xulbux 1.5.5__py3-none-any.whl

xulbux/__help__.py

@@ -0,0 +1,74 @@
+try: from ._consts_ import DEFAULT
+except: from _consts_ import DEFAULT
+try: from .xx_format_codes import *
+except: from xx_format_codes import *
+try: from .xx_cmd import *
+except: from xx_cmd import *
+
+import os as _os
+
+
+
+
+def get_version(file:str = '__init__.py', var:str = '__version__') -> str:
+    try:
+        from . import var
+        return var
+    except ImportError:
+        init_path = _os.path.join(_os.path.dirname(__file__), file)
+        if _os.path.isfile(init_path):
+            with open(init_path, encoding='utf-8') as f:
+                for line in f:
+                    if line.startswith(var): return line.split('=')[-1].strip().strip('\'"')
+        return 'unknown'
+
+def help():
+    """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]{get_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']}])[*]
+    [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 ENVIRONMENT VARS  [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Env_vars[*]
+    [dim](•) CMD LOG AND ACTIONS      [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Cmd[*]
+    [dim](•) PRETTY PRINTING          [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]FormatCodes[*]
+    [dim](•) COLOR OPERATIONS         [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Color[*]
+    [dim](•) DATA OPERATIONS          [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Data[*]
+    [dim](•) STR 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.text_color)
+    Cmd.pause_exit(pause=True)
+
+
+
+if __name__ == '__main__':
+    help()

xulbux/__init__.py

@@ -0,0 +1,47 @@
+"""
+ >>> 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 ENVIRONMENT VARS  xx.EnvVars
+  • CMD LOG AND ACTIONS      xx.Cmd
+  • PRETTY PRINTING          xx.FormatCodes
+  • COLOR OPERATIONS         xx.Color
+  • DATA OPERATIONS          xx.Data
+  • STR OPERATIONS           xx.String
+  • CODE STRING OPERATIONS   xx.Code
+  • REGEX PATTERN TEMPLATES  xx.Regex
+"""
+
+__version__ = '1.5.5'
+__author__ = 'XulbuX'
+__email__ = 'xulbux.real@gmail.com'
+__license__ = 'MIT'
+__copyright__ = 'Copyright (c) 2024 XulbuX'
+__url__ = 'https://github.com/XulbuX-dev/Python/tree/main/Libraries/XulbuX'
+__description__ = 'A library which includes a lot of really helpful functions.'
+__all__ = [
+    '__help__', '_consts_', 'xx_cmd', 'xx_code', 'xx_color', 'xx_data', 'xx_env_vars', 'xx_file',
+    'xx_format_codes', 'xx_json', 'xx_path', 'xx_regex', 'xx_string', 'xx_system'
+]
+
+from .__help__ import help
+from ._consts_ import *
+from .xx_cmd import *
+from .xx_code import *
+from .xx_color import *
+from .xx_data import *
+from .xx_env_vars 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/_consts_.py

@@ -0,0 +1,147 @@
+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  = char  = '\x1b'
+    START = start = '['
+    SEP   = sep   = ';'
+    END   = end   = 'm'
+
+    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_cmd.py

@@ -0,0 +1,240 @@
+"""
+Functions for logging and other small actions within the console:
+- `Cmd.get_args()`
+- `Cmd.user()`
+- `Cmd.is_admin()`
+- `Cmd.pause_exit()`
+- `Cmd.cls()`
+- `Cmd.log()`
+- `Cmd.debug()`
+- `Cmd.info()`
+- `Cmd.done()`
+- `Cmd.warn()`
+- `Cmd.fail()`
+- `Cmd.exit()`
+- `Cmd.confirm()`
+- `Cmd.restricted_input()`
+- `Cmd.pwd_input()`\n
+----------------------------------------------------------------------------------------------------------
+You can also use special formatting codes directly inside the log message to change their appearance.<br>
+For more detailed information about formatting codes, see the the `xx_format_codes` description.
+"""
+
+
+from ._consts_ import DEFAULT, CHARS
+from .xx_format_codes import *
+from .xx_string import *
+from .xx_color import *
+
+from contextlib import suppress
+import subprocess as _subprocess
+import pyperclip as _pyperclip
+import keyboard as _keyboard
+import getpass as _getpass
+import ctypes as _ctypes
+import shutil as _shutil
+import mouse as _mouse
+import sys as _sys
+import os as _os
+
+
+
+
+class Cmd:
+
+    @staticmethod
+    def get_args(find_args:dict) -> dict:
+        args = _sys.argv[1:]
+        results = {}
+        for arg_key, arg_group in find_args.items():
+            value = None
+            exists = False
+            for arg in arg_group:
+                if arg in args:
+                    exists = True
+                    arg_index = args.index(arg)
+                    if arg_index + 1 < len(args) and not args[arg_index + 1].startswith('-'):
+                        value = String.to_type(args[arg_index + 1])
+                    break
+            results[arg_key] = {'exists': exists, 'value': value}
+        return results
+
+    def w() -> int: return getattr(_shutil.get_terminal_size(), 'columns', 80)
+    def h() -> int: return getattr(_shutil.get_terminal_size(), 'lines', 24)
+    def wh() -> tuple[int,int]: return Cmd.w(), Cmd.h()
+    def user() -> str: return _os.getenv('USER') or _os.getenv('USERNAME') or _getpass.getuser()
+
+    @staticmethod
+    def is_admin() -> bool:
+        try:
+            if _os.name == 'nt':
+                return _ctypes.windll.shell32.IsUserAnAdmin() != 0
+            elif _os.name == 'posix':
+                return _os.geteuid() == 0
+            else:
+                return False
+        except:
+            return False
+
+    @staticmethod
+    def pause_exit(pause:bool = False, exit:bool = False, last_prompt:object = '', exit_code:int = 0, reset_ansi:bool = False) -> None:
+        """Will print the `last_prompt` and then pause the program if `pause` is set<br>
+        to `True` and after the pause, exit the program if `exit` is set to `True`."""
+        print(last_prompt, end='', flush=True)
+        if reset_ansi: FormatCodes.print('[_]', end='')
+        if pause: _keyboard.read_event()
+        if exit: _sys.exit(exit_code)
+
+    @staticmethod
+    def cls() -> None:
+        """Will clear the console in addition to completely resetting the ANSI formats."""
+        if _shutil.which('cls'): _os.system('cls')
+        elif _shutil.which('clear'): _os.system('clear')
+        print('\033[0m', end='', flush=True)
+
+    @staticmethod
+    def log(title:str, prompt:object, start:str = '', end:str = '\n', title_bg_color:hexa|rgba = None, default_color:hexa|rgba = None) -> None:
+        """Will print a formatted log message:<br>
+        `title` -⠀the title of the log message (e.g. `DEBUG`, `WARN`, `FAIL`, etc.)<br>
+        `prompt` -⠀the log message<br>
+        `start` -⠀something to print before the log is printed<br>
+        `end` -⠀something to print after the log is printed (e.g. `\\n\\n`)<br>
+        `title_bg_color` -⠀the background color of the `title`<br>
+        `default_color` -⠀the default text color of the `prompt`\n
+        --------------------------------------------------------------------------------
+        The log message supports special formatting codes. For more detailed<br>
+        information about formatting codes, see `xx_format_codes` class description."""
+        title_color = '_color' if not title_bg_color else Color.text_color_for_on_bg(title_bg_color)
+        if title: FormatCodes.print(f'{start}  [bold][{title_color}]{f"[BG:{title_bg_color}]" if title_bg_color else ""} {title.upper()}: [_]\t{f"[{default_color}]" if default_color else ""}{str(prompt)}[_]', default_color, end=end)
+        else: FormatCodes.print(f'{start}  {f"[{default_color}]" if default_color else ""}{str(prompt)}[_]', default_color, end=end)
+
+    @staticmethod
+    def debug(prompt:object = 'Point in program reached.', active:bool = True, start:str = '\n', end:str = '\n\n', title_bg_color:hexa|rgba = DEFAULT.color['yellow'], default_color:hexa|rgba = DEFAULT.text_color, pause:bool = False, exit:bool = False) -> None:
+        """A preset for `log()`: `DEBUG` log message with the options to pause<br>
+        at the message and exit the program after the message was printed."""
+        if active:
+            Cmd.log('DEBUG', prompt, start, end, title_bg_color, default_color)
+            Cmd.pause_exit(pause, exit)
+
+    @staticmethod
+    def info(prompt:object = 'Program running.', start:str = '\n', end:str = '\n\n', title_bg_color:hexa|rgba = DEFAULT.color['blue'], default_color:hexa|rgba = DEFAULT.text_color, pause:bool = False, exit:bool = False) -> None:
+        """A preset for `log()`: `INFO` log message with the options to pause<br>
+        at the message and exit the program after the message was printed."""
+        Cmd.log('INFO', prompt, start, end, title_bg_color, default_color)
+        Cmd.pause_exit(pause, exit)
+
+    @staticmethod
+    def done(prompt:object = 'Program finished.', start:str = '\n', end:str = '\n\n', title_bg_color:hexa|rgba = DEFAULT.color['teal'], default_color:hexa|rgba = DEFAULT.text_color, pause:bool = False, exit:bool = False) -> None:
+        """A preset for `log()`: `DONE` log message with the options to pause<br>
+        at the message and exit the program after the message was printed."""
+        Cmd.log('DONE', prompt, start, end, title_bg_color, default_color)
+        Cmd.pause_exit(pause, exit)
+
+    @staticmethod
+    def warn(prompt:object = 'Important message.', start:str = '\n', end:str = '\n\n', title_bg_color:hexa|rgba = DEFAULT.color['orange'], default_color:hexa|rgba = DEFAULT.text_color, pause:bool = False, exit:bool = False) -> None:
+        """A preset for `log()`: `WARN` log message with the options to pause<br>
+        at the message and exit the program after the message was printed."""
+        Cmd.log('WARN', prompt, start, end, title_bg_color, default_color)
+        Cmd.pause_exit(pause, exit)
+
+    @staticmethod
+    def fail(prompt:object = 'Program error.', start:str = '\n', end:str = '\n\n', title_bg_color:hexa|rgba = DEFAULT.color['red'], default_color:hexa|rgba = DEFAULT.text_color, pause:bool = False, exit:bool = True, reset_ansi=True) -> None:
+        """A preset for `log()`: `FAIL` log message with the options to pause<br>
+        at the message and exit the program after the message was printed."""
+        Cmd.log('FAIL', prompt, start, end, title_bg_color, default_color)
+        Cmd.pause_exit(pause, exit, reset_ansi=reset_ansi)
+
+    @staticmethod
+    def exit(prompt:object = 'Program ended.', start:str = '\n', end:str = '\n\n', title_bg_color:hexa|rgba = DEFAULT.color['magenta'], default_color:hexa|rgba = DEFAULT.text_color, pause:bool = False, exit:bool = True, reset_ansi=True) -> None:
+        """A preset for `log()`: `EXIT` log message with the options to pause<br>
+        at the message and exit the program after the message was printed."""
+        Cmd.log('EXIT', prompt, start, end, title_bg_color, default_color)
+        Cmd.pause_exit(pause, exit, reset_ansi=reset_ansi)
+
+    @staticmethod
+    def input(prompt:object = '', default_color:hexa|rgba = DEFAULT.color['cyan']) -> None:
+        """Acts like a standard Python `input()` but the prompt can be formatted with special formatting codes.<br>
+        For more detailed information about formatting codes, see the `xx_format_codes` description."""
+        return input(FormatCodes.to_ansi(str(prompt), default_color))
+
+    @staticmethod
+    def confirm(prompt:object = 'Do you want to continue?', start = '\n', end = '\n', default_color:hexa|rgba = DEFAULT.color['cyan'], default_is_yes:bool = True) -> None:
+        """Ask a yes/no question.\n
+        -----------------------------------------------------------------------------------
+        The question can be formatted with special formatting codes. For more detailed<br>
+        information about formatting codes, see the `xx_format_codes` description."""
+        confirmed = input(FormatCodes.to_ansi(f'{start}  {str(prompt)} [_|dim](({"Y" if default_is_yes else "y"}/{"n" if default_is_yes else "N"}):  )', default_color)).strip().lower() in (('', 'y', 'yes') if default_is_yes else ('y', 'yes'))
+        if end: Cmd.log('', '') if end == '\n' else Cmd.log('', end[1:]) if end.startswith('\n') else Cmd.log('', end)
+        return confirmed
+
+    @staticmethod
+    def restricted_input(prompt:object = '', allowed_chars:str = CHARS.all, min_length:int = None, max_length:int = None, mask_char:str = None) -> str|None:
+        """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)\n
+        -----------------------------------------------------------------------------------
+        The input can be formatted with special formatting codes. For more detailed<br>
+        information about formatting codes, see the `xx_format_codes` description."""
+        print(prompt, end='', flush=True)
+        result, select_all, last_line_count, last_console_width = '', False, 1, 0
+        def filter_pasted_text(text:str) -> str:
+            if allowed_chars == CHARS.all: return text
+            return ''.join(char for char in text if char in allowed_chars)
+        def update_display(console_width:int) -> None:
+            nonlocal select_all, last_line_count, last_console_width
+            lines = String.split_every_chars(str(prompt) + (mask_char * len(result) if mask_char else result), console_width)
+            line_count = len(lines)
+            if (line_count > 1 or line_count < last_line_count) and not last_line_count == 1:
+                if last_console_width > console_width: line_count *= 2
+                for _ in range(line_count if line_count < last_line_count and not line_count > last_line_count else line_count - 2 if line_count > last_line_count else line_count - 1):
+                    _sys.stdout.write('\033[2K\r\033[A')
+            prompt_len = len(str(prompt)) if prompt else 0
+            prompt_str, input_str = lines[0][:prompt_len], lines[0][prompt_len:] if len(lines) == 1 else '\n'.join([lines[0][prompt_len:]] + lines[1:])  # SEPARATE THE PROMPT AND THE INPUT
+            _sys.stdout.write('\033[2K\r' + prompt_str + ('\033[7m' if select_all else '') + input_str + '\033[0m')
+            last_line_count, last_console_width = line_count, console_width
+        while True:
+            event = _keyboard.read_event()
+            if event.event_type == 'down':
+                if event.name == 'enter':
+                    if min_length is not None and len(result) < min_length:
+                        continue
+                    print()
+                    return result.rstrip('\n')
+                elif event.name in ('backspace', 'delete', 'entf'):
+                    if select_all: result, select_all = '', False
+                    elif result and event.name == 'backspace':
+                        result = result[:-1]
+                    update_display(Cmd.w())
+                elif (event.name == 'v' and _keyboard.is_pressed('ctrl')) or _mouse.is_pressed('right'):
+                    if select_all: result, select_all = '', False
+                    filtered_text = filter_pasted_text(_pyperclip.paste())
+                    if max_length is None or len(result) + len(filtered_text) <= max_length:
+                        result += filtered_text
+                        update_display(Cmd.w())
+                elif event.name == 'a' and _keyboard.is_pressed('ctrl'):
+                    select_all = True
+                    update_display(Cmd.w())
+                elif event.name == 'c' and _keyboard.is_pressed('ctrl') and select_all:
+                    with suppress(KeyboardInterrupt):  # PREVENT CTRL+C FROM RAISING A `KeyboardInterrupt` EXCEPTION
+                        select_all = False
+                        update_display(Cmd.w())
+                        _pyperclip.copy(result)
+                elif event.name == 'esc':
+                    return
+                elif event.name == 'space':
+                    if (allowed_chars == CHARS.all or ' ' in allowed_chars) and (max_length is None or len(result) < max_length):
+                        result += ' '
+                        update_display(Cmd.w())
+                elif len(event.name) == 1:
+                    if (allowed_chars == CHARS.all or event.name in allowed_chars) and (max_length is None or len(result) < max_length):
+                        result += event.name
+                        update_display(Cmd.w())
+                else:  # ANY DISALLOWED OR NON-DEFINED KEY PRESSED
+                    select_all = False
+                    update_display(Cmd.w())
+
+    @staticmethod
+    def pwd_input(prompt:object = 'Password: ', allowed_chars:str = CHARS.standard_ascii, min_length:int = None, max_length:int = None) -> str:
+        """Password input that masks the entered characters with asterisks."""
+        return Cmd.restricted_input(prompt, allowed_chars, min_length, max_length, mask_char='*')

xulbux/xx_code.py

@@ -0,0 +1,102 @@
+from .xx_string import *
+from .xx_regex import *
+from .xx_data import *
+
+import regex as _rx
+
+
+
+
+class Code:
+
+    @staticmethod
+    def normalize_spaces(string:str, tab_spaces:int = 4) -> str:
+        """Replaces all special space characters with normal spaces.<br>
+        Also replaces tab characters with `tab_spaces` spaces."""
+        return string.replace('\t', ' ' * tab_spaces).replace('\u2000', ' ').replace('\u2001', ' ').replace('\u2002', ' ').replace('\u2003', ' ').replace('\u2004', ' ').replace('\u2005', ' ').replace('\u2006', ' ').replace('\u2007', ' ').replace('\u2008', ' ').replace('\u2009', ' ').replace('\u200A', ' ')
+
+    @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_string_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.<br>
+        If `remove_empty_lines` is `True`, empty lines will be removed in the process."""
+        code_lines = String.get_string_lines(code, remove_empty_lines=True)
+        lines = code_lines if remove_empty_lines else String.get_string_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, nested_func_calls = _rx.findall(r'(?i)' + Regex.func_call(), code), []
+        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 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))