engin 0.0.16__py3-none-any.whl → 0.0.17__py3-none-any.whl

engin/_assembler.py

@@ -228,7 +228,7 @@ class Assembler:
         yield from (
             child_provider
             for root_provider in root_providers
-            for root_provider_param in root_provider.parameter_types
+            for root_provider_param in root_provider.parameter_type_ids
             for child_provider in self._resolve_providers(root_provider_param)
         )
         yield from root_providers

engin/_cli/_graph.py

@@ -165,7 +165,7 @@ def _render_node(node: Dependency, render_block: bool = True) -> str:
         md += f"{_short_name(node.return_type_id)}"
         return f'{node_id}["`{md}`"]{style}'
     if isinstance(node, Entrypoint):
-        entrypoint_type = node.parameter_types[0]
+        entrypoint_type = node.parameter_type_ids[0]
         md += f"{entrypoint_type}"
         return f'{node_id}[/"`{md}`"\\]{style}'
     if isinstance(node, Invoke):

engin/_dependency.py

@@ -76,7 +76,7 @@ class Dependency(ABC, Option, Generic[P, T]):
             return f"{self._func.__module__}.{self._func.__name__}"
 
     @property
-    def parameter_types(self) -> list[TypeId]:
+    def parameter_type_ids(self) -> list[TypeId]:
         parameters = list(self._signature.parameters.values())
         if not parameters:
             return []
@@ -136,7 +136,7 @@ class Entrypoint(Invoke):
         super().__init__(invocation=_noop)
 
     @property
-    def parameter_types(self) -> list[TypeId]:
+    def parameter_type_ids(self) -> list[TypeId]:
         return [TypeId.from_type(self._type)]
 
     @property
@@ -153,7 +153,12 @@ class Entrypoint(Invoke):
 
 class Provide(Dependency[Any, T]):
     def __init__(
-        self, builder: Func[P, T], *, scope: str | None = None, override: bool = False
+        self,
+        builder: Func[P, T],
+        *,
+        scope: str | None = None,
+        as_type: type | None = None,
+        override: bool = False,
     ) -> None:
         """
         Provide a type via a builder or factory function.
@@ -161,19 +166,26 @@ class Provide(Dependency[Any, T]):
         Args:
             builder: the builder function that returns the type.
             scope: (optional) associate this provider with a specific scope.
-            override: (optional) allow this provider to override existing providers from
-                the same package.
+            as_type: (optional) allows you to explicitly specify the provided type, e.g.
+                to type erase a concrete type, or to provide a mock implementation.
+            override: (optional) allow this provider to override other providers for the
+                same type from the same package.
         """
         super().__init__(func=builder)
         self._scope = scope
         self._override = override
+        self._explicit_type = as_type
+
+        if self._explicit_type is not None:
+            self._signature = self._signature.replace(return_annotation=self._explicit_type)
+
         self._is_multi = typing.get_origin(self.return_type) is list
 
         # Validate that the provider does to depend on its own output value, as this will
         # cause a recursion error and is undefined behaviour wise.
         if any(
             self.return_type == param.annotation
-            for param in self.signature.parameters.values()
+            for param in self._signature.parameters.values()
         ):
             raise ValueError("A provider cannot depend on its own return type")
 
@@ -187,6 +199,8 @@ class Provide(Dependency[Any, T]):
 
     @property
     def return_type(self) -> type[T]:
+        if self._explicit_type is not None:
+            return self._explicit_type
         if isclass(self._func):
             return_type = self._func  # __init__ returns self
         else:
@@ -253,23 +267,19 @@ class Supply(Provide, Generic[T]):
         function.
 
         Args:
-            value: the value to Supply
-            as_type: allows you to specify the provided type, useful for type erasing,
-              e.g. Supply a concrete value but specify it as an interface or other
-              abstraction.
-            override: allow this provider to override existing providers from the same
-              package.
+            value: the value to Supply.
+            as_type: (optional) allows you to explicitly specify the provided type, e.g.
+              to type erase a concrete type, or to provide a mock implementation.
+            override: (optional) allow this provider to override other providers for the
+              same type from the same package.
         """
         self._value = value
-        self._type_hint = as_type
-        if self._type_hint is not None:
-            self._get_val.__annotations__["return"] = as_type
-        super().__init__(builder=self._get_val, override=override)
+        super().__init__(builder=self._get_val, as_type=as_type, override=override)
 
     @property
     def return_type(self) -> type[T]:
-        if self._type_hint is not None:
-            return self._type_hint
+        if self._explicit_type is not None:
+            return self._explicit_type
         if isinstance(self._value, list):
             return list[type(self._value[0])]  # type: ignore[misc,return-value]
         return type(self._value)

engin/_graph.py

@@ -31,7 +31,7 @@ class DependencyGrapher:
     ) -> list[Node]:
         nodes: list[Node] = []
         for root in roots:
-            for parameter in root.parameter_types:
+            for parameter in root.parameter_type_ids:
                 provider = self._providers[parameter]
 
                 # multiprovider

engin/ext/fastapi.py

@@ -75,7 +75,7 @@ class _FastAPIDependencyGrapher(DependencyGrapher):
     ) -> list[Node]:
         nodes: list[Node] = []
         for root in roots:
-            for parameter in root.parameter_types:
+            for parameter in root.parameter_type_ids:
                 provider = self._providers[parameter]
 
                 # multiprovider
@@ -162,7 +162,7 @@ class APIRouteDependency(Dependency):
         return self._route
 
     @property
-    def parameter_types(self) -> list[TypeId]:
+    def parameter_type_ids(self) -> list[TypeId]:
         parameters = list(self._signature.parameters.values())
         if not parameters:
             return []

{engin-0.0.16.dist-info → engin-0.0.17.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: engin
-Version: 0.0.16
+Version: 0.0.17
 Summary: An async-first modular application framework
 Project-URL: Homepage, https://github.com/invokermain/engin
 Project-URL: Documentation, https://engin.readthedocs.io/en/latest/

{engin-0.0.16.dist-info → engin-0.0.17.dist-info}/RECORD

@@ -1,10 +1,10 @@
 engin/__init__.py,sha256=rBTteMLAVKg4TJSaMElJUwz72BA_X7nBTREg-I-bWhA,584
-engin/_assembler.py,sha256=8rt16LGvPpXHtjSdEDQJ6XC6DVwSbr_4_Mcfcfnpf70,10949
+engin/_assembler.py,sha256=r2Vr9UO7pHYvj71087PIJYT9lFBNPni3x34MtjMHN7A,10952
 engin/_block.py,sha256=8ysWrmHkWpTm6bmSc6jZVoO0Ax5Svu1HwxpZwAtIF_o,2617
-engin/_dependency.py,sha256=KM_d4TEu7NaoOSuIC7lRO7UvPzBFb0sxR74ZbInLMng,8561
+engin/_dependency.py,sha256=5x4_0QvHtqv6R_brKHRc-INKE4oMh1JU8-9RCmulp4Q,8976
 engin/_engin.py,sha256=yIpZdeqvm8hv0RxOV0veFuvyu9xQ054JSaeuUWwHdOQ,7380
 engin/_exceptions.py,sha256=UzMppJWDk_Hx3qWAypcPVLw9OYCibqiZjLYeTl22zaE,1355
-engin/_graph.py,sha256=1pMB0cr--uS0XJycDb1rS_X45RBpoyA6NkKqbeSuz1Q,1628
+engin/_graph.py,sha256=y1g7Lm_Zy5GPEgRsggCKV5DDaDzcwUl8v3IZCK8jyGI,1631
 engin/_introspect.py,sha256=VdREX6Lhhga5SnEP9G7mjHkgJR4mpqk_SMnmL2zTcqY,966
 engin/_lifecycle.py,sha256=cSWe3euZkmpxmUPFvph2lsTtvuZbxttEfBL-RnOI7lo,5325
 engin/_option.py,sha256=nZcdrehp1QwgxMUoIpsM0PJuu1q1pbXzhcVsetbsHpc,223
@@ -12,13 +12,13 @@ engin/_type_utils.py,sha256=Pmm4m1_WdevT5KTe8tzY_BseNxPyhu_nKsLGgyNcPpo,2247
 engin/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 engin/_cli/__init__.py,sha256=lp1KiBpcgk_dZU5V9DjgLPwmp0ja444fwLH2CYCscNc,302
 engin/_cli/_graph.html,sha256=rR5dnDKoz7KtSff0ERCi2UKuoH_Z03MRYiXI_W03G5k,2430
-engin/_cli/_graph.py,sha256=2v-l5rEC4zm36SWgmzQ2UK-nIHofYpexTo3et55AtE0,5539
+engin/_cli/_graph.py,sha256=YZ0awBLtWD5W6xrHO9ueMnk_EIsYM4_j_bmquiLsb2Y,5542
 engin/_cli/_utils.py,sha256=AQFtLO8qjYRCTQc9A8Z1HVf7eZr8iGWogxbYzsgIkS4,360
 engin/ext/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 engin/ext/asgi.py,sha256=d5Z6gtMVWDZdAlvrTaMt987sKyiq__A0X4gJQ7IETmA,3247
-engin/ext/fastapi.py,sha256=e8UV521Mq9Iqr55CT7_jtd51iaIZjWlAacoqFBXsh-k,6356
-engin-0.0.16.dist-info/METADATA,sha256=1-9KPa3HdnKUM38_OD3yAdNHHTb4-cOBds8dlqedv9s,2354
-engin-0.0.16.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-engin-0.0.16.dist-info/entry_points.txt,sha256=sW247zZUMxm0b5UKYvPuqQQljYDtU-j2zK3cu7gHwM0,41
-engin-0.0.16.dist-info/licenses/LICENSE,sha256=XHh5LPUPKZWTBqBv2xxN2RU7D59nHoiJGb5RIt8f45w,1070
-engin-0.0.16.dist-info/RECORD,,
+engin/ext/fastapi.py,sha256=TGNf0LFLaTLMLlAycH7GgP_GcBld262v9xboGOwhvgE,6362
+engin-0.0.17.dist-info/METADATA,sha256=1SUQZwsFr3neO0WJ_gLLv90kgJCcBNUbwWWi2zZZ77Q,2354
+engin-0.0.17.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+engin-0.0.17.dist-info/entry_points.txt,sha256=sW247zZUMxm0b5UKYvPuqQQljYDtU-j2zK3cu7gHwM0,41
+engin-0.0.17.dist-info/licenses/LICENSE,sha256=XHh5LPUPKZWTBqBv2xxN2RU7D59nHoiJGb5RIt8f45w,1070
+engin-0.0.17.dist-info/RECORD,,