Aglyph - Dependency Injection for Python

http://ninthtest.info/aglyph-python-dependency-injection/

Introduction

Aglyph is a Dependency Injection framework for Python that...

• supports type 2 (setter) and type 3 (constructor) dependency injection
• can assemble prototype, singleton, borg, and weakref components
• supports templates (i.e. component inheritance) and lifecycle methods
• works with any kind of object creation pattern you'll encounter:
  • constructor
  • factory function or method
  • object creation hidden behind attribute or property access
• is configured declaratively, either programmatically through a fluent API or using a simple XML syntax (see the Aglyph DTD)
• is non-intrusive:
  • only one dependency (Autologging) beyond the Python standard library
  • does not require modification of existing source code (i.e. no decorators, specific naming conventions, or any other kind of syntactic "magic" necessary)
• can inject not only 3rd-party dependencies, but also dependents
• runs on Python 2.7 and 3.4+ using the same codebase
• is proactively tested on CPython, Jython, IronPython, PyPy, and Stackless Python
• is fully logged and traced for ease of troubleshooting (note: tracing is disabled by default, and can be activated by setting an environment variable)

Installation

The easiest way to install Aglyph is to use pip:

$ pip install Aglyph

To verify that an installation was successful:

>>> import aglyph
>>> aglyph.__version__
'3.0.0.post1'

After installing, take a look at Getting started with Aglyph and the Aglyph cookbook.

Alternative source and binary installation options are described below.

Source installation

Clone or fork the repository:

$ git clone https://github.com/mzipay/Aglyph.git

Alternatively, download and extract a source .zip or .tar.gz archive from https://github.com/mzipay/Aglyph/releases, https://pypi.python.org/pypi/Aglyph/ or https://sourceforge.net/projects/aglyph/files/aglyph/.

Run the test suite and install the aglyph package:

$ cd Aglyph
$ python setup.py test
$ python setup.py install

Binary installation

Download the Python wheel (.whl) or .exe/.msi Windows installer from https://pypi.python.org/pypi/Aglyph/ or https://sourceforge.net/projects/aglyph/files/aglyph/.

Use pip or wheel to install the .whl, or run the Windows installer.