PyPI 官网下载 | mypy-boto3-cloudtrail-1.18.25.tar.gz

<a id="mypy-boto3-cloudtrail"></a> # mypy-boto3-cloudtrail [](https://pypi.org/project/mypy-boto3-cloudtrail) [](https://pypi.org/project/mypy-boto3-cloudtrail) [](https://mypy-boto3-builder.readthedocs.io/) [](https://pypistats.org/packages/mypy-boto3-cloudtrail)  Type annotations for [boto3.CloudTrail 1.18.25](https://boto3.amazonaws.com/v1/documentation/api/1.18.25/reference/services/cloudtrail.html#CloudTrail) service compatible with [VSCode](https://code.visualstudio.com/), [PyCharm](https://www.jetbrains.com/pycharm/), [Emacs](https://www.gnu.org/software/emacs/), [Sublime Text](https://www.sublimetext.com/), [mypy](https://github.com/python/mypy), [pyright](https://github.com/microsoft/pyright) and other tools. Generated by [mypy-boto3-builder 5.1.0](https://github.com/vemel/mypy_boto3_builder). More information can be found on [boto3-stubs](https://pypi.org/project/boto3-stubs/) page and in [mypy-boto3-cloudtrail docs](https://vemel.github.io/boto3_stubs_docs/mypy_boto3_cloudtrail/) See how it helps to find and fix potential bugs:  - [mypy-boto3-cloudtrail](#mypy-boto3-cloudtrail) - [How to install](#how-to-install) - [Usage](#usage) - [VSCode](#vscode) - [PyCharm](#pycharm) - [Other IDEs](#other-ides) - [mypy](#mypy) - [pyright](#pyright) - [Explicit type annotations](#explicit-type-annotations) - [Client annotations](#client-annotations) - [Paginators annotations](#paginators-annotations) - [Literals](#literals) - [Typed dictionaries](#typed-dictionaries) - [Versioning](#versioning) - [Documentation](#documentation) - [Support and contributing](#support-and-contributing) <a id="how-to-install"></a> ## How to install Install `boto3-stubs` for `CloudTrail` service. ```bash python -m pip install boto3-stubs[cloudtrail] ``` <a id="usage"></a> ## Usage <a id="vscode"></a> ### VSCode - Install [Python extension](https://marketplace.visualstudio.com/items?itemName=ms-python.python) - Install [Pylance extension](https://marketplace.visualstudio.com/items?itemName=ms-python.vscode-pylance) - Set `Pylance` as your Python Language Server - Install `boto-stubs[cloudtrail]` in your environment: `python -m pip install 'boto3-stubs[cloudtrail]'` Both type checking and auto-complete should work for `CloudTrail` service. No explicit type annotations required, write your `boto3` code as usual. <a id="pycharm"></a> ### PyCharm - Install `boto-stubs[cloudtrail]` in your environment: `python -m pip install 'boto3-stubs[cloudtrail]'` Both type checking and auto-complete should work for `CloudTrail` service. No explicit type annotations required, write your `boto3` code as usual. Auto-complete can be slow on big projects or if you have a lot of installed `boto3-stubs` submodules. <a id="other-ides"></a> ### Other IDEs Not tested, but as long as your IDE support `mypy` or `pyright`, everything should work. <a id="mypy"></a> ### mypy - Install `mypy`: `python -m pip install mypy` - Install `boto-stubs[cloudtrail]` in your environment: `python -m pip install 'boto3-stubs[cloudtrail]'` - Run `mypy` as usual Type checking should work for `CloudTrail` service. No explicit type annotations required, write your `boto3` code as usual. <a id="pyright"></a> ### pyright - Install `pyright`: `yarn global add pyright` - Install `boto-stubs[cloudtrail]` in your environment: `python -m pip install 'boto3-stubs[cloudtrail]'` - Optionally, you can install `boto3-stubs` to `typings` folder. Type checking should work for `CloudTrail` service. No explicit type annotations required, write your `boto3` code as usual. <a id="explicit-type-annotations"></a> ## Explicit type annotations <a id="client-annotations"></a> ### Client annotations `CloudTrailClient` provides annotations for `boto3.client("cloudtrail")`. ```python import boto3 from mypy_boto3_cloudtrail import CloudTrailClient client: CloudTrailClient = boto3.client("cloudtrail") # now client usage is checked by mypy and IDE should provide code auto-complete # works for session as well session = boto3.session.Session(region="us-west-1") session_client: CloudTrailClient = session.client("cloudtrail") ``` <a id="paginators-annotations"></a> ### Paginators annotations `mypy_boto3_cloudtrail.paginator` module contains type annotations for all paginators. ```python from mypy_boto3_cloudtrail import CloudTrailClient from mypy_boto3_cloudtrail.paginator import ( ListPublicKeysPaginator, ListTagsPaginator, ListTrailsPaginator, LookupEventsPaginator, ) client: CloudTrailClient = boto3.client("cloudtrail") # Explicit type annotations are optional here # Type should be correctly discovered by mypy and IDEs # VSCode requires explicit type annotations list_public_keys_paginator: ListPublicKeysPaginator = client.get_paginator("list_public_keys") list_tags_paginator: ListTagsPaginator = client.get_paginator("list_tags") list_trails_paginator: ListTrailsPaginator = client.get_paginator("list_trails") lookup_events_paginator: LookupEventsPaginator = client.get_paginator("lookup_events") ``` <a id="literals"></a> ### Literals `mypy_boto3_cloudtrail.literals` module contains literals extracted from shapes that can be used in user code for type checking. ```python from mypy_boto3_cloudtrail.literals import ( EventCategoryType, InsightTypeType, ListPublicKeysPaginatorName, ListTagsPaginatorName, ListTrailsPaginatorName, LookupAttributeKeyType, LookupEventsPaginatorName, ReadWriteTypeType, ) def check_value(value: EventCategoryType) -> bool: ... ``` <a id="typed-dictionaries"></a> ### Typed dictionaries `mypy_boto3_cloudtrail.type_defs` module contains structures and shapes assembled to typed dictionaries for additional type checking. ```python from mypy_boto3_cloudtrail.type_defs import ( AddTagsRequestRequestTypeDef, AdvancedEventSelectorTypeDef, AdvancedFieldSelectorTypeDef, CreateTrailRequestRequestTypeDef, CreateTrailResponseTypeDef, DataResourceTypeDef, DeleteTrailRequestRequestTypeDef, DescribeTrailsRequestRequestTypeDef, DescribeTrailsResponseTypeDef, EventSelectorTypeDef, EventTypeDef, GetEventSelectorsRequestRequestTypeDef, GetEventSelectorsResponseTypeDef, GetInsightSelectorsRequestRequestTypeDef, GetInsightSelectorsResponseTypeDef, GetTrailRequestRequestTypeDef, GetTrailResponseTypeDef, GetTrailStatusRequestRequestTypeDef, GetTrailStatusResponseTypeDef, InsightSelectorTypeDef, ListPublicKeysRequestRequestTypeDef, ListPublicKeysResponseTypeDef, ListTagsRequestRequestTypeDef, ListTagsResponseTypeDef, ListTrailsRequestRequestTypeDef, ListTrailsResponseTypeDef, LookupAttributeTypeDef, LookupEventsRequestRequestTypeDef, LookupEventsResponseTypeDef, PaginatorConfigTypeDef, PublicKeyTypeDef, PutEventSelectorsRequestRequestTypeDef, PutEventSelectorsResponseTypeDef, PutInsightSelectorsRequestRequestTypeDef, PutInsightSelectorsResponseTypeDef, RemoveTagsRequestRequestTypeDef, ResourceTagTypeDef, ResourceTypeDef, ResponseMetadataTypeDef, StartLoggingRequestRequestTypeDef, StopLoggingRequestRequestTypeDef, TagTypeDef, TrailInfoTypeDef, TrailTypeDef, UpdateTrailRequestRequestTypeDef, UpdateTrailResponseTypeDef, ) def get_structure() -> AddTagsRequestRequestTypeDef: return { ...