prion 0.1.0__tar.gz

prion-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: prion
+Version: 0.1.0
+Summary: Dependency injection framework using pure Python
+Author: Geunryeol Park
+Author-email: Geunryeol Park <pkr5207@gmail.com>
+License-Expression: MIT
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# Prion
+
+A dependency injection framework using pure Python. No external dependencies.
+
+## Installation
+
+```sh
+pip install prion
+```
+
+## Usage
+
+Define a container by subclassing `Syringe` and declaring dependencies with `single()` or `factory()`.
+
+```pycon
+>>> from prion import Syringe, single, factory
+
+>>> class AppSyringe(Syringe):
+...     config: dict = single()
+...     session: dict = factory()
+
+```
+
+Create an instance and register providers using decorators.
+
+```pycon
+>>> syringe = AppSyringe()
+
+>>> @syringe.config
+... def create_config() -> dict:
+...     return {"debug": True}
+
+>>> @syringe.session
+... def create_session() -> dict:
+...     return {}
+
+```
+
+Access dependencies as attributes.
+
+```pycon
+>>> syringe.config is syringe.config
+True
+
+>>> syringe.session is not syringe.session
+True
+
+```
+
+## Strategies
+
+| Strategy    | Behavior                          |
+| ----------- | --------------------------------- |
+| `single()`  | Creates once, returns cached      |
+| `factory()` | Creates a new instance each time  |
+
+## License
+
+MIT

prion-0.1.0/README.md

@@ -0,0 +1,59 @@
+# Prion
+
+A dependency injection framework using pure Python. No external dependencies.
+
+## Installation
+
+```sh
+pip install prion
+```
+
+## Usage
+
+Define a container by subclassing `Syringe` and declaring dependencies with `single()` or `factory()`.
+
+```pycon
+>>> from prion import Syringe, single, factory
+
+>>> class AppSyringe(Syringe):
+...     config: dict = single()
+...     session: dict = factory()
+
+```
+
+Create an instance and register providers using decorators.
+
+```pycon
+>>> syringe = AppSyringe()
+
+>>> @syringe.config
+... def create_config() -> dict:
+...     return {"debug": True}
+
+>>> @syringe.session
+... def create_session() -> dict:
+...     return {}
+
+```
+
+Access dependencies as attributes.
+
+```pycon
+>>> syringe.config is syringe.config
+True
+
+>>> syringe.session is not syringe.session
+True
+
+```
+
+## Strategies
+
+| Strategy    | Behavior                          |
+| ----------- | --------------------------------- |
+| `single()`  | Creates once, returns cached      |
+| `factory()` | Creates a new instance each time  |
+
+## License
+
+MIT

prion-0.1.0/pyproject.toml

@@ -0,0 +1,29 @@
+[project]
+name = "prion"
+version = "0.1.0"
+description = "Dependency injection framework using pure Python"
+readme = "README.md"
+requires-python = ">=3.10"
+authors = [{name = "Geunryeol Park", email = "pkr5207@gmail.com"}]
+classifiers = [
+  "License :: OSI Approved :: MIT License",
+  "Programming Language :: Python",
+  "Topic :: Utilities"
+]
+license = "MIT"
+
+[build-system]
+requires = ["uv_build>=0.9.26,<0.10.0"]
+build-backend = "uv_build"
+
+[tool.uv]
+managed = true
+resolution = "highest"
+
+[tool.pytest.ini_options]
+addopts = ["--doctest-glob=*.md"]
+
+[dependency-groups]
+dev = [
+    "pytest>=9.0.2",
+]

prion-0.1.0/src/prion/__init__.py

@@ -0,0 +1,3 @@
+from prion.syringe import Syringe, factory, single
+
+__all__ = ["Syringe", "factory", "single"]

prion-0.1.0/src/prion/_internal/dependency.py

@@ -0,0 +1,52 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Any, Callable
+
+if TYPE_CHECKING:
+    from prion.syringe import Syringe
+
+
+class DependencyState:
+    __slots__ = ("_strategy", "_provider", "_value", "_resolved")
+
+    def __init__(self, strategy: str) -> None:
+        self._strategy = strategy
+        self._provider: Callable[..., Any] | None = None
+        self._value: Any = None
+        self._resolved = False
+
+    def __call__(self, provider: Callable[..., Any]) -> Callable[..., Any]:
+        self._provider = provider
+        return provider
+
+    def resolve(self) -> Any:
+        if self._provider is None:
+            raise RuntimeError("no provider registered for this dependency")
+        if self._strategy == "single":
+            if not self._resolved:
+                self._value = self._provider()
+                self._resolved = True
+            return self._value
+        return self._provider()
+
+
+class Dependency:
+    __slots__ = ("_strategy", "_attr")
+
+    def __init__(self, strategy: str) -> None:
+        self._strategy = strategy
+        self._attr: str = ""
+
+    def __set_name__(self, owner: type, name: str) -> None:
+        self._attr = name
+
+    def __get__(self, obj: Syringe | None, objtype: type | None = None) -> Any:
+        if obj is None:
+            return self
+        state = obj._dependencies.get(self._attr)
+        if state is None:
+            state = DependencyState(self._strategy)
+            obj._dependencies[self._attr] = state
+        if state._provider is None:
+            return state
+        return state.resolve()

prion-0.1.0/src/prion/syringe.py

@@ -0,0 +1,19 @@
+from __future__ import annotations
+
+from typing import Any
+
+from prion._internal.dependency import Dependency, DependencyState
+
+
+class Syringe:
+
+    def __init__(self) -> None:
+        self._dependencies: dict[str, DependencyState] = {}
+
+
+def single() -> Any:
+    return Dependency("single")
+
+
+def factory() -> Any:
+    return Dependency("factory")