Documentation Index
Fetch the complete documentation index at: https://mintlify.com/alex-ber/AlexBerUtils/llms.txt
Use this file to discover all available pages before exploring further.
Installation
Install AlexBerUtils via pip with optional dependency groups
Quickstart
Get up and running with a working example in minutes
Concurrency & Async
RLock, LockingProxy, exec_in_executor, and AsyncExecutionQueue
Configuration
Hierarchical YAML config parsing with profile support
What is AlexBerUtils?
AlexBerUtils is a collection of small, focused Python utility modules that solve common problems in concurrent applications, configuration management, and general Python development. Each module is independently usable and addresses a specific concern. The library is published on PyPI asalex-ber-utils and supports Python 3.8+.
Key modules
thread_locals
Concurrency primitives — Reentrant
RLock with fairness, LockingProxy for thread-safe object wrapping, exec_in_executor with ContextVar preservationcache
Async caching —
AsyncCache with LRU/LFU eviction policies, optional TTL, and built-in performance statisticsinit_app_conf
App configuration — Parse YAML config files with profile layering, CLI argument merging, and implicit type conversion
ymlparsers
YAML utilities — Hierarchical YAML loading with Jinja2 variable substitution, built on HiYaPyCo
mains
App startup helpers — Working directory fixing, env loading, multiprocess exception guarding, hashable utilities
in_memory_similarity_search
Similarity search — Cosine similarity over small in-memory vector sets for text similarity tasks
Why AlexBerUtils?
- Production-tested — Each utility addresses a real problem encountered in production Python applications
- Minimal dependencies — Core features require only
PyYAMLandpackaging; optional extras are clearly separated - Python 3.8+ — Designed for modern Python with full type annotation support
- Async-native — Concurrency utilities work seamlessly with both
threadingandasyncio
