# Clean IoC
A simple dependency injection library for python that requires nothing of your application code (except that you use typing).
Read the [docs](https://peter-daly.github.io/clean_ioc/) to find out more.
## Basic Registering and resolving
There are 4 basic modes of registering a new set of classes
### Implementation
```python
class UserRepository(abc.ABC):
@abc.abstractmethod
def add(self, user):
pass
class InMemoryUserRepository(UserRepository):
def __init__(self):
self.users = []
def add(self, user):
# This is obviously terrible, but it's for demo purposes
self.users.append(user)
class SqlAlchemyUserRepository(UserRepository):
def __init__(self):
# Do some db stuff here
pass
def add(self, user):
# Do some db stuff here
pass
container = Container()
container.register(UserRepository, InMemoryUserRepository)
repository = container.resolve(UserRepository) # This will return an InMemoryUserRepository
```
### Concrete Class
```python
class ClientDependency:
def get_int(self):
return 10
class Client:
def __init__(self, dep: ClientDependency):
self.dep = dep
def get_number(self):
return self.dep.get_int()
container = Container()
container.register(ClientDependency)
container.register(Client)
client = container.resolve(Client)
client.get_number() # returns 10
```
### Factory
```python
class ClientDependency:
def get_int(self):
return 10
class Client:
def __init__(self, dep: ClientDependency):
self.dep = dep
def get_number(self):
return self.dep.get_int()
def client_factory(dep: ClientDependency):
return Client(dep=dep)
container = Container()
container.register(ClientDependency)
container.register(Client, factory=client_factory)
client = container.resolve(Client)
client.get_number() # returns 10
```
### Instance
```python
class ClientDependency:
def __init__(self, num):
self.num = num
def get_int(self):
return self.num
class Client:
def __init__(self, dep: ClientDependency):
self.dep = dep
def get_number(self):
return self.dep.get_int()
client_dependency = ClientDependency(num=10)
container = Container()
container.register(ClientDependency, instance=client_dependency)
container.register(Client)
client = container.resolve(Client)
client.get_number() # returns 10
```
Raw data
{
"_id": null,
"home_page": null,
"name": "clean_ioc",
"maintainer": null,
"docs_url": null,
"requires_python": "~=3.10",
"maintainer_email": null,
"keywords": "dependency, hints, injection, inversion of control, ioc, type, typing",
"author": "Peter Daly",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/37/47/67f8cdae7cd53aa8963f5c72afa4c6d1a332bddaa536c2833a1e7e341a66/clean_ioc-1.18.0.tar.gz",
"platform": null,
"description": "# Clean IoC\nA simple dependency injection library for python that requires nothing of your application code (except that you use typing).\n\n\nRead the [docs](https://peter-daly.github.io/clean_ioc/) to find out more.\n\n\n## Basic Registering and resolving\n\nThere are 4 basic modes of registering a new set of classes\n\n### Implementation\n\n```python\n\nclass UserRepository(abc.ABC):\n @abc.abstractmethod\n def add(self, user):\n pass\n\nclass InMemoryUserRepository(UserRepository):\n\n def __init__(self):\n self.users = []\n\n def add(self, user):\n # This is obviously terrible, but it's for demo purposes\n self.users.append(user)\n\nclass SqlAlchemyUserRepository(UserRepository):\n\n def __init__(self):\n # Do some db stuff here\n pass\n\n def add(self, user):\n # Do some db stuff here\n pass\n\ncontainer = Container()\ncontainer.register(UserRepository, InMemoryUserRepository)\n\n\nrepository = container.resolve(UserRepository) # This will return an InMemoryUserRepository\n\n```\n\n### Concrete Class\n\n```python\n\nclass ClientDependency:\n def get_int(self):\n return 10\n\nclass Client:\n def __init__(self, dep: ClientDependency):\n self.dep = dep\n\n def get_number(self):\n return self.dep.get_int()\n\n\ncontainer = Container()\ncontainer.register(ClientDependency)\ncontainer.register(Client)\n\nclient = container.resolve(Client)\n\nclient.get_number() # returns 10\n\n```\n\n### Factory\n\n```python\n\nclass ClientDependency:\n def get_int(self):\n return 10\n\nclass Client:\n def __init__(self, dep: ClientDependency):\n self.dep = dep\n\n def get_number(self):\n return self.dep.get_int()\n\ndef client_factory(dep: ClientDependency):\n return Client(dep=dep)\n\n\ncontainer = Container()\ncontainer.register(ClientDependency)\ncontainer.register(Client, factory=client_factory)\n\nclient = container.resolve(Client)\n\nclient.get_number() # returns 10\n\n```\n\n\n### Instance\n\n```python\n\nclass ClientDependency:\n def __init__(self, num):\n self.num = num\n\n def get_int(self):\n return self.num\n\nclass Client:\n def __init__(self, dep: ClientDependency):\n self.dep = dep\n\n def get_number(self):\n return self.dep.get_int()\n\nclient_dependency = ClientDependency(num=10)\n\ncontainer = Container()\ncontainer.register(ClientDependency, instance=client_dependency)\ncontainer.register(Client)\n\nclient = container.resolve(Client)\n\nclient.get_number() # returns 10\n\n```\n\n",
"bugtrack_url": null,
"license": null,
"summary": "An IOC Container for Python 3.10+",
"version": "1.18.0",
"project_urls": {
"Documentation": "https://peter-daly.github.io/clean_ioc/",
"Homepage": "https://peter-daly.github.io/clean_ioc/",
"Repository": "https://github.com/peter-daly/clean_ioc"
},
"split_keywords": [
"dependency",
" hints",
" injection",
" inversion of control",
" ioc",
" type",
" typing"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "be5928c08fcf6ed5f263509350613c0906d85b16d86e88f1dade2011d9d38c0d",
"md5": "2b9dce8e475bebd5eb84d6b91208b82d",
"sha256": "e3c34a5b433e1152b0b201c56f76b239a3481e9458c3090ad0a8b7c7643899f9"
},
"downloads": -1,
"filename": "clean_ioc-1.18.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2b9dce8e475bebd5eb84d6b91208b82d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "~=3.10",
"size": 22898,
"upload_time": "2025-07-30T20:42:33",
"upload_time_iso_8601": "2025-07-30T20:42:33.554945Z",
"url": "https://files.pythonhosted.org/packages/be/59/28c08fcf6ed5f263509350613c0906d85b16d86e88f1dade2011d9d38c0d/clean_ioc-1.18.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "374767f8cdae7cd53aa8963f5c72afa4c6d1a332bddaa536c2833a1e7e341a66",
"md5": "bc8dea63485c8413b1e7caead92c0b3c",
"sha256": "6ee6afa2dbe91abc8d2a4b6e134118ae1bd41b8001822e3a65b5e0945d1611c5"
},
"downloads": -1,
"filename": "clean_ioc-1.18.0.tar.gz",
"has_sig": false,
"md5_digest": "bc8dea63485c8413b1e7caead92c0b3c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "~=3.10",
"size": 19808,
"upload_time": "2025-07-30T20:42:34",
"upload_time_iso_8601": "2025-07-30T20:42:34.740125Z",
"url": "https://files.pythonhosted.org/packages/37/47/67f8cdae7cd53aa8963f5c72afa4c6d1a332bddaa536c2833a1e7e341a66/clean_ioc-1.18.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 20:42:34",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "peter-daly",
"github_project": "clean_ioc",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "clean_ioc"
}
JSON
