microservice-api 0.3.0

Lightweight FastAPI microservice for identity and access management, built with asyncpg and Tortoise ORM

microservice-api

Lightweight FastAPI microservice for identity and access management, built with asyncpg and Tortoise ORM.

Features

• FastAPI endpoints for auth, users, groups, and permissions
• Async Postgres stack with Tortoise ORM and asyncpg
• JWT-based auth helpers and middleware
• Background worker scaffolding

Installation

pip install microservice-api

Quickstart

uvicorn microservice.main:create_app --factory --reload

Example

Run the minimal example (no DB/auth/worker) from the repo:

make install
make run

Or run it directly:

./.venv/bin/python examples/run.py

Configuration

Set environment variables in a .env file or your shell. Common values include database connection info and JWT secrets.

Development

pip install -e .[dev]
pytest