Advanced Usage

Interactive Runs

fabsetup --interactive user.task

Output

• control output --hide-*

• numbering

• ANSI color codes

Outfile

fabsetup --outfile output.md

Logging of fabsetup calls: Automatically create a file on each fabsetup execution: outfile.dir=~/.fabsetup-runs

Example, fabsetup generated output without uncolored, command output with ANSI color codes:

@task
def task_with_colorful_commands(c):
    """Bla bla"""
    c.run("echo colors")

fabsetup --color-off --color-keep --outfile output.md \
  user.task-with-colorful-commands

Pandoc

Add Table of Content

fabsetup --outfile output.md --toc  user.task

HTML File

fabsetup --pandoc-html-file output.html  user.task

Invoke Task Files and Fabfiles

Fabsetup is also able to load and to invoke invoke task files and fabfiles.

--load-inv and --load-fab

inv -l
inv itask

fabsetup --load-inv -l
fabsetup --config invoke.yaml --load-inv inv.itask

fab -l
fab -H user@host ftask

fabsetup --load-fab -l
fabsetup -H user@host --config fabric.yaml --load-fab inv.ftask

fabsetup --load-inv --load-fab -l
fabsetup -H user@host --config invoke.yaml --load-inv --load-fab inv.itask fab.ftask