🏥 Infirmary: an API for Clinical Data for the Consortium for Molecular and Cellular Characterization of Screen-Detected Lesions
Project description
🏥 Infirmary
Welcome to "Infirmary", the ReST-based application programming interface for the Clinical Data component of the the Consortium for Molecular and Cellular Characterization of Screen-Detected Lesions. This project, along with Sickbay form a database for discovering clinical data.
⚙️ Endpoints
Once deployed, this package provides the following ReST API endpoints:
Endpoint | Auth | Purpose |
---|---|---|
/ping |
Test if the server is working | |
/hello/{greeting} |
🔐 | Test if authentication is working |
/clinicalCores |
🔐 | Return all Clinical Cores in the database, fully serialized |
/clinicalCores/{participant_ID} |
🔐 | Return the single Clinical Core for the named participant_ID |
/organs |
🔐 | Return all organs in the database |
/organs/{identifier} |
🔐 | Return the single organ with the numeric identifier |
/specimens |
🔐 | Return all biospecimens in the database |
/specimens/{specimen_ID} |
🔐 | Return the single biospecimen with the given specimen_ID |
/genomics |
🔐 | Return all genomics in the database |
/genomics/{specimen_ID} |
🔐 | Return the genomics information with the given specimens_ID |
/images |
🔐 | Return all imaging information in the database |
/images/{identifier} |
🔐 | Return the imaging information with the numeric identifier |
For those endpoints where the "Auth" column is dispays 🔐, you must provide an HTTP Basic Authentication header with a username and password of a member of the Consortium for Molecular and Cellular Characterization of Screen-Detected Lesions. All of the endpoints return a JSON payload.
🔧 Development
To develop locally with a local Postgres database:
python3 -m venv venv
venv/bin/pip install --quiet --upgrade setuptools pip wheel build
venv/bin/pip install --editable '.[dev]'
venv/bin/infirmary --debug
To create and register the image:
docker image build --tag mcl-infirmary:latest .
docker image tag mcl-infirmary:latest nutjob4life/mcl-infirmary:latest
docker login
docker image push nutjob4life/mcl-infirmary:latest
To explore the image:
docker container run --rm --interactive --tty --entrypoint /bin/sh mcl-infirmary:latest
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
Built Distribution
Hashes for mcl.infirmary-1.2.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | cc20c229b5ba38dcc7e378e7b2ddf83aa45a9e67bccf62c0a0554682576e9773 |
|
MD5 | d4142e48a28f939a1231a06b55196851 |
|
BLAKE2b-256 | 149a5554f9a6b82ae347c10c44dc2c6e18c431c5f659a88607190236b4cdd6d1 |