orionis 0.506.0__py3-none-any.whl → 0.507.0__py3-none-any.whl

orionis/app.py

@@ -2,16 +2,18 @@ from orionis.foundation.application import Application, IApplication
 
 def Orionis() -> IApplication:
     """
-    Initialize and return the main Orionis application instance.
+    Creates and returns the main Orionis application instance.
 
-    Initializes the core application object that implements the `IApplication` interface.
-    This function acts as the entry point for creating and accessing the main application instance.
+    This function initializes the core application object that implements the `IApplication` interface.
+    It serves as the primary entry point for creating and accessing the main application instance,
+    ensuring that the application is properly set up before use.
 
     Returns
     -------
     IApplication
-        The initialized application instance implementing the `IApplication` interface.
+        An instance of `Application` that implements the `IApplication` interface, representing
+        the main Orionis application.
     """
 
-    # Instantiate and return the main application object
+    # Instantiate the main application object implementing IApplication
     return Application()

orionis/foundation/contracts/application.py

@@ -567,11 +567,11 @@ class IApplication(IContainer):
     def setPaths(
         self,
         *,
-        console_scheduler: str | Path = (Path.cwd() / 'app' / 'console' / 'kernel.py').resolve(),
-        console_commands: str | Path = (Path.cwd() / 'app' / 'console' / 'commands').resolve(),
-        http_controllers: str | Path = (Path.cwd() / 'app' / 'http' / 'controllers').resolve(),
-        http_middleware: str | Path = (Path.cwd() / 'app' / 'http' / 'middleware').resolve(),
-        http_requests: str | Path = (Path.cwd() / 'app' / 'http' / 'requests').resolve(),
+        root: str | Path = Path.cwd().resolve(),
+        commands: str | Path = (Path.cwd() / 'app' / 'console' / 'commands').resolve(),
+        controllers: str | Path = (Path.cwd() / 'app' / 'http' / 'controllers').resolve(),
+        middleware: str | Path = (Path.cwd() / 'app' / 'http' / 'middleware').resolve(),
+        requests: str | Path = (Path.cwd() / 'app' / 'http' / 'requests').resolve(),
         models: str | Path = (Path.cwd() / 'app' / 'models').resolve(),
         providers: str | Path = (Path.cwd() / 'app' / 'providers').resolve(),
         events: str | Path = (Path.cwd() / 'app' / 'events').resolve(),
@@ -584,95 +584,90 @@ class IApplication(IContainer):
         views: str | Path = (Path.cwd() / 'resources' / 'views').resolve(),
         lang: str | Path = (Path.cwd() / 'resources' / 'lang').resolve(),
         assets: str | Path = (Path.cwd() / 'resources' / 'assets').resolve(),
-        routes_web: str | Path = (Path.cwd() / 'routes' / 'web.py').resolve(),
-        routes_api: str | Path = (Path.cwd() / 'routes' / 'api.py').resolve(),
-        routes_console: str | Path = (Path.cwd() / 'routes' / 'console.py').resolve(),
-        routes_channels: str | Path = (Path.cwd() / 'routes' / 'channels.py').resolve(),
+        routes: str | Path = (Path.cwd() / 'routes').resolve(),
         config: str | Path = (Path.cwd() / 'config').resolve(),
         migrations: str | Path = (Path.cwd() / 'database' / 'migrations').resolve(),
         seeders: str | Path = (Path.cwd() / 'database' / 'seeders').resolve(),
         factories: str | Path = (Path.cwd() / 'database' / 'factories').resolve(),
-        storage_logs: str | Path = (Path.cwd() / 'storage' / 'logs').resolve(),
-        storage_framework: str | Path = (Path.cwd() / 'storage' / 'framework').resolve(),
-        storage_sessions: str | Path = (Path.cwd() / 'storage' / 'framework' / 'sessions').resolve(),
-        storage_cache: str | Path = (Path.cwd() / 'storage' / 'framework' / 'cache').resolve(),
-        storage_views: str | Path = (Path.cwd() / 'storage' / 'framework' / 'views').resolve(),
+        logs: str | Path = (Path.cwd() / 'storage' / 'logs').resolve(),
+        sessions: str | Path = (Path.cwd() / 'storage' / 'framework' / 'sessions').resolve(),
+        cache: str | Path = (Path.cwd() / 'storage' / 'framework' / 'cache').resolve(),
+        testing: str | Path = (Path.cwd() / 'storage' / 'framework' / 'testing').resolve(),
+        storage: str | Path = (Path.cwd() / 'storage').resolve()
     ) -> 'IApplication':
         """
-        Configure application directory paths using keyword arguments.
+        Set and resolve application directory paths using keyword arguments.
 
-        This method allows setting custom paths for various application directories
-        including controllers, models, views, storage locations, and other framework
-        components. All parameters are keyword-only and have sensible defaults based
-        on common MVC framework conventions.
+        This method allows customization of all major application directory paths, such as
+        console components, HTTP components, application layers, resources, routes,
+        database files, and storage locations. All provided paths are resolved to absolute
+        paths and stored as strings in the configuration dictionary.
 
         Parameters
         ----------
-        console_scheduler : str | Path, optional
-            Path to the console kernel scheduler file.
-        console_commands : str | Path, optional
-            Directory path for console command classes.
-        http_controllers : str | Path, optional
-            Directory path for HTTP controller classes.
-        http_middleware : str | Path, optional
-            Directory path for HTTP middleware classes.
-        http_requests : str | Path, optional
-            Directory path for HTTP request classes.
-        models : str | Path, optional
-            Directory path for model classes.
-        providers : str | Path, optional
-            Directory path for service provider classes.
-        events : str | Path, optional
-            Directory path for event classes.
-        listeners : str | Path, optional
-            Directory path for event listener classes.
-        notifications : str | Path, optional
-            Directory path for notification classes.
-        jobs : str | Path, optional
-            Directory path for job classes.
-        policies : str | Path, optional
-            Directory path for authorization policy classes.
-        exceptions : str | Path, optional
-            Directory path for custom exception classes.
-        services : str | Path, optional
-            Directory path for service classes.
-        views : str | Path, optional
-            Directory path for view templates.
-        lang : str | Path, optional
-            Directory path for language localization files.
-        assets : str | Path, optional
-            Directory path for static assets.
-        routes_web : str | Path, optional
-            File path for web routes definition.
-        routes_api : str | Path, optional
-            File path for API routes definition.
-        routes_console : str | Path, optional
-            File path for console routes definition.
-        routes_channels : str | Path, optional
-            File path for channel routes definition.
-        config : str | Path, optional
-            Directory path for configuration files.
-        migrations : str | Path, optional
-            Directory path for database migration files.
-        seeders : str | Path, optional
-            Directory path for database seeder files.
-        factories : str | Path, optional
-            Directory path for model factory files.
-        storage_logs : str | Path, optional
-            Directory path for log files.
-        storage_framework : str | Path, optional
-            Directory path for framework storage files.
-        storage_sessions : str | Path, optional
-            Directory path for session storage files.
-        storage_cache : str | Path, optional
-            Directory path for cache storage files.
-        storage_views : str | Path, optional
-            Directory path for compiled view cache files.
+        root : str or Path, optional
+            Root directory of the application. Defaults to the current working directory.
+        commands : str or Path, optional
+            Directory for console command classes. Defaults to 'app/console/commands'.
+        controllers : str or Path, optional
+            Directory for HTTP controller classes. Defaults to 'app/http/controllers'.
+        middleware : str or Path, optional
+            Directory for HTTP middleware classes. Defaults to 'app/http/middleware'.
+        requests : str or Path, optional
+            Directory for HTTP request classes. Defaults to 'app/http/requests'.
+        models : str or Path, optional
+            Directory for data model classes. Defaults to 'app/models'.
+        providers : str or Path, optional
+            Directory for service provider classes. Defaults to 'app/providers'.
+        events : str or Path, optional
+            Directory for event classes. Defaults to 'app/events'.
+        listeners : str or Path, optional
+            Directory for event listener classes. Defaults to 'app/listeners'.
+        notifications : str or Path, optional
+            Directory for notification classes. Defaults to 'app/notifications'.
+        jobs : str or Path, optional
+            Directory for queue job classes. Defaults to 'app/jobs'.
+        policies : str or Path, optional
+            Directory for authorization policy classes. Defaults to 'app/policies'.
+        exceptions : str or Path, optional
+            Directory for custom exception classes. Defaults to 'app/exceptions'.
+        services : str or Path, optional
+            Directory for application service classes. Defaults to 'app/services'.
+        views : str or Path, optional
+            Directory for view templates. Defaults to 'resources/views'.
+        lang : str or Path, optional
+            Directory for language files. Defaults to 'resources/lang'.
+        assets : str or Path, optional
+            Directory for asset files. Defaults to 'resources/assets'.
+        routes : str or Path, optional
+            Directory for route definitions. Defaults to 'routes'.
+        config : str or Path, optional
+            Directory for configuration files. Defaults to 'config'.
+        migrations : str or Path, optional
+            Directory for database migration files. Defaults to 'database/migrations'.
+        seeders : str or Path, optional
+            Directory for database seeder files. Defaults to 'database/seeders'.
+        factories : str or Path, optional
+            Directory for model factory files. Defaults to 'database/factories'.
+        logs : str or Path, optional
+            Directory for log file storage. Defaults to 'storage/logs'.
+        sessions : str or Path, optional
+            Directory for session file storage. Defaults to 'storage/framework/sessions'.
+        cache : str or Path, optional
+            Directory for cache file storage. Defaults to 'storage/framework/cache'.
+        testing : str or Path, optional
+            Directory for testing file storage. Defaults to 'storage/framework/testing'.
 
         Returns
         -------
-        IApplication
-            The application instance to enable method chaining.
+        Application
+            Returns the current Application instance to enable method chaining.
+
+        Notes
+        -----
+        All path parameters accept either string or Path objects and are automatically
+        resolved to absolute paths relative to the current working directory. The
+        resolved paths are stored as strings in the internal configuration dictionary.
         """
         pass
 

orionis/metadata/framework.py

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

{orionis-0.506.0.dist-info → orionis-0.507.0.dist-info}/METADATA

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

{orionis-0.506.0.dist-info → orionis-0.507.0.dist-info}/RECORD

@@ -1,5 +1,5 @@
 orionis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/app.py,sha256=b69fOzj2J8Aw5g0IldWZXixUDeeTO9vcHc_Njses9HU,603
+orionis/app.py,sha256=bRZo4WbTXf9UidNc09Pm-kn1pIO9Hj86xCEJ-rpz2wQ,742
 orionis/console/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/kernel.py,sha256=m4RoulZB3nkl6-O250UDN4ZoXqfTF4F5gbAYt7TAnQo,3054
 orionis/console/args/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -197,7 +197,7 @@ orionis/foundation/config/testing/enums/drivers.py,sha256=mwv47FcKDXEOxydQXAGtkd
 orionis/foundation/config/testing/enums/mode.py,sha256=IbFpauu7J-iSAfmC8jDbmTEYl8eZr-AexL-lyOh8_74,337
 orionis/foundation/config/testing/enums/verbosity.py,sha256=Z-FQ6C3rxbRwP8HoVibbgRMGcsen2SwTuEy3wnjdIhc,486
 orionis/foundation/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/foundation/contracts/application.py,sha256=vLf7ozmdBY3F6pPQipecwo_JbvHshq3jTD4D8YqPy7c,31407
+orionis/foundation/contracts/application.py,sha256=SyO8m9qw5P8E60zJ1WCitc9llvEaWkT2CLPrkDIBIq0,31610
 orionis/foundation/contracts/config.py,sha256=mCyA43f0n_e-CEL0f-sWWgE-M7GicS_aEtC_TNbn_yc,802
 orionis/foundation/exceptions/__init__.py,sha256=q6we1N8kcd6j6GjUJY30WQhhHnqF9RXA0c6-ksEztlc,294
 orionis/foundation/exceptions/integrity.py,sha256=mc4pL1UMoYRHEmphnpW2oGk5URhu7DJRREyzHaV-cs8,472
@@ -219,7 +219,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=72SoixFog9IOE9Ve9Xcfw6
 orionis/foundation/providers/testing_provider.py,sha256=SrJRpdvcblx9WvX7x9Y3zc7OQfiTf7la0HAJrm2ESlE,3725
 orionis/foundation/providers/workers_provider.py,sha256=oa_2NIDH6UxZrtuGkkoo_zEoNIMGgJ46vg5CCgAm7wI,3926
 orionis/metadata/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/metadata/framework.py,sha256=7GDE1vlKx7t9nOHv-ZfHJT1aRtbeCDfcrHCCN_WVg_Y,4109
+orionis/metadata/framework.py,sha256=fFR8Cs3ZS8FjoV9AhPPcw-3A_6DGHTpumC7OCWp-mGo,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
@@ -395,7 +395,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.506.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.507.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
 tests/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 tests/container/context/test_manager.py,sha256=wOwXpl9rHNfTTexa9GBKYMwK0_-KSQPbI-AEyGNkmAE,1356
@@ -541,8 +541,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.506.0.dist-info/METADATA,sha256=92B0xXn_6oSt7vqPcFDegLTan4m-sLF3SAYX9uSi3VY,4801
-orionis-0.506.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.506.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
-orionis-0.506.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
-orionis-0.506.0.dist-info/RECORD,,
+orionis-0.507.0.dist-info/METADATA,sha256=jTF7G9c5k9OZectyJLiq480nITd4_ccGQwDRRet0dnQ,4801
+orionis-0.507.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.507.0.dist-info/top_level.txt,sha256=2bdoHgyGZhOtLAXS6Om8OCTmL24dUMC_L1quMe_ETbk,14
+orionis-0.507.0.dist-info/zip-safe,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+orionis-0.507.0.dist-info/RECORD,,