xulbux 1.5.5__py3-none-any.whl

xulbux/xx_system.py

@@ -0,0 +1,75 @@
+import subprocess as _subprocess
+import platform as _platform
+import time as _time
+import sys as _sys
+import os as _os
+
+
+
+
+class System:
+
+    @staticmethod
+    def restart(prompt:object = None, wait:int = 0, continue_program:bool = False, force:bool = False) -> None:
+        """Starts a system restart:<br>
+        `prompt` is the message to be displayed in the systems restart notification.<br>
+        `wait` is the time to wait until restarting in seconds.<br>
+        `continue_program` is whether to continue the current Python program after calling this function.<br>
+        `force` is whether to force a restart even if other processes are still running."""
+        system = _platform.system().lower()
+        if system == 'windows':
+            if not force:
+                output = _subprocess.check_output('tasklist', shell=True).decode()
+                processes = [line.split()[0] for line in output.splitlines()[3:] if line.strip()]
+                if len(processes) > 2:  # EXCLUDING THE PYTHON PROCESS AND CMD
+                    raise RuntimeError('Processes are still running. Use the parameter `force=True` to restart anyway.')
+            if prompt:
+                _os.system(f'shutdown /r /t {wait} /c "{prompt}"')
+            else:
+                _os.system('shutdown /r /t 0')
+            if continue_program:
+                print(f'Restarting in {wait} seconds...')
+                _time.sleep(wait)
+        elif system in ['linux', 'darwin']:
+            if not force:
+                output = _subprocess.check_output(['ps', '-A']).decode()
+                processes = output.splitlines()[1:]  # EXCLUDE HEADER
+                if len(processes) > 2:  # EXCLUDING THE PYTHON PROCESS AND PS
+                    raise RuntimeError('Processes are still running. Use the parameter `force=True` to restart anyway.')
+            if prompt:
+                _subprocess.Popen(['notify-send', 'System Restart', prompt])
+                _time.sleep(wait)
+            try:
+                _subprocess.run(['sudo', 'shutdown', '-r', 'now'])
+            except _subprocess.CalledProcessError:
+                raise PermissionError('Failed to restart: insufficient privileges. Ensure sudo permissions are granted.')
+            if continue_program:
+                print(f'Restarting in {wait} seconds...')
+                _time.sleep(wait)
+        else:
+            raise NotImplementedError(f'Restart not implemented for `{system}`')
+
+    @staticmethod
+    def check_libs(lib_names:list[str], install_missing:bool = False, confirm_install:bool = True) -> None|list[str]:
+        """Checks if the given list of libraries are installed. If not:
+        - If `install_missing` is `False` the missing libraries will be returned as a list.
+        - If `install_missing` is `True` the missing libraries will be installed. If `confirm_install` is `True` the user will first be asked if they want to install the missing libraries."""
+        missing = []
+        for lib in lib_names:
+            try: __import__(lib)
+            except ImportError: missing.append(lib)
+        if not missing:
+            return None
+        elif not install_missing:
+            return missing
+        if confirm_install:
+            print('The following required libraries are missing:')
+            for lib in missing:
+                print(f'- {lib}')
+            if input('Do you want to install them now (Y/n):  ').strip().lower() not in ['', 'y', 'yes']:
+                raise ImportError('Missing required libraries.')
+        try:
+            _subprocess.check_call([_sys.executable, '-m', 'pip', 'install'] + missing)
+            return None
+        except _subprocess.CalledProcessError:
+            return missing

xulbux-1.5.5.dist-info/METADATA

@@ -0,0 +1,97 @@
+Metadata-Version: 2.3
+Name: XulbuX
+Version: 1.5.5
+Summary: A library which includes a lot of really helpful functions.
+Project-URL: Homepage, https://github.com/XulbuX-dev/Python/tree/main/Libraries/XulbuX
+Project-URL: Bug Reports, https://github.com/XulbuX-dev/Python/issues
+Project-URL: Documentation, https://github.com/XulbuX-dev/Python/wiki
+Project-URL: Source Code, https://github.com/XulbuX-dev/Python/tree/main/Libraries/XulbuX/src
+Project-URL: Changelog, https://github.com/XulbuX-dev/Python/blob/main/Libraries/XulbuX/CHANGELOG.md
+Author-email: XulbuX <xulbux.real@gmail.com>
+License: MIT License
+        
+        Copyright (c) 2024 XulbuX
+        
+        Permission is hereby granted, free of charge, to any person obtaining a copy
+        of this software and associated documentation files (the "Software"), to deal
+        in the Software without restriction, including without limitation the rights
+        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+        copies of the Software, and to permit persons to whom the Software is
+        furnished to do so, subject to the following conditions:
+        
+        The above copyright notice and this permission notice shall be included in all
+        copies or substantial portions of the Software.
+        
+        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+        SOFTWARE.
+Keywords: classes,cmd,code,color,data,env,environment,file,format,functions,helper,helpful,json,library,methods,operations,path,presets,python,regex,string,structures,system,tools,types,utility,xulbux
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10.0
+Requires-Dist: keyboard>=0.13.5
+Requires-Dist: mouse>=0.7.1
+Requires-Dist: regex>=2023.10.3
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# **$\color{#8085FF}\Huge\textsf{XulbuX}$**
+
+**$\color{#8085FF}\textsf{XulbuX}$** is a library which includes a lot of really helpful classes, types and functions.
+
+For the libraries latest changes, see the [change log](https://github.com/XulbuX-dev/Python/blob/main/Libraries/XulbuX/CHANGELOG.md).<br>
+For precise information about the library, see the library's [Wiki page](https://github.com/XulbuX-dev/Python/wiki).
+
+
+## Installation
+
+On all operating systems, run the following command:
+```bash
+pip install XulbuX
+```
+
+
+## Usage
+
+```python
+# GENERAL LIBRARY
+import XulbuX as xx
+# CUSTOM TYPES
+from XulbuX import rgba, hsla, hexa
+```
+The library **$\color{#8085FF}\textsf{XulbuX}$** (*below used as* `xx` *with above imported types*) contains the following modules:
+```python
+  • CUSTOM TYPES:
+     • rgba(int,int,int,float)
+     • hsla(int,int,int,float)
+     • hexa(str)
+  • PATH OPERATIONS          xx.Path
+  • FILE OPERATIONS          xx.File
+  • JSON FILE OPERATIONS     xx.Json
+  • SYSTEM ACTIONS           xx.System
+  • MANAGE ENVIRONMENT VARS  xx.EnvVars
+  • CMD LOG AND ACTIONS      xx.Cmd
+  • PRETTY PRINTING          xx.FormatCodes
+  • COLOR OPERATIONS         xx.Color
+  • DATA OPERATIONS          xx.Data
+  • STR OPERATIONS           xx.String
+  • CODE STRING OPERATIONS   xx.Code
+  • REGEX PATTERN TEMPLATES  xx.Regex
+```
+
+
+<br>
+
+--------------------------------------------------------------
+[View this library on PyPI](https://pypi.org/project/XulbuX/)

xulbux-1.5.5.dist-info/RECORD

@@ -0,0 +1,20 @@
+xulbux/__help__.py,sha256=2p_CLFMoEu4Coqs2d3dFuoZ16NQTI6aZkctVjSmq7mE,4098
+xulbux/__init__.py,sha256=8I7GLhkT_P3-KIDDZmAlbIgxmQfoh3ujgv5_aPzQt8g,1644
+xulbux/_consts_.py,sha256=vquutpFVjJsGqRi78EboXbyMczqMdAPZVnAyqcwzJ6k,5313
+xulbux/xx_cmd.py,sha256=9rmnq7YkgfzBoCpcyai0FKZTcBPpMjw3L15-FORUdnI,14070
+xulbux/xx_code.py,sha256=wnQuA0gfxd-Q_sCW-R3Sqw4Ld6u4TQMRAJGzMgTDiqk,5520
+xulbux/xx_color.py,sha256=TqsY5akT9vzHMWJZQ0Ggev5DIzfHaCcq0Tgd-sp15TM,42106
+xulbux/xx_data.py,sha256=U9qzEZFVV_I6CgjbENfz2SuhvIN31Y9t_EtOhccF-6c,26127
+xulbux/xx_env_vars.py,sha256=zN0xFtqukQO9TdR-Ci7sky4s5m2wjQQUfhrhdcNaS1Y,2394
+xulbux/xx_file.py,sha256=CEv5n-ZG_l7HK2ClVQWRiqlERaHhHeGvy0W4rr8OrMI,2513
+xulbux/xx_format_codes.py,sha256=O7DnVnzwa1riiHP9DbRtpMD1LNrOKMT4xpwngt49iPo,12939
+xulbux/xx_json.py,sha256=Z4617tA2VJIdHxQIGCbx99ubLTYj1Dky75C7qiORkWg,4827
+xulbux/xx_path.py,sha256=P_r8WzJygtDCFuQxcEONlkW_exkHxRaqJoUxnPBetyo,4338
+xulbux/xx_regex.py,sha256=s3AsnlMrwblz57BjygV-fjgFn0AguopvZLCKWHVd3ZA,6921
+xulbux/xx_string.py,sha256=gwwY8pTB7d6gJgp8lo8pUftnyJBna0VQ4oFFc_AmOjo,5297
+xulbux/xx_system.py,sha256=2zqqT_oqCPDPzaUBSNMC8awRhSUHQtwIwju9pIQQQQ4,3797
+xulbux-1.5.5.dist-info/METADATA,sha256=PorHfyAoYZ3R8blKx0TAlsqqT9qcZ5auVdlVBJ97L5Y,4162
+xulbux-1.5.5.dist-info/WHEEL,sha256=3U_NnUcV_1B1kPkYaPzN-irRckL5VW_lytn0ytO_kRY,87
+xulbux-1.5.5.dist-info/entry_points.txt,sha256=hfQ1MjdOLVbINRpbJVzNcqRbAouwYF4a-5kzO69zcHE,46
+xulbux-1.5.5.dist-info/licenses/LICENSE,sha256=6NflEcvzFEe8_JFVNCPVwZBwBhlLLd4vqQi8WiX_Xk4,1084
+xulbux-1.5.5.dist-info/RECORD,,

xulbux-1.5.5.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.26.1
+Root-Is-Purelib: true
+Tag: py3-none-any

xulbux-1.5.5.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+xulbux-help = __help__:help

xulbux-1.5.5.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 XulbuX
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.