diapyr 42

Constructor injection for Python

diapyr

Constructor injection for Python.

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

API

diapyr

DI

Convenience import.

types

Convenience import.

diapyr.diapyr

types

def types(*deptypes, **kwargs)

Declare that the decorated function or method expects args of the given types. Use square brackets to request all instances of a type as a list. Use this kwarg to declare the type of result returned by a factory.

DI Objects

class DI()

add

def add(*objs)

Register the given classes, factories or instances.

all

def all(type)

Return all objects of the given type, instantiating them and collaborators if necessary.

__call__

def __call__(clazz)

Return unique object of the given type, instantiating it and its collaborators if necessary.

join

def join(type)

Add a source to the parent that requests the given type from this container.

discardall

def discardall()

Discard all instances created in the current context. Each instance created not via a context manager will have its dispose method called if there is one. Normally this procedure is automatic on context exit, this method is provided for the root context which is never exited.

diapyr.start

diapyr.util

bfs

def bfs(keys)

Breadth-first search starting with the given iterable of keys, intended to be used as a decorator. If a function is decorated it should take an info object and key, and yield subsequent keys. If a class is decorated, a new instance of it is used as info object: The class should have a newdepth method that will be called before each depth, and a process method that takes a key and yields subsequent keys as in the function case. The info object is kept updated with the list of currentkeys, current depth and the set of donekeys. Note that the first currentkeys (depth 0) is exactly the passed in keys iterable, subsequent currentkeys will be non-empty lists. The process function is only invoked for keys that have not yet been processed, i.e. unique keys. When finished the decorated function/class is replaced with the last state of the info object.

setuphacks

getsetupkwargs

def getsetupkwargs(setuppath, fields)

Extract the kwargs passed to setup at the given path (typically some setup.py) that have names in the given fields.