rotools 0.1.165

Robert Olechowski python tools

ROTools

A collection of Python utilities and helpers for everyday development tasks.

Installation

pip install rotools

With optional extras:

pip install rotools[minio]       # MinioWrapper
pip install rotools[requests]    # RequestHelper
pip install rotools[polars]      # df_helpers
pip install rotools[sqlalchemy]  # db_helpers

Quick start

from ROTools import DictObj, ConfigLoader, StopWatch

# DictObj — dict with attribute access and dot-notation paths
d = DictObj(name="Alice", address=DictObj(city="Warsaw"))
print(d.name)                  # Alice
print(d.get("address.city"))   # Warsaw
d.set("address.zip", "00-001")
d.dump()

# ConfigLoader — YAML config with env-var overrides
cfg = ConfigLoader("config.yaml")
db_host = cfg.get("database.host")

# StopWatch — simple elapsed-time helper
sw = StopWatch()
sw.start()
# ... work ...
sw.stop()
print(sw)

Modules

Module	Description
DictObj	Dict-like object with attribute access and dot-notation paths
ConfigLoader	YAML config loader with environment variable overrides
Attr	Deep get/set/del using dot-notation strings
StopWatch	Elapsed time measurement
WorkersCollection	Thread/process worker pool
SignalHandler	Graceful shutdown signal handling
RequestHelper	HTTP request wrapper with retries
RateLimiter	Rate limiting for loops and API calls
SleepController	Interruptible sleep
SmartCounter	Counter with merge support
StringBuilder	String/table builder
HashBuilder	Deterministic hash generation for objects
MinioWrapper	S3/Minio object storage wrapper
PathWrapper	Filesystem path utilities

Requirements

• Python >= 3.10
• PyYAML >= 6.0
• humanize >= 4.0

License

Apache License 2.0