sparse-cli 0.0.2

Sparse command line utility.

Sparse CLI

The Sparse CLI is the command line utility for the Sparse geo-distributed database hosting service. It’s developed in Python and the code is published under the MIT License at github.com/sparse-data/sparse-cli.

Develop

You can install the CLI for local development by installing the dependencies into a Python3 environment and developing the egg:

pip install -r requirements.txt
python setup.py develop

This will install a sparse binary in your local Python environment’s bin folder. You can check that this is on your path with e.g.:

which sparse

Build

If you want to build standalone binaries, you first need to install the extra development requirements:

pip install -r dev-requirements.txt

Then you can build a Pex executable using:

python setup.py bdist_pex --bdist-all

This will create a ./dist/sparse binary which you can copy and run anywhere on your system.

Alternatively, you can build a standalone binary with an embedded Python interpretor using PyOxidizer:

pyoxidizer run

This will create a binary at ./build/:target/debug/install/sparse that you can run on any machine with the same architecture and OS as your build machine.

Usage

Run the sparse command without arguments or with the --help flag for usage information:

sparse --help

You can drill down into usage information for the resources / command groups and for individual commands, e.g.:

sparse auth --help
sparse auth login --help

Further documentation is available on the Sparse website.

Test

Running the tests requires nose and coverage, included in the dev-requirements.txt.

Then, run e.g.:

nosetests --with-coverage --cover-package sparse