Human Cell Atlas Data Storage System Command Line Interface
Project description
This repository contains a prototype for interacting with the replicated Data Storage System (hereafter the DSS) of the Human Cell Atlas.
This prototype uses a local version of the DSS API spec (using Swagger) to generate a command
line client that will make requests to the DSS. Please run hca --help to see an overview of available commands.
Development
To develop on the CLI, first run pip install -r requirements-dev.txt.
Testing
Before you run tests, do an hca login. This will pop up a browser and get you to authenticate with Google. Use an email from one of the whitelisted domains (in DSS_SUBSCRIPTION_AUTHORIZED_DOMAINS_ARRAY from here).
Then make test.
Code Generation
These python bindings have to be regenerated to reflect any api changes. To regenerate these, run make bindings. Only package maintainers should run this command and publish new package versions.
Installation
To install this package, run pip install hca-cli. This will automatically hook up with the api endpoint as defined in the package published last.
To use the command line interface with a local or test DSS, open <directory_holding_hca_module>/hca/api_spec.json. Change host to the host you want (if you’re running on a local DSS, this will likely be localhost:5000) and the first argument of schemes should be the scheme you want (http if running locally, https otherwise).
Usage
The command-line utility hca is the entry point to the CLI provided by this package.
Each of the above commands has its own associated optional or required arguments. To see these, type hca <command> -h. These arguments are listed in a style common to most argparse parsers. For instance:
hca put-bundles [-h] [--version VERSION] --replica REPLICA --files INDEXED/NAME/UUID/VERSION [INDEXED/NAME/UUID/VERSION ...] --creator-uid CREATOR_UID uuid
Here is a list of what each type means.
Positional arguments: These don’t have a flag in front of them. If they are surrounded by brackets, they are optional.
Optional arguments: Note that the term optional in this sense doesn’t mean that the argument is not required. It means that the argument is identified by a flag. If the argument and the flag (A word with “–” in front of it). are surrounded in brackets, this input is optional. If an arument is repeated multiple times with the later arguments surrounded in brackets, it means the parser accepts a list of these arguments.
Objects: Because the REST API sometimes consumes lists of objects, it is important to be able to pass these into the command line interface. To pass in an object, it is a number of arguments separated by slashes, as seen in the example above. An example input to this could be
True/Bob/3806d74a-6ab5-4a6d-ba00-667ea858c7b5/2017-06-30T19:33:38+00:00. If an argument within an object is optional and you don’t have an input for it, you can replace it’s supposed place withNone.
Bugs
Please report bugs, issues, feature requests, etc. on GitHub.
License
Licensed under the terms of the MIT License.
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
Built Distribution
File details
Details for the file hca-1.0.0.tar.gz.
File metadata
- Download URL: hca-1.0.0.tar.gz
- Upload date:
- Size: 31.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 64883377cf73ee2d55534d16fc7b6a3bab98d6d0dc96b003b5829fd0d9b31bb7 |
|
| MD5 | 0890662fee65e51554c00ee8298f1fef |
|
| BLAKE2b-256 | dc40c354e7986a1e6da1db6e4a65ab16c96f6af3954f6c836535cc125d5b5794 |
File details
Details for the file hca-1.0.0-py2.py3-none-any.whl.
File metadata
- Download URL: hca-1.0.0-py2.py3-none-any.whl
- Upload date:
- Size: 84.7 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | f57538df4ce52f1b73235e6328edefe203a4c3464a52eef9608b04b69ecb0baf |
|
| MD5 | 0601aac45388535d68d2f98f626d82a7 |
|
| BLAKE2b-256 | 98ad1f071883b9ddd987d532f52bdfff9e708594d1aa86e3da8bbc34842e7394 |
