awscli 1.36.40__py3-none-any.whl → 1.37.1__py3-none-any.whl

awscli/__init__.py

@@ -18,7 +18,7 @@ A Universal Command Line Environment for Amazon Web Services.
 
 import os
 
-__version__ = '1.36.40'
+__version__ = '1.37.1'
 
 #
 # Get our data path to be added to botocore's search path

awscli/customizations/s3/subcommands.py

@@ -458,7 +458,7 @@ CHECKSUM_MODE = {
 }
 
 CHECKSUM_ALGORITHM = {
-        'name': 'checksum-algorithm', 'choices': ['CRC32', 'SHA256', 'SHA1', 'CRC32C'],
+        'name': 'checksum-algorithm', 'choices': ['CRC64NVME', 'CRC32', 'SHA256', 'SHA1', 'CRC32C'],
         'help_text': 'Indicates the algorithm used to create the checksum for the object.'
 }
 

awscli/topics/s3-faq.rst

@@ -13,32 +13,55 @@ Below are common questions regarding the use of Amazon S3 in the AWS CLI.
 Q: Does the AWS CLI validate checksums?
 ---------------------------------------
 
-The AWS CLI will perform checksum validation for uploading files in 
-specific scenarios.
+The AWS CLI will attempt to perform checksum validation for uploading and
+downloading files, as described below.
 
 Upload
 ~~~~~~
 
-The AWS CLI will calculate and auto-populate the ``Content-MD5`` header for
-both standard and multipart uploads.  If the checksum that S3 calculates does
-not match the ``Content-MD5`` provided, S3 will not store the object and
-instead will return an error message back the AWS CLI.  The AWS CLI will retry
-this error up to 5 times before giving up.  On the case that any files fail to
-transfer successfully to S3, the AWS CLI will exit with a non zero RC.
-See ``aws help return-codes`` for more information.
-
-If the upload request is signed with Signature Version 4, then the AWS CLI uses the
-``x-amz-content-sha256`` header as a checksum instead of ``Content-MD5``.
-The AWS CLI will use Signature Version 4 for S3 in several cases:
-
-* You're using an AWS region that only supports Signature Version 4.  This
-  includes ``eu-central-1`` and ``ap-northeast-2``.
-* You explicitly opt in and set ``signature_version = s3v4`` in your
-  ``~/.aws/config`` file.
-
-Note that the AWS CLI will add a ``Content-MD5`` header for both
-the high level ``aws s3`` commands that perform uploads
-(``aws s3 cp``, ``aws s3 sync``) as well as the low level ``s3api``
-commands including ``aws s3api put-object`` and ``aws s3api upload-part``.
-
-If you want to verify the integrity of an object during upload, see `How can I check the integrity of an object uploaded to Amazon S3? <https://aws.amazon.com/premiumsupport/knowledge-center/data-integrity-s3/>`_ in the *AWS Knowledge Center*.
+The AWS CLI v1 will calculate and auto-populate a ``x-amz-checksum-<algorithm>`` HTTP header by
+default for each upload, where ``<algorithm>`` is the algorithm used to calculate the checksum.
+By default, the Cyclic Redundancy Check 32 (CRC32) algorithm
+is used to calculate checksums, but an alternative algorithm can be specified by using the
+``--checksum-algorithm`` argument on high-level ``aws s3`` commands. The checksum algorithms
+supported by the AWS CLI v1 are:
+
+- CRC64NVME (Recommended)
+- CRC32
+- CRC32C
+- SHA1
+- SHA256
+
+Amazon S3 will use the algorithm specified in the header to calculate the checksum of the object. If it
+does not match the checksum provided, the object will not be stored and an error message
+will be returned. Otherwise, the checksum is stored in object metadata that you can use
+later to verify data integrity of download operations (see Download section).
+
+.. note::
+    Note that the AWS CLI will perform the above checksum calculations for commands that perform uploads. This
+    includes high-level commands like ``aws s3 cp``, ``aws s3 sync``, and ``aws s3 mv``, and low-level commands
+    like ``aws s3api put-object`` and ``aws s3api upload-part``."
+
+    For high-level command invocations that result in uploading multiple files (e.g. ``aws s3 sync``),
+    the same checksum algorithm will be used for all file uploads included in the command execution.
+
+For more information about verifying data integrity in Amazon S3, see
+`Checking object integrity in Amazon S3?
+<https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html/>`_ in the Amazon S3 User Guide.
+
+Download
+~~~~~~
+
+The AWS CLI will attempt to verify the checksum of downloads when possible. If a non-MD5 checksum is returned
+with a downloaded object, the CLI will use the same algorithm to recalculate the checksum and verify
+it matches the one stored in Amazon S3. If checksum validation fails, an error is raised and the request will NOT be
+retried.
+
+.. note::
+    Note that the AWS CLI will perform the above checksum calculations for commands that perform uploads. This
+    includes high-level commands like ``aws s3 cp``, ``aws s3 sync``, and ``aws s3 mv``, and low-level commands
+    like ``aws s3api get-object``"
+
+For more information about verifying data integrity in Amazon S3, see
+`Checking object integrity in Amazon S3?
+<https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html/>`_ in the Amazon S3 User Guide.

{awscli-1.36.40.dist-info → awscli-1.37.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: awscli
-Version: 1.36.40
+Version: 1.37.1
 Summary: Universal Command Line Environment for AWS.
 Home-page: http://aws.amazon.com/cli/
 Author: Amazon Web Services
@@ -23,9 +23,9 @@ Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Requires-Python: >= 3.8
 License-File: LICENSE.txt
-Requires-Dist: botocore (==1.35.99)
+Requires-Dist: botocore (==1.36.1)
 Requires-Dist: docutils (<0.17,>=0.10)
-Requires-Dist: s3transfer (<0.11.0,>=0.10.0)
+Requires-Dist: s3transfer (<0.12.0,>=0.11.0)
 Requires-Dist: PyYAML (<6.1,>=3.10)
 Requires-Dist: colorama (<0.4.7,>=0.2.5)
 Requires-Dist: rsa (<4.8,>=3.1.2)

{awscli-1.36.40.dist-info → awscli-1.37.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-awscli/__init__.py,sha256=uq9n0OOmRNJZiNyvGAHTnIm3bXjwnXOm_jv0q3vSb0Q,1534
+awscli/__init__.py,sha256=p4i1ejXxLHQhbQ0CLaTFgLL7c0BtoAFYfAcxOdf0gJc,1533
 awscli/__main__.py,sha256=iBjOg0tBxNlhzTi_tyc1G0SMGBvHMVvBJzX3JqYaooY,662
 awscli/alias.py,sha256=Us9pvP8Zplbr1W4N3rE5gxicWLqlRG3l_9VPskxafgs,11313
 awscli/argparser.py,sha256=3Pxx-vWytdV985Y6MIl9DeutUXyehIvACIs_PDby8GI,7650
@@ -198,7 +198,7 @@ awscli/customizations/s3/filters.py,sha256=OuQUr6XAMkS1i6GO65_L7NbL7kwgmKT2ghWhv
 awscli/customizations/s3/results.py,sha256=L19gi3CtJYeHqWIWuIVcbj82Dshw2g5jNX8PFidcC2U,26625
 awscli/customizations/s3/s3.py,sha256=Igwsn89G7i9M4nShjzcFmwlCVXvpfgmoyEf9wpNLXdk,2739
 awscli/customizations/s3/s3handler.py,sha256=FSeCyMRi2EwNDNR329geVV8vZpap1OiSscNS-3sCCP0,23299
-awscli/customizations/s3/subcommands.py,sha256=Mv8XKvnrAQXqASFoHO92ZIn-qSmV7gHF2DVxSBx8NIM,63294
+awscli/customizations/s3/subcommands.py,sha256=Zk361nn61l1kPIfqzomLquFPbsPIjgnERDYsE280QUs,63307
 awscli/customizations/s3/transferconfig.py,sha256=7MW4hi90N5mLeQBlmVxs9J5ixRjejp1F4uPmGGF3TME,4472
 awscli/customizations/s3/utils.py,sha256=Wcnx32I2P5E7A2Qh0ONG6IXWvnmz3NxNBtGUrGI61VQ,34213
 awscli/customizations/s3/syncstrategy/__init__.py,sha256=BFJ0dbdWkUBgJ2qav1Jhz06SddTMIeahxSaW_H0vop0,565
@@ -5994,15 +5994,15 @@ awscli/examples/xray/update-sampling-rule.rst,sha256=a1THv2Q8ELvSSlZbnbUVN5YWopG
 awscli/topics/config-vars.rst,sha256=rVxgQDJipsSqwDE2GOC2FUBp8jZbqufJPanTxTx7ST0,22751
 awscli/topics/return-codes.rst,sha256=d9lpNFZwD75IiYcDEADQzu-4QiR8P28UPHkrNwPV5J8,1996
 awscli/topics/s3-config.rst,sha256=kyLbdEEePnHW0hoMmQDkt4o6PbqAdpO5ph_51GgQyXg,11664
-awscli/topics/s3-faq.rst,sha256=sS5jKHF_7X5eiGwpUg7aTqQt2zCRN-m_xXOcE0Bme0Q,1899
+awscli/topics/s3-faq.rst,sha256=Kw1w4NFHOTXq9Mz5S3HHw3mBkyeEzH4ruB0PD6-EO1c,2938
 awscli/topics/topic-tags.json,sha256=6lUSrs3FKCZNRSQMnjcXNgWyRNGjZIeur1988a4IO5o,1577
-awscli-1.36.40.data/scripts/aws,sha256=r24FExgs0-JjILTQ3XZAqXBYE4SV6UMTtALkLGAj86g,805
-awscli-1.36.40.data/scripts/aws.cmd,sha256=s46DkC6LNgX63CIkzxxbPnFMJ6DRDBkvc88GnWa8Pvg,1432
-awscli-1.36.40.data/scripts/aws_bash_completer,sha256=RRpoEGJRagRzyHZKZZOwpltuVYv2EoiZsdXhmyWPZ54,204
-awscli-1.36.40.data/scripts/aws_completer,sha256=oC9kuMDlWE47dWk_4xjPde2PQvN-M0vND0J4YSLabVQ,1126
-awscli-1.36.40.data/scripts/aws_zsh_completer.sh,sha256=Qm6Z8ejNAMzpJjaT0pzqxbSDT2zxdmzVe5haRA7qLoc,1808
-awscli-1.36.40.dist-info/LICENSE.txt,sha256=o5XhFlwu0OK_BBrijlKCRa7dQAm36UrUB3gCV_cEr8E,549
-awscli-1.36.40.dist-info/METADATA,sha256=CvvVYsv_x0-q8M74jr887UXlf-yYakAQBSmHygQ4Vj8,11331
-awscli-1.36.40.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
-awscli-1.36.40.dist-info/top_level.txt,sha256=vt9wXFr1_nGYK6abhJgt6zY3fULe4JSZedm_5XOM9S0,7
-awscli-1.36.40.dist-info/RECORD,,
+awscli-1.37.1.data/scripts/aws,sha256=r24FExgs0-JjILTQ3XZAqXBYE4SV6UMTtALkLGAj86g,805
+awscli-1.37.1.data/scripts/aws.cmd,sha256=s46DkC6LNgX63CIkzxxbPnFMJ6DRDBkvc88GnWa8Pvg,1432
+awscli-1.37.1.data/scripts/aws_bash_completer,sha256=RRpoEGJRagRzyHZKZZOwpltuVYv2EoiZsdXhmyWPZ54,204
+awscli-1.37.1.data/scripts/aws_completer,sha256=oC9kuMDlWE47dWk_4xjPde2PQvN-M0vND0J4YSLabVQ,1126
+awscli-1.37.1.data/scripts/aws_zsh_completer.sh,sha256=Qm6Z8ejNAMzpJjaT0pzqxbSDT2zxdmzVe5haRA7qLoc,1808
+awscli-1.37.1.dist-info/LICENSE.txt,sha256=o5XhFlwu0OK_BBrijlKCRa7dQAm36UrUB3gCV_cEr8E,549
+awscli-1.37.1.dist-info/METADATA,sha256=tZ9RpxFsh8Bw9NPLhQtz9Oj53OUeGUACs7MFEz0sz6A,11329
+awscli-1.37.1.dist-info/WHEEL,sha256=GV9aMThwP_4oNCtvEC2ec3qUYutgWeAzklro_0m4WJQ,91
+awscli-1.37.1.dist-info/top_level.txt,sha256=vt9wXFr1_nGYK6abhJgt6zY3fULe4JSZedm_5XOM9S0,7
+awscli-1.37.1.dist-info/RECORD,,