PyPepper

PyPepper

Composable building blocks for Python microservices.
Build faster. Live more.

PyPI Docs CI Coverage Python License

In memory of my father, who passed away in 2023 from COVID-19.

PyPepper packages the pieces you wire into services: HTTP / SSE, FSM, a workflow scheduler, signed events, thin DB helpers, and optional OpenTelemetry tracing — for Python 3.10–3.14.

Documentation

Getting Started · Tutorial · Architecture · Guides · API Reference

Source under docs/. Local preview: make docs-serve.

Contributing

See CONTRIBUTING.md for setup, Conventional Commits, and PR expectations.

Security

See SECURITY.md for supported versions and how to report vulnerabilities privately.

Domains

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 state machine with rollback
Scheduler pypepper.scheduler Job → Channel → Worker → Workflow
Network pypepper.network FastAPI HTTP server and SSE subsystem
Helper pypepper.helper MySQL / PostgreSQL / MongoDB connectors

Highlights
Network FastAPI HTTP + SSE with API-key auth and rate limits → guide
FSM & events Rollback on handler failure; signed payloads → guide
Scheduler Workflow job pipeline with retries → guide
Tracing Opt-in OpenTelemetry (console / local Jaeger) → guide
Quality PEP 561 py.typed · ruff + mypy CI · coverage ≥ 90%
Data Thin DB helpers → guide

Quick start

Requires Python 3.10–3.14 and uv ≥ 0.10.7 (recommended).

make build-prepare

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

HTTP example:

python example/server/app.py --config ./conf/app.config.yaml

Full walkthrough: Getting Started.

Developer commands 
make lint     # ruff + mypy
make test     # check + pytest (coverage ≥ 90%)
make docs     # mkdocs build --strict
make docker   # local image
make clean

Project links

Data verified by PyPI on Jul 20, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.6.5)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for jovijovi from gravatar.com jovijovi

Credits

Author: jovijovi

GitHub Statistics

Data verified by PyPI on Jul 20, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License

Requires

Python <=3.14, >=3.10

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pypepper-0.6.2.tar.gz (258.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pypepper-0.6.2-py3-none-any.whl (62.5 kB view details)

Uploaded Python 3

File details

Details for the file pypepper-0.6.2.tar.gz.

File metadata

  • Download URL: pypepper-0.6.2.tar.gz
  • Upload date:
  • Size: 258.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pypepper-0.6.2.tar.gz
Algorithm Hash digest
SHA256 7bc45315dd0a0cbcb34ca12a0a1f2fa94b8048bd753f86f00b7158b0811f4bc1
MD5 370a5cb3952cf0653c725414e8efd0b0
BLAKE2b-256 c3353dafb9c3344d865338760a3e54732b045048712b499d4c1f1f2094701cdc

See more details on using hashes here.

Provenance

The following attestation bundles were made for pypepper-0.6.2.tar.gz:

Publisher: publish.yml on jovijovi/pypepper

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file pypepper-0.6.2-py3-none-any.whl.

File metadata

  • Download URL: pypepper-0.6.2-py3-none-any.whl
  • Upload date:
  • Size: 62.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.14

File hashes

Hashes for pypepper-0.6.2-py3-none-any.whl
Algorithm Hash digest
SHA256 4eb34642c9e4ff9fb0f601fa320aec65e91e9b1c24384871d829d0ee6603bf67
MD5 2a9b14474d3f71b1c4f30e14a987ff7b
BLAKE2b-256 e94b15e1dd97fbc0e050d8ee5ad8d25b5795c9991e2e9fcfa51f2941a54b0bc9

See more details on using hashes here.

Provenance

The following attestation bundles were made for pypepper-0.6.2-py3-none-any.whl:

Publisher: publish.yml on jovijovi/pypepper

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

0.6.5

2 files

0.6.4

2 files

0.6.3

2 files

This release

0.6.2 This release

2 files

0.6.1

2 files

0.6.0

2 files

0.4.6

2 files

0.4.5

2 files

0.4.4

2 files

0.4.3

2 files

0.4.1

2 files

0.4.0

2 files

0.3.8

2 files

0.3.7

2 files

0.3.6

2 files

0.3.5

2 files

0.3.3

2 files

0.3.2

2 files

0.3.1

2 files

0.3.0

2 files

0.2.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page