orionis 0.548.0__py3-none-any.whl → 0.549.0__py3-none-any.whl

orionis/console/contracts/cli_request.py

@@ -82,4 +82,93 @@ class ICLIRequest(ABC):
         This method uses the dictionary's get() method to safely access values,
         ensuring that missing arguments return None rather than raising a KeyError.
         """
+        pass
+
+    def getCWD(self) -> str:
+        """
+        Retrieve the current working directory (CWD) as an absolute path.
+
+        This method returns the absolute path of the directory from which the Python process was started.
+        It is useful for determining the context in which the CLI command is being executed, especially
+        when dealing with relative file paths or when the working directory may affect application behavior.
+
+        Returns
+        -------
+        str
+            The absolute path to the current working directory as a string.
+        """
+        pass
+
+    def getPID(self) -> int:
+        """
+        Retrieve the process ID (PID) of the current Python process.
+
+        This method returns the unique identifier assigned by the operating system
+        to the currently running Python process. The PID can be useful for logging,
+        debugging, or managing process-related operations.
+
+        Returns
+        -------
+        int
+            The process ID (PID) of the current Python process as an integer.
+        """
+        pass
+
+    def getParentPID(self) -> int:
+        """
+        Retrieve the parent process ID (PPID) of the current Python process.
+
+        This method returns the process ID of the parent process that spawned the current
+        Python process. The parent process ID can be useful for tracking process hierarchies,
+        debugging, or managing process relationships in CLI applications.
+
+        Returns
+        -------
+        int
+            The parent process ID (PPID) as an integer. This value is assigned by the operating
+            system and uniquely identifies the parent process of the current Python process.
+
+        Notes
+        -----
+        The returned PPID is determined by the operating system and may vary depending on how
+        the Python process was started. If the parent process has terminated, the PPID may refer
+        to the init process or another system-defined process.
+        """
+        pass
+
+    def getExecutable(self) -> str:
+        """
+        Retrieve the absolute path to the Python interpreter executable.
+
+        This method returns the full filesystem path to the Python interpreter
+        that is currently executing the script. This can be useful for debugging,
+        spawning subprocesses, or determining the runtime environment.
+
+        Returns
+        -------
+        str
+            The absolute path to the Python executable as a string.
+        """
+        pass
+
+    def getPlatform(self) -> str:
+        """
+        Retrieve the name of the current operating system platform.
+
+        This method determines the name of the operating system on which the Python
+        interpreter is currently running. It uses the standard library's `platform`
+        module to obtain a human-readable string representing the platform, such as
+        'Windows', 'Linux', or 'Darwin' (for macOS).
+
+        Returns
+        -------
+        str
+            A string representing the name of the operating system platform. Typical
+            return values include 'Windows', 'Linux', or 'Darwin'.
+
+        Notes
+        -----
+        The returned value is determined by the underlying system and may vary
+        depending on the environment in which the code is executed.
+        """
         pass

orionis/console/request/cli_request.py

@@ -218,4 +218,98 @@ class CLIRequest(ICLIRequest):
             return default
 
         # Return the value associated with the specified argument name
-        return self.__args.get(name, default)
+        return self.__args.get(name, default)
+
+    def getCWD(self) -> str:
+        """
+        Retrieve the current working directory (CWD) as an absolute path.
+
+        This method returns the absolute path of the directory from which the Python process was started.
+        It is useful for determining the context in which the CLI command is being executed, especially
+        when dealing with relative file paths or when the working directory may affect application behavior.
+
+        Returns
+        -------
+        str
+            The absolute path to the current working directory as a string.
+        """
+        import os           # Import the os module to interact with the operating system
+        return os.getcwd()  # Return the current working directory
+
+    def getPID(self) -> int:
+        """
+        Retrieve the process ID (PID) of the current Python process.
+
+        This method returns the unique identifier assigned by the operating system
+        to the currently running Python process. The PID can be useful for logging,
+        debugging, or managing process-related operations.
+
+        Returns
+        -------
+        int
+            The process ID (PID) of the current Python process as an integer.
+        """
+        import os           # Import the os module to access operating system functionality
+        return os.getpid()  # Return the current process ID
+
+    def getParentPID(self) -> int:
+        """
+        Retrieve the parent process ID (PPID) of the current Python process.
+
+        This method returns the process ID of the parent process that spawned the current
+        Python process. The parent process ID can be useful for tracking process hierarchies,
+        debugging, or managing process relationships in CLI applications.
+
+        Returns
+        -------
+        int
+            The parent process ID (PPID) as an integer. This value is assigned by the operating
+            system and uniquely identifies the parent process of the current Python process.
+
+        Notes
+        -----
+        The returned PPID is determined by the operating system and may vary depending on how
+        the Python process was started. If the parent process has terminated, the PPID may refer
+        to the init process or another system-defined process.
+        """
+        import os               # Import the os module to interact with the operating system
+        return os.getppid()     # Return the parent process ID of the current process
+
+    def getExecutable(self) -> str:
+        """
+        Retrieve the absolute path to the Python interpreter executable.
+
+        This method returns the full filesystem path to the Python interpreter
+        that is currently executing the script. This can be useful for debugging,
+        spawning subprocesses, or determining the runtime environment.
+
+        Returns
+        -------
+        str
+            The absolute path to the Python executable as a string.
+        """
+        import sys              # Import sys module to access interpreter information
+        return sys.executable   # Return the path to the Python executable
+
+    def getPlatform(self) -> str:
+        """
+        Retrieve the name of the current operating system platform.
+
+        This method determines the name of the operating system on which the Python
+        interpreter is currently running. It uses the standard library's `platform`
+        module to obtain a human-readable string representing the platform, such as
+        'Windows', 'Linux', or 'Darwin' (for macOS).
+
+        Returns
+        -------
+        str
+            A string representing the name of the operating system platform. Typical
+            return values include 'Windows', 'Linux', or 'Darwin'.
+
+        Notes
+        -----
+        The returned value is determined by the underlying system and may vary
+        depending on the environment in which the code is executed.
+        """
+        import platform             # Import the platform module to access system information
+        return platform.system()    # Return the platform name as a string

orionis/metadata/framework.py

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

{orionis-0.548.0.dist-info → orionis-0.549.0.dist-info}/METADATA

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

{orionis-0.548.0.dist-info → orionis-0.549.0.dist-info}/RECORD

@@ -21,7 +21,7 @@ orionis/console/commands/workflow.py,sha256=NYOmjTSvm2o6AE4h9LSTZMFSYPQreNmEJtro
 orionis/console/contracts/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/contracts/base_command.py,sha256=vmAJD0yMQ5-AD_s9_xCFEAl64sKk65z7U2E196dALQM,5760
 orionis/console/contracts/base_scheduler.py,sha256=OW-a_YDDNPrenYT9z8Tv71VjyZ1aSzqzqhTBhTCZhGM,7698
-orionis/console/contracts/cli_request.py,sha256=1fl18n2mtpk-p4XCY0dtyHjYS0bazXyE6gcLczY5YGY,3360
+orionis/console/contracts/cli_request.py,sha256=qIV8ig8PG39LYp1acnUD8GYsNRSHncxIxGjO3B3YsUo,6755
 orionis/console/contracts/command.py,sha256=Wvm62hw2gDIPNmoEUFyhKUERjZ6wnAbI-UDY_5gJE24,3626
 orionis/console/contracts/console.py,sha256=phaQhCLWa81MLzB5ydOSaUfEIdDq7fOjvym8Rmi-arc,11908
 orionis/console/contracts/dump.py,sha256=LqT4nAyn37eACNz0c_WqQd8BDXgZ9pugtkiVlHOP6yc,1012
@@ -80,7 +80,7 @@ orionis/console/output/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3
 orionis/console/output/console.py,sha256=EtSDWRBW8wk0iJdPfB1mzU49krLJBaSAUdVdVOzzhQ4,17888
 orionis/console/output/executor.py,sha256=uQjFPOlyZLFj9pcyYPugCqxwJog0AJgK1OcmQH2ELbw,7314
 orionis/console/request/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-orionis/console/request/cli_request.py,sha256=0LuSuovIJn6BF3HfDHihVZRmMTss-xd21dvUYCuMF3I,9079
+orionis/console/request/cli_request.py,sha256=zFuoFzLVDCcSNcJZAuLAlsc9jfhck5o23qaKc2C0QAg,13231
 orionis/console/tasks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 orionis/console/tasks/schedule.py,sha256=FgZWJtfXRcZ_-FfJaxP1LzHmDtm5QD9QRRCJ--QMqK8,83385
 orionis/container/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -241,7 +241,7 @@ orionis/foundation/providers/scheduler_provider.py,sha256=1do4B09bU_6xbFHHVYYTGM
 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=CUwFTlTrOpjRnUkNx7lH01jKuJ-yYNq5OAZqi-IxlyU,4109
+orionis/metadata/framework.py,sha256=dNCXPNRAN0XUaGbBHf3pbs-glIqhnCpmevRzDEeDj-c,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
@@ -433,8 +433,8 @@ 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.548.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
-orionis-0.548.0.dist-info/METADATA,sha256=Rs_Ar8Co3tu5LDbMQ79aqkJPKzkKVgUsNIagrBy7eSk,4801
-orionis-0.548.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-orionis-0.548.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
-orionis-0.548.0.dist-info/RECORD,,
+orionis-0.549.0.dist-info/licenses/LICENCE,sha256=JhC-z_9mbpUrCfPjcl3DhDA8trNDMzb57cvRSam1avc,1463
+orionis-0.549.0.dist-info/METADATA,sha256=kIuCc2awemPVuMkEd_rYpQpZ3N7aanweQd-Knrpfcvw,4801
+orionis-0.549.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+orionis-0.549.0.dist-info/top_level.txt,sha256=lyXi6jArpqJ-0zzNqd_uwsH-z9TCEBVBL-pC3Ekv7hU,8
+orionis-0.549.0.dist-info/RECORD,,