Metadata-Version: 2.1
Name: botocore-a-la-carte
Version: 1.34.20
Summary: botocore re-uploaded with a-la-carte data packages.
Home-page: https://github.com/thejcannon/botocore-a-la-carte
Author: Amazon Web Services
License: Apache License 2.0
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: System Administrators
Classifier: Natural Language :: English
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >= 3.8
License-File: LICENSE.txt
License-File: NOTICE
Requires-Dist: jmespath (<2.0.0,>=0.7.1)
Requires-Dist: python-dateutil (<3.0.0,>=2.1)
Requires-Dist: urllib3 (<1.27,>=1.25.4) ; python_version < "3.10"
Requires-Dist: urllib3 (<2.1,>=1.25.4) ; python_version >= "3.10"
Provides-Extra: crt
Requires-Dist: awscrt (==0.19.19) ; extra == 'crt'

``botocore-a-la-carte``
-----------------------

``botocore-a-la-carte`` is a re-packaging of ``botocore`` such that each service's data JSON exists in a
separate package, and are opted-into through package extras.

The package ``botocore-a-la-carte`` contains the base code/resources for ``botocore`` to operate, and has
a package extra per service (referencing a package which contains just the JSON data for that service).

Installation and Usage
----------------------

⚠️ The package extras must be installed in the same directory as this package (such as in a virtual environment).
This package does not support being installed in separate locations pointed to by ``sys.path``.
This is a limitation of the core ``botocore`` package and the Python packaging ecosystem. ⚠️

Example:

``botocore-a-la-carte`` with no extras allows you to use core ``botocore`` functionality
(e.g. load credentials, sign requests, etc...).

.. code-block:: console

    $ pip install botocore-a-la-carte
    ...
    $ python
    >>> import botocore
    ...

If you require specific service support, specify the service names as an extras:

.. code-block:: console

    $ pip install botocore-a-la-carte[s3, ec2]
    ...
    $ python
    >>> import botocore.session
    >>> session = botocore.session.get_session()
    >>> client = session.create_client('ec2')
    >>> print(client.describe_instances())



