xulbux 1.5.5__tar.gz → 1.5.7__tar.gz

xulbux-1.5.7/.github/workflows/python-package.yml

@@ -0,0 +1,49 @@
+# THIS WORKFLOW WILL INSTALL PYTHON DEPENDENCIES, RUN TESTS AND LINT WITH A VARIETY OF PYTHON VERSIONS
+# FOR MORE INFORMATION SEE: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python
+
+name: Python package
+
+on:
+  push:
+    branches: ["main"]
+  pull_request:
+    branches: ["main"]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.10", "3.11", "3.12", "3.13"]
+
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Set up Python ${{ matrix.python-version }}
+      uses: actions/setup-python@v3
+      with:
+        python-version: ${{ matrix.python-version }}
+
+    - name: Cache pip packages
+      uses: actions/cache@v3
+      with:
+        path: ~/.cache/pip
+        key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt', '**/pyproject.toml') }}
+        restore-keys: |
+          ${{ runner.os }}-pip-
+
+    - name: Install project and dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -e .[dev]  # INSTALL PROJECT AND DEV DEPENDENCIES
+        pip install flake8 pytest  # ENSURE BOTH flake8 AND pytest ARE INSTALLED
+
+    - name: Lint with flake8
+      run: |
+        python -m flake8 . --count --select=E9,F63,F7,F82 --show-source --statistics
+        python -m flake8 . --count --exit-zero --max-complexity=10 --max-line-length=127 --statistics
+
+    - name: Test with pytest
+      run: |
+        python -m pytest --verbose  # RUN pytest USING PYTHON MODULE TO AVOID PATH ISSUES

xulbux-1.5.7/.gitignore

@@ -0,0 +1,31 @@
+# Python bytecode
+__pycache__/
+*.py[cod]
+*$py.class
+
+# Distribution / packaging
+.Python
+wheels/
+build/
+dist/
+
+# PyBuilder
+.pybuilder/
+target/
+
+.python-version
+
+# PEP 582
+__pypackages__/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# VS Code
+.vscode/
+
+# Pytest
+.pytest_cache/

{xulbux-1.5.5 → xulbux-1.5.7}/CHANGELOG.md

@@ -7,7 +7,7 @@
       border-radius: 0.2em;
       text-align: center;
       justify-content: center;
-    ">🠫</div>
+    "><span style="display:none">go to bottom </span>🠫</div>
   </abbr></a>
 </div>
 
@@ -15,17 +15,33 @@
 # <br><b>Changelog</b><br>
 
 
-## ... `v1.5.5`
+## 15.11.2024 `v1.5.7`
+* Change the testing modules to be able to run together with the library `pytest`
+* Added formatting checks, using `black`, `isort` and `flake8`
+* Added the script (*command*) `xx-help` or `xulbux-help`
+* Moved the `help()` function to the file `_cli_.py`, because that's where all the scripts are located (*It also was renamed to* `help_command()`)
+* Structured `Cmd.restricted_input()` a bit nicer, so it appears less complex
+* Corrected code after `Lint with flake8` formatting suggestions
+* Moved the function `normalize_spaces()` to `xx_string`
+* Added additional tests for the custom color types
+* Updated the whole `xx_format_codes` module for more efficiency and speed
+
+## 11.11.2024 `v1.5.6`
+* Moved the whole library to it's own repository: [PythonLibraryXulbuX](https://github.com/XulbuX-dev/PythonLibraryXulbuX)
+* Updated all connections and links
+
+## 11.11.2024 `v1.5.5`
 * Added functions to get the width and height of the console (*in characters and lines*):<br>
   <code>Cmd.w() -> *int*</code> how many text characters the console is wide<br>
   <code>Cmd.h() -> *int*</code> how many lines the console is high<br>
   <code>Cmd.wh() -> *tuple[int,int]*</code> a tuple with width and height
-* Added the function <code>split_every_chars(*string*, *split_every*) -> *list*[*str*]</code> to `xx_string`
+* Added the function <code>split_count(*string*, *count*) -> *list*[*str*]</code> to `xx_string`
 * Added doc-strings to every function in `xx_string`
 * Updated the `Cmd.restricted_input()` function:
   - paste text from the clipboard
   - select all text to delete everything at once
   - write and backspace over multiple lines
+  - not the prompt supports custom format codes
 * Added required non-standard libraries to the project file
 * Added more metadata to the project file
 
@@ -282,6 +298,6 @@ from XulbuX import rgb, hsl, hexa
       border-radius: 0.2em;
       text-align: center;
       justify-content: center;
-    ">🠩</div>
+    "><span style="display:none">go to top </span>🠩</div>
   </abbr></a>
 </div>

{xulbux-1.5.5 → xulbux-1.5.7}/PKG-INFO

@@ -1,12 +1,12 @@
 Metadata-Version: 2.3
 Name: XulbuX
-Version: 1.5.5
+Version: 1.5.7
 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
+Project-URL: Homepage, https://github.com/XulbuX-dev/PythonLibraryXulbuX
+Project-URL: Bug Reports, https://github.com/XulbuX-dev/PythonLibraryXulbuX/issues
+Project-URL: Documentation, https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki
+Project-URL: Source Code, https://github.com/XulbuX-dev/PythonLibraryXulbuX/tree/main/src
+Project-URL: Changelog, https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/CHANGELOG.md
 Author-email: XulbuX <xulbux.real@gmail.com>
 License: MIT License
         
@@ -29,7 +29,7 @@ License: MIT License
         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
+Keywords: classes,cmd,code,color,data,env,environment,file,format,functions,helper,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
@@ -41,17 +41,21 @@ 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: pyperclip>=1.9.0
 Requires-Dist: regex>=2023.10.3
 Provides-Extra: dev
-Requires-Dist: pytest>=7.0; extra == 'dev'
+Requires-Dist: black>=23.7.0; 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'
 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).
+For the libraries latest changes, see the [change log](https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/CHANGELOG.md).<br>
+For precise information about the library, see the library's [Wiki page](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki).
 
 
 ## Installation

{xulbux-1.5.5 → xulbux-1.5.7}/README.md

@@ -2,8 +2,8 @@
 
 **$\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).
+For the libraries latest changes, see the [change log](https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/CHANGELOG.md).<br>
+For precise information about the library, see the library's [Wiki page](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki).
 
 
 ## Installation

xulbux-1.5.7/documentation.md

@@ -0,0 +1,369 @@
+<div id="top" style="width:45px; height:45px; right:10px; top:10px; position:absolute">
+  <a href="#bottom"><abbr title="go to bottom" style="text-decoration:none">
+    <div style="
+      font-size: 2em;
+      font-weight: bold;
+      background: #88889845;
+      border-radius: 0.2em;
+      text-align: center;
+      justify-content: center;
+    "><span style="display:none">go to bottom </span>🠫</div>
+  </abbr></a>
+</div>
+<br>
+
+
+**$\color{#8085FF}\Huge\textsf{XulbuX}$**
+
+-------------------------------------------------------------
+
+**$\color{#8085FF}\textsf{XulbuX}$** is a library which includes a lot of really helpful classes, types and functions.<br>
+For the libraries latest changes, see the [change log](https://github.com/XulbuX-dev/Python/blob/main/Libraries/XulbuX/CHANGELOG.md).
+
+
+
+# Installation
+
+
+Open a console and run the command:
+```css
+pip install XulbuX
+```
+This should install the latest version of the library, along with some other required libraries.<br>
+To upgrade the library (*if there is a new release*) run the following command in your console:
+```css
+pip install --upgrade XulbuX
+```
+
+
+
+# Usage
+
+
+This imports the full library under the alias `xx`, so it"s classes, types and functions are accessible with `xx.Class.method()`, `xx.type()` and `xx.function()`:
+```python
+import XulbuX as xx
+```
+So you don"t have to write `xx` in front of the library"s types, you can import them directly:
+```python
+from XulbuX import rgba, hsla, hexa
+```
+
+
+
+# Modules
+
+
+## xx_color
+
+### `rgba()`
+An RGB/RGBA color: is a tuple of 3 integers, representing the red (`0`-`255`), green (`0`-`255`), and blue (`0`-`255`).<br>
+It also includes an optional 4th param, which is a float, that represents the alpha channel (`0.0`-`1.0`):
+```python
+rgba(
+    r: int,
+    g: int,
+    b: int,
+    a: float = None
+)
+```
+Includes methods:
+- `to_hsla()` to convert to HSL color
+- `to_hexa()` to convert to HEX color
+- `has_alpha()` to check if the color has an alpha channel
+- `lighten(amount)` to create a lighter version of the color
+- `darken(amount)` to create a darker version of the color
+- `saturate(amount)` to increase color saturation
+- `desaturate(amount)` to decrease color saturation
+- `rotate(degrees)` to rotate the hue by degrees
+- `invert()` to get the inverse color
+- `grayscale()` to convert to grayscale
+- `blend(other, ratio)` to blend with another color
+- `is_dark()` to check if the color is considered dark
+- `is_light()` to check if the color is considered light
+- `is_grayscale()` to check if the color is grayscale
+- `is_opaque()` to check if the color has no transparency
+- `with_alpha(alpha)` to create a new color with different alpha
+- `complementary()` to get the complementary color
+<br>
+
+### `hsla()`
+A HSL/HSLA color: is a tuple of 3 integers, representing hue (`0`-`360`), saturation (`0`-`100`), and lightness (`0`-`100`).<br>
+It also includes an optional 4th param, which is a float, that represents the alpha channel (`0.0`-`1.0`).\n
+```python
+hsla(
+    h: int,
+    s: int,
+    l: int,
+    a: float = None
+)
+```
+Includes methods:
+- `to_rgba()` to convert to RGB color
+- `to_hexa()` to convert to HEX color
+- `has_alpha()` to check if the color has an alpha channel
+- `lighten(amount)` to create a lighter version of the color
+- `darken(amount)` to create a darker version of the color
+- `saturate(amount)` to increase color saturation
+- `desaturate(amount)` to decrease color saturation
+- `rotate(degrees)` to rotate the hue by degrees
+- `invert()` to get the inverse color
+- `grayscale()` to convert to grayscale
+- `blend(other, ratio)` to blend with another color
+- `is_dark()` to check if the color is considered dark
+- `is_light()` to check if the color is considered light
+- `is_grayscale()` to check if the color is grayscale
+- `is_opaque()` to check if the color has no transparency
+- `with_alpha(alpha)` to create a new color with different alpha
+- `complementary()` to get the complementary color
+<br>
+
+### `hexa()`
+A HEX color: is a string representing a hexadecimal color code with optional alpha channel.
+```python
+hexa(
+    color: str | int
+)
+```
+Supports formats: RGB, RGBA, RRGGBB, RRGGBBAA (*with or without prefix*)<br>
+Includes methods:
+- `to_rgba()` to convert to RGB color
+- `to_hsla()` to convert to HSL color
+- `has_alpha()` to check if the color has an alpha channel
+- `lighten(amount)` to create a lighter version of the color
+- `darken(amount)` to create a darker version of the color
+- `saturate(amount)` to increase color saturation
+- `desaturate(amount)` to decrease color saturation
+- `rotate(degrees)` to rotate the hue by degrees
+- `invert()` to get the inverse color
+- `grayscale()` to convert to grayscale
+- `blend(other, ratio)` to blend with another color
+- `is_dark()` to check if the color is considered dark
+- `is_light()` to check if the color is considered light
+- `is_grayscale()` to check if the color is grayscale
+- `is_opaque()` to check if the color has no transparency
+- `with_alpha(alpha)` to create a new color with different alpha
+- `complementary()` to get the complementary color
+<br>
+
+
+
+## xx_cmd
+
+
+### `Cmd`
+This class includes functions for logging and other actions within the console.
+<br>
+
+#### `Cmd.get_args()`
+----------------------
+This function is used to get the command arguments, for if the current file is run via the console as a command.<br>
+**Params:**<br>
+- <code>find_args: *dict*</code> a dictionary that specifies, which arguments you are looking for and under which alias they should be returned if found. This dictionary could look something like this:
+  ```python
+  {
+      "filepath": ["-f", "--file", "-p", "--path", "-fp", "--filepath", "--file-path"],
+      "help":     ["-h", "--help"],
+      "debug":    ["-d", "--debug"]
+  }
+  ```
+  For this example, the command line could look like this:
+  ```bash
+  python main.py -f /path/to/file -d
+  ```
+  To get one value, you can allow multiple arguments, just like for the filepath in the above example.
+
+**Returns:**<br>
+The function will return a dictionary, with the specified aliases and two values per alias:
+1. `"exists"` is `True`  if one of the listed arguments is found and `False` otherwise
+2. `"value"` is the value of the argument (`None` *if the argument has no value*)
+
+So for the example command line from above, the function would return a dictionary:
+```python
+{
+    "filepath": { "exists": True, "value": "/path/to/file" },
+    "help":     { "exists": False, "value": None },
+    "debug":    { "exists": True, "value": None }
+}
+```
+<br>
+
+#### `Cmd.user()`
+------------------
+**Returns:** the username of the user of the current console session
+<br>
+
+#### `Cmd.is_admin()`
+----------------------
+**Returns:** `True` if the current console session is run as administrator and `False` otherwise
+<br>
+
+#### `Cmd.pause_exit()`
+------------------------
+Will print a prompt and then pause and/or exit the program.<br>
+**Params:**
+- <code>pause: *bool*</code> whether to pause the program at the message or not
+- <code>exit: *bool*</code> whether to exit the program after the message was printed (*and the program was unpaused if* `pause` *is true*) or not
+- <code>prompt: *str*</code> the prompt to print before pausing and/or exiting the program
+- <code>exit_code: *int*</code> the exit code to use if `exit` is true
+- <code>reset_ansi: *bool*</code> whether to reset the ANSI codes after the message was printed
+<br>
+
+#### `Cmd.cls()`
+-----------------
+Will clear the console in addition to completely resetting the ANSI formats.
+<br>
+
+#### <span id="cmd-log">`Cmd.log()`</span>
+-----------------
+Will print a nicely formatted log message.<br>
+**Params:**
+- <code>title: *str*</code> the title of the log message
+- <code>prompt: *object*</code> the prompt to print before the log message
+- <code>start: *str*</code> the string to print before the log message
+- <code>end: *str*</code> the string to print after the log message (*default* `\n`)
+- <code>title_bg_color: *hexa*|*rgba*</code> the background color of the title
+- <code>default_color: *hexa*|*rgba*</code> the default color of the log message
+The log message supports special formatting codes. For more detailed information about formatting codes, see the [`xx_format_codes` documentation](#xx_format_codes).
+<br>
+
+#### `Cmd.debug()` `Cmd.info()` `Cmd.done()` `Cmd.warn()` `Cmd.fail()` `Cmd.exit()`
+-----------------------------------------------------------------------------------------
+These functions are all presets for the [`Cmd.log()`](#cmd-log) function, with the options to pause at the message and exit the program after the message was printed. That means, they have the same params as the `Cmd.log()` function, with the two additional ones.<br>
+**Additional Params:**
+- <code>pause: *bool*</code> whether to pause the program at the message or not (*different default depending on the log preset*)
+- <code>exit: *bool*</code> whether to exit the program after the message was printed (*and the program was unpaused if* `pause` *is true*) or not (*different default depending on the log preset*)
+<br>
+
+#### `Cmd.confirm()`
+---------------------
+This function can be used to ask a yes/no question.<br>
+Like in the [`Cmd.log()`](#cmd-log) function it is possible to use special formatting codes inside the `prompt`.<br>
+**Params:**
+- <code>prompt: *object*</code> the prompt to print before the question
+- <code>start: *str*</code> the string to print before the question
+- <code>end: *str*</code> the string to print after the question (*default* `\n`)
+- <code>default_color: *hexa*|*rgba*</code> the default color of the question
+- <code>default_is_yes: *bool*</code> whether the default answer is yes or no (*if the user continues without entering anything or an unrecognized answer*)
+
+**Returns:**
+- `True` if the user enters `Y` or `yes` and `False` otherwise
+- If the user entered nothing:
+  - `True` if `default_is_yes` is true
+  - `False` if `default_is_yes` is false
+<br>
+
+#### <span id="cmd-restricted_input">`Cmd.restricted_input()`</span>
+------------------------------
+This function acts like a standard Python `input()` with the advantage, that you can specify:
+- what text characters the user is allowed to type and
+- the minimum and/or maximum length of the users input
+- optional mask character (hide user input, e.g. for passwords)
+- reset the ANSI formatting codes after the user continues
+
+Like in the [`Cmd.log()`](#cmd-log) function it is possible to use special formatting codes inside the `prompt`.<br>
+**Params:**
+- <code>prompt: *object*</code> the prompt to print before the input
+- <code>allowed_chars: *str*</code> the allowed text characters the user can type (*default is all characters*)
+- <code>min_length: *int*</code> the minimum length of the users input (*user can not confirm the input before this length is reached*)
+- <code>max_length: *int*</code> the maximum length of the users input (*user cannot keep on writing if this length is reached*)
+- <code>mask_char: *str*</code> the mask character to hide the users input
+- <code>reset_ansi: *bool*</code> whether to reset the ANSI formatting codes after the user continues
+
+**Returns:** the user's entry as a string
+<br>
+
+#### `Cmd.pwd_input()`
+This function almost works like the [`Cmd.restricted_input()`](#cmd-restricted_input) function, but it always hides the users input.<br>
+It has no additional parameters.<br>
+
+
+
+## xx_code
+
+
+### `Code`
+This class includes functions, used to work with strings, that are code.
+<br>
+
+#### `Code.add_indent()`
+-------------------------
+This function will add `indent` spaces at the beginning of each line.<br>
+**Params:**
+- <code>code: *str*</code> the string to add the indent to
+- <code>indent: *int*</code> the amount of spaces to add (*default* `4`)
+
+**Returns:** the indented string
+<br>
+
+#### `Code.get_tab_spaces()`
+-----------------------------
+This function will try to get the amount of spaces that are used for indentation.<br>
+**Params:**
+- <code>code: *str*</code> the string to get the tab spaces from
+
+**Returns:** the amount of spaces used for indentation
+<br>
+
+#### `Code.change_tab_size()`
+------------------------------
+This function will change the amount of spaces used for indentation.<br>
+**Params:**
+- <code>code: *str*</code> the string to change the tab size of
+- <code>new_tab_size: *int*</code> the amount of spaces to use for indentation
+- <code>remove_empty_lines: *bool*</code> whether to remove empty lines in the process
+
+**Returns:** the string with the new tab size (*and no empty lines if* `remove_empty_lines` *is true*)
+<br>
+
+#### `Code.get_func_calls()`
+This function will try to get all the function calls (*JavaScript, Python, etc. style functions*).<br>
+**Params:**
+- <code>code: *str*</code> the string to get the function calls from
+
+**Returns:** a list of function calls
+<br>
+
+#### `Code.is_js()`
+This function will check if the code is likely to be JavaScript.<br>
+**Params:**
+- <code>code: *str*</code> the string to check
+
+**Returns:** `True` if the code is likely to be JavaScript and `False` otherwise
+
+
+
+
+
+#### `String.normalize_spaces()`
+-------------------------------
+This function will replace all special space characters with normal spaces.<br>
+**Params:**
+- <code>code: *str*</code> the string to normalize
+- <code>tab_spaces: *int*</code> the amount of spaces to replace tab characters with (*default* `4`)
+
+**Returns:** the normalized string
+<br>
+
+
+
+
+
+<br id="bottom">
+<br>
+
+--------------------------------------------------------------
+[View this library on PyPI](https://pypi.org/project/XulbuX/)
+
+<div style="width:45px; height:45px; right:10px; position:absolute">
+  <a href="#top"><abbr title="go to top" style="text-decoration:none">
+    <div style="
+      font-size: 2em;
+      font-weight: bold;
+      background: #88889845;
+      border-radius: 0.2em;
+      text-align: center;
+      justify-content: center;
+    "><span style="display:none">go to top </span>🠩</div>
+  </abbr></a>
+</div>

xulbux-1.5.7/pyproject.toml

@@ -0,0 +1,117 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "XulbuX"
+version = "1.5.7"
+authors = [{ name = "XulbuX", email = "xulbux.real@gmail.com" }]
+description = "A library which includes a lot of really helpful functions."
+readme = "README.md"
+license = { file = "LICENSE" }
+changelog = "CHANGELOG.md"
+requires-python = ">=3.10.0"
+dependencies = [
+  "keyboard>=0.13.5",
+  "mouse>=0.7.1",
+  "pyperclip>=1.9.0",
+  "regex>=2023.10.3",
+]
+optional-dependencies = { dev = [
+  "pytest>=7.4.2",
+  "black>=23.7.0",
+  "isort>=5.12.0",
+  "flake8>=6.1.0",
+] }
+classifiers = [
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+keywords = [
+  "xulbux",
+  "python",
+  "library",
+  "utility",
+  "helper",
+  "functions",
+  "tools",
+  "classes",
+  "types",
+  "methods",
+  "cmd",
+  "code",
+  "color",
+  "data",
+  "structures",
+  "env",
+  "environment",
+  "file",
+  "format",
+  "json",
+  "path",
+  "regex",
+  "string",
+  "system",
+  "operations",
+  "presets",
+]
+
+[project.urls]
+"Homepage" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX"
+"Bug Reports" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/issues"
+"Documentation" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki"
+"Source Code" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/tree/main/src"
+"Changelog" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/CHANGELOG.md"
+
+[project.scripts]
+xx-help = "XulbuX._cli_:help_command"
+xulbux-help = "XulbuX._cli_:help_command"
+
+[tool.black]
+line-length = 127
+target-version = ['py310', 'py311', 'py312', 'py313']
+include = '\.pyi?$'
+extend-exclude = '''
+/(
+  # directories
+  \.eggs
+  | \.git
+  | \.hg
+  | \.mypy_cache
+  | \.tox
+  | \.venv
+  | build
+  | dist
+)/
+'''
+
+[tool.isort]
+profile = "black"
+line_length = 127
+multi_line_output = 3
+include_trailing_comma = true
+force_grid_wrap = 0
+use_parentheses = true
+ensure_newline_before_comments = true
+
+[tool.flake8]
+max-line-length = 127
+extend-ignore = ["E203", "E266", "E501", "W503", "E303"]
+max-complexity = 18
+select = ["B", "C", "E", "F", "W", "T4", "B9"]
+per-file-ignores = ["__init__.py:F401,F403"]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/xulbux"]
+
+[tool.pytest.ini_options]
+minversion = "7.0"
+addopts = "-ra -q"
+pythonpath = ["src"]
+testpaths = ["tests/test_cmd_info.py", "tests/test_color_types.py"]