Metadata-Version: 2.4
Name: forge-core-di
Version: 0.2.0
Summary: Lightweight Dependency Injection and Application Runtime Core for Python.
Project-URL: Homepage, https://github.com/akmallmline/forgecore
Project-URL: Repository, https://github.com/akmallmline/forgecore
Author-email: Akmal Maulana <akmallmline@gmail.com>
License: MIT
License-File: LICENSE
Keywords: application-kernel,autowiring,dependency-injection,di-container,framework,lifecycle,plugin,python
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Requires-Python: >=3.12
Description-Content-Type: text/markdown

# ForgeCore

Lightweight Dependency Injection and Application Runtime Core for Python.

ForgeCore is a framework engine — not just a DI container. It provides the
foundation for building web frameworks, CLI tools, bots, trading systems,
and AI agents in Python.

---

## Features

- Explicit DI container — no magic auto-registration
- Constructor autowiring via type hints
- Singleton, Transient, and Scoped lifecycles
- Thread-safe scoped instances via `threading.local()`
- Circular dependency detection with clear error messages
- Optional injection (`Cache | None = None`)
- Service binding — abstraction to implementation mapping
- Custom factory support
- Application kernel with boot pipeline
- Service provider system for modular registration
- Lifecycle hooks (`on_start`, `on_stop`)
- Event system with subscribe, emit, and unsubscribe
- Plugin system for runtime extension

---

## Requirements

- Python 3.12+

---

## Installation

```bash
pip install forgecore
