Welcome to Fabsetup!

Set up and maintain configurations, software installations and other things on a local or remote linux system.

Features:

Fabsetup's tasks do the things:
- tasks execute commands commented and comprehensible
- tasks produce output formatted in Markdown or HTML
- run a task local or on a remote host
Addons:
- only install the tasks you need
- create Your own addon with Your task
The Command fabsetup, based on Fabric, is a pimped fab command with the same options and arguments. And some more:
- Control markdown formatted output:
  - --hide-code-block
  - --hide-command-line
  - --hide-command-output
  - --hide-docstring
  - --hide-header
  - --hide-print
  - --unnumbered
  - --pandoc-add-toc
- Write output to file:
  - --outfile
  - --pandoc-html-file
- Control ANSI color codes:
  - --color-off
  - --color-keep
- Control execution of commands:
  - --interactive
- Load fabfiles and invoke tasks:
  - --load-fab
  - --load-inv
- Show effective config:
  - --show-config
- List known Fabsetup addons:
  - --known-addons
API:
- for Your own Fabsetup addon
- use Fabsetup in Your own Fabric tasks and Invoke tasks

Installation

Install fabsetup the same way like fabric, best via pip:

pip install fabsetup

Run task info:

fabsetup info

Important options:

# Show versions
fabsetup --version

# Help
fabsetup -h

# List tasks
fabsetup -l

# Show task help
fabsetup info --help
fabsetup new --help

Invokes shell tab completion also works with fabsetup:

fabsetup -h | grep -A1 "completion"

Apply this simple setup of tab completion in bash:

echo 'source <(fabsetup --print-completion-script bash)' >> ~/.bashrc
source ~/.bashrc

Now You are able to "tab" through the available fabsetup tasks and options:

fabsetup --h<TAB><TAB>  ->  --help  --hide  --hosts
fabsetup --he<TAB>      ->  fabsetup --help
fabsetup --help i<TAB>  ->  fabsetup --help info

More features: Advanced Usage

Fabsetup itself only comes with two tasks, info and new. The tasks that "really do things" reside in separate fabsetup addons.

They will be installed the same way like fabsetup and fabric, best via pip. For example:

pip install fabsetup-theno-termdown

Now You are able to run the task theno.termdown. This task sets up termdown, locally or on a remote host:

# local
fabsetup theno.termdown

# remote
fabsetup -H user@host theno.termdown

Create Your own fabsetup addon doing great things! Start now:

fabsetup new

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution for fabsetup 0.14.0
File	Size	Uploaded
fabsetup-0.14.0.tar.gz	34.6 kB	Jan 11, 2023	Details

Table of built distributions (wheels) for fabsetup 0.14.0
File	Interpreter	ABI	Platform	Reset
fabsetup-0.14.0-py3-none-any.whl 38.5 kB Jan 11, 2023	Python 3	none	any	Details

Total release size: 73.1 kB

Download URL	fabsetup-0.14.0.tar.gz
Size	34.6 kB
Tags	Source
SHA-256 checksum How to use checksums	`cdae2a7067865f3d66712147007523ac0a9c159a2f690717d56089d03d3e9eac`
BLAKE2b-256 checksum How to use checksums	`5dd6dd1076821ecee6acd9848caabff8cc33cc20dc84291b68596932450c5712`
Upload date	Jan 11, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.1`

Download URL	fabsetup-0.14.0-py3-none-any.whl
Size	38.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`ff2f7c88da212605c734deba2c9eb83512205e104de962e5feeae1937380fe2c`
BLAKE2b-256 checksum How to use checksums	`32e2d500f394fd0c47476d8e01833eddaf85559008d86b0ff887c06060f3dac7`
Upload date	Jan 11, 2023
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.2 CPython/3.11.1`