xulbux 1.7.3__tar.gz → 1.8.1__tar.gz

xulbux-1.8.1/PKG-INFO

@@ -0,0 +1,190 @@
+Metadata-Version: 2.4
+Name: xulbux
+Version: 1.8.1
+Summary: A Python library which includes lots of helpful classes, types and functions aiming to make common programming tasks simpler.
+Author-email: XulbuX <xulbux.real@gmail.com>
+Maintainer-email: XulbuX <xulbux.real@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/XulbuX/PythonLibraryXulbuX
+Project-URL: Documentation, https://github.com/XulbuX/PythonLibraryXulbuX/wiki
+Project-URL: Source Code, https://github.com/XulbuX/PythonLibraryXulbuX/tree/main/src
+Project-URL: Changelog, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md
+Project-URL: Bug Reports, https://github.com/XulbuX/PythonLibraryXulbuX/issues
+Project-URL: Stats, https://clickpy.clickhouse.com/dashboard/xulbux
+Project-URL: License, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE
+Keywords: args,arguments,attributes,classes,client,cmd,code,codes,color,commands,console,constants,consts,conversion,convert,data,debug,easier,env,environment,error,file,format,formatting,functions,helper,hex,hexa,hsl,hsla,info,input,json,library,log,logging,methods,nice,operations,path,presets,pretty,printing,properties,python,re,regex,rgb,rgba,string,structures,system,tools,types,utility,warn,warning,xulbux
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Operating System :: OS Independent
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10.0
+Description-Content-Type: text/markdown
+Requires-Dist: keyboard>=0.13.5
+Requires-Dist: prompt_toolkit>=3.0.41
+Requires-Dist: pyperclip>=1.9.0
+Requires-Dist: regex>=2023.10.3
+Provides-Extra: dev
+Requires-Dist: black>=23.7.0; extra == "dev"
+Requires-Dist: flake8-pyproject>=1.2.3; extra == "dev"
+Requires-Dist: flake8>=6.1.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: pytest>=7.4.2; extra == "dev"
+
+# **XulbuX**
+
+[![](https://img.shields.io/pypi/v/xulbux?labelColor=404560&color=7075FF)](https://pypi.org/project/xulbux) [![](https://img.shields.io/pepy/dt/xulbux?labelColor=404560&color=7075FF)](https://clickpy.clickhouse.com/dashboard/xulbux) [![](https://img.shields.io/github/license/XulbuX/PythonLibraryXulbuX?labelColor=405555&color=70FFEE)](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE) [![](https://img.shields.io/github/last-commit/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/commits) [![](https://img.shields.io/github/issues/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/issues)
+
+**XulbuX** is a library that contains many useful classes, types, and functions,
+ranging from console logging and working with colors to file management and system operations.
+The library is designed to simplify common programming tasks and improve code readability through its collection of tools.
+
+For precise information about the library, see the library's [**documentation**](https://github.com/XulbuX/PythonLibraryXulbuX/wiki).<br>
+For the libraries latest changes and updates, see the [**change log**](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md).
+
+### The best modules, you have to check out:
+
+[![format_codes](https://img.shields.io/badge/format__codes-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) [![console](https://img.shields.io/badge/console-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console) [![color](https://img.shields.io/badge/color-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color)
+
+<br>
+
+## Installation
+
+Run the following commands in a console with administrator privileges, so the actions take effect for all users.
+
+Install the library and all its dependencies with the command:
+```console
+pip install xulbux
+```
+
+Upgrade the library and all its dependencies to their latest available version with the command:
+```console
+pip install --upgrade xulbux
+```
+
+<br>
+
+## CLI Commands
+
+When the library is installed, the following commands are available in the console:
+| Command       | Description                              |
+| :------------ | :--------------------------------------- |
+| `xulbux-help` | shows some information about the library |
+
+<br>
+
+## Usage
+
+Import the full library under the alias `xx`, so its constants, classes, methods, and types are accessible with `xx.CONSTANT.value`, `xx.Class.method()`, `xx.type()`:
+```python
+import xulbux as xx
+```
+So you don't have to import the full library under an alias, you can also import only certain parts of the library's contents:
+```python
+# LIBRARY CONSTANTS
+from xulbux.base.consts import COLOR, CHARS, ANSI
+# Main Classes
+from xulbux import Code, Color, Console, ...
+# module specific imports
+from xulbux.color import rgba, hsla, hexa
+```
+
+<br>
+
+## Modules
+
+| Module                                                                                                                                                    | Short Description                                                                           |
+| :-------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
+| [![base](https://img.shields.io/badge/base-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/base)                          | includes more modules like library constants                                                |
+| [![code](https://img.shields.io/badge/code-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/code)                          | advanced code-string operations (*changing the indent, finding function calls, ...*)        |
+| [![color](https://img.shields.io/badge/color-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color)                       | everything around colors (*converting, blending, searching colors in strings, ...*)         |
+| [![console](https://img.shields.io/badge/console-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console)                 | advanced actions related to the console (*pretty logging, advanced inputs, ...*)            |
+| [![data](https://img.shields.io/badge/data-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/data)                          | advanced operations with data structures (*compare, generate path IDs, pretty print, ...*)  |
+| [![env_path](https://img.shields.io/badge/env__path-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/env_path)             | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)        |
+| [![file](https://img.shields.io/badge/file-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/file)                          | advanced working with files (*create files, rename file-extensions, ...*)                   |
+| [![format_codes](https://img.shields.io/badge/format__codes-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) | easy pretty printing using custom format codes (*print, inputs, format codes to ANSI, ...*) |
+| [![json](https://img.shields.io/badge/json-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/json)                          | advanced working with json files (*read, create, update, ...*)                              |
+| [![path](https://img.shields.io/badge/path-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/path)                          | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)      |
+| [![regex](https://img.shields.io/badge/regex-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/regex)                       | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)     |
+| [![string](https://img.shields.io/badge/string-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/string)                    | helpful actions when working with strings. (*normalize, escape, decompose, ...*)            |
+| [![system](https://img.shields.io/badge/system-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/system)                    | advanced system actions (*restart with message, check installed Python libs, ...*)          |
+
+<br>
+
+## Example Usage
+
+This is what it could look like using this library for a simple but ultra good-looking color converter:
+```python
+from xulbux.base.consts import COLOR, CHARS
+from xulbux.color import hexa
+from xulbux import Console
+
+
+def main() -> None:
+
+    # LET THE USER ENTER A HEXA COLOR IN ANY HEXA FORMAT
+    input_clr = Console.input(
+        "[b](Enter a HEXA color in any format) > ",
+        start="\n",
+        placeholder="#7075FF",
+        max_len=7,
+        allowed_chars=CHARS.HEX_DIGITS,
+    )
+
+    # ANNOUNCE INDEXING THE INPUT COLOR
+    Console.log(
+        "INDEX",
+        "Indexing the input HEXA color...",
+        start="\n",
+        title_bg_color=COLOR.BLUE,
+    )
+
+    try:
+        # TRY TO CONVERT THE INPUT COLOR INTO A hexa() COLOR
+        hexa_color = hexa(input_clr)
+
+    except ValueError:
+        # ANNOUNCE THE ERROR AND EXIT THE PROGRAM
+        Console.fail(
+            "The input HEXA color is invalid.",
+            end="\n\n",
+            exit=True,
+        )
+
+    # ANNOUNCE STARTING THE CONVERSION
+    Console.log(
+        "CONVERT",
+        "Converting the HEXA color into different types...",
+        title_bg_color=COLOR.TANGERINE,
+    )
+
+    # CONVERT THE HEXA COLOR INTO THE TWO OTHER COLOR TYPES
+    rgba_color = hexa_color.to_rgba()
+    hsla_color = hexa_color.to_hsla()
+
+    # ANNOUNCE THE SUCCESSFUL CONVERSION
+    Console.done(
+        "Successfully converted color into different types.",
+        end="\n\n",
+    )
+
+    # PRETTY PRINT THE COLOR IN DIFFERENT TYPES
+    Console.log_box_bordered(
+        f"[b](HEXA:) [i|white]({hexa_color})",
+        f"[b](RGBA:) [i|white]({rgba_color})",
+        f"[b](HSLA:) [i|white]({hsla_color})",
+    )
+
+
+if __name__ == "__main__":
+    main()
+```
+
+<br>
+<br>
+
+--------------------------------------------------------------
+[View this library on **PyPI**](https://pypi.org/project/xulbux)

xulbux-1.8.1/README.md

@@ -0,0 +1,154 @@
+# **XulbuX**
+
+[![](https://img.shields.io/pypi/v/xulbux?labelColor=404560&color=7075FF)](https://pypi.org/project/xulbux) [![](https://img.shields.io/pepy/dt/xulbux?labelColor=404560&color=7075FF)](https://clickpy.clickhouse.com/dashboard/xulbux) [![](https://img.shields.io/github/license/XulbuX/PythonLibraryXulbuX?labelColor=405555&color=70FFEE)](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE) [![](https://img.shields.io/github/last-commit/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/commits) [![](https://img.shields.io/github/issues/XulbuX/PythonLibraryXulbuX?labelColor=554045&color=FF6065)](https://github.com/XulbuX/PythonLibraryXulbuX/issues)
+
+**XulbuX** is a library that contains many useful classes, types, and functions,
+ranging from console logging and working with colors to file management and system operations.
+The library is designed to simplify common programming tasks and improve code readability through its collection of tools.
+
+For precise information about the library, see the library's [**documentation**](https://github.com/XulbuX/PythonLibraryXulbuX/wiki).<br>
+For the libraries latest changes and updates, see the [**change log**](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md).
+
+### The best modules, you have to check out:
+
+[![format_codes](https://img.shields.io/badge/format__codes-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) [![console](https://img.shields.io/badge/console-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console) [![color](https://img.shields.io/badge/color-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color)
+
+<br>
+
+## Installation
+
+Run the following commands in a console with administrator privileges, so the actions take effect for all users.
+
+Install the library and all its dependencies with the command:
+```console
+pip install xulbux
+```
+
+Upgrade the library and all its dependencies to their latest available version with the command:
+```console
+pip install --upgrade xulbux
+```
+
+<br>
+
+## CLI Commands
+
+When the library is installed, the following commands are available in the console:
+| Command       | Description                              |
+| :------------ | :--------------------------------------- |
+| `xulbux-help` | shows some information about the library |
+
+<br>
+
+## Usage
+
+Import the full library under the alias `xx`, so its constants, classes, methods, and types are accessible with `xx.CONSTANT.value`, `xx.Class.method()`, `xx.type()`:
+```python
+import xulbux as xx
+```
+So you don't have to import the full library under an alias, you can also import only certain parts of the library's contents:
+```python
+# LIBRARY CONSTANTS
+from xulbux.base.consts import COLOR, CHARS, ANSI
+# Main Classes
+from xulbux import Code, Color, Console, ...
+# module specific imports
+from xulbux.color import rgba, hsla, hexa
+```
+
+<br>
+
+## Modules
+
+| Module                                                                                                                                                    | Short Description                                                                           |
+| :-------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------ |
+| [![base](https://img.shields.io/badge/base-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/base)                          | includes more modules like library constants                                                |
+| [![code](https://img.shields.io/badge/code-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/code)                          | advanced code-string operations (*changing the indent, finding function calls, ...*)        |
+| [![color](https://img.shields.io/badge/color-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/color)                       | everything around colors (*converting, blending, searching colors in strings, ...*)         |
+| [![console](https://img.shields.io/badge/console-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/console)                 | advanced actions related to the console (*pretty logging, advanced inputs, ...*)            |
+| [![data](https://img.shields.io/badge/data-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/data)                          | advanced operations with data structures (*compare, generate path IDs, pretty print, ...*)  |
+| [![env_path](https://img.shields.io/badge/env__path-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/env_path)             | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)        |
+| [![file](https://img.shields.io/badge/file-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/file)                          | advanced working with files (*create files, rename file-extensions, ...*)                   |
+| [![format_codes](https://img.shields.io/badge/format__codes-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/format_codes) | easy pretty printing using custom format codes (*print, inputs, format codes to ANSI, ...*) |
+| [![json](https://img.shields.io/badge/json-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/json)                          | advanced working with json files (*read, create, update, ...*)                              |
+| [![path](https://img.shields.io/badge/path-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/path)                          | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)      |
+| [![regex](https://img.shields.io/badge/regex-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/regex)                       | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)     |
+| [![string](https://img.shields.io/badge/string-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/string)                    | helpful actions when working with strings. (*normalize, escape, decompose, ...*)            |
+| [![system](https://img.shields.io/badge/system-FF7E58?style=for-the-badge)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/system)                    | advanced system actions (*restart with message, check installed Python libs, ...*)          |
+
+<br>
+
+## Example Usage
+
+This is what it could look like using this library for a simple but ultra good-looking color converter:
+```python
+from xulbux.base.consts import COLOR, CHARS
+from xulbux.color import hexa
+from xulbux import Console
+
+
+def main() -> None:
+
+    # LET THE USER ENTER A HEXA COLOR IN ANY HEXA FORMAT
+    input_clr = Console.input(
+        "[b](Enter a HEXA color in any format) > ",
+        start="\n",
+        placeholder="#7075FF",
+        max_len=7,
+        allowed_chars=CHARS.HEX_DIGITS,
+    )
+
+    # ANNOUNCE INDEXING THE INPUT COLOR
+    Console.log(
+        "INDEX",
+        "Indexing the input HEXA color...",
+        start="\n",
+        title_bg_color=COLOR.BLUE,
+    )
+
+    try:
+        # TRY TO CONVERT THE INPUT COLOR INTO A hexa() COLOR
+        hexa_color = hexa(input_clr)
+
+    except ValueError:
+        # ANNOUNCE THE ERROR AND EXIT THE PROGRAM
+        Console.fail(
+            "The input HEXA color is invalid.",
+            end="\n\n",
+            exit=True,
+        )
+
+    # ANNOUNCE STARTING THE CONVERSION
+    Console.log(
+        "CONVERT",
+        "Converting the HEXA color into different types...",
+        title_bg_color=COLOR.TANGERINE,
+    )
+
+    # CONVERT THE HEXA COLOR INTO THE TWO OTHER COLOR TYPES
+    rgba_color = hexa_color.to_rgba()
+    hsla_color = hexa_color.to_hsla()
+
+    # ANNOUNCE THE SUCCESSFUL CONVERSION
+    Console.done(
+        "Successfully converted color into different types.",
+        end="\n\n",
+    )
+
+    # PRETTY PRINT THE COLOR IN DIFFERENT TYPES
+    Console.log_box_bordered(
+        f"[b](HEXA:) [i|white]({hexa_color})",
+        f"[b](RGBA:) [i|white]({rgba_color})",
+        f"[b](HSLA:) [i|white]({hsla_color})",
+    )
+
+
+if __name__ == "__main__":
+    main()
+```
+
+<br>
+<br>
+
+--------------------------------------------------------------
+[View this library on **PyPI**](https://pypi.org/project/xulbux)

{xulbux-1.7.3 → xulbux-1.8.1}/pyproject.toml

@@ -4,16 +4,16 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xulbux"
-version = "1.7.3"
+version = "1.8.1"
 authors = [{ name = "XulbuX", email = "xulbux.real@gmail.com" }]
+maintainers = [{ name = "XulbuX", email = "xulbux.real@gmail.com" }]
 description = "A Python library which includes lots of helpful classes, types and functions aiming to make common programming tasks simpler."
 readme = "README.md"
 license = "MIT"
-license-files = ["LICENSE"]
+license-files = ["LICEN[CS]E.*"]
 requires-python = ">=3.10.0"
 dependencies = [
   "keyboard>=0.13.5",
-  "mouse>=0.7.1",
   "prompt_toolkit>=3.0.41",
   "pyperclip>=1.9.0",
   "regex>=2023.10.3",
@@ -26,7 +26,7 @@ optional-dependencies = { dev = [
   "pytest>=7.4.2",
 ] }
 classifiers = [
-  "Programming Language :: Python :: 3",
+  "Development Status :: 5 - Production/Stable",
   "Programming Language :: Python :: 3.13",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.11",
@@ -102,12 +102,11 @@ keywords = [
 "Source Code" = "https://github.com/XulbuX/PythonLibraryXulbuX/tree/main/src"
 "Changelog" = "https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md"
 "Bug Reports" = "https://github.com/XulbuX/PythonLibraryXulbuX/issues"
+"Stats" = "https://clickpy.clickhouse.com/dashboard/xulbux"
 "License" = "https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE"
 
-
 [project.scripts]
-xx-help = "xulbux._cli_:help_command"
-xulbux-help = "xulbux._cli_:help_command"
+xulbux-help = "xulbux.cli.help:show_help"
 
 [tool.black]
 line-length = 127
@@ -144,9 +143,11 @@ extend-ignore = ["E203", "E266", "W503"]
 per-file-ignores = ["__init__.py:F403,F405"]
 
 [tool.setuptools]
-packages = ["xulbux"]
 package-dir = { "" = "src" }
 
+[tool.setuptools.packages.find]
+where = ["src"]
+
 [tool.pytest.ini_options]
 minversion = "7.0"
 addopts = "-ra -q"

xulbux-1.8.1/src/xulbux/__init__.py

@@ -0,0 +1,23 @@
+__version__ = "1.8.1"
+
+__author__ = "XulbuX"
+__email__ = "xulbux.real@gmail.com"
+__license__ = "MIT"
+__copyright__ = "Copyright (c) 2024 XulbuX"
+__url__ = "https://github.com/XulbuX/PythonLibraryXulbuX"
+__description__ = "A Python library which includes lots of helpful classes, types, and functions aiming to make common programming tasks simpler."
+
+__all__ = ["Code", "Color", "Console", "Data", "EnvPath", "File", "FormatCodes", "Json", "Path", "Regex", "String", "System"]
+
+from .code import Code
+from .color import Color
+from .console import Console
+from .data import Data
+from .env_path import EnvPath
+from .file import File
+from .format_codes import FormatCodes
+from .json import Json
+from .path import Path
+from .regex import Regex
+from .string import String
+from .system import System

xulbux-1.7.3/src/xulbux/_consts_.py → xulbux-1.8.1/src/xulbux/base/consts.py

@@ -1,4 +1,3 @@
-from dataclasses import dataclass
 from typing import TypeAlias
 
 
@@ -6,85 +5,79 @@ FormattableString: TypeAlias = str
 """A `str` object that is made to be formatted with the `.format()` method."""
 
 
-@dataclass
 class COLOR:
-    """Color presets used in the `xulbux` library."""
-
-    text = "#A5D6FF"
-    """The default text color used in the `xulbux` library."""
-
-    white = "#F1F2FF"
-    lightgray = "#B6B7C0"
-    gray = "#7B7C8D"
-    darkgray = "#67686C"
-    black = "#202125"
-    red = "#FF606A"
-    coral = "#FF7069"
-    orange = "#FF876A"
-    tangerine = "#FF9962"
-    gold = "#FFAF60"
-    yellow = "#FFD260"
-    lime = "#C9F16E"
-    green = "#7EE787"
-    neongreen = "#4CFF85"
-    teal = "#50EAAF"
-    cyan = "#3EDEE6"
-    ice = "#77DBEF"
-    lightblue = "#60AAFF"
-    blue = "#8085FF"
-    lavender = "#9B7DFF"
-    purple = "#AD68FF"
-    magenta = "#C860FF"
-    pink = "#F162EF"
-    rose = "#FF609F"
-
-
-class _AllTextCharacters:
-    pass
-
-
-@dataclass
+    """Hexa color presets."""
+
+    WHITE = "#F1F2FF"
+    LIGHT_GRAY = "#B6B7C0"
+    GRAY = "#7B7C8D"
+    DARK_GRAY = "#67686C"
+    BLACK = "#202125"
+    RED = "#FF606A"
+    CORAL = "#FF7069"
+    ORANGE = "#FF876A"
+    TANGERINE = "#FF9962"
+    GOLD = "#FFAF60"
+    YELLOW = "#FFD260"
+    LIME = "#C9F16E"
+    GREEN = "#7EE787"
+    NEON_GREEN = "#4CFF85"
+    TEAL = "#50EAAF"
+    CYAN = "#3EDEE6"
+    ICE = "#77DBEF"
+    LIGHT_BLUE = "#60AAFF"
+    BLUE = "#8085FF"
+    LAVENDER = "#9B7DFF"
+    PURPLE = "#AD68FF"
+    MAGENTA = "#C860FF"
+    PINK = "#F162EF"
+    ROSE = "#FF609F"
+
+
 class CHARS:
     """Text character sets."""
 
-    all = _AllTextCharacters
+    class _AllTextChars:
+        pass
+
+    ALL = _AllTextChars
     """Code to signal that all characters are allowed."""
 
-    digits: str = "0123456789"
+    DIGITS = "0123456789"
     """Digits: `0`-`9`"""
-    float_digits: str = digits + "."
+    FLOAT_DIGITS = DIGITS + "."
     """Digits: `0`-`9` with decimal point `.`"""
-    hex_digits: str = digits + "#abcdefABCDEF"
+    HEX_DIGITS = DIGITS + "#abcdefABCDEF"
     """Digits: `0`-`9` Letters: `a`-`f` `A`-`F` and a hashtag `#`"""
 
-    lowercase: str = "abcdefghijklmnopqrstuvwxyz"
+    LOWERCASE = "abcdefghijklmnopqrstuvwxyz"
     """Lowercase letters `a`-`z`"""
-    lowercase_extended: str = lowercase + "äëïöüÿàèìòùáéíóúýâêîôûãñõåæç"
+    LOWERCASE_EXTENDED = LOWERCASE + "äëïöüÿàèìòùáéíóúýâêîôûãñõåæç"
     """Lowercase letters `a`-`z` with all lowercase diacritic letters."""
-    uppercase: str = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+    UPPERCASE = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
     """Uppercase letters `A`-`Z`"""
-    uppercase_extended: str = uppercase + "ÄËÏÖÜÀÈÌÒÙÁÉÍÓÚÝÂÊÎÔÛÃÑÕÅÆÇß"
+    UPPERCASE_EXTENDED = UPPERCASE + "ÄËÏÖÜÀÈÌÒÙÁÉÍÓÚÝÂÊÎÔÛÃÑÕÅÆÇß"
     """Uppercase letters `A`-`Z` with all uppercase diacritic letters."""
 
-    letters: str = lowercase + uppercase
+    LETTERS = LOWERCASE + UPPERCASE
     """Lowercase and uppercase letters `a`-`z` and `A`-`Z`"""
-    letters_extended: str = lowercase_extended + uppercase_extended
+    LETTERS_EXTENDED = LOWERCASE_EXTENDED + UPPERCASE_EXTENDED
     """Lowercase and uppercase letters `a`-`z` `A`-`Z` and all diacritic letters."""
 
-    special_ascii: str = " !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~"
+    SPECIAL_ASCII = " !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~"
     """All ASCII special characters."""
-    special_ascii_extended: str = special_ascii + "ø£Ø׃ªº¿®¬½¼¡«»░▒▓│┤©╣║╗╝¢¥┐└┴┬├─┼╚╔╩╦╠═╬¤ðÐı┘┌█▄¦▀µþÞ¯´≡­±‗¾¶§÷¸°¨·¹³²■ "
+    SPECIAL_ASCII_EXTENDED = SPECIAL_ASCII + "ø£Ø׃ªº¿®¬½¼¡«»░▒▓│┤©╣║╗╝¢¥┐└┴┬├─┼╚╔╩╦╠═╬¤ðÐı┘┌█▄¦▀µþÞ¯´≡­±‗¾¶§÷¸°¨·¹³²■ "
     """All ASCII special characters with the extended ASCII special characters."""
-    standard_ascii: str = special_ascii + digits + letters
+    STANDARD_ASCII = SPECIAL_ASCII + DIGITS + LETTERS
     """All standard ASCII characters."""
-    full_ascii: str = special_ascii_extended + digits + letters_extended
+    FULL_ASCII = SPECIAL_ASCII_EXTENDED + DIGITS + LETTERS_EXTENDED
     """All characters in the ASCII table."""
 
 
 class ANSI:
-    """Constants and class-methods for use of ANSI escape codes."""
+    """Constants and methods for use of ANSI escape codes"""
 
-    escaped_char: str = "\\x1b"
+    ESCAPED_CHAR = "\\x1b"
     """The printable ANSI escape character."""
     CHAR = char = "\x1b"
     """The ANSI escape character."""
@@ -100,12 +93,12 @@ class ANSI:
         """Generate an ANSI sequence with `parts` amount of placeholders."""
         return cls.CHAR + cls.START + cls.SEP.join(["{}" for _ in range(parts)]) + cls.END
 
-    seq_color: FormattableString = CHAR + START + "38" + SEP + "2" + SEP + "{}" + SEP + "{}" + SEP + "{}" + END
+    SEQ_COLOR: FormattableString = CHAR + START + "38" + SEP + "2" + SEP + "{}" + SEP + "{}" + SEP + "{}" + END
     """The ANSI escape sequence for setting the text RGB color."""
-    seq_bg_color: FormattableString = CHAR + START + "48" + SEP + "2" + SEP + "{}" + SEP + "{}" + SEP + "{}" + END
+    SEQ_BG_COLOR: FormattableString = CHAR + START + "48" + SEP + "2" + SEP + "{}" + SEP + "{}" + SEP + "{}" + END
     """The ANSI escape sequence for setting the background RGB color."""
 
-    color_map: tuple[str, ...] = (
+    COLOR_MAP: tuple[str, ...] = (
         ########### DEFAULT CONSOLE COLOR NAMES ############
         "black",
         "red",
@@ -118,7 +111,7 @@ class ANSI:
     )
     """The console default color names."""
 
-    codes_map: dict[str | tuple[str, ...], int] = {
+    CODES_MAP: dict[str | tuple[str, ...], int] = {
         ################# SPECIFIC RESETS ##################
         "_": 0,
         ("_bold", "_b"): 22,

xulbux-1.8.1/src/xulbux/cli/help.py

@@ -0,0 +1,45 @@
+from .. import __version__
+from ..base.consts import COLOR
+from ..format_codes import FormatCodes
+from ..console import Console
+
+
+CLR = {
+    "class": COLOR.TANGERINE,
+    "const": COLOR.RED,
+    "func": COLOR.CYAN,
+    "import": COLOR.NEON_GREEN,
+    "lib": COLOR.ORANGE,
+    "punctuators": COLOR.DARK_GRAY,
+    "code_border": COLOR.GRAY,
+}
+HELP = FormatCodes.to_ansi(
+    rf"""  [_|b|#7075FF]               __  __
+  [b|#7075FF]  _  __ __  __/ / / /_  __  ___  __
+  [b|#7075FF] | |/ // / / / / / __ \/ / / | |/ /
+  [b|#7075FF] > , </ /_/ / /_/ /_/ / /_/ /> , <
+  [b|#7075FF]/_/|_|\____/\__/\____/\____//_/|_|  [*|BG:{COLOR.GRAY}|#000] v[b]{__version__} [*]
+
+  [i|{COLOR.CORAL}]A TON OF COOL FUNCTIONS, YOU NEED![*]
+
+  [b|#FCFCFF]Usage:[*]
+  [dim|{CLR['code_border']}](╭────────────────────────────────────────────────────╮)
+  [dim|{CLR['code_border']}](│) [{CLR['punctuators']}]# LIBRARY CONSTANTS[*]                                [dim|{CLR['code_border']}](│)
+  [dim|{CLR['code_border']}](│) [{CLR['import']}]from [{CLR['lib']}]xulbux[{CLR['punctuators']}].[{CLR['lib']}]base[{CLR['punctuators']}].[{CLR['lib']}]consts [{CLR['import']}]import [{CLR['const']}]COLOR[{CLR['punctuators']}], [{CLR['const']}]CHARS[{CLR['punctuators']}], [{CLR['const']}]ANSI[*]  [dim|{CLR['code_border']}](│)
+  [dim|{CLR['code_border']}](│) [{CLR['punctuators']}]# Main Classes[*]                                     [dim|{CLR['code_border']}](│)
+  [dim|{CLR['code_border']}](│) [{CLR['import']}]from [{CLR['lib']}]xulbux [{CLR['import']}]import [{CLR['class']}]Code[{CLR['punctuators']}], [{CLR['class']}]Color[{CLR['punctuators']}], [{CLR['class']}]Console[{CLR['punctuators']}], ...[*]       [dim|{CLR['code_border']}](│)
+  [dim|{CLR['code_border']}](│) [{CLR['punctuators']}]# module specific imports[*]                          [dim|{CLR['code_border']}](│)
+  [dim|{CLR['code_border']}](│) [{CLR['import']}]from [{CLR['lib']}]xulbux[{CLR['punctuators']}].[{CLR['lib']}]color [{CLR['import']}]import [{CLR['func']}]rgba[{CLR['punctuators']}], [{CLR['func']}]hsla[{CLR['punctuators']}], [{CLR['func']}]hexa[*]          [dim|{CLR['code_border']}](│)
+  [dim|{CLR['code_border']}](╰────────────────────────────────────────────────────╯)
+  [b|#FCFCFF]Documentation:[*]
+  [dim|{CLR['code_border']}](╭────────────────────────────────────────────────────╮)
+  [dim|{CLR['code_border']}](│) [#DADADD]For more information see the GitHub page.          [dim|{CLR['code_border']}](│)
+  [dim|{CLR['code_border']}](│) [u|#8085FF](https://github.com/XulbuX/PythonLibraryXulbuX/wiki) [dim|{CLR['code_border']}](│)
+  [dim|{CLR['code_border']}](╰────────────────────────────────────────────────────╯)
+  [_]"""
+)
+
+
+def show_help() -> None:
+    print(HELP)
+    Console.pause_exit(pause=True, prompt="  [dim](Press any key to exit...)\n\n")

xulbux-1.7.3/src/xulbux/xx_code.py → xulbux-1.8.1/src/xulbux/code.py

@@ -1,6 +1,6 @@
-from .xx_string import String
-from .xx_regex import Regex
-from .xx_data import Data
+from .string import String
+from .regex import Regex
+from .data import Data
 
 import regex as _rx