pico-ioc 2.0.1__tar.gz → 2.0.2__tar.gz

{pico_ioc-2.0.1 → pico_ioc-2.0.2}/CHANGELOG.md

@@ -89,6 +89,32 @@ This version marks a significant redesign and the first major public release, es
 - Encourages a lighter, more Pythonic style for simple provider declarations.
 
 
+---
+
+## [2.0.2] - 2025-10-26
+
+### Fixed 🧩
+
+* **`@provides` Decorator Execution**
+  Corrected an issue where the `@provides` decorator executed its wrapped function prematurely during module import, leading to runtime errors like `TypeError: Service() takes no arguments`.
+  The decorator now properly registers provider metadata without invoking the function until dependency resolution time.
+
+### Added ✨
+
+* **`FlatDictSource` Configuration Provider**
+  Introduced a lightweight configuration source for flat in-memory dictionaries.
+  Supports optional key prefixing and case sensitivity control for simple, programmatic configuration injection.
+
+### Internal 🔧
+
+* Updated type imports and registration logic in `api.py` to support `Mapping` for the new configuration source.
+* Added `FlatDictSource` to the public API (`__all__` and import namespace).
+
+### Notes 📝
+
+* Fully backward compatible.
+* This patch release focuses on decorator correctness and configuration flexibility improvements.
+
 ---
 
 ## [<2.0.0]

{pico_ioc-2.0.1 → pico_ioc-2.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pico-ioc
-Version: 2.0.1
+Version: 2.0.2
 Summary: A minimalist, zero-dependency Inversion of Control (IoC) container for Python.
 Author-email: David Perez Cabrera <dperezcabrera@gmail.com>
 License: MIT License

{pico_ioc-2.0.1 → pico_ioc-2.0.2}/src/pico_ioc/__init__.py

@@ -23,6 +23,7 @@ from .api import (
     ConfigSource,
     EnvSource,
     FileSource,
+    FlatDictSource,
     init,
     configured,
 )
@@ -76,6 +77,7 @@ __all__ = [
     "EnvSource",
     "FileSource",
     "ConfigSource",
+    "FlatDictSource",
     "init",
     "configured",
     "EventBus",

pico_ioc-2.0.2/src/pico_ioc/_version.py

@@ -0,0 +1 @@
+__version__ = '2.0.2'

{pico_ioc-2.0.1 → pico_ioc-2.0.2}/src/pico_ioc/api.py

@@ -6,7 +6,7 @@ import importlib
 import pkgutil
 import logging
 from dataclasses import is_dataclass, fields, dataclass, MISSING
-from typing import Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Union, get_args, get_origin, Annotated, Protocol
+from typing import Any, Callable, Dict, Iterable, List, Optional, Set, Tuple, Union, get_args, get_origin, Annotated, Protocol, Mapping
 from .constants import LOGGER, PICO_INFRA, PICO_NAME, PICO_KEY, PICO_META
 from .exceptions import (
     ProviderNotFoundError,
@@ -54,6 +54,31 @@ class FileSource:
             return str(v)
         return None
 
+class FlatDictSource(ConfigSource):
+    def __init__(self, data: Mapping[str, Any], prefix: str = "", case_sensitive: bool = True):
+        base = dict(data)
+        if case_sensitive:
+            self._data = {str(k): v for k, v in base.items()}
+            self._prefix = prefix
+        else:
+            self._data = {str(k).upper(): v for k, v in base.items()}
+            self._prefix = prefix.upper()
+        self._case_sensitive = case_sensitive
+
+    def get(self, key: str) -> Optional[str]:
+        if not key:
+            return None
+        k = f"{self._prefix}{key}" if self._prefix else key
+        if not self._case_sensitive:
+            k = k.upper()
+        v = self._data.get(k)
+        if v is None:
+            return None
+        if isinstance(v, (str, int, float, bool)):
+            return str(v)
+        return None
+
+
 def _meta_get(obj: Any) -> Dict[str, Any]:
     m = getattr(obj, PICO_META, None)
     if m is None:
@@ -132,29 +157,21 @@ def factory(
         return c
     return dec(cls) if cls else dec
 
-def provides(
-    key: Any,
-    *,
-    name: Any = None,
-    qualifiers: Iterable[str] = (),
-    scope: str = "singleton",
-    primary: bool = False,
-    lazy: bool = False,
-    conditional_profiles: Iterable[str] = (),
-    conditional_require_env: Iterable[str] = (),
-    conditional_predicate: Optional[Callable[[], bool]] = None,
-    on_missing_selector: Optional[object] = None,
-    on_missing_priority: int = 0,
-):
-    def dec(fn):
+def provides(*dargs, **dkwargs):
+    def _apply(fn, key_hint, *, name=None, qualifiers=(), scope="singleton", primary=False, lazy=False, conditional_profiles=(), conditional_require_env=(), conditional_predicate=None, on_missing_selector=None, on_missing_priority=0):
         target = fn.__func__ if isinstance(fn, (staticmethod, classmethod)) else fn
-        @functools.wraps(target)
-        def w(*a, **k):
-            return target(*a, **k)
-        setattr(w, PICO_INFRA, "provides")
-        setattr(w, PICO_NAME, name if name is not None else key)
-        setattr(w, PICO_KEY, key)
-        m = _meta_get(w)
+        inferred_key = key_hint
+        if inferred_key is MISSING:
+            rt = _get_return_type(target)
+            if isinstance(rt, type):
+                inferred_key = rt
+            else:
+                inferred_key = getattr(target, "__name__", str(target))
+        setattr(target, PICO_INFRA, "provides")
+        pico_name = name if name is not None else (inferred_key if isinstance(inferred_key, str) else getattr(target, "__name__", str(target)))
+        setattr(target, PICO_NAME, pico_name)
+        setattr(target, PICO_KEY, inferred_key)
+        m = _meta_get(target)
         m["qualifier"] = tuple(str(q) for q in qualifiers or ())
         m["scope"] = scope
         if primary:
@@ -169,8 +186,16 @@ def provides(
             }
         if on_missing_selector is not None:
             m["on_missing"] = {"selector": on_missing_selector, "priority": int(on_missing_priority)}
-        return w
-    return dec
+        return fn
+
+    if dargs and len(dargs) == 1 and inspect.isfunction(dargs[0]) and not dkwargs:
+        fn = dargs[0]
+        return _apply(fn, MISSING)
+    else:
+        key = dargs[0] if dargs else MISSING
+        def _decorator(fn):
+            return _apply(fn, key, **dkwargs)
+        return _decorator
 
 class Qualifier(str):
     __slots__ = ()

{pico_ioc-2.0.1 → pico_ioc-2.0.2}/src/pico_ioc.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pico-ioc
-Version: 2.0.1
+Version: 2.0.2
 Summary: A minimalist, zero-dependency Inversion of Control (IoC) container for Python.
 Author-email: David Perez Cabrera <dperezcabrera@gmail.com>
 License: MIT License

pico_ioc-2.0.1/src/pico_ioc/_version.py

@@ -1 +0,0 @@
-__version__ = '2.0.1'