Metadata-Version: 2.1
Name: ghga_service_chassis_lib
Version: 0.14.1
Summary: A library that contains the basic chassis functionality used in services of GHGA
Home-page: https://github.com/ghga-de/ghga-service-chassis-lib
Author: German Human Genome Phenome Archive (GHGA)
Author-email: contact@ghga.de
License: Apache 2.0
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3.9
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.9
Description-Content-Type: text/markdown; charset=UTF-8
Provides-Extra: api
Provides-Extra: kafka
Provides-Extra: pubsub
Provides-Extra: mongo_connect
Provides-Extra: object_storage_dao
Provides-Extra: s3
Provides-Extra: postgresql
Provides-Extra: dev
Provides-Extra: all
License-File: LICENSE

![tests](https://github.com/ghga-de/ghga-service-chassis-lib/actions/workflows/unit_and_int_tests.yaml/badge.svg)
[![PyPI version shields.io](https://img.shields.io/pypi/v/ghga_service_chassis_lib.svg)](https://pypi.python.org/pypi/ghga_service_chassis_lib/)
[![PyPI pyversions](https://img.shields.io/pypi/pyversions/ghga_service_chassis_lib.svg)](https://pypi.python.org/pypi/ghga_service_chassis_lib/)
[![Coverage Status](https://coveralls.io/repos/github/ghga-de/ghga_service_chassis_lib/badge.svg?branch=main)](https://coveralls.io/github/ghga-de/ghga_service_chassis_lib?branch=main)

# ghga-service-chassis-lib
This python library serves as chassis for the microservices developed at
German Human Genome-Phenome Archive (GHGA).

It collects boilerplate code for common functionalities such as config
parameter parsing and API server setup.

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_chassis_lib

You can install it from there using:
```
pip install ghga_service_chassis_lib
```

Thereby, you may specify following extra(s):
- `api`: dependencies needed to use the API server functionalities
- `dev`: dependencies needed for development and testing

## Development
For setting up the development environment, we rely on the
[devcontainer feature](https://code.visualstudio.com/docs/remote/containers) 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-formating
- a pre-configured debugger
- automatic license-header insertion

Moreover, inside the devcontainer, there is follwing 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`](./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:
``` bash
# Execute in the repo's root dir:
cd ./.devcontainer

# build and run the environment with docker-compose
docker build -t ghga-service-chassis-lib .
docker run -it ghga-service-chassis-lib /bin/bash

```

## License
This repository is free to use and modify according to the [Apache 2.0 License](./LICENSE).
