colemen-py 0.1.0

A dot-accessible Python utility toolkit for files, directories, media, math conversions, random values, strings, validation, and external tooling.

colemen_py

colemen_py is a dot-accessible Python utility toolkit rebuilt from the older colemen_utils ecosystem.

The public API is intentionally discoverable from a single import:

import colemen_py as c

c.file.exists("notes.txt")
c.string.to_snake_case("Hello World")
c.rand.uuid()

Installation

Base install:

pip install colemen-py

Optional feature groups:

pip install "colemen-py[image]"   # Pillow-backed image helpers
pip install "colemen-py[audio]"   # Mutagen-backed audio metadata helpers
pip install "colemen-py[video]"   # OpenCV-backed video frame scoring helpers
pip install "colemen-py[media]"   # image + audio + video optional dependencies
pip install "colemen-py[dev]"     # test/build/lint tooling

The import package name is still colemen_py:

import colemen_py as c

Design principles

• One installable package, many internal modules.
• Dot-accessible namespaces for IDE autocomplete.
• Pythonic snake_case method names, with selected compatibility aliases where useful.
• Public functions include type hints and docstrings.
• No expensive work at import time.
• str and pathlib.Path are accepted for path-based helpers.
• Generic file utilities live in c.file; media-specific behavior lives in c.media.

Public namespaces

c.array      # list/sequence utilities
c.list       # alias to c.array
c.object     # dictionary/object utilities
c.dict       # alias to c.object
c.string     # string utilities
c.file       # file utilities
c.dir        # directory utilities
c.directory  # alias to c.dir
c.console    # console output/timers
c.rand       # random values/ids
c.random     # alias to c.rand
c.time       # time/duration utilities
c.type       # type checks/coercion
c.validation # validation helpers
c.math       # math helpers
c.media      # media/binary utilities

Stage 1 status

This is the foundation package. The old colemen_utils source has not been blindly copied in. Instead, the core utility surface has been rebuilt with clean internals and tests.

The package can use bundled binaries when present and can also fall back to compatible tools available on PATH. Current media wrappers may rely on external executables such as ExifTool, FFmpeg, FFprobe, colemen_copy, and Shredator depending on the feature being used.