Nextstrain command-line tool
Project description
# nextstrain-cli
This is the Nextstrain command-line tool. It aims to provide access to
Nextstrain components in a local environment with a minimum of fuss.
You can use it to run a pathogen build which makes use of components like
[sacra][], [fauna][], and [augur][] or view the results of such a build in our
standard viewer, [auspice][].
[sacra]: https://github.com/nextstrain/sacra
[fauna]: https://github.com/nextstrain/fauna
[augur]: https://github.com/nextstrain/augur
[auspice]: https://github.com/nextstrain/auspice
## Usage
This package provides a `nextstrain` program which provides access to a few
commands. If you've installed this package (`nextstrain-cli`), you can just
run `nextstrain`. Otherwise, you can run `./bin/nextstrain` from a copy of the
source code.
```
usage: nextstrain [-h] {build,view,update,check-setup,version} ...
Nextstrain command-line tool
optional arguments:
-h, --help show this help message and exit
commands:
{build,view,update,check-setup,version}
build Run pathogen build
view View pathogen build
update Updates your local image copy
check-setup Tests your local setup
version Show version information
```
For more information on a specific command, you can run it with the `--help`
option, for example, `nextstrain build --help`.
## Installation
This tool is written in Python 3 and requires at least Python 3.5. You may
install it with pip (or pip3) like so:
pip install nextstrain-cli
or from a git clone or copy of the source code:
pip install .
If your system has both Python 2 and Python 3 installed side-by-side, you may
need to use pip3 instead of pip (which often defaults to pip2).
This tool also currently requires [Docker][]. You can download and install the
[Docker Community Edition (CE)][] for your platform for free. After doing so,
run `nextstrain check-setup` to ensure it works.
[Docker]: https://docker.com
[Docker Community Edition (CE)]: https://www.docker.com/community-edition#download
This is the Nextstrain command-line tool. It aims to provide access to
Nextstrain components in a local environment with a minimum of fuss.
You can use it to run a pathogen build which makes use of components like
[sacra][], [fauna][], and [augur][] or view the results of such a build in our
standard viewer, [auspice][].
[sacra]: https://github.com/nextstrain/sacra
[fauna]: https://github.com/nextstrain/fauna
[augur]: https://github.com/nextstrain/augur
[auspice]: https://github.com/nextstrain/auspice
## Usage
This package provides a `nextstrain` program which provides access to a few
commands. If you've installed this package (`nextstrain-cli`), you can just
run `nextstrain`. Otherwise, you can run `./bin/nextstrain` from a copy of the
source code.
```
usage: nextstrain [-h] {build,view,update,check-setup,version} ...
Nextstrain command-line tool
optional arguments:
-h, --help show this help message and exit
commands:
{build,view,update,check-setup,version}
build Run pathogen build
view View pathogen build
update Updates your local image copy
check-setup Tests your local setup
version Show version information
```
For more information on a specific command, you can run it with the `--help`
option, for example, `nextstrain build --help`.
## Installation
This tool is written in Python 3 and requires at least Python 3.5. You may
install it with pip (or pip3) like so:
pip install nextstrain-cli
or from a git clone or copy of the source code:
pip install .
If your system has both Python 2 and Python 3 installed side-by-side, you may
need to use pip3 instead of pip (which often defaults to pip2).
This tool also currently requires [Docker][]. You can download and install the
[Docker Community Edition (CE)][] for your platform for free. After doing so,
run `nextstrain check-setup` to ensure it works.
[Docker]: https://docker.com
[Docker Community Edition (CE)]: https://www.docker.com/community-edition#download
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
nextstrain-cli-1.1.6.tar.gz
(9.0 kB
view hashes)
Built Distribution
Close
Hashes for nextstrain_cli-1.1.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 0a63c811e87af13108bb1784cb3c9521080a2df48ac7dfa04e545ba6e6dc0fc0 |
|
MD5 | 63a9567b990abd726c4bfedac7a073ad |
|
BLAKE2b-256 | b9b7ae16b475e8fac50c3eb198e2d5581c4a37b5b08704f65f783471754b9335 |