termlink v0.1.1
termlink
Provide an ontology via Terminology Service's API link.
Termlink is a command line client and library for uploading ontologies to LifeOmic's Precision Health Cloud. It's goal is to make uploading standardized ontologies easier and to provide utilities for uploading custom ontologies. It provides a simple command line interface for uploading standard ontologies via the Precision Health Cloud API and a Python SDK for building integrations with custom ontologies.
Quickstart
Download the following tools:
Pull the latest version of Termlink from Docker Hub:
$ docker pull lifeomic/termlink
Create an environment variables file containing your LifeOmic account, user and API key.
$ cat lifeomic.env
LO_ACCOUNT=<your account>
LO_USER=<your username>
LO_ACCESS_KEY=<your access key>
Note: The best way to manage API keys is using the LifeOmic CLI. You can also create an API key using the Precision Health Cloud.
Run it.
$ docker run --env-file lifeomic.env -e LO_PROJECT=<your project> --network=host termlink python -m termlink --help
Note: You can obtain your project identifier using the LifeOmic CLI.
Getting Started
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
Prerequisites
The following tools are required to run Termlink:
Installing
The following steps will guide you through installing the project locally.
Clone the git
repository onto your local machine.
$ git clone git@github.com:lifeomic/termlink.git && cd ./termlink
Using Python 3, create a virtualenv
and then activate it.
$ python3 -m venv venv && source venv/bin/activate
Note: Your Python binary may be under a different name.
Check that your local version of Python is at least version 3.7 by running python --version
.
Once you have verified your version of Python is correct, run the following to download all dependencies.
$ pip install -r requirements.txt requirements-dev.txt
You now have everything you need to start developing on Termlink.
Testing
This project uses the Python unittest
framework.
Unit Testing
The simple way to run unit tests is using yarn
:
$ yarn test
To speed up development, you can run the tests against your local Python build using the Makefile
.
$ make test
Deployment
Built With
- Docker: "Build, Ship, and Run Any App, Anywhere."
- Python 3: "Python is a programming language that lets you work quickly and integrate systems more effectively."
- Requests: "Requests is an elegant and simple HTTP library for Python, built for human beings."
Contributing
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
Authors
- Taylor Steinberg - Initial work - tdstein
See also the list of contributors who participated in this project.
License
This project is licensed under the MIT - see the LICENSE file for details.
Acknowledgments
5 years ago