hdmi 0.2.0__py3-none-any.whl → 0.2.2__py3-none-any.whl

hdmi/__init__.py

@@ -7,6 +7,8 @@ A lightweight dependency injection framework with:
 - Early error detection
 """
 
+__version__ = "0.2.2"
+
 from hdmi.builders import ContainerBuilder
 from hdmi.containers import Container, ScopedContainer
 from hdmi.types import IContainer, ServiceDefinition
@@ -18,12 +20,12 @@ from hdmi.exceptions import (
 )
 
 __all__ = [
+    "__version__",
     "CircularDependencyError",
     "Container",
     "ContainerBuilder",
     "HDMIError",
     "IContainer",
-    "IContainer",
     "ScopeViolationError",
     "ScopedContainer",
     "ServiceDefinition",

hdmi-0.2.2.dist-info/METADATA

@@ -0,0 +1,119 @@
+Metadata-Version: 2.4
+Name: hdmi
+Version: 0.2.2
+Summary: A dependency injection framework for Python with dynamic late-binding resolution
+Project-URL: Homepage, https://github.com/msqd/hdmi
+Project-URL: Documentation, https://hdmi.readthedocs.io/
+Project-URL: Repository, https://github.com/msqd/hdmi
+Project-URL: Issues, https://github.com/msqd/hdmi/issues
+Project-URL: Changelog, https://github.com/msqd/hdmi/blob/main/CHANGELOG.md
+Author-email: Romain Dorgueil <romain@makersquad.fr>
+License: MIT License
+        
+        Copyright (c) 2025 Romain Dorgueil
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: anyio>=4.0.0
+Provides-Extra: dev
+Requires-Dist: basedpyright>=1.21.0; extra == 'dev'
+Requires-Dist: furo>=2024.0.0; extra == 'dev'
+Requires-Dist: hatch>=1.16.2; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: sphinx-autobuild>=2024.0.0; extra == 'dev'
+Requires-Dist: sphinx>=8.0.0; extra == 'dev'
+Requires-Dist: sphinxcontrib-mermaid>=1.0.0; extra == 'dev'
+Requires-Dist: twine>=6.0.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# hdmi
+
+**A lightweight dependency injection framework for Python 3.13+ with type-driven discovery and scope validation.**
+
+[![PyPI version](https://img.shields.io/pypi/v/hdmi.svg)](https://pypi.python.org/pypi/hdmi)
+[![Python versions](https://img.shields.io/pypi/pyversions/hdmi.svg)](https://pypi.python.org/pypi/hdmi)
+[![CI](https://github.com/msqd/hdmi/actions/workflows/cicd.yml/badge.svg)](https://github.com/msqd/hdmi/actions/workflows/cicd.yml)
+[![Documentation](https://readthedocs.org/projects/hdmi/badge/?version=latest)](https://hdmi.readthedocs.io/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+> **Warning: Pre-Alpha Software**
+>
+> hdmi is experimental software in active development. Breaking changes may occur until version 1.0.
+
+**Documentation:** [Full Docs](https://hdmi.readthedocs.io/) | [Getting Started](https://hdmi.readthedocs.io/en/latest/tutorials/) | [API Reference](https://hdmi.readthedocs.io/en/latest/reference/)
+
+## Features
+
+- **Type-driven dependency discovery** — Uses Python's standard type annotations, no decorators needed
+- **Scope-aware validation** — Prevents lifetime bugs at container build time
+- **Lazy instantiation** — Services created just-in-time when first resolved
+- **Two-phase architecture** — Configuration separated from runtime for immutable, validated graphs
+
+## Quick Start
+
+```bash
+pip install hdmi
+```
+
+```python
+import asyncio
+from hdmi import ContainerBuilder
+
+class DatabaseConnection:
+    def __init__(self):
+        self.connected = True
+
+class UserRepository:
+    def __init__(self, db: DatabaseConnection):
+        self.db = db
+
+class UserService:
+    def __init__(self, repo: UserRepository):
+        self.repo = repo
+
+async def main():
+    builder = ContainerBuilder()
+    builder.register(DatabaseConnection)
+    builder.register(UserRepository)
+    builder.register(UserService)
+
+    container = builder.build()  # Validates the dependency graph
+    user_service = await container.get(UserService)  # Auto-wired!
+
+asyncio.run(main())
+```
+
+For scoped services (per-request lifecycles), transient services, and scope validation rules, see the [documentation](https://hdmi.readthedocs.io/).
+
+## Development
+
+This project follows strict TDD methodology. See [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+
+```bash
+make test    # Run all tests
+make docs    # Build documentation
+make help    # Show all available commands
+```
+
+## License
+
+MIT License — see [LICENSE](LICENSE) for details.

{hdmi-0.2.0.dist-info → hdmi-0.2.2.dist-info}/RECORD

@@ -1,16 +1,17 @@
-hdmi/__init__.py,sha256=bUVZmkoCG1PgkbS7XrwwXylowF56s7aS_mCA-yHDWu4,748
+hdmi/__init__.py,sha256=zK867wD6DvDWZ2Bn4_NnGg1x1teQSZj6M2PsHvf3XDQ,772
+hdmi/exceptions.py,sha256=lAaqSapQHzxuNXFJDuoFtAyDZYLIEAqdMGEp5xugmW8,1293
+hdmi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hdmi/builders/__init__.py,sha256=uN2EzCY9iFzmcxWrqikw5WDFvr_HuD2PxxYV3C43eKs,293
 hdmi/builders/default.py,sha256=Oyiz23IZs0Ks1rLYDZw2D6Sl-pQVxkJpcTwThIu7qHQ,10140
 hdmi/containers/__init__.py,sha256=TD8ReZks3E8CRaThWUzbZmZ4TleSmfMok_5njgNmyew,429
 hdmi/containers/default.py,sha256=jGbOU7a11p2NkWVja6tgBPb_Ngd3DOV-TP0GzhSs7Ds,9782
 hdmi/containers/scoped.py,sha256=c8OlWzQ2oiUxB1fQoB3kcSrGBX8pOw7l_Cg8QfaWzto,4415
-hdmi/exceptions.py,sha256=lAaqSapQHzxuNXFJDuoFtAyDZYLIEAqdMGEp5xugmW8,1293
-hdmi/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hdmi/types/__init__.py,sha256=uD9C8RExERfag1oq1JfiiHc88N54qvg4Lw6idV7pvMA,136
 hdmi/types/containers.py,sha256=pdEdu1QynRUDYhYz7h5EyGpB0H2FD8eCP0dXTKaLu5c,906
 hdmi/types/definitions.py,sha256=gqyhBneTex1efrAdBzn7R3bBU8YrOtoZE15cdmQFMTE,1802
 hdmi/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 hdmi/utils/typing.py,sha256=1JdUYZoE0SdX1jci0iGQLJkvBYodImoCQV8S_JcJvyw,1384
-hdmi-0.2.0.dist-info/WHEEL,sha256=iHtWm8nRfs0VRdCYVXocAWFW8ppjHL-uTJkAdZJKOBM,80
-hdmi-0.2.0.dist-info/METADATA,sha256=jOpv684i50C6OMUwvvvUlhdjcwHefvDCWktafcZyA-0,5858
-hdmi-0.2.0.dist-info/RECORD,,
+hdmi-0.2.2.dist-info/METADATA,sha256=EZ5JkvquUcb8xJmLq2DAtnwkBDDGdxbnvVzz2BDrnqY,4852
+hdmi-0.2.2.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+hdmi-0.2.2.dist-info/licenses/LICENSE,sha256=quAaDhvG1hdVv2ldCegF0EM_dZGLLmv9NT9RPIcMCmM,1072
+hdmi-0.2.2.dist-info/RECORD,,

{hdmi-0.2.0.dist-info → hdmi-0.2.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: uv 0.9.30
+Generator: hatchling 1.28.0
 Root-Is-Purelib: true
 Tag: py3-none-any

hdmi-0.2.2.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Romain Dorgueil
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

hdmi-0.2.0.dist-info/METADATA

@@ -1,183 +0,0 @@
-Metadata-Version: 2.3
-Name: hdmi
-Version: 0.2.0
-Summary: A dependency injection framework for Python with dynamic late-binding resolution
-Author: Romain Dorgueil
-Author-email: Romain Dorgueil <romain@makersquad.fr>
-License: MIT License
-         
-         Copyright (c) 2025 Romain Dorgueil
-         
-         Permission is hereby granted, free of charge, to any person obtaining a copy
-         of this software and associated documentation files (the "Software"), to deal
-         in the Software without restriction, including without limitation the rights
-         to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-         copies of the Software, and to permit persons to whom the Software is
-         furnished to do so, subject to the following conditions:
-         
-         The above copyright notice and this permission notice shall be included in all
-         copies or substantial portions of the Software.
-         
-         THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-         IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-         FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-         AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-         LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-         SOFTWARE.
-Requires-Dist: anyio>=4.0.0
-Requires-Dist: pytest>=8.0.0 ; extra == 'dev'
-Requires-Dist: pytest-cov>=4.1.0 ; extra == 'dev'
-Requires-Dist: ruff>=0.8.0 ; extra == 'dev'
-Requires-Dist: basedpyright>=1.21.0 ; extra == 'dev'
-Requires-Dist: sphinx>=8.0.0 ; extra == 'dev'
-Requires-Dist: sphinx-autobuild>=2024.0.0 ; extra == 'dev'
-Requires-Dist: furo>=2024.0.0 ; extra == 'dev'
-Requires-Dist: sphinxcontrib-mermaid>=1.0.0 ; extra == 'dev'
-Requires-Dist: twine>=6.0.0 ; extra == 'dev'
-Requires-Python: >=3.13
-Provides-Extra: dev
-Description-Content-Type: text/markdown
-
-# hdmi - Dependency Management Interface
-
-> **Warning: Pre-Alpha Software**
->
-> hdmi is experimental software in active development. Breaking changes may occur
-> until version 1.0. Use with care in production environments.
-
-A lightweight dependency injection framework for Python 3.13+ with:
-
-- **Type-driven dependency discovery** - Uses Python's standard type annotations
-- **Scope-aware validation** - Prevents lifetime bugs at build time
-- **Lazy instantiation** - Services created just-in-time
-- **Early error detection** - Configuration errors caught at build time
-
-## Quick Example
-
-### Simple Example (Singleton Services)
-
-```python
-import asyncio
-from hdmi import ContainerBuilder
-
-# Define your services
-class DatabaseConnection:
-    def __init__(self):
-        self.connected = True
-
-class UserRepository:
-    def __init__(self, db: DatabaseConnection):
-        self.db = db
-
-class UserService:
-    def __init__(self, repo: UserRepository):
-        self.repo = repo
-
-async def main():
-    # Configure the container (all singletons by default)
-    builder = ContainerBuilder()
-    builder.register(DatabaseConnection)
-    builder.register(UserRepository)
-    builder.register(UserService)
-
-    # Build validates the dependency graph
-    container = builder.build()
-
-    # Resolve services lazily - dependencies are auto-wired!
-    user_service = await container.get(UserService)
-
-asyncio.run(main())
-```
-
-### Using Scoped Services
-
-```python
-import asyncio
-from hdmi import ContainerBuilder
-
-async def main():
-    # For request-scoped services (e.g., web requests)
-    builder = ContainerBuilder()
-    builder.register(DatabaseConnection)  # singleton (default)
-    builder.register(UserRepository, scoped=True)  # One per request
-    builder.register(UserService, transient=True)   # New each time
-
-    container = builder.build()
-
-    # Scoped services must be resolved within a scope context
-    async with container.scope() as scoped:
-        user_service = await scoped.get(UserService)
-        # All scoped dependencies share the same instance within this scope
-
-asyncio.run(main())
-```
-
-## Key Features
-
-### Two-Phase Architecture
-
-1. **ContainerBuilder** (Configuration): Register services and define scopes
-2. **Container** (Runtime): Validated, immutable graph for lazy resolution
-
-### Scope Safety
-
-Services have four lifecycles that are validated at build time:
-
-- **Singleton** (default): One instance per container
-- **Scoped**: One instance per scope (e.g., per request)
-- **Transient**: New instance every time
-- **Scoped Transient**: New instance every time, requires scope
-
-**Validation Rules (Simplified):**
-The only invalid dependency is when a non-scoped service (singleton or transient) depends on a scoped service.
-
-```python
-# Valid: Scoped -> Singleton
-builder = ContainerBuilder()
-builder.register(DatabaseConnection)  # singleton (default)
-builder.register(UserRepository, scoped=True)
-
-# Invalid: Singleton -> Scoped (raises ScopeViolationError)
-builder = ContainerBuilder()
-builder.register(RequestHandler, scoped=True)
-builder.register(SingletonService)  # singleton depends on scoped!
-container = builder.build()  # ScopeViolationError!
-```
-
-### Type-Driven Dependencies
-
-Dependencies are automatically discovered from type annotations:
-
-```python
-class ServiceA:
-    def __init__(self, dep: DependencyType):
-        self.dep = dep
-```
-
-No decorators or manual wiring required!
-
-## Installation
-
-```bash
-pip install hdmi  # Coming soon
-```
-
-## Development
-
-This project uses [uv](https://github.com/astral-sh/uv) for dependency management and follows strict TDD methodology.
-
-```bash
-# Run all checks (linting, type checking, tests)
-make test
-
-# Build documentation
-make docs
-
-# See all available commands
-make help
-```
-
-## License
-
-MIT License - see LICENSE file for details.