feat: ✨ BlackSheep integration

Author: remimd

README.md

@@ -19,3 +19,4 @@ pip install python-injection
 * [**Basic usage**](documentation/basic-usage.md)
 * [**Advanced usage**](documentation/advanced-usage.md)
 * [**Utils**](documentation/utils.md)
+* [**Integrations**](documentation/integrations.md)

documentation/integrations.md

@@ -0,0 +1,32 @@
+# Integrations
+
+**Integrations make it easy to connect `python-injection` to other frameworks.**
+
+## [BlackSheep](https://github.com/Neoteroi/BlackSheep)
+
+_[See more](https://www.neoteroi.dev/blacksheep/dependency-injection) about BlackSheep and its dependency injection._
+
+Example:
+
+```python
+from blacksheep import Application
+from injection.integrations.blacksheep import InjectionServices
+
+app = Application(
+    services=InjectionServices(),
+)
+```
+
+Example with a custom injection module:
+
+```python
+from blacksheep import Application
+from injection import Module
+from injection.integrations.blacksheep import InjectionServices
+
+custom_module = Module(f"{__name__}:custom_module")
+
+app = Application(
+    services=InjectionServices(custom_module),
+)
+```

injection/integrations/__init__.py

@@ -0,0 +1,32 @@
+from typing import Any, TypeVar
+
+from injection import Module, default_module
+from injection.exceptions import NoInjectable
+
+_T = TypeVar("_T")
+
+
+class InjectionServices:
+    """
+    BlackSheep dependency injection container implemented with `python-injection`.
+    """
+
+    __slots__ = ("__module",)
+
+    def __init__(self, module: Module = default_module):
+        self.__module = module
+
+    def __contains__(self, cls: type | Any, /) -> bool:
+        return cls in self.__module
+
+    def register(self, cls: type | Any, *__args, **__kwargs):
+        self.__module.injectable(cls)
+        return self
+
+    def resolve(self, cls: type[_T] | Any, *__args, **__kwargs) -> _T:
+        instance = self.__module.get_instance(cls)
+
+        if instance is None:
+            raise NoInjectable(cls)
+
+        return instance

injection/integrations/blacksheep.py

@@ -14,9 +14,11 @@ python = ">=3.10, <4"
 
 [tool.poetry.group.dev.dependencies]
 black = "*"
+blacksheep = "^2.0.4"
 flake8 = "*"
 isort = "*"
 pytest = "*"
+pytest-asyncio = "*"
 pytest-cov = "*"
 
 [build-system]

poetry.lock

@@ -4,11 +4,6 @@ exclude_lines =
     raise NotImplementedError
 
 
-[coverage:run]
-omit =
-    __init__.py
-
-
 [flake8]
 max-line-length=88
 per-file-ignores =
@@ -23,4 +18,5 @@ profile=black
 [tool:pytest]
 python_files = test_*.py
 addopts = -p no:warnings --tb=short
+asyncio_mode = auto
 testpaths = tests/

pyproject.toml

@@ -0,0 +1,42 @@
+import pytest
+from blacksheep import Application, Response
+from blacksheep.server.controllers import APIController, post
+from blacksheep.testing import TestClient
+
+from injection import singleton
+from injection.integrations.blacksheep import InjectionServices
+
+application = Application(
+    services=InjectionServices(),
+)
+
+
+@singleton
+class Dependency:
+    ...
+
+
+class TestController(APIController):
+    def __init__(self, dependency: Dependency):
+        self.__dependency = dependency
+
+    @classmethod
+    def class_name(cls) -> str:
+        return "tests"
+
+    @post("/integration")
+    async def test_integration(self) -> Response:
+        assert isinstance(self.__dependency, Dependency)
+        return self.no_content()
+
+
+class TestBlackSheepIntegration:
+    @pytest.fixture(scope="class")
+    async def client(self) -> TestClient:
+        await application.start()
+        yield TestClient(application)
+        await application.stop()
+
+    async def test_blacksheep_integration_with_success(self, client):
+        response = await client.post("/api/tests/integration")
+        assert response.status == 204