foyndation

Base library of foyono projects.

This README is auto-generated, see project wiki for details.

API

foyndation

initlogging

def initlogging()

Initialise the logging module to send debug (and higher levels) to stderr.

innerclass

def innerclass(cls)

An instance of the decorated class may access its enclosing instance via self.

invokeall

def invokeall(callables)

Invoke every callable, even if one or more of them fail. This is mostly useful for synchronising with futures. If all succeeded return their return values as a list, otherwise raise all exceptions thrown as a chain.

onerror

@contextmanager
def onerror(f)

Context manager that runs the given function if an exception happens, like finally excluding the happy path. Return a true value from f to declare the exception was handled i.e. prevent it from being re-raised.

rmsuffix

def rmsuffix(text, suffix)

Return text with suffix removed, or None if text does not end with suffix.

singleton

def singleton(t)

The decorated class is replaced with a no-arg instance. Can also be used to replace a factory function with its result.

solo

def solo(v)

Assert exactly one object in the given sequence and return it.

parabject

register

def register(obj, paracls)

Instantiate paracls, set obj to be the regular object associated with the new parabject, and return the parabject.

dereference

def dereference(parabject)

Get the regular object associated with parabject or raise UnknownParabjectException.

Parabject Objects

class Parabject()

Subclasses typically implement __getattr__ for dynamic behaviour on attribute access, use unmangle there to undo name mangling.

__neg__

def __neg__()

Dereference this parabject.

unmangle

def unmangle(name)

Undo name mangling.