Debian Codegraph @

docs/source/guide/new.rst

raw
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.