DRS-cli

This repository contains a Bravado-based client for a mockup implementation of the Data Repository Service API schema of the Global Alliance for Genomics and Health, as described in the mock-DRS repository. The client was developed for the use within the TEStribute task distribution logic application.

Usage

To use the client import it as follows in your Python code after installation:

import drs_client

client = drs_client.Client("http://localhost:9101/ga4gh/drs/v1/")

It is possible to supply a Bearer token, which will then be added to the Authentication header (prepended by Bearer) for every outbound call:

client = tes_client.Client(
   url="https://path.to/swagger.json",
   jwt="SomET0kEn"
)

Note that the indicated URL is valid when mock-DRS was installed at the default location on your local machine. When a different DRS instance is supposed to be used, replace the full URL (including http:// or https://).

Access the mock-DRS GET /objects/{object_id} endpoint with, e.g.:

response = client.GetObject("a001")

Access the mock-DRS POST /update-db endpoint with, e.g.:

response = client.updateDatabaseObjects(
    clear_db=True,
    objects=[
        {
            "access_methods": [
                {
                    "access_id": "string",
                    "access_url": {"headers": ["Authorization"], "url": "string"},
                    "region": "us-east-1",
                    "type": "s3",
                }
            ],
            "aliases": ["string"],
            "checksums": [{"checksum": "string", "type": "string"}],
            "created": "string",
            "description": "string",
            "id": "string",
            "mime_type": "application/json",
            "name": "string",
            "size": 0,
            "updated": "string",
            "version": "string",
        },
    ],
)

the objects list can contain any number of such drs_object dicts and the clear_db indicates weather or not the db should be emptied before upload of specified objects.

For further details on populating the DRS via the POST /update-db endpoint, please see the documentation in the mock-DRS repository.

Note that all other endpoints are currently not implemented.

Installation

You can install DRS-cli in one of two ways:

Manual installation

git clone https://github.com/elixir-europe/DRS-cli.git
cd DRS-cli
python setup.py install

Installation via package manager

pip install -e git+https://github.com/elixir-europe/DRS-cli.git#egg=drs_client

or

pip install drs_client

Contributing

This project is a community effort and lives off your contributions, be it in the form of bug reports, feature requests, discussions, or fixes and other code changes. Please read the contributing guidelines if you want to contribute. And please mind the code of conduct for all interactions with the community.

Versioning

Development of the app is currently still in alpha stage, and current versioning is for internal use only. In the future, we are aiming to adopt semantic versioning that is synchronized to the versioning of TEStribute and [mock-TES] in order to ensure that these apps will be compatible as long as both their major and minor versions match.

License

This project is covered by the Apache License 2.0 also available shipped with this repository.

Contact

Please contact the project leader for inquiries, proposals, questions etc. that are not covered by the Contributing section.

Acknowledgments

The project is a collaborative effort under the umbrella of the ELIXIR Cloud and AAI group. It was started during the 2019 Google Summer of Code as part of the Global Alliance for Genomics and Health organization.