google-cloud-video-transcoder 1.15.1__py3-none-any.whl

google/cloud/video/transcoder_v1/services/transcoder_service/pagers.py

@@ -0,0 +1,353 @@
+# -*- coding: utf-8 -*-
+# Copyright 2024 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 typing import (
+    Any,
+    AsyncIterator,
+    Awaitable,
+    Callable,
+    Iterator,
+    Optional,
+    Sequence,
+    Tuple,
+    Union,
+)
+
+from google.api_core import gapic_v1
+from google.api_core import retry as retries
+from google.api_core import retry_async as retries_async
+
+try:
+    OptionalRetry = Union[retries.Retry, gapic_v1.method._MethodDefault, None]
+    OptionalAsyncRetry = Union[
+        retries_async.AsyncRetry, gapic_v1.method._MethodDefault, None
+    ]
+except AttributeError:  # pragma: NO COVER
+    OptionalRetry = Union[retries.Retry, object, None]  # type: ignore
+    OptionalAsyncRetry = Union[retries_async.AsyncRetry, object, None]  # type: ignore
+
+from google.cloud.video.transcoder_v1.types import resources, services
+
+
+class ListJobsPager:
+    """A pager for iterating through ``list_jobs`` requests.
+
+    This class thinly wraps an initial
+    :class:`google.cloud.video.transcoder_v1.types.ListJobsResponse` object, and
+    provides an ``__iter__`` method to iterate through its
+    ``jobs`` field.
+
+    If there are more pages, the ``__iter__`` method will make additional
+    ``ListJobs`` requests and continue to iterate
+    through the ``jobs`` field on the
+    corresponding responses.
+
+    All the usual :class:`google.cloud.video.transcoder_v1.types.ListJobsResponse`
+    attributes are available on the pager. If multiple requests are made, only
+    the most recent response is retained, and thus used for attribute lookup.
+    """
+
+    def __init__(
+        self,
+        method: Callable[..., services.ListJobsResponse],
+        request: services.ListJobsRequest,
+        response: services.ListJobsResponse,
+        *,
+        retry: OptionalRetry = gapic_v1.method.DEFAULT,
+        timeout: Union[float, object] = gapic_v1.method.DEFAULT,
+        metadata: Sequence[Tuple[str, Union[str, bytes]]] = ()
+    ):
+        """Instantiate the pager.
+
+        Args:
+            method (Callable): The method that was originally called, and
+                which instantiated this pager.
+            request (google.cloud.video.transcoder_v1.types.ListJobsRequest):
+                The initial request object.
+            response (google.cloud.video.transcoder_v1.types.ListJobsResponse):
+                The initial response object.
+            retry (google.api_core.retry.Retry): Designation of what errors,
+                if any, should be retried.
+            timeout (float): The timeout for this request.
+            metadata (Sequence[Tuple[str, Union[str, bytes]]]): Key/value pairs which should be
+                sent along with the request as metadata. Normally, each value must be of type `str`,
+                but for metadata keys ending with the suffix `-bin`, the corresponding values must
+                be of type `bytes`.
+        """
+        self._method = method
+        self._request = services.ListJobsRequest(request)
+        self._response = response
+        self._retry = retry
+        self._timeout = timeout
+        self._metadata = metadata
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._response, name)
+
+    @property
+    def pages(self) -> Iterator[services.ListJobsResponse]:
+        yield self._response
+        while self._response.next_page_token:
+            self._request.page_token = self._response.next_page_token
+            self._response = self._method(
+                self._request,
+                retry=self._retry,
+                timeout=self._timeout,
+                metadata=self._metadata,
+            )
+            yield self._response
+
+    def __iter__(self) -> Iterator[resources.Job]:
+        for page in self.pages:
+            yield from page.jobs
+
+    def __repr__(self) -> str:
+        return "{0}<{1!r}>".format(self.__class__.__name__, self._response)
+
+
+class ListJobsAsyncPager:
+    """A pager for iterating through ``list_jobs`` requests.
+
+    This class thinly wraps an initial
+    :class:`google.cloud.video.transcoder_v1.types.ListJobsResponse` object, and
+    provides an ``__aiter__`` method to iterate through its
+    ``jobs`` field.
+
+    If there are more pages, the ``__aiter__`` method will make additional
+    ``ListJobs`` requests and continue to iterate
+    through the ``jobs`` field on the
+    corresponding responses.
+
+    All the usual :class:`google.cloud.video.transcoder_v1.types.ListJobsResponse`
+    attributes are available on the pager. If multiple requests are made, only
+    the most recent response is retained, and thus used for attribute lookup.
+    """
+
+    def __init__(
+        self,
+        method: Callable[..., Awaitable[services.ListJobsResponse]],
+        request: services.ListJobsRequest,
+        response: services.ListJobsResponse,
+        *,
+        retry: OptionalAsyncRetry = gapic_v1.method.DEFAULT,
+        timeout: Union[float, object] = gapic_v1.method.DEFAULT,
+        metadata: Sequence[Tuple[str, Union[str, bytes]]] = ()
+    ):
+        """Instantiates the pager.
+
+        Args:
+            method (Callable): The method that was originally called, and
+                which instantiated this pager.
+            request (google.cloud.video.transcoder_v1.types.ListJobsRequest):
+                The initial request object.
+            response (google.cloud.video.transcoder_v1.types.ListJobsResponse):
+                The initial response object.
+            retry (google.api_core.retry.AsyncRetry): Designation of what errors,
+                if any, should be retried.
+            timeout (float): The timeout for this request.
+            metadata (Sequence[Tuple[str, Union[str, bytes]]]): Key/value pairs which should be
+                sent along with the request as metadata. Normally, each value must be of type `str`,
+                but for metadata keys ending with the suffix `-bin`, the corresponding values must
+                be of type `bytes`.
+        """
+        self._method = method
+        self._request = services.ListJobsRequest(request)
+        self._response = response
+        self._retry = retry
+        self._timeout = timeout
+        self._metadata = metadata
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._response, name)
+
+    @property
+    async def pages(self) -> AsyncIterator[services.ListJobsResponse]:
+        yield self._response
+        while self._response.next_page_token:
+            self._request.page_token = self._response.next_page_token
+            self._response = await self._method(
+                self._request,
+                retry=self._retry,
+                timeout=self._timeout,
+                metadata=self._metadata,
+            )
+            yield self._response
+
+    def __aiter__(self) -> AsyncIterator[resources.Job]:
+        async def async_generator():
+            async for page in self.pages:
+                for response in page.jobs:
+                    yield response
+
+        return async_generator()
+
+    def __repr__(self) -> str:
+        return "{0}<{1!r}>".format(self.__class__.__name__, self._response)
+
+
+class ListJobTemplatesPager:
+    """A pager for iterating through ``list_job_templates`` requests.
+
+    This class thinly wraps an initial
+    :class:`google.cloud.video.transcoder_v1.types.ListJobTemplatesResponse` object, and
+    provides an ``__iter__`` method to iterate through its
+    ``job_templates`` field.
+
+    If there are more pages, the ``__iter__`` method will make additional
+    ``ListJobTemplates`` requests and continue to iterate
+    through the ``job_templates`` field on the
+    corresponding responses.
+
+    All the usual :class:`google.cloud.video.transcoder_v1.types.ListJobTemplatesResponse`
+    attributes are available on the pager. If multiple requests are made, only
+    the most recent response is retained, and thus used for attribute lookup.
+    """
+
+    def __init__(
+        self,
+        method: Callable[..., services.ListJobTemplatesResponse],
+        request: services.ListJobTemplatesRequest,
+        response: services.ListJobTemplatesResponse,
+        *,
+        retry: OptionalRetry = gapic_v1.method.DEFAULT,
+        timeout: Union[float, object] = gapic_v1.method.DEFAULT,
+        metadata: Sequence[Tuple[str, Union[str, bytes]]] = ()
+    ):
+        """Instantiate the pager.
+
+        Args:
+            method (Callable): The method that was originally called, and
+                which instantiated this pager.
+            request (google.cloud.video.transcoder_v1.types.ListJobTemplatesRequest):
+                The initial request object.
+            response (google.cloud.video.transcoder_v1.types.ListJobTemplatesResponse):
+                The initial response object.
+            retry (google.api_core.retry.Retry): Designation of what errors,
+                if any, should be retried.
+            timeout (float): The timeout for this request.
+            metadata (Sequence[Tuple[str, Union[str, bytes]]]): Key/value pairs which should be
+                sent along with the request as metadata. Normally, each value must be of type `str`,
+                but for metadata keys ending with the suffix `-bin`, the corresponding values must
+                be of type `bytes`.
+        """
+        self._method = method
+        self._request = services.ListJobTemplatesRequest(request)
+        self._response = response
+        self._retry = retry
+        self._timeout = timeout
+        self._metadata = metadata
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._response, name)
+
+    @property
+    def pages(self) -> Iterator[services.ListJobTemplatesResponse]:
+        yield self._response
+        while self._response.next_page_token:
+            self._request.page_token = self._response.next_page_token
+            self._response = self._method(
+                self._request,
+                retry=self._retry,
+                timeout=self._timeout,
+                metadata=self._metadata,
+            )
+            yield self._response
+
+    def __iter__(self) -> Iterator[resources.JobTemplate]:
+        for page in self.pages:
+            yield from page.job_templates
+
+    def __repr__(self) -> str:
+        return "{0}<{1!r}>".format(self.__class__.__name__, self._response)
+
+
+class ListJobTemplatesAsyncPager:
+    """A pager for iterating through ``list_job_templates`` requests.
+
+    This class thinly wraps an initial
+    :class:`google.cloud.video.transcoder_v1.types.ListJobTemplatesResponse` object, and
+    provides an ``__aiter__`` method to iterate through its
+    ``job_templates`` field.
+
+    If there are more pages, the ``__aiter__`` method will make additional
+    ``ListJobTemplates`` requests and continue to iterate
+    through the ``job_templates`` field on the
+    corresponding responses.
+
+    All the usual :class:`google.cloud.video.transcoder_v1.types.ListJobTemplatesResponse`
+    attributes are available on the pager. If multiple requests are made, only
+    the most recent response is retained, and thus used for attribute lookup.
+    """
+
+    def __init__(
+        self,
+        method: Callable[..., Awaitable[services.ListJobTemplatesResponse]],
+        request: services.ListJobTemplatesRequest,
+        response: services.ListJobTemplatesResponse,
+        *,
+        retry: OptionalAsyncRetry = gapic_v1.method.DEFAULT,
+        timeout: Union[float, object] = gapic_v1.method.DEFAULT,
+        metadata: Sequence[Tuple[str, Union[str, bytes]]] = ()
+    ):
+        """Instantiates the pager.
+
+        Args:
+            method (Callable): The method that was originally called, and
+                which instantiated this pager.
+            request (google.cloud.video.transcoder_v1.types.ListJobTemplatesRequest):
+                The initial request object.
+            response (google.cloud.video.transcoder_v1.types.ListJobTemplatesResponse):
+                The initial response object.
+            retry (google.api_core.retry.AsyncRetry): Designation of what errors,
+                if any, should be retried.
+            timeout (float): The timeout for this request.
+            metadata (Sequence[Tuple[str, Union[str, bytes]]]): Key/value pairs which should be
+                sent along with the request as metadata. Normally, each value must be of type `str`,
+                but for metadata keys ending with the suffix `-bin`, the corresponding values must
+                be of type `bytes`.
+        """
+        self._method = method
+        self._request = services.ListJobTemplatesRequest(request)
+        self._response = response
+        self._retry = retry
+        self._timeout = timeout
+        self._metadata = metadata
+
+    def __getattr__(self, name: str) -> Any:
+        return getattr(self._response, name)
+
+    @property
+    async def pages(self) -> AsyncIterator[services.ListJobTemplatesResponse]:
+        yield self._response
+        while self._response.next_page_token:
+            self._request.page_token = self._response.next_page_token
+            self._response = await self._method(
+                self._request,
+                retry=self._retry,
+                timeout=self._timeout,
+                metadata=self._metadata,
+            )
+            yield self._response
+
+    def __aiter__(self) -> AsyncIterator[resources.JobTemplate]:
+        async def async_generator():
+            async for page in self.pages:
+                for response in page.job_templates:
+                    yield response
+
+        return async_generator()
+
+    def __repr__(self) -> str:
+        return "{0}<{1!r}>".format(self.__class__.__name__, self._response)

google/cloud/video/transcoder_v1/services/transcoder_service/transports/__init__.py

@@ -0,0 +1,36 @@
+# -*- coding: utf-8 -*-
+# Copyright 2024 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 collections import OrderedDict
+from typing import Dict, Type
+
+from .base import TranscoderServiceTransport
+from .grpc import TranscoderServiceGrpcTransport
+from .grpc_asyncio import TranscoderServiceGrpcAsyncIOTransport
+from .rest import TranscoderServiceRestInterceptor, TranscoderServiceRestTransport
+
+# Compile a registry of transports.
+_transport_registry = OrderedDict()  # type: Dict[str, Type[TranscoderServiceTransport]]
+_transport_registry["grpc"] = TranscoderServiceGrpcTransport
+_transport_registry["grpc_asyncio"] = TranscoderServiceGrpcAsyncIOTransport
+_transport_registry["rest"] = TranscoderServiceRestTransport
+
+__all__ = (
+    "TranscoderServiceTransport",
+    "TranscoderServiceGrpcTransport",
+    "TranscoderServiceGrpcAsyncIOTransport",
+    "TranscoderServiceRestTransport",
+    "TranscoderServiceRestInterceptor",
+)

google/cloud/video/transcoder_v1/services/transcoder_service/transports/base.py

@@ -0,0 +1,260 @@
+# -*- coding: utf-8 -*-
+# Copyright 2024 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.
+#
+import abc
+from typing import Awaitable, Callable, Dict, Optional, Sequence, Union
+
+import google.api_core
+from google.api_core import exceptions as core_exceptions
+from google.api_core import gapic_v1
+from google.api_core import retry as retries
+import google.auth  # type: ignore
+from google.auth import credentials as ga_credentials  # type: ignore
+from google.oauth2 import service_account  # type: ignore
+from google.protobuf import empty_pb2  # type: ignore
+
+from google.cloud.video.transcoder_v1 import gapic_version as package_version
+from google.cloud.video.transcoder_v1.types import resources, services
+
+DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo(
+    gapic_version=package_version.__version__
+)
+
+
+class TranscoderServiceTransport(abc.ABC):
+    """Abstract transport class for TranscoderService."""
+
+    AUTH_SCOPES = ("https://www.googleapis.com/auth/cloud-platform",)
+
+    DEFAULT_HOST: str = "transcoder.googleapis.com"
+
+    def __init__(
+        self,
+        *,
+        host: str = DEFAULT_HOST,
+        credentials: Optional[ga_credentials.Credentials] = None,
+        credentials_file: Optional[str] = None,
+        scopes: Optional[Sequence[str]] = None,
+        quota_project_id: Optional[str] = None,
+        client_info: gapic_v1.client_info.ClientInfo = DEFAULT_CLIENT_INFO,
+        always_use_jwt_access: Optional[bool] = False,
+        api_audience: Optional[str] = None,
+        **kwargs,
+    ) -> None:
+        """Instantiate the transport.
+
+        Args:
+            host (Optional[str]):
+                 The hostname to connect to (default: 'transcoder.googleapis.com').
+            credentials (Optional[google.auth.credentials.Credentials]): The
+                authorization credentials to attach to requests. These
+                credentials identify the application to the service; if none
+                are specified, the client will attempt to ascertain the
+                credentials from the environment.
+            credentials_file (Optional[str]): A file with credentials that can
+                be loaded with :func:`google.auth.load_credentials_from_file`.
+                This argument is mutually exclusive with credentials.
+            scopes (Optional[Sequence[str]]): A list of scopes.
+            quota_project_id (Optional[str]): An optional project to use for billing
+                and quota.
+            client_info (google.api_core.gapic_v1.client_info.ClientInfo):
+                The client info used to send a user-agent string along with
+                API requests. If ``None``, then default info will be used.
+                Generally, you only need to set this if you're developing
+                your own client library.
+            always_use_jwt_access (Optional[bool]): Whether self signed JWT should
+                be used for service account credentials.
+        """
+
+        scopes_kwargs = {"scopes": scopes, "default_scopes": self.AUTH_SCOPES}
+
+        # Save the scopes.
+        self._scopes = scopes
+        if not hasattr(self, "_ignore_credentials"):
+            self._ignore_credentials: bool = False
+
+        # If no credentials are provided, then determine the appropriate
+        # defaults.
+        if credentials and credentials_file:
+            raise core_exceptions.DuplicateCredentialArgs(
+                "'credentials_file' and 'credentials' are mutually exclusive"
+            )
+
+        if credentials_file is not None:
+            credentials, _ = google.auth.load_credentials_from_file(
+                credentials_file, **scopes_kwargs, quota_project_id=quota_project_id
+            )
+        elif credentials is None and not self._ignore_credentials:
+            credentials, _ = google.auth.default(
+                **scopes_kwargs, quota_project_id=quota_project_id
+            )
+            # Don't apply audience if the credentials file passed from user.
+            if hasattr(credentials, "with_gdch_audience"):
+                credentials = credentials.with_gdch_audience(
+                    api_audience if api_audience else host
+                )
+
+        # If the credentials are service account credentials, then always try to use self signed JWT.
+        if (
+            always_use_jwt_access
+            and isinstance(credentials, service_account.Credentials)
+            and hasattr(service_account.Credentials, "with_always_use_jwt_access")
+        ):
+            credentials = credentials.with_always_use_jwt_access(True)
+
+        # Save the credentials.
+        self._credentials = credentials
+
+        # Save the hostname. Default to port 443 (HTTPS) if none is specified.
+        if ":" not in host:
+            host += ":443"
+        self._host = host
+
+    @property
+    def host(self):
+        return self._host
+
+    def _prep_wrapped_messages(self, client_info):
+        # Precompute the wrapped methods.
+        self._wrapped_methods = {
+            self.create_job: gapic_v1.method.wrap_method(
+                self.create_job,
+                default_timeout=60.0,
+                client_info=client_info,
+            ),
+            self.list_jobs: gapic_v1.method.wrap_method(
+                self.list_jobs,
+                default_timeout=60.0,
+                client_info=client_info,
+            ),
+            self.get_job: gapic_v1.method.wrap_method(
+                self.get_job,
+                default_timeout=60.0,
+                client_info=client_info,
+            ),
+            self.delete_job: gapic_v1.method.wrap_method(
+                self.delete_job,
+                default_timeout=60.0,
+                client_info=client_info,
+            ),
+            self.create_job_template: gapic_v1.method.wrap_method(
+                self.create_job_template,
+                default_timeout=60.0,
+                client_info=client_info,
+            ),
+            self.list_job_templates: gapic_v1.method.wrap_method(
+                self.list_job_templates,
+                default_timeout=60.0,
+                client_info=client_info,
+            ),
+            self.get_job_template: gapic_v1.method.wrap_method(
+                self.get_job_template,
+                default_timeout=60.0,
+                client_info=client_info,
+            ),
+            self.delete_job_template: gapic_v1.method.wrap_method(
+                self.delete_job_template,
+                default_timeout=60.0,
+                client_info=client_info,
+            ),
+        }
+
+    def close(self):
+        """Closes resources associated with the transport.
+
+        .. warning::
+             Only call this method if the transport is NOT shared
+             with other clients - this may cause errors in other clients!
+        """
+        raise NotImplementedError()
+
+    @property
+    def create_job(
+        self,
+    ) -> Callable[
+        [services.CreateJobRequest], Union[resources.Job, Awaitable[resources.Job]]
+    ]:
+        raise NotImplementedError()
+
+    @property
+    def list_jobs(
+        self,
+    ) -> Callable[
+        [services.ListJobsRequest],
+        Union[services.ListJobsResponse, Awaitable[services.ListJobsResponse]],
+    ]:
+        raise NotImplementedError()
+
+    @property
+    def get_job(
+        self,
+    ) -> Callable[
+        [services.GetJobRequest], Union[resources.Job, Awaitable[resources.Job]]
+    ]:
+        raise NotImplementedError()
+
+    @property
+    def delete_job(
+        self,
+    ) -> Callable[
+        [services.DeleteJobRequest], Union[empty_pb2.Empty, Awaitable[empty_pb2.Empty]]
+    ]:
+        raise NotImplementedError()
+
+    @property
+    def create_job_template(
+        self,
+    ) -> Callable[
+        [services.CreateJobTemplateRequest],
+        Union[resources.JobTemplate, Awaitable[resources.JobTemplate]],
+    ]:
+        raise NotImplementedError()
+
+    @property
+    def list_job_templates(
+        self,
+    ) -> Callable[
+        [services.ListJobTemplatesRequest],
+        Union[
+            services.ListJobTemplatesResponse,
+            Awaitable[services.ListJobTemplatesResponse],
+        ],
+    ]:
+        raise NotImplementedError()
+
+    @property
+    def get_job_template(
+        self,
+    ) -> Callable[
+        [services.GetJobTemplateRequest],
+        Union[resources.JobTemplate, Awaitable[resources.JobTemplate]],
+    ]:
+        raise NotImplementedError()
+
+    @property
+    def delete_job_template(
+        self,
+    ) -> Callable[
+        [services.DeleteJobTemplateRequest],
+        Union[empty_pb2.Empty, Awaitable[empty_pb2.Empty]],
+    ]:
+        raise NotImplementedError()
+
+    @property
+    def kind(self) -> str:
+        raise NotImplementedError()
+
+
+__all__ = ("TranscoderServiceTransport",)