Skip to main content

An inversion-of-control (IoC) container for building decoupled, configurable, pluggable applications.

Project description Documentation Status

Have a large application where you want to decrease coupling between components? Need to supply configuration to your application’s various services? Want to make a pluggable application where others can supply services?

Inversion of Control and Dependency Injection are two patterns commonly used for these goals.

wired is an implementation of an inversion-of-control (IoC) container and may be used as the core of a dependency injection (DI) framework or simply as a way to separate config-time from runtime for services in an application. It also provides caching such that a container maintains a local copy of each service as they are instantiated.

wired aims to scale down to the simplest cases and up to very large, custom systems. It has one dependency and that dependency has one dependency.

See or docs/index.rst in this distribution for detailed documentation.

0.3 (2020-11-29)

  • Added the __wired_factory__ protocol which enables classes/functions. This feature allows objects to declare their factory in a reusable way near the definition of the class/function instead of near the ServiceRegistry.register_factory invocation. Build some decorators that automatically inject this protocol! See

  • Added the wired.service_factory venusian decorator which can be used to discover factories by setting up a venusian.Scanner and scanning your code to auto-register the services. In the future wired will likely provide top-level scanning, but for now you have to do it yourself and there are examples in the docs. See

0.2.2 (2020-05-26)

0.2.1 (2019-08-12)

0.2 (2019-04-22)

Backward Incompatibilities

  • wired.ServiceContainer.set has been redefined to set a service instance for a specific context object instead of for a type-of-context. The new method wired.ServiceContainer.register_singleton is a direct replacement for the old behavior.


  • Add wired.ServiceContainer.register_factory and wired.ServiceContainer.register_singleton which are per-container analogues to their per-registry variants on wired.ServiceRegistry.

  • Edit docs to (a) improve sales pitch, (b) split into a couple of sub-pages, and (c) provide a tutorial. Update README and description a bit as well. See

0.1.2 (2019-03-23)

  • Add support for Python 3.7.

  • Fix an issue where two different service classes with the same name would be treated as the same service, defeating the type-based lookup.

0.1.1 (2018-08-04)

  • Improve memory management slightly in cases where many short-lived context objects are used by tracking and cleaning up their weakrefs.

0.1 (2018-08-01)

  • Initial release.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

wired-0.3.tar.gz (53.5 kB view hashes)

Uploaded source

Built Distribution

wired-0.3-py2.py3-none-any.whl (14.2 kB view hashes)

Uploaded py2 py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page