PyPepper

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

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.

Project: https://github.com/jovijovi/pypepper
Docs: https://jovijovi.github.io/pypepper/

Documentation

Getting Started · Architecture · Guides · API Reference

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

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

License
- OSI Approved :: MIT License
Operating System
- OS Independent
Programming Language
- Python :: 3
Typing
- Typed

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.1.tar.gz (239.9 kB view details)

Uploaded Jul 15, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

pypepper-0.6.1-py3-none-any.whl (61.0 kB view details)

Uploaded Jul 15, 2026 Python 3

File details

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

File metadata

Download URL: pypepper-0.6.1.tar.gz
Upload date: Jul 15, 2026
Size: 239.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for pypepper-0.6.1.tar.gz
Algorithm	Hash digest
SHA256	`13105d8f8bf1ed95084aca4c3cec969cfbc7bb489dc46017bdbbc80f456f420c`
MD5	`c7a7817e58d43b2ea36be32fc0c61546`
BLAKE2b-256	`69e165bc2840308b8ed9dd073cb036af0282678a3567b02a936d380e395f5fa9`

See more details on using hashes here.

Provenance

The following attestation bundles were made for pypepper-0.6.1.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.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: pypepper-0.6.1.tar.gz
- Subject digest: 13105d8f8bf1ed95084aca4c3cec969cfbc7bb489dc46017bdbbc80f456f420c
- Sigstore transparency entry: 2172509975
- Sigstore integration time: Jul 15, 2026
Source repository:
- Permalink: jovijovi/pypepper@8468b79d84886b9a77e8cbc15d401427a3af17ec
- Branch / Tag: refs/tags/v0.6.1
- Owner: https://github.com/jovijovi
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@8468b79d84886b9a77e8cbc15d401427a3af17ec
- Trigger Event: push