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