utz 0.4.0

*("oots")*: imports and utilities for easy wildcard-importing + boilerplate-reduction

utz

("oots"): imports and utilities for easy wildcard-importing + boilerplate-reduction

Install

pip install utz

Use

Import everything:

from utz import *

See __init__.py, which imports many of the modules below, as well as a many standard-library methods and objects.

Features

Some noteworthy modules:

• cd: "change directory" contextmanager
• o: dict wrapper exposing keys as attrs (e.g.: o({'a':1}).a == 1)
• process: subprocess wrappers for more easily shelling out to commands and parsing their stdout
• docker: DSL for programmatically creating Dockerfiles (and building images from them)
• ssh: SSH tunnel wrapped in a context manager
• time: now()/today() helpers with convenient / no-nonsense ISO string serialization and UTC bias
• bases: int⟺str codecs with improvements over standard base64 et al.
• tmpdir: make temporary directories with a specific basename
• context: contextmanager helpers, including ctxs for composing multiple context managers
• escape: escaping split/join helpers
• backoff: simple exponential-backoff utility
• git: git helpers / wrappers around GitPython
• pnds: common pandas imports and helpers
• collections: collection/list helpers

auto-setup.py

utz/setup.py provides defaults for various setuptools.setup() params:

• name: use parent directory name
• version: parse from git tag (otherwise from git describe --tags)
• author_{name,email}: infer from last commit
• long_description: parse README.md (and set `long_description_content_type)
• description: parse first <p> under opening <h1> from README.md
• license: parse from LICENSE file (MIT and Apache v2 supported)

For an example, see gsmo==0.0.1 (and corresponding release).

It can be installed via a pip extra:

pip install utz[setup]