svcs-di 0.2.0__tar.gz

svcs_di-0.2.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.3
+Name: svcs-di
+Version: 0.2.0
+Summary: Dependency injection using svcs
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: svcs
+Requires-Python: >=3.14

svcs_di-0.2.0/pyproject.toml

@@ -0,0 +1,57 @@
+[project]
+name = "svcs-di"
+version = "0.2.0"
+description = "Dependency injection using svcs"
+requires-python = ">=3.14"
+dependencies = [
+    "svcs"
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3 :: Only",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Typing :: Typed",
+]
+
+[dependency-groups]
+dev = [
+    "coverage>=7.13.0",
+    "furo>=2025.12.19",
+    "linkify-it-py>=2.0.3",
+    "myst-parser",
+    "pyrefly>=0.46.1",
+    "pyright>=1.1.407",
+    "pytest>=8.4.2",
+    "pytest-cov>=4.1.0",
+    "pytest-run-parallel>=0.8.1",
+    "pytest-timeout>=2.4.0",
+    "pytest-xdist>=3.8.0",
+    "ruff>=0.14.10",
+    "sphinx>=8",
+    "sphinx-autobuild>=2025.8.25",
+    "sybil[pytest]>=8.4.2",
+    "ty>=0.0.6",
+]
+
+[tool.pytest.ini_options]
+testpaths = ["tests", "src"]
+python_files = ["test_*.py"]
+addopts = "-p no:doctest -m \"not slow\""
+pythonpath = ["examples"]
+markers = [
+    "slow: marks tests as slow (deselect with '-m \"not slow\"')",
+    "freethreaded: marks tests that verify free-threading compatibility",
+]
+# Free-threading safety: timeout tests to detect hangs/deadlocks
+timeout = 60
+faulthandler_timeout = 120
+
+[tool.ty.environment]
+extra-paths = ["examples/scanning"]
+
+[build-system]
+requires = ["uv_build>=0.8.17,<0.9.0"]
+build-backend = "uv_build"

svcs_di-0.2.0/src/svcs_di/__init__.py

@@ -0,0 +1,44 @@
+"""
+svcs-di: Minimal automatic dependency injection helper for svcs.
+
+This package provides a thin layer on top of svcs for automatic dependency
+resolution based on type hints, with explicit opt-in via the Inject[T] marker.
+
+Key exports:
+- auto: Factory function generator for automatic dependency injection
+- auto_async: Async factory function generator for async dependencies
+- Inject: Type marker for parameters that should be injected from container
+- Resource: Type marker for resource injection from HopscotchContainer
+- Injector: Protocol defining the injector interface
+- AsyncInjector: Protocol defining the async injector interface
+- DefaultInjector: Default synchronous injector implementation
+- DefaultAsyncInjector: Default asynchronous injector implementation
+- InjectionTarget: Type alias for class or callable targets (type[T] | Callable[..., T])
+- AsyncInjectionTarget: Type alias for async targets (type[T] | Callable[..., Awaitable[T]])
+"""
+
+from svcs_di.auto import (
+    AsyncInjectionTarget,
+    AsyncInjector,
+    DefaultAsyncInjector,
+    DefaultInjector,
+    Inject,
+    InjectionTarget,
+    Injector,
+    Resource,
+    auto,
+    auto_async,
+)
+
+__all__ = [
+    "auto",
+    "auto_async",
+    "Inject",
+    "Resource",
+    "Injector",
+    "AsyncInjector",
+    "DefaultInjector",
+    "DefaultAsyncInjector",
+    "InjectionTarget",
+    "AsyncInjectionTarget",
+]

svcs_di-0.2.0/src/svcs_di/_container_mixin.py

@@ -0,0 +1,77 @@
+"""
+Mixin providing shared inject/ainject methods for container classes.
+
+This module contains InjectorMixin which provides the core implementation
+for inject() and ainject() methods used by InjectorContainer and HopscotchContainer.
+"""
+
+from typing import Any
+
+from svcs_di.auto import AsyncInjector, Injector
+
+
+class InjectorMixin:
+    """
+    Mixin providing inject/ainject methods for containers.
+
+    This mixin provides _do_inject and _do_ainject methods that implement
+    the core injection logic. Subclasses should define their own inject()
+    and ainject() methods that delegate to these with appropriate injector_kwargs.
+
+    Attributes:
+        injector: The synchronous injector class to use.
+        async_injector: The asynchronous injector class to use.
+    """
+
+    injector: type[Injector] | None
+    async_injector: type[AsyncInjector] | None
+
+    def _do_inject[T](
+        self,
+        svc_type: type[T],
+        injector_kwargs: dict[str, Any],
+        **kwargs: Any,
+    ) -> T:
+        """
+        Core sync injection implementation.
+
+        Args:
+            svc_type: The service type to resolve.
+            injector_kwargs: Kwargs to pass to injector constructor (e.g., resource).
+            **kwargs: Kwargs to pass through to the target callable.
+
+        Returns:
+            The resolved service instance.
+
+        Raises:
+            ValueError: If no injector is configured.
+        """
+        if self.injector is None:
+            raise ValueError("Cannot inject without an injector configured")
+        return self.injector(container=self, **injector_kwargs)(svc_type, **kwargs)
+
+    async def _do_ainject[T](
+        self,
+        svc_type: type[T],
+        injector_kwargs: dict[str, Any],
+        **kwargs: Any,
+    ) -> T:
+        """
+        Core async injection implementation.
+
+        Args:
+            svc_type: The service type to resolve.
+            injector_kwargs: Kwargs to pass to injector constructor (e.g., resource).
+            **kwargs: Kwargs to pass through to the target callable.
+
+        Returns:
+            The resolved service instance.
+
+        Raises:
+            ValueError: If no async injector is configured.
+        """
+        if self.async_injector is None:
+            raise ValueError("Cannot inject without an async injector configured")
+        return await self.async_injector(container=self, **injector_kwargs)(
+            svc_type, **kwargs
+        )