praxicraft-shared
Stateless Python utilities shared by Praxicraft backends (Practice, auth, notifications, and future services). Products pin a git tag; no Django ORM, settings, or product business logic lives here.
Planning & milestones: Gamified-Application/docs/praxicraft-shared/README.md
Prerequisites
- Python 3.11+
- GitHub access to this private repo (install via HTTPS + token)
Install (in a product)
praxicraft-shared @ git+https://github.com/praxicraft-platform/praxicraft-shared@v0.6.0
Builds need a token with contents:read (CI: PRAXICRAFT_GH_TOKEN).
Local editable (sibling checkout):
pip install -e ~/Desktop/praxicraft-shared
Local development
cd ~/Desktop/praxicraft-shared
pip install -e ".[dev]"
ruff check src tests
pytest
What’s in the package
| Module | Role |
|---|---|
jwt_utils |
Validate RS256 access JWTs (JWKS / PEM) |
auth_client |
HTTP client for praxicraft-auth (token exchange, me, …) |
billing_client |
HTTP client for praxicraft-billing (entitlements, checkout, cancel/resume) |
s3_client |
Injectable MinIO/S3 helpers (make_s3_client, put/get/presign, prefix download) |
notifications_client |
HTTP client for praxicraft-notifications internal send |
service_token |
Parse product:token / JSON service-token maps (no DRF) |
ai_service |
Thin client for praxicraft-llm (gateway + circuit-breaker fallback) |
error_envelope |
Standard success/error dict shapes |
events |
Event envelope helpers + events/SCHEMA.md |
email/ |
Shared HTML/text email templates (rendered by notifications) |
secret_crypto |
Fernet encrypt/decrypt (inject key) |
work_email |
Email normalize / consumer-domain helpers |
hibp |
Have I Been Pwned password check |
Not shipped yet (planned): org_client (after auth A7).
Hard rules
- Stateless — no Django models, ORM, Celery, or package-owned Redis singletons
- No
django.conf.settings— callers inject URLs and keys - No product logic (XP, Assess scoring, Tutor mastery)
- Semver via git tags — breaking JWT/auth contracts = major bump
Related
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
praxicraft_shared-0.6.0.tar.gz
(58.3 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
