Metadata-Version: 2.4
Name: microservice-api
Version: 0.1.9
Summary: Lightweight FastAPI microservice for identity and access management, built with asyncpg and Tortoise ORM
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi==0.129.0
Requires-Dist: uvicorn[standard]==0.32.1
Requires-Dist: pydantic==2.10.3
Requires-Dist: email-validator==2.1.1
Requires-Dist: tortoise-orm==1.1.2
Requires-Dist: asyncpg==0.30.0
Requires-Dist: pyjwt==2.11.0
Requires-Dist: httpx==0.28.1
Requires-Dist: requests==2.32.3
Requires-Dist: apscheduler==3.11.2
Requires-Dist: picologging==0.9.3
Requires-Dist: python-dotenv==1.2.1
Requires-Dist: stripe<8.0.0,>=5.0.0
Requires-Dist: google-genai>=1.0.0

# 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

```bash
pip install microservice-api
```

## Quickstart

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

## Example

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

```bash
make install
make run
```

Or run it directly:

```bash
./.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

```bash
pip install -e .[dev]
pytest
```
