pico-ioc 0.2.0__py3-none-any.whl → 0.3.0__py3-none-any.whl

pico_ioc/__init__.py

@@ -1,7 +1,6 @@
-# src/pico_ioc/__init__.py
-
-import functools, inspect, pkgutil, importlib, logging, sys
-from typing import Callable, Any, Iterator, Optional, AsyncIterator
+import functools, inspect, pkgutil, importlib, logging
+from typing import Callable, Any, Optional
+from contextvars import ContextVar
 
 try:
     # written at build time by setuptools-scm
@@ -11,6 +10,15 @@ except Exception:  # pragma: no cover
 
 __all__ = ["__version__"]
 
+# ------------------------------------------------------------------------------
+# Re-entrancy guards
+# ------------------------------------------------------------------------------
+# True while init/scan is running. Blocks userland container access during scan.
+_scanning: ContextVar[bool] = ContextVar("pico_scanning", default=False)
+
+# True while the container is resolving deps for a component (internal use allowed).
+_resolving: ContextVar[bool] = ContextVar("pico_resolving", default=False)
+
 # ==============================================================================
 # --- 1. Container and Chameleon Proxy (Framework-Agnostic) ---
 # ==============================================================================
@@ -26,6 +34,16 @@ class PicoContainer:
         return key in self._providers or key in self._singletons
 
     def get(self, key: Any) -> Any:
+        # Forbid user code calling container.get() while the scanner is importing modules.
+        # Allow only internal calls performed during dependency resolution.
+        if _scanning.get() and not _resolving.get():
+            raise RuntimeError(
+                "pico-ioc: re-entrant container access during scan. "
+                "Avoid calling init()/get() at import time (e.g., in a module body). "
+                "Move resolution to runtime (e.g., under if __name__ == '__main__':) "
+                "or delay it until pico-ioc init completes."
+            )
+
         if key in self._singletons:
             return self._singletons[key]
         if key in self._providers:
@@ -143,13 +161,17 @@ def _resolve_param(container: PicoContainer, p: inspect.Parameter) -> Any:
     if p.name == 'self' or p.kind in (inspect.Parameter.VAR_POSITIONAL, inspect.Parameter.VAR_KEYWORD):
         raise RuntimeError("Invalid param for resolution")
 
+    # 1) NAME
     if container.has(p.name):
         return container.get(p.name)
 
     ann = p.annotation
+
+    # 2) TYPE
     if ann is not inspect._empty and container.has(ann):
         return container.get(ann)
 
+    # 3) TYPE MRO
     if ann is not inspect._empty:
         try:
             for base in getattr(ann, "__mro__", ())[1:]:
@@ -160,10 +182,11 @@ def _resolve_param(container: PicoContainer, p: inspect.Parameter) -> Any:
         except Exception:
             pass
 
+    # 4) str(NAME)
     if container.has(str(p.name)):
         return container.get(str(p.name))
 
-    key = p.name if not (ann and ann is not inspect._empty) else ann
+    key = p.name if ann is inspect._empty else ann
     return container.get(key)
 
 
@@ -175,21 +198,22 @@ def _scan_and_configure(
     package = importlib.import_module(package_or_name) if isinstance(package_or_name, str) else package_or_name
     logging.info(f"🚀 Scanning in '{package.__name__}'...")
     component_classes, factory_classes = [], []
+
     for _, name, _ in pkgutil.walk_packages(package.__path__, package.__name__ + '.'):
-        # Skip excluded modules (used by auto_exclude_caller and custom excludes)
         if exclude and exclude(name):
             logging.info(f"  ⏭️ Skipping module {name} (excluded)")
             continue
         try:
             module = importlib.import_module(name)
             for _, obj in inspect.getmembers(module, inspect.isclass):
-                if hasattr(obj, '_is_component'):
+                if getattr(obj, '_is_component', False):
                     component_classes.append(obj)
-                elif hasattr(obj, '_is_factory_component'):
+                elif getattr(obj, '_is_factory_component', False):
                     factory_classes.append(obj)
         except Exception as e:
             logging.warning(f"  ⚠️ Module {name} not processed: {e}")
 
+    # Register factories
     for factory_cls in factory_classes:
         try:
             sig = inspect.signature(factory_cls.__init__)
@@ -200,28 +224,39 @@ def _scan_and_configure(
         except Exception as e:
             logging.error(f"  ❌ Error in factory {factory_cls.__name__}: {e}", exc_info=True)
 
+    # Register components
     for component_cls in component_classes:
         key = getattr(component_cls, '_component_key', component_cls)
+
         def create_component(cls=component_cls):
             sig = inspect.signature(cls.__init__)
             deps = {}
-            for p in sig.parameters.values():
-                if p.name == 'self' or p.kind in (inspect.Parameter.VAR_POSITIONAL, inspect.Parameter.VAR_KEYWORD):
-                    continue
-                deps[p.name] = _resolve_param(container, p)
+            tok = _resolving.set(True)
+            try:
+                for p in sig.parameters.values():
+                    if p.name == 'self' or p.kind in (inspect.Parameter.VAR_POSITIONAL, inspect.Parameter.VAR_KEYWORD):
+                        continue
+                    deps[p.name] = _resolve_param(container, p)
+            finally:
+                _resolving.reset(tok)
             return cls(**deps)
+
         container.bind(key, create_component)
 
 _container = None
 
 def init(root_package, *, exclude: Optional[Callable[[str], bool]] = None, auto_exclude_caller: bool = True):
+    """
+    Initialize the global container and scan the given root package/module.
+    While scanning, re-entrant userland access to container.get() is blocked
+    to avoid import-time side effects.
+    """
     global _container
     if _container:
         return _container
 
     combined_exclude = exclude
     if auto_exclude_caller:
-        # módulo que invoca a init()
         try:
             caller_frame = inspect.stack()[1].frame
             caller_module = inspect.getmodule(caller_frame)
@@ -240,7 +275,13 @@ def init(root_package, *, exclude: Optional[Callable[[str], bool]] = None, auto_
 
     _container = PicoContainer()
     logging.info("🔌 Initializing 'pico-ioc'...")
-    _scan_and_configure(root_package, _container, exclude=combined_exclude)
+
+    tok = _scanning.set(True)
+    try:
+        _scan_and_configure(root_package, _container, exclude=combined_exclude)
+    finally:
+        _scanning.reset(tok)
+
     logging.info("✅ Container configured and ready.")
     return _container
 
@@ -252,19 +293,26 @@ def factory_component(cls):
     return cls
 
 def provides(key: Any, *, lazy: bool = True):
+    """
+    Declare that a factory method provides a component under 'key'.
+    By default, returns a LazyProxy that instantiates upon first real use.
+    """
     def decorator(func):
         @functools.wraps(func)
         def wrapper(*args, **kwargs):
             return LazyProxy(lambda: func(*args, **kwargs)) if lazy else func(*args, **kwargs)
-        # mantenemos compat con _provides_name (por si alguien lo usa)
-        setattr(wrapper, '_provides_name', key)
+        setattr(wrapper, '_provides_name', key)  # legacy-compatible storage
         return wrapper
     return decorator
 
 def component(cls=None, *, name: str = None):
-    def decorator(cls):
-        setattr(cls, '_is_component', True)
-        setattr(cls, '_component_key', name if name is not None else cls)
-        return cls
+    """
+    Mark a class as a component. Registered by class type by default,
+    or by 'name' if provided.
+    """
+    def decorator(c):
+        setattr(c, '_is_component', True)
+        setattr(c, '_component_key', name if name is not None else c)
+        return c
     return decorator(cls) if cls else decorator
 

pico_ioc/_version.py

@@ -1 +1 @@
-__version__ = '0.2.0'
+__version__ = '0.3.0'

{pico_ioc-0.2.0.dist-info → pico_ioc-0.3.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pico-ioc
-Version: 0.2.0
+Version: 0.3.0
 Summary: A minimalist, zero-dependency Inversion of Control (IoC) container for Python.
 Author-email: David Perez Cabrera <dperezcabrera@gmail.com>
 Project-URL: Homepage, https://github.com/dperezcabrera/pico-ioc
@@ -226,8 +226,3 @@ tox -e py311
 ## 📜 License
 
 MIT — see [LICENSE](https://opensource.org/licenses/MIT)
-
----
-
-¿Quieres que también te prepare **un ejemplo completo en el README** con `fast_model` y `BaseChatModel` para que quede documentado el nuevo orden de resolución? Así quedaría clarísimo para cualquiera que lo use.
-

pico_ioc-0.3.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+pico_ioc/__init__.py,sha256=wCgi07l_0ZqhgZRfoRgWld_Q3_0qkqazUPWsO0XbPQI,13474
+pico_ioc/_version.py,sha256=3wVEs2QD_7OcTlD97cZdCeizd2hUbJJ0GeIO8wQIjrk,22
+pico_ioc-0.3.0.dist-info/METADATA,sha256=nzmDf0ZLTn0OkaoYDytJDnPQstVgVf2ExGZv0nMs15g,6374
+pico_ioc-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+pico_ioc-0.3.0.dist-info/top_level.txt,sha256=_7_RLu616z_dtRw16impXn4Mw8IXe2J4BeX5912m5dQ,9
+pico_ioc-0.3.0.dist-info/RECORD,,

pico_ioc-0.2.0.dist-info/RECORD

@@ -1,6 +0,0 @@
-pico_ioc/__init__.py,sha256=JkCWRwZb_Mv86Q6gI7wJnsFuKWh0A0B7u-uuAfyeF6Y,11781
-pico_ioc/_version.py,sha256=FVHPBGkfhbQDi_z3v0PiKJrXXqXOx0vGW_1VaqNJi7U,22
-pico_ioc-0.2.0.dist-info/METADATA,sha256=CgJTdTIs1-MeabncD7fl9sez6t5a41jdYVea8qUDKOY,6599
-pico_ioc-0.2.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-pico_ioc-0.2.0.dist-info/top_level.txt,sha256=_7_RLu616z_dtRw16impXn4Mw8IXe2J4BeX5912m5dQ,9
-pico_ioc-0.2.0.dist-info/RECORD,,