google-api-python-client-stubs 1.32.0__tar.gz → 1.34.0__tar.gz

google_api_python_client_stubs-1.34.0/PKG-INFO

@@ -0,0 +1,82 @@
+Metadata-Version: 2.4
+Name: google-api-python-client-stubs
+Version: 1.34.0
+Summary: Type stubs for google-api-python-client
+Author: Henrik Bruåsdal
+Author-email: Henrik Bruåsdal <henrik.bruasdal@gmail.com>
+License-Expression: Apache-2.0
+License-File: LICENSE
+Classifier: Typing :: Stubs Only
+Requires-Dist: google-api-python-client>=2.192.0
+Requires-Dist: types-httplib2>=0.22.0.2
+Requires-Dist: typing-extensions>=3.10.0
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+
+# Type stubs for google-api-python-client
+
+[![PyPI version](https://badge.fury.io/py/google-api-python-client-stubs.svg)](https://badge.fury.io/py/google-api-python-client-stubs)
+
+This package provides type stubs for the [google-api-python-client](https://github.com/googleapis/google-api-python-client) library. 
+It allows you to type check usage of the library with e.g. [mypy](http://mypy-lang.org/) and will also improve autocomplete in many editors.
+
+**This is in no way affiliated with Google.**
+
+The stubs were generated automatically based on Google's [Discovery Documents](https://developers.google.com/discovery/v1/reference/apis), that are bundled with google-api-python-client as of v2.
+
+If you find incorrect annotations, please create an issue.
+
+Releases can be somewhat infrequent. If you need a new release, create an issue and I'll probably get around to it faster.
+
+## Installation
+
+```shell script
+$ pip install google-api-python-client-stubs
+```
+
+The stubs should be automatically picked up by your editor or typechecker.
+
+## Caveats
+
+### Explicit annotations
+The `google-api-python-client-stubs` is quite dynamic. 
+All resources are just instances of a single class with dynamically attached methods
+and the requests and responses are just dictionaries. The way this is annotated is with
+classes and [TypedDicts](https://docs.python.org/3/library/typing.html#typing.TypedDict)
+that don't exist in the actual library, only in the stub files. This means you *cannot* use any of these types at runtime, it *will* cause your code to crash.
+If you rely solely on type inference, this is not an issue, but as soon as you want to explicitly
+annotate a variable, argument or return type in your code with one of these types, you must follow these rules:
+1. Either put `from __future__ import annotations` at the top of your file or surround the annotations with quotes. 
+This ensures that Python doesn't attempt to evaluate the types at runtime. 
+Note that the import is only supported in Python 3.7 and above.
+2. Only import the types inside an `if typing.TYPE_CHECKING` block. This ensures that the imports are only evaluated during
+type checking, not at runtime.
+
+Any type not available at runtime is located under the `googleapiclient._apis` package, with a subpackage for the API and a subpackage for the API version.
+For example, the return type of `build("sheets", "v4")`, `SheetsResource`, should be imported from `googleapiclient._apis.sheets.v4`. Nested resources have a nested class structure, e.g. the return type of `build("sheets", "v4").spreadsheets().values()` is `SheetsResource.SpreadsheetsResource.ValuesResource`.
+If autocompleting import paths doesn't work you can find the correct path by using Mypy's [reveal_type](https://mypy.readthedocs.io/en/stable/common_issues.html#reveal-type)
+on the thing you want to explicitly annotate. For `TypedDict`s this will also give you useful info about the structure of the dictionary.
+
+If you use Pyright/Pylance, you'll get a [reportMissingModuleSource](https://github.com/microsoft/pyright/blob/main/docs/configuration.md#reportMissingModuleSource) error at the import site, which indicates that the stub file doesn't have a corresponding source file. As long as the import only occurs during typechecking, this can be safely ignored. Autocomplete and typechecking will still work.
+
+Note that since the types don't exist at runtime, they're not compatible with libraries that evaluate annotations at runtime. For example, you can't use them to annotate a field in a Pydantic model.
+
+### Performance
+The stubs contain a separate overload of `googleapiclient.discovery.build` for each service and version (see `discovery.pyi`). 
+This can lead to slow type inference for this function. Mypy will generally be pretty fast after the first run,
+but you might experience slow autocomplete in your editor. If you're experiencing this problem you can bypass type inference with explicit annotations, 
+e.g. `sheets_service: SheetsResource = build("sheets", "v4")` instead of `sheets_service = build("sheets", "v4")`.
+Note the caveats to this approach in the previous section.
+
+### Recursive types
+The stubs previously didn't include recursive type definitions due to a lack of type checker support, but this is now included. Note that if you're using Mypy, v0.990 or higher is required for this to work.
+
+### Stubs for non-API-specific parts
+There are detailed stubs for the API services, but other parts of the library have only been annotated with [stubgen](https://mypy.readthedocs.io/en/stable/stubgen.html),
+so they're mostly typed as `Any`. I believe these parts are mostly used internally by the library itself,
+so for most users this should be fine. Contributions to improve these stubs are welcome, though.
+
+## Development
+You can run `create_stubs.py` to generate new stubs. Note that you should first update the google-api-python-client dependency and also clone https://github.com/googleapis/google-api-python-client.
+
+Feel free to use this to open a PR when new versions come out.

google_api_python_client_stubs-1.34.0/googleapiclient-stubs/_apis/accesscontextmanager/v1/resources.pyi

@@ -0,0 +1,470 @@
+import collections.abc
+import typing
+
+import httplib2
+import typing_extensions
+
+import googleapiclient.discovery
+import googleapiclient.http
+
+from .schemas import *
+
+_list = list
+
+@typing.type_check_only
+class AccessContextManagerResource(googleapiclient.discovery.Resource):
+    @typing.type_check_only
+    class AccessPoliciesResource(googleapiclient.discovery.Resource):
+        @typing.type_check_only
+        class AccessLevelsResource(googleapiclient.discovery.Resource):
+            def create(
+                self, *, parent: str, body: AccessLevel = ..., **kwargs: typing.Any
+            ) -> OperationHttpRequest: ...
+            def delete(
+                self, *, name: str, **kwargs: typing.Any
+            ) -> OperationHttpRequest: ...
+            def get(
+                self,
+                *,
+                name: str,
+                accessLevelFormat: typing_extensions.Literal[
+                    "LEVEL_FORMAT_UNSPECIFIED", "AS_DEFINED", "CEL"
+                ] = ...,
+                **kwargs: typing.Any,
+            ) -> AccessLevelHttpRequest: ...
+            def list(
+                self,
+                *,
+                parent: str,
+                accessLevelFormat: typing_extensions.Literal[
+                    "LEVEL_FORMAT_UNSPECIFIED", "AS_DEFINED", "CEL"
+                ] = ...,
+                pageSize: int = ...,
+                pageToken: str = ...,
+                **kwargs: typing.Any,
+            ) -> ListAccessLevelsResponseHttpRequest: ...
+            def list_next(
+                self,
+                previous_request: ListAccessLevelsResponseHttpRequest,
+                previous_response: ListAccessLevelsResponse,
+            ) -> ListAccessLevelsResponseHttpRequest | None: ...
+            def patch(
+                self,
+                *,
+                name: str,
+                body: AccessLevel = ...,
+                updateMask: str = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+            def replaceAll(
+                self,
+                *,
+                parent: str,
+                body: ReplaceAccessLevelsRequest = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+            def testIamPermissions(
+                self,
+                *,
+                resource: str,
+                body: TestIamPermissionsRequest = ...,
+                **kwargs: typing.Any,
+            ) -> TestIamPermissionsResponseHttpRequest: ...
+
+        @typing.type_check_only
+        class AuthorizedOrgsDescsResource(googleapiclient.discovery.Resource):
+            def create(
+                self,
+                *,
+                parent: str,
+                body: AuthorizedOrgsDesc = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+            def delete(
+                self, *, name: str, **kwargs: typing.Any
+            ) -> OperationHttpRequest: ...
+            def get(
+                self, *, name: str, **kwargs: typing.Any
+            ) -> AuthorizedOrgsDescHttpRequest: ...
+            def list(
+                self,
+                *,
+                parent: str,
+                pageSize: int = ...,
+                pageToken: str = ...,
+                **kwargs: typing.Any,
+            ) -> ListAuthorizedOrgsDescsResponseHttpRequest: ...
+            def list_next(
+                self,
+                previous_request: ListAuthorizedOrgsDescsResponseHttpRequest,
+                previous_response: ListAuthorizedOrgsDescsResponse,
+            ) -> ListAuthorizedOrgsDescsResponseHttpRequest | None: ...
+            def patch(
+                self,
+                *,
+                name: str,
+                body: AuthorizedOrgsDesc = ...,
+                updateMask: str = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+
+        @typing.type_check_only
+        class ServicePerimetersResource(googleapiclient.discovery.Resource):
+            def commit(
+                self,
+                *,
+                parent: str,
+                body: CommitServicePerimetersRequest = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+            def create(
+                self, *, parent: str, body: ServicePerimeter = ..., **kwargs: typing.Any
+            ) -> OperationHttpRequest: ...
+            def delete(
+                self, *, name: str, **kwargs: typing.Any
+            ) -> OperationHttpRequest: ...
+            def get(
+                self, *, name: str, **kwargs: typing.Any
+            ) -> ServicePerimeterHttpRequest: ...
+            def list(
+                self,
+                *,
+                parent: str,
+                pageSize: int = ...,
+                pageToken: str = ...,
+                **kwargs: typing.Any,
+            ) -> ListServicePerimetersResponseHttpRequest: ...
+            def list_next(
+                self,
+                previous_request: ListServicePerimetersResponseHttpRequest,
+                previous_response: ListServicePerimetersResponse,
+            ) -> ListServicePerimetersResponseHttpRequest | None: ...
+            def patch(
+                self,
+                *,
+                name: str,
+                body: ServicePerimeter = ...,
+                updateMask: str = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+            def replaceAll(
+                self,
+                *,
+                parent: str,
+                body: ReplaceServicePerimetersRequest = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+            def testIamPermissions(
+                self,
+                *,
+                resource: str,
+                body: TestIamPermissionsRequest = ...,
+                **kwargs: typing.Any,
+            ) -> TestIamPermissionsResponseHttpRequest: ...
+
+        def create(
+            self, *, body: AccessPolicy = ..., **kwargs: typing.Any
+        ) -> OperationHttpRequest: ...
+        def delete(
+            self, *, name: str, **kwargs: typing.Any
+        ) -> OperationHttpRequest: ...
+        def get(
+            self, *, name: str, **kwargs: typing.Any
+        ) -> AccessPolicyHttpRequest: ...
+        def getIamPolicy(
+            self,
+            *,
+            resource: str,
+            body: GetIamPolicyRequest = ...,
+            **kwargs: typing.Any,
+        ) -> PolicyHttpRequest: ...
+        def list(
+            self,
+            *,
+            pageSize: int = ...,
+            pageToken: str = ...,
+            parent: str = ...,
+            **kwargs: typing.Any,
+        ) -> ListAccessPoliciesResponseHttpRequest: ...
+        def list_next(
+            self,
+            previous_request: ListAccessPoliciesResponseHttpRequest,
+            previous_response: ListAccessPoliciesResponse,
+        ) -> ListAccessPoliciesResponseHttpRequest | None: ...
+        def patch(
+            self,
+            *,
+            name: str,
+            body: AccessPolicy = ...,
+            updateMask: str = ...,
+            **kwargs: typing.Any,
+        ) -> OperationHttpRequest: ...
+        def setIamPolicy(
+            self,
+            *,
+            resource: str,
+            body: SetIamPolicyRequest = ...,
+            **kwargs: typing.Any,
+        ) -> PolicyHttpRequest: ...
+        def testIamPermissions(
+            self,
+            *,
+            resource: str,
+            body: TestIamPermissionsRequest = ...,
+            **kwargs: typing.Any,
+        ) -> TestIamPermissionsResponseHttpRequest: ...
+        def accessLevels(self) -> AccessLevelsResource: ...
+        def authorizedOrgsDescs(self) -> AuthorizedOrgsDescsResource: ...
+        def servicePerimeters(self) -> ServicePerimetersResource: ...
+
+    @typing.type_check_only
+    class OperationsResource(googleapiclient.discovery.Resource):
+        def cancel(
+            self, *, name: str, body: CancelOperationRequest = ..., **kwargs: typing.Any
+        ) -> EmptyHttpRequest: ...
+        def delete(self, *, name: str, **kwargs: typing.Any) -> EmptyHttpRequest: ...
+        def get(self, *, name: str, **kwargs: typing.Any) -> OperationHttpRequest: ...
+        def list(
+            self,
+            *,
+            name: str,
+            filter: str = ...,
+            pageSize: int = ...,
+            pageToken: str = ...,
+            returnPartialSuccess: bool = ...,
+            **kwargs: typing.Any,
+        ) -> ListOperationsResponseHttpRequest: ...
+        def list_next(
+            self,
+            previous_request: ListOperationsResponseHttpRequest,
+            previous_response: ListOperationsResponse,
+        ) -> ListOperationsResponseHttpRequest | None: ...
+
+    @typing.type_check_only
+    class OrganizationsResource(googleapiclient.discovery.Resource):
+        @typing.type_check_only
+        class GcpUserAccessBindingsResource(googleapiclient.discovery.Resource):
+            def create(
+                self,
+                *,
+                parent: str,
+                body: GcpUserAccessBinding = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+            def delete(
+                self, *, name: str, **kwargs: typing.Any
+            ) -> OperationHttpRequest: ...
+            def get(
+                self, *, name: str, **kwargs: typing.Any
+            ) -> GcpUserAccessBindingHttpRequest: ...
+            def list(
+                self,
+                *,
+                parent: str,
+                pageSize: int = ...,
+                pageToken: str = ...,
+                **kwargs: typing.Any,
+            ) -> ListGcpUserAccessBindingsResponseHttpRequest: ...
+            def list_next(
+                self,
+                previous_request: ListGcpUserAccessBindingsResponseHttpRequest,
+                previous_response: ListGcpUserAccessBindingsResponse,
+            ) -> ListGcpUserAccessBindingsResponseHttpRequest | None: ...
+            def patch(
+                self,
+                *,
+                name: str,
+                body: GcpUserAccessBinding = ...,
+                append: bool = ...,
+                updateMask: str = ...,
+                **kwargs: typing.Any,
+            ) -> OperationHttpRequest: ...
+
+        def gcpUserAccessBindings(self) -> GcpUserAccessBindingsResource: ...
+
+    @typing.type_check_only
+    class PermissionsResource(googleapiclient.discovery.Resource):
+        def list(
+            self, *, pageSize: int = ..., pageToken: str = ..., **kwargs: typing.Any
+        ) -> ListSupportedPermissionsResponseHttpRequest: ...
+        def list_next(
+            self,
+            previous_request: ListSupportedPermissionsResponseHttpRequest,
+            previous_response: ListSupportedPermissionsResponse,
+        ) -> ListSupportedPermissionsResponseHttpRequest | None: ...
+
+    @typing.type_check_only
+    class ServicesResource(googleapiclient.discovery.Resource):
+        def get(
+            self, *, name: str, **kwargs: typing.Any
+        ) -> SupportedServiceHttpRequest: ...
+        def list(
+            self, *, pageSize: int = ..., pageToken: str = ..., **kwargs: typing.Any
+        ) -> ListSupportedServicesResponseHttpRequest: ...
+        def list_next(
+            self,
+            previous_request: ListSupportedServicesResponseHttpRequest,
+            previous_response: ListSupportedServicesResponse,
+        ) -> ListSupportedServicesResponseHttpRequest | None: ...
+
+    def new_batch_http_request(
+        self,
+        callback: collections.abc.Callable[
+            [
+                str,
+                googleapiclient.http.HttpRequest,
+                googleapiclient.errors.HttpError | None,
+            ],
+            typing.Any,
+        ]
+        | None = None,
+    ) -> googleapiclient.http.BatchHttpRequest: ...
+    def accessPolicies(self) -> AccessPoliciesResource: ...
+    def operations(self) -> OperationsResource: ...
+    def organizations(self) -> OrganizationsResource: ...
+    def permissions(self) -> PermissionsResource: ...
+    def services(self) -> ServicesResource: ...
+
+@typing.type_check_only
+class AccessLevelHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> AccessLevel: ...
+
+@typing.type_check_only
+class AccessPolicyHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> AccessPolicy: ...
+
+@typing.type_check_only
+class AuthorizedOrgsDescHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> AuthorizedOrgsDesc: ...
+
+@typing.type_check_only
+class EmptyHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> Empty: ...
+
+@typing.type_check_only
+class GcpUserAccessBindingHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> GcpUserAccessBinding: ...
+
+@typing.type_check_only
+class ListAccessLevelsResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ListAccessLevelsResponse: ...
+
+@typing.type_check_only
+class ListAccessPoliciesResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ListAccessPoliciesResponse: ...
+
+@typing.type_check_only
+class ListAuthorizedOrgsDescsResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ListAuthorizedOrgsDescsResponse: ...
+
+@typing.type_check_only
+class ListGcpUserAccessBindingsResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ListGcpUserAccessBindingsResponse: ...
+
+@typing.type_check_only
+class ListOperationsResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ListOperationsResponse: ...
+
+@typing.type_check_only
+class ListServicePerimetersResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ListServicePerimetersResponse: ...
+
+@typing.type_check_only
+class ListSupportedPermissionsResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ListSupportedPermissionsResponse: ...
+
+@typing.type_check_only
+class ListSupportedServicesResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ListSupportedServicesResponse: ...
+
+@typing.type_check_only
+class OperationHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> Operation: ...
+
+@typing.type_check_only
+class PolicyHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> Policy: ...
+
+@typing.type_check_only
+class ServicePerimeterHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> ServicePerimeter: ...
+
+@typing.type_check_only
+class SupportedServiceHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> SupportedService: ...
+
+@typing.type_check_only
+class TestIamPermissionsResponseHttpRequest(googleapiclient.http.HttpRequest):
+    def execute(
+        self,
+        http: httplib2.Http | googleapiclient.http.HttpMock | None = None,
+        num_retries: int = 0,
+    ) -> TestIamPermissionsResponse: ...