kstlib 2.1.1

Config-driven helpers for Python projects (dynamic config, secure secrets, preset logging, and more…)

Config-driven Python toolkit for resilient applications

---

kstlib is a personal Python toolkit built over 7 years of learning and experimentation.

It started as a way to explore Python best practices, evolved into utilities for personal automation, and now serves as the foundation for study projects in algorithmic trading and market analysis.

The focus has always been on building resilient, secure, and performant systems.

Note: Everything works via Python, but since kstlib is heavily config-driven, the Examples Gallery showcases a YAML-first approach.

Core Modules

Module	Purpose
config	Cascading config files, includes, SOPS encryption, Box access
secrets	Multi-provider resolver (env, keyring, SOPS, KMS) with guardrails
logging	Rich console, rotating files, TRACE level, structlog integration
auth	OIDC/OAuth2 with PKCE, token storage, auto-refresh
mail	Jinja templates, transports (SMTP, Gmail API, Resend, AWS SES)
alerts	Multi-channel (Slack, Email), throttling, severity levels
websocket	Resilient connections, auto-reconnect, heartbeat, watchdog
rapi	Config-driven REST client with HMAC signing
pipeline	Declarative sequential workflows (shell/python/callable steps), error policies, conditional execution
monitoring	Collectors + Jinja rendering + delivery (file, mail)
resilience	Circuit breaker, rate limiter, graceful shutdown
ops	Session manager (tmux), containers (Docker/Podman)
helpers	TimeTrigger, formatting, secure delete, validators

Quick Start

Installation

pip install kstlib

Basic Usage

from kstlib.config import load_from_file
from kstlib import cache

config = load_from_file("config.yml")

@cache(ttl=300)
def expensive_computation(x: int) -> int:
    return x ** 2

result = expensive_computation(5)

Minimal Configuration

app:
  name: "My Application"
  debug: true

database:
  host: "localhost"
  port: 5432

Documentation

Full documentation available at kstlib.readthedocs.io

• Features Guide
• Examples Gallery
• API Reference
• Development Guide

Installation Options

# Standard install
pip install kstlib

# With uv (faster)
uv pip install kstlib

# Development install
pip install "kstlib[dev]"

# All extras
pip install "kstlib[all]"

# From GitHub (latest)
pip install "git+https://github.com/KaminoU/kstlib.git"

License

MIT License - Copyright 2025 Michel TRUONG

See LICENSE for full text.