ghga-service-commons
This Python library serves as a collection of common utilities used by the microservices developed at German Human Genome-Phenome Archive (GHGA).
It collects boilerplate code for common functionalities such as API server setup, authentication and authorization.
This library is primarily intended for internal use at GHGA and should not be seen as a general-purpose microservice chassis. However, if this library matches your specific needs as well, please feel free to use it. It is open source.
Installation
This package is available at PyPI: https://pypi.org/project/ghga_service_commons
You can install it from there using:
pip install ghga_service_commons
Thereby, you may specify following extra(s):
api: dependencies needed to use the API server functionalitiesauth: dependencies needed for dealing with authentication and authorization
Development
For setting up the development environment, we rely on the devcontainer feature of vscode.
To use it, you have to have Docker as well as vscode with its "Remote - Containers" extension (ms-vscode-remote.remote-containers) extension installed.
Then, you just have to open this repo in vscode and run the command
Remote-Containers: Reopen in Container from the vscode "Command Palette".
This will give you a full-fledged, pre-configured development environment including:
- infrastructural dependencies of the service (databases, etc.)
- all relevant vscode extensions pre-installed
- pre-configured linting and auto-formatting
- a pre-configured debugger
- automatic license-header insertion
Moreover, inside the devcontainer, there is following convenience command available (please type it in the integrated terminal of vscode):
dev_install- install the lib with all development dependencies and pre-commit hooks (please run that if you are starting the devcontainer for the first time or if added any python dependencies to the./setup.cfg)
If you prefer not to use vscode, you could get a similar setup (without the editor specific features) by running the following commands:
# Execute in the repo's root dir:
cd ./.devcontainer
# build and run the environment with docker-compose
docker build -t ghga-service-commons .
docker run -it ghga-service-commons /bin/bash
License
This repository is free to use and modify according to the Apache 2.0 License.
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ghga_service_commons-0.8.0.tar.gz.
File metadata
- Download URL: ghga_service_commons-0.8.0.tar.gz
- Upload date:
- Size: 28.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/4.0.2 CPython/3.11.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
1c2d3f48c654407f3c32940fdb38480a0663aa8f57c90cc499d074396073161c
|
|
| MD5 |
f77ae5abcdc308f23dd96f2b98aeeaf3
|
|
| BLAKE2b-256 |
285ada5172ee1034c97af07d8532a5a996e7137bcff744a5ece16723dac46855
|
File details
Details for the file ghga_service_commons-0.8.0-py3-none-any.whl.
File metadata
- Download URL: ghga_service_commons-0.8.0-py3-none-any.whl
- Upload date:
- Size: 49.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/4.0.2 CPython/3.11.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4838f7c23fcd90f382eb9d5d27e29dd60d7db2443f2209198c7f0500904d1c11
|
|
| MD5 |
02b3580878ec3d5c2ceec135f052d8ac
|
|
| BLAKE2b-256 |
a3cf2dcb14db7e74b620dca80a822110d18bb347fe4c8bbefa74ba07445982eb
|
