Development

Thanks for your interest in this personal project! Whether you’re here to explore the code, report an issue, or contribute, it’s much appreciated.

This section covers the development workflow, testing strategy, and infrastructure setup for anyone who wants to hack on kstlib.

Note

This project uses strict quality gates: tox for multi-version testing, pre-commit hooks, and a CI/CD pipeline that enforces 95%+ coverage per module.


Contribution Workflow

Git branching, commit conventions, release process.

Contributing to kstlib
Testing

pytest, tox multi-env, coverage requirements.

Testing
Quality & CI

Ruff, mypy, pre-commit hooks, tox marker system.

Quality & CI
Makefile

Make targets for common dev tasks.

Makefile Commands
Performance

Benchmarking and optimization guidelines.

Performance
Infrastructure

Keycloak, LocalStack for local testing.

Local Infrastructure
Secrets Management

SOPS setup, key management, best practices.

Secrets Management
Secrets Workflow

Day-to-day secrets operations.

Secrets Workflow
Binary Dependencies

System dependencies and installation.

Binary Dependencies