Function _windows_cmd_shell_quote

awscli/compat.py:355–406

Return a Windows shell-escaped version of the string *s* that is safe to pass through cmd.exe Handles two interpretation layers: 1. cmd.exe metacharacters - neutralized by double-quoting when the string contains any cmd.exe special characters. 2. MSVC C runtime argv par

(s)

def _windows_cmd_shell_quote(s):
    """Return a Windows shell-escaped version of the string *s* that is
    safe to pass through cmd.exe

    Handles two interpretation layers:
      1. cmd.exe metacharacters - neutralized by double-quoting when
         the string contains any cmd.exe special characters.
      2. MSVC C runtime argv parsing - backslash/double-quote escaping
         so the target process receives the correct argument.

    Note: cmd.exe %VAR% expansion and !VAR! delayed expansion
    cannot be reliably escaped inside double quotes on the
    command line and are not handled here.

    :param s: A string to escape
    :return: An escaped string
    """
    if not s:
        return '""'

    buff = []
    num_backslashes = 0
    needs_quoting = False
    for character in s:
        if character == '\\':
            num_backslashes += 1
        elif character == '"':
            if num_backslashes > 0:
                buff.append('\\' * (num_backslashes * 2))
                num_backslashes = 0
            buff.append('\\"')
            needs_quoting = True
        else:
            if num_backslashes > 0:
                buff.append('\\' * num_backslashes)
                num_backslashes = 0
            if character in _WIN_CMD_UNSAFE_CHARS:
                needs_quoting = True
            buff.append(character)

    if needs_quoting:
        # Trailing backslashes must be doubled when we append a closing
        # double quote — without doubling, a trailing backslash would
        # escape the closing quote.
        if num_backslashes > 0:
            buff.append('\\' * (num_backslashes * 2))
        inner = ''.join(buff)
        return f'"{inner}"'

    if num_backslashes > 0:
        buff.append('\\' * num_backslashes)
    return ''.join(buff)


def get_popen_kwargs_for_pager_cmd(pager_cmd=None):