feat: Add Cloud Run Jobs v2 API (#65)

* chore: update to gapic-generator-python 1.5.0

feat: add support for `google.cloud.<api>.__version__`
PiperOrigin-RevId: 484665853

Source-Link: googleapis/googleapis@8eb249a

Source-Link: googleapis/googleapis-gen@c8aa327
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYzhhYTMyN2I1ZjQ3ODg2NWZjM2ZkOTFlM2MyNzY4ZTU0ZTI2YWQ0NCJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* feat: Adds Cloud Run Jobs v2 API client libraries

A Cloud Run Job runs its tasks and exits when finished.

For more information about Cloud Run Jobs, visit https://cloud.google.com/run/docs/create-jobs

PiperOrigin-RevId: 485653075

Source-Link: googleapis/googleapis@a9a137b

Source-Link: googleapis/googleapis-gen@7d398ce
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiN2QzOThjZTY4YWQwMTAxZGI2MDEzMGQ1MjY5NTBkZjBlZmNhZGRjZSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* feat: Adds gRPC probe support to Cloud Run v2 API client libraries

PiperOrigin-RevId: 486175948

Source-Link: googleapis/googleapis@153e959

Source-Link: googleapis/googleapis-gen@bb74acd
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYmI3NGFjZGM4ZDMwMTJkZWEwYjk0ODU4MzYzMTk4NTQyMjI2ZmMwMSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* add .release-please-manifest.json with correct version

* chore: Update to gapic-generator-python 1.6.0

feat(python): Add typing to proto.Message based class attributes

feat(python): Snippetgen handling of repeated enum field

PiperOrigin-RevId: 487326846

Source-Link: googleapis/googleapis@da380c7

Source-Link: googleapis/googleapis-gen@61ef576
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNjFlZjU3NjJlZTY3MzFhMGNiYmZlYTIyZmQwZWVjZWU1MWFiMWM4ZSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* feat: new APIs added to reflect updates to the filestore service

- Add ENTERPRISE Tier
- Add snapshot APIs: RevertInstance, ListSnapshots, CreateSnapshot, DeleteSnapshot, UpdateSnapshot
- Add multi-share APIs: ListShares, GetShare, CreateShare, DeleteShare, UpdateShare
- Add ConnectMode to NetworkConfig (for Private Service Access support)
- New status codes (SUSPENDED/SUSPENDING, REVERTING/RESUMING)
- Add SuspensionReason (for KMS related suspension)
- Add new fields to Instance information: max_capacity_gb, capacity_step_size_gb, max_share_count, capacity_gb, multi_share_enabled

PiperOrigin-RevId: 487492758

Source-Link: googleapis/googleapis@5be5981

Source-Link: googleapis/googleapis-gen@ab0e217
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYWIwZTIxN2Y1NjBjYzJjMWFmYzExNDQxYzJlYWI2YjY5NTBlZmQyYiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* chore: Update gapic-generator-python to v1.6.1

PiperOrigin-RevId: 488036204

Source-Link: googleapis/googleapis@08f275f

Source-Link: googleapis/googleapis-gen@555c094
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNTU1YzA5NDVlNjA2NDllMzg3MzlhZTY0YmM0NTcxOWNkZjcyMTc4ZiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* use templated owlbot.py and setup.py

* run nox format session

* update docs/run_v2/services_.rst

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
Co-authored-by: Anthonios Partheniou <partheniou@google.com>

packages/google-cloud-run/.github/release-please.yml

@@ -1,2 +1,3 @@
 releaseType: python
 handleGHRelease: true
+manifest: true

packages/google-cloud-run/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.4.2"
+}

packages/google-cloud-run/docs/conf.py

@@ -24,9 +24,9 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
-import sys
 import os
 import shlex
+import sys
 
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the

packages/google-cloud-run/docs/run_v2/executions.rst

@@ -0,0 +1,10 @@
+Executions
+----------------------------
+
+.. automodule:: google.cloud.run_v2.services.executions
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.run_v2.services.executions.pagers
+    :members:
+    :inherited-members:

packages/google-cloud-run/docs/run_v2/jobs.rst

@@ -0,0 +1,10 @@
+Jobs
+----------------------
+
+.. automodule:: google.cloud.run_v2.services.jobs
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.run_v2.services.jobs.pagers
+    :members:
+    :inherited-members:

packages/google-cloud-run/docs/run_v2/services_.rst

@@ -3,5 +3,8 @@ Services for Google Cloud Run v2 API
 .. toctree::
     :maxdepth: 2
 
+    executions
+    jobs
     revisions
     services
+    tasks

packages/google-cloud-run/docs/run_v2/tasks.rst

@@ -0,0 +1,10 @@
+Tasks
+-----------------------
+
+.. automodule:: google.cloud.run_v2.services.tasks
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.run_v2.services.tasks.pagers
+    :members:
+    :inherited-members:

packages/google-cloud-run/docs/run_v2/types.rst

@@ -3,5 +3,4 @@ Types for Google Cloud Run v2 API
 
 .. automodule:: google.cloud.run_v2.types
     :members:
-    :undoc-members:
     :show-inheritance:

packages/google-cloud-run/google/cloud/run/__init__.py

@@ -0,0 +1,177 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+from google.cloud.run import gapic_version as package_version
+
+__version__ = package_version.__version__
+
+
+from google.cloud.run_v2.services.executions.async_client import ExecutionsAsyncClient
+from google.cloud.run_v2.services.executions.client import ExecutionsClient
+from google.cloud.run_v2.services.jobs.async_client import JobsAsyncClient
+from google.cloud.run_v2.services.jobs.client import JobsClient
+from google.cloud.run_v2.services.revisions.async_client import RevisionsAsyncClient
+from google.cloud.run_v2.services.revisions.client import RevisionsClient
+from google.cloud.run_v2.services.services.async_client import ServicesAsyncClient
+from google.cloud.run_v2.services.services.client import ServicesClient
+from google.cloud.run_v2.services.tasks.async_client import TasksAsyncClient
+from google.cloud.run_v2.services.tasks.client import TasksClient
+from google.cloud.run_v2.types.condition import Condition
+from google.cloud.run_v2.types.execution import (
+    DeleteExecutionRequest,
+    Execution,
+    GetExecutionRequest,
+    ListExecutionsRequest,
+    ListExecutionsResponse,
+)
+from google.cloud.run_v2.types.execution_template import ExecutionTemplate
+from google.cloud.run_v2.types.job import (
+    CreateJobRequest,
+    DeleteJobRequest,
+    ExecutionReference,
+    GetJobRequest,
+    Job,
+    ListJobsRequest,
+    ListJobsResponse,
+    RunJobRequest,
+    UpdateJobRequest,
+)
+from google.cloud.run_v2.types.k8s_min import (
+    CloudSqlInstance,
+    Container,
+    ContainerPort,
+    EnvVar,
+    EnvVarSource,
+    GRPCAction,
+    HTTPGetAction,
+    HTTPHeader,
+    Probe,
+    ResourceRequirements,
+    SecretKeySelector,
+    SecretVolumeSource,
+    TCPSocketAction,
+    VersionToPath,
+    Volume,
+    VolumeMount,
+)
+from google.cloud.run_v2.types.revision import (
+    DeleteRevisionRequest,
+    GetRevisionRequest,
+    ListRevisionsRequest,
+    ListRevisionsResponse,
+    Revision,
+)
+from google.cloud.run_v2.types.revision_template import RevisionTemplate
+from google.cloud.run_v2.types.service import (
+    CreateServiceRequest,
+    DeleteServiceRequest,
+    GetServiceRequest,
+    ListServicesRequest,
+    ListServicesResponse,
+    Service,
+    UpdateServiceRequest,
+)
+from google.cloud.run_v2.types.task import (
+    GetTaskRequest,
+    ListTasksRequest,
+    ListTasksResponse,
+    Task,
+    TaskAttemptResult,
+)
+from google.cloud.run_v2.types.task_template import TaskTemplate
+from google.cloud.run_v2.types.traffic_target import (
+    TrafficTarget,
+    TrafficTargetAllocationType,
+    TrafficTargetStatus,
+)
+from google.cloud.run_v2.types.vendor_settings import (
+    BinaryAuthorization,
+    ExecutionEnvironment,
+    IngressTraffic,
+    RevisionScaling,
+    VpcAccess,
+)
+
+__all__ = (
+    "ExecutionsClient",
+    "ExecutionsAsyncClient",
+    "JobsClient",
+    "JobsAsyncClient",
+    "RevisionsClient",
+    "RevisionsAsyncClient",
+    "ServicesClient",
+    "ServicesAsyncClient",
+    "TasksClient",
+    "TasksAsyncClient",
+    "Condition",
+    "DeleteExecutionRequest",
+    "Execution",
+    "GetExecutionRequest",
+    "ListExecutionsRequest",
+    "ListExecutionsResponse",
+    "ExecutionTemplate",
+    "CreateJobRequest",
+    "DeleteJobRequest",
+    "ExecutionReference",
+    "GetJobRequest",
+    "Job",
+    "ListJobsRequest",
+    "ListJobsResponse",
+    "RunJobRequest",
+    "UpdateJobRequest",
+    "CloudSqlInstance",
+    "Container",
+    "ContainerPort",
+    "EnvVar",
+    "EnvVarSource",
+    "GRPCAction",
+    "HTTPGetAction",
+    "HTTPHeader",
+    "Probe",
+    "ResourceRequirements",
+    "SecretKeySelector",
+    "SecretVolumeSource",
+    "TCPSocketAction",
+    "VersionToPath",
+    "Volume",
+    "VolumeMount",
+    "DeleteRevisionRequest",
+    "GetRevisionRequest",
+    "ListRevisionsRequest",
+    "ListRevisionsResponse",
+    "Revision",
+    "RevisionTemplate",
+    "CreateServiceRequest",
+    "DeleteServiceRequest",
+    "GetServiceRequest",
+    "ListServicesRequest",
+    "ListServicesResponse",
+    "Service",
+    "UpdateServiceRequest",
+    "GetTaskRequest",
+    "ListTasksRequest",
+    "ListTasksResponse",
+    "Task",
+    "TaskAttemptResult",
+    "TaskTemplate",
+    "TrafficTarget",
+    "TrafficTargetStatus",
+    "TrafficTargetAllocationType",
+    "BinaryAuthorization",
+    "RevisionScaling",
+    "VpcAccess",
+    "ExecutionEnvironment",
+    "IngressTraffic",
+)

packages/google-cloud-run/google/cloud/run/gapic_version.py

@@ -0,0 +1,16 @@
+# -*- coding: utf-8 -*-
+# Copyright 2022 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+__version__ = "0.4.2"  # {x-release-please-version}

packages/google-cloud-run/google/cloud/run/py.typed

@@ -0,0 +1,2 @@
+# Marker file for PEP 561.
+# The google-cloud-run package uses inline types.