xulbux 1.6.4__tar.gz → 1.6.6__tar.gz

{xulbux-1.6.4/src/xulbux.egg-info → xulbux-1.6.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: xulbux
-Version: 1.6.4
+Version: 1.6.6
 Summary: A library which includes a lot of really helpful functions.
 Author-email: XulbuX <xulbux.real@gmail.com>
 License: MIT License
@@ -25,12 +25,12 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
-Project-URL: Bug Reports, https://github.com/XulbuX-dev/PythonLibraryXulbuX/issues
-Project-URL: Changelog, https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/CHANGELOG.md
-Project-URL: Documentation, https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki
-Project-URL: Homepage, https://github.com/XulbuX-dev/PythonLibraryXulbuX
-Project-URL: License, https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/LICENSE
-Project-URL: Source Code, https://github.com/XulbuX-dev/PythonLibraryXulbuX/tree/main/src
+Project-URL: Bug Reports, https://github.com/XulbuX/PythonLibraryXulbuX/issues
+Project-URL: Changelog, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md
+Project-URL: Documentation, https://github.com/XulbuX/PythonLibraryXulbuX/wiki
+Project-URL: Homepage, https://github.com/XulbuX/PythonLibraryXulbuX
+Project-URL: License, https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE
+Project-URL: Source Code, https://github.com/XulbuX/PythonLibraryXulbuX/tree/main/src
 Keywords: xulbux,python,library,utility,helper,functions,tools,classes,types,methods,cmd,console,code,color,data,structures,env,environment,file,format,json,path,regex,string,system,operations,presets
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
@@ -45,6 +45,7 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 Requires-Dist: keyboard>=0.13.5
 Requires-Dist: mouse>=0.7.1
+Requires-Dist: prompt_toolkit>=3.0.41
 Requires-Dist: pyperclip>=1.9.0
 Requires-Dist: regex>=2023.10.3
 Provides-Extra: dev
@@ -52,13 +53,14 @@ Requires-Dist: pytest>=7.4.2; extra == "dev"
 Requires-Dist: black>=23.7.0; extra == "dev"
 Requires-Dist: isort>=5.12.0; extra == "dev"
 Requires-Dist: flake8>=6.1.0; extra == "dev"
+Requires-Dist: flake8-pyproject>=1.2.3; extra == "dev"
 
 # **$\color{#8085FF}\Huge\textsf{XulbuX}$**
 
 **$\color{#8085FF}\textsf{XulbuX}$** is a library which includes a lot of really helpful classes, types and functions.
 
-For precise information about the library, see the library's [Wiki page](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki).<br>
-For the libraries latest changes, see the [change log](https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/CHANGELOG.md).
+For precise information about the library, see the library's [Wiki page](https://github.com/XulbuX/PythonLibraryXulbuX/wiki).<br>
+For the libraries latest changes, see the [change log](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md).
 
 
 ## Installation
@@ -90,17 +92,17 @@ from xulbux import rgba, hsla, hexa
 
 | | |
 | :--------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------- |
-| <h3>[`xx_code`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_code)</h3>                 | advanced code-string operations (*changing the indent, finding function calls, ...*)               |
-| <h3>[`xx_color`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_color)</h3>               | everything around colors (*converting, blending, searching colors in strings, ...*)                |
-| <h3>[`xx_console`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_console)</h3>           | advanced actions related to the console (*pretty logging, advanced inputs, ...*)                   |
-| <h3>[`xx_data`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_data)</h3>                 | advanced operations with data structures (*compare, generate path ID's, pretty print/format, ...*) |
-| <h3>[`xx_env_path`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_env_path)</h3>         | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)               |
-| <h3>[`xx_file`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_file)</h3>                 | advanced working with files (*create files, rename file-extensions, ...*)                          |
-| <h3>[`xx_format_codes`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_format_codes)</h3> | easy pretty printing with custom format codes (*print, inputs, custom format codes to ANSI, ...*)  |
+| <h3>[`xx_code`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_code)</h3>                 | advanced code-string operations (*changing the indent, finding function calls, ...*)               |
+| <h3>[`xx_color`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_color)</h3>               | everything around colors (*converting, blending, searching colors in strings, ...*)                |
+| <h3>[`xx_console`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_console)</h3>           | advanced actions related to the console (*pretty logging, advanced inputs, ...*)                   |
+| <h3>[`xx_data`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_data)</h3>                 | advanced operations with data structures (*compare, generate path ID's, pretty print/format, ...*) |
+| <h3>[`xx_env_path`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_env_path)</h3>         | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)               |
+| <h3>[`xx_file`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_file)</h3>                 | advanced working with files (*create files, rename file-extensions, ...*)                          |
+| <h3>[`xx_format_codes`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_format_codes)</h3> | easy pretty printing with custom format codes (*print, inputs, custom format codes to ANSI, ...*)  |
 | <h3>`xx_json`</h3>                                                                                   | advanced working with json files (*read, create, update, ...*)                                     |
 | <h3>`xx_path`</h3>                                                                                   | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)             |
 | <h3>`xx_regex`</h3>                                                                                  | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)            |
-| <h3>[`xx_string`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_string)</h3>             | helpful actions when working with strings. (*normalize, escape, decompose, ...*)                   |
+| <h3>[`xx_string`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_string)</h3>             | helpful actions when working with strings. (*normalize, escape, decompose, ...*)                   |
 | <h3>`xx_system`</h3>                                                                                 | advanced system actions (*restart with message, check installed Python libs, ...*)                 |
 
 

{xulbux-1.6.4 → xulbux-1.6.6}/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 precise information about the library, see the library's [Wiki page](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki).<br>
-For the libraries latest changes, see the [change log](https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/CHANGELOG.md).
+For precise information about the library, see the library's [Wiki page](https://github.com/XulbuX/PythonLibraryXulbuX/wiki).<br>
+For the libraries latest changes, see the [change log](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md).
 
 
 ## Installation
@@ -35,17 +35,17 @@ from xulbux import rgba, hsla, hexa
 
 | | |
 | :--------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------- |
-| <h3>[`xx_code`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_code)</h3>                 | advanced code-string operations (*changing the indent, finding function calls, ...*)               |
-| <h3>[`xx_color`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_color)</h3>               | everything around colors (*converting, blending, searching colors in strings, ...*)                |
-| <h3>[`xx_console`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_console)</h3>           | advanced actions related to the console (*pretty logging, advanced inputs, ...*)                   |
-| <h3>[`xx_data`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_data)</h3>                 | advanced operations with data structures (*compare, generate path ID's, pretty print/format, ...*) |
-| <h3>[`xx_env_path`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_env_path)</h3>         | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)               |
-| <h3>[`xx_file`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_file)</h3>                 | advanced working with files (*create files, rename file-extensions, ...*)                          |
-| <h3>[`xx_format_codes`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_format_codes)</h3> | easy pretty printing with custom format codes (*print, inputs, custom format codes to ANSI, ...*)  |
+| <h3>[`xx_code`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_code)</h3>                 | advanced code-string operations (*changing the indent, finding function calls, ...*)               |
+| <h3>[`xx_color`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_color)</h3>               | everything around colors (*converting, blending, searching colors in strings, ...*)                |
+| <h3>[`xx_console`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_console)</h3>           | advanced actions related to the console (*pretty logging, advanced inputs, ...*)                   |
+| <h3>[`xx_data`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_data)</h3>                 | advanced operations with data structures (*compare, generate path ID's, pretty print/format, ...*) |
+| <h3>[`xx_env_path`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_env_path)</h3>         | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)               |
+| <h3>[`xx_file`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_file)</h3>                 | advanced working with files (*create files, rename file-extensions, ...*)                          |
+| <h3>[`xx_format_codes`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_format_codes)</h3> | easy pretty printing with custom format codes (*print, inputs, custom format codes to ANSI, ...*)  |
 | <h3>`xx_json`</h3>                                                                                   | advanced working with json files (*read, create, update, ...*)                                     |
 | <h3>`xx_path`</h3>                                                                                   | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)             |
 | <h3>`xx_regex`</h3>                                                                                  | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)            |
-| <h3>[`xx_string`](https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki/xx_string)</h3>             | helpful actions when working with strings. (*normalize, escape, decompose, ...*)                   |
+| <h3>[`xx_string`](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_string)</h3>             | helpful actions when working with strings. (*normalize, escape, decompose, ...*)                   |
 | <h3>`xx_system`</h3>                                                                                 | advanced system actions (*restart with message, check installed Python libs, ...*)                 |
 
 

{xulbux-1.6.4 → xulbux-1.6.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xulbux"
-version = "1.6.4"
+version = "1.6.6"
 authors = [{ name = "XulbuX", email = "xulbux.real@gmail.com" }]
 description = "A library which includes a lot of really helpful functions."
 readme = "README.md"
@@ -13,6 +13,7 @@ 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",
 ]
@@ -21,6 +22,7 @@ optional-dependencies = { dev = [
   "black>=23.7.0",
   "isort>=5.12.0",
   "flake8>=6.1.0",
+  "flake8-pyproject>=1.2.3",
 ] }
 classifiers = [
   "Intended Audience :: Developers",
@@ -63,12 +65,12 @@ keywords = [
 ]
 
 [project.urls]
-"Bug Reports" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/issues"
-"Changelog" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/CHANGELOG.md"
-"Documentation" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/wiki"
-"Homepage" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX"
-"License" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/blob/main/LICENSE"
-"Source Code" = "https://github.com/XulbuX-dev/PythonLibraryXulbuX/tree/main/src"
+"Bug Reports" = "https://github.com/XulbuX/PythonLibraryXulbuX/issues"
+"Changelog" = "https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md"
+"Documentation" = "https://github.com/XulbuX/PythonLibraryXulbuX/wiki"
+"Homepage" = "https://github.com/XulbuX/PythonLibraryXulbuX"
+"License" = "https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/LICENSE"
+"Source Code" = "https://github.com/XulbuX/PythonLibraryXulbuX/tree/main/src"
 
 
 [project.scripts]
@@ -103,11 +105,11 @@ use_parentheses = true
 ensure_newline_before_comments = true
 
 [tool.flake8]
+max-complexity = 12
 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"]
+select = ["E", "F", "W", "C90"]
+extend-ignore = ["E203", "E266", "W503"]
+per-file-ignores = ["__init__.py:F403,F405"]
 
 [tool.setuptools]
 packages = ["xulbux"]

{xulbux-1.6.4 → xulbux-1.6.6}/src/xulbux/__init__.py

@@ -19,12 +19,12 @@
   • REGEX PATTERN TEMPLATES  xx.Regex
 """
 
-__version__ = "1.6.4"
+__version__ = "1.6.6"
 __author__ = "XulbuX"
 __email__ = "xulbux.real@gmail.com"
 __license__ = "MIT"
 __copyright__ = "Copyright (c) 2024 XulbuX"
-__url__ = "https://github.com/XulbuX-dev/PythonLibraryXulbuX"
+__url__ = "https://github.com/XulbuX/PythonLibraryXulbuX"
 __description__ = "A library which includes a lot of really helpful functions."
 __all__ = [
     "_consts_",

{xulbux-1.6.4 → xulbux-1.6.6}/src/xulbux/_cli_.py

@@ -1,5 +1,5 @@
 from . import __version__
-from ._consts_ import DEFAULT
+from ._consts_ import COLOR
 from .xx_format_codes import FormatCodes
 from .xx_console import Console
 
@@ -7,20 +7,20 @@ from .xx_console import Console
 def help_command():
     """Show some info about the library, with a brief explanation of how to use it."""
     color = {
-        "lib": DEFAULT.color["ice"],
-        "import": DEFAULT.color["red"],
-        "class": DEFAULT.color["lavender"],
-        "types": DEFAULT.color["lightblue"],
-        "punctuators": DEFAULT.color["darkgray"],
+        "lib": COLOR.ice,
+        "import": COLOR.red,
+        "class": COLOR.lavender,
+        "types": COLOR.lightblue,
+        "punctuators": COLOR.darkgray,
     }
     FormatCodes.print(
         rf"""  [_|b|#7075FF]               __  __
   [b|#7075FF]  _  __ __  __/ / / /_  __  ___  __
   [b|#7075FF] | |/ // / / / / / __ \/ / / | |/ /
   [b|#7075FF] > , </ /_/ / /_/ /_/ / /_/ /> , <
-  [b|#7075FF]/_/|_|\____/\__/\____/\____//_/|_|  [*|BG:{DEFAULT.color['gray']}|#000] v[b]{__version__} [*]
+  [b|#7075FF]/_/|_|\____/\__/\____/\____//_/|_|  [*|BG:{COLOR.gray}|#000] v[b]{__version__} [*]
 
-  [i|{DEFAULT.color['coral']}]A TON OF COOL FUNCTIONS, YOU NEED![*]
+  [i|{COLOR.coral}]A TON OF COOL FUNCTIONS, YOU NEED![*]
 
   [b|#75A2FF]Usage:[*]
     [{color['punctuators']}]# GENERAL LIBRARY[*]
@@ -48,6 +48,6 @@ def help_command():
   [_]
   [dim](Press any key to exit...)
   """,
-        default_color=DEFAULT.text_color,
+        default_color=COLOR.text
     )
     Console.pause_exit(pause=True)

xulbux-1.6.6/src/xulbux/_consts_.py

@@ -0,0 +1,158 @@
+from dataclasses import dataclass
+from typing import TypeAlias
+
+
+FormattableString: TypeAlias = str
+
+
+@dataclass
+class COLOR:
+    """Color presets used in the XulbuX library."""
+
+    text = "#A5D6FF"
+    white = "#F1F2FF"
+    lightgray = "#B6B7C0"
+    gray = "#7B7C8D"
+    darkgray = "#67686C"
+    black = "#202125"
+    red = "#FF606A"
+    coral = "#FF7069"
+    orange = "#FF876A"
+    tangerine = "#FF9962"
+    gold = "#FFAF60"
+    yellow = "#FFD260"
+    green = "#7EE787"
+    teal = "#50EAAF"
+    cyan = "#3EDEE6"
+    ice = "#77DBEF"
+    lightblue = "#60AAFF"
+    blue = "#8085FF"
+    lavender = "#9B7DFF"
+    purple = "#AD68FF"
+    magenta = "#C860FF"
+    pink = "#F162EF"
+    rose = "#FF609F"
+
+
+class _AllTextCharacters:
+    pass
+
+
+@dataclass
+class CHARS:
+    """Strings with only certain text characters."""
+
+    # CODE TO SIGNAL, ALL CHARACTERS ARE ALLOWED
+    all = _AllTextCharacters
+
+    # DIGIT SETS
+    digits: str = "0123456789"
+    float_digits: str = digits + "."
+    hex_digits: str = digits + "#abcdefABCDEF"
+
+    # LETTER CATEGORIES
+    lowercase: str = "abcdefghijklmnopqrstuvwxyz"
+    lowercase_extended: str = lowercase + "äëïöüÿàèìòùáéíóúýâêîôûãñõåæç"
+    uppercase: str = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+    uppercase_extended: str = uppercase + "ÄËÏÖÜÀÈÌÒÙÁÉÍÓÚÝÂÊÎÔÛÃÑÕÅÆÇß"
+
+    # COMBINED LETTER SETS
+    letters: str = lowercase + uppercase
+    letters_extended: str = lowercase_extended + uppercase_extended
+
+    # ASCII sets
+    special_ascii: str = " !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~"
+    special_ascii_extended: str = special_ascii + "ø£Ø׃ªº¿®¬½¼¡«»░▒▓│┤©╣║╗╝¢¥┐└┴┬├─┼╚╔╩╦╠═╬¤ðÐı┘┌█▄¦▀µþÞ¯´≡­±‗¾¶§÷¸°¨·¹³²■ "
+    standard_ascii: str = special_ascii + digits + letters
+    full_ascii: str = special_ascii_extended + digits + letters_extended
+
+
+class ANSI:
+    """Constants and class-methods for use of ANSI escape codes."""
+
+    escaped_char: str = "\\x1b"
+    CHAR = char = "\x1b"
+    START = start = "["
+    SEP = sep = ";"
+    END = end = "m"
+    default_color_modifiers: dict[str, str] = {"lighten": "+l", "darken": "-d"}
+
+    @classmethod
+    def seq(cls, parts: int = 1) -> str:
+        """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_bg_color: FormattableString = CHAR + START + "48" + SEP + "2" + SEP + "{}" + SEP + "{}" + SEP + "{}" + END
+
+    color_map: list[str] = [
+        ########### DEFAULT CONSOLE COLOR NAMES ############
+        "black",
+        "red",
+        "green",
+        "yellow",
+        "blue",
+        "magenta",
+        "cyan",
+        "white",
+    ]
+
+    codes_map: dict[str | tuple[str, ...], int] = {
+        ################# SPECIFIC RESETS ##################
+        "_": 0,
+        ("_bold", "_b"): 22,
+        ("_dim", "_d"): 22,
+        ("_italic", "_i"): 23,
+        ("_underline", "_u"): 24,
+        ("_double-underline", "_du"): 24,
+        ("_inverse", "_invert", "_in"): 27,
+        ("_hidden", "_hide", "_h"): 28,
+        ("_strikethrough", "_s"): 29,
+        ("_color", "_c"): 39,
+        ("_background", "_bg"): 49,
+        ################### TEXT STYLES ####################
+        ("bold", "b"): 1,
+        ("dim", "d"): 2,
+        ("italic", "i"): 3,
+        ("underline", "u"): 4,
+        ("inverse", "invert", "in"): 7,
+        ("hidden", "hide", "h"): 8,
+        ("strikethrough", "s"): 9,
+        ("double-underline", "du"): 21,
+        ################## DEFAULT COLORS ##################
+        "black": 30,
+        "red": 31,
+        "green": 32,
+        "yellow": 33,
+        "blue": 34,
+        "magenta": 35,
+        "cyan": 36,
+        "white": 37,
+        ############## BRIGHT DEFAULT COLORS ###############
+        "br:black": 90,
+        "br:red": 91,
+        "br:green": 92,
+        "br:yellow": 93,
+        "br:blue": 94,
+        "br:magenta": 95,
+        "br:cyan": 96,
+        "br:white": 97,
+        ############ DEFAULT BACKGROUND COLORS #############
+        "bg:black": 40,
+        "bg:red": 41,
+        "bg:green": 42,
+        "bg:yellow": 43,
+        "bg:blue": 44,
+        "bg:magenta": 45,
+        "bg:cyan": 46,
+        "bg:white": 47,
+        ######### BRIGHT DEFAULT BACKGROUND COLORS #########
+        "bg:br:black": 100,
+        "bg:br:red": 101,
+        "bg:br:green": 102,
+        "bg:br:yellow": 103,
+        "bg:br:blue": 104,
+        "bg:br:magenta": 105,
+        "bg:br:cyan": 106,
+        "bg:br:white": 107,
+    }

xulbux-1.6.6/src/xulbux/xx_code.py

@@ -0,0 +1,100 @@
+from .xx_string import String
+from .xx_regex import Regex
+from .xx_data import Data
+
+import regex as _rx
+
+
+class Code:
+
+    @staticmethod
+    def add_indent(code: str, indent: int) -> str:
+        """Adds `indent` spaces at the beginning of each line."""
+        indented_lines = [" " * indent + line for line in code.splitlines()]
+        return "\n".join(indented_lines)
+
+    @staticmethod
+    def get_tab_spaces(code: str) -> int:
+        """Will try to get the amount of spaces used for indentation."""
+        code_lines = String.get_lines(code, remove_empty_lines=True)
+        indents = [len(line) - len(line.lstrip()) for line in code_lines]
+        non_zero_indents = [i for i in indents if i > 0]
+        return min(non_zero_indents) if non_zero_indents else 0
+
+    @staticmethod
+    def change_tab_size(code: str, new_tab_size: int, remove_empty_lines: bool = False) -> str:
+        """Replaces all tabs with `new_tab_size` spaces.\n
+        ----------------------------------------------------------------------------------
+        If `remove_empty_lines` is `True`, empty lines will be removed in the process."""
+        code_lines = String.get_lines(code, remove_empty_lines=True)
+        lines = code_lines if remove_empty_lines else String.get_lines(code)
+        tab_spaces = Code.get_tab_spaces(code)
+        if (tab_spaces == new_tab_size) or tab_spaces == 0:
+            if remove_empty_lines:
+                return "\n".join(code_lines)
+            return code
+        result = []
+        for line in lines:
+            stripped = line.lstrip()
+            indent_level = (len(line) - len(stripped)) // tab_spaces
+            new_indent = " " * (indent_level * new_tab_size)
+            result.append(new_indent + stripped)
+        return "\n".join(result)
+
+    @staticmethod
+    def get_func_calls(code: str) -> list:
+        """Will try to get all function calls and return them as a list."""
+        funcs = _rx.findall(r"(?i)" + Regex.func_call(), code)
+        nested_func_calls = []
+        for _, func_attrs in funcs:
+            nested_calls = _rx.findall(r"(?i)" + Regex.func_call(), func_attrs)
+            if nested_calls:
+                nested_func_calls.extend(nested_calls)
+        return Data.remove_duplicates(funcs + nested_func_calls)
+
+    @staticmethod
+    def is_js(code: str, funcs: list = ["__", "$t", "$lang"]) -> bool:
+        """Will check if the code is very likely to be JavaScript."""
+        funcs = "|".join(funcs)
+        js_pattern = _rx.compile(
+            Regex.outside_strings(
+                r"""^(?:
+                (\$[\w_]+)\s*                      # JQUERY-STYLE VARIABLES
+                |(\$[\w_]+\s*\()                   # JQUERY-STYLE FUNCTION CALLS
+                |((""" + funcs + r")" + Regex.brackets("()") + r"""\s*) # PREDEFINED FUNCTION CALLS
+                |(\bfunction\s*\()                 # FUNCTION DECLARATIONS
+                |(\b(var|let|const)\s+[\w_]+\s*=)  # VARIABLE DECLARATIONS
+                |(\b(if|for|while|switch)\s*\()    # CONTROL STRUCTURES
+                |(\b(return|throw)\s+)             # RETURN OR THROW STATEMENTS
+                |(\bnew\s+[\w_]+\()                # OBJECT INSTANTIATION
+                |(\b[\w_]+\s*=>\s*{)               # ARROW FUNCTIONS
+                |(\b(true|false|null|undefined)\b) # JAVASCRIPT LITERALS
+                |(\b(document|window|console)\.)   # BROWSER OBJECTS
+                |(\b[\w_]+\.(forEach|map|filter|reduce)\() # ARRAY METHODS
+                |(/[^/\n\r]*?/[gimsuy]*)           # REGULAR EXPRESSIONS
+                |(===|!==|\+\+|--|\|\||&&)         # JAVASCRIPT-SPECIFIC OPERATORS
+                |(\bclass\s+[\w_]+)                # CLASS DECLARATIONS
+                |(\bimport\s+.*?from\s+)           # IMPORT STATEMENTS
+                |(\bexport\s+(default\s+)?)        # EXPORT STATEMENTS
+                |(\basync\s+function)              # ASYNC FUNCTIONS
+                |(\bawait\s+)                      # AWAIT KEYWORD
+                |(\btry\s*{)                       # TRY-CATCH BLOCKS
+                |(\bcatch\s*\()
+                |(\bfinally\s*{)
+                |(\byield\s+)                      # GENERATOR FUNCTIONS
+                |(\[.*?\]\s*=)                     # DESTRUCTURING ASSIGNMENT
+                |(\.\.\.)                          # SPREAD OPERATOR
+                |(==|!=|>=|<=|>|<)                 # COMPARISON OPERATORS
+                |(\+=|-=|\*=|/=|%=|\*\*=)          # COMPOUND ASSIGNMENT OPERATORS
+                |(\+|-|\*|/|%|\*\*)                # ARITHMETIC OPERATORS
+                |(&|\||\^|~|<<|>>|>>>)             # BITWISE OPERATORS
+                |(\?|:)                            # TERNARY OPERATOR
+                |(\bin\b)                          # IN OPERATOR
+                |(\binstanceof\b)                  # INSTANCEOF OPERATOR
+                |(\bdelete\b)                      # DELETE OPERATOR
+                |(\btypeof\b)                      # TYPEOF OPERATOR
+                |(\bvoid\b)                        # VOID OPERATOR
+                )[\s\S]*$"""
+            ), _rx.VERBOSE | _rx.IGNORECASE
+        )
+        return bool(js_pattern.fullmatch(code))