awscli 1.42.33__py3-none-any.whl → 1.44.6__py3-none-any.whl

awscli/examples/servicediscovery/update-public-dns-namespace.rst

@@ -1,18 +1,35 @@
-**To update a public DNS namespace**
+**Example 1: To update a public DNS namespace using ID**
 
-The following ``update-public-dns-namespace`` example updates the description of a public DNS namespace. ::
+The following ``update-public-dns-namespace`` example updates the description of a public DNS namespace using its ID. ::
 
     aws servicediscovery update-public-dns-namespace \
-        --id ns-bk3aEXAMPLE \
-        --updater-request-id example-public-request-id \
+        --id ns-abcd1234xmpl5678 \
+        --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
         --namespace Description="The updated namespace description."
 
 Output::
 
     {
-        "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
     }
 
 To confirm that the operation succeeded, you can run ``get-operation``.
 
 For more information, see `AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To update a public DNS namespace using ARN**
+
+The following ``update-public-dns-namespace`` example updates a public DNS namespace using its ARN. ::
+
+    aws servicediscovery update-public-dns-namespace \
+        --id arn:aws:servicediscovery:us-west-2:123456789012:namespace/ns-abcd1234xmpl5678 \
+        --updater-request-id abcd1234-5678-90ab-cdef-xmpl12345678 \
+        --namespace Description="The updated namespace description."
+
+Output::
+
+    {
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
+    }
+
+For more information, see `AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/update-service-attributes.rst

@@ -1,11 +1,23 @@
- **To update a service to add an attribute**
+**Example 1: To update a service to add an attribute**
 
 The following ``update-service-attributes`` example updates the specified service to add a service attribute with a key ``Port`` and a value ``80``. ::
 
     aws servicediscovery update-service-attributes \
-        --service-id srv-e4anhexample0004 \
+        --service-id srv-abcd1234xmpl5678 \
         --attributes Port=80
 
 This command produces no output.
 
 For more information, see `AWS Cloud Map services <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To update a service attributes using ARN**
+
+The following ``update-service-attributes`` example updates a service using its ARN to add a service attribute. Specifying the ARN is necessary for adding attributes to services created in namespaces shared with your account. ::
+
+    aws servicediscovery update-service-attributes \
+        --service-id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
+        --attributes Port=80
+
+This command produces no output.
+
+For more information, see  `AWS Cloud Map services <https://docs.aws.amazon.com/cloud-map/latest/dg/working-with-services.html>`__ and `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/examples/servicediscovery/update-service.rst

@@ -1,17 +1,33 @@
-**To update a service**
+**Example 1: To update a service**
 
 The following ``update-service`` example updates a service to update the ``DnsConfig`` and ``HealthCheckConfig`` settings. ::
 
     aws servicediscovery update-service \
-        --id srv-e4anhexample0004 \
-        --service "DnsConfig={DnsRecords=[{"Type"="A","TTL"=60}]},HealthCheckConfig={"Type"="HTTP","ResourcePath"="/","FailureThreshold"="2"}"
+        --id srv-abcd1234xmpl5678 \
+        --service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"
 
 Output::
 
     {
-        "OperationId": "gv4g5meo7ndmeh4fqskygvk23d2fijwa-k9302yzd"
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
     }
 
 To confirm that the operation succeeded, you can run ``get-operation``.
 
 For more information about updating a service, see `Updating an AWS Cloud Map service <https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html>`__ in the *AWS Cloud Map Developer Guide*.
+
+**Example 2: To update a service using ARN**
+
+The following ``update-service`` example updates a service using its ARN. Specifying an ARN is necessary for services that are created in namespaces shared with your account. ::
+
+    aws servicediscovery update-service \
+        --id arn:aws:servicediscovery:us-west-2:123456789012:service/srv-abcd1234xmpl5678 \
+        --service "DnsConfig={DnsRecords=[{Type=A,TTL=60}]},HealthCheckConfig={Type=HTTP,ResourcePath=/,FailureThreshold=2}"
+
+Output::
+
+    {
+        "OperationId": "abcd1234-5678-90ab-cdef-xmpl12345678"
+    }
+
+For more information about updating a service, see `Updating an AWS Cloud Map service <https://docs.aws.amazon.com/cloud-map/latest/dg/editing-services.html>`__ and `Shared AWS Cloud Map namespaces <https://docs.aws.amazon.com/cloud-map/latest/dg/sharing-namespaces.html>`__ in the *AWS Cloud Map Developer Guide*.

awscli/paramfile.py

@@ -10,6 +10,8 @@
 # distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF
 # ANY KIND, either express or implied. See the License for the specific
 # language governing permissions and limitations under the License.
+import sys
+
 import copy
 import logging
 import os
@@ -20,6 +22,7 @@ from botocore.httpsession import URLLib3Session
 
 from awscli import argprocess
 from awscli.compat import compat_open
+from awscli.utils import resolve_v2_debug_mode
 
 logger = logging.getLogger(__name__)
 
@@ -166,7 +169,7 @@ class URIArgumentHandler:
             prefixes.update(REMOTE_PREFIX_MAP)
         self._prefixes = prefixes
 
-    def __call__(self, event_name, param, value, **kwargs):
+    def __call__(self, event_name, param, value, parsed_globals=None, **kwargs):
         """Handler that supports param values from URIs."""
         cli_argument = param
         qualified_param_name = '.'.join(event_name.split('.')[1:])
@@ -175,13 +178,27 @@ class URIArgumentHandler:
         ):
             return
         else:
-            return self._check_for_uri_param(cli_argument, value)
+            return self._check_for_uri_param(cli_argument, value, parsed_globals)
 
-    def _check_for_uri_param(self, param, value):
+    def _check_for_uri_param(self, param, value, parsed_globals):
         if isinstance(value, list) and len(value) == 1:
             value = value[0]
         try:
-            return get_paramfile(value, self._prefixes)
+            param_file = get_paramfile(value, self._prefixes)
+            if param_file is not None and resolve_v2_debug_mode(parsed_globals):
+                print(
+                    '\nAWS CLI v2 UPGRADE WARNING: For input parameters that '
+                    'have a prefix of `http://` or `https://`, AWS CLI v2 '
+                    'will not automatically request the content of the URL '
+                    'for the parameter, and the `cli_follow_urlparam` option '
+                    'has been removed. For guidance on how to adapt this '
+                    'command to AWS CLI v2 usage, see '
+                    'https://docs.aws.amazon.com/cli/latest/userguide/'
+                    'cliv2-migration-changes.html'
+                    '#cliv2-migration-paramfile.\n',
+                    file=sys.stderr,
+                )
+            return param_file
         except ResourceLoadingError as e:
             raise argprocess.ParamError(param.cli_name, str(e))
 

awscli/testutils.py

@@ -27,7 +27,9 @@ import json
 import logging
 import os
 import platform
+import random
 import shutil
+import string
 import sys
 import tempfile
 import time
@@ -36,6 +38,7 @@ import uuid
 from pprint import pformat
 from subprocess import PIPE, Popen
 from unittest import mock
+from pathlib import Path
 
 import botocore.loaders
 from botocore.awsrequest import AWSResponse
@@ -49,6 +52,11 @@ _LOADER = botocore.loaders.Loader()
 INTEG_LOG = logging.getLogger('awscli.tests.integration')
 AWS_CMD = None
 
+with tempfile.TemporaryDirectory() as tmpdir:
+    with open(Path(tmpdir) / 'aws-cli-tmp-file', 'w') as f:
+        pass
+    CASE_INSENSITIVE = (Path(tmpdir) / 'AWS-CLI-TMP-FILE').exists()
+
 
 def skip_if_windows(reason):
     """Decorator to skip tests that should not be run on windows.
@@ -69,6 +77,15 @@ def skip_if_windows(reason):
     return decorator
 
 
+def skip_if_case_sensitive():
+    def decorator(func):
+        return unittest.skipIf(
+            not CASE_INSENSITIVE,
+            "This test requires a case-insensitive filesystem."
+        )(func)
+    return decorator
+
+
 def create_clidriver():
     driver = awscli.clidriver.create_clidriver()
     session = driver.session

awscli/topics/config-vars.rst

@@ -98,7 +98,7 @@ The valid values of the ``output`` configuration variable are:
 ``cli_timestamp_format`` controls the format of timestamps displayed by the AWS CLI.
 The valid values of the ``cli_timestamp_format`` configuration variable are:
 
-* none - Display the timestamp exactly as received from the HTTP response.
+* wire - Display the timestamp exactly as received from the HTTP response.
 * iso8601 - Reformat timestamp using iso8601 in the UTC timezone.
 
 ``cli_follow_urlparam`` controls whether or not the CLI will attempt to follow

awscli/topics/s3-case-insensitivity.rst

@@ -0,0 +1,105 @@
+:title: AWS CLI S3 Case-Insensitivity
+:description: Using 'aws s3' commands on case-insensitive filesystems
+:category: S3
+:related command: s3 cp, s3 sync, s3 mv
+
+
+This page explains how to detect and handle potential case conflicts when
+downloading multiple objects from S3 to a local case-insensitive filesystem
+using a single AWS CLI command.
+
+Case conflicts
+==============
+S3 object keys are case-sensitive meaning that a bucket can have a set of
+key names that differ only by case, for example, ``a.txt`` and ``A.txt``.
+
+The AWS CLI offers high-level S3 commands that manage transfers of
+multiple S3 objects using a single command:
+
+* ``aws s3 sync``
+* ``aws s3 cp --recursive``
+* ``aws s3 mv --recursive``
+
+Case conflicts can occur on case-insensitive filesystems when an S3 bucket
+has multiple objects whose keys differ only by case and a single AWS CLI
+command is called to download multiple S3 objects **OR** a local file
+already exists whose name differs only by case.
+
+For example, consider an S3 bucket with the following stored objects:
+
+* ``a.txt``
+* ``A.txt``
+
+When the following AWS CLI command is called, the AWS CLI will submit
+requests to download ``a.txt`` and ``A.txt``. Since only
+one can exist on a case-insensitive filesystem, the last download to finish
+will be the file that's locally available.
+
+.. code-block::
+
+    aws s3 sync s3://examplebucket ./mylocaldir
+
+Detecting and handling case conflicts
+=====================================
+To detect and handle case conflicts, you can specify the ``--case-conflict``
+parameter. The following values are valid options:
+
+* ``error`` - When a case conflict is detected, the command will immediately
+  fail and abort in-progress downloads.
+* ``warn`` - (Default) When a case conflict is detected, the AWS CLI will
+  display a warning.
+* ``skip`` - When a case conflict is detected, the command will skip
+  downloading the object and continue and display a warning.
+* ``ignore`` - Case conflicts will not be detected or handled.
+
+
+Continuing the prior example, the following describes what happens when
+appending the ``--case-conflict`` parameter with possible values:
+
+``--case-conflict error``
+
+1. Submit a download request for ``A.txt``.
+2. Detect that ``a.txt`` conflicts with an object that's been submitted for download.
+3. Throw an error. If ``A.txt`` finished downloading, it will be locally available. Otherwise, the download request for ``A.txt`` will be aborted.
+
+``--case-conflict warn``
+
+1. Submit a download request for ``A.txt``.
+2. Detect that ``a.txt`` conflicts with an object that's been submitted for download.
+3. Display a warning.
+4. Submit a download request for ``a.txt``, downloading ``A.txt`` and ``a.txt`` in parallel.
+
+``--case-conflict skip``
+
+1. Submit a download request for ``A.txt``.
+2. Detect that ``a.txt`` conflicts with an object that's been submitted for download.
+3. Skip downloading ``a.txt`` and continue.
+
+``--case-conflict ignore``
+
+1. Submit a download request for ``A.txt``.
+2. Submit a download request for ``a.txt``, downloading ``A.txt`` and ``a.txt`` in parallel.
+
+If your local filesystem is case-sensitive, there's no need to detect and
+handle case conflicts. We recommend setting ``--case-conflict ignore``
+in this case.
+
+S3 Express directory buckets
+============================
+Detecting case conflicts is **NOT** supported when the source is an S3 Express
+directory bucket. When operating on directory buckets, valid values for the
+``--case-conflict`` parameter are:
+
+* ``warn``
+* ``ignore``
+
+The following values are invalid when operating on directory buckets:
+
+* ``error``
+* ``skip``
+
+For example, calling the following command will fail:
+
+.. code-block::
+
+    aws s3 cp s3://mydirbucket--usw2-az1--x-s3 ./mylocaldir --recursive --case-conflict error

awscli/topics/topic-tags.json

@@ -69,5 +69,21 @@
         "title": [
             "AWS CLI S3 FAQ"
         ]
+    },
+    "s3-case-insensitivity": {
+        "category": [
+            "S3"
+        ],
+        "description": [
+            "Using 'aws s3' commands on case-insensitive filesystems"
+        ],
+        "related command": [
+             "s3 cp",
+             "s3 sync",
+             "s3 mv"
+        ],
+        "title": [
+            "AWS CLI S3 Case-Insensitivity"
+        ]
     }
 }

awscli/utils.py

@@ -134,6 +134,18 @@ def find_service_and_method_in_event_name(event_name):
     return service_name, operation_name
 
 
+def resolve_v2_debug_mode(args):
+    # Resolve whether v2-debug mode is enabled,
+    # following the correct precedence order.
+    if args is None:
+        return False
+    if getattr(args, 'v2_debug', False):
+        return True
+    if os.environ.get('AWS_CLI_UPGRADE_DEBUG_MODE', '').lower() == 'true':
+        return True
+    return False
+
+
 def is_document_type(shape):
     """Check if shape is a document type"""
     return getattr(shape, 'is_document_type', False)
@@ -205,8 +217,13 @@ def ignore_ctrl_c():
         signal.signal(signal.SIGINT, original)
 
 
-def emit_top_level_args_parsed_event(session, args):
-    session.emit('top-level-args-parsed', parsed_args=args, session=session)
+def emit_top_level_args_parsed_event(session, args, remaining=None):
+    session.emit(
+        'top-level-args-parsed',
+        parsed_args=args,
+        session=session,
+        remaining_args=remaining,
+    )
 
 
 def is_a_tty():

{awscli-1.42.33.dist-info → awscli-1.44.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: awscli
-Version: 1.42.33
+Version: 1.44.6
 Summary: Universal Command Line Environment for AWS.
 Home-page: http://aws.amazon.com/cli/
 Author: Amazon Web Services
@@ -21,11 +21,12 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >= 3.9
 License-File: LICENSE.txt
-Requires-Dist: botocore (==1.40.33)
+Requires-Dist: botocore (==1.42.16)
 Requires-Dist: docutils (<=0.19,>=0.18.1)
-Requires-Dist: s3transfer (<0.15.0,>=0.14.0)
+Requires-Dist: s3transfer (<0.17.0,>=0.16.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)
@@ -63,6 +64,7 @@ The aws-cli package works on Python versions:
 -  3.11.x and greater
 -  3.12.x and greater
 -  3.13.x and greater
+-  3.14.x and greater
 
 Notices
 ~~~~~~~