pico-ioc 1.0.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

pico_ioc/_version.py

@@ -1 +1 @@
-__version__ = '1.0.0'
+__version__ = '1.1.0'

pico_ioc/api.py

@@ -3,7 +3,7 @@
 import inspect
 import logging
 from contextlib import contextmanager
-from typing import Callable, Optional, Tuple
+from typing import Callable, Optional, Tuple, Any, Dict  # ⬅️ Any, Dict
 
 from .container import PicoContainer, Binder
 from .plugins import PicoPlugin
@@ -24,14 +24,14 @@ def init(
     auto_exclude_caller: bool = True,
     plugins: Tuple[PicoPlugin, ...] = (),
     reuse: bool = True,
+    overrides: Optional[Dict[Any, Any]] = None,  # ⬅️ NUEVO
 ) -> PicoContainer:
-    """
-    Initialize and configure a PicoContainer by scanning a root package.
-    """
+
     root_name = root_package if isinstance(root_package, str) else getattr(root_package, "__name__", None)
 
-    # Reuse only if the existing container was built for the same root
     if reuse and _state._container and _state._root_name == root_name:
+        if overrides:
+            _apply_overrides(_state._container, overrides)
         return _state._container
 
     combined_exclude = _build_exclude(exclude, auto_exclude_caller, root_name=root_name)
@@ -48,6 +48,9 @@ def init(
             plugins=plugins,
         )
 
+    if overrides:
+        _apply_overrides(container, overrides)
+
     _run_hooks(plugins, "after_bind", container, binder)
     _run_hooks(plugins, "before_eager", container, binder)
 
@@ -57,22 +60,32 @@ def init(
 
     logging.info("Container configured and ready.")
     _state._container = container
-    _state._root_name = root_name  # remember which root this container represents
+    _state._root_name = root_name
     return container
 
 
 # -------------------- helpers --------------------
 
+def _apply_overrides(container: PicoContainer, overrides: Dict[Any, Any]) -> None:
+    for key, val in overrides.items():
+        lazy = False
+        if isinstance(val, tuple) and len(val) == 2 and callable(val[0]) and isinstance(val[1], bool):
+            provider = val[0]
+            lazy = val[1]
+        elif callable(val):
+            provider = val
+        else:
+            def provider(v=val):
+                return v
+        container.bind(key, provider, lazy=lazy)
+
+
 def _build_exclude(
     exclude: Optional[Callable[[str], bool]],
     auto_exclude_caller: bool,
     *,
     root_name: Optional[str] = None,
 ) -> Optional[Callable[[str], bool]]:
-    """
-    Compose the exclude predicate. When auto_exclude_caller=True, exclude only
-    the exact calling module, but never exclude modules under the root being scanned.
-    """
     if not auto_exclude_caller:
         return exclude
 
@@ -91,7 +104,6 @@ def _build_exclude(
 
 
 def _get_caller_module_name() -> Optional[str]:
-    """Return the module name that called `init`."""
     try:
         f = inspect.currentframe()
         # frame -> _get_caller_module_name -> _build_exclude -> init

pico_ioc/container.py

@@ -28,6 +28,9 @@ class PicoContainer:
         self._singletons: Dict[Any, Any] = {}
 
     def bind(self, key: Any, provider, *, lazy: bool):
+        # 🔧 rebind must evict any cached singleton for this key
+        self._singletons.pop(key, None)
+
         meta = {"factory": provider, "lazy": bool(lazy)}
         try:
             q = getattr(key, QUALIFIERS_KEY, ())

{pico_ioc-1.0.0.dist-info → pico_ioc-1.1.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pico-ioc
-Version: 1.0.0
+Version: 1.1.0
 Summary: A minimalist, zero-dependency Inversion of Control (IoC) container for Python.
 Author-email: David Perez Cabrera <dperezcabrera@gmail.com>
 License: MIT License
@@ -72,6 +72,7 @@ It helps you build loosely-coupled, testable apps without manual wiring. Inspire
 - **Plugins** — lifecycle hooks (`before_scan`, `after_ready`).
 - **Public API helper** — auto-export decorated symbols in `__init__.py`.
 - **Thread/async safe** — isolation via `ContextVar`.
+- **Overrides for testing** — inject mocks/fakes directly via `init(overrides={...})`.
 
 ---
 
@@ -117,7 +118,21 @@ print(svc.run())
 ```
 fetching from sqlite:///demo.db
 ```
+---
+
+### Quick overrides for testing
+
+```python
+from pico_ioc import init
+import myapp
 
+fake = {"repo": "fake-data"}
+c = init(myapp, overrides={
+    "fast_model": fake,                  # constant instance
+    "user_service": lambda: {"id": 1},   # provider
+})
+assert c.get("fast_model") == {"repo": "fake-data"}
+```
 ---
 
 ## 📖 Documentation
@@ -137,6 +152,12 @@ tox
 
 ---
 
+## 📜 Changelog
+
+See [CHANGELOG.md](./CHANGELOG.md) for version history.
+
+---
+
 ## 📜 License
 
 MIT — see [LICENSE](https://opensource.org/licenses/MIT)

{pico_ioc-1.0.0.dist-info → pico_ioc-1.1.0.dist-info}/RECORD

@@ -1,8 +1,8 @@
 pico_ioc/__init__.py,sha256=7EyifZ02LFfhkAR6zzAaQJvByyMI2_-qNrw49gPoJkA,633
 pico_ioc/_state.py,sha256=KHNtdPrv1s-uynfot2IsNkWotBPyORPCcM2xe9qMMPo,286
-pico_ioc/_version.py,sha256=RsZjRjMprNcDm97wqRRSk6rTLgTX8N0GyicZyZ8OsBQ,22
-pico_ioc/api.py,sha256=pvzAx725UG5Z6TPqQqiWdfytb0ddk26-cxnkTJRaK8o,3648
-pico_ioc/container.py,sha256=81Jys4Ipu57B4pM5xQuq48S5oEhuKin7Y8vEERg-4_4,5085
+pico_ioc/_version.py,sha256=b6-WiVk0Li5MaV2rBnHYl104TsouINojSWKqHDas0js,22
+pico_ioc/api.py,sha256=pInjKJ1oi8bM4N0u4T3XLFa2qmYiHpQ7omcdXFFkGmE,3928
+pico_ioc/container.py,sha256=oyCCeiPFVx7qw51IR9_ReuccInnpYMNuYhKxOKsioYE,5193
 pico_ioc/decorators.py,sha256=gNPxLFNEdFUFYlxILKjU76XyoPohediK0DNiv-RpK3I,1902
 pico_ioc/plugins.py,sha256=JbI-28VLGJaik7ysXi3L-YGTGxhqwJH4W5QYuWSruDE,589
 pico_ioc/proxy.py,sha256=-e3Z9z7Bc_2wxswwUJI_s8AfvCTps8f8RWUJ9RuEp7E,4606
@@ -10,8 +10,8 @@ pico_ioc/public_api.py,sha256=E3sArCoI1xxkIw7xQBvLYAWcIoVJjcq1s0kH-0qIVDE,2383
 pico_ioc/resolver.py,sha256=PN5uq2dFEStAzzTEl0n4AEyC-k7TowqCu7-uwIDDgEk,3897
 pico_ioc/scanner.py,sha256=-iOj_qX15IBFmOAFQlP_1rIkBfamGzdqYdvIPOvq7sY,7709
 pico_ioc/typing_utils.py,sha256=JQ4bkR60pKxFs3f8JlEz41ruKDsWj-SmkKv3DLJriec,950
-pico_ioc-1.0.0.dist-info/licenses/LICENSE,sha256=N1_nOvHTM6BobYnOTNXiQkroDqCEi6EzfGBv8lWtyZ0,1077
-pico_ioc-1.0.0.dist-info/METADATA,sha256=CZqjp3KYScMMGV25CGrAnDVj37ZbGw3BD9eWC9tjOxw,5434
-pico_ioc-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pico_ioc-1.0.0.dist-info/top_level.txt,sha256=_7_RLu616z_dtRw16impXn4Mw8IXe2J4BeX5912m5dQ,9
-pico_ioc-1.0.0.dist-info/RECORD,,
+pico_ioc-1.1.0.dist-info/licenses/LICENSE,sha256=N1_nOvHTM6BobYnOTNXiQkroDqCEi6EzfGBv8lWtyZ0,1077
+pico_ioc-1.1.0.dist-info/METADATA,sha256=9tZ6dAnCgwLxD2GinaNb3U0FsCTPHTmicJxk9YsFY18,5920
+pico_ioc-1.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pico_ioc-1.1.0.dist-info/top_level.txt,sha256=_7_RLu616z_dtRw16impXn4Mw8IXe2J4BeX5912m5dQ,9
+pico_ioc-1.1.0.dist-info/RECORD,,