xulbux 1.6.7__tar.gz → 1.6.9__tar.gz

{xulbux-1.6.7/src/xulbux.egg-info → xulbux-1.6.9}/PKG-INFO

@@ -1,43 +1,21 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: xulbux
-Version: 1.6.7
+Version: 1.6.9
 Summary: A Python library which includes lots of helpful classes, types and functions aiming to make common programming tasks simpler.
 Author-email: XulbuX <xulbux.real@gmail.com>
-License: MIT License
-        
-        Copyright (c) 2024 XulbuX
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy
-        of this software and associated documentation files (the "Software"), to deal
-        in the Software without restriction, including without limitation the rights
-        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-        copies of the Software, and to permit persons to whom the Software is
-        furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all
-        copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-        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.
-        
+License-Expression: MIT
 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,constants,code,color,data,structures,env,environment,file,format,json,path,regex,string,system,operations,presets
+Keywords: args,arguments,attributes,classes,cmd,client,code,codes,color,commands,console,consts,constants,convert,conversion,data,debug,easier,env,environment,error,file,format,formatting,functions,helper,hex,hexa,hsl,hsla,info,input,json,library,log,logging,methods,nice,operations,path,presets,pretty,printing,properties,python,re,regex,rgb,rgba,string,structures,system,tools,types,utility,warn,warning,xulbux
 Classifier: Intended Audience :: Developers
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10.0
@@ -54,6 +32,7 @@ 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"
+Dynamic: license-file
 
 # **$\color{#8085FF}\Huge\textsf{XulbuX}$**
 
@@ -102,20 +81,20 @@ from xulbux import rgba, hsla, hexa
 
 ## Modules
 
-| | |
-| :--------------------------------------------------------------------------------------------------: | :------------------------------------------------------------------------------------------------- |
-| <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/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, ...*)                 |
+| Module                                                                                                                                                            | Short Description                                                                                  |
+| :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
+| [![xx_code](https://img.shields.io/badge/xx__code-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_code)                         | advanced code-string operations (*changing the indent, finding function calls, ...*)               |
+| [![xx_color](https://img.shields.io/badge/xx__color-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_color)                      | everything around colors (*converting, blending, searching colors in strings, ...*)                |
+| [![xx_console](https://img.shields.io/badge/xx__console-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_console)                | advanced actions related to the console (*pretty logging, advanced inputs, ...*)                   |
+| [![xx_data](https://img.shields.io/badge/xx__data-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_data)                         | advanced operations with data structures (*compare, generate path ID's, pretty print/format, ...*) |
+| [![xx_env_path](https://img.shields.io/badge/xx__env__path-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_env_path)             | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)               |
+| [![xx_file](https://img.shields.io/badge/xx__file-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_file)                         | advanced working with files (*create files, rename file-extensions, ...*)                          |
+| [![xx_format_codes](https://img.shields.io/badge/xx__format__codes-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_format_codes) | easy pretty printing with custom format codes (*print, inputs, custom format codes to ANSI, ...*)  |
+| [![xx_json](https://img.shields.io/badge/xx__json-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_json)                         | advanced working with json files (*read, create, update, ...*)                                     |
+| [![xx_path](https://img.shields.io/badge/xx__path-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_path)                         | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)             |
+| ![xx_regex](https://img.shields.io/badge/xx__regex-6065FF?style=flat)                                                                                     | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)            |
+| [![xx_string](https://img.shields.io/badge/xx__string-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_string)                   | helpful actions when working with strings. (*normalize, escape, decompose, ...*)                   |
+| ![xx_system](https://img.shields.io/badge/xx__system-6065FF?style=flat)                                                                                   | advanced system actions (*restart with message, check installed Python libs, ...*)                 |
 
 <br>
 

xulbux-1.6.9/README.md

@@ -0,0 +1,132 @@
+# **$\color{#8085FF}\Huge\textsf{XulbuX}$**
+
+**$\color{#8085FF}\textsf{XulbuX}$** is library that contains many useful classes, types, and functions,
+ranging from console logging and working with colors to file management and system operations.
+The library is designed to simplify common programming tasks and improve code readability through its collection of tools.
+
+For precise information about the library, see the library's [wiki page](https://github.com/XulbuX/PythonLibraryXulbuX/wiki).<br>
+For the libraries latest changes and updates, see the [change log](https://github.com/XulbuX/PythonLibraryXulbuX/blob/main/CHANGELOG.md).
+
+<br>
+
+## Installation
+
+Run the following commands in a console with administrator privileges, so the actions take effect for all users.
+
+Install the library and all its dependencies with the command:
+```console
+pip install xulbux
+```
+
+Upgrade the library and all its dependencies to their latest available version with the command:
+```console
+pip install --upgrade xulbux
+```
+
+<br>
+
+## Usage
+
+Import the full library under the alias `xx`, so its constants, classes, methods and types are accessible with `xx.CONSTANT.value`, `xx.Class.method()`, `xx.type()`:
+```python
+import xulbux as xx
+```
+So you don't have to import the full library under an alias, you can also import only certain parts of the library's contents:
+```python
+# CONSTANTS
+from xulbux import COLOR, CHARS, ANSI
+# Classes
+from xulbux import Code, Color, Console, ...
+# types
+from xulbux import rgba, hsla, hexa
+```
+
+<br>
+
+## Modules
+
+| Module                                                                                                                                                            | Short Description                                                                                  |
+| :---------------------------------------------------------------------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
+| [![xx_code](https://img.shields.io/badge/xx__code-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_code)                         | advanced code-string operations (*changing the indent, finding function calls, ...*)               |
+| [![xx_color](https://img.shields.io/badge/xx__color-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_color)                      | everything around colors (*converting, blending, searching colors in strings, ...*)                |
+| [![xx_console](https://img.shields.io/badge/xx__console-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_console)                | advanced actions related to the console (*pretty logging, advanced inputs, ...*)                   |
+| [![xx_data](https://img.shields.io/badge/xx__data-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_data)                         | advanced operations with data structures (*compare, generate path ID's, pretty print/format, ...*) |
+| [![xx_env_path](https://img.shields.io/badge/xx__env__path-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_env_path)             | getting and editing the PATH variable (*get paths, check for paths, add paths, ...*)               |
+| [![xx_file](https://img.shields.io/badge/xx__file-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_file)                         | advanced working with files (*create files, rename file-extensions, ...*)                          |
+| [![xx_format_codes](https://img.shields.io/badge/xx__format__codes-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_format_codes) | easy pretty printing with custom format codes (*print, inputs, custom format codes to ANSI, ...*)  |
+| [![xx_json](https://img.shields.io/badge/xx__json-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_json)                         | advanced working with json files (*read, create, update, ...*)                                     |
+| [![xx_path](https://img.shields.io/badge/xx__path-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_path)                         | advanced path operations (*get paths, smart-extend relative paths, delete paths, ...*)             |
+| ![xx_regex](https://img.shields.io/badge/xx__regex-6065FF?style=flat)                                                                                     | generated regex pattern-templates (*match bracket- and quote pairs, match colors, ...*)            |
+| [![xx_string](https://img.shields.io/badge/xx__string-6065FF?style=flat)](https://github.com/XulbuX/PythonLibraryXulbuX/wiki/xx_string)                   | helpful actions when working with strings. (*normalize, escape, decompose, ...*)                   |
+| ![xx_system](https://img.shields.io/badge/xx__system-6065FF?style=flat)                                                                                   | advanced system actions (*restart with message, check installed Python libs, ...*)                 |
+
+<br>
+
+## Example Usage
+
+This is what it could look like using this library for a simple but very nice looking color converter:
+```python
+from xulbux import COLOR                 # CONSTANTS
+from xulbux import FormatCodes, Console  # Classes
+from xulbux import hexa                  # types
+
+
+def main() -> None:
+
+    # LET THE USER ENTER A HEXA COLOR IN ANY HEXA FORMAT
+    input_clr = FormatCodes.input(
+      "\n[b](Enter a HEXA color in any format) [dim](>) "
+    )
+
+    # ANNOUNCE INDEXING THE INPUT COLOR
+    Console.log(
+      "INDEX",
+      "Indexing the input HEXA color...",
+      start="\n",
+      title_bg_color=COLOR.blue,
+    )
+
+    try:
+        # TRY TO CONVERT THE INPUT COLOR INTO A hexa() COLOR
+        hexa_color = hexa(input_clr)
+
+    except ValueError:
+        # ANNOUNCE THE ERROR AND EXIT THE PROGRAM
+        Console.fail(
+          "The input HEXA color is invalid.",
+          end="\n\n",
+          exit=True,
+        )
+
+    # ANNOUNCE STARTING THE CONVERSION
+    Console.log(
+      "CONVERT",
+      "Converting the HEXA color into different types...",
+      title_bg_color=COLOR.tangerine,
+    )
+
+    # CONVERT THE HEXA COLOR INTO THE TWO OTHER COLOR TYPES
+    rgba_color = hexa_color.to_rgba()
+    hsla_color = hexa_color.to_hsla()
+
+    # ANNOUNCE THE SUCCESSFUL CONVERSION
+    Console.done(
+      "Successfully converted color into different types.",
+      end="\n\n",
+    )
+
+    # PRETTY PRINT THE COLOR IN DIFFERENT TYPES
+    FormatCodes.print(f"[b](HEXA:) [i|white]({hexa_color})")
+    FormatCodes.print(f"[b](RGBA:) [i|white]({rgba_color})")
+    FormatCodes.print(f"[b](HSLA:) [i|white]({hsla_color})\n")
+
+
+if __name__ == "__main__":
+    main()
+```
+
+<br>
+<br>
+
+--------------------------------------------------------------
+[View this library on PyPI](https://pypi.org/project/XulbuX/)

{xulbux-1.6.7 → xulbux-1.6.9}/pyproject.toml

@@ -4,11 +4,12 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xulbux"
-version = "1.6.7"
+version = "1.6.9"
 authors = [{ name = "XulbuX", email = "xulbux.real@gmail.com" }]
 description = "A Python library which includes lots of helpful classes, types and functions aiming to make common programming tasks simpler."
 readme = "README.md"
-license = { file = "LICENSE" }
+license = "MIT"
+license-files = ["LICENSE"]
 requires-python = ">=3.10.0"
 dependencies = [
   "keyboard>=0.13.5",
@@ -30,39 +31,68 @@ classifiers = [
   "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",
+  "args",
+  "arguments",
+  "attributes",
   "classes",
-  "types",
-  "methods",
   "cmd",
-  "console",
-  "constants",
+  "client",
   "code",
+  "codes",
   "color",
+  "commands",
+  "console",
+  "consts",
+  "constants",
+  "convert",
+  "conversion",
   "data",
-  "structures",
+  "debug",
+  "easier",
   "env",
   "environment",
+  "error",
   "file",
   "format",
+  "formatting",
+  "functions",
+  "helper",
+  "hex",
+  "hexa",
+  "hsl",
+  "hsla",
+  "info",
+  "input",
   "json",
+  "library",
+  "log",
+  "logging",
+  "methods",
+  "nice",
+  "operations",
   "path",
+  "presets",
+  "pretty",
+  "printing",
+  "properties",
+  "python",
+  "re",
   "regex",
+  "rgb",
+  "rgba",
   "string",
+  "structures",
   "system",
-  "operations",
-  "presets",
+  "tools",
+  "types",
+  "utility",
+  "warn",
+  "warning",
+  "xulbux",
 ]
 
 [project.urls]
@@ -121,10 +151,15 @@ minversion = "7.0"
 addopts = "-ra -q"
 pythonpath = ["src"]
 testpaths = [
-  "tests/test_console_info.py",
-  "tests/test_color_types.py",
+  "tests/test_code.py",
   "tests/test_color.py",
+  "tests/test_color_types.py",
+  "tests/test_console.py",
   "tests/test_data.py",
-  "tests/test_env_vars.py",
+  "tests/test_env_path.py",
+  "tests/test_file.py",
   "tests/test_format_codes.py",
+  "tests/test_json.py",
+  "tests/test_path.py",
+  "tests/test_string.py",
 ]

xulbux-1.6.9/src/xulbux/__init__.py

@@ -0,0 +1,25 @@
+__version__ = "1.6.9"
+__author__ = "XulbuX"
+__email__ = "xulbux.real@gmail.com"
+__license__ = "MIT"
+__copyright__ = "Copyright (c) 2025 XulbuX"
+__url__ = "https://github.com/XulbuX/PythonLibraryXulbuX"
+__description__ = "A library which includes a lot of really helpful functions."
+__all__ = [
+    "_consts_", "xx_code", "xx_color", "xx_console", "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-1.6.7 → xulbux-1.6.9}/src/xulbux/_cli_.py

@@ -1,5 +1,5 @@
-from . import __version__
 from ._consts_ import COLOR
+from . import __version__
 from .xx_format_codes import FormatCodes
 from .xx_console import Console
 
@@ -33,17 +33,17 @@ def help_command():
        [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](•) CODE STRING OPERATIONS   [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Code[*]
+    [dim](•) WORKING WITH COLORS      [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Color[*]
+    [dim](•) CONSOLE LOG AND ACTIONS  [{color['lib']}]xx[{color['punctuators']}].[{color['class']}]Console[*]
     [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...)

xulbux-1.6.9/src/xulbux/xx_code.py

@@ -0,0 +1,115 @@
+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."""
+        if not code or len(code.strip()) < 3:
+            return False
+        for func in funcs:
+            if _rx.match(r"^[\s\n]*" + _rx.escape(func) + r"\([^\)]*\)[\s\n]*$", code):
+                return True
+        direct_js_patterns = [
+            r"^[\s\n]*\$\(['\"][^'\"]+['\"]\)\.[\w]+\([^\)]*\);?[\s\n]*$",  # jQuery calls
+            r"^[\s\n]*\$\.[a-zA-Z]\w*\([^\)]*\);?[\s\n]*$",  # $.ajax(), etc.
+            r"^[\s\n]*\(\s*function\s*\(\)\s*\{.*\}\s*\)\(\);?[\s\n]*$",  # IIFE
+            r"^[\s\n]*document\.[a-zA-Z]\w*\([^\)]*\);?[\s\n]*$",  # document.getElementById()
+            r"^[\s\n]*window\.[a-zA-Z]\w*\([^\)]*\);?[\s\n]*$",  # window.alert()
+            r"^[\s\n]*console\.[a-zA-Z]\w*\([^\)]*\);?[\s\n]*$",  # console.log()
+        ]
+        for pattern in direct_js_patterns:
+            if _rx.match(pattern, code):
+                return True
+        arrow_function_patterns = [
+            r"^[\s\n]*\b[\w_]+\s*=\s*\([^\)]*\)\s*=>\s*[^;{]*[;]?[\s\n]*$",  # const x = (y) => y*2;
+            r"^[\s\n]*\b[\w_]+\s*=\s*[\w_]+\s*=>\s*[^;{]*[;]?[\s\n]*$",  # const x = y => y*2;
+            r"^[\s\n]*\(\s*[\w_,\s]+\s*\)\s*=>\s*[^;{]*[;]?[\s\n]*$",  # (x) => x*2
+            r"^[\s\n]*[\w_]+\s*=>\s*[^;{]*[;]?[\s\n]*$",  # x => x*2
+        ]
+        for pattern in arrow_function_patterns:
+            if _rx.match(pattern, code):
+                return True
+        funcs_pattern = r"(" + "|".join(_rx.escape(f) for f in funcs) + r")" + Regex.brackets("()")
+        js_indicators = [(r"\b(var|let|const)\s+[\w_$]+", 2),  # JS variable declarations
+                         (r"\$[\w_$]+\s*=", 2),  # jQuery-style variables
+                         (r"\$[\w_$]+\s*\(", 2),  # jQuery function calls
+                         (r"\bfunction\s*[\w_$]*\s*\(", 2),  # Function declarations
+                         (r"[\w_$]+\s*=\s*function\s*\(", 2),  # Function assignments
+                         (r"\b[\w_$]+\s*=>\s*[\{\(]", 2),  # Arrow functions
+                         (r"\(function\s*\(\)\s*\{", 2),  # IIFE pattern
+                         (funcs_pattern, 2),  # Custom predefined functions
+                         (r"\b(true|false|null|undefined)\b", 1),  # JS literals
+                         (r"===|!==|\+\+|--|\|\||&&", 1.5),  # JS-specific operators
+                         (r"\bnew\s+[\w_$]+\s*\(", 1.5),  # Object instantiation with new
+                         (r"\b(document|window|console|Math|Array|Object|String|Number)\.", 2),  # JS objects
+                         (r"\basync\s+function|\bawait\b", 2),  # Async/await
+                         (r"\b(if|for|while|switch)\s*\([^)]*\)\s*\{", 1),  # Control structures with braces
+                         (r"\btry\s*\{[^}]*\}\s*catch\s*\(", 1.5),  # Try-catch
+                         (r";[\s\n]*$", 0.5),  # Semicolon line endings
+                         ]
+        js_score = 0
+        line_endings = [line.strip() for line in code.splitlines() if line.strip()]
+        semicolon_endings = sum(1 for line in line_endings if line.endswith(';'))
+        if semicolon_endings >= 1:
+            js_score += min(semicolon_endings, 2)
+        opening_braces = code.count('{')
+        closing_braces = code.count('}')
+        if opening_braces > 0 and opening_braces == closing_braces:
+            js_score += 1
+        for pattern, score in js_indicators:
+            regex = _rx.compile(pattern, _rx.IGNORECASE)
+            matches = regex.findall(code)
+            if matches:
+                js_score += len(matches) * score
+        return js_score >= 2