orionis 0.614.0__py3-none-any.whl → 0.615.0__py3-none-any.whl

orionis/foundation/application.py

@@ -28,24 +28,41 @@ from orionis.support.wrapper.dataclass import DataClass
 
 class Application(Container, IApplication):
     """
-    Main application container that manages the complete application lifecycle.
-
-    This class extends the Container to provide comprehensive application-level
-    functionality including service provider registration and bootstrapping, kernel
-    management, configuration handling, and application initialization. It implements
-    a fluent interface pattern to enable method chaining for configuration setup.
-
-    The Application class serves as the central orchestrator for the Orionis framework,
-    managing the loading and booting of service providers, framework kernels, and
-    various configuration subsystems such as authentication, caching, database,
-    logging, and more.
+    Application: Main container that manages the complete lifecycle of the Orionis application.
+
+    This class extends `Container` and acts as the central core of the Orionis framework,
+    orchestrating initialization, configuration, registration, and bootstrapping of all
+    application components and services. It follows a fluent interface pattern, enabling
+    method chaining for clear and concise configuration.
+
+    Key Responsibilities:
+    ---------------------
+    - Registers and boots both native and user-defined service providers, ensuring all
+        dependencies and services are available throughout the application lifecycle.
+    - Loads and manages essential framework kernels (CLI, testing, etc.), guaranteeing
+        that core components are properly initialized and accessible.
+    - Centralizes configuration management for all critical subsystems: authentication,
+        cache, database, logging, mail, queue, routing, storage, session, testing, and more.
+    - Provides methods for customizing and extending the application architecture,
+        supporting dynamic configurator loading and seamless integration of additional services.
+    - Implements mechanisms for custom exception handling and schedulers, enhancing
+        robustness and flexibility across the application lifecycle.
+    - Exposes utilities for accessing configuration and path settings using dot notation.
+
+    Typical Workflow:
+    -----------------
+    1. Instantiate the Application class.
+    2. Register providers and configurators via `withProviders` and `withConfigurators`.
+    3. Optionally customize exception handlers and schedulers.
+    4. Call `create()` to initialize and boot the application, loading kernels and providers.
+    5. Access services, configuration, and paths through the Application instance.
 
     Attributes
     ----------
     isBooted : bool
-        Read-only property indicating whether the application providers have been booted.
+            Read-only property indicating whether the application providers have been booted.
     startAt : int
-        Read-only property containing the timestamp when the application was started.
+            Read-only property containing the timestamp (epoch) when the application was started.
     """
 
     @property

orionis/metadata/framework.py

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

{orionis-0.614.0.dist-info → orionis-0.615.0.dist-info}/METADATA

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

{orionis-0.614.0.dist-info → orionis-0.615.0.dist-info}/RECORD

@@ -103,7 +103,7 @@ orionis/failure/contracts/handler.py,sha256=AeJfkJfD3hTkOIYAtADq6GnQfq-qWgDfUc7b
 orionis/failure/entities/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/failure/entities/throwable.py,sha256=1zD-awcuAyEtlR-L7V7ZIfPSF4GpXkf-neL5sXul7dc,1240
 orionis/foundation/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/application.py,sha256=zi-HJC0VrQET-dpO6pQdpm4vIgSkorLSKRsNv0p2G30,89309
+orionis/foundation/application.py,sha256=frdnW4Rt21_FEHDu89f47I-oi4sAKtzI8l9ebWRrRAk,90479
 orionis/foundation/config/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/foundation/config/startup.py,sha256=btqvryeIf9lLNQ9fBff7bJMrfraEY8qrWi4y_5YAR0Q,9681
 orionis/foundation/config/app/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -216,7 +216,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=IrPQJwvQVLRm5Qnz0Cxon4
 orionis/foundation/providers/testing_provider.py,sha256=eI1p2lUlxl25b5Z487O4nmqLE31CTDb4c3Q21xFadkE,1615
 orionis/foundation/providers/workers_provider.py,sha256=GdHENYV_yGyqmHJHn0DCyWmWId5xWjD48e6Zq2PGCWY,1674
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=uzNzXKaQrLGo5vxlsRvHfPC8A-y32VzSk3Es_r2yZlc,4109
+orionis/metadata/framework.py,sha256=F_AfLW-Z5lm23wlCAQmCM06TzhNf2QtNwzP0aS5BBGM,4109
 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
@@ -403,8 +403,8 @@ orionis/test/validators/workers.py,sha256=rWcdRexINNEmGaO7mnc1MKUxkHKxrTsVuHgbnI
 orionis/test/view/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/test/view/render.py,sha256=R55ykeRs0wDKcdTf4O1YZ8GDHTFmJ0IK6VQkbJkYUvo,5571
 orionis/test/view/report.stub,sha256=QLqqCdRoENr3ECiritRB3DO_MOjRQvgBh5jxZ3Hs1r0,28189
-orionis-0.614.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.614.0.dist-info/METADATA,sha256=IEifcfvwh-YqvRe-SQdeISs7_Ww8qYgk6-Cz4xy25wM,4801
-orionis-0.614.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.614.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.614.0.dist-info/RECORD,,
+orionis-0.615.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.615.0.dist-info/METADATA,sha256=11J6tAu_o4a4R0A_VnrK5wB2jWl_BN_08DY_iFWIHY4,4801
+orionis-0.615.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.615.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.615.0.dist-info/RECORD,,