xref: /llvm-project/lldb/packages/Python/lldbsuite/support/seven.py (revision 2238dcc39358353cac21df75c3c3286ab20b8f53)
1import binascii
2import shlex
3import subprocess
4
5
6def get_command_output(command):
7    try:
8        return subprocess.check_output(
9            command, shell=True, universal_newlines=True
10        ).rstrip()
11    except subprocess.CalledProcessError as e:
12        return e.output
13
14
15def bitcast_to_string(b: bytes) -> str:
16    """
17    Take a bytes object and return a string. The returned string contains the
18    exact same bytes as the input object. (latin1 <-> unicode transformation is
19    an identity operation for the first 256 code points).
20    """
21    return b.decode("latin1")
22
23
24def bitcast_to_bytes(s: str) -> bytes:
25    """
26    Take a string and return a bytes object. The returned object contains the
27    exact same bytes as the input string. (latin1 <-> unicode transformation isi
28    an identity operation for the first 256 code points).
29    """
30    return s.encode("latin1")
31
32
33def unhexlify(hexstr):
34    """Hex-decode a string. The result is always a string."""
35    return bitcast_to_string(binascii.unhexlify(hexstr))
36
37
38def hexlify(data):
39    """Hex-encode string data. The result if always a string."""
40    return bitcast_to_string(binascii.hexlify(bitcast_to_bytes(data)))
41
42
43# TODO: Replace this with `shlex.join` when minimum Python version is >= 3.8
44def join_for_shell(split_command):
45    return " ".join([shlex.quote(part) for part in split_command])
46