utils

utils (published from the pyutils project) is a small Python library that gathers the little helper functions you tend to rewrite in every project into one importable place. It is organized into broad functional modules so you can quickly find helpers for enums, lists, dicts, dates, math, booleans, and objects.

Rather than reaching for a heavyweight dependency or copy-pasting the same snippets, you import a focused helper such as a clean enum implementation, a list flattener, or a dict inverter. The API is intentionally minimal and grouped by data type to keep discovery easy.

What You Get

• A clean enum module offering enum classes with options like frozen and strict comparison
• List helpers for flattening, chunking, and other common sequence transformations
• Dict helpers for inverting and manipulating mappings
• Date, math, and boolean utility functions for everyday tasks
• Object helpers for introspection and attribute handling

Common Use Cases

• Avoiding repeated copy-paste of the same small helper functions across projects
• Using a lightweight enum implementation with configurable behavior
• Flattening or chunking nested lists without writing boilerplate
• Inverting or transforming dictionaries with a single call

Under The Hood

Architecture - The package is a flat collection of independent modules under utils/, one per data domain: enum.py, lists.py, dicts/, dates.py, math.py, bools.py, and objects.py. The top-level __init__.py re-exports these so callers can from utils import enum or import specific helpers directly. There is no shared state or framework; each module is a standalone set of functions.

Tech Stack - Pure Python with no runtime dependencies, packaged with a classic setup.py/setup.cfg. Development tooling includes Pipenv (Pipfile), tox for test matrices, and even a default.nix for Nix-based environments.

Code Quality - The repo ships a tests/ directory covering the modules and historically ran on Travis CI. The codebase is small and readable, though the project is now inactive with infrequent maintenance, so it is best suited to stable, low-churn helper needs.

API Design - Helpers are grouped by data type, which makes discovery intuitive: you look in lists for list helpers and dicts for dict helpers. Functions are small and single-purpose, and the enum module offers a notably clean, options-driven API for defining enums.