xulbux 1.6.1__py3-none-any.whl

xulbux/__init__.py

@@ -0,0 +1,57 @@
+"""
+ >>> import xulbux as xx
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  • 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 THE ENV PATH VAR  xx.EnvPath
+  • CONSOLE LOG AND ACTIONS  xx.Console
+  • EASY PRETTY PRINTING     xx.FormatCodes
+  • WORKING WITH COLORS      xx.Color
+  • DATA OPERATIONS          xx.Data
+  • STRING OPERATIONS        xx.String
+  • CODE STRING OPERATIONS   xx.Code
+  • REGEX PATTERN TEMPLATES  xx.Regex
+"""
+
+__version__ = "1.6.1"
+__author__ = "XulbuX"
+__email__ = "xulbux.real@gmail.com"
+__license__ = "MIT"
+__copyright__ = "Copyright (c) 2024 XulbuX"
+__url__ = "https://github.com/XulbuX-dev/PythonLibraryXulbuX"
+__description__ = "A library which includes a lot of really helpful functions."
+__all__ = [
+    "_consts_",
+    "xx_console",
+    "xx_code",
+    "xx_color",
+    "xx_data",
+    "xx_env_path",
+    "xx_file",
+    "xx_format_codes",
+    "xx_json",
+    "xx_path",
+    "xx_regex",
+    "xx_string",
+    "xx_system",
+]
+
+from ._consts_ import *
+from .xx_code import *
+from .xx_color import *
+from .xx_console import *
+from .xx_data import *
+from .xx_env_path import *
+from .xx_file import *
+from .xx_format_codes import *
+from .xx_json import *
+from .xx_path import *
+from .xx_regex import *
+from .xx_string import *
+from .xx_system import *

xulbux/_cli_.py

@@ -0,0 +1,53 @@
+from . import __version__
+from ._consts_ import DEFAULT
+from .xx_format_codes import FormatCodes
+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"],
+    }
+    FormatCodes.print(
+        rf"""  [_|b|#7075FF]               __  __
+  [b|#7075FF]  _  __ __  __/ / / /_  __  ___  __
+  [b|#7075FF] | |/ // / / / / / __ \/ / / | |/ /
+  [b|#7075FF] > , </ /_/ / /_/ /_/ / /_/ /> , <
+  [b|#7075FF]/_/|_|\____/\__/\____/\____//_/|_|  [*|BG:{DEFAULT.color['gray']}|#000] v[b]{__version__} [*]
+
+  [i|{DEFAULT.color['coral']}]A TON OF COOL FUNCTIONS, YOU NEED![*]
+
+  [b|#75A2FF]Usage:[*]
+    [{color['punctuators']}]# GENERAL LIBRARY[*]
+    [{color['import']}]import [{color['lib']}]xulbux [{color['import']}]as [{color['lib']}]xx[*]
+    [{color['punctuators']}]# CUSTOM TYPES[*]
+    [{color['import']}]from [{color['lib']}]xulbux [{color['import']}]import [{color['lib']}]rgba[{color['punctuators']}], [{color['lib']}]hsla[{color['punctuators']}], [{color['lib']}]hexa[*]
+
+  [b|#75A2FF]Includes:[*]
+    [dim](•) CUSTOM TYPES:
+       [dim](•) [{color['class']}]rgba[{color['punctuators']}]/([i|{color['types']}]int[_|{color['punctuators']}],[i|{color['types']}]int[_|{color['punctuators']}],[i|{color['types']}]int[_|{color['punctuators']}],[i|{color['types']}]float[_|{color['punctuators']}])[*]
+       [dim](•) [{color['class']}]hsla[{color['punctuators']}]/([i|{color['types']}]int[_|{color['punctuators']}],[i|{color['types']}]int[_|{color['punctuators']}],[i|{color['types']}]int[_|{color['punctuators']}],[i|{color['types']}]float[_|{color['punctuators']}])[*]
+       [dim](•) [{color['class']}]hexa[{color['punctuators']}]/([i|{color['types']}]str[_|{color['punctuators']}]|[i|{color['types']}]int[_|{color['punctuators']}])[*]
+    [dim](•) PATH OPERATIONS          [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Path[*]
+    [dim](•) FILE OPERATIONS          [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]File[*]
+    [dim](•) JSON FILE OPERATIONS     [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Json[*]
+    [dim](•) SYSTEM ACTIONS           [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]System[*]
+    [dim](•) MANAGE THE ENV PATH VAR  [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]EnvPath[*]
+    [dim](•) CONSOLE LOG AND ACTIONS  [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Console[*]
+    [dim](•) EASY PRETTY PRINTING     [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]FormatCodes[*]
+    [dim](•) WORKING WITH COLORS      [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Color[*]
+    [dim](•) DATA OPERATIONS          [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Data[*]
+    [dim](•) STRING OPERATIONS        [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]String[*]
+    [dim](•) CODE STRING OPERATIONS   [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Code[*]
+    [dim](•) REGEX PATTERN TEMPLATES  [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Regex[*]
+  [_]
+  [dim](Press any key to exit...)
+  """,
+        default_color=DEFAULT.text_color,
+    )
+    Console.pause_exit(pause=True)

xulbux/_consts_.py

@@ -0,0 +1,145 @@
+class DEFAULT:
+
+    text_color: str = "#95B5FF"
+    color: dict[str, str] = {
+        "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": "#3EE6DE",
+        "ice": "#77EFEF",
+        "lightblue": "#60AAFF",
+        "blue": "#8085FF",
+        "lavender": "#9B7DFF",
+        "purple": "#AD68FF",
+        "magenta": "#C860FF",
+        "pink": "#EE60BB",
+        "rose": "#FF6090",
+    }
+
+
+class CHARS:
+
+    # CODE TO SIGNAL, ALL CHARACTERS ARE ALLOWED
+    all = "<*allowed>"
+
+    # DIGIT SETS
+    digits = "0123456789"
+    float_digits = digits + "."
+    hex_digits = digits + "#abcdefABCDEF"
+
+    # LETTER CATEGORIES
+    lowercase = "abcdefghijklmnopqrstuvwxyz"
+    lowercase_extended = lowercase + "äëïöüÿàèìòùáéíóúýâêîôûãñõåæç"
+    uppercase = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"
+    uppercase_extended = uppercase + "ÄËÏÖÜÀÈÌÒÙÁÉÍÓÚÝÂÊÎÔÛÃÑÕÅÆÇß"
+
+    # COMBINED LETTER SETS
+    letters = lowercase + uppercase
+    letters_extended = lowercase_extended + uppercase_extended
+
+    # ASCII sets
+    special_ascii = " !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~"
+    special_ascii_extended = special_ascii + "ø£Ø׃ªº¿®¬½¼¡«»░▒▓│┤©╣║╗╝¢¥┐└┴┬├─┼╚╔╩╦╠═╬¤ðÐı┘┌█▄¦▀µþÞ¯´≡­±‗¾¶§÷¸°¨·¹³²■ "
+    standard_ascii = special_ascii + digits + letters
+    full_ascii = special_ascii_extended + digits + letters_extended
+
+
+class ANSI:
+
+    global CHAR, START, SEP, END
+
+    char_esc = r"\x1b"
+    CHAR = char = "\x1b"
+    START = start = "["
+    SEP = sep = ";"
+    END = end = "m"
+    modifier = {"lighten": "+l", "darken": "-d"}
+
+    def seq(parts: int = 1) -> str:
+        """Generate an ANSI sequence with `parts` amount of placeholders."""
+        return CHAR + START + SEP.join(["{}" for _ in range(parts)]) + END
+
+    seq_color: str = CHAR + START + "38" + SEP + "2" + SEP + "{}" + SEP + "{}" + SEP + "{}" + END
+    seq_bg_color: str = 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] = {
+        ###################### 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 FORMATS ###################
+        ("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 CONSOLE COLORS ##############
+        "black": 30,
+        "red": 31,
+        "green": 32,
+        "yellow": 33,
+        "blue": 34,
+        "magenta": 35,
+        "cyan": 36,
+        "white": 37,
+        ########## BRIGHT DEFAULT CONSOLE COLORS ###########
+        ("bright:black", "br:black"): 90,
+        ("bright:red", "br:red"): 91,
+        ("bright:green", "br:green"): 92,
+        ("bright:yellow", "br:yellow"): 93,
+        ("bright:blue", "br:blue"): 94,
+        ("bright:magenta", "br:magenta"): 95,
+        ("bright:cyan", "br:cyan"): 96,
+        ("bright:white", "br:white"): 97,
+        ######## DEFAULT CONSOLE 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 CONSOLE BACKGROUND COLORS #####
+        ("bg:bright:black", "bg:br:black"): 100,
+        ("bg:bright:red", "bg:br:red"): 101,
+        ("bg:bright:green", "bg:br:green"): 102,
+        ("bg:bright:yellow", "bg:br:yellow"): 103,
+        ("bg:bright:blue", "bg:br:blue"): 104,
+        ("bg:bright:magenta", "bg:br:magenta"): 105,
+        ("bg:bright:cyan", "bg:br:cyan"): 106,
+        ("bg:bright:white", "bg:br:white"): 107,
+    }

xulbux/xx_code.py

@@ -0,0 +1,105 @@
+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))