diff --git a/.github/.OwlBot.lock.yaml b/.github/.OwlBot.lock.yaml index 9ee60f7e..2567653c 100644 --- a/.github/.OwlBot.lock.yaml +++ b/.github/.OwlBot.lock.yaml @@ -1,3 +1,3 @@ docker: - image: gcr.io/repo-automation-bots/owlbot-python:latest - digest: sha256:aea14a583128771ae8aefa364e1652f3c56070168ef31beb203534222d842b8b + image: gcr.io/cloud-devrel-public-resources/owlbot-python:latest + digest: sha256:87eee22d276554e4e52863ec9b1cb6a7245815dfae20439712bf644348215a5a diff --git a/.github/.OwlBot.yaml b/.github/.OwlBot.yaml index e173f5a7..b85888aa 100644 --- a/.github/.OwlBot.yaml +++ b/.github/.OwlBot.yaml @@ -13,7 +13,7 @@ # limitations under the License. docker: - image: gcr.io/repo-automation-bots/owlbot-python:latest + image: gcr.io/cloud-devrel-public-resources/owlbot-python:latest deep-remove-regex: - /owl-bot-staging diff --git a/.github/sync-repo-settings.yaml b/.github/sync-repo-settings.yaml index af599353..3e98ae70 100644 --- a/.github/sync-repo-settings.yaml +++ b/.github/sync-repo-settings.yaml @@ -1,9 +1,11 @@ -# https://github.com/googleapis/repo-automation-bots/tree/master/packages/sync-repo-settings -# Rules for master branch protection +# https://github.com/googleapis/repo-automation-bots/tree/main/packages/sync-repo-settings +# Rules for main branch protection branchProtectionRules: # Identifies the protection rule pattern. Name of the branch to be protected. -# Defaults to `master` -- pattern: master +# Defaults to `main` +- pattern: main + requiresCodeOwnerReviews: true + requiresStrictStatusChecks: true requiredStatusCheckContexts: - 'Kokoro' - 'cla/google' diff --git a/.kokoro/build.sh b/.kokoro/build.sh index 9183de36..67e69b36 100755 --- a/.kokoro/build.sh +++ b/.kokoro/build.sh @@ -41,7 +41,7 @@ python3 -m pip install --upgrade --quiet nox python3 -m nox --version # If this is a continuous build, send the test log to the FlakyBot. -# See https://github.com/googleapis/repo-automation-bots/tree/master/packages/flakybot. +# See https://github.com/googleapis/repo-automation-bots/tree/main/packages/flakybot. if [[ $KOKORO_BUILD_ARTIFACTS_SUBDIR = *"continuous"* ]]; then cleanup() { chmod +x $KOKORO_GFILE_DIR/linux_amd64/flakybot diff --git a/.kokoro/test-samples-impl.sh b/.kokoro/test-samples-impl.sh index 311a8d54..8a324c9c 100755 --- a/.kokoro/test-samples-impl.sh +++ b/.kokoro/test-samples-impl.sh @@ -80,7 +80,7 @@ for file in samples/**/requirements.txt; do EXIT=$? # If this is a periodic build, send the test log to the FlakyBot. - # See https://github.com/googleapis/repo-automation-bots/tree/master/packages/flakybot. + # See https://github.com/googleapis/repo-automation-bots/tree/main/packages/flakybot. if [[ $KOKORO_BUILD_ARTIFACTS_SUBDIR = *"periodic"* ]]; then chmod +x $KOKORO_GFILE_DIR/linux_amd64/flakybot $KOKORO_GFILE_DIR/linux_amd64/flakybot diff --git a/CHANGELOG.md b/CHANGELOG.md index c6680b12..f64e03e7 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -4,6 +4,13 @@ [1]: https://pypi.org/project/google-cloud-tasks/#history +### [2.5.2](https://www.github.com/googleapis/python-tasks/compare/v2.5.1...v2.5.2) (2021-09-24) + + +### Bug Fixes + +* add 'dict' annotation type to 'request' ([42d768b](https://www.github.com/googleapis/python-tasks/commit/42d768b9f302aef3258f4abc413199070bcd2a8d)) + ### [2.5.1](https://www.github.com/googleapis/python-tasks/compare/v2.5.0...v2.5.1) (2021-07-28) diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index b0135f6f..fc8d3c96 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -50,9 +50,9 @@ You'll have to create a development environment using a Git checkout: # Configure remotes such that you can pull changes from the googleapis/python-tasks # repository into your local repository. $ git remote add upstream git@github.com:googleapis/python-tasks.git - # fetch and merge changes from upstream into master + # fetch and merge changes from upstream into main $ git fetch upstream - $ git merge upstream/master + $ git merge upstream/main Now your local repo is set up such that you will push changes to your GitHub repo, from which you can submit a pull request. @@ -110,12 +110,12 @@ Coding Style variables:: export GOOGLE_CLOUD_TESTING_REMOTE="upstream" - export GOOGLE_CLOUD_TESTING_BRANCH="master" + export GOOGLE_CLOUD_TESTING_BRANCH="main" By doing this, you are specifying the location of the most up-to-date - version of ``python-tasks``. The the suggested remote name ``upstream`` - should point to the official ``googleapis`` checkout and the - the branch should be the main branch on that remote (``master``). + version of ``python-tasks``. The + remote name ``upstream`` should point to the official ``googleapis`` + checkout and the branch should be the default branch on that remote (``main``). - This repository contains configuration for the `pre-commit `__ tool, which automates checking @@ -209,7 +209,7 @@ The `description on PyPI`_ for the project comes directly from the ``README``. Due to the reStructuredText (``rst``) parser used by PyPI, relative links which will work on GitHub (e.g. ``CONTRIBUTING.rst`` instead of -``https://github.com/googleapis/python-tasks/blob/master/CONTRIBUTING.rst``) +``https://github.com/googleapis/python-tasks/blob/main/CONTRIBUTING.rst``) may cause problems creating links or rendering the description. .. _description on PyPI: https://pypi.org/project/google-cloud-tasks @@ -234,7 +234,7 @@ We support: Supported versions can be found in our ``noxfile.py`` `config`_. -.. _config: https://github.com/googleapis/python-tasks/blob/master/noxfile.py +.. _config: https://github.com/googleapis/python-tasks/blob/main/noxfile.py We also explicitly decided to support Python 3 beginning with version 3.6. diff --git a/README.rst b/README.rst index 24139fb8..ad2a545b 100644 --- a/README.rst +++ b/README.rst @@ -10,7 +10,7 @@ requests. - `Product Documentation`_ .. |GA| image:: https://img.shields.io/badge/support-GA-gold.svg - :target: https://github.com/googleapis/google-cloud-python/blob/master/README.rst#general-availability + :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#general-availability .. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-tasks.svg :target: https://pypi.org/project/google-cloud-tasks/ .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-tasks.svg diff --git a/docs/conf.py b/docs/conf.py index c5edc47b..6a310b89 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -76,8 +76,8 @@ # The encoding of source files. # source_encoding = 'utf-8-sig' -# The master toctree document. -master_doc = "index" +# The root toctree document. +root_doc = "index" # General information about the project. project = "google-cloud-tasks" @@ -110,6 +110,7 @@ # directories to ignore when looking for source files. exclude_patterns = [ "_build", + "**/.nox/**/*", "samples/AUTHORING_GUIDE.md", "samples/CONTRIBUTING.md", "samples/snippets/README.rst", @@ -279,7 +280,7 @@ # author, documentclass [howto, manual, or own class]). latex_documents = [ ( - master_doc, + root_doc, "google-cloud-tasks.tex", "google-cloud-tasks Documentation", author, @@ -313,7 +314,7 @@ # One entry per manual page. List of tuples # (source start file, name, description, authors, manual section). man_pages = [ - (master_doc, "google-cloud-tasks", "google-cloud-tasks Documentation", [author], 1,) + (root_doc, "google-cloud-tasks", "google-cloud-tasks Documentation", [author], 1,) ] # If true, show URL addresses after external links. @@ -327,7 +328,7 @@ # dir menu entry, description, category) texinfo_documents = [ ( - master_doc, + root_doc, "google-cloud-tasks", "google-cloud-tasks Documentation", author, diff --git a/google/cloud/tasks_v2/services/cloud_tasks/client.py b/google/cloud/tasks_v2/services/cloud_tasks/client.py index a97427f0..41dd290a 100644 --- a/google/cloud/tasks_v2/services/cloud_tasks/client.py +++ b/google/cloud/tasks_v2/services/cloud_tasks/client.py @@ -17,7 +17,7 @@ from distutils import util import os import re -from typing import Callable, Dict, Optional, Sequence, Tuple, Type, Union +from typing import Dict, Optional, Sequence, Tuple, Type, Union import pkg_resources from google.api_core import client_options as client_options_lib # type: ignore @@ -378,7 +378,7 @@ def __init__( def list_queues( self, - request: cloudtasks.ListQueuesRequest = None, + request: Union[cloudtasks.ListQueuesRequest, dict] = None, *, parent: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -389,7 +389,7 @@ def list_queues( Queues are returned in lexicographical order. Args: - request (google.cloud.tasks_v2.types.ListQueuesRequest): + request (Union[google.cloud.tasks_v2.types.ListQueuesRequest, dict]): The request object. Request message for [ListQueues][google.cloud.tasks.v2.CloudTasks.ListQueues]. parent (str): @@ -459,7 +459,7 @@ def list_queues( def get_queue( self, - request: cloudtasks.GetQueueRequest = None, + request: Union[cloudtasks.GetQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -469,7 +469,7 @@ def get_queue( r"""Gets a queue. Args: - request (google.cloud.tasks_v2.types.GetQueueRequest): + request (Union[google.cloud.tasks_v2.types.GetQueueRequest, dict]): The request object. Request message for [GetQueue][google.cloud.tasks.v2.CloudTasks.GetQueue]. name (str): @@ -534,7 +534,7 @@ def get_queue( def create_queue( self, - request: cloudtasks.CreateQueueRequest = None, + request: Union[cloudtasks.CreateQueueRequest, dict] = None, *, parent: str = None, queue: gct_queue.Queue = None, @@ -555,7 +555,7 @@ def create_queue( before using this method. Args: - request (google.cloud.tasks_v2.types.CreateQueueRequest): + request (Union[google.cloud.tasks_v2.types.CreateQueueRequest, dict]): The request object. Request message for [CreateQueue][google.cloud.tasks.v2.CloudTasks.CreateQueue]. parent (str): @@ -636,7 +636,7 @@ def create_queue( def update_queue( self, - request: cloudtasks.UpdateQueueRequest = None, + request: Union[cloudtasks.UpdateQueueRequest, dict] = None, *, queue: gct_queue.Queue = None, update_mask: field_mask_pb2.FieldMask = None, @@ -660,7 +660,7 @@ def update_queue( before using this method. Args: - request (google.cloud.tasks_v2.types.UpdateQueueRequest): + request (Union[google.cloud.tasks_v2.types.UpdateQueueRequest, dict]): The request object. Request message for [UpdateQueue][google.cloud.tasks.v2.CloudTasks.UpdateQueue]. queue (google.cloud.tasks_v2.types.Queue): @@ -746,7 +746,7 @@ def update_queue( def delete_queue( self, - request: cloudtasks.DeleteQueueRequest = None, + request: Union[cloudtasks.DeleteQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -767,7 +767,7 @@ def delete_queue( before using this method. Args: - request (google.cloud.tasks_v2.types.DeleteQueueRequest): + request (Union[google.cloud.tasks_v2.types.DeleteQueueRequest, dict]): The request object. Request message for [DeleteQueue][google.cloud.tasks.v2.CloudTasks.DeleteQueue]. name (str): @@ -821,7 +821,7 @@ def delete_queue( def purge_queue( self, - request: cloudtasks.PurgeQueueRequest = None, + request: Union[cloudtasks.PurgeQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -836,7 +836,7 @@ def purge_queue( effect. A purge is irreversible. Args: - request (google.cloud.tasks_v2.types.PurgeQueueRequest): + request (Union[google.cloud.tasks_v2.types.PurgeQueueRequest, dict]): The request object. Request message for [PurgeQueue][google.cloud.tasks.v2.CloudTasks.PurgeQueue]. name (str): @@ -901,7 +901,7 @@ def purge_queue( def pause_queue( self, - request: cloudtasks.PauseQueueRequest = None, + request: Union[cloudtasks.PauseQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -918,7 +918,7 @@ def pause_queue( [PAUSED][google.cloud.tasks.v2.Queue.State.PAUSED]. Args: - request (google.cloud.tasks_v2.types.PauseQueueRequest): + request (Union[google.cloud.tasks_v2.types.PauseQueueRequest, dict]): The request object. Request message for [PauseQueue][google.cloud.tasks.v2.CloudTasks.PauseQueue]. name (str): @@ -983,7 +983,7 @@ def pause_queue( def resume_queue( self, - request: cloudtasks.ResumeQueueRequest = None, + request: Union[cloudtasks.ResumeQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1007,7 +1007,7 @@ def resume_queue( Risks `__. Args: - request (google.cloud.tasks_v2.types.ResumeQueueRequest): + request (Union[google.cloud.tasks_v2.types.ResumeQueueRequest, dict]): The request object. Request message for [ResumeQueue][google.cloud.tasks.v2.CloudTasks.ResumeQueue]. name (str): @@ -1072,7 +1072,7 @@ def resume_queue( def get_iam_policy( self, - request: iam_policy_pb2.GetIamPolicyRequest = None, + request: Union[iam_policy_pb2.GetIamPolicyRequest, dict] = None, *, resource: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1090,7 +1090,7 @@ def get_iam_policy( - ``cloudtasks.queues.getIamPolicy`` Args: - request (google.iam.v1.iam_policy_pb2.GetIamPolicyRequest): + request (Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]): The request object. Request message for `GetIamPolicy` method. resource (str): @@ -1205,7 +1205,7 @@ def get_iam_policy( def set_iam_policy( self, - request: iam_policy_pb2.SetIamPolicyRequest = None, + request: Union[iam_policy_pb2.SetIamPolicyRequest, dict] = None, *, resource: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1227,7 +1227,7 @@ def set_iam_policy( - ``cloudtasks.queues.setIamPolicy`` Args: - request (google.iam.v1.iam_policy_pb2.SetIamPolicyRequest): + request (Union[google.iam.v1.iam_policy_pb2.SetIamPolicyRequest, dict]): The request object. Request message for `SetIamPolicy` method. resource (str): @@ -1342,7 +1342,7 @@ def set_iam_policy( def test_iam_permissions( self, - request: iam_policy_pb2.TestIamPermissionsRequest = None, + request: Union[iam_policy_pb2.TestIamPermissionsRequest, dict] = None, *, resource: str = None, permissions: Sequence[str] = None, @@ -1361,7 +1361,7 @@ def test_iam_permissions( warning. Args: - request (google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest): + request (Union[google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest, dict]): The request object. Request message for `TestIamPermissions` method. resource (str): @@ -1432,7 +1432,7 @@ def test_iam_permissions( def list_tasks( self, - request: cloudtasks.ListTasksRequest = None, + request: Union[cloudtasks.ListTasksRequest, dict] = None, *, parent: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1451,7 +1451,7 @@ def list_tasks( at any time. Args: - request (google.cloud.tasks_v2.types.ListTasksRequest): + request (Union[google.cloud.tasks_v2.types.ListTasksRequest, dict]): The request object. Request message for listing tasks using [ListTasks][google.cloud.tasks.v2.CloudTasks.ListTasks]. @@ -1522,7 +1522,7 @@ def list_tasks( def get_task( self, - request: cloudtasks.GetTaskRequest = None, + request: Union[cloudtasks.GetTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1532,7 +1532,7 @@ def get_task( r"""Gets a task. Args: - request (google.cloud.tasks_v2.types.GetTaskRequest): + request (Union[google.cloud.tasks_v2.types.GetTaskRequest, dict]): The request object. Request message for getting a task using [GetTask][google.cloud.tasks.v2.CloudTasks.GetTask]. @@ -1592,7 +1592,7 @@ def get_task( def create_task( self, - request: cloudtasks.CreateTaskRequest = None, + request: Union[cloudtasks.CreateTaskRequest, dict] = None, *, parent: str = None, task: gct_task.Task = None, @@ -1608,7 +1608,7 @@ def create_task( - The maximum task size is 100KB. Args: - request (google.cloud.tasks_v2.types.CreateTaskRequest): + request (Union[google.cloud.tasks_v2.types.CreateTaskRequest, dict]): The request object. Request message for [CreateTask][google.cloud.tasks.v2.CloudTasks.CreateTask]. parent (str): @@ -1717,7 +1717,7 @@ def create_task( def delete_task( self, - request: cloudtasks.DeleteTaskRequest = None, + request: Union[cloudtasks.DeleteTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1730,7 +1730,7 @@ def delete_task( or permanently failed. Args: - request (google.cloud.tasks_v2.types.DeleteTaskRequest): + request (Union[google.cloud.tasks_v2.types.DeleteTaskRequest, dict]): The request object. Request message for deleting a task using [DeleteTask][google.cloud.tasks.v2.CloudTasks.DeleteTask]. @@ -1785,7 +1785,7 @@ def delete_task( def run_task( self, - request: cloudtasks.RunTaskRequest = None, + request: Union[cloudtasks.RunTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1821,7 +1821,7 @@ def run_task( task that has already succeeded or permanently failed. Args: - request (google.cloud.tasks_v2.types.RunTaskRequest): + request (Union[google.cloud.tasks_v2.types.RunTaskRequest, dict]): The request object. Request message for forcing a task to run now using [RunTask][google.cloud.tasks.v2.CloudTasks.RunTask]. diff --git a/google/cloud/tasks_v2/services/cloud_tasks/transports/base.py b/google/cloud/tasks_v2/services/cloud_tasks/transports/base.py index f79aae7f..23f24ae9 100644 --- a/google/cloud/tasks_v2/services/cloud_tasks/transports/base.py +++ b/google/cloud/tasks_v2/services/cloud_tasks/transports/base.py @@ -122,7 +122,7 @@ def __init__( **scopes_kwargs, quota_project_id=quota_project_id ) - # If the credentials is service account credentials, then always try to use self signed JWT. + # 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) diff --git a/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc.py b/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc.py index cfc89672..d0a83281 100644 --- a/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc.py +++ b/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc.py @@ -88,16 +88,16 @@ def __init__( api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint. If provided, it overrides the ``host`` argument and tries to create a mutual TLS channel with client SSL credentials from - ``client_cert_source`` or applicatin default SSL credentials. + ``client_cert_source`` or application default SSL credentials. client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]): Deprecated. A callback to provide client SSL certificate bytes and private key bytes, both in PEM format. It is ignored if ``api_mtls_endpoint`` is None. ssl_channel_credentials (grpc.ChannelCredentials): SSL credentials - for grpc channel. It is ignored if ``channel`` is provided. + for the grpc channel. It is ignored if ``channel`` is provided. client_cert_source_for_mtls (Optional[Callable[[], Tuple[bytes, bytes]]]): A callback to provide client certificate bytes and private key bytes, - both in PEM format. It is used to configure mutual TLS channel. It is + both in PEM format. It is used to configure a mutual TLS channel. It is ignored if ``channel`` or ``ssl_channel_credentials`` is provided. quota_project_id (Optional[str]): An optional project to use for billing and quota. diff --git a/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc_asyncio.py b/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc_asyncio.py index 1dead937..ae9c4762 100644 --- a/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc_asyncio.py +++ b/google/cloud/tasks_v2/services/cloud_tasks/transports/grpc_asyncio.py @@ -135,16 +135,16 @@ def __init__( api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint. If provided, it overrides the ``host`` argument and tries to create a mutual TLS channel with client SSL credentials from - ``client_cert_source`` or applicatin default SSL credentials. + ``client_cert_source`` or application default SSL credentials. client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]): Deprecated. A callback to provide client SSL certificate bytes and private key bytes, both in PEM format. It is ignored if ``api_mtls_endpoint`` is None. ssl_channel_credentials (grpc.ChannelCredentials): SSL credentials - for grpc channel. It is ignored if ``channel`` is provided. + for the grpc channel. It is ignored if ``channel`` is provided. client_cert_source_for_mtls (Optional[Callable[[], Tuple[bytes, bytes]]]): A callback to provide client certificate bytes and private key bytes, - both in PEM format. It is used to configure mutual TLS channel. It is + both in PEM format. It is used to configure a mutual TLS channel. It is ignored if ``channel`` or ``ssl_channel_credentials`` is provided. quota_project_id (Optional[str]): An optional project to use for billing and quota. diff --git a/google/cloud/tasks_v2beta2/services/cloud_tasks/client.py b/google/cloud/tasks_v2beta2/services/cloud_tasks/client.py index 266ba811..fa9e61c7 100644 --- a/google/cloud/tasks_v2beta2/services/cloud_tasks/client.py +++ b/google/cloud/tasks_v2beta2/services/cloud_tasks/client.py @@ -17,7 +17,7 @@ from distutils import util import os import re -from typing import Callable, Dict, Optional, Sequence, Tuple, Type, Union +from typing import Dict, Optional, Sequence, Tuple, Type, Union import pkg_resources from google.api_core import client_options as client_options_lib # type: ignore @@ -378,7 +378,7 @@ def __init__( def list_queues( self, - request: cloudtasks.ListQueuesRequest = None, + request: Union[cloudtasks.ListQueuesRequest, dict] = None, *, parent: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -389,7 +389,7 @@ def list_queues( Queues are returned in lexicographical order. Args: - request (google.cloud.tasks_v2beta2.types.ListQueuesRequest): + request (Union[google.cloud.tasks_v2beta2.types.ListQueuesRequest, dict]): The request object. Request message for [ListQueues][google.cloud.tasks.v2beta2.CloudTasks.ListQueues]. parent (str): @@ -459,7 +459,7 @@ def list_queues( def get_queue( self, - request: cloudtasks.GetQueueRequest = None, + request: Union[cloudtasks.GetQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -469,7 +469,7 @@ def get_queue( r"""Gets a queue. Args: - request (google.cloud.tasks_v2beta2.types.GetQueueRequest): + request (Union[google.cloud.tasks_v2beta2.types.GetQueueRequest, dict]): The request object. Request message for [GetQueue][google.cloud.tasks.v2beta2.CloudTasks.GetQueue]. name (str): @@ -534,7 +534,7 @@ def get_queue( def create_queue( self, - request: cloudtasks.CreateQueueRequest = None, + request: Union[cloudtasks.CreateQueueRequest, dict] = None, *, parent: str = None, queue: gct_queue.Queue = None, @@ -555,7 +555,7 @@ def create_queue( before using this method. Args: - request (google.cloud.tasks_v2beta2.types.CreateQueueRequest): + request (Union[google.cloud.tasks_v2beta2.types.CreateQueueRequest, dict]): The request object. Request message for [CreateQueue][google.cloud.tasks.v2beta2.CloudTasks.CreateQueue]. parent (str): @@ -636,7 +636,7 @@ def create_queue( def update_queue( self, - request: cloudtasks.UpdateQueueRequest = None, + request: Union[cloudtasks.UpdateQueueRequest, dict] = None, *, queue: gct_queue.Queue = None, update_mask: field_mask_pb2.FieldMask = None, @@ -660,7 +660,7 @@ def update_queue( before using this method. Args: - request (google.cloud.tasks_v2beta2.types.UpdateQueueRequest): + request (Union[google.cloud.tasks_v2beta2.types.UpdateQueueRequest, dict]): The request object. Request message for [UpdateQueue][google.cloud.tasks.v2beta2.CloudTasks.UpdateQueue]. queue (google.cloud.tasks_v2beta2.types.Queue): @@ -747,7 +747,7 @@ def update_queue( def delete_queue( self, - request: cloudtasks.DeleteQueueRequest = None, + request: Union[cloudtasks.DeleteQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -768,7 +768,7 @@ def delete_queue( before using this method. Args: - request (google.cloud.tasks_v2beta2.types.DeleteQueueRequest): + request (Union[google.cloud.tasks_v2beta2.types.DeleteQueueRequest, dict]): The request object. Request message for [DeleteQueue][google.cloud.tasks.v2beta2.CloudTasks.DeleteQueue]. name (str): @@ -822,7 +822,7 @@ def delete_queue( def purge_queue( self, - request: cloudtasks.PurgeQueueRequest = None, + request: Union[cloudtasks.PurgeQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -837,7 +837,7 @@ def purge_queue( effect. A purge is irreversible. Args: - request (google.cloud.tasks_v2beta2.types.PurgeQueueRequest): + request (Union[google.cloud.tasks_v2beta2.types.PurgeQueueRequest, dict]): The request object. Request message for [PurgeQueue][google.cloud.tasks.v2beta2.CloudTasks.PurgeQueue]. name (str): @@ -902,7 +902,7 @@ def purge_queue( def pause_queue( self, - request: cloudtasks.PauseQueueRequest = None, + request: Union[cloudtasks.PauseQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -919,7 +919,7 @@ def pause_queue( [PAUSED][google.cloud.tasks.v2beta2.Queue.State.PAUSED]. Args: - request (google.cloud.tasks_v2beta2.types.PauseQueueRequest): + request (Union[google.cloud.tasks_v2beta2.types.PauseQueueRequest, dict]): The request object. Request message for [PauseQueue][google.cloud.tasks.v2beta2.CloudTasks.PauseQueue]. name (str): @@ -984,7 +984,7 @@ def pause_queue( def resume_queue( self, - request: cloudtasks.ResumeQueueRequest = None, + request: Union[cloudtasks.ResumeQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1008,7 +1008,7 @@ def resume_queue( Risks `__. Args: - request (google.cloud.tasks_v2beta2.types.ResumeQueueRequest): + request (Union[google.cloud.tasks_v2beta2.types.ResumeQueueRequest, dict]): The request object. Request message for [ResumeQueue][google.cloud.tasks.v2beta2.CloudTasks.ResumeQueue]. name (str): @@ -1073,7 +1073,7 @@ def resume_queue( def get_iam_policy( self, - request: iam_policy_pb2.GetIamPolicyRequest = None, + request: Union[iam_policy_pb2.GetIamPolicyRequest, dict] = None, *, resource: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1091,7 +1091,7 @@ def get_iam_policy( - ``cloudtasks.queues.getIamPolicy`` Args: - request (google.iam.v1.iam_policy_pb2.GetIamPolicyRequest): + request (Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]): The request object. Request message for `GetIamPolicy` method. resource (str): @@ -1206,7 +1206,7 @@ def get_iam_policy( def set_iam_policy( self, - request: iam_policy_pb2.SetIamPolicyRequest = None, + request: Union[iam_policy_pb2.SetIamPolicyRequest, dict] = None, *, resource: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1228,7 +1228,7 @@ def set_iam_policy( - ``cloudtasks.queues.setIamPolicy`` Args: - request (google.iam.v1.iam_policy_pb2.SetIamPolicyRequest): + request (Union[google.iam.v1.iam_policy_pb2.SetIamPolicyRequest, dict]): The request object. Request message for `SetIamPolicy` method. resource (str): @@ -1343,7 +1343,7 @@ def set_iam_policy( def test_iam_permissions( self, - request: iam_policy_pb2.TestIamPermissionsRequest = None, + request: Union[iam_policy_pb2.TestIamPermissionsRequest, dict] = None, *, resource: str = None, permissions: Sequence[str] = None, @@ -1362,7 +1362,7 @@ def test_iam_permissions( warning. Args: - request (google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest): + request (Union[google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest, dict]): The request object. Request message for `TestIamPermissions` method. resource (str): @@ -1433,7 +1433,7 @@ def test_iam_permissions( def list_tasks( self, - request: cloudtasks.ListTasksRequest = None, + request: Union[cloudtasks.ListTasksRequest, dict] = None, *, parent: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1452,7 +1452,7 @@ def list_tasks( at any time. Args: - request (google.cloud.tasks_v2beta2.types.ListTasksRequest): + request (Union[google.cloud.tasks_v2beta2.types.ListTasksRequest, dict]): The request object. Request message for listing tasks using [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. @@ -1523,7 +1523,7 @@ def list_tasks( def get_task( self, - request: cloudtasks.GetTaskRequest = None, + request: Union[cloudtasks.GetTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1533,7 +1533,7 @@ def get_task( r"""Gets a task. Args: - request (google.cloud.tasks_v2beta2.types.GetTaskRequest): + request (Union[google.cloud.tasks_v2beta2.types.GetTaskRequest, dict]): The request object. Request message for getting a task using [GetTask][google.cloud.tasks.v2beta2.CloudTasks.GetTask]. @@ -1593,7 +1593,7 @@ def get_task( def create_task( self, - request: cloudtasks.CreateTaskRequest = None, + request: Union[cloudtasks.CreateTaskRequest, dict] = None, *, parent: str = None, task: gct_task.Task = None, @@ -1613,7 +1613,7 @@ def create_task( maximum task size is 1MB. Args: - request (google.cloud.tasks_v2beta2.types.CreateTaskRequest): + request (Union[google.cloud.tasks_v2beta2.types.CreateTaskRequest, dict]): The request object. Request message for [CreateTask][google.cloud.tasks.v2beta2.CloudTasks.CreateTask]. parent (str): @@ -1722,7 +1722,7 @@ def create_task( def delete_task( self, - request: cloudtasks.DeleteTaskRequest = None, + request: Union[cloudtasks.DeleteTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1735,7 +1735,7 @@ def delete_task( successfully or permanently failed. Args: - request (google.cloud.tasks_v2beta2.types.DeleteTaskRequest): + request (Union[google.cloud.tasks_v2beta2.types.DeleteTaskRequest, dict]): The request object. Request message for deleting a task using [DeleteTask][google.cloud.tasks.v2beta2.CloudTasks.DeleteTask]. @@ -1790,7 +1790,7 @@ def delete_task( def lease_tasks( self, - request: cloudtasks.LeaseTasksRequest = None, + request: Union[cloudtasks.LeaseTasksRequest, dict] = None, *, parent: str = None, lease_duration: duration_pb2.Duration = None, @@ -1824,7 +1824,7 @@ def lease_tasks( is exceeded. Args: - request (google.cloud.tasks_v2beta2.types.LeaseTasksRequest): + request (Union[google.cloud.tasks_v2beta2.types.LeaseTasksRequest, dict]): The request object. Request message for leasing tasks using [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. @@ -1918,7 +1918,7 @@ def lease_tasks( def acknowledge_task( self, - request: cloudtasks.AcknowledgeTaskRequest = None, + request: Union[cloudtasks.AcknowledgeTaskRequest, dict] = None, *, name: str = None, schedule_time: timestamp_pb2.Timestamp = None, @@ -1943,7 +1943,7 @@ def acknowledge_task( [ListTasks][google.cloud.tasks.v2beta2.CloudTasks.ListTasks]. Args: - request (google.cloud.tasks_v2beta2.types.AcknowledgeTaskRequest): + request (Union[google.cloud.tasks_v2beta2.types.AcknowledgeTaskRequest, dict]): The request object. Request message for acknowledging a task using [AcknowledgeTask][google.cloud.tasks.v2beta2.CloudTasks.AcknowledgeTask]. @@ -2014,7 +2014,7 @@ def acknowledge_task( def renew_lease( self, - request: cloudtasks.RenewLeaseRequest = None, + request: Union[cloudtasks.RenewLeaseRequest, dict] = None, *, name: str = None, schedule_time: timestamp_pb2.Timestamp = None, @@ -2031,7 +2031,7 @@ def renew_lease( [schedule_time][google.cloud.tasks.v2beta2.Task.schedule_time]. Args: - request (google.cloud.tasks_v2beta2.types.RenewLeaseRequest): + request (Union[google.cloud.tasks_v2beta2.types.RenewLeaseRequest, dict]): The request object. Request message for renewing a lease using [RenewLease][google.cloud.tasks.v2beta2.CloudTasks.RenewLease]. @@ -2119,7 +2119,7 @@ def renew_lease( def cancel_lease( self, - request: cloudtasks.CancelLeaseRequest = None, + request: Union[cloudtasks.CancelLeaseRequest, dict] = None, *, name: str = None, schedule_time: timestamp_pb2.Timestamp = None, @@ -2137,7 +2137,7 @@ def cancel_lease( [LeaseTasks][google.cloud.tasks.v2beta2.CloudTasks.LeaseTasks]. Args: - request (google.cloud.tasks_v2beta2.types.CancelLeaseRequest): + request (Union[google.cloud.tasks_v2beta2.types.CancelLeaseRequest, dict]): The request object. Request message for canceling a lease using [CancelLease][google.cloud.tasks.v2beta2.CloudTasks.CancelLease]. @@ -2213,7 +2213,7 @@ def cancel_lease( def run_task( self, - request: cloudtasks.RunTaskRequest = None, + request: Union[cloudtasks.RunTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -2255,7 +2255,7 @@ def run_task( task][google.cloud.tasks.v2beta2.PullMessage]. Args: - request (google.cloud.tasks_v2beta2.types.RunTaskRequest): + request (Union[google.cloud.tasks_v2beta2.types.RunTaskRequest, dict]): The request object. Request message for forcing a task to run now using [RunTask][google.cloud.tasks.v2beta2.CloudTasks.RunTask]. diff --git a/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/base.py b/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/base.py index 609a04a3..c5cd9161 100644 --- a/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/base.py +++ b/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/base.py @@ -122,7 +122,7 @@ def __init__( **scopes_kwargs, quota_project_id=quota_project_id ) - # If the credentials is service account credentials, then always try to use self signed JWT. + # 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) diff --git a/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc.py b/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc.py index 100d45b1..bb239d66 100644 --- a/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc.py +++ b/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc.py @@ -88,16 +88,16 @@ def __init__( api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint. If provided, it overrides the ``host`` argument and tries to create a mutual TLS channel with client SSL credentials from - ``client_cert_source`` or applicatin default SSL credentials. + ``client_cert_source`` or application default SSL credentials. client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]): Deprecated. A callback to provide client SSL certificate bytes and private key bytes, both in PEM format. It is ignored if ``api_mtls_endpoint`` is None. ssl_channel_credentials (grpc.ChannelCredentials): SSL credentials - for grpc channel. It is ignored if ``channel`` is provided. + for the grpc channel. It is ignored if ``channel`` is provided. client_cert_source_for_mtls (Optional[Callable[[], Tuple[bytes, bytes]]]): A callback to provide client certificate bytes and private key bytes, - both in PEM format. It is used to configure mutual TLS channel. It is + both in PEM format. It is used to configure a mutual TLS channel. It is ignored if ``channel`` or ``ssl_channel_credentials`` is provided. quota_project_id (Optional[str]): An optional project to use for billing and quota. diff --git a/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc_asyncio.py b/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc_asyncio.py index f371b59b..8659618c 100644 --- a/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc_asyncio.py +++ b/google/cloud/tasks_v2beta2/services/cloud_tasks/transports/grpc_asyncio.py @@ -135,16 +135,16 @@ def __init__( api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint. If provided, it overrides the ``host`` argument and tries to create a mutual TLS channel with client SSL credentials from - ``client_cert_source`` or applicatin default SSL credentials. + ``client_cert_source`` or application default SSL credentials. client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]): Deprecated. A callback to provide client SSL certificate bytes and private key bytes, both in PEM format. It is ignored if ``api_mtls_endpoint`` is None. ssl_channel_credentials (grpc.ChannelCredentials): SSL credentials - for grpc channel. It is ignored if ``channel`` is provided. + for the grpc channel. It is ignored if ``channel`` is provided. client_cert_source_for_mtls (Optional[Callable[[], Tuple[bytes, bytes]]]): A callback to provide client certificate bytes and private key bytes, - both in PEM format. It is used to configure mutual TLS channel. It is + both in PEM format. It is used to configure a mutual TLS channel. It is ignored if ``channel`` or ``ssl_channel_credentials`` is provided. quota_project_id (Optional[str]): An optional project to use for billing and quota. diff --git a/google/cloud/tasks_v2beta3/services/cloud_tasks/client.py b/google/cloud/tasks_v2beta3/services/cloud_tasks/client.py index 6f4951c4..5a3f09f2 100644 --- a/google/cloud/tasks_v2beta3/services/cloud_tasks/client.py +++ b/google/cloud/tasks_v2beta3/services/cloud_tasks/client.py @@ -17,7 +17,7 @@ from distutils import util import os import re -from typing import Callable, Dict, Optional, Sequence, Tuple, Type, Union +from typing import Dict, Optional, Sequence, Tuple, Type, Union import pkg_resources from google.api_core import client_options as client_options_lib # type: ignore @@ -378,7 +378,7 @@ def __init__( def list_queues( self, - request: cloudtasks.ListQueuesRequest = None, + request: Union[cloudtasks.ListQueuesRequest, dict] = None, *, parent: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -389,7 +389,7 @@ def list_queues( Queues are returned in lexicographical order. Args: - request (google.cloud.tasks_v2beta3.types.ListQueuesRequest): + request (Union[google.cloud.tasks_v2beta3.types.ListQueuesRequest, dict]): The request object. Request message for [ListQueues][google.cloud.tasks.v2beta3.CloudTasks.ListQueues]. parent (str): @@ -459,7 +459,7 @@ def list_queues( def get_queue( self, - request: cloudtasks.GetQueueRequest = None, + request: Union[cloudtasks.GetQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -469,7 +469,7 @@ def get_queue( r"""Gets a queue. Args: - request (google.cloud.tasks_v2beta3.types.GetQueueRequest): + request (Union[google.cloud.tasks_v2beta3.types.GetQueueRequest, dict]): The request object. Request message for [GetQueue][google.cloud.tasks.v2beta3.CloudTasks.GetQueue]. name (str): @@ -534,7 +534,7 @@ def get_queue( def create_queue( self, - request: cloudtasks.CreateQueueRequest = None, + request: Union[cloudtasks.CreateQueueRequest, dict] = None, *, parent: str = None, queue: gct_queue.Queue = None, @@ -555,7 +555,7 @@ def create_queue( before using this method. Args: - request (google.cloud.tasks_v2beta3.types.CreateQueueRequest): + request (Union[google.cloud.tasks_v2beta3.types.CreateQueueRequest, dict]): The request object. Request message for [CreateQueue][google.cloud.tasks.v2beta3.CloudTasks.CreateQueue]. parent (str): @@ -636,7 +636,7 @@ def create_queue( def update_queue( self, - request: cloudtasks.UpdateQueueRequest = None, + request: Union[cloudtasks.UpdateQueueRequest, dict] = None, *, queue: gct_queue.Queue = None, update_mask: field_mask_pb2.FieldMask = None, @@ -660,7 +660,7 @@ def update_queue( before using this method. Args: - request (google.cloud.tasks_v2beta3.types.UpdateQueueRequest): + request (Union[google.cloud.tasks_v2beta3.types.UpdateQueueRequest, dict]): The request object. Request message for [UpdateQueue][google.cloud.tasks.v2beta3.CloudTasks.UpdateQueue]. queue (google.cloud.tasks_v2beta3.types.Queue): @@ -747,7 +747,7 @@ def update_queue( def delete_queue( self, - request: cloudtasks.DeleteQueueRequest = None, + request: Union[cloudtasks.DeleteQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -768,7 +768,7 @@ def delete_queue( before using this method. Args: - request (google.cloud.tasks_v2beta3.types.DeleteQueueRequest): + request (Union[google.cloud.tasks_v2beta3.types.DeleteQueueRequest, dict]): The request object. Request message for [DeleteQueue][google.cloud.tasks.v2beta3.CloudTasks.DeleteQueue]. name (str): @@ -822,7 +822,7 @@ def delete_queue( def purge_queue( self, - request: cloudtasks.PurgeQueueRequest = None, + request: Union[cloudtasks.PurgeQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -837,7 +837,7 @@ def purge_queue( effect. A purge is irreversible. Args: - request (google.cloud.tasks_v2beta3.types.PurgeQueueRequest): + request (Union[google.cloud.tasks_v2beta3.types.PurgeQueueRequest, dict]): The request object. Request message for [PurgeQueue][google.cloud.tasks.v2beta3.CloudTasks.PurgeQueue]. name (str): @@ -902,7 +902,7 @@ def purge_queue( def pause_queue( self, - request: cloudtasks.PauseQueueRequest = None, + request: Union[cloudtasks.PauseQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -919,7 +919,7 @@ def pause_queue( [PAUSED][google.cloud.tasks.v2beta3.Queue.State.PAUSED]. Args: - request (google.cloud.tasks_v2beta3.types.PauseQueueRequest): + request (Union[google.cloud.tasks_v2beta3.types.PauseQueueRequest, dict]): The request object. Request message for [PauseQueue][google.cloud.tasks.v2beta3.CloudTasks.PauseQueue]. name (str): @@ -984,7 +984,7 @@ def pause_queue( def resume_queue( self, - request: cloudtasks.ResumeQueueRequest = None, + request: Union[cloudtasks.ResumeQueueRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1008,7 +1008,7 @@ def resume_queue( Risks `__. Args: - request (google.cloud.tasks_v2beta3.types.ResumeQueueRequest): + request (Union[google.cloud.tasks_v2beta3.types.ResumeQueueRequest, dict]): The request object. Request message for [ResumeQueue][google.cloud.tasks.v2beta3.CloudTasks.ResumeQueue]. name (str): @@ -1073,7 +1073,7 @@ def resume_queue( def get_iam_policy( self, - request: iam_policy_pb2.GetIamPolicyRequest = None, + request: Union[iam_policy_pb2.GetIamPolicyRequest, dict] = None, *, resource: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1091,7 +1091,7 @@ def get_iam_policy( - ``cloudtasks.queues.getIamPolicy`` Args: - request (google.iam.v1.iam_policy_pb2.GetIamPolicyRequest): + request (Union[google.iam.v1.iam_policy_pb2.GetIamPolicyRequest, dict]): The request object. Request message for `GetIamPolicy` method. resource (str): @@ -1206,7 +1206,7 @@ def get_iam_policy( def set_iam_policy( self, - request: iam_policy_pb2.SetIamPolicyRequest = None, + request: Union[iam_policy_pb2.SetIamPolicyRequest, dict] = None, *, resource: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1228,7 +1228,7 @@ def set_iam_policy( - ``cloudtasks.queues.setIamPolicy`` Args: - request (google.iam.v1.iam_policy_pb2.SetIamPolicyRequest): + request (Union[google.iam.v1.iam_policy_pb2.SetIamPolicyRequest, dict]): The request object. Request message for `SetIamPolicy` method. resource (str): @@ -1343,7 +1343,7 @@ def set_iam_policy( def test_iam_permissions( self, - request: iam_policy_pb2.TestIamPermissionsRequest = None, + request: Union[iam_policy_pb2.TestIamPermissionsRequest, dict] = None, *, resource: str = None, permissions: Sequence[str] = None, @@ -1362,7 +1362,7 @@ def test_iam_permissions( warning. Args: - request (google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest): + request (Union[google.iam.v1.iam_policy_pb2.TestIamPermissionsRequest, dict]): The request object. Request message for `TestIamPermissions` method. resource (str): @@ -1433,7 +1433,7 @@ def test_iam_permissions( def list_tasks( self, - request: cloudtasks.ListTasksRequest = None, + request: Union[cloudtasks.ListTasksRequest, dict] = None, *, parent: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1452,7 +1452,7 @@ def list_tasks( at any time. Args: - request (google.cloud.tasks_v2beta3.types.ListTasksRequest): + request (Union[google.cloud.tasks_v2beta3.types.ListTasksRequest, dict]): The request object. Request message for listing tasks using [ListTasks][google.cloud.tasks.v2beta3.CloudTasks.ListTasks]. @@ -1523,7 +1523,7 @@ def list_tasks( def get_task( self, - request: cloudtasks.GetTaskRequest = None, + request: Union[cloudtasks.GetTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1533,7 +1533,7 @@ def get_task( r"""Gets a task. Args: - request (google.cloud.tasks_v2beta3.types.GetTaskRequest): + request (Union[google.cloud.tasks_v2beta3.types.GetTaskRequest, dict]): The request object. Request message for getting a task using [GetTask][google.cloud.tasks.v2beta3.CloudTasks.GetTask]. @@ -1593,7 +1593,7 @@ def get_task( def create_task( self, - request: cloudtasks.CreateTaskRequest = None, + request: Union[cloudtasks.CreateTaskRequest, dict] = None, *, parent: str = None, task: gct_task.Task = None, @@ -1609,7 +1609,7 @@ def create_task( - The maximum task size is 100KB. Args: - request (google.cloud.tasks_v2beta3.types.CreateTaskRequest): + request (Union[google.cloud.tasks_v2beta3.types.CreateTaskRequest, dict]): The request object. Request message for [CreateTask][google.cloud.tasks.v2beta3.CloudTasks.CreateTask]. parent (str): @@ -1718,7 +1718,7 @@ def create_task( def delete_task( self, - request: cloudtasks.DeleteTaskRequest = None, + request: Union[cloudtasks.DeleteTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1731,7 +1731,7 @@ def delete_task( or permanently failed. Args: - request (google.cloud.tasks_v2beta3.types.DeleteTaskRequest): + request (Union[google.cloud.tasks_v2beta3.types.DeleteTaskRequest, dict]): The request object. Request message for deleting a task using [DeleteTask][google.cloud.tasks.v2beta3.CloudTasks.DeleteTask]. @@ -1786,7 +1786,7 @@ def delete_task( def run_task( self, - request: cloudtasks.RunTaskRequest = None, + request: Union[cloudtasks.RunTaskRequest, dict] = None, *, name: str = None, retry: retries.Retry = gapic_v1.method.DEFAULT, @@ -1823,7 +1823,7 @@ def run_task( task that has already succeeded or permanently failed. Args: - request (google.cloud.tasks_v2beta3.types.RunTaskRequest): + request (Union[google.cloud.tasks_v2beta3.types.RunTaskRequest, dict]): The request object. Request message for forcing a task to run now using [RunTask][google.cloud.tasks.v2beta3.CloudTasks.RunTask]. diff --git a/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/base.py b/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/base.py index cc7d0b7a..57d6f663 100644 --- a/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/base.py +++ b/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/base.py @@ -122,7 +122,7 @@ def __init__( **scopes_kwargs, quota_project_id=quota_project_id ) - # If the credentials is service account credentials, then always try to use self signed JWT. + # 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) diff --git a/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/grpc.py b/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/grpc.py index 1000b6b0..5e0bb0e5 100644 --- a/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/grpc.py +++ b/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/grpc.py @@ -88,16 +88,16 @@ def __init__( api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint. If provided, it overrides the ``host`` argument and tries to create a mutual TLS channel with client SSL credentials from - ``client_cert_source`` or applicatin default SSL credentials. + ``client_cert_source`` or application default SSL credentials. client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]): Deprecated. A callback to provide client SSL certificate bytes and private key bytes, both in PEM format. It is ignored if ``api_mtls_endpoint`` is None. ssl_channel_credentials (grpc.ChannelCredentials): SSL credentials - for grpc channel. It is ignored if ``channel`` is provided. + for the grpc channel. It is ignored if ``channel`` is provided. client_cert_source_for_mtls (Optional[Callable[[], Tuple[bytes, bytes]]]): A callback to provide client certificate bytes and private key bytes, - both in PEM format. It is used to configure mutual TLS channel. It is + both in PEM format. It is used to configure a mutual TLS channel. It is ignored if ``channel`` or ``ssl_channel_credentials`` is provided. quota_project_id (Optional[str]): An optional project to use for billing and quota. diff --git a/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/grpc_asyncio.py b/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/grpc_asyncio.py index f10ad55a..c4f26ad4 100644 --- a/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/grpc_asyncio.py +++ b/google/cloud/tasks_v2beta3/services/cloud_tasks/transports/grpc_asyncio.py @@ -135,16 +135,16 @@ def __init__( api_mtls_endpoint (Optional[str]): Deprecated. The mutual TLS endpoint. If provided, it overrides the ``host`` argument and tries to create a mutual TLS channel with client SSL credentials from - ``client_cert_source`` or applicatin default SSL credentials. + ``client_cert_source`` or application default SSL credentials. client_cert_source (Optional[Callable[[], Tuple[bytes, bytes]]]): Deprecated. A callback to provide client SSL certificate bytes and private key bytes, both in PEM format. It is ignored if ``api_mtls_endpoint`` is None. ssl_channel_credentials (grpc.ChannelCredentials): SSL credentials - for grpc channel. It is ignored if ``channel`` is provided. + for the grpc channel. It is ignored if ``channel`` is provided. client_cert_source_for_mtls (Optional[Callable[[], Tuple[bytes, bytes]]]): A callback to provide client certificate bytes and private key bytes, - both in PEM format. It is used to configure mutual TLS channel. It is + both in PEM format. It is used to configure a mutual TLS channel. It is ignored if ``channel`` or ``ssl_channel_credentials`` is provided. quota_project_id (Optional[str]): An optional project to use for billing and quota. diff --git a/noxfile.py b/noxfile.py index 03aa2f58..2bf3ffd7 100644 --- a/noxfile.py +++ b/noxfile.py @@ -84,9 +84,15 @@ def default(session): constraints_path = str( CURRENT_DIRECTORY / "testing" / f"constraints-{session.python}.txt" ) - session.install("asyncmock", "pytest-asyncio", "-c", constraints_path) - - session.install("mock", "pytest", "pytest-cov", "-c", constraints_path) + session.install( + "mock", + "asyncmock", + "pytest", + "pytest-cov", + "pytest-asyncio", + "-c", + constraints_path, + ) session.install("-e", ".", "-c", constraints_path) diff --git a/renovate.json b/renovate.json index c0489556..c21036d3 100644 --- a/renovate.json +++ b/renovate.json @@ -1,6 +1,9 @@ { "extends": [ - "config:base", ":preserveSemverRanges" + "config:base", + "group:all", + ":preserveSemverRanges", + ":disableDependencyDashboard" ], "ignorePaths": [".pre-commit-config.yaml"], "pip_requirements": { diff --git a/samples/snippets/noxfile.py b/samples/snippets/noxfile.py index 6a8ccdae..b008613f 100644 --- a/samples/snippets/noxfile.py +++ b/samples/snippets/noxfile.py @@ -39,17 +39,15 @@ TEST_CONFIG = { # You can opt out from the test for specific Python versions. - 'ignored_versions': ["2.7"], - + "ignored_versions": [], # Old samples are opted out of enforcing Python type hints # All new samples should feature them - 'enforce_type_hints': False, - + "enforce_type_hints": False, # An envvar key for determining the project id to use. Change it # to 'BUILD_SPECIFIC_GCLOUD_PROJECT' if you want to opt in using a # build specific Cloud project. You can also use your own string # to use your own Cloud project. - 'gcloud_project_env': 'GOOGLE_CLOUD_PROJECT', + "gcloud_project_env": "GOOGLE_CLOUD_PROJECT", # 'gcloud_project_env': 'BUILD_SPECIFIC_GCLOUD_PROJECT', # If you need to use a specific version of pip, # change pip_version_override to the string representation @@ -57,13 +55,13 @@ "pip_version_override": None, # A dictionary you want to inject into your test. Don't put any # secrets here. These values will override predefined values. - 'envs': {}, + "envs": {}, } try: # Ensure we can import noxfile_config in the project's directory. - sys.path.append('.') + sys.path.append(".") from noxfile_config import TEST_CONFIG_OVERRIDE except ImportError as e: print("No user noxfile_config found: detail: {}".format(e)) @@ -78,25 +76,28 @@ def get_pytest_env_vars() -> Dict[str, str]: ret = {} # Override the GCLOUD_PROJECT and the alias. - env_key = TEST_CONFIG['gcloud_project_env'] + env_key = TEST_CONFIG["gcloud_project_env"] # This should error out if not set. - ret['GOOGLE_CLOUD_PROJECT'] = os.environ[env_key] + ret["GOOGLE_CLOUD_PROJECT"] = os.environ[env_key] # Apply user supplied envs. - ret.update(TEST_CONFIG['envs']) + ret.update(TEST_CONFIG["envs"]) return ret # DO NOT EDIT - automatically generated. -# All versions used to tested samples. -ALL_VERSIONS = ["2.7", "3.6", "3.7", "3.8", "3.9"] +# All versions used to test samples. +ALL_VERSIONS = ["3.6", "3.7", "3.8", "3.9"] # Any default versions that should be ignored. -IGNORED_VERSIONS = TEST_CONFIG['ignored_versions'] +IGNORED_VERSIONS = TEST_CONFIG["ignored_versions"] TESTED_VERSIONS = sorted([v for v in ALL_VERSIONS if v not in IGNORED_VERSIONS]) -INSTALL_LIBRARY_FROM_SOURCE = bool(os.environ.get("INSTALL_LIBRARY_FROM_SOURCE", False)) +INSTALL_LIBRARY_FROM_SOURCE = os.environ.get("INSTALL_LIBRARY_FROM_SOURCE", False) in ( + "True", + "true", +) # # Style Checks # @@ -141,7 +142,7 @@ def _determine_local_import_names(start_dir: str) -> List[str]: @nox.session def lint(session: nox.sessions.Session) -> None: - if not TEST_CONFIG['enforce_type_hints']: + if not TEST_CONFIG["enforce_type_hints"]: session.install("flake8", "flake8-import-order") else: session.install("flake8", "flake8-import-order", "flake8-annotations") @@ -150,9 +151,11 @@ def lint(session: nox.sessions.Session) -> None: args = FLAKE8_COMMON_ARGS + [ "--application-import-names", ",".join(local_names), - "." + ".", ] session.run("flake8", *args) + + # # Black # @@ -165,6 +168,7 @@ def blacken(session: nox.sessions.Session) -> None: session.run("black", *python_files) + # # Sample Tests # @@ -173,7 +177,9 @@ def blacken(session: nox.sessions.Session) -> None: PYTEST_COMMON_ARGS = ["--junitxml=sponge_log.xml"] -def _session_tests(session: nox.sessions.Session, post_install: Callable = None) -> None: +def _session_tests( + session: nox.sessions.Session, post_install: Callable = None +) -> None: if TEST_CONFIG["pip_version_override"]: pip_version = TEST_CONFIG["pip_version_override"] session.install(f"pip=={pip_version}") @@ -203,7 +209,7 @@ def _session_tests(session: nox.sessions.Session, post_install: Callable = None) # on travis where slow and flaky tests are excluded. # See http://doc.pytest.org/en/latest/_modules/_pytest/main.html success_codes=[0, 5], - env=get_pytest_env_vars() + env=get_pytest_env_vars(), ) @@ -213,9 +219,9 @@ def py(session: nox.sessions.Session) -> None: if session.python in TESTED_VERSIONS: _session_tests(session) else: - session.skip("SKIPPED: {} tests are disabled for this sample.".format( - session.python - )) + session.skip( + "SKIPPED: {} tests are disabled for this sample.".format(session.python) + ) # diff --git a/samples/snippets/requirements-test.txt b/samples/snippets/requirements-test.txt index 95ea1e6a..92709451 100644 --- a/samples/snippets/requirements-test.txt +++ b/samples/snippets/requirements-test.txt @@ -1 +1 @@ -pytest==6.2.4 +pytest==6.2.5 diff --git a/samples/snippets/requirements.txt b/samples/snippets/requirements.txt index 68147e18..ce0a9070 100644 --- a/samples/snippets/requirements.txt +++ b/samples/snippets/requirements.txt @@ -1 +1 @@ -google-cloud-tasks==2.5.0 +google-cloud-tasks==2.5.1 diff --git a/scripts/fixup_tasks_v2_keywords.py b/scripts/fixup_tasks_v2_keywords.py index fdfc7b38..7f90aee4 100644 --- a/scripts/fixup_tasks_v2_keywords.py +++ b/scripts/fixup_tasks_v2_keywords.py @@ -39,22 +39,22 @@ def partition( class tasksCallTransformer(cst.CSTTransformer): CTRL_PARAMS: Tuple[str] = ('retry', 'timeout', 'metadata') METHOD_TO_PARAMS: Dict[str, Tuple[str]] = { - 'create_queue': ('parent', 'queue', ), - 'create_task': ('parent', 'task', 'response_view', ), - 'delete_queue': ('name', ), - 'delete_task': ('name', ), - 'get_iam_policy': ('resource', 'options', ), - 'get_queue': ('name', ), - 'get_task': ('name', 'response_view', ), - 'list_queues': ('parent', 'filter', 'page_size', 'page_token', ), - 'list_tasks': ('parent', 'response_view', 'page_size', 'page_token', ), - 'pause_queue': ('name', ), - 'purge_queue': ('name', ), - 'resume_queue': ('name', ), - 'run_task': ('name', 'response_view', ), - 'set_iam_policy': ('resource', 'policy', ), - 'test_iam_permissions': ('resource', 'permissions', ), - 'update_queue': ('queue', 'update_mask', ), + 'create_queue': ('parent', 'queue', ), + 'create_task': ('parent', 'task', 'response_view', ), + 'delete_queue': ('name', ), + 'delete_task': ('name', ), + 'get_iam_policy': ('resource', 'options', ), + 'get_queue': ('name', ), + 'get_task': ('name', 'response_view', ), + 'list_queues': ('parent', 'filter', 'page_size', 'page_token', ), + 'list_tasks': ('parent', 'response_view', 'page_size', 'page_token', ), + 'pause_queue': ('name', ), + 'purge_queue': ('name', ), + 'resume_queue': ('name', ), + 'run_task': ('name', 'response_view', ), + 'set_iam_policy': ('resource', 'policy', ), + 'test_iam_permissions': ('resource', 'permissions', ), + 'update_queue': ('queue', 'update_mask', ), } def leave_Call(self, original: cst.Call, updated: cst.Call) -> cst.CSTNode: @@ -73,7 +73,7 @@ def leave_Call(self, original: cst.Call, updated: cst.Call) -> cst.CSTNode: return updated kwargs, ctrl_kwargs = partition( - lambda a: not a.keyword.value in self.CTRL_PARAMS, + lambda a: a.keyword.value not in self.CTRL_PARAMS, kwargs ) diff --git a/scripts/fixup_tasks_v2beta2_keywords.py b/scripts/fixup_tasks_v2beta2_keywords.py index 4b2201b4..08c870c6 100644 --- a/scripts/fixup_tasks_v2beta2_keywords.py +++ b/scripts/fixup_tasks_v2beta2_keywords.py @@ -39,26 +39,26 @@ def partition( class tasksCallTransformer(cst.CSTTransformer): CTRL_PARAMS: Tuple[str] = ('retry', 'timeout', 'metadata') METHOD_TO_PARAMS: Dict[str, Tuple[str]] = { - 'acknowledge_task': ('name', 'schedule_time', ), - 'cancel_lease': ('name', 'schedule_time', 'response_view', ), - 'create_queue': ('parent', 'queue', ), - 'create_task': ('parent', 'task', 'response_view', ), - 'delete_queue': ('name', ), - 'delete_task': ('name', ), - 'get_iam_policy': ('resource', 'options', ), - 'get_queue': ('name', 'read_mask', ), - 'get_task': ('name', 'response_view', ), - 'lease_tasks': ('parent', 'lease_duration', 'max_tasks', 'response_view', 'filter', ), - 'list_queues': ('parent', 'filter', 'page_size', 'page_token', 'read_mask', ), - 'list_tasks': ('parent', 'response_view', 'page_size', 'page_token', ), - 'pause_queue': ('name', ), - 'purge_queue': ('name', ), - 'renew_lease': ('name', 'schedule_time', 'lease_duration', 'response_view', ), - 'resume_queue': ('name', ), - 'run_task': ('name', 'response_view', ), - 'set_iam_policy': ('resource', 'policy', ), - 'test_iam_permissions': ('resource', 'permissions', ), - 'update_queue': ('queue', 'update_mask', ), + 'acknowledge_task': ('name', 'schedule_time', ), + 'cancel_lease': ('name', 'schedule_time', 'response_view', ), + 'create_queue': ('parent', 'queue', ), + 'create_task': ('parent', 'task', 'response_view', ), + 'delete_queue': ('name', ), + 'delete_task': ('name', ), + 'get_iam_policy': ('resource', 'options', ), + 'get_queue': ('name', 'read_mask', ), + 'get_task': ('name', 'response_view', ), + 'lease_tasks': ('parent', 'lease_duration', 'max_tasks', 'response_view', 'filter', ), + 'list_queues': ('parent', 'filter', 'page_size', 'page_token', 'read_mask', ), + 'list_tasks': ('parent', 'response_view', 'page_size', 'page_token', ), + 'pause_queue': ('name', ), + 'purge_queue': ('name', ), + 'renew_lease': ('name', 'schedule_time', 'lease_duration', 'response_view', ), + 'resume_queue': ('name', ), + 'run_task': ('name', 'response_view', ), + 'set_iam_policy': ('resource', 'policy', ), + 'test_iam_permissions': ('resource', 'permissions', ), + 'update_queue': ('queue', 'update_mask', ), } def leave_Call(self, original: cst.Call, updated: cst.Call) -> cst.CSTNode: @@ -77,7 +77,7 @@ def leave_Call(self, original: cst.Call, updated: cst.Call) -> cst.CSTNode: return updated kwargs, ctrl_kwargs = partition( - lambda a: not a.keyword.value in self.CTRL_PARAMS, + lambda a: a.keyword.value not in self.CTRL_PARAMS, kwargs ) diff --git a/scripts/fixup_tasks_v2beta3_keywords.py b/scripts/fixup_tasks_v2beta3_keywords.py index e9fe202e..e0f28a92 100644 --- a/scripts/fixup_tasks_v2beta3_keywords.py +++ b/scripts/fixup_tasks_v2beta3_keywords.py @@ -39,22 +39,22 @@ def partition( class tasksCallTransformer(cst.CSTTransformer): CTRL_PARAMS: Tuple[str] = ('retry', 'timeout', 'metadata') METHOD_TO_PARAMS: Dict[str, Tuple[str]] = { - 'create_queue': ('parent', 'queue', ), - 'create_task': ('parent', 'task', 'response_view', ), - 'delete_queue': ('name', ), - 'delete_task': ('name', ), - 'get_iam_policy': ('resource', 'options', ), - 'get_queue': ('name', 'read_mask', ), - 'get_task': ('name', 'response_view', ), - 'list_queues': ('parent', 'filter', 'page_size', 'page_token', 'read_mask', ), - 'list_tasks': ('parent', 'response_view', 'page_size', 'page_token', ), - 'pause_queue': ('name', ), - 'purge_queue': ('name', ), - 'resume_queue': ('name', ), - 'run_task': ('name', 'response_view', ), - 'set_iam_policy': ('resource', 'policy', ), - 'test_iam_permissions': ('resource', 'permissions', ), - 'update_queue': ('queue', 'update_mask', ), + 'create_queue': ('parent', 'queue', ), + 'create_task': ('parent', 'task', 'response_view', ), + 'delete_queue': ('name', ), + 'delete_task': ('name', ), + 'get_iam_policy': ('resource', 'options', ), + 'get_queue': ('name', 'read_mask', ), + 'get_task': ('name', 'response_view', ), + 'list_queues': ('parent', 'filter', 'page_size', 'page_token', 'read_mask', ), + 'list_tasks': ('parent', 'response_view', 'page_size', 'page_token', ), + 'pause_queue': ('name', ), + 'purge_queue': ('name', ), + 'resume_queue': ('name', ), + 'run_task': ('name', 'response_view', ), + 'set_iam_policy': ('resource', 'policy', ), + 'test_iam_permissions': ('resource', 'permissions', ), + 'update_queue': ('queue', 'update_mask', ), } def leave_Call(self, original: cst.Call, updated: cst.Call) -> cst.CSTNode: @@ -73,7 +73,7 @@ def leave_Call(self, original: cst.Call, updated: cst.Call) -> cst.CSTNode: return updated kwargs, ctrl_kwargs = partition( - lambda a: not a.keyword.value in self.CTRL_PARAMS, + lambda a: a.keyword.value not in self.CTRL_PARAMS, kwargs ) diff --git a/scripts/readme-gen/templates/install_deps.tmpl.rst b/scripts/readme-gen/templates/install_deps.tmpl.rst index a0406dba..275d6498 100644 --- a/scripts/readme-gen/templates/install_deps.tmpl.rst +++ b/scripts/readme-gen/templates/install_deps.tmpl.rst @@ -12,7 +12,7 @@ Install Dependencies .. _Python Development Environment Setup Guide: https://cloud.google.com/python/setup -#. Create a virtualenv. Samples are compatible with Python 2.7 and 3.4+. +#. Create a virtualenv. Samples are compatible with Python 3.6+. .. code-block:: bash diff --git a/setup.py b/setup.py index 6b2363ab..eaca1480 100644 --- a/setup.py +++ b/setup.py @@ -21,7 +21,7 @@ name = "google-cloud-tasks" description = "Cloud Tasks API API client library" -version = "2.5.1" +version = "2.5.2" release_status = "Development Status :: 5 - Production/Stable" dependencies = [ # NOTE: Maintainers, please do not require google-api-core>=2.x.x