libaaron 0.6

trivial functions I like to pack along for various things

Just I library of handy functions I like to bring along.

reify is a decorator I stole from the Pylons project that I like to use frequently.

cached is a decorator that makes a property but caches it’s results. It’s functionally similar to reify, but it dynamically creates a “private” attribute to cache the result instead of messing with descriptors. This approach is comppatible with slots. I love slots.

w is a function that takes an iterable with a context manager (like a file object) and yields from that iterable inside its context manager.

>>> # instead of this:
>>> with open('myfile.txt') as mf:
...     for line in mf:
...         # do something
...
>>> # you can do this:
>>> for line in w(open('myfile.txt')):
...     # do something
...

flatten is a function that takes an iterable as an arguments and recursively yields all contents from nested iterables (except strings, which are yielded as strings). The optional second argument is a function that will be used to convert any mappings into iterables before yielding from them (in the event you want to yield from their values or something else).

DotDict is a subclass of dict which allows fetching items with dot syntax. Useful as an object_hook when deserializing JSON, perhaps.