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

awscli/customizations/globalargs.py

@@ -12,12 +12,18 @@
 # language governing permissions and limitations under the License.
 import sys
 import os
+
+from awscli.customizations.argrename import HIDDEN_ALIASES
+from awscli.customizations.utils import uni_print
 from botocore.client import Config
 from botocore import UNSIGNED
 from botocore.endpoint import DEFAULT_TIMEOUT
+from botocore.useragent import register_feature_id
 import jmespath
 
 from awscli.compat import urlparse
+from awscli.utils import resolve_v2_debug_mode
+
 
 def register_parse_global_args(cli):
     cli.register('top-level-args-parsed', resolve_types,
@@ -30,6 +36,8 @@ def register_parse_global_args(cli):
                  unique_id='resolve-cli-read-timeout')
     cli.register('top-level-args-parsed', resolve_cli_connect_timeout,
                  unique_id='resolve-cli-connect-timeout')
+    cli.register('top-level-args-parsed', detect_migration_breakage,
+                 unique_id='detect-migration-breakage')
 
 
 def resolve_types(parsed_args, **kwargs):
@@ -90,6 +98,167 @@ def resolve_cli_connect_timeout(parsed_args, session, **kwargs):
     arg_name = 'connect_timeout'
     _resolve_timeout(session, parsed_args, arg_name)
 
+def detect_migration_breakage(parsed_args, session, remaining_args, **kwargs):
+    if not resolve_v2_debug_mode(parsed_args):
+        return
+    region = parsed_args.region or session.get_config_variable('region')
+    s3_config = session.get_config_variable('s3')
+    if (
+            not session.get_scoped_config().get('cli_pager', None)
+            == '' and 'AWS_PAGER' not in os.environ
+    ):
+        uni_print(
+            '\nAWS CLI v2 UPGRADE WARNING: By default, the AWS CLI v2 returns '
+            'all output through your operating system’s default pager '
+            'program. This is different from v1 behavior, where the system '
+            'pager is not used by default. To retain AWS CLI v1 behavior in '
+            'AWS CLI v2, set the `cli_pager` configuration setting, or the '
+            '`AWS_PAGER` environment variable, to the empty string. See '
+            'https://docs.aws.amazon.com/cli/latest/userguide/'
+            'cliv2-migration-changes.html#cliv2-migration-output-pager.\n',
+            out_file=sys.stderr
+        )
+    if 'PYTHONUTF8' in os.environ or 'PYTHONIOENCODING' in os.environ:
+        if 'AWS_CLI_FILE_ENCODING' not in os.environ:
+            uni_print(
+                '\nThe AWS CLI v2 does not support The `PYTHONUTF8` and '
+                '`PYTHONIOENCODING` environment variables, and instead uses '
+                'the `AWS_CLI_FILE_ENCODING` variable. This is different from '
+                'v1 behavior, where the former two variables are used '
+                'instead. To retain AWS CLI v1 behavior in AWS CLI v2, set '
+                'the `AWS_CLI_FILE_ENCODING` environment variable instead. '
+                'See https://docs.aws.amazon.com/cli/latest/userguide/'
+                'cliv2-migration-changes.html'
+                '#cliv2-migration-encodingenvvar.\n',
+                out_file=sys.stderr
+            )
+    if (
+            (
+                s3_config is None
+                or s3_config.get('us_east_1_regional_endpoint', 'legacy')
+                == 'legacy'
+            )
+            and region in ('us-east-1', None)
+    ):
+        session.register(
+            'request-created.s3.*',
+            warn_if_east_configured_global_endpoint
+        )
+        session.register(
+            'request-created.s3api.*',
+            warn_if_east_configured_global_endpoint
+        )
+    if session.get_config_variable('api_versions'):
+        uni_print(
+            '\nAWS CLI v2 UPGRADE WARNING: AWS CLI v2 UPGRADE WARNING: '
+            'The AWS CLI v2 does not support calling older versions of AWS '
+            'service APIs via the `api_versions` configuration file setting. This '
+            'is different from v1 behavior, where this configuration setting '
+            'can be used to pin older API versions. To migrate to v2 '
+            'behavior, remove the `api_versions` configuration setting, and '
+            'test against the latest service API versions. See '
+            'https://docs.aws.amazon.com/cli/latest/userguide/'
+            'cliv2-migration-changes.html#cliv2-migration-api-versions.\n',
+            out_file = sys.stderr
+        )
+    if session.full_config.get('plugins', {}):
+        uni_print(
+            '\nAWS CLI v2 UPGRADE WARNING: In AWS CLI v2, plugins are '
+            'disabled by default, and support for plugins is provisional. '
+            'This is different from v1 behavior, where plugin support is URL '
+            'below to update your configuration to enable plugins in AWS CLI '
+            'v2. Also, be sure to lock into a particular version of the AWS '
+            'CLI and test the functionality of your plugins every time AWS '
+            'CLI v2 is upgraded. See https://docs.aws.amazon.com/cli/latest/'
+            'userguide/cliv2-migration-changes.html'
+            '#cliv2-migration-profile-plugins.\n',
+            out_file=sys.stderr
+        )
+    if (
+            parsed_args.command == 'ecr' and
+            remaining_args is not None and
+            remaining_args[0] == 'get-login'
+    ):
+        uni_print(
+            '\nAWS CLI v2 UPGRADE WARNING: The `ecr get-login` command has '
+            'been removed in AWS CLI v2. You must use `ecr get-login-password` '
+            'instead. See https://docs.aws.amazon.com/cli/latest/userguide/'
+            'cliv2-migration-changes.html#cliv2-migration-ecr-get-login.\n',
+            out_file=sys.stderr
+        )
+    for working, obsolete in HIDDEN_ALIASES.items():
+        working_split = working.split('.')
+        working_service = working_split[0]
+        working_cmd = working_split[1]
+        working_param = working_split[2]
+        if (
+                parsed_args.command == working_service
+                and remaining_args is not None
+                and remaining_args[0] == working_cmd
+                and f"--{working_param}" in remaining_args
+        ):
+            uni_print(
+                '\nAWS CLI v2 UPGRADE WARNING: You have entered command '
+                'arguments that use at least 1 of 21 built-in ("hidden") '
+                'aliases that were removed in AWS CLI v2. For this command '
+                'to work in AWS CLI v2, you must replace usage of the alias '
+                'with the corresponding parameter in AWS CLI v2. See '
+                'https://docs.aws.amazon.com/cli/latest/userguide/'
+                'cliv2-migration-changes.html#cliv2-migration-aliases.\n',
+                out_file=sys.stderr
+            )
+    # Register against the provide-client-params event to ensure that the
+    # feature ID is registered before any API requests are made. We
+    # cannot register the feature ID in this function because no
+    # botocore context is created at this point.
+    session.register(
+        'provide-client-params.*.*',
+        _register_v2_debug_feature_id
+    )
+    session.register('choose-signer.s3.*', warn_if_sigv2)
+
+
+def _register_v2_debug_feature_id(params, model, **kwargs):
+    register_feature_id('CLI_V1_TO_V2_MIGRATION_DEBUG_MODE')
+
+def warn_if_east_configured_global_endpoint(request, operation_name, **kwargs):
+    # The regional us-east-1 endpoint is used in certain cases (e.g.
+    # FIPS/Dual-Stack is enabled). Rather than duplicating this logic
+    # from botocore, we check the endpoint URL directly.
+    parsed_url = urlparse.urlparse(request.url)
+    if parsed_url.hostname.endswith('s3.amazonaws.com'):
+        uni_print(
+            '\nAWS CLI v2 UPGRADE WARNING: When you configure AWS CLI v2 to '
+            'use the `us-east-1` region, it uses the true regional endpoint '
+            'rather than the global endpoint. This is different from v1 '
+            'behavior, where the global endpoint would be used when the '
+            'region is `us-east-1`. To retain AWS CLI v1 behavior in AWS '
+            'CLI v2, configure the region setting to `aws-global`. See '
+            'https://docs.aws.amazon.com/cli/latest/userguide/'
+            'cliv2-migration-changes.html'
+            '#cliv2-migration-s3-regional-endpoint.\n',
+            out_file=sys.stderr
+        )
+
+def warn_if_sigv2(
+        signing_name,
+        region_name,
+        signature_version,
+        context,
+        **kwargs
+):
+    if context.get('auth_type', None) == 'v2':
+        uni_print(
+            '\nAWS CLI v2 UPGRADE WARNING: The AWS CLI v2 only uses Signature '
+            'v4 to authenticate Amazon S3 requests. This is different from '
+            'v1 behavior, where the signature used for Amazon S3 requests may '
+            'vary depending on configuration settings, region, and the '
+            'bucket being used. To migrate to AWS CLI v2 behavior, configure '
+            'the Signature Version S3 setting to version 4. See '
+            'https://docs.aws.amazon.com/cli/latest/userguide/'
+            'cliv2-migration-changes.html#cliv2-migration-sigv4.\n',
+            out_file=sys.stderr
+        )
 
 def resolve_cli_read_timeout(parsed_args, session, **kwargs):
     arg_name = 'read_timeout'

awscli/customizations/paginate.py

@@ -33,7 +33,7 @@ from botocore.exceptions import DataNotFoundError, PaginationError
 from botocore import model
 
 from awscli.arguments import BaseCLIArgument
-
+from awscli.utils import resolve_v2_debug_mode
 
 logger = logging.getLogger(__name__)
 
@@ -135,6 +135,9 @@ def unify_paging_params(argument_table, operation_model, event_name,
     _remove_existing_paging_arguments(argument_table, paginator_config)
     parsed_args_event = event_name.replace('building-argument-table.',
                                            'operation-args-parsed.')
+    call_parameters_event = event_name.replace(
+        'building-argument-table', 'calling-command'
+    )
     shadowed_args = {}
     add_paging_argument(argument_table, 'starting-token',
                         PageArgument('starting-token', STARTING_TOKEN_HELP,
@@ -168,6 +171,14 @@ def unify_paging_params(argument_table, operation_model, event_name,
         partial(check_should_enable_pagination,
                 list(_get_all_cli_input_tokens(paginator_config)),
                 shadowed_args, argument_table))
+    session.register(
+        call_parameters_event,
+        partial(
+            check_should_enable_pagination_call_parameters,
+            session,
+            list(_get_all_input_tokens(paginator_config)),
+        ),
+    )
 
 
 def add_paging_argument(argument_table, arg_name, argument, shadowed_args):
@@ -240,6 +251,18 @@ def _get_all_cli_input_tokens(pagination_config):
         yield cli_name
 
 
+# Get all tokens but return them in API namespace rather than CLI namespace
+def _get_all_input_tokens(pagination_config):
+    # Get all input tokens including the limit_key
+    # if it exists.
+    tokens = _get_input_tokens(pagination_config)
+    for token_name in tokens:
+        yield token_name
+    if 'limit_key' in pagination_config:
+        key_name = pagination_config['limit_key']
+        yield key_name
+
+
 def _get_input_tokens(pagination_config):
     tokens = pagination_config['input_token']
     if not isinstance(tokens, list):
@@ -253,6 +276,48 @@ def _get_cli_name(param_objects, token_name):
             return param.cli_name.lstrip('-')
 
 
+def check_should_enable_pagination_call_parameters(
+        session,
+        input_tokens,
+        call_parameters,
+        parsed_args,
+        parsed_globals,
+        **kwargs
+):
+    """
+    Check for pagination args in the actual calling arguments passed to
+    the function.
+
+    If the user is using the --cli-input-json parameter to provide JSON
+    parameters they are all in the API naming space rather than the CLI
+    naming space and would be missed by the processing above. This function
+    gets called on the calling-command event.
+    """
+    if resolve_v2_debug_mode(parsed_globals):
+        cli_input_json_data = session.emit_first_non_none_response(
+            f"get-cli-input-json-data",
+        )
+        if cli_input_json_data is None:
+            cli_input_json_data = {}
+        pagination_params_in_input_tokens = [
+            param for param in cli_input_json_data if param in input_tokens
+        ]
+        if pagination_params_in_input_tokens:
+            uni_print(
+                '\nAWS CLI v2 UPGRADE WARNING: In AWS CLI v2, if you specify '
+                'pagination parameters by using a file with the '
+                '`--cli-input-json` parameter, automatic pagination will be '
+                'turned off. This is different from v1 behavior, where '
+                'pagination parameters specified via the `--cli-input-json` '
+                'parameter are ignored. To retain AWS CLI v1 behavior in '
+                'AWS CLI v2, remove all pagination parameters from the input '
+                'JSON. See https://docs.aws.amazon.com/cli/latest/userguide/'
+                'cliv2-migration-changes.html'
+                '#cliv2-migration-skeleton-paging.\n',
+                out_file=sys.stderr
+            )
+
+
 class PageArgument(BaseCLIArgument):
     type_map = {
         'string': str,

awscli/customizations/s3/filegenerator.py

@@ -94,7 +94,8 @@ class FileDecodingError(Exception):
 class FileStat(object):
     def __init__(self, src, dest=None, compare_key=None, size=None,
                  last_update=None, src_type=None, dest_type=None,
-                 operation_name=None, response_data=None, etag=None):
+                 operation_name=None, response_data=None, etag=None,
+                 case_conflict_submitted=None, case_conflict_key=None,):
         self.src = src
         self.dest = dest
         self.compare_key = compare_key
@@ -105,6 +106,8 @@ class FileStat(object):
         self.operation_name = operation_name
         self.response_data = response_data
         self.etag = etag
+        self.case_conflict_submitted = case_conflict_submitted
+        self.case_conflict_key = case_conflict_key
 
 
 class FileGenerator(object):

awscli/customizations/s3/fileinfo.py

@@ -42,7 +42,8 @@ class FileInfo(object):
                  last_update=None, src_type=None, dest_type=None,
                  operation_name=None, client=None, parameters=None,
                  source_client=None, is_stream=False,
-                 associated_response_data=None, etag=None):
+                 associated_response_data=None, etag=None,
+                 case_conflict_submitted=None, case_conflict_key=None,):
         self.src = src
         self.src_type = src_type
         self.operation_name = operation_name
@@ -60,6 +61,8 @@ class FileInfo(object):
         self.is_stream = is_stream
         self.associated_response_data = associated_response_data
         self.etag = etag
+        self.case_conflict_submitted = case_conflict_submitted
+        self.case_conflict_key = case_conflict_key
 
     def is_glacier_compatible(self):
         """Determines if a file info object is glacier compatible

awscli/customizations/s3/fileinfobuilder.py

@@ -46,6 +46,12 @@ class FileInfoBuilder(object):
         file_info_attr['is_stream'] = self._is_stream
         file_info_attr['associated_response_data'] = file_base.response_data
         file_info_attr['etag'] = file_base.etag
+        file_info_attr['case_conflict_submitted'] = getattr(
+            file_base, 'case_conflict_submitted', None
+        )
+        file_info_attr['case_conflict_key'] = getattr(
+            file_base, 'case_conflict_key', None
+        )
 
         # This is a bit quirky. The below conditional hinges on the --delete
         # flag being set, which only occurs during a sync command. The source

awscli/customizations/s3/s3handler.py

@@ -47,6 +47,7 @@ from awscli.customizations.s3.utils import DirectoryCreatorSubscriber
 from awscli.customizations.s3.utils import DeleteSourceFileSubscriber
 from awscli.customizations.s3.utils import DeleteSourceObjectSubscriber
 from awscli.customizations.s3.utils import DeleteCopySourceObjectSubscriber
+from awscli.customizations.s3.utils import CaseConflictCleanupSubscriber
 from awscli.compat import get_binary_stdin
 
 
@@ -403,6 +404,13 @@ class DownloadRequestSubmitter(BaseTransferRequestSubmitter):
         if self._cli_params.get('is_move', False):
             subscribers.append(DeleteSourceObjectSubscriber(
                 fileinfo.source_client))
+        if fileinfo.case_conflict_submitted is not None:
+            subscribers.append(
+                CaseConflictCleanupSubscriber(
+                    fileinfo.case_conflict_submitted,
+                    fileinfo.case_conflict_key,
+                )
+            )
 
     def _submit_transfer_request(self, fileinfo, extra_args, subscribers):
         bucket, key = find_bucket_key(fileinfo.src)
@@ -433,6 +441,7 @@ class CopyRequestSubmitter(BaseTransferRequestSubmitter):
 
     def _add_additional_subscribers(self, subscribers, fileinfo):
         subscribers.append(ProvideSizeSubscriber(fileinfo.size))
+        subscribers.append(ProvideETagSubscriber(fileinfo.etag))
         if self._should_inject_content_type():
             subscribers.append(ProvideCopyContentTypeSubscriber())
         if self._cli_params.get('is_move', False):

awscli/customizations/s3/subcommands.py

@@ -34,9 +34,10 @@ from awscli.customizations.s3.utils import find_bucket_key, AppendFilter, \
     S3PathResolver
 from awscli.customizations.utils import uni_print
 from awscli.customizations.s3.syncstrategy.base import MissingFileSync, \
-    SizeAndLastModifiedSync, NeverSync
+    SizeAndLastModifiedSync, NeverSync, AlwaysSync
+from awscli.customizations.s3.syncstrategy.caseconflict import CaseConflictSync
 from awscli.customizations.s3 import transferconfig
-
+from awscli.utils import resolve_v2_debug_mode
 
 LOGGER = logging.getLogger(__name__)
 
@@ -482,6 +483,33 @@ BUCKET_REGION = {
     )
 }
 
+CASE_CONFLICT = {
+    'name': 'case-conflict',
+    'choices': [
+         'ignore',
+         'skip',
+         'warn',
+         'error',
+    ],
+    'default': 'warn',
+    'help_text': (
+         "Configures behavior when attempting to download multiple objects "
+         "whose keys differ only by case, which can cause undefined behavior "
+         "on case-insensitive filesystems. "
+         "This parameter only applies for commands that perform multiple S3 "
+         "to local downloads. "
+         f"See <a href='{CaseConflictSync.DOC_URI}'>Handling case "
+         "conflicts</a> for details. Valid values are: "
+         "<ul>"
+         "<li>``error`` - Raise an error and abort downloads.</li>"
+         "<li>``warn`` - The default value. Emit a warning and download "
+         "the object.</li>"
+         "<li>``skip`` - Skip downloading the object.</li>"
+         "<li>``ignore`` - Ignore the conflict and download the object.</li>"
+         "</ul>"
+    ),
+ }
+
 TRANSFER_ARGS = [DRYRUN, QUIET, INCLUDE, EXCLUDE, ACL,
                  FOLLOW_SYMLINKS, NO_FOLLOW_SYMLINKS, NO_GUESS_MIME_TYPE,
                  SSE, SSE_C, SSE_C_KEY, SSE_KMS_KEY_ID, SSE_C_COPY_SOURCE,
@@ -767,6 +795,7 @@ class S3TransferCommand(S3Command):
         cmd_params.add_verify_ssl(parsed_globals)
         cmd_params.add_page_size(parsed_args)
         cmd_params.add_paths(parsed_args.paths)
+        cmd_params.add_v2_debug(parsed_globals)
 
         runtime_config = transferconfig.RuntimeConfig().build_config(
             **self._session.get_scoped_config().get('s3', {}))
@@ -806,7 +835,8 @@ class CpCommand(S3TransferCommand):
             "or <S3Uri> <S3Uri>"
     ARG_TABLE = [{'name': 'paths', 'nargs': 2, 'positional_arg': True,
                   'synopsis': USAGE}] + TRANSFER_ARGS + \
-                [METADATA, METADATA_DIRECTIVE, EXPECTED_SIZE, RECURSIVE]
+                [METADATA, METADATA_DIRECTIVE, EXPECTED_SIZE, RECURSIVE,
+                 CASE_CONFLICT]
 
 
 class MvCommand(S3TransferCommand):
@@ -816,7 +846,8 @@ class MvCommand(S3TransferCommand):
             "or <S3Uri> <S3Uri>"
     ARG_TABLE = [{'name': 'paths', 'nargs': 2, 'positional_arg': True,
                   'synopsis': USAGE}] + TRANSFER_ARGS +\
-                [METADATA, METADATA_DIRECTIVE, RECURSIVE, VALIDATE_SAME_S3_PATHS]
+                [METADATA, METADATA_DIRECTIVE, RECURSIVE, VALIDATE_SAME_S3_PATHS,
+                 CASE_CONFLICT]
 
 
 class RmCommand(S3TransferCommand):
@@ -838,7 +869,7 @@ class SyncCommand(S3TransferCommand):
             "<LocalPath> or <S3Uri> <S3Uri>"
     ARG_TABLE = [{'name': 'paths', 'nargs': 2, 'positional_arg': True,
                   'synopsis': USAGE}] + TRANSFER_ARGS + \
-                [METADATA, METADATA_DIRECTIVE]
+                [METADATA, METADATA_DIRECTIVE, CASE_CONFLICT]
 
 
 class MbCommand(S3Command):
@@ -1003,7 +1034,16 @@ class CommandArchitecture(object):
         # Set the default strategies.
         sync_strategies['file_at_src_and_dest_sync_strategy'] = \
             SizeAndLastModifiedSync()
-        sync_strategies['file_not_at_dest_sync_strategy'] = MissingFileSync()
+        if self._should_handle_case_conflicts():
+            sync_strategies['file_not_at_dest_sync_strategy'] = (
+                CaseConflictSync(
+                    on_case_conflict=self.parameters['case_conflict']
+                )
+            )
+        else:
+            sync_strategies['file_not_at_dest_sync_strategy'] = (
+                MissingFileSync()
+            )
         sync_strategies['file_not_at_src_sync_strategy'] = NeverSync()
 
         # Determine what strategies to override if any.
@@ -1056,6 +1096,24 @@ class CommandArchitecture(object):
         result_queue = queue.Queue()
         operation_name = cmd_translation[paths_type]
 
+        if self.parameters['v2_debug']:
+            if operation_name == 'copy':
+                uni_print(
+                    '\nAWS CLI v2 UPGRADE WARNING: In AWS CLI v2, object '
+                    'properties will be copied from the source in multipart '
+                    'copies between S3 buckets initiated via `aws s3` '
+                    'commands, resulting in additional S3 API calls to '
+                    'transfer the metadata. Note that the principal must '
+                    'have permission to call these APIs, or the command may '
+                    'fail. This is different from v1 behavior, where metadata '
+                    'is not copied. For guidance on retaining v1 behavior in '
+                    'AWS CLI v2, or for more details, see '
+                    'https://docs.aws.amazon.com/cli/latest/userguide/'
+                    'cliv2-migration-changes.html'
+                    '#cliv2-migration-s3-copy-metadata.\n\n',
+                    out_file=sys.stderr
+                )
+
         fgen_kwargs = {
             'client': self._source_client, 'operation_name': operation_name,
             'follow_symlinks': self.parameters['follow_symlinks'],
@@ -1119,6 +1177,12 @@ class CommandArchitecture(object):
                             'filters': [create_filter(self.parameters)],
                             'file_info_builder': [file_info_builder],
                             's3_handler': [s3_transfer_handler]}
+            if self._should_handle_case_conflicts():
+                self._handle_case_conflicts(
+                    command_dict,
+                    rev_files,
+                    rev_generator,
+                )
         elif self.cmd == 'rm':
             command_dict = {'setup': [files],
                             'file_generator': [file_generator],
@@ -1131,6 +1195,12 @@ class CommandArchitecture(object):
                             'filters': [create_filter(self.parameters)],
                             'file_info_builder': [file_info_builder],
                             's3_handler': [s3_transfer_handler]}
+            if self._should_handle_case_conflicts():
+                self._handle_case_conflicts(
+                    command_dict,
+                    rev_files,
+                    rev_generator,
+                )
 
         files = command_dict['setup']
         while self.instructions:
@@ -1196,6 +1266,74 @@ class CommandArchitecture(object):
                 }
             )
 
+    def _should_handle_case_conflicts(self):
+        return (
+                self.cmd in {'sync', 'cp', 'mv'}
+                and self.parameters.get('paths_type') == 's3local'
+                and self.parameters['case_conflict'] != 'ignore'
+                and self.parameters.get('dir_op')
+        )
+
+    def _handle_case_conflicts(self, command_dict, rev_files, rev_generator):
+        # Objects are not returned in lexicographical order when
+        # operated on S3 Express directory buckets. This is required
+        # for sync operations to behave correctly, which is what
+        # recursive copies and moves fall back to so potential case
+        # conflicts can be detected and handled.
+        if not is_s3express_bucket(
+                split_s3_bucket_key(self.parameters['src'])[0]
+        ):
+            self._modify_instructions_for_case_conflicts(
+                command_dict, rev_files, rev_generator
+            )
+            return
+        # `skip` and `error` are not valid choices in this case because
+        # it's not possible to detect case conflicts.
+        if self.parameters['case_conflict'] not in {'ignore', 'warn'}:
+            raise ValueError(
+                f"`{self.parameters['case_conflict']}` is not a valid value "
+                "for `--case-conflict` when operating on S3 Express "
+                "directory buckets. Valid values: `warn`, `ignore`."
+            )
+        msg = (
+            "warning: Recursive copies/moves from an S3 Express "
+            "directory bucket to a case-insensitive local filesystem "
+            "may result in undefined behavior if there are "
+            "S3 object key names that differ only by case. To disable "
+            "this warning, set the `--case-conflict` parameter to `ignore`. "
+            f"For more information, see {CaseConflictSync.DOC_URI}."
+        )
+        uni_print(msg, sys.stderr)
+
+    def _modify_instructions_for_case_conflicts(
+            self, command_dict, rev_files, rev_generator
+    ):
+        # Command will perform recursive S3 to local downloads.
+        # Checking for potential case conflicts requires knowledge
+        # of local files. Instead of writing a separate validation
+        # mechanism for recursive downloads, we modify the instructions
+        # to mimic a sync command.
+        sync_strategies = {
+            # Local filename exists with exact case match. Always sync
+            # because it's a copy operation.
+            'file_at_src_and_dest_sync_strategy': AlwaysSync(),
+            # Local filename either doesn't exist or differs only by case.
+            # Let `CaseConflictSync` determine which it is and handle it
+            # according to configured `--case-conflict` parameter.
+            'file_not_at_dest_sync_strategy': CaseConflictSync(
+                on_case_conflict=self.parameters['case_conflict']
+            ),
+            # Copy is one-way so never sync if not at source.
+            'file_not_at_src_sync_strategy': NeverSync(),
+        }
+        command_dict['setup'].append(rev_files)
+        command_dict['file_generator'].append(rev_generator)
+        command_dict['filters'].append(create_filter(self.parameters))
+        command_dict['comparator'] = [Comparator(**sync_strategies)]
+        self.instructions.insert(
+            self.instructions.index('file_info_builder'), 'comparator'
+        )
+
 
 class CommandParameters(object):
     """
@@ -1447,6 +1585,9 @@ class CommandParameters(object):
     def add_page_size(self, parsed_args):
         self.parameters['page_size'] = getattr(parsed_args, 'page_size', None)
 
+    def add_v2_debug(self, parsed_globals):
+        self.parameters['v2_debug'] = resolve_v2_debug_mode(parsed_globals)
+
     def _validate_sse_c_args(self):
         self._validate_sse_c_arg()
         self._validate_sse_c_arg('sse_c_copy_source')

awscli/customizations/s3/syncstrategy/base.py

@@ -254,3 +254,12 @@ class MissingFileSync(BaseSync):
         LOG.debug("syncing: %s -> %s, file does not exist at destination",
                   src_file.src, src_file.dest)
         return True
+
+
+class AlwaysSync(BaseSync):
+    def __init__(self, sync_type='file_at_src_and_dest'):
+        super(AlwaysSync, self).__init__(sync_type)
+
+    def determine_should_sync(self, src_file, dest_file):
+        LOG.debug(f"syncing: {src_file.src} -> {src_file.dest}")
+        return True