Skip to main content

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 as alex-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 preservation

cache

Async cachingAsyncCache with LRU/LFU eviction policies, optional TTL, and built-in performance statistics

init_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 PyYAML and packaging; 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 threading and asyncio

License

AlexBerUtils is released under the BSD 2-Clause License.