A simple flask library for building microservices with RBAC JWT security, OpenAPI client and SQLAlchemy database support.
Project description
A simple flask library for building microservices with RBAC JWT security, OpenAPI client and SQLAlchemy database support.
Developer Quick Start Guide
Follow the instructions below to get a development environment up and running quickly!
Prerequisites
Python 3.10+
Getting Help with Make Tasks
Execute the following command to get a full list of make targets:
$ make help
Setup Python Development Environment
Create a Python virtual environment:
$ mkvirtualenv -p py310 flask-ligand
Setup develop environment:
$ make develop-venv
Setup git pre-commit hooks:
$ make setup-pre-commit
Verify that environment is ready for development:
$ make test-all
Configuration Settings
The following environment variables are available to configure behavior of services that use this library:
ENV |
Default Value for ‘local’ Environment |
Description |
SERVICE_PUBLIC_URL |
http://localhost:5000 |
The public URL for this service. (Used for generating OpenAPI clients) |
SERVICE_PRIVATE_URL |
http://localhost:5000 |
The private URL for this service. (Used for generating OpenAPI clients) |
OIDC_ISSUER_URL |
None (must be provided) |
The Keycloak IAM URL to use for authentication. |
OIDC_REALM |
None (must be provided) |
The Keycloak IAM realm to use for authentication. |
SQLALCHEMY_DATABASE_URI |
sqlite:///:memory: |
The URI for a PostgreSQL database to use for persistent storage. |
OPENAPI_GEN_SERVER_URL |
http://api.openapi-generator.tech |
The OpenAPI online generator server URL to use for creating clients. |
Contributing
See CONTRIBUTING.rst for more details on developing for the flask-ligand project.
Release Process
See release_process.rst for information on the release process for the flask-ligand project.
Python Black IDE Integration
This repo utilizes Python Black for automatic code formatting using the make format task. However, this is not very convenient to use on a regular basis and instead it is recommended to integrate Python Black into your IDE workflow. Checkout these editor integration guides for integrating Python Black with popular IDEs and text editors.
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 flask_ligand-0.1.2-py2.py3-none-any.whl
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 3ebc68384f0935e175474e8510bbbc01903b8c3837d1b646cbcf12e332e08da3 |
|
| MD5 | fe4a0bbba1b3423484b0f381688cec38 |
|
| BLAKE2b-256 | 8f9c10f0bf23685a7c628ad12d5f311c62f72111d1aa1293db92210b26cc7e00 |
