Human Cell Atlas Data Storage System Command Line Interface
Project description
This repository contains a command line interface (CLI) and Python library for interacting with the Data Coordination Platform (DCP) of the Human Cell Atlas (HCA). Currently it allows interaction with the Upload Service and Data Storage Service (DSS).
Installation
pip install hca.
Usage
The hca package installs a command-line utility hca.
To see the list of commands you can use, type hca --help. Commands are grouped into major categories that
roughly correspond to DCP system components, e.g. DSS, Staging Service. To get detailed help for a particular
command group type, e.g. hca dss --help.
When it is necessary to provide a list of things to a command put them in a single string separated with slashes, e.g.
True/Bob/3806d74a-6ab5-4a6d-ba00-667ea858c7b5/2017-06-30T19:33:38+00:00.
Development
To develop on the CLI, first run pip install -r requirements-dev.txt.
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).
Code Generation
Some parts of the CLI are auto-generated from the OpenAPI (Swagger) Specifications (OAS). The 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.
Testing
Before you run tests, do an hca dss 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.
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-2.2.0.tar.gz.
File metadata
- Download URL: hca-2.2.0.tar.gz
- Upload date:
- Size: 42.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1eaa81c4f0e5c6a2d9851967e9dfc0c3db927b306be8446683b3d118e67a05ea |
|
| MD5 | c255c23995ad9c3c50c984df606b32c6 |
|
| BLAKE2b-256 | 51e5e14ce7415568b57c3c2b9b37d7aa09870713f625dd3dc65b493a517b8df6 |
File details
Details for the file hca-2.2.0-py2.py3-none-any.whl.
File metadata
- Download URL: hca-2.2.0-py2.py3-none-any.whl
- Upload date:
- Size: 117.3 kB
- Tags: Python 2, Python 3
- Uploaded using Trusted Publishing? No
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | e79561dd46f198f363a140f7648d0dfc63184621cd6e4d6146cfbde87c1f7bba |
|
| MD5 | 571f6ba699eb8fc8aff215a7c2d960ba |
|
| BLAKE2b-256 | bffe015dd5d5f18d7b0b938d65876cfcd5763a11a0a1a1215d4de0d9784cad0b |
