orionis 0.449.0__py3-none-any.whl → 0.450.0__py3-none-any.whl

orionis/container/container.py

@@ -1,22 +1,12 @@
 import threading
-from typing import Any, Callable
+from typing import Any, Callable, Optional
 from orionis.container.context.manager import ScopeManager
 from orionis.container.contracts.container import IContainer
 from orionis.container.entities.binding import Binding
 from orionis.container.enums.lifetimes import Lifetime
 from orionis.container.exceptions import OrionisContainerException
 from orionis.container.resolver.resolver import Resolver
-from orionis.container.validators import (
-    ImplementsAbstractMethods,
-    IsAbstractClass,
-    IsCallable,
-    IsConcreteClass,
-    IsInstance,
-    IsNotSubclass,
-    IsSubclass,
-    IsValidAlias,
-    LifetimeValidator
-)
+from orionis.container.validators import *
 from orionis.services.introspection.abstract.reflection import ReflectionAbstract
 from orionis.services.introspection.callables.reflection import ReflectionCallable
 
@@ -71,6 +61,7 @@ class Container(IContainer):
             # This write is protected by the lock, ensuring memory visibility
             cls._instances[cls] = instance
 
+            # Return the newly created instance
             return instance
 
     def __init__(self) -> None:
@@ -106,7 +97,7 @@ class Container(IContainer):
         *,
         alias: str = None,
         enforce_decoupling: bool = False
-    ) -> bool:
+    ) -> Optional[bool]:
         """
         Registers a service with a transient lifetime.
 
@@ -192,7 +183,7 @@ class Container(IContainer):
         *,
         alias: str = None,
         enforce_decoupling: bool = False
-    ) -> bool:
+    ) -> Optional[bool]:
         """
         Registers a service with a singleton lifetime.
 
@@ -275,7 +266,7 @@ class Container(IContainer):
         *,
         alias: str = None,
         enforce_decoupling: bool = False
-    ) -> bool:
+    ) -> Optional[bool]:
         """
         Registers a service with a scoped lifetime.
 
@@ -358,7 +349,7 @@ class Container(IContainer):
         *,
         alias: str = None,
         enforce_decoupling: bool = False
-    ) -> bool:
+    ) -> Optional[bool]:
         """
         Registers an instance of a class or interface in the container.
         Parameters
@@ -438,7 +429,7 @@ class Container(IContainer):
         fn: Callable[..., Any],
         *,
         lifetime: Lifetime = Lifetime.TRANSIENT
-    ) -> bool:
+    ) -> Optional[bool]:
         """
         Registers a function or factory under a given alias.
 
@@ -527,21 +518,54 @@ class Container(IContainer):
     def getBinding(
         self,
         abstract_or_alias: Any
-    ) -> Binding:
+    ) -> Optional[Binding]:
         """
         Retrieves the binding for the requested abstract type or alias.
 
+        This method performs a lookup in the container's internal binding dictionaries
+        to find the binding associated with the provided abstract type or alias.
+        It first searches in the primary bindings dictionary, then in the aliases
+        dictionary if no direct binding is found.
+
         Parameters
         ----------
         abstract_or_alias : Any
-            The abstract class, interface, or alias (str) to retrieve.
+            The abstract class, interface, or alias (str) to retrieve the binding for.
+            This can be either a class type or a string alias that was registered
+            with the container.
 
         Returns
         -------
-        Binding
-            The binding associated with the requested abstract type or alias.
+        Binding or None
+            The binding object associated with the requested abstract type or alias.
+            Returns None if no binding is found for the provided abstract_or_alias.
+            The binding contains information about the service registration including
+            the concrete implementation, lifetime, and other configuration details.
+
+        Notes
+        -----
+        The method searches in the following order:
+        1. Direct lookup in the bindings dictionary using the abstract type
+        2. Lookup in the aliases dictionary using the provided alias
+
+        This method does not raise exceptions for missing bindings; it returns None
+        instead, allowing the caller to handle the absence of a binding appropriately.
         """
-        return self.__bindings.get(abstract_or_alias) or self.__aliasses.get(abstract_or_alias)
+
+        # First, attempt to find the binding directly using the abstract type
+        # This handles cases where the service was registered with its abstract class
+        binding = self.__bindings.get(abstract_or_alias)
+        if binding:
+            return binding
+
+        # If no direct binding found, search in the aliases dictionary
+        # This handles cases where the service is being requested by its alias
+        binding = self.__aliasses.get(abstract_or_alias)
+        if binding:
+            return binding
+
+        # Return None if no binding is found for the requested abstract type or alias
+        return None
 
     def drop(
         self,

orionis/container/context/scope.py

@@ -6,7 +6,7 @@ class ScopedContext:
     """
 
     _active_scope = contextvars.ContextVar(
-        "orionis_context_scope",
+        "x-orionis-container-context-scope",
         default=None
     )
 

orionis/metadata/framework.py

@@ -5,7 +5,7 @@
 NAME = "orionis"
 
 # Current version of the framework
-VERSION = "0.449.0"
+VERSION = "0.450.0"
 
 # Full name of the author or maintainer of the project
 AUTHOR = "Raul Mauricio Uñate Castro"

{orionis-0.449.0.dist-info → orionis-0.450.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: orionis
-Version: 0.449.0
+Version: 0.450.0
 Summary: Orionis Framework – Elegant, Fast, and Powerful.
 Home-page: https://github.com/orionis-framework/framework
 Author: Raul Mauricio Uñate Castro

{orionis-0.449.0.dist-info → orionis-0.450.0.dist-info}/RECORD

@@ -36,10 +36,10 @@ orionis/console/output/contracts/executor.py,sha256=7l3kwnvv6GlH9EYk0v94YE1olex_
 orionis/console/output/enums/__init__.py,sha256=LAaAxg-DpArCjf_jqZ0_9s3p8899gntDYkSU_ppTdC8,66
 orionis/console/output/enums/styles.py,sha256=6a4oQCOBOKMh2ARdeq5GlIskJ3wjiylYmh66tUKKmpQ,4053
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/container/container.py,sha256=ICKSeaXA_IL15jV6Ofe1wIb1QyX-F-8oaGuk7hj955I,22773
+orionis/container/container.py,sha256=cF9iu-Q8CMllnDTTL8DnJBcr40GgET6SG2ITnzirWDI,24366
 orionis/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/context/manager.py,sha256=I08K_jKXSKmrq18Pv33qYyMKIlAovVOwIgmfiVm-J7c,2971
-orionis/container/context/scope.py,sha256=_qwGMLV_zPVEvxESY18PCY8FS7AsSg_NlflwWGyOYOw,1143
+orionis/container/context/scope.py,sha256=p_oCzR7dDz-5ZAd16ab4vfLc3gBf34CaN0f4iR9D0bQ,1155
 orionis/container/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/container/contracts/container.py,sha256=QV_seo8mKrZJG2Ytr2u0RSiRaTaSPw6zUxgJ_tq6oP4,8301
 orionis/container/contracts/resolver.py,sha256=cbzzLvUuv5FD8DHnjs8VGCjDnCHXPWezRPHS_qr93xs,3193
@@ -181,7 +181,7 @@ orionis/foundation/providers/progress_bar_provider.py,sha256=X4Ke7mPr0MgVp6WDNaQ
 orionis/foundation/providers/testing_provider.py,sha256=YTubcNnWrG3SPx5NM5HgYefvUYoXdlzXcjljnjavUwM,6462
 orionis/foundation/providers/workers_provider.py,sha256=5CvlUETdIblh7Wx8pT0MswTeTCGhYah-EvFqOrLu8Mo,4113
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=0G9f0nfa5xLDZkU7zSFNtjf5kUF9WlHCUBWupRMxfbI,4088
+orionis/metadata/framework.py,sha256=SwwdGkSoqfg2mdA0GAeC1WFurIhx9-TS526fHUrN7AU,4088
 orionis/metadata/package.py,sha256=k7Yriyp5aUcR-iR8SK2ec_lf0_Cyc-C7JczgXa-I67w,16039
 orionis/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/services/asynchrony/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -347,7 +347,7 @@ orionis/test/validators/web_report.py,sha256=n9BfzOZz6aEiNTypXcwuWbFRG0OdHNSmCNu
 orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnIfJYgc,1206
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=f-zNhtKSg9R5Njqujbg2l2amAs2-mRVESneLIkWOZjU,4082
-orionis-0.449.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.450.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 tests/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -491,8 +491,8 @@ tests/testing/validators/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 tests/testing/validators/test_testing_validators.py,sha256=WPo5GxTP6xE-Dw3X1vZoqOMpb6HhokjNSbgDsDRDvy4,16588
 tests/testing/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/testing/view/test_render.py,sha256=tnnMBwS0iKUIbogLvu-7Rii50G6Koddp3XT4wgdFEYM,1050
-orionis-0.449.0.dist-info/METADATA,sha256=Kia9-lqn-tR4K7i-mUN6aGDnKF4936Dx7PVc6G80tcE,4772
-orionis-0.449.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.449.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.449.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.449.0.dist-info/RECORD,,
+orionis-0.450.0.dist-info/METADATA,sha256=yCYH8b-NPXkXb-GpHWqk9jBq5yC5FGXbxk0pvDUmVqI,4772
+orionis-0.450.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.450.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.450.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.450.0.dist-info/RECORD,,