Merge branch 'release-1.18.13'

* release-1.18.13: Bumping version to 1.18.13 Add changelog entries from botocore Add info on installing with CRT support (#2812) Add crt extra to Boto3 (#2943)
boto · Aug 3, 2021 · 7bcd669 · 7bcd669
2 parents 27f65d1 + c25afdf
commit 7bcd669
Show file tree

Hide file tree

Showing 6 changed files with 74 additions and 3 deletions.
diff --git a/.changes/1.18.13.json b/.changes/1.18.13.json
@@ -0,0 +1,27 @@
+[
+  {
+    "category": "``redshift``",
+    "description": "[``botocore``] API support for Redshift Data Sharing feature.",
+    "type": "api-change"
+  },
+  {
+    "category": "``iotsitewise``",
+    "description": "[``botocore``] My AWS Service (placeholder) - This release introduces custom Intervals and offset for tumbling window in metric for AWS IoT SiteWise.",
+    "type": "api-change"
+  },
+  {
+    "category": "``glue``",
+    "description": "[``botocore``] Add ConcurrentModificationException to create-table, delete-table, create-database, update-database, delete-database",
+    "type": "api-change"
+  },
+  {
+    "category": "``mediaconvert``",
+    "description": "[``botocore``] AWS Elemental MediaConvert SDK has added control over the passthrough of XDS captions metadata to outputs.",
+    "type": "api-change"
+  },
+  {
+    "category": "``proton``",
+    "description": "[``botocore``] Docs only add idempotent create apis",
+    "type": "api-change"
+  }
+]
diff --git a/CHANGELOG.rst b/CHANGELOG.rst
@@ -2,6 +2,16 @@
 CHANGELOG
 =========
 
+1.18.13
+=======
+
+* api-change:``redshift``: [``botocore``] API support for Redshift Data Sharing feature.
+* api-change:``iotsitewise``: [``botocore``] My AWS Service (placeholder) - This release introduces custom Intervals and offset for tumbling window in metric for AWS IoT SiteWise.
+* api-change:``glue``: [``botocore``] Add ConcurrentModificationException to create-table, delete-table, create-database, update-database, delete-database
+* api-change:``mediaconvert``: [``botocore``] AWS Elemental MediaConvert SDK has added control over the passthrough of XDS captions metadata to outputs.
+* api-change:``proton``: [``botocore``] Docs only add idempotent create apis
+
+
 1.18.12
 =======
 

diff --git a/boto3/__init__.py b/boto3/__init__.py
@@ -18,7 +18,7 @@
 
 
 __author__ = 'Amazon Web Services'
-__version__ = '1.18.12'
+__version__ = '1.18.13'
 
 
 # The default Boto3 session; autoloaded when needed.

diff --git a/docs/source/guide/quickstart.rst b/docs/source/guide/quickstart.rst
@@ -56,6 +56,37 @@ certain versions, you may provide constraints when installing::
 
    The latest development version of Boto3 is on `GitHub <https://github.com/boto/boto3>`_.
 
+Using the AWS Common Runtime (CRT)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+In addition to the default install of Boto3, you can choose to include the new `AWS Common Runtime <https://docs.aws.amazon.com/sdkref/latest/guide/common-runtime.html>`_
+(CRT). The AWS CRT is a collection of modular packages that serve as a new foundation for AWS SDKs.
+Each library provides better performance and minimal footprint for the functional area it
+implements. Using the CRT, SDKs can share the same base code when possible, improving consistency
+and throughput optimizations across AWS SDKs.
+
+When the AWS CRT is included, Boto3 uses it to incorporate features not otherwise
+available in the AWS SDK for Python.
+
+At this time, Boto3 uses the AWS CRT's authentication package (`aws-c-auth
+<https://github.com/awslabs/aws-c-auth>`_) to add support for the `AWS Signature Version 4
+<https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html>`_ (sigv4) signer, which
+adds authentication to your AWS requests using your security credentials (your AWS access key and
+secret access key).
+
+Boto3 doesn't use the AWS CRT by default but you can opt into using it by specifying the
+:code:`crt` `extra feature <https://www.python.org/dev/peps/pep-0508/#extras>`_ when installing Boto3::
+
+    pip install boto3[crt]
+
+To revert to the non-CRT version of Boto3, use this command::
+
+    pip uninstall awscrt
+
+If you need to re-enable CRT,  reinstall :code:`boto3[crt]` to ensure you get a compatible version of :code:`awscrt`::
+
+    pip install boto3[crt]
+
 Configuration
 -------------
 

diff --git a/setup.cfg b/setup.cfg
@@ -3,6 +3,9 @@ universal = 0
 
 [metadata]
 requires_dist =
-    botocore>=1.21.12,<1.22.0
+    botocore>=1.21.13,<1.22.0
     jmespath>=0.7.1,<1.0.0
     s3transfer>=0.5.0,<0.6.0
+
+[options.extras_require]
+crt = botocore[crt]>=1.21.0,<2.0a0
diff --git a/setup.py b/setup.py
@@ -14,7 +14,7 @@
 
 
 requires = [
-    'botocore>=1.21.12,<1.22.0',
+    'botocore>=1.21.13,<1.22.0',
     'jmespath>=0.7.1,<1.0.0',
     's3transfer>=0.5.0,<0.6.0'
 ]