alfa-cli 0.1.2

CLI tools for ALFA

alfa-cli

This package provides a command line tool for ALFA.

Installation

You can directly install alfa-cli using pip. This will install the alfa-cli package as well as all dependencies.

$ pip install -U alfa-cli

If you already have alfa-cli installed and want to upgrade to the latest version, you can run:

$ pip install --upgrade alfa-cli

Usage

Once alfa-cli is installed, you can run it with the following template.

$ alfa [options] <command> <subcommand> [parameters]

For more information regarding the usage, you can refer to the provided help information.

$ alfa --help
$ alfa <command> --help
$ alfa <command> <subcommand> --help

Command Completion

The alfa-cli package includes a command completion feature, but is not automatically installed. To enable tab completion you can follow the instructions below:

For bash, run the following command, or append it to ~/.bashrc

$ . alfa-complete.sh

For zsh, run the following command, or append it to ~/.zshrc

$ . alfa-complete.zsh

Development

To install requirements locally:

1. Activate local venv

$ virtualenv venv
$ source venv/bin/activate

2. Install requirements from setup.py

$ pip install -e .[dev]

To develop alfa-cli alongside alfa-sdk, you can opt to install a local copy of the alfa-sdk instead.

$ pip install -e /path/to/alfa-sdk-py

Running it locally

You can run the cli directly as a python module.

$ python alfa_cli [options] <command> <subcommand> [parameters]

Alternatively, you can install your local copy of alfa-cli in develop mode, and use it normally.

$ python setup.py develop
$ alfa [options] <command> <subcommand> [parameters]