2015-11-27 23:25:33 +01:00
|
|
|
.. _guide_new:
|
|
|
|
|
2021-09-22 18:34:33 +02:00
|
|
|
What's new
|
2015-11-27 23:25:33 +01:00
|
|
|
==========
|
2021-09-22 18:34:33 +02:00
|
|
|
Boto3 is a ground-up rewrite of Boto. It uses a data-driven approach to
|
2015-11-27 23:25:33 +01:00
|
|
|
generate classes at runtime from JSON description files that are shared
|
|
|
|
between SDKs in various languages. This includes descriptions for a
|
2016-11-09 01:23:44 +01:00
|
|
|
high level, object oriented interface similar to those available in
|
2015-11-27 23:25:33 +01:00
|
|
|
previous versions of Boto.
|
|
|
|
|
2021-09-22 18:34:33 +02:00
|
|
|
Because Boto3 is generated from these shared JSON files, we get
|
2015-11-27 23:25:33 +01:00
|
|
|
fast updates to the latest services and features and a consistent
|
|
|
|
API across services. Community contributions to JSON description
|
2021-09-22 18:34:33 +02:00
|
|
|
files in other SDKs also benefit Boto3, just as contributions to
|
|
|
|
Boto3 benefit the other SDKs.
|
2015-11-27 23:25:33 +01:00
|
|
|
|
2021-09-22 18:34:33 +02:00
|
|
|
Major features
|
2015-11-27 23:25:33 +01:00
|
|
|
--------------
|
2021-09-22 18:34:33 +02:00
|
|
|
Boto3 consists of the following major features:
|
2015-11-27 23:25:33 +01:00
|
|
|
|
|
|
|
* **Resources**: a high level, object oriented interface
|
|
|
|
* **Collections**: a tool to iterate and manipulate groups of resources
|
|
|
|
* **Clients**: low level service connections
|
|
|
|
* **Paginators**: automatic paging of responses
|
|
|
|
* **Waiters**: a way to block until a certain state has been reached
|
|
|
|
|
2021-09-22 18:34:33 +02:00
|
|
|
Along with these major features, Boto3 also provides *sessions* and
|
2015-11-27 23:25:33 +01:00
|
|
|
per-session *credentials* & *configuration*, as well as basic
|
|
|
|
components like *authentication*, *parameter* & *response* handling,
|
|
|
|
an *event system* for customizations and logic to *retry* failed
|
|
|
|
requests.
|
|
|
|
|
|
|
|
Botocore
|
|
|
|
~~~~~~~~
|
2021-09-22 18:34:33 +02:00
|
|
|
Boto3 is built atop of a library called
|
2015-11-27 23:25:33 +01:00
|
|
|
`Botocore <https://pypi.python.org/pypi/botocore>`_, which is shared by the
|
|
|
|
`AWS CLI <http://aws.amazon.com/cli/>`_. Botocore provides the low level
|
2021-09-22 18:34:33 +02:00
|
|
|
clients, session, and credential & configuration data. Boto3 builds on top
|
2015-11-27 23:25:33 +01:00
|
|
|
of Botocore by providing its own session, resources and collections.
|