quotish 0.1.0

quotish is a combinator library for building command lines and shell snippets using PEP 750 template strings. Grab it from PyPI or read the documentation on ReadTheDocs.

>>> import quotish as qsh
>>> # Safely interpolate values into argument lists or shell-safe strings.
>>> msg = 'hello, world'
>>> qsh.cmd(t'echo {msg}!').argv()
['echo', 'hello, world!']
>>> qsh.cmd(t'echo {msg}!').render()
"echo 'hello, world!'"
>>> # Interpolate into shell lines instead to preserve shell syntax constructs.
>>> qsh.shell(t'echo {msg}; echo 123').render()
"echo 'hello, world'; echo 123"
>>> # Unpack sequences, build cartesian products, and compose the resulting
>>> # command lines together.
>>> host = 'host'
>>> pkgs = ['ripgrep', 'just']
>>> dnf = qsh.cmd(t'dnf install -y {pkgs:*}')
>>> inner = qsh.shell(rt"echo '- '{pkgs:^}$'\n' ; {dnf:*}")
>>> qsh.cmd(t'ssh {host} {inner}').argv()
['ssh', 'host', "echo '- 'ripgrep$'\\n' '- 'just$'\\n' ; dnf install -y ripgrep just"]