dioxide 0.0.2a1__cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64.whl

dioxide-0.0.2a1.dist-info/METADATA

@@ -0,0 +1,324 @@
+Metadata-Version: 2.4
+Name: dioxide
+Version: 0.0.2a1
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Dist: maturin>=1.0,<2.0 ; extra == 'dev'
+Requires-Dist: pytest>=8.0 ; extra == 'dev'
+Requires-Dist: pytest-cov>=4.1 ; extra == 'dev'
+Requires-Dist: behave>=1.2.6 ; extra == 'dev'
+Requires-Dist: mypy>=1.8 ; extra == 'dev'
+Requires-Dist: ruff>=0.1 ; extra == 'dev'
+Requires-Dist: isort>=5.13 ; extra == 'dev'
+Requires-Dist: tox>=4.0 ; extra == 'dev'
+Requires-Dist: pre-commit>=3.0 ; extra == 'dev'
+Provides-Extra: dev
+License-File: LICENSE
+Summary: Fast, Rust-backed declarative dependency injection for Python
+Keywords: dependency-injection,di,ioc,rust,container
+Author-email: Mike Lane <mikelane@gmail.com>
+License: MIT
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/mikelane/dioxide
+Project-URL: Repository, https://github.com/mikelane/dioxide
+Project-URL: Issues, https://github.com/mikelane/dioxide/issues
+
+# dioxide
+
+**Fast, Rust-backed declarative dependency injection for Python**
+
+[![CI](https://github.com/mikelane/dioxide/workflows/CI/badge.svg)](https://github.com/mikelane/dioxide/actions)
+[![Release](https://github.com/mikelane/dioxide/actions/workflows/release-automated.yml/badge.svg)](https://github.com/mikelane/dioxide/actions/workflows/release-automated.yml)
+[![PyPI version](https://badge.fury.io/py/dioxide.svg)](https://pypi.org/project/dioxide/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/dioxide.svg)](https://pypi.org/project/dioxide/)
+[![Platform Support](https://img.shields.io/badge/platform-Linux%20%7C%20macOS%20%7C%20Windows-blue)](https://github.com/mikelane/dioxide)
+[![Architecture](https://img.shields.io/badge/arch-x86__64%20%7C%20aarch64-green)](https://github.com/mikelane/dioxide)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+---
+
+## Overview
+
+`dioxide` is a dependency injection framework for Python that combines:
+
+- **Declarative Python API** - Simple decorators and type hints
+- **Rust-backed performance** - Fast graph construction and resolution via PyO3
+- **Type safety** - Full support for mypy and type checkers
+- **Clean architecture** - Encourages loose coupling and testability
+
+## Installation
+
+```bash
+pip install dioxide
+```
+
+### Platform Support
+
+| Platform | x86_64 | ARM64/aarch64 |
+|----------|--------|---------------|
+| Linux    | ✅     | ✅            |
+| macOS    | ✅     | ✅ (M1/M2/M3) |
+| Windows  | ✅     | ❌            |
+
+**Python Versions**: 3.11, 3.12, 3.13, 3.14
+
+## Status
+
+**⚠️ ALPHA**: dioxide is in active alpha development. API changes expected between releases.
+
+- **Latest Release**: [v0.0.1-alpha](https://github.com/mikelane/dioxide/releases/tag/v0.0.1-alpha) (Nov 6, 2025) - Published to Test PyPI
+- **Current Work**: v0.0.2-alpha - MLP API Realignment (breaking changes)
+- **Next Milestone**: v0.1.0-beta - MLP Complete (API freeze) - Mid-December 2025
+
+See [ROADMAP.md](ROADMAP.md) for detailed timeline and [Issues](https://github.com/mikelane/dioxide/issues) for current work.
+
+## Vision
+
+**Make the Dependency Inversion Principle feel inevitable.**
+
+dioxide exists to make clean architecture (ports-and-adapters) the path of least resistance. We combine:
+
+1. **Type-safe DI** - If mypy passes, the wiring is correct
+2. **Profile-based implementations** - Swap PostgreSQL ↔ in-memory with one line
+3. **Testing without mocks** - Fast fakes at the seams, not mock behavior
+4. **Rust-backed performance** - Fast graph operations and resolution
+
+See [MLP_VISION.md](docs/MLP_VISION.md) for the complete design philosophy.
+
+## Quick Start
+
+**⚠️ Note**: API examples show **target MLP syntax** (v0.1.0-beta). Current v0.0.1-alpha uses different syntax. See [CHANGELOG.md](CHANGELOG.md) for migration guide.
+
+```python
+from dioxide import container, component, profile
+from typing import Protocol
+
+# Define a protocol (the seam)
+class EmailProvider(Protocol):
+    async def send(self, to: str, subject: str, body: str) -> None: ...
+
+# Production implementation
+@component.implements(EmailProvider)
+@profile.production
+class SendGridEmail:
+    async def send(self, to: str, subject: str, body: str) -> None:
+        # Real SendGrid API call
+        pass
+
+# Test/dev implementation
+@component.implements(EmailProvider)
+@profile("test", "development")
+class FakeEmail:
+    def __init__(self):
+        self.outbox = []
+
+    async def send(self, to: str, subject: str, body: str) -> None:
+        self.outbox.append({"to": to, "subject": subject})
+
+# Business logic depends on protocol, not implementation
+@component
+class NotificationService:
+    def __init__(self, email: EmailProvider):
+        self.email = email
+
+    async def send_welcome(self, user_email: str) -> None:
+        await self.email.send(user_email, "Welcome!", "Thanks for signing up!")
+
+# Scan and activate profile
+container.scan("app", profile="production")  # or "test" for testing
+
+# Use services directly (dependencies auto-injected)
+service = NotificationService()
+await service.send_welcome("user@example.com")
+```
+
+**Key features**:
+- `@component` for singleton components (shared across app)
+- `@component.factory` for per-request components (new instance each time)
+- `@profile` to swap implementations by environment
+- Global singleton container (no manual instantiation)
+- Constructor injection via type hints
+
+## Features
+
+### v0.0.1-alpha ✅ RELEASED (Nov 6, 2025)
+- [x] `@component` decorator for auto-discovery
+- [x] Container.scan() for automatic registration
+- [x] Constructor dependency injection
+- [x] SINGLETON and FACTORY scopes
+- [x] Manual provider registration
+- [x] Type-safe Container.resolve() with mypy support
+- [x] 100% test coverage
+- [x] Full CI/CD automation
+
+### v0.0.2-alpha 🔄 IN PROGRESS (MLP API Realignment)
+- [x] `@component.implements(Protocol)` syntax - ✅ Issue #66
+- [x] `@profile` decorator system (hybrid approach) - ✅ Issue #68
+- [ ] `@component.factory` attribute syntax - Issue #65
+- [ ] `container.scan()` with package and profile parameters - Issue #69
+- [x] Global singleton container pattern - ✅ Issue #70
+- [ ] Documentation realignment
+- [x] Optional: `container[Type]` syntax - ✅ Issue #70
+
+### v0.1.0-beta 🎯 TARGET: Mid-December 2025 (MLP Complete)
+- [ ] Lifecycle protocols (`Initializable`, `Disposable`)
+- [ ] Circular dependency detection at startup
+- [ ] Excellent error messages with suggestions
+- [ ] Complete example application
+- [ ] FastAPI integration example
+- [ ] Testing guide (fakes > mocks philosophy)
+- [ ] API frozen (no breaking changes until 2.0)
+
+### Post-MLP Features (v0.2.0+)
+See [ROADMAP.md](ROADMAP.md) for post-MLP features:
+- Request scoping
+- Property injection
+- Framework integrations (FastAPI, Flask, Django)
+- Developer tooling (CLI, IDE plugins)
+
+## Development
+
+### Prerequisites
+
+- Python 3.11+
+- Rust 1.70+
+- [uv](https://github.com/astral-sh/uv) for Python package management
+- [maturin](https://github.com/PyO3/maturin) for building Rust extensions
+
+### Setup
+
+```bash
+# Clone the repository
+git clone https://github.com/mikelane/dioxide.git
+cd dioxide
+
+# Install dependencies with uv
+uv venv
+source .venv/bin/activate  # or `.venv\Scripts\activate` on Windows
+uv pip install -e ".[dev]"
+
+# Build the Rust extension
+maturin develop
+
+# Run tests
+pytest
+
+# Run all quality checks
+tox
+```
+
+### Development Workflow
+
+```bash
+# Format code
+tox -e format
+
+# Lint
+tox -e lint
+
+# Type check
+tox -e type
+
+# Run tests for all Python versions
+tox
+
+# Run tests with coverage
+tox -e cov
+
+# Mutation testing
+tox -e mutate
+```
+
+### Pre-commit Hooks
+
+Install pre-commit hooks to ensure code quality:
+
+```bash
+pre-commit install
+```
+
+## Architecture
+
+```
+dioxide/
+├── python/dioxide/       # Python API
+│   ├── __init__.py
+│   ├── container.py       # Main Container class
+│   ├── decorators.py      # @component decorator
+│   └── scope.py           # Scope enum
+├── rust/src/              # Rust core
+│   └── lib.rs             # PyO3 bindings and graph logic
+├── tests/                 # Python tests
+└── pyproject.toml         # Project configuration
+```
+
+### Key Design Decisions
+
+1. **Rust for graph operations** - Dependency graphs can get complex; Rust's performance and safety help scale
+2. **Python-first API** - Developers work in pure Python; Rust is an implementation detail
+3. **Type hints as the contract** - Leverage Python's type system for DI metadata
+4. **Explicit over implicit** - Registration is manual to avoid surprises
+5. **Test-driven development** - Every feature starts with failing tests
+
+## Comparison to Other Frameworks
+
+| Feature | dioxide | dependency-injector | injector |
+|---------|----------|---------------------|----------|
+| Type-based DI | ✅ | ✅ | ✅ |
+| Rust-backed | ✅ | ❌ | ❌ |
+| Scopes | ✅ | ✅ | ✅ |
+| Lifecycle | ✅ | ✅ | ❌ |
+| Cycle detection | ✅ (planned) | ❌ | ❌ |
+| Performance* | 🚀 (goal) | ⚡ | ⚡ |
+
+*Benchmarks coming in v0.2
+
+## Contributing
+
+Contributions are welcome! We follow a strict workflow to maintain code quality:
+
+**Quick start for contributors:**
+1. **Create or find an issue** - All work must be associated with a GitHub issue
+2. **Fork the repository** (external contributors)
+3. **Create a feature branch** with issue reference (e.g., `fix/issue-123-description`)
+4. **Follow TDD** - Write tests first, then implementation
+5. **Submit a Pull Request** - All changes must go through PR review
+
+**Key requirements:**
+- ✅ All work must have an associated GitHub issue
+- ✅ All changes must go through the Pull Request process
+- ✅ Tests and documentation are mandatory
+- ✅ Branch protection enforces these requirements on `main`
+
+Please see [CONTRIBUTING.md](CONTRIBUTING.md) for detailed guidelines.
+
+See [ROADMAP.md](ROADMAP.md) for the complete product roadmap and [MLP_VISION.md](docs/MLP_VISION.md) for the design philosophy.
+
+## License
+
+MIT License - see [LICENSE](LICENSE) for details.
+
+## Acknowledgments
+
+- Inspired by [dependency-injector](https://github.com/ets-labs/python-dependency-injector) and Spring Framework
+- Built with [PyO3](https://github.com/PyO3/pyo3) and [maturin](https://github.com/PyO3/maturin)
+- Graph algorithms powered by [petgraph](https://github.com/petgraph/petgraph)
+
+---
+
+**⚠️ Alpha Status**: dioxide is in active alpha development. Breaking API changes expected until v0.1.0-beta (mid-December 2025), when the API will freeze. Not recommended for production use yet.
+
+**MLP Timeline**:
+- **Now**: v0.0.2-alpha - API realignment with MLP Vision
+- **Dec 2025**: v0.1.0-beta - MLP Complete, API frozen ✨
+- **2026+**: Post-MLP features, ecosystem growth, 1.0 stable
+

dioxide-0.0.2a1.dist-info/RECORD

@@ -0,0 +1,12 @@
+dioxide-0.0.2a1.dist-info/METADATA,sha256=PcH2k84VXd_J08Uxt_riN_cafe4S1T9uZabk91rAg-A,11245
+dioxide-0.0.2a1.dist-info/WHEEL,sha256=Xj3Gekq9LGV-pOsH0xOV_xZAidS_kmiR2iwGc6yWrnY,130
+dioxide-0.0.2a1.dist-info/licenses/LICENSE,sha256=JpEmJvRYOTIUt0UjgvpDrd3U94Wnbt_Grr5z-xU2jtk,1066
+dioxide/__init__.py,sha256=VCnC7vekY2D_FLtCkNpiiws0qMpx9e4Wle2Ul5L_VxE,1523
+dioxide/_dioxide_core.abi3.so,sha256=WxmhZzvj8hwXyu0pDn5r6j9FJAEaQP3NZY7V91LcTmE,381792
+dioxide/_dioxide_core.pyi,sha256=IkVCY_MBiU6UBX09V1mI3yAdrMEw00qGg1NE5uIspf0,702
+dioxide/container.py,sha256=dxda4yPDUefPcSJnx02Xa3vTZnNypul-GntFDJAUm1A,25485
+dioxide/decorators.py,sha256=JVqPWCSnOXVYUOzb2wY2S5fCBuMtcRWlXRNhKYacwAQ,8798
+dioxide/profile.py,sha256=0MY9h92iAZ88kyPbMd8aNV4AAuiJlDQX5cZ-A0ZzFQM,6759
+dioxide/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+dioxide/scope.py,sha256=xRKDoUz8OzBRgLpXj2lk_Nir0F7aPnJFI1eMY2mgeOg,2358
+dioxide-0.0.2a1.dist-info/RECORD,,

dioxide-0.0.2a1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.9.6)
+Root-Is-Purelib: false
+Tag: cp311-abi3-manylinux_2_17_aarch64.manylinux2014_aarch64

dioxide-0.0.2a1.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Mike Lane
+
+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.