Command

Helper to assert and run other CLI commands and work with its output.

Functions

`command_ensure_exists(command)`

Verifies that a command is available, and logs a message in case it is missing.

from blcks_do.command import command_ensure_exists

if not command_ensure_exists('terraform'):
    pass

`command_run(command, env=None, workdir=None, shell=True)`

Runs a command and prints to full command line, as well as the commands output.

from blcks_do.command import command_run

if command_run(['env', '--debug'], env={"SOME_ENV": "foo-bar"}, workdir="/tmp"):
    pass

output

▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
running command 'env --debug' in '/tmp'
────────────────────────────────────────────────────────────────────────────────
USER=pelle
[...]
SOME_ENV=foo-bar
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀

`command_exec_json(command, env=None, workdir=None)`

Executes a command and parses the output as JSON.

from blcks_do.command import command_exec_json

result = command_exec_json('some_json_command.sh')

if result is not None:
    print(result['attribute1'])