google-cloud-logging 3.14.0__tar.gz → 3.16.0__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.
Files changed (108) hide show
  1. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/MANIFEST.in +1 -1
  2. {google_cloud_logging-3.14.0/google_cloud_logging.egg-info → google_cloud_logging-3.16.0}/PKG-INFO +20 -22
  3. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/README.rst +13 -12
  4. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging/__init__.py +1 -1
  5. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging/gapic_version.py +2 -2
  6. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/__init__.py +1 -1
  7. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/client.py +2 -1
  8. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/gapic_version.py +2 -2
  9. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/__init__.py +1 -1
  10. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/config_service_v2/__init__.py +1 -1
  11. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/config_service_v2/async_client.py +39 -28
  12. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/config_service_v2/client.py +37 -22
  13. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/config_service_v2/pagers.py +1 -1
  14. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/config_service_v2/transports/__init__.py +1 -1
  15. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/config_service_v2/transports/base.py +7 -1
  16. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/config_service_v2/transports/grpc.py +7 -3
  17. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/config_service_v2/transports/grpc_asyncio.py +7 -3
  18. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/logging_service_v2/__init__.py +1 -1
  19. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/logging_service_v2/async_client.py +29 -18
  20. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/logging_service_v2/client.py +37 -22
  21. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/logging_service_v2/pagers.py +1 -1
  22. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/logging_service_v2/transports/__init__.py +1 -1
  23. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/logging_service_v2/transports/base.py +7 -1
  24. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/logging_service_v2/transports/grpc.py +7 -3
  25. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/logging_service_v2/transports/grpc_asyncio.py +7 -3
  26. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/metrics_service_v2/__init__.py +1 -1
  27. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/metrics_service_v2/async_client.py +29 -18
  28. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/metrics_service_v2/client.py +37 -22
  29. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/metrics_service_v2/pagers.py +1 -1
  30. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/metrics_service_v2/transports/__init__.py +1 -1
  31. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/metrics_service_v2/transports/base.py +7 -1
  32. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/metrics_service_v2/transports/grpc.py +7 -3
  33. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/services/metrics_service_v2/transports/grpc_asyncio.py +7 -3
  34. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/types/__init__.py +1 -1
  35. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/types/log_entry.py +1 -1
  36. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/types/logging.py +1 -1
  37. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/types/logging_config.py +1 -1
  38. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/types/logging_metrics.py +1 -1
  39. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0/google_cloud_logging.egg-info}/PKG-INFO +20 -22
  40. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google_cloud_logging.egg-info/requires.txt +4 -4
  41. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/setup.py +7 -10
  42. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/__init__.py +1 -1
  43. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/__init__.py +1 -1
  44. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/gapic/__init__.py +1 -1
  45. google_cloud_logging-3.16.0/tests/unit/gapic/logging_v2/__init__.py +15 -0
  46. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/gapic/logging_v2/test_config_service_v2.py +605 -533
  47. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/gapic/logging_v2/test_logging_service_v2.py +237 -128
  48. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/gapic/logging_v2/test_metrics_service_v2.py +223 -109
  49. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/test_app_engine.py +46 -32
  50. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test_logger.py +0 -11
  51. google_cloud_logging-3.14.0/tests/unit/gapic/logging_v2/__init__.py +0 -15
  52. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/LICENSE +0 -0
  53. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging/handlers/__init__.py +0 -0
  54. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging/handlers/middleware/__init__.py +0 -0
  55. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging/handlers/transports/__init__.py +0 -0
  56. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging/py.typed +0 -0
  57. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/_gapic.py +0 -0
  58. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/_helpers.py +0 -0
  59. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/_http.py +0 -0
  60. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/_instrumentation.py +0 -0
  61. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/entries.py +0 -0
  62. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/gapic_metadata.json +0 -0
  63. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/__init__.py +0 -0
  64. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/_helpers.py +0 -0
  65. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/_monitored_resources.py +0 -0
  66. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/app_engine.py +0 -0
  67. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/container_engine.py +0 -0
  68. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/handlers.py +0 -0
  69. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/middleware/__init__.py +0 -0
  70. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/middleware/request.py +0 -0
  71. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/structured_log.py +0 -0
  72. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/transports/__init__.py +0 -0
  73. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/transports/background_thread.py +0 -0
  74. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/transports/base.py +0 -0
  75. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/handlers/transports/sync.py +0 -0
  76. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/logger.py +0 -0
  77. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/metric.py +0 -0
  78. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/py.typed +0 -0
  79. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/resource.py +0 -0
  80. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google/cloud/logging_v2/sink.py +0 -0
  81. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google_cloud_logging.egg-info/SOURCES.txt +0 -0
  82. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google_cloud_logging.egg-info/dependency_links.txt +0 -0
  83. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google_cloud_logging.egg-info/not-zip-safe +0 -0
  84. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/google_cloud_logging.egg-info/top_level.txt +0 -0
  85. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/setup.cfg +0 -0
  86. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/system/gapic/v2/test_system_logging_service_v2_v2.py +0 -0
  87. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/system/test_system.py +0 -0
  88. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/__init__.py +0 -0
  89. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/middleware/test_request.py +0 -0
  90. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/test__helpers.py +0 -0
  91. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/test__monitored_resources.py +0 -0
  92. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/test_container_engine.py +0 -0
  93. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/test_handlers.py +0 -0
  94. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/test_structured_log.py +0 -0
  95. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/transports/__init__.py +0 -0
  96. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/transports/test_background_thread.py +0 -0
  97. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/transports/test_base.py +0 -0
  98. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/handlers/transports/test_sync.py +0 -0
  99. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test__gapic.py +0 -0
  100. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test__helpers.py +0 -0
  101. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test__http.py +0 -0
  102. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test__instrumentation.py +0 -0
  103. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test_client.py +0 -0
  104. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test_entries.py +0 -0
  105. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test_logging_shim.py +0 -0
  106. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test_metric.py +0 -0
  107. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test_packaging.py +0 -0
  108. {google_cloud_logging-3.14.0 → google_cloud_logging-3.16.0}/tests/unit/test_sink.py +0 -0
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- # Copyright 2025 Google LLC
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.
@@ -1,20 +1,17 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: google-cloud-logging
3
- Version: 3.14.0
3
+ Version: 3.16.0
4
4
  Summary: Google Cloud Logging API client library
5
5
  Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-logging
6
6
  Author: Google LLC
7
7
  Author-email: googleapis-packages@google.com
8
- License: Apache 2.0
8
+ License: Apache-2.0
9
9
  Platform: Posix; MacOS X; Windows
10
10
  Classifier: Development Status :: 5 - Production/Stable
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.7
16
- Classifier: Programming Language :: Python :: 3.8
17
- Classifier: Programming Language :: Python :: 3.9
18
15
  Classifier: Programming Language :: Python :: 3.10
19
16
  Classifier: Programming Language :: Python :: 3.11
20
17
  Classifier: Programming Language :: Python :: 3.12
@@ -22,20 +19,20 @@ Classifier: Programming Language :: Python :: 3.13
22
19
  Classifier: Programming Language :: Python :: 3.14
23
20
  Classifier: Operating System :: OS Independent
24
21
  Classifier: Topic :: Internet
25
- Requires-Python: >=3.7
22
+ Requires-Python: >=3.10
26
23
  License-File: LICENSE
27
- 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
24
+ Requires-Dist: google-api-core[grpc]<3.0.0,>=2.17.1
28
25
  Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
29
26
  Requires-Dist: google-cloud-appengine-logging<2.0.0,>=0.1.3
30
27
  Requires-Dist: google-cloud-audit-log<1.0.0,>=0.3.1
31
28
  Requires-Dist: google-cloud-core<3.0.0,>=2.0.0
32
29
  Requires-Dist: grpc-google-iam-v1<1.0.0,>=0.12.4
33
- Requires-Dist: opentelemetry-api>=1.9.0
34
- Requires-Dist: grpcio<2.0.0,>=1.33.2
30
+ Requires-Dist: opentelemetry-api>=1.16.0
31
+ Requires-Dist: grpcio<2.0.0,>=1.59.0
35
32
  Requires-Dist: grpcio<2.0.0,>=1.75.1; python_version >= "3.14"
36
33
  Requires-Dist: proto-plus<2.0.0,>=1.22.3
37
34
  Requires-Dist: proto-plus<2.0.0,>=1.25.0; python_version >= "3.13"
38
- 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
35
+ Requires-Dist: protobuf<8.0.0,>=4.25.8
39
36
  Dynamic: author
40
37
  Dynamic: author-email
41
38
  Dynamic: classifier
@@ -48,12 +45,12 @@ Dynamic: requires-dist
48
45
  Dynamic: requires-python
49
46
  Dynamic: summary
50
47
 
51
- Python Client for Cloud Logging API
52
- ===================================
48
+ Python Client for Cloud Logging
49
+ ===============================
53
50
 
54
51
  |stable| |pypi| |versions|
55
52
 
56
- `Cloud Logging API`_: Writes log entries and manages your Cloud Logging configuration.
53
+ `Cloud Logging`_: Writes log entries and manages your Cloud Logging configuration.
57
54
 
58
55
  - `Client Library Documentation`_
59
56
  - `Product Documentation`_
@@ -64,9 +61,9 @@ Python Client for Cloud Logging API
64
61
  :target: https://pypi.org/project/google-cloud-logging/
65
62
  .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-logging.svg
66
63
  :target: https://pypi.org/project/google-cloud-logging/
67
- .. _Cloud Logging API: https://cloud.google.com/logging/docs
64
+ .. _Cloud Logging: https://cloud.google.com/logging/
68
65
  .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/logging/latest/summary_overview
69
- .. _Product Documentation: https://cloud.google.com/logging/docs
66
+ .. _Product Documentation: https://cloud.google.com/logging/
70
67
 
71
68
  Quick Start
72
69
  -----------
@@ -75,12 +72,12 @@ In order to use this library, you first need to go through the following steps:
75
72
 
76
73
  1. `Select or create a Cloud Platform project.`_
77
74
  2. `Enable billing for your project.`_
78
- 3. `Enable the Cloud Logging API.`_
75
+ 3. `Enable the Cloud Logging.`_
79
76
  4. `Set up Authentication.`_
80
77
 
81
78
  .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
82
79
  .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
83
- .. _Enable the Cloud Logging API.: https://cloud.google.com/logging/docs
80
+ .. _Enable the Cloud Logging.: https://cloud.google.com/logging/
84
81
  .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
85
82
 
86
83
  For an interactive walkthrough on how to use this library in a python application, click the Guide Me button below:
@@ -118,14 +115,15 @@ Supported Python Versions
118
115
  Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
119
116
  Python.
120
117
 
121
- Python >= 3.7, including 3.14
118
+ Python >= 3.10, including 3.14
122
119
 
123
120
  .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
124
121
  .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
125
122
 
126
123
  Unsupported Python Versions
127
124
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^
128
- Python <= 3.6
125
+ Python <= 3.9
126
+
129
127
 
130
128
  If you are using an `end-of-life`_
131
129
  version of Python, we recommend that you update as soon as possible to an actively supported version.
@@ -154,14 +152,14 @@ Windows
154
152
  Next Steps
155
153
  ~~~~~~~~~~
156
154
 
157
- - Read the `Client Library Documentation`_ for Cloud Logging API
155
+ - Read the `Client Library Documentation`_ for Cloud Logging
158
156
  to see other available methods on the client.
159
- - Read the `Cloud Logging API Product documentation`_ to learn
157
+ - Read the `Cloud Logging Product documentation`_ to learn
160
158
  more about the product and see How-to Guides.
161
159
  - View this `README`_ to see the full list of Cloud
162
160
  APIs that we cover.
163
161
 
164
- .. _Cloud Logging API Product documentation: https://cloud.google.com/logging/docs
162
+ .. _Cloud Logging Product documentation: https://cloud.google.com/logging/
165
163
  .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
166
164
 
167
165
  Logging
@@ -1,9 +1,9 @@
1
- Python Client for Cloud Logging API
2
- ===================================
1
+ Python Client for Cloud Logging
2
+ ===============================
3
3
 
4
4
  |stable| |pypi| |versions|
5
5
 
6
- `Cloud Logging API`_: Writes log entries and manages your Cloud Logging configuration.
6
+ `Cloud Logging`_: Writes log entries and manages your Cloud Logging configuration.
7
7
 
8
8
  - `Client Library Documentation`_
9
9
  - `Product Documentation`_
@@ -14,9 +14,9 @@ Python Client for Cloud Logging API
14
14
  :target: https://pypi.org/project/google-cloud-logging/
15
15
  .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-logging.svg
16
16
  :target: https://pypi.org/project/google-cloud-logging/
17
- .. _Cloud Logging API: https://cloud.google.com/logging/docs
17
+ .. _Cloud Logging: https://cloud.google.com/logging/
18
18
  .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/logging/latest/summary_overview
19
- .. _Product Documentation: https://cloud.google.com/logging/docs
19
+ .. _Product Documentation: https://cloud.google.com/logging/
20
20
 
21
21
  Quick Start
22
22
  -----------
@@ -25,12 +25,12 @@ In order to use this library, you first need to go through the following steps:
25
25
 
26
26
  1. `Select or create a Cloud Platform project.`_
27
27
  2. `Enable billing for your project.`_
28
- 3. `Enable the Cloud Logging API.`_
28
+ 3. `Enable the Cloud Logging.`_
29
29
  4. `Set up Authentication.`_
30
30
 
31
31
  .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
32
32
  .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
33
- .. _Enable the Cloud Logging API.: https://cloud.google.com/logging/docs
33
+ .. _Enable the Cloud Logging.: https://cloud.google.com/logging/
34
34
  .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
35
35
 
36
36
  For an interactive walkthrough on how to use this library in a python application, click the Guide Me button below:
@@ -68,14 +68,15 @@ Supported Python Versions
68
68
  Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
69
69
  Python.
70
70
 
71
- Python >= 3.7, including 3.14
71
+ Python >= 3.10, including 3.14
72
72
 
73
73
  .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
74
74
  .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
75
75
 
76
76
  Unsupported Python Versions
77
77
  ^^^^^^^^^^^^^^^^^^^^^^^^^^^
78
- Python <= 3.6
78
+ Python <= 3.9
79
+
79
80
 
80
81
  If you are using an `end-of-life`_
81
82
  version of Python, we recommend that you update as soon as possible to an actively supported version.
@@ -104,14 +105,14 @@ Windows
104
105
  Next Steps
105
106
  ~~~~~~~~~~
106
107
 
107
- - Read the `Client Library Documentation`_ for Cloud Logging API
108
+ - Read the `Client Library Documentation`_ for Cloud Logging
108
109
  to see other available methods on the client.
109
- - Read the `Cloud Logging API Product documentation`_ to learn
110
+ - Read the `Cloud Logging Product documentation`_ to learn
110
111
  more about the product and see How-to Guides.
111
112
  - View this `README`_ to see the full list of Cloud
112
113
  APIs that we cover.
113
114
 
114
- .. _Cloud Logging API Product documentation: https://cloud.google.com/logging/docs
115
+ .. _Cloud Logging Product documentation: https://cloud.google.com/logging/
115
116
  .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
116
117
 
117
118
  Logging
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- # Copyright 2025 Google LLC
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.
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- # Copyright 2025 Google LLC
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__ = "3.14.0" # {x-release-please-version}
16
+ __version__ = "3.16.0" # {x-release-please-version}
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- # Copyright 2025 Google LLC
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.
@@ -383,7 +383,8 @@ class Client(ClientWithProject):
383
383
  elif monitored_resource.type == _GKE_RESOURCE_TYPE:
384
384
  return StructuredLogHandler(**kw, project_id=self.project)
385
385
  elif monitored_resource.type == _GCF_RESOURCE_TYPE:
386
- # __stdout__ stream required to support structured logging on Python 3.7
386
+ # Bypassing redirects via __stdout__ ensures structured logging
387
+ # works robustly on Google Cloud Functions even if stdout is redirected.
387
388
  kw["stream"] = kw.get("stream", sys.__stdout__)
388
389
  return StructuredLogHandler(**kw, project_id=self.project)
389
390
  elif monitored_resource.type == _RUN_RESOURCE_TYPE:
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- # Copyright 2025 Google LLC
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__ = "3.14.0" # {x-release-please-version}
16
+ __version__ = "3.16.0" # {x-release-please-version}
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- # Copyright 2025 Google LLC
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.
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- # Copyright 2025 Google LLC
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.
@@ -1,5 +1,5 @@
1
1
  # -*- coding: utf-8 -*-
2
- # Copyright 2025 Google LLC
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.
@@ -15,7 +15,6 @@
15
15
  #
16
16
  import logging as std_logging
17
17
  import re
18
- import uuid
19
18
  from collections import OrderedDict
20
19
  from typing import (
21
20
  Callable,
@@ -209,7 +208,7 @@ class ConfigServiceV2AsyncClient:
209
208
  return self._client.transport
210
209
 
211
210
  @property
212
- def api_endpoint(self):
211
+ def api_endpoint(self) -> str:
213
212
  """Return the API endpoint used by the client instance.
214
213
 
215
214
  Returns:
@@ -575,11 +574,11 @@ class ConfigServiceV2AsyncClient:
575
574
  )
576
575
 
577
576
  # Make the request
578
- operation = client.create_bucket_async(request=request)
577
+ operation = await client.create_bucket_async(request=request)
579
578
 
580
579
  print("Waiting for operation to complete...")
581
580
 
582
- response = (await operation).result()
581
+ response = await operation.result()
583
582
 
584
583
  # Handle the response
585
584
  print(response)
@@ -681,11 +680,11 @@ class ConfigServiceV2AsyncClient:
681
680
  )
682
681
 
683
682
  # Make the request
684
- operation = client.update_bucket_async(request=request)
683
+ operation = await client.update_bucket_async(request=request)
685
684
 
686
685
  print("Waiting for operation to complete...")
687
686
 
688
- response = (await operation).result()
687
+ response = await operation.result()
689
688
 
690
689
  # Handle the response
691
690
  print(response)
@@ -2274,11 +2273,11 @@ class ConfigServiceV2AsyncClient:
2274
2273
  )
2275
2274
 
2276
2275
  # Make the request
2277
- operation = client.create_link(request=request)
2276
+ operation = await client.create_link(request=request)
2278
2277
 
2279
2278
  print("Waiting for operation to complete...")
2280
2279
 
2281
- response = (await operation).result()
2280
+ response = await operation.result()
2282
2281
 
2283
2282
  # Handle the response
2284
2283
  print(response)
@@ -2424,11 +2423,11 @@ class ConfigServiceV2AsyncClient:
2424
2423
  )
2425
2424
 
2426
2425
  # Make the request
2427
- operation = client.delete_link(request=request)
2426
+ operation = await client.delete_link(request=request)
2428
2427
 
2429
2428
  print("Waiting for operation to complete...")
2430
2429
 
2431
- response = (await operation).result()
2430
+ response = await operation.result()
2432
2431
 
2433
2432
  # Handle the response
2434
2433
  print(response)
@@ -3992,11 +3991,11 @@ class ConfigServiceV2AsyncClient:
3992
3991
  )
3993
3992
 
3994
3993
  # Make the request
3995
- operation = client.copy_log_entries(request=request)
3994
+ operation = await client.copy_log_entries(request=request)
3996
3995
 
3997
3996
  print("Waiting for operation to complete...")
3998
3997
 
3999
- response = (await operation).result()
3998
+ response = await operation.result()
4000
3999
 
4001
4000
  # Handle the response
4002
4001
  print(response)
@@ -4058,7 +4057,7 @@ class ConfigServiceV2AsyncClient:
4058
4057
 
4059
4058
  async def list_operations(
4060
4059
  self,
4061
- request: Optional[operations_pb2.ListOperationsRequest] = None,
4060
+ request: Optional[Union[operations_pb2.ListOperationsRequest, dict]] = None,
4062
4061
  *,
4063
4062
  retry: OptionalRetry = gapic_v1.method.DEFAULT,
4064
4063
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
@@ -4084,8 +4083,12 @@ class ConfigServiceV2AsyncClient:
4084
4083
  # Create or coerce a protobuf request object.
4085
4084
  # The request isn't a proto-plus wrapped type,
4086
4085
  # so it must be constructed via keyword expansion.
4087
- if isinstance(request, dict):
4088
- request = operations_pb2.ListOperationsRequest(**request)
4086
+ if request is None:
4087
+ request_pb = operations_pb2.ListOperationsRequest()
4088
+ elif isinstance(request, dict):
4089
+ request_pb = operations_pb2.ListOperationsRequest(**request)
4090
+ else:
4091
+ request_pb = request
4089
4092
 
4090
4093
  # Wrap the RPC method; this adds retry and timeout information,
4091
4094
  # and friendly error handling.
@@ -4094,7 +4097,7 @@ class ConfigServiceV2AsyncClient:
4094
4097
  # Certain fields should be provided within the metadata header;
4095
4098
  # add these here.
4096
4099
  metadata = tuple(metadata) + (
4097
- gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)),
4100
+ gapic_v1.routing_header.to_grpc_metadata((("name", request_pb.name),)),
4098
4101
  )
4099
4102
 
4100
4103
  # Validate the universe domain.
@@ -4102,7 +4105,7 @@ class ConfigServiceV2AsyncClient:
4102
4105
 
4103
4106
  # Send the request.
4104
4107
  response = await rpc(
4105
- request,
4108
+ request_pb,
4106
4109
  retry=retry,
4107
4110
  timeout=timeout,
4108
4111
  metadata=metadata,
@@ -4113,7 +4116,7 @@ class ConfigServiceV2AsyncClient:
4113
4116
 
4114
4117
  async def get_operation(
4115
4118
  self,
4116
- request: Optional[operations_pb2.GetOperationRequest] = None,
4119
+ request: Optional[Union[operations_pb2.GetOperationRequest, dict]] = None,
4117
4120
  *,
4118
4121
  retry: OptionalRetry = gapic_v1.method.DEFAULT,
4119
4122
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
@@ -4139,8 +4142,12 @@ class ConfigServiceV2AsyncClient:
4139
4142
  # Create or coerce a protobuf request object.
4140
4143
  # The request isn't a proto-plus wrapped type,
4141
4144
  # so it must be constructed via keyword expansion.
4142
- if isinstance(request, dict):
4143
- request = operations_pb2.GetOperationRequest(**request)
4145
+ if request is None:
4146
+ request_pb = operations_pb2.GetOperationRequest()
4147
+ elif isinstance(request, dict):
4148
+ request_pb = operations_pb2.GetOperationRequest(**request)
4149
+ else:
4150
+ request_pb = request
4144
4151
 
4145
4152
  # Wrap the RPC method; this adds retry and timeout information,
4146
4153
  # and friendly error handling.
@@ -4149,7 +4156,7 @@ class ConfigServiceV2AsyncClient:
4149
4156
  # Certain fields should be provided within the metadata header;
4150
4157
  # add these here.
4151
4158
  metadata = tuple(metadata) + (
4152
- gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)),
4159
+ gapic_v1.routing_header.to_grpc_metadata((("name", request_pb.name),)),
4153
4160
  )
4154
4161
 
4155
4162
  # Validate the universe domain.
@@ -4157,7 +4164,7 @@ class ConfigServiceV2AsyncClient:
4157
4164
 
4158
4165
  # Send the request.
4159
4166
  response = await rpc(
4160
- request,
4167
+ request_pb,
4161
4168
  retry=retry,
4162
4169
  timeout=timeout,
4163
4170
  metadata=metadata,
@@ -4168,7 +4175,7 @@ class ConfigServiceV2AsyncClient:
4168
4175
 
4169
4176
  async def cancel_operation(
4170
4177
  self,
4171
- request: Optional[operations_pb2.CancelOperationRequest] = None,
4178
+ request: Optional[Union[operations_pb2.CancelOperationRequest, dict]] = None,
4172
4179
  *,
4173
4180
  retry: OptionalRetry = gapic_v1.method.DEFAULT,
4174
4181
  timeout: Union[float, object] = gapic_v1.method.DEFAULT,
@@ -4197,8 +4204,12 @@ class ConfigServiceV2AsyncClient:
4197
4204
  # Create or coerce a protobuf request object.
4198
4205
  # The request isn't a proto-plus wrapped type,
4199
4206
  # so it must be constructed via keyword expansion.
4200
- if isinstance(request, dict):
4201
- request = operations_pb2.CancelOperationRequest(**request)
4207
+ if request is None:
4208
+ request_pb = operations_pb2.CancelOperationRequest()
4209
+ elif isinstance(request, dict):
4210
+ request_pb = operations_pb2.CancelOperationRequest(**request)
4211
+ else:
4212
+ request_pb = request
4202
4213
 
4203
4214
  # Wrap the RPC method; this adds retry and timeout information,
4204
4215
  # and friendly error handling.
@@ -4207,7 +4218,7 @@ class ConfigServiceV2AsyncClient:
4207
4218
  # Certain fields should be provided within the metadata header;
4208
4219
  # add these here.
4209
4220
  metadata = tuple(metadata) + (
4210
- gapic_v1.routing_header.to_grpc_metadata((("name", request.name),)),
4221
+ gapic_v1.routing_header.to_grpc_metadata((("name", request_pb.name),)),
4211
4222
  )
4212
4223
 
4213
4224
  # Validate the universe domain.
@@ -4215,7 +4226,7 @@ class ConfigServiceV2AsyncClient:
4215
4226
 
4216
4227
  # Send the request.
4217
4228
  await rpc(
4218
- request,
4229
+ request_pb,
4219
4230
  retry=retry,
4220
4231
  timeout=timeout,
4221
4232
  metadata=metadata,