Metadata-Version: 2.1
Name: singularitytechnologies.singularity-cli
Version: 0.1.1.dev0
Summary: A CLI to run common singularity tasks.
Home-page: https://github.com/singularitydigitaltechnologies/singularity-cli
Author: Sam Lacey
Author-email: sam.lacey@singularity-technologies.io
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: docopt
Requires-Dist: singularitytechnologies.singularitytechnologiesapi

# Singularity Technologies CLI

This CLI is desinged to help Engineers engage with our API and platform much
more easily.

The CLI handles HMAC signature generation and sets all necessary headers
autonomously.

Its highly recomended that you use the CLI rather than cURL commands.

The CLI has been tested on Ubuntu. If you require support or bug fixes for OSX
or Windows operating systems please open an issue!

Pull Requests are always welcome!

## Installation

The CLI can easily be installed using pip:

```
pip3 install singularitytechnologies.cli
```

While Python2.7 should work, we only officially support usage with Python3.5+

## Config file

The CLI will look for a config json file in the location:

```
$HOME/.singularity/config.json
```

Which should contain the following:

```
{
  "api_key": <key>,
  "secret": <secret>
}
```

If you'd like to store your config elsewhere, simply set the environment
variable:

```
SINGULARITY_CONFIG_PATH=<path>
```

## Usage

A full list of commands can be seen by simply using the following command:

```
singularity-cli
```

You can test your connection to the API by using our PING command:

```
singularity-cli ping
```

A successful connection should return the response `pong`

See this [blog post](https://www.singularity-technologies.io/blog) for a short demonstration on how to use the various
features of the CLI.


