google-cloud-maintenance-api 0.3.0__tar.gz → 0.4.1__tar.gz

{google_cloud_maintenance_api-0.3.0 → google_cloud_maintenance_api-0.4.1}/MANIFEST.in

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{google_cloud_maintenance_api-0.3.0/google_cloud_maintenance_api.egg-info → google_cloud_maintenance_api-0.4.1}/PKG-INFO

@@ -1,20 +1,17 @@
 Metadata-Version: 2.4
 Name: google-cloud-maintenance-api
-Version: 0.3.0
+Version: 0.4.1
 Summary: Google Cloud Maintenance Api API client library
 Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-maintenance-api
 Author: Google LLC
 Author-email: googleapis-packages@google.com
-License: Apache 2.0
+License: Apache-2.0
 Platform: Posix; MacOS X; Windows
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
@@ -22,15 +19,15 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Internet
-Requires-Python: >=3.7
+Requires-Python: >=3.10
 License-File: LICENSE
-Requires-Dist: google-api-core[grpc]!=2.0.*,!=2.1.*,!=2.10.*,!=2.2.*,!=2.3.*,!=2.4.*,!=2.5.*,!=2.6.*,!=2.7.*,!=2.8.*,!=2.9.*,<3.0.0,>=1.34.1
+Requires-Dist: google-api-core[grpc]<3.0.0,>=2.17.1
 Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
-Requires-Dist: grpcio<2.0.0,>=1.33.2
+Requires-Dist: grpcio<2.0.0,>=1.59.0
 Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
 Requires-Dist: proto-plus<2.0.0,>=1.22.3
 Requires-Dist: proto-plus<2.0.0,>=1.25.0; python_version >= "3.13"
-Requires-Dist: protobuf!=4.21.0,!=4.21.1,!=4.21.2,!=4.21.3,!=4.21.4,!=4.21.5,<7.0.0,>=3.20.2
+Requires-Dist: protobuf<8.0.0,>=4.25.8
 Dynamic: author
 Dynamic: author-email
 Dynamic: classifier
@@ -43,12 +40,16 @@ Dynamic: requires-dist
 Dynamic: requires-python
 Dynamic: summary
 
-Python Client for Maintenance API
-=================================
+Python Client for Maintenance
+=============================
 
 |preview| |pypi| |versions|
 
-`Maintenance API`_: The Maintenance API provides a centralized view of planned disruptive maintenance events across supported Google Cloud products. It offers users visibility into upcoming, ongoing, and completed maintenance, along with controls to manage certain maintenance activities, such as mainteance windows, rescheduling, and on-demand updates.
+`Cloud Maintenance`_: The Maintenance API provides a centralized view of planned disruptive
+maintenance events across supported Google Cloud products. It offers users
+visibility into upcoming, ongoing, and completed maintenance, along with
+controls to manage certain maintenance activities, such as maintenance
+windows, rescheduling, and on-demand updates.
 
 - `Client Library Documentation`_
 - `Product Documentation`_
@@ -59,9 +60,9 @@ Python Client for Maintenance API
    :target: https://pypi.org/project/google-cloud-maintenance-api/
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-maintenance-api.svg
    :target: https://pypi.org/project/google-cloud-maintenance-api/
-.. _Maintenance API: https://cloud.google.com/unified-maintenance/docs/overview
+.. _Cloud Maintenance: https://cloud.google.com/unified-maintenance/
 .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/google-cloud-maintenance-api/latest/summary_overview
-.. _Product Documentation:  https://cloud.google.com/unified-maintenance/docs/overview
+.. _Product Documentation:  https://cloud.google.com/unified-maintenance/
 
 Quick Start
 -----------
@@ -70,12 +71,12 @@ In order to use this library, you first need to go through the following steps:
 
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
-3. `Enable the Maintenance API.`_
+3. `Enable the Maintenance.`_
 4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
-.. _Enable the Maintenance API.:  https://cloud.google.com/unified-maintenance/docs/overview
+.. _Enable the Maintenance.:  https://cloud.google.com/unified-maintenance/
 .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
@@ -106,14 +107,15 @@ Supported Python Versions
 Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
 Python.
 
-Python >= 3.7, including 3.14
+Python >= 3.10, including 3.14
 
 .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
 .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
 
 Unsupported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Python <= 3.6
+Python <= 3.9
+
 
 If you are using an `end-of-life`_
 version of Python, we recommend that you update as soon as possible to an actively supported version.
@@ -142,14 +144,14 @@ Windows
 Next Steps
 ~~~~~~~~~~
 
--  Read the `Client Library Documentation`_ for Maintenance API
+-  Read the `Client Library Documentation`_ for Maintenance
    to see other available methods on the client.
--  Read the `Maintenance API Product documentation`_ to learn
+-  Read the `Maintenance Product documentation`_ to learn
    more about the product and see How-to Guides.
 -  View this `README`_ to see the full list of Cloud
    APIs that we cover.
 
-.. _Maintenance API Product documentation:  https://cloud.google.com/unified-maintenance/docs/overview
+.. _Maintenance Product documentation:  https://cloud.google.com/unified-maintenance/
 .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
 
 Logging

{google_cloud_maintenance_api-0.3.0 → google_cloud_maintenance_api-0.4.1}/README.rst

@@ -1,9 +1,13 @@
-Python Client for Maintenance API
-=================================
+Python Client for Maintenance
+=============================
 
 |preview| |pypi| |versions|
 
-`Maintenance API`_: The Maintenance API provides a centralized view of planned disruptive maintenance events across supported Google Cloud products. It offers users visibility into upcoming, ongoing, and completed maintenance, along with controls to manage certain maintenance activities, such as mainteance windows, rescheduling, and on-demand updates.
+`Cloud Maintenance`_: The Maintenance API provides a centralized view of planned disruptive
+maintenance events across supported Google Cloud products. It offers users
+visibility into upcoming, ongoing, and completed maintenance, along with
+controls to manage certain maintenance activities, such as maintenance
+windows, rescheduling, and on-demand updates.
 
 - `Client Library Documentation`_
 - `Product Documentation`_
@@ -14,9 +18,9 @@ Python Client for Maintenance API
    :target: https://pypi.org/project/google-cloud-maintenance-api/
 .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-maintenance-api.svg
    :target: https://pypi.org/project/google-cloud-maintenance-api/
-.. _Maintenance API: https://cloud.google.com/unified-maintenance/docs/overview
+.. _Cloud Maintenance: https://cloud.google.com/unified-maintenance/
 .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/google-cloud-maintenance-api/latest/summary_overview
-.. _Product Documentation:  https://cloud.google.com/unified-maintenance/docs/overview
+.. _Product Documentation:  https://cloud.google.com/unified-maintenance/
 
 Quick Start
 -----------
@@ -25,12 +29,12 @@ In order to use this library, you first need to go through the following steps:
 
 1. `Select or create a Cloud Platform project.`_
 2. `Enable billing for your project.`_
-3. `Enable the Maintenance API.`_
+3. `Enable the Maintenance.`_
 4. `Set up Authentication.`_
 
 .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
 .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
-.. _Enable the Maintenance API.:  https://cloud.google.com/unified-maintenance/docs/overview
+.. _Enable the Maintenance.:  https://cloud.google.com/unified-maintenance/
 .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
 
 Installation
@@ -61,14 +65,15 @@ Supported Python Versions
 Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
 Python.
 
-Python >= 3.7, including 3.14
+Python >= 3.10, including 3.14
 
 .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
 .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
 
 Unsupported Python Versions
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^
-Python <= 3.6
+Python <= 3.9
+
 
 If you are using an `end-of-life`_
 version of Python, we recommend that you update as soon as possible to an actively supported version.
@@ -97,14 +102,14 @@ Windows
 Next Steps
 ~~~~~~~~~~
 
--  Read the `Client Library Documentation`_ for Maintenance API
+-  Read the `Client Library Documentation`_ for Maintenance
    to see other available methods on the client.
--  Read the `Maintenance API Product documentation`_ to learn
+-  Read the `Maintenance Product documentation`_ to learn
    more about the product and see How-to Guides.
 -  View this `README`_ to see the full list of Cloud
    APIs that we cover.
 
-.. _Maintenance API Product documentation:  https://cloud.google.com/unified-maintenance/docs/overview
+.. _Maintenance Product documentation:  https://cloud.google.com/unified-maintenance/
 .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
 
 Logging

{google_cloud_maintenance_api-0.3.0 → google_cloud_maintenance_api-0.4.1}/google/cloud/maintenance_api/__init__.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{google_cloud_maintenance_api-0.3.0 → google_cloud_maintenance_api-0.4.1}/google/cloud/maintenance_api/gapic_version.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.3.0"  # {x-release-please-version}
+__version__ = "0.4.1"  # {x-release-please-version}

{google_cloud_maintenance_api-0.3.0 → google_cloud_maintenance_api-0.4.1}/google/cloud/maintenance_api_v1/__init__.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -21,12 +21,7 @@ from google.cloud.maintenance_api_v1 import gapic_version as package_version
 
 __version__ = package_version.__version__
 
-if sys.version_info >= (3, 8):  # pragma: NO COVER
-    from importlib import metadata
-else:  # pragma: NO COVER
-    # TODO(https://github.com/googleapis/python-api-core/issues/835): Remove
-    # this code path once we drop support for Python 3.7
-    import importlib_metadata as metadata
+from importlib import metadata
 
 from .services.maintenance import MaintenanceAsyncClient, MaintenanceClient
 from .types.maintenance_service import (
@@ -50,28 +45,17 @@ else:  # pragma: NO COVER
     # An older version of api_core is installed which does not define the
     # functions above. We do equivalent checks manually.
     try:
-        import sys
         import warnings
 
         _py_version_str = sys.version.split()[0]
         _package_label = "google.cloud.maintenance_api_v1"
-        if sys.version_info < (3, 9):
+        if sys.version_info < (3, 10):
             warnings.warn(
                 "You are using a non-supported Python version "
                 + f"({_py_version_str}).  Google will not post any further "
                 + f"updates to {_package_label} supporting this Python version. "
                 + "Please upgrade to the latest Python version, or at "
-                + f"least to Python 3.9, and then update {_package_label}.",
-                FutureWarning,
-            )
-        if sys.version_info[:2] == (3, 9):
-            warnings.warn(
-                f"You are using a Python version ({_py_version_str}) "
-                + f"which Google will stop supporting in {_package_label} in "
-                + "January 2026. Please "
-                + "upgrade to the latest Python version, or at "
-                + "least to Python 3.10, before then, and "
-                + f"then update {_package_label}.",
+                + f"least to Python 3.10, and then update {_package_label}.",
                 FutureWarning,
             )
 

{google_cloud_maintenance_api-0.3.0/google/cloud/maintenance_api_v1beta → google_cloud_maintenance_api-0.4.1/google/cloud/maintenance_api_v1}/gapic_version.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -13,4 +13,4 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-__version__ = "0.3.0"  # {x-release-please-version}
+__version__ = "0.4.1"  # {x-release-please-version}

{google_cloud_maintenance_api-0.3.0/google/cloud/maintenance_api_v1beta → google_cloud_maintenance_api-0.4.1/google/cloud/maintenance_api_v1}/services/__init__.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{google_cloud_maintenance_api-0.3.0 → google_cloud_maintenance_api-0.4.1}/google/cloud/maintenance_api_v1/services/maintenance/__init__.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

{google_cloud_maintenance_api-0.3.0 → google_cloud_maintenance_api-0.4.1}/google/cloud/maintenance_api_v1/services/maintenance/async_client.py

@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2025 Google LLC
+# Copyright 2026 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -13,9 +13,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 #
-from collections import OrderedDict
 import logging as std_logging
 import re
+from collections import OrderedDict
 from typing import (
     Callable,
     Dict,
@@ -29,13 +29,13 @@ from typing import (
     Union,
 )
 
+import google.protobuf
 from google.api_core import exceptions as core_exceptions
 from google.api_core import gapic_v1
 from google.api_core import retry_async as retries
 from google.api_core.client_options import ClientOptions
 from google.auth import credentials as ga_credentials  # type: ignore
 from google.oauth2 import service_account  # type: ignore
-import google.protobuf
 
 from google.cloud.maintenance_api_v1 import gapic_version as package_version
 
@@ -44,8 +44,8 @@ try:
 except AttributeError:  # pragma: NO COVER
     OptionalRetry = Union[retries.AsyncRetry, object, None]  # type: ignore
 
+import google.protobuf.timestamp_pb2 as timestamp_pb2  # type: ignore
 from google.cloud.location import locations_pb2  # type: ignore
-from google.protobuf import timestamp_pb2  # type: ignore
 
 from google.cloud.maintenance_api_v1.services.maintenance import pagers
 from google.cloud.maintenance_api_v1.types import maintenance_service
@@ -116,7 +116,10 @@ class MaintenanceAsyncClient:
         Returns:
             MaintenanceAsyncClient: The constructed client.
         """
-        return MaintenanceClient.from_service_account_info.__func__(MaintenanceAsyncClient, info, *args, **kwargs)  # type: ignore
+        sa_info_func = (
+            MaintenanceClient.from_service_account_info.__func__  # type: ignore
+        )
+        return sa_info_func(MaintenanceAsyncClient, info, *args, **kwargs)
 
     @classmethod
     def from_service_account_file(cls, filename: str, *args, **kwargs):
@@ -132,7 +135,10 @@ class MaintenanceAsyncClient:
         Returns:
             MaintenanceAsyncClient: The constructed client.
         """
-        return MaintenanceClient.from_service_account_file.__func__(MaintenanceAsyncClient, filename, *args, **kwargs)  # type: ignore
+        sa_file_func = (
+            MaintenanceClient.from_service_account_file.__func__  # type: ignore
+        )
+        return sa_file_func(MaintenanceAsyncClient, filename, *args, **kwargs)
 
     from_service_account_json = from_service_account_file
 
@@ -182,7 +188,7 @@ class MaintenanceAsyncClient:
         return self._client.transport
 
     @property
-    def api_endpoint(self):
+    def api_endpoint(self) -> str:
         """Return the API endpoint used by the client instance.
 
         Returns:
@@ -662,7 +668,7 @@ class MaintenanceAsyncClient:
 
     async def get_location(
         self,
-        request: Optional[locations_pb2.GetLocationRequest] = None,
+        request: Optional[Union[locations_pb2.GetLocationRequest, dict]] = None,
         *,
         retry: OptionalRetry = gapic_v1.method.DEFAULT,
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
@@ -688,8 +694,12 @@ class MaintenanceAsyncClient:
         # Create or coerce a protobuf request object.
         # The request isn't a proto-plus wrapped type,
         # so it must be constructed via keyword expansion.
-        if isinstance(request, dict):
-            request = locations_pb2.GetLocationRequest(**request)
+        if request is None:
+            request_pb = locations_pb2.GetLocationRequest()
+        elif isinstance(request, dict):
+            request_pb = locations_pb2.GetLocationRequest(**request)
+        else:
+            request_pb = request
 
         # Wrap the RPC method; this adds retry and timeout information,
         # and friendly error handling.
@@ -698,7 +708,7 @@ class MaintenanceAsyncClient:
         # Certain fields should be provided within the metadata header;
         # add these here.
         metadata = tuple(metadata) + (
-            gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)),
+            gapic_v1.routing_header.to_grpc_metadata((("name", request_pb.name),)),
         )
 
         # Validate the universe domain.
@@ -706,7 +716,7 @@ class MaintenanceAsyncClient:
 
         # Send the request.
         response = await rpc(
-            request,
+            request_pb,
             retry=retry,
             timeout=timeout,
             metadata=metadata,
@@ -717,7 +727,7 @@ class MaintenanceAsyncClient:
 
     async def list_locations(
         self,
-        request: Optional[locations_pb2.ListLocationsRequest] = None,
+        request: Optional[Union[locations_pb2.ListLocationsRequest, dict]] = None,
         *,
         retry: OptionalRetry = gapic_v1.method.DEFAULT,
         timeout: Union[float, object] = gapic_v1.method.DEFAULT,
@@ -743,8 +753,12 @@ class MaintenanceAsyncClient:
         # Create or coerce a protobuf request object.
         # The request isn't a proto-plus wrapped type,
         # so it must be constructed via keyword expansion.
-        if isinstance(request, dict):
-            request = locations_pb2.ListLocationsRequest(**request)
+        if request is None:
+            request_pb = locations_pb2.ListLocationsRequest()
+        elif isinstance(request, dict):
+            request_pb = locations_pb2.ListLocationsRequest(**request)
+        else:
+            request_pb = request
 
         # Wrap the RPC method; this adds retry and timeout information,
         # and friendly error handling.
@@ -753,7 +767,7 @@ class MaintenanceAsyncClient:
         # Certain fields should be provided within the metadata header;
         # add these here.
         metadata = tuple(metadata) + (
-            gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)),
+            gapic_v1.routing_header.to_grpc_metadata((("name", request_pb.name),)),
         )
 
         # Validate the universe domain.
@@ -761,7 +775,7 @@ class MaintenanceAsyncClient:
 
         # Send the request.
         response = await rpc(
-            request,
+            request_pb,
             retry=retry,
             timeout=timeout,
             metadata=metadata,