google-cloud-maintenance-api 0.4.0__tar.gz → 0.4.2__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/MANIFEST.in +1 -1
- {google_cloud_maintenance_api-0.4.0/google_cloud_maintenance_api.egg-info → google_cloud_maintenance_api-0.4.2}/PKG-INFO +25 -21
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/README.rst +17 -12
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api/gapic_version.py +2 -2
- google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1/__init__.py +62 -0
- google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1/_compat.py +262 -0
- {google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1beta → google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1}/gapic_version.py +2 -2
- {google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1beta → google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1}/services/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/async_client.py +2 -4
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/client.py +25 -161
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/pagers.py +1 -1
- {google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1beta → google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1}/services/maintenance/transports/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/transports/base.py +2 -4
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/transports/grpc.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/transports/grpc_asyncio.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/transports/rest.py +48 -49
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/services/maintenance/transports/rest_base.py +1 -116
- {google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1beta → google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1}/types/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/types/maintenance_service.py +1 -1
- google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1beta/__init__.py +62 -0
- google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1beta/_compat.py +262 -0
- {google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1 → google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1beta}/gapic_version.py +2 -2
- {google_cloud_maintenance_api-0.4.0/tests → google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1beta/services}/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/async_client.py +2 -4
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/client.py +25 -161
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/pagers.py +1 -1
- {google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1 → google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1beta}/services/maintenance/transports/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/transports/base.py +2 -4
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/transports/grpc.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/transports/grpc_asyncio.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/transports/rest.py +48 -49
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/services/maintenance/transports/rest_base.py +1 -116
- {google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1 → google_cloud_maintenance_api-0.4.2/google/cloud/maintenance_api_v1beta}/types/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/types/maintenance_service.py +2 -2
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2/google_cloud_maintenance_api.egg-info}/PKG-INFO +25 -21
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google_cloud_maintenance_api.egg-info/SOURCES.txt +4 -0
- google_cloud_maintenance_api-0.4.2/google_cloud_maintenance_api.egg-info/requires.txt +8 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/setup.py +12 -10
- {google_cloud_maintenance_api-0.4.0/tests/unit → google_cloud_maintenance_api-0.4.2/tests}/__init__.py +1 -1
- {google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1/services → google_cloud_maintenance_api-0.4.2/tests/unit}/__init__.py +1 -1
- google_cloud_maintenance_api-0.4.2/tests/unit/gapic/__init__.py +15 -0
- google_cloud_maintenance_api-0.4.2/tests/unit/gapic/maintenance_api_v1/__init__.py +15 -0
- google_cloud_maintenance_api-0.4.2/tests/unit/gapic/maintenance_api_v1/test_compat.py +429 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/tests/unit/gapic/maintenance_api_v1/test_maintenance.py +141 -418
- google_cloud_maintenance_api-0.4.2/tests/unit/gapic/maintenance_api_v1beta/__init__.py +15 -0
- google_cloud_maintenance_api-0.4.2/tests/unit/gapic/maintenance_api_v1beta/test_compat.py +429 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/tests/unit/gapic/maintenance_api_v1beta/test_maintenance.py +141 -418
- google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1/__init__.py +0 -151
- google_cloud_maintenance_api-0.4.0/google/cloud/maintenance_api_v1beta/__init__.py +0 -151
- google_cloud_maintenance_api-0.4.0/google_cloud_maintenance_api.egg-info/requires.txt +0 -11
- google_cloud_maintenance_api-0.4.0/tests/unit/gapic/__init__.py +0 -15
- google_cloud_maintenance_api-0.4.0/tests/unit/gapic/maintenance_api_v1/__init__.py +0 -15
- google_cloud_maintenance_api-0.4.0/tests/unit/gapic/maintenance_api_v1beta/__init__.py +0 -15
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/LICENSE +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api/py.typed +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/gapic_metadata.json +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1/py.typed +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/gapic_metadata.json +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google/cloud/maintenance_api_v1beta/py.typed +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google_cloud_maintenance_api.egg-info/dependency_links.txt +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google_cloud_maintenance_api.egg-info/not-zip-safe +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/google_cloud_maintenance_api.egg-info/top_level.txt +0 -0
- {google_cloud_maintenance_api-0.4.0 → google_cloud_maintenance_api-0.4.2}/setup.cfg +0 -0
|
@@ -1,34 +1,33 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: google-cloud-maintenance-api
|
|
3
|
-
Version: 0.4.
|
|
3
|
+
Version: 0.4.2
|
|
4
4
|
Summary: Google Cloud Maintenance Api API client library
|
|
5
5
|
Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-maintenance-api
|
|
6
6
|
Author: Google LLC
|
|
7
7
|
Author-email: googleapis-packages@google.com
|
|
8
|
-
License: Apache
|
|
8
|
+
License: Apache-2.0
|
|
9
9
|
Platform: Posix; MacOS X; Windows
|
|
10
10
|
Classifier: Development Status :: 4 - Beta
|
|
11
11
|
Classifier: Intended Audience :: Developers
|
|
12
12
|
Classifier: License :: OSI Approved :: Apache Software License
|
|
13
13
|
Classifier: Programming Language :: Python
|
|
14
14
|
Classifier: Programming Language :: Python :: 3
|
|
15
|
-
Classifier: Programming Language :: Python :: 3.9
|
|
16
15
|
Classifier: Programming Language :: Python :: 3.10
|
|
17
16
|
Classifier: Programming Language :: Python :: 3.11
|
|
18
17
|
Classifier: Programming Language :: Python :: 3.12
|
|
19
18
|
Classifier: Programming Language :: Python :: 3.13
|
|
20
19
|
Classifier: Programming Language :: Python :: 3.14
|
|
20
|
+
Classifier: Programming Language :: Python :: 3.15
|
|
21
21
|
Classifier: Operating System :: OS Independent
|
|
22
22
|
Classifier: Topic :: Internet
|
|
23
|
-
Requires-Python: >=3.
|
|
23
|
+
Requires-Python: >=3.10
|
|
24
24
|
License-File: LICENSE
|
|
25
|
-
Requires-Dist: google-api-core[grpc]<3.0.0,>=2.
|
|
25
|
+
Requires-Dist: google-api-core[grpc]<3.0.0,>=2.28.0
|
|
26
26
|
Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
|
|
27
|
-
Requires-Dist: grpcio<2.0.0,>=1.
|
|
27
|
+
Requires-Dist: grpcio<2.0.0,>=1.59.0
|
|
28
28
|
Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
|
|
29
|
-
Requires-Dist: proto-plus<2.0.0,>=1.
|
|
30
|
-
Requires-Dist:
|
|
31
|
-
Requires-Dist: protobuf<8.0.0,>=4.25.8
|
|
29
|
+
Requires-Dist: proto-plus<2.0.0,>=1.26.1
|
|
30
|
+
Requires-Dist: protobuf<8.0.0,>=6.33.5
|
|
32
31
|
Dynamic: author
|
|
33
32
|
Dynamic: author-email
|
|
34
33
|
Dynamic: classifier
|
|
@@ -41,12 +40,16 @@ Dynamic: requires-dist
|
|
|
41
40
|
Dynamic: requires-python
|
|
42
41
|
Dynamic: summary
|
|
43
42
|
|
|
44
|
-
Python Client for Maintenance
|
|
45
|
-
|
|
43
|
+
Python Client for Maintenance
|
|
44
|
+
=============================
|
|
46
45
|
|
|
47
46
|
|preview| |pypi| |versions|
|
|
48
47
|
|
|
49
|
-
`Maintenance
|
|
48
|
+
`Cloud Maintenance`_: The Maintenance API provides a centralized view of planned disruptive
|
|
49
|
+
maintenance events across supported Google Cloud products. It offers users
|
|
50
|
+
visibility into upcoming, ongoing, and completed maintenance, along with
|
|
51
|
+
controls to manage certain maintenance activities, such as maintenance
|
|
52
|
+
windows, rescheduling, and on-demand updates.
|
|
50
53
|
|
|
51
54
|
- `Client Library Documentation`_
|
|
52
55
|
- `Product Documentation`_
|
|
@@ -57,9 +60,9 @@ Python Client for Maintenance API
|
|
|
57
60
|
:target: https://pypi.org/project/google-cloud-maintenance-api/
|
|
58
61
|
.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-maintenance-api.svg
|
|
59
62
|
:target: https://pypi.org/project/google-cloud-maintenance-api/
|
|
60
|
-
..
|
|
63
|
+
.. _Cloud Maintenance: https://cloud.google.com/unified-maintenance/
|
|
61
64
|
.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/google-cloud-maintenance-api/latest/summary_overview
|
|
62
|
-
.. _Product Documentation: https://cloud.google.com/unified-maintenance/
|
|
65
|
+
.. _Product Documentation: https://cloud.google.com/unified-maintenance/
|
|
63
66
|
|
|
64
67
|
Quick Start
|
|
65
68
|
-----------
|
|
@@ -68,12 +71,12 @@ In order to use this library, you first need to go through the following steps:
|
|
|
68
71
|
|
|
69
72
|
1. `Select or create a Cloud Platform project.`_
|
|
70
73
|
2. `Enable billing for your project.`_
|
|
71
|
-
3. `Enable the Maintenance
|
|
74
|
+
3. `Enable the Maintenance.`_
|
|
72
75
|
4. `Set up Authentication.`_
|
|
73
76
|
|
|
74
77
|
.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
|
|
75
78
|
.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
|
|
76
|
-
.. _Enable the Maintenance
|
|
79
|
+
.. _Enable the Maintenance.: https://cloud.google.com/unified-maintenance/
|
|
77
80
|
.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
|
|
78
81
|
|
|
79
82
|
Installation
|
|
@@ -104,14 +107,15 @@ Supported Python Versions
|
|
|
104
107
|
Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
|
|
105
108
|
Python.
|
|
106
109
|
|
|
107
|
-
Python >= 3.
|
|
110
|
+
Python >= 3.10, including 3.14
|
|
108
111
|
|
|
109
112
|
.. _active: https://devguide.python.org/devcycle/#in-development-main-branch
|
|
110
113
|
.. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
|
|
111
114
|
|
|
112
115
|
Unsupported Python Versions
|
|
113
116
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
114
|
-
Python <= 3.
|
|
117
|
+
Python <= 3.9
|
|
118
|
+
|
|
115
119
|
|
|
116
120
|
If you are using an `end-of-life`_
|
|
117
121
|
version of Python, we recommend that you update as soon as possible to an actively supported version.
|
|
@@ -140,14 +144,14 @@ Windows
|
|
|
140
144
|
Next Steps
|
|
141
145
|
~~~~~~~~~~
|
|
142
146
|
|
|
143
|
-
- Read the `Client Library Documentation`_ for Maintenance
|
|
147
|
+
- Read the `Client Library Documentation`_ for Maintenance
|
|
144
148
|
to see other available methods on the client.
|
|
145
|
-
- Read the `Maintenance
|
|
149
|
+
- Read the `Maintenance Product documentation`_ to learn
|
|
146
150
|
more about the product and see How-to Guides.
|
|
147
151
|
- View this `README`_ to see the full list of Cloud
|
|
148
152
|
APIs that we cover.
|
|
149
153
|
|
|
150
|
-
.. _Maintenance
|
|
154
|
+
.. _Maintenance Product documentation: https://cloud.google.com/unified-maintenance/
|
|
151
155
|
.. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
|
|
152
156
|
|
|
153
157
|
Logging
|
|
@@ -1,9 +1,13 @@
|
|
|
1
|
-
Python Client for Maintenance
|
|
2
|
-
|
|
1
|
+
Python Client for Maintenance
|
|
2
|
+
=============================
|
|
3
3
|
|
|
4
4
|
|preview| |pypi| |versions|
|
|
5
5
|
|
|
6
|
-
`Maintenance
|
|
6
|
+
`Cloud Maintenance`_: The Maintenance API provides a centralized view of planned disruptive
|
|
7
|
+
maintenance events across supported Google Cloud products. It offers users
|
|
8
|
+
visibility into upcoming, ongoing, and completed maintenance, along with
|
|
9
|
+
controls to manage certain maintenance activities, such as maintenance
|
|
10
|
+
windows, rescheduling, and on-demand updates.
|
|
7
11
|
|
|
8
12
|
- `Client Library Documentation`_
|
|
9
13
|
- `Product Documentation`_
|
|
@@ -14,9 +18,9 @@ Python Client for Maintenance API
|
|
|
14
18
|
:target: https://pypi.org/project/google-cloud-maintenance-api/
|
|
15
19
|
.. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-maintenance-api.svg
|
|
16
20
|
:target: https://pypi.org/project/google-cloud-maintenance-api/
|
|
17
|
-
..
|
|
21
|
+
.. _Cloud Maintenance: https://cloud.google.com/unified-maintenance/
|
|
18
22
|
.. _Client Library Documentation: https://cloud.google.com/python/docs/reference/google-cloud-maintenance-api/latest/summary_overview
|
|
19
|
-
.. _Product Documentation: https://cloud.google.com/unified-maintenance/
|
|
23
|
+
.. _Product Documentation: https://cloud.google.com/unified-maintenance/
|
|
20
24
|
|
|
21
25
|
Quick Start
|
|
22
26
|
-----------
|
|
@@ -25,12 +29,12 @@ In order to use this library, you first need to go through the following steps:
|
|
|
25
29
|
|
|
26
30
|
1. `Select or create a Cloud Platform project.`_
|
|
27
31
|
2. `Enable billing for your project.`_
|
|
28
|
-
3. `Enable the Maintenance
|
|
32
|
+
3. `Enable the Maintenance.`_
|
|
29
33
|
4. `Set up Authentication.`_
|
|
30
34
|
|
|
31
35
|
.. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
|
|
32
36
|
.. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
|
|
33
|
-
.. _Enable the Maintenance
|
|
37
|
+
.. _Enable the Maintenance.: https://cloud.google.com/unified-maintenance/
|
|
34
38
|
.. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
|
|
35
39
|
|
|
36
40
|
Installation
|
|
@@ -61,14 +65,15 @@ Supported Python Versions
|
|
|
61
65
|
Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
|
|
62
66
|
Python.
|
|
63
67
|
|
|
64
|
-
Python >= 3.
|
|
68
|
+
Python >= 3.10, including 3.14
|
|
65
69
|
|
|
66
70
|
.. _active: https://devguide.python.org/devcycle/#in-development-main-branch
|
|
67
71
|
.. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
|
|
68
72
|
|
|
69
73
|
Unsupported Python Versions
|
|
70
74
|
^^^^^^^^^^^^^^^^^^^^^^^^^^^
|
|
71
|
-
Python <= 3.
|
|
75
|
+
Python <= 3.9
|
|
76
|
+
|
|
72
77
|
|
|
73
78
|
If you are using an `end-of-life`_
|
|
74
79
|
version of Python, we recommend that you update as soon as possible to an actively supported version.
|
|
@@ -97,14 +102,14 @@ Windows
|
|
|
97
102
|
Next Steps
|
|
98
103
|
~~~~~~~~~~
|
|
99
104
|
|
|
100
|
-
- Read the `Client Library Documentation`_ for Maintenance
|
|
105
|
+
- Read the `Client Library Documentation`_ for Maintenance
|
|
101
106
|
to see other available methods on the client.
|
|
102
|
-
- Read the `Maintenance
|
|
107
|
+
- Read the `Maintenance Product documentation`_ to learn
|
|
103
108
|
more about the product and see How-to Guides.
|
|
104
109
|
- View this `README`_ to see the full list of Cloud
|
|
105
110
|
APIs that we cover.
|
|
106
111
|
|
|
107
|
-
.. _Maintenance
|
|
112
|
+
.. _Maintenance Product documentation: https://cloud.google.com/unified-maintenance/
|
|
108
113
|
.. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
|
|
109
114
|
|
|
110
115
|
Logging
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
# -*- coding: utf-8 -*-
|
|
2
|
-
# Copyright
|
|
2
|
+
# Copyright 2026 Google LLC
|
|
3
3
|
#
|
|
4
4
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
5
|
# you may not use this file except in compliance with the License.
|
|
@@ -13,4 +13,4 @@
|
|
|
13
13
|
# See the License for the specific language governing permissions and
|
|
14
14
|
# limitations under the License.
|
|
15
15
|
#
|
|
16
|
-
__version__ = "0.4.
|
|
16
|
+
__version__ = "0.4.2" # {x-release-please-version}
|
|
@@ -0,0 +1,62 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
# Copyright 2026 Google LLC
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
#
|
|
16
|
+
import google.api_core as api_core
|
|
17
|
+
|
|
18
|
+
from google.cloud.maintenance_api_v1 import gapic_version as package_version
|
|
19
|
+
|
|
20
|
+
__version__ = package_version.__version__
|
|
21
|
+
|
|
22
|
+
# PEP 0810: Explicit Lazy Imports
|
|
23
|
+
# Python 3.15+ natively intercepts and defers these imports.
|
|
24
|
+
# Developers can disable this behavior and force eager imports.
|
|
25
|
+
# For more information, see:
|
|
26
|
+
# https://docs.python.org/3.15/library/sys.html#sys.set_lazy_imports_filter
|
|
27
|
+
# Older Python versions safely ignore this variable.
|
|
28
|
+
__lazy_modules__ = {
|
|
29
|
+
"google.cloud.maintenance_api_v1.services.maintenance",
|
|
30
|
+
"google.cloud.maintenance_api_v1.types.maintenance_service",
|
|
31
|
+
}
|
|
32
|
+
|
|
33
|
+
|
|
34
|
+
from .services.maintenance import MaintenanceAsyncClient, MaintenanceClient
|
|
35
|
+
from .types.maintenance_service import (
|
|
36
|
+
GetResourceMaintenanceRequest,
|
|
37
|
+
ListResourceMaintenancesRequest,
|
|
38
|
+
ListResourceMaintenancesResponse,
|
|
39
|
+
MaintenanceCategory,
|
|
40
|
+
MaintenanceControl,
|
|
41
|
+
MaintenanceSummary,
|
|
42
|
+
ResourceMaintenance,
|
|
43
|
+
SummarizeMaintenancesRequest,
|
|
44
|
+
SummarizeMaintenancesResponse,
|
|
45
|
+
)
|
|
46
|
+
|
|
47
|
+
__all__ = (
|
|
48
|
+
"MaintenanceAsyncClient",
|
|
49
|
+
"GetResourceMaintenanceRequest",
|
|
50
|
+
"ListResourceMaintenancesRequest",
|
|
51
|
+
"ListResourceMaintenancesResponse",
|
|
52
|
+
"MaintenanceCategory",
|
|
53
|
+
"MaintenanceClient",
|
|
54
|
+
"MaintenanceControl",
|
|
55
|
+
"MaintenanceSummary",
|
|
56
|
+
"ResourceMaintenance",
|
|
57
|
+
"SummarizeMaintenancesRequest",
|
|
58
|
+
"SummarizeMaintenancesResponse",
|
|
59
|
+
)
|
|
60
|
+
|
|
61
|
+
api_core.check_python_version("google.cloud.maintenance_api_v1")
|
|
62
|
+
api_core.check_dependency_versions("google.cloud.maintenance_api_v1")
|
|
@@ -0,0 +1,262 @@
|
|
|
1
|
+
# -*- coding: utf-8 -*-
|
|
2
|
+
# Copyright 2026 Google LLC
|
|
3
|
+
#
|
|
4
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
|
+
# you may not use this file except in compliance with the License.
|
|
6
|
+
# You may obtain a copy of the License at
|
|
7
|
+
#
|
|
8
|
+
# http://www.apache.org/licenses/LICENSE-2.0
|
|
9
|
+
#
|
|
10
|
+
# Unless required by applicable law or agreed to in writing, software
|
|
11
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
|
12
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
13
|
+
# See the License for the specific language governing permissions and
|
|
14
|
+
# limitations under the License.
|
|
15
|
+
#
|
|
16
|
+
"""A compatibility module for older versions of google-api-core."""
|
|
17
|
+
|
|
18
|
+
import json
|
|
19
|
+
import os
|
|
20
|
+
from typing import Any, Dict, List, Optional, Tuple
|
|
21
|
+
from urllib.parse import urlparse, urlunparse
|
|
22
|
+
|
|
23
|
+
from google.api_core import path_template
|
|
24
|
+
from google.api_core.universe import EmptyUniverseError
|
|
25
|
+
from google.auth.exceptions import MutualTLSChannelError
|
|
26
|
+
from google.protobuf import json_format
|
|
27
|
+
|
|
28
|
+
try:
|
|
29
|
+
# note: `#type: ignore` is added because the return type for `should_use_client_cert`
|
|
30
|
+
# is different than that of the fallback implementation below. This will be removed once
|
|
31
|
+
# we bump the minimum supported version of google-auth.
|
|
32
|
+
from google.auth.transport.mtls import should_use_client_cert # type: ignore
|
|
33
|
+
except ImportError: # pragma: NO COVER
|
|
34
|
+
|
|
35
|
+
def should_use_client_cert():
|
|
36
|
+
"""Returns whether client certificate should be used for mTLS."""
|
|
37
|
+
use_client_cert = os.getenv(
|
|
38
|
+
"GOOGLE_API_USE_CLIENT_CERTIFICATE", "false"
|
|
39
|
+
).lower()
|
|
40
|
+
if use_client_cert not in ("true", "false"):
|
|
41
|
+
raise ValueError(
|
|
42
|
+
"Environment variable `GOOGLE_API_USE_CLIENT_CERTIFICATE` must be"
|
|
43
|
+
" either `true` or `false`"
|
|
44
|
+
)
|
|
45
|
+
return use_client_cert == "true"
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def read_environment_variables():
|
|
49
|
+
"""Returns the environment variables used by the client.
|
|
50
|
+
|
|
51
|
+
Returns:
|
|
52
|
+
Tuple[bool, str, str]: returns the GOOGLE_API_USE_CLIENT_CERTIFICATE,
|
|
53
|
+
GOOGLE_API_USE_MTLS_ENDPOINT, and GOOGLE_CLOUD_UNIVERSE_DOMAIN environment variables.
|
|
54
|
+
|
|
55
|
+
Raises:
|
|
56
|
+
ValueError: If GOOGLE_API_USE_CLIENT_CERTIFICATE is not
|
|
57
|
+
any of ["true", "false"].
|
|
58
|
+
google.auth.exceptions.MutualTLSChannelError: If GOOGLE_API_USE_MTLS_ENDPOINT
|
|
59
|
+
is not any of ["auto", "never", "always"].
|
|
60
|
+
"""
|
|
61
|
+
use_client_cert = should_use_client_cert()
|
|
62
|
+
use_mtls_endpoint = os.getenv("GOOGLE_API_USE_MTLS_ENDPOINT", "auto").lower()
|
|
63
|
+
universe_domain_env = os.getenv("GOOGLE_CLOUD_UNIVERSE_DOMAIN")
|
|
64
|
+
if use_mtls_endpoint not in ("auto", "never", "always"):
|
|
65
|
+
raise MutualTLSChannelError(
|
|
66
|
+
"Environment variable `GOOGLE_API_USE_MTLS_ENDPOINT` must be `never`,"
|
|
67
|
+
" `auto` or `always`"
|
|
68
|
+
)
|
|
69
|
+
return use_client_cert, use_mtls_endpoint, universe_domain_env
|
|
70
|
+
|
|
71
|
+
|
|
72
|
+
DEFAULT_UNIVERSE = "googleapis.com"
|
|
73
|
+
|
|
74
|
+
try:
|
|
75
|
+
from google.api_core.universe import get_default_mtls_endpoint
|
|
76
|
+
except ImportError: # pragma: NO COVER
|
|
77
|
+
|
|
78
|
+
def get_default_mtls_endpoint(api_endpoint: Optional[str]) -> Optional[str]:
|
|
79
|
+
"""Converts api endpoint to mTLS endpoint.
|
|
80
|
+
|
|
81
|
+
Convert "*.sandbox.googleapis.com" and "*.googleapis.com" to
|
|
82
|
+
"*.mtls.sandbox.googleapis.com" and "*.mtls.googleapis.com" respectively.
|
|
83
|
+
Other URLs (including those that do not match these domain suffixes or
|
|
84
|
+
already contain '.mtls.') are passed through as-is.
|
|
85
|
+
|
|
86
|
+
Args:
|
|
87
|
+
api_endpoint (Optional[str]): the api endpoint to convert.
|
|
88
|
+
|
|
89
|
+
Returns:
|
|
90
|
+
Optional[str]: converted mTLS api endpoint.
|
|
91
|
+
"""
|
|
92
|
+
if not api_endpoint or ".mtls." in api_endpoint.lower():
|
|
93
|
+
return api_endpoint
|
|
94
|
+
|
|
95
|
+
has_scheme = "://" in api_endpoint
|
|
96
|
+
if not has_scheme:
|
|
97
|
+
parsed = urlparse("//" + api_endpoint)
|
|
98
|
+
else:
|
|
99
|
+
parsed = urlparse(api_endpoint)
|
|
100
|
+
|
|
101
|
+
host = parsed.hostname
|
|
102
|
+
if not host:
|
|
103
|
+
return api_endpoint
|
|
104
|
+
|
|
105
|
+
port = f":{parsed.port}" if parsed.port else ""
|
|
106
|
+
|
|
107
|
+
lowered_host = host.lower()
|
|
108
|
+
suffix_sandbox = ".sandbox.googleapis.com"
|
|
109
|
+
suffix_google = ".googleapis.com"
|
|
110
|
+
if lowered_host.endswith(suffix_sandbox):
|
|
111
|
+
new_host = host[: -len(suffix_sandbox)] + ".mtls.sandbox.googleapis.com"
|
|
112
|
+
elif lowered_host.endswith(suffix_google):
|
|
113
|
+
new_host = host[: -len(suffix_google)] + ".mtls.googleapis.com"
|
|
114
|
+
else:
|
|
115
|
+
return api_endpoint
|
|
116
|
+
|
|
117
|
+
netloc = new_host + port
|
|
118
|
+
new_parsed = parsed._replace(netloc=netloc)
|
|
119
|
+
|
|
120
|
+
if not has_scheme:
|
|
121
|
+
return urlunparse(new_parsed)[2:]
|
|
122
|
+
else:
|
|
123
|
+
return urlunparse(new_parsed)
|
|
124
|
+
|
|
125
|
+
|
|
126
|
+
try:
|
|
127
|
+
from google.api_core.universe import get_api_endpoint
|
|
128
|
+
except ImportError: # pragma: NO COVER
|
|
129
|
+
|
|
130
|
+
def get_api_endpoint(
|
|
131
|
+
api_override: Optional[str],
|
|
132
|
+
universe_domain: str,
|
|
133
|
+
default_universe: str,
|
|
134
|
+
default_mtls_endpoint: Optional[str],
|
|
135
|
+
default_endpoint_template: str,
|
|
136
|
+
use_mtls: bool,
|
|
137
|
+
) -> str:
|
|
138
|
+
"""Return the API endpoint used by the client.
|
|
139
|
+
|
|
140
|
+
Args:
|
|
141
|
+
api_override (Optional[str]): The API endpoint override. If specified,
|
|
142
|
+
this is always returned.
|
|
143
|
+
universe_domain (str): The universe domain used by the client.
|
|
144
|
+
default_universe (str): The default universe domain.
|
|
145
|
+
default_mtls_endpoint (Optional[str]): The default mTLS endpoint.
|
|
146
|
+
default_endpoint_template (str): The default endpoint template containing
|
|
147
|
+
a placeholder `{UNIVERSE_DOMAIN}`.
|
|
148
|
+
use_mtls (bool): Whether to use the mTLS endpoint.
|
|
149
|
+
|
|
150
|
+
Returns:
|
|
151
|
+
str: The API endpoint to be used by the client.
|
|
152
|
+
|
|
153
|
+
Raises:
|
|
154
|
+
google.auth.exceptions.MutualTLSChannelError: If mTLS is requested but
|
|
155
|
+
not supported in the configured universe domain.
|
|
156
|
+
ValueError: If mTLS is requested but no mTLS endpoint is available.
|
|
157
|
+
"""
|
|
158
|
+
if api_override is not None:
|
|
159
|
+
return api_override
|
|
160
|
+
|
|
161
|
+
if use_mtls:
|
|
162
|
+
if universe_domain.lower() != default_universe.lower():
|
|
163
|
+
raise MutualTLSChannelError(
|
|
164
|
+
f"mTLS is not supported in any universe other than {default_universe}."
|
|
165
|
+
)
|
|
166
|
+
if not default_mtls_endpoint:
|
|
167
|
+
raise ValueError("mTLS endpoint is not available.")
|
|
168
|
+
return default_mtls_endpoint
|
|
169
|
+
else:
|
|
170
|
+
return default_endpoint_template.format(UNIVERSE_DOMAIN=universe_domain)
|
|
171
|
+
|
|
172
|
+
|
|
173
|
+
try:
|
|
174
|
+
from google.api_core.universe import get_universe_domain
|
|
175
|
+
except ImportError: # pragma: NO COVER
|
|
176
|
+
|
|
177
|
+
def get_universe_domain(
|
|
178
|
+
*potential_universes: Optional[str],
|
|
179
|
+
default_universe: str,
|
|
180
|
+
) -> str:
|
|
181
|
+
"""Return the universe domain used by the client.
|
|
182
|
+
|
|
183
|
+
Args:
|
|
184
|
+
*potential_universes (Optional[str]): Potential universe domains in order of preference.
|
|
185
|
+
default_universe (str): The default universe domain.
|
|
186
|
+
|
|
187
|
+
Returns:
|
|
188
|
+
str: The universe domain to be used by the client.
|
|
189
|
+
|
|
190
|
+
Raises:
|
|
191
|
+
EmptyUniverseError: If the resolved universe domain is an empty string.
|
|
192
|
+
"""
|
|
193
|
+
resolved = next(
|
|
194
|
+
(x.strip() for x in potential_universes if x is not None),
|
|
195
|
+
default_universe,
|
|
196
|
+
)
|
|
197
|
+
|
|
198
|
+
if not resolved:
|
|
199
|
+
raise EmptyUniverseError()
|
|
200
|
+
return resolved
|
|
201
|
+
|
|
202
|
+
|
|
203
|
+
try:
|
|
204
|
+
from google.api_core.rest_helpers import transcode_request # type: ignore
|
|
205
|
+
except ImportError: # pragma: NO COVER
|
|
206
|
+
|
|
207
|
+
def transcode_request(
|
|
208
|
+
http_options: List[Dict[str, str]],
|
|
209
|
+
request: Any,
|
|
210
|
+
required_fields_default_values: Optional[Dict[str, Any]] = None,
|
|
211
|
+
rest_numeric_enums: bool = False,
|
|
212
|
+
) -> Tuple[Dict[str, Any], Optional[str], Dict[str, Any]]:
|
|
213
|
+
"""Transcodes a request into HTTP method, URI, body, and query parameters.
|
|
214
|
+
|
|
215
|
+
Args:
|
|
216
|
+
http_options (List[Dict[str, str]]): List of HTTP transcoding rules.
|
|
217
|
+
request (Any): The protobuf or proto-plus request message.
|
|
218
|
+
required_fields_default_values (Optional[Dict[str, Any]]): Dictionary
|
|
219
|
+
of required fields default values to merge into query parameters if missing.
|
|
220
|
+
rest_numeric_enums (bool): Whether to encode enums as integers.
|
|
221
|
+
|
|
222
|
+
Returns:
|
|
223
|
+
Tuple[Dict[str, Any], Optional[str], Dict[str, Any]]: A tuple containing:
|
|
224
|
+
- The raw transcoded request dictionary (containing keys like 'uri', 'method').
|
|
225
|
+
- The serialized request body JSON string, or None if no body.
|
|
226
|
+
- The query parameters dictionary.
|
|
227
|
+
"""
|
|
228
|
+
if request is None:
|
|
229
|
+
raise TypeError("request cannot be None")
|
|
230
|
+
|
|
231
|
+
# Convert proto-plus message to its underlying protobuf message if needed
|
|
232
|
+
pb_request = getattr(request, "_pb", request)
|
|
233
|
+
|
|
234
|
+
transcoded_request = path_template.transcode(http_options, pb_request)
|
|
235
|
+
|
|
236
|
+
body_json = None
|
|
237
|
+
if transcoded_request.get("body") is not None:
|
|
238
|
+
body_json = json_format.MessageToJson(
|
|
239
|
+
transcoded_request["body"],
|
|
240
|
+
use_integers_for_enums=rest_numeric_enums,
|
|
241
|
+
)
|
|
242
|
+
|
|
243
|
+
query_params_json = {}
|
|
244
|
+
if transcoded_request.get("query_params") is not None:
|
|
245
|
+
query_params_json = json.loads(
|
|
246
|
+
json_format.MessageToJson(
|
|
247
|
+
transcoded_request["query_params"],
|
|
248
|
+
use_integers_for_enums=rest_numeric_enums,
|
|
249
|
+
)
|
|
250
|
+
)
|
|
251
|
+
|
|
252
|
+
# If required_fields_default_values is provided, we merge default values for missing
|
|
253
|
+
# required fields into the query parameters.
|
|
254
|
+
if required_fields_default_values:
|
|
255
|
+
for k, v in required_fields_default_values.items():
|
|
256
|
+
if k not in query_params_json:
|
|
257
|
+
query_params_json[k] = v
|
|
258
|
+
|
|
259
|
+
if rest_numeric_enums:
|
|
260
|
+
query_params_json["$alt"] = "json;enum-encoding=int"
|
|
261
|
+
|
|
262
|
+
return transcoded_request, body_json, query_params_json
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
# -*- coding: utf-8 -*-
|
|
2
|
-
# Copyright
|
|
2
|
+
# Copyright 2026 Google LLC
|
|
3
3
|
#
|
|
4
4
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
5
|
# you may not use this file except in compliance with the License.
|
|
@@ -13,4 +13,4 @@
|
|
|
13
13
|
# See the License for the specific language governing permissions and
|
|
14
14
|
# limitations under the License.
|
|
15
15
|
#
|
|
16
|
-
__version__ = "0.4.
|
|
16
|
+
__version__ = "0.4.2" # {x-release-please-version}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
# -*- coding: utf-8 -*-
|
|
2
|
-
# Copyright
|
|
2
|
+
# Copyright 2026 Google LLC
|
|
3
3
|
#
|
|
4
4
|
# Licensed under the Apache License, Version 2.0 (the "License");
|
|
5
5
|
# you may not use this file except in compliance with the License.
|
|
@@ -794,9 +794,7 @@ class MaintenanceAsyncClient:
|
|
|
794
794
|
DEFAULT_CLIENT_INFO = gapic_v1.client_info.ClientInfo(
|
|
795
795
|
gapic_version=package_version.__version__
|
|
796
796
|
)
|
|
797
|
-
|
|
798
|
-
if hasattr(DEFAULT_CLIENT_INFO, "protobuf_runtime_version"): # pragma: NO COVER
|
|
799
|
-
DEFAULT_CLIENT_INFO.protobuf_runtime_version = google.protobuf.__version__
|
|
797
|
+
DEFAULT_CLIENT_INFO.protobuf_runtime_version = google.protobuf.__version__
|
|
800
798
|
|
|
801
799
|
|
|
802
800
|
__all__ = ("MaintenanceAsyncClient",)
|