google-cloud-devicestreaming 0.1.0__py3-none-any.whl

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 (26) hide show
  1. google/cloud/devicestreaming/__init__.py +69 -0
  2. google/cloud/devicestreaming/gapic_version.py +16 -0
  3. google/cloud/devicestreaming/py.typed +2 -0
  4. google/cloud/devicestreaming_v1/__init__.py +67 -0
  5. google/cloud/devicestreaming_v1/gapic_metadata.json +118 -0
  6. google/cloud/devicestreaming_v1/gapic_version.py +16 -0
  7. google/cloud/devicestreaming_v1/py.typed +2 -0
  8. google/cloud/devicestreaming_v1/services/__init__.py +15 -0
  9. google/cloud/devicestreaming_v1/services/direct_access_service/__init__.py +22 -0
  10. google/cloud/devicestreaming_v1/services/direct_access_service/async_client.py +1001 -0
  11. google/cloud/devicestreaming_v1/services/direct_access_service/client.py +1410 -0
  12. google/cloud/devicestreaming_v1/services/direct_access_service/pagers.py +197 -0
  13. google/cloud/devicestreaming_v1/services/direct_access_service/transports/__init__.py +38 -0
  14. google/cloud/devicestreaming_v1/services/direct_access_service/transports/base.py +262 -0
  15. google/cloud/devicestreaming_v1/services/direct_access_service/transports/grpc.py +512 -0
  16. google/cloud/devicestreaming_v1/services/direct_access_service/transports/grpc_asyncio.py +592 -0
  17. google/cloud/devicestreaming_v1/services/direct_access_service/transports/rest.py +1234 -0
  18. google/cloud/devicestreaming_v1/services/direct_access_service/transports/rest_base.py +361 -0
  19. google/cloud/devicestreaming_v1/types/__init__.py +56 -0
  20. google/cloud/devicestreaming_v1/types/adb_service.py +317 -0
  21. google/cloud/devicestreaming_v1/types/service.py +410 -0
  22. google_cloud_devicestreaming-0.1.0.dist-info/LICENSE +202 -0
  23. google_cloud_devicestreaming-0.1.0.dist-info/METADATA +228 -0
  24. google_cloud_devicestreaming-0.1.0.dist-info/RECORD +26 -0
  25. google_cloud_devicestreaming-0.1.0.dist-info/WHEEL +5 -0
  26. google_cloud_devicestreaming-0.1.0.dist-info/top_level.txt +1 -0
@@ -0,0 +1,228 @@
1
+ Metadata-Version: 2.1
2
+ Name: google-cloud-devicestreaming
3
+ Version: 0.1.0
4
+ Summary: Google Cloud Devicestreaming API client library
5
+ Home-page: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-devicestreaming
6
+ Author: Google LLC
7
+ Author-email: googleapis-packages@google.com
8
+ License: Apache 2.0
9
+ Platform: Posix; MacOS X; Windows
10
+ Classifier: Development Status :: 4 - Beta
11
+ Classifier: Intended Audience :: Developers
12
+ Classifier: License :: OSI Approved :: Apache Software License
13
+ Classifier: Programming Language :: Python
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
+ Classifier: Programming Language :: Python :: 3.10
19
+ Classifier: Programming Language :: Python :: 3.11
20
+ Classifier: Programming Language :: Python :: 3.12
21
+ Classifier: Programming Language :: Python :: 3.13
22
+ Classifier: Operating System :: OS Independent
23
+ Classifier: Topic :: Internet
24
+ Requires-Python: >=3.7
25
+ License-File: LICENSE
26
+ 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
27
+ Requires-Dist: google-auth!=2.24.0,!=2.25.0,<3.0.0,>=2.14.1
28
+ Requires-Dist: proto-plus<2.0.0,>=1.22.3
29
+ 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
30
+ Requires-Dist: proto-plus<2.0.0,>=1.25.0; python_version >= "3.13"
31
+
32
+ Python Client for Device Streaming API
33
+ ======================================
34
+
35
+ |preview| |pypi| |versions|
36
+
37
+ `Device Streaming API`_: The Cloud API for device streaming usage.
38
+
39
+ - `Client Library Documentation`_
40
+ - `Product Documentation`_
41
+
42
+ .. |preview| image:: https://img.shields.io/badge/support-preview-orange.svg
43
+ :target: https://github.com/googleapis/google-cloud-python/blob/main/README.rst#stability-levels
44
+ .. |pypi| image:: https://img.shields.io/pypi/v/google-cloud-devicestreaming.svg
45
+ :target: https://pypi.org/project/google-cloud-devicestreaming/
46
+ .. |versions| image:: https://img.shields.io/pypi/pyversions/google-cloud-devicestreaming.svg
47
+ :target: https://pypi.org/project/google-cloud-devicestreaming/
48
+ .. _Device Streaming API: https://cloud.google.com/device-streaming/docs
49
+ .. _Client Library Documentation: https://cloud.google.com/python/docs/reference/google-cloud-devicestreaming/latest/summary_overview
50
+ .. _Product Documentation: https://cloud.google.com/device-streaming/docs
51
+
52
+ Quick Start
53
+ -----------
54
+
55
+ In order to use this library, you first need to go through the following steps:
56
+
57
+ 1. `Select or create a Cloud Platform project.`_
58
+ 2. `Enable billing for your project.`_
59
+ 3. `Enable the Device Streaming API.`_
60
+ 4. `Set up Authentication.`_
61
+
62
+ .. _Select or create a Cloud Platform project.: https://console.cloud.google.com/project
63
+ .. _Enable billing for your project.: https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project
64
+ .. _Enable the Device Streaming API.: https://cloud.google.com/device-streaming/docs
65
+ .. _Set up Authentication.: https://googleapis.dev/python/google-api-core/latest/auth.html
66
+
67
+ Installation
68
+ ~~~~~~~~~~~~
69
+
70
+ Install this library in a virtual environment using `venv`_. `venv`_ is a tool that
71
+ creates isolated Python environments. These isolated environments can have separate
72
+ versions of Python packages, which allows you to isolate one project's dependencies
73
+ from the dependencies of other projects.
74
+
75
+ With `venv`_, it's possible to install this library without needing system
76
+ install permissions, and without clashing with the installed system
77
+ dependencies.
78
+
79
+ .. _`venv`: https://docs.python.org/3/library/venv.html
80
+
81
+
82
+ Code samples and snippets
83
+ ~~~~~~~~~~~~~~~~~~~~~~~~~
84
+
85
+ Code samples and snippets live in the `samples/`_ folder.
86
+
87
+ .. _samples/: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-devicestreaming/samples
88
+
89
+
90
+ Supported Python Versions
91
+ ^^^^^^^^^^^^^^^^^^^^^^^^^
92
+ Our client libraries are compatible with all current `active`_ and `maintenance`_ versions of
93
+ Python.
94
+
95
+ Python >= 3.7
96
+
97
+ .. _active: https://devguide.python.org/devcycle/#in-development-main-branch
98
+ .. _maintenance: https://devguide.python.org/devcycle/#maintenance-branches
99
+
100
+ Unsupported Python Versions
101
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^^
102
+ Python <= 3.6
103
+
104
+ If you are using an `end-of-life`_
105
+ version of Python, we recommend that you update as soon as possible to an actively supported version.
106
+
107
+ .. _end-of-life: https://devguide.python.org/devcycle/#end-of-life-branches
108
+
109
+ Mac/Linux
110
+ ^^^^^^^^^
111
+
112
+ .. code-block:: console
113
+
114
+ python3 -m venv <your-env>
115
+ source <your-env>/bin/activate
116
+ pip install google-cloud-devicestreaming
117
+
118
+
119
+ Windows
120
+ ^^^^^^^
121
+
122
+ .. code-block:: console
123
+
124
+ py -m venv <your-env>
125
+ .\<your-env>\Scripts\activate
126
+ pip install google-cloud-devicestreaming
127
+
128
+ Next Steps
129
+ ~~~~~~~~~~
130
+
131
+ - Read the `Client Library Documentation`_ for Device Streaming API
132
+ to see other available methods on the client.
133
+ - Read the `Device Streaming API Product documentation`_ to learn
134
+ more about the product and see How-to Guides.
135
+ - View this `README`_ to see the full list of Cloud
136
+ APIs that we cover.
137
+
138
+ .. _Device Streaming API Product documentation: https://cloud.google.com/device-streaming/docs
139
+ .. _README: https://github.com/googleapis/google-cloud-python/blob/main/README.rst
140
+
141
+ Logging
142
+ -------
143
+
144
+ This library uses the standard Python :code:`logging` functionality to log some RPC events that could be of interest for debugging and monitoring purposes.
145
+ Note the following:
146
+
147
+ #. Logs may contain sensitive information. Take care to **restrict access to the logs** if they are saved, whether it be on local storage or on Google Cloud Logging.
148
+ #. Google may refine the occurrence, level, and content of various log messages in this library without flagging such changes as breaking. **Do not depend on immutability of the logging events**.
149
+ #. By default, the logging events from this library are not handled. You must **explicitly configure log handling** using one of the mechanisms below.
150
+
151
+ Simple, environment-based configuration
152
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
153
+
154
+ To enable logging for this library without any changes in your code, set the :code:`GOOGLE_SDK_PYTHON_LOGGING_SCOPE` environment variable to a valid Google
155
+ logging scope. This configures handling of logging events (at level :code:`logging.DEBUG` or higher) from this library in a default manner, emitting the logged
156
+ messages in a structured format. It does not currently allow customizing the logging levels captured nor the handlers, formatters, etc. used for any logging
157
+ event.
158
+
159
+ A logging scope is a period-separated namespace that begins with :code:`google`, identifying the Python module or package to log.
160
+
161
+ - Valid logging scopes: :code:`google`, :code:`google.cloud.asset.v1`, :code:`google.api`, :code:`google.auth`, etc.
162
+ - Invalid logging scopes: :code:`foo`, :code:`123`, etc.
163
+
164
+ **NOTE**: If the logging scope is invalid, the library does not set up any logging handlers.
165
+
166
+ Environment-Based Examples
167
+ ^^^^^^^^^^^^^^^^^^^^^^^^^^
168
+
169
+ - Enabling the default handler for all Google-based loggers
170
+
171
+ .. code-block:: console
172
+
173
+ export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google
174
+
175
+ - Enabling the default handler for a specific Google module (for a client library called :code:`library_v1`):
176
+
177
+ .. code-block:: console
178
+
179
+ export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.cloud.library_v1
180
+
181
+
182
+ Advanced, code-based configuration
183
+ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
184
+
185
+ You can also configure a valid logging scope using Python's standard `logging` mechanism.
186
+
187
+ Code-Based Examples
188
+ ^^^^^^^^^^^^^^^^^^^
189
+
190
+ - Configuring a handler for all Google-based loggers
191
+
192
+ .. code-block:: python
193
+
194
+ import logging
195
+
196
+ from google.cloud import library_v1
197
+
198
+ base_logger = logging.getLogger("google")
199
+ base_logger.addHandler(logging.StreamHandler())
200
+ base_logger.setLevel(logging.DEBUG)
201
+
202
+ - Configuring a handler for a specific Google module (for a client library called :code:`library_v1`):
203
+
204
+ .. code-block:: python
205
+
206
+ import logging
207
+
208
+ from google.cloud import library_v1
209
+
210
+ base_logger = logging.getLogger("google.cloud.library_v1")
211
+ base_logger.addHandler(logging.StreamHandler())
212
+ base_logger.setLevel(logging.DEBUG)
213
+
214
+ Logging details
215
+ ~~~~~~~~~~~~~~~
216
+
217
+ #. Regardless of which of the mechanisms above you use to configure logging for this library, by default logging events are not propagated up to the root
218
+ logger from the `google`-level logger. If you need the events to be propagated to the root logger, you must explicitly set
219
+ :code:`logging.getLogger("google").propagate = True` in your code.
220
+ #. You can mix the different logging configurations above for different Google modules. For example, you may want use a code-based logging configuration for
221
+ one library, but decide you need to also set up environment-based logging configuration for another library.
222
+
223
+ #. If you attempt to use both code-based and environment-based configuration for the same module, the environment-based configuration will be ineffectual
224
+ if the code -based configuration gets applied first.
225
+
226
+ #. The Google-specific logging configurations (default handlers for environment-based configuration; not propagating logging events to the root logger) get
227
+ executed the first time *any* client library is instantiated in your application, and only if the affected loggers have not been previously configured.
228
+ (This is the reason for 2.i. above.)
@@ -0,0 +1,26 @@
1
+ google/cloud/devicestreaming/__init__.py,sha256=rtK8fQyofujdTohzps7BLNBXKhCGULH0-_b1vZZlMxE,1920
2
+ google/cloud/devicestreaming/gapic_version.py,sha256=BkWfWAp4YMBJHw2nmZcKWv8E9aqy0wHtomdnYHkoA9w,652
3
+ google/cloud/devicestreaming/py.typed,sha256=okKffHNB0KVQ8RWzji3P91-QVhjcn7QrSnuTknjctoA,89
4
+ google/cloud/devicestreaming_v1/__init__.py,sha256=O10qXJO3aZG0B2Yi8eBBHk_WIbjkVUCZe-1TJQx7E_s,1731
5
+ google/cloud/devicestreaming_v1/gapic_metadata.json,sha256=Q8ZYLR5QcwVyWkmb2p6EVJf6OmX-8OQXbkw3rjoGPKQ,3041
6
+ google/cloud/devicestreaming_v1/gapic_version.py,sha256=BkWfWAp4YMBJHw2nmZcKWv8E9aqy0wHtomdnYHkoA9w,652
7
+ google/cloud/devicestreaming_v1/py.typed,sha256=okKffHNB0KVQ8RWzji3P91-QVhjcn7QrSnuTknjctoA,89
8
+ google/cloud/devicestreaming_v1/services/__init__.py,sha256=ABnBlq63X5TtiLc0JptfQUECNGc-s0WTBlbk0_83qf0,600
9
+ google/cloud/devicestreaming_v1/services/direct_access_service/__init__.py,sha256=lDvD9NwARAO0syf6zAb7fXyXX29OrxnH5KiUxg1i7fU,789
10
+ google/cloud/devicestreaming_v1/services/direct_access_service/async_client.py,sha256=pc38bRooK3QkW1oCWUoLgWZZ1iGbOktP1DbLuiLOuko,42795
11
+ google/cloud/devicestreaming_v1/services/direct_access_service/client.py,sha256=v8tN4cmJqBcw7qYnRb2HNMMomM0ssDewnaQ6HYzfAtk,58797
12
+ google/cloud/devicestreaming_v1/services/direct_access_service/pagers.py,sha256=3KOJ8KgP3FJy0D_5yvx8VDRXQxUVSBzH3Lmp-N54cT4,7890
13
+ google/cloud/devicestreaming_v1/services/direct_access_service/transports/__init__.py,sha256=-9fnZVJ9ImQoc4sHd4fYQXjpEyddKZH_Q5v_1D-49W8,1478
14
+ google/cloud/devicestreaming_v1/services/direct_access_service/transports/base.py,sha256=OnRD1zMpP0T3OICNXQp1h6FLGU1ZnY-_bwMtAkVbubw,9625
15
+ google/cloud/devicestreaming_v1/services/direct_access_service/transports/grpc.py,sha256=Kz-DaUFjt1sdWxP7vTuD_KptC3CHXzJL8Tjl9yvisCg,22844
16
+ google/cloud/devicestreaming_v1/services/direct_access_service/transports/grpc_asyncio.py,sha256=dvBpRGkb2IeVshh0TEdqfShH2ztNaMfgx9cKqZdFyYE,26106
17
+ google/cloud/devicestreaming_v1/services/direct_access_service/transports/rest.py,sha256=r3FViEW9uCKpC9dqN6Hw_WfW7tZcarP_Jy9KJ1R65T4,51370
18
+ google/cloud/devicestreaming_v1/services/direct_access_service/transports/rest_base.py,sha256=IS7P8KVt2QWQonJBqocxLJyYTFyfvM6hQUXF3goDplo,13013
19
+ google/cloud/devicestreaming_v1/types/__init__.py,sha256=ts31EjIEbViAVfxJtXnas6-ItRMXjqsf6F6L40NG03E,1411
20
+ google/cloud/devicestreaming_v1/types/adb_service.py,sha256=fX-irfbsHyPzXSxvlZIhimCJ6iq4lIUsXrJWlKeUAPE,8912
21
+ google/cloud/devicestreaming_v1/types/service.py,sha256=cHR6QAPk5Pzp_XSQ4Z8oz7x78Akmp_-HzOMx_DU-E4Y,13448
22
+ google_cloud_devicestreaming-0.1.0.dist-info/LICENSE,sha256=z8d0m5b2O9McPEK1xHG_dWgUBT6EfBDz6wA0F7xSPTA,11358
23
+ google_cloud_devicestreaming-0.1.0.dist-info/METADATA,sha256=1xH3sK5W_wZGIeXiv_8Zjx-vmIJ41hocbdAbk7N6Lwo,9472
24
+ google_cloud_devicestreaming-0.1.0.dist-info/WHEEL,sha256=P9jw-gEje8ByB7_hXoICnHtVCrEwMQh-630tKvQWehc,91
25
+ google_cloud_devicestreaming-0.1.0.dist-info/top_level.txt,sha256=_1QvSJIhFAGfxb79D6DhB7SUw2X6T4rwnz_LLrbcD3c,7
26
+ google_cloud_devicestreaming-0.1.0.dist-info/RECORD,,
@@ -0,0 +1,5 @@
1
+ Wheel-Version: 1.0
2
+ Generator: setuptools (75.3.0)
3
+ Root-Is-Purelib: true
4
+ Tag: py3-none-any
5
+