xju 1.2.5

xju library

Various modules implemented to some broad principles:

• fine-grained static typing

• pure context management

• useful functionality that is hard to use incorrectly

• 100% test coverage

xju.newtype - static and dynamic distinct int, float and str types

• unlike typing.NewType the new types are compatible with isinstance, so you can actually use them to do real stuff, like implement overloaded methods

• see xju/newtype.py.test for sample code

xju.cmc - context management

• unlike python standard library e.g. open(), these are “pure” context managers: resources are never acquired until __enter__

xju.cmc.cmclass - provides context management for class attributes that are context managers

• managing multiple resource attributes is clumsy with ExitStack, this module implements __enter__ and __exit__ automatically to ensure correct ordering and cleanup on exceptions

• see xju/cmc/cmclass.py.test for sample code

xju.cmc.Dict - dictionary that is a context manager for its (context manager) values

• see xju/cmc/Dict.py.test for sample code

xju.cmc.io - pure context management for e.g. file reading and writing

• see unit tests for sample code: * FileLock.py.test * FileMode.py.test * FilePosition.py.test * FileReader.py.test * FileWriter.py.test

xju.cmc.tstore

• time-based storage, organised as files covering time-ranges

• see xju/cmc/tstore.py.test for sample code

xju.cmc.perflog

• time-based json-format record storage built on xju.cmc.tstore

• see xju/cmc/perflog.py.test for sample code

xju.pq

• jquery-like html inspection and modification

• see xju/pq.py.test for sample code

xju.assert_

• assert functions that capture term values e.g. x and y in Assert(x)==y

• see xju/assert_.py.test for sample code

xju.cmd

• wrapper for subprocess.Popen that captures very common usage without the option-and-flag-warren of subprocess

• see xju/cmd.py.test for sample code

xju.json_codec

• encoding/decoding type-hinted dict/list/int/bool/None/float/str and classes to and from json

• designed to fit well with type checking

• built in support for xju.newtype described above

• generates json schema equivalent schemas for types

• see xju/json_codec.py.test for full sample code

xju.jsonschema

• represents JSON schemas as straight-foward, easy-to-read python data structures, because life’s too short for jsonschema

• see xju/jsonschema.py.test for sample code

xju.patch

• minimal, simple, direct patching(/stub/mock) utility, unlike mock-warren. Because one shouldn’t need a degree to read and write a unit test

• see xju/patch.py.test for sample code

xju.time

• type-safe time and duration classes

• see xju/time.py.test for sample code

xju.xn

• Exception wrapping to provide human readable context gathering

• see xju/xn.py.test for sample code