Metadata-Version: 2.1
Name: botocore-stubs
Version: 1.21.32
Summary: Type annotations for botocore 1.21.32, generated by mypy-boto3-builder 5.2.0
Home-page: https://github.com/vemel/mypy_boto3_builder
Author: Vlad Emelianov
Author-email: vlad.emelianov.nz@gmail.com
License: MIT License
Project-URL: Documentation, https://mypy-boto3-builder.readthedocs.io/en/latest/
Project-URL: Source, https://github.com/vemel/mypy_boto3_builder
Project-URL: Tracker, https://github.com/vemel/mypy_boto3_builder/issues
Description: <a id="botocore-stubs"></a>
        
        # botocore-stubs
        
        [![PyPI - botocore-stubs](https://img.shields.io/pypi/v/botocore-stubs.svg?color=blue)](https://pypi.org/project/botocore-stubs)
        [![PyPI - Python Version](https://img.shields.io/pypi/pyversions/botocore-stubs.svg?color=blue)](https://pypi.org/project/botocore-stubs)
        [![Docs](https://img.shields.io/readthedocs/mypy-boto3-builder.svg?color=blue)](https://mypy-boto3-builder.readthedocs.io/)
        [![PyPI - Downloads](https://img.shields.io/pypi/dw/botocore-stubs?color=blue)](https://pypistats.org/packages/botocore-stubs)
        
        ![boto3.typed](https://github.com/vemel/mypy_boto3_builder/raw/master/logo.png)
        
        Type annotations for [botocore 1.21.32](https://github.com/boto/botocore)
        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.2.0](https://github.com/vemel/mypy_boto3_builder).
        
        See how it helps to find and fix potential bugs:
        
        ![boto3-stubs demo](https://github.com/vemel/mypy_boto3_builder/raw/master/demo.gif)
        
        - [botocore-stubs](#botocore-stubs)
          - [How to install](#how-to-install)
            - [Basic](#basic)
          - [How to uninstall](#how-to-uninstall)
          - [Usage](#usage)
            - [VSCode](#vscode)
            - [PyCharm](#pycharm)
            - [Emacs](#emacs)
            - [Sublime Text](#sublime-text)
            - [Other IDEs](#other-ides)
            - [mypy](#mypy)
            - [pyright](#pyright)
          - [How it works](#how-it-works)
          - [What's new](#what%27s-new)
            - [Implemented features](#implemented-features)
            - [Latest changes](#latest-changes)
          - [Versioning](#versioning)
          - [Thank you](#thank-you)
          - [Documentation](#documentation)
          - [Support and contributing](#support-and-contributing)
        
        <a id="how-to-install"></a>
        
        ## How to install
        
        <a id="basic"></a>
        
        ### Basic
        
        Install `botocore-stubs` to add type annotations for `botocore` package.
        Install `boto3-stubs` to add type annotations for `boto3` package.
        
        ```bash
        # install type annotations only for botocore
        python -m pip install botocore-stubs
        
        # install type annotations only for boto3 and botocore
        python -m pip install botocore-stubs boto3-stubs
        
        # install `boto3` type annotations
        # for ec2, s3, rds, lambda, sqs, dynamo and cloudformation
        # Consumes ~7 MB of space
        python -m pip install 'boto3-stubs[essential]'
        
        # or install annotations for services you use
        python -m pip install 'boto3-stubs[acm,apigateway]'
        ```
        
        <a id="how-to-uninstall"></a>
        
        ## How to uninstall
        
        ```bash
        # uninstall boto3-stubs
        python -m pip uninstall -y boto3-stubs botocore-stubs
        
        # uninstall submodules
        python -m pip freeze | grep mypy-boto3 | xargs python -m pip uninstall -y
        ```
        
        <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` with services you use in your environment:
          `python -m pip install 'boto3-stubs[s3,ec2]'`
        
        Both type checking and auto-complete should work for installed `boto3`
        services. No explicit type annotations required, write your `boto3` code as
        usual.
        
        <a id="pycharm"></a>
        
        ### PyCharm
        
        - Install `boto-stubs` with services you use in your environment:
          `python -m pip install 'boto3-stubs[s3,ec2]'`
        - Install `mypy_boto3_builder`: `pip install mypy_boto3_builder`
        - Generate stubs in `<project_root>/typings` directory for services you use
        
        ```bash
        python -m mypy_boto3_builder --installed --skip-services typings -d -s s3 ec2
        ```
        
        - Add `<project_root>/typings` folder to your
          [Interpreter Paths](https://www.jetbrains.com/help/pycharm/stubs.html#reuse-stubs)
        
        Since stubs are stored in your project root, you do not need to re-generate
        them after update.
        
        <a id="emacs"></a>
        
        ### Emacs
        
        - Install `boto-stubs` with services you use in your environment:
          `python -m pip install 'boto3-stubs[s3,ec2]'`
        - Install [use-package](https://github.com/jwiegley/use-package),
          [lsp](https://github.com/emacs-lsp/lsp-mode/),
          [company](https://github.com/company-mode/company-mode) and
          [flycheck](https://github.com/flycheck/flycheck) packages
        - Install [lsp-pyright](https://github.com/emacs-lsp/lsp-pyright) package
        
        ```elisp
        (use-package lsp-pyright
          :ensure t
          :hook (python-mode . (lambda ()
                                  (require 'lsp-pyright)
                                  (lsp)))  ; or lsp-deferred
          :init (when (executable-find "python3")
                  (setq lsp-pyright-python-executable-cmd "python3"))
          )
        ```
        
        - Make sure emacs uses the environment where you have installed `boto3-stubs`
        
        <a id="sublime-text"></a>
        
        ### Sublime Text
        
        - Install `boto-stubs` with services you use in your environment:
          `python -m pip install 'boto3-stubs[s3,ec2]'`
        - Install [LSP-pyright](https://github.com/sublimelsp/LSP-pyright) package
        - Make sure emacs uses the environment where you have installed `boto3-stubs`
        
        <a id="other-ides"></a>
        
        ### Other IDEs
        
        Not tested, but as long as your IDE supports `mypy` or `pyright`, everything
        should work.
        
        <a id="mypy"></a>
        
        ### mypy
        
        - Install `mypy`: `python -m pip install mypy`
        - Install `boto-stubs` with services you use in your environment:
          `python -m pip install 'boto3-stubs[s3,ec2]'`
        - Run `mypy` as usual
        
        Type checking should work for installed `boto3` services. 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` with services you use in your environment:
          `python -m pip install 'boto3-stubs[s3,ec2]'`
        - Optionally, you can install `boto3-stubs` to `typings` folder.
        
        Type checking should work for installed `boto3` services. No explicit type
        annotations required, write your `boto3` code as usual.
        
        <a id="how-it-works"></a>
        
        ## How it works
        
        Fully automated
        [mypy-boto3-builder](https://github.com/vemel/mypy_boto3_builder) carefully
        generates type annotations for each service, patiently waiting for `boto3`
        updates. It delivers a drop-in type annotations for you and makes sure that:
        
        - All available `boto3` services are covered.
        - Each public class and method of every `boto3` service gets valid type
          annotations extracted from the documentation (blame `botocore` docs if types
          are incorrect).
        - Type annotations include up-to-date documentation.
        - Link to documentation is provided for every method.
        - Code is processed by [black](https://github.com/psf/black) and
          [isort](https://github.com/PyCQA/isort) for readability.
        
        <a id="what's-new"></a>
        
        ## What's new
        
        <a id="implemented-features"></a>
        
        ### Implemented features
        
        - Fully type annotated `boto3` library
        - `mypy`, `pyright`, `VSCode`, `PyCharm`, `Sublime Text` and `Emacs`
          compatibility
        - `Client` type annotations for each service
        - `ServiceResource` type annotations for each service
        - `Resource` type annotations for each service
        - `Waiter` type annotations for each service
        - `Paginator` type annotations for each service
        - Generated `TypeDefs` for each service
        - Generated `Literals` for each service
        - Auto discovery of types for `boto3.client` and `boto3.session` calls
        - Auto discovery of types for `session.client` and `session.session` calls
        - Auto discovery of types for `client.get_waiter` and `client.get_paginator`
          calls
        - Auto discovery of types for `ServiceResource` and `Resource` collections
        
        <a id="latest-changes"></a>
        
        ### Latest changes
        
        Builder changelog can be found in
        [Releases](https://github.com/vemel/mypy_boto3_builder/releases).
        
        <a id="versioning"></a>
        
        ## Versioning
        
        `botocore-stubs` version is the same as related `botocore` version and follows
        [PEP 440](https://www.python.org/dev/peps/pep-0440/) format.
        
        <a id="thank-you"></a>
        
        ## Thank you
        
        - [Allie Fitter](https://github.com/alliefitter) for
          [boto3-type-annotations](https://pypi.org/project/boto3-type-annotations/),
          this package is based on top of his work
        - [black](https://github.com/psf/black) developers for an awesome formatting
          tool
        - [Timothy Edmund Crosley](https://github.com/timothycrosley) for
          [isort](https://github.com/PyCQA/isort) and how flexible it is
        - [mypy](https://github.com/python/mypy) developers for doing all dirty work
          for us
        - [pyright](https://github.com/microsoft/pyright) team for the new era of typed
          Python
        
        <a id="documentation"></a>
        
        ## Documentation
        
        All services type annotations can be found in
        [boto3-stubs docs](https://vemel.github.io/boto3_stubs_docs/)
        
        <a id="support-and-contributing"></a>
        
        ## Support and contributing
        
        This package is auto-generated. Please reports any bugs or request new features
        in [mypy-boto3-builder](https://github.com/vemel/mypy_boto3_builder/issues/)
        repository.
        
Keywords: boto3 type-annotations botocore-stubs mypy typeshed autocomplete
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Typing :: Typed
Requires-Python: >=3.6
Description-Content-Type: text/markdown
