PyPepper

PyPepper is a microservice toolkit for Python (>=3.10, <=3.14). It provides reusable building blocks rather than a full application framework.

Published docs: https://jovijovi.github.io/pypepper/

Domains

Domain	Package	Role
Common	pypepper.common	Config, logging, context, cache, crypto, utilities
Event	pypepper.event	Signed domain events with JSON marshal
FSM	pypepper.fsm	Event-triggered finite state machine with rollback
Scheduler	pypepper.scheduler	Job → Channel → Worker → Workflow pipeline
Network	pypepper.network	FastAPI HTTP server and SSE subsystem
Helper	pypepper.helper	Thin MySQL / PostgreSQL / MongoDB connectors

Where to start

1. Getting Started — install, test, run examples
2. Tutorial: First service — one path to COMPLETE (and optional SSE)
3. Architecture — layering, extension points, singletons
4. Domain guides under Guides for copy-paste snippets
5. API Reference — generated signatures and docstrings

Examples

• example/server/app.py — minimal HTTP handlers
• example/scheduler/app.py — Job → Worker through COMPLETE
• example/sse/app.py — SSE with API key auth and rate limiting

export PYPEPPER_SSE_API_KEY=your-local-key
python example/sse/app.py