atomicshop 3.3.4__py3-none-any.whl → 3.3.6__py3-none-any.whl

atomicshop/__init__.py

@@ -1,4 +1,4 @@
 """Atomic Basic functions and classes to make developer life easier"""
 
 __author__ = "Den Kras"
-__version__ = '3.3.4'
+__version__ = '3.3.6'

atomicshop/networks.py

@@ -3,6 +3,7 @@ import time
 from typing import Union
 import os
 import psutil
+import ctypes
 
 from icmplib import ping
 from icmplib.models import Host
@@ -20,9 +21,12 @@ MICROSOFT_LOOPBACK_DEVICE_HARDWARE_ID = "*MSLOOP"
 GUID_DEVCLASS_NET: str = '{4d36e972-e325-11ce-bfc1-08002be10318}'
 
 
-def is_ip_alive(ip_address: str, timeout: int = 1) -> bool:
+def is_ip_in_use_ping(ip_address: str, timeout: int = 1) -> bool:
     """
-    Returns True if icmplib.models.Host.is_alive returns True.
+    Returns True if the IP address is pingable, False otherwise.
+    :param ip_address: string, IP address to check.
+    :param timeout: int, timeout in seconds. Default is 1 second.
+    :return: bool, True if the IP address is pingable, False otherwise.
     """
 
     host_object: Host = ping(ip_address, count=1, timeout=timeout)
@@ -30,15 +34,72 @@ def is_ip_alive(ip_address: str, timeout: int = 1) -> bool:
     return host_object.is_alive
 
 
-def get_default_internet_ipv4() -> str:
+def is_ip_in_use_arp(
+        ipv4: str,
+        gateway_ip: str = None
+) -> tuple[
+        Union[str, None],
+        Union[bool, None]
+]:
     """
+    Windows only.
+    Check if an IPv4 address is in use on the local network using ARP.
+    :param ipv4: string, IPv4 address to check.
+    :param gateway_ip: string, IPv4 address of the default gateway.
+        How it works: If you provide the gateway_ip, the function will get yje MAC of the gateway,
+        then it will get the MAC of the target IP address. If the MACs are the same, it means that the target IP's
+        ARP reply is an ARP proxy reply from the gateway.
+    :return: tuple (mac_address: str | None, via_gateway: bool | None)
+        If the IP address is in use, mac_address will be the MAC address of the device using the IP address,
+        else None. If gateway_ip is provided, via_gateway will be True if the MAC address is the same as the gateway's MAC address,
+        False if it's different, and None if gateway_ip is not provided.
+    """
+
+    iphlpapi = ctypes.windll.iphlpapi
+    ws2_32 = ctypes.windll.ws2_32
+
+    def _send_arp(ip: str) -> str | None:
+        """Return MAC string like 'aa:bb:cc:dd:ee:ff' if IP is claimed on the LAN, else None."""
+        # inet_addr returns DWORD in network byte order
+        dest_ip = ws2_32.inet_addr(ip.encode('ascii'))
+        if dest_ip == 0xFFFFFFFF:  # INVALID
+            raise ValueError(f"Bad IPv4 address: {ip}")
+
+        mac_buf = ctypes.c_uint64(0)  # storage for up to 8 bytes
+        mac_len = ctypes.c_ulong(ctypes.sizeof(mac_buf))  # in/out len
+        # SrcIP=0 lets Windows pick the right interface
+        rc = iphlpapi.SendARP(dest_ip, 0, ctypes.byref(mac_buf), ctypes.byref(mac_len))
+        if rc != 0:  # Non-zero means no ARP reply / not on-link / other error
+            return None
+
+        # Extract the first 6 bytes from little-endian integer
+        mac_int = mac_buf.value
+        mac_bytes = mac_int.to_bytes(8, 'little')[:6]
+        return ':'.join(f'{b:02x}' for b in mac_bytes)
+
+    mac = _send_arp(ipv4)
+    if mac is None:
+        return None, None
+    via_gateway = None
+    if gateway_ip:
+        gw_mac = _send_arp(gateway_ip)
+        via_gateway = (gw_mac is not None and gw_mac.lower() == mac.lower())
+    return mac, via_gateway
+
+
+def __get_default_internet_ipv4() -> str:
+    """
+    FOR REFERENCE ONLY, DO NOT USE.
+    DOESN'T WORK UNDER ALL CIRCUMSTANCES, CAN'T PINPOINT THE REASON.
+
     Get the default IPv4 address of the interface that is being used for internet.
     :return: string, default IPv4 address.
     """
 
     return socket.gethostbyname(socket.gethostname())
 
-def get_default_internet_ipv4_by_connect(target: str = "8.8.8.8") -> str:
+
+def get_default_internet_ipv4(target: str = "8.8.8.8") -> str:
     with socket.socket(socket.AF_INET, socket.SOCK_DGRAM) as s:
         s.connect((target, 80))  # no packet sent; OS just chooses a route
         return s.getsockname()[0]  # local address of that route
@@ -296,9 +357,9 @@ def generate_unused_ipv4_addresses_by_vlan(
     for i in range(number_of_ips):
         # Create the IP address.
         while True:
-            ip_address = f"{vlan}.{counter}"
+            ip_address: str = f"{vlan}.{counter}"
             counter += 1
-            is_ip_in_use: bool = is_ip_alive(ip_address)
+            is_ip_in_use, _ = is_ip_in_use_arp(ip_address)
             if not is_ip_in_use and not ip_address in skip_ips:
                 # print("[+] Found IP to assign: ", ip_address)
                 generated_ips.append(ip_address)
@@ -506,7 +567,7 @@ def add_virtual_ips_to_default_adapter_by_current_setting(
                 dns_gateways = default_adapter_info['dns_gateways']
 
             # We will get the default IP address of the machine.
-            default_ip_address: str = socket.gethostbyname(socket.gethostname())
+            default_ip_address: str = get_default_internet_ipv4()
             # So we can make it the first IP in the list, but first remove it from the list.
             _ = ips.pop(ips.index(default_ip_address))
             # At this point we will copy the list of IPs that we will set the SkipAsSource flag for.

{atomicshop-3.3.4.dist-info → atomicshop-3.3.6.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atomicshop
-Version: 3.3.4
+Version: 3.3.6
 Summary: Atomic functions and classes to make developer life easier
 Author: Denis Kras
 License-Expression: MIT
@@ -14,6 +14,7 @@ License-File: LICENSE.txt
 Requires-Dist: wheel
 Requires-Dist: beautifulsoup4
 Requires-Dist: cryptography
+Requires-Dist: dkinst
 Requires-Dist: dnslib
 Requires-Dist: dnspython
 Requires-Dist: docker

{atomicshop-3.3.4.dist-info → atomicshop-3.3.6.dist-info}/RECORD

@@ -1,4 +1,4 @@
-atomicshop/__init__.py,sha256=-H5JgHG0iCCH8pC2RNRvzeaxBh2DD3LjRloFS8OdaVQ,122
+atomicshop/__init__.py,sha256=PKxHKogNO1jVrjMDxPohtYhd5093pVEONPVfmujNgfw,122
 atomicshop/_basics_temp.py,sha256=6cu2dd6r2dLrd1BRNcVDKTHlsHs_26Gpw8QS6v32lQ0,3699
 atomicshop/_create_pdf_demo.py,sha256=Yi-PGZuMg0RKvQmLqVeLIZYadqEZwUm-4A9JxBl_vYA,3713
 atomicshop/_patch_import.py,sha256=ENp55sKVJ0e6-4lBvZnpz9PQCt3Otbur7F6aXDlyje4,6334
@@ -23,7 +23,7 @@ atomicshop/http_parse.py,sha256=1Tna9YbOM0rE3t6i_M-klBlwd1KNSA9skA_BqKGXDFc,1186
 atomicshop/inspect_wrapper.py,sha256=sGRVQhrJovNygHTydqJj0hxES-aB2Eg9KbIk3G31apw,11429
 atomicshop/ip_addresses.py,sha256=penRFeJ1-LDVTko4Q0EwK4JiN5cU-KzCBR2VXg9qbUY,1238
 atomicshop/keyboard_press.py,sha256=1W5kRtOB75fulVx-uF2yarBhW0_IzdI1k73AnvXstk0,452
-atomicshop/networks.py,sha256=dTh6T9vAnjYOEPdfpL6W6wN091HwRbVLeNscXWZX_DI,22151
+atomicshop/networks.py,sha256=fwOMMHwn-XMq0WgYCFbo34NXW-Xu-4nDfWl3T5EsE9U,24807
 atomicshop/on_exit.py,sha256=9XlOnzoAG8zlI8wBF4AB8hyrC6Q1b84gkhqpAhhdN9g,6977
 atomicshop/pbtkmultifile_argparse.py,sha256=aEk8nhvoQVu-xyfZosK3ma17CwIgOjzO1erXXdjwtS4,4574
 atomicshop/print_api.py,sha256=SJNQIMqSLlYaPtjHnALySAI-jQYuYHOCGgfP7oe96fU,10957
@@ -54,13 +54,10 @@ atomicshop/a_installs/ubuntu/docker_rootless.py,sha256=9IPNtGZYjfy1_n6ZRt7gWz9KZ
 atomicshop/a_installs/ubuntu/docker_sudo.py,sha256=JzayxeyKDtiuT4Icp2L2LyFRbx4wvpyN_bHLfZ-yX5E,281
 atomicshop/a_installs/ubuntu/elastic_search_and_kibana.py,sha256=yRB-l1zBxdiN6av-FwNkhcBlaeu4zrDPjQ0uPGgpK2I,244
 atomicshop/a_installs/ubuntu/mongodb.py,sha256=xuRJS1qqOZ0EZp7of5R3tTjSu6CwBIxYg8-NaM7othE,230
-atomicshop/a_installs/ubuntu/nodejs.py,sha256=Iax55VJpT2HZsdRv-JvxkLg6JPYpJ-M8_r-wI5ES_yQ,222
 atomicshop/a_installs/ubuntu/pycharm.py,sha256=Ld7YQBwPxrjuZcTG1K4kZqjbBdt8aooCVRa15u5FOmE,157
 atomicshop/a_installs/win/fibratus.py,sha256=TU4e9gdZ_zI73C40uueJ59pD3qmN-UFGdX5GFoVf6cM,179
 atomicshop/a_installs/win/mongodb.py,sha256=AqyItXu19aaoe49pppDxtEkXey6PMy0PoT2Y_RmPpPE,179
-atomicshop/a_installs/win/nodejs.py,sha256=U519Dyt4bsQPbEg_PwnZL5tsbfqDr1BbhxwoQFZsSKo,200
 atomicshop/a_installs/win/pycharm.py,sha256=j_RSd7aDOyC3yDd-_GUTMLlQTmDrqtVFG--oUfGLiZk,140
-atomicshop/a_installs/win/robocorp.py,sha256=Ob8X9Czwd-OR3pudFIFft1dcUjDM0Pw0X03yfPaf3yw,3280
 atomicshop/a_installs/win/wsl_ubuntu_lts.py,sha256=dZbPRLNKFeMd6MotjkE6UDY9cOiIaaclIdR1kGYWI50,139
 atomicshop/a_mains/dns_gateway_setting.py,sha256=ncc2rFQCChxlNP59UshwmTonLqC6MWblrVAzbbz-13M,149
 atomicshop/a_mains/github_wrapper.py,sha256=F-PoZknVCxWPN0PTO6l7ZNiaYvo7OVFKFI_zlPt56ps,169
@@ -198,7 +195,6 @@ atomicshop/wrappers/configparserw.py,sha256=JwDTPjZoSrv44YKwIRcjyUnpN-FjgXVfMqMK
 atomicshop/wrappers/cryptographyw.py,sha256=QEUpDn8vUvMg3ADz6-4oC2kbDNC_woDlw7C0zU7qFVM,14233
 atomicshop/wrappers/ffmpegw.py,sha256=wcq0ZnAe0yajBOuTKZCCaKI7CDBjkq7FAgdW5IsKcVE,6031
 atomicshop/wrappers/githubw.py,sha256=bds_8fgyFyHXKwty6-SBS3H3Ueta2IMM5UQFpiFmgHQ,27554
-atomicshop/wrappers/msiw.py,sha256=GQLqud72nfex3kvO1bJSruNriCYTYX1_G1gSf1MPkIA,6118
 atomicshop/wrappers/netshw.py,sha256=8WE_576XiiHykwFuE-VkCx5CydMpFlztX4frlEteCtI,6350
 atomicshop/wrappers/numpyw.py,sha256=sBV4gSKyr23kXTalqAb1oqttzE_2XxBooCui66jbAqc,1025
 atomicshop/wrappers/olefilew.py,sha256=biD5m58rogifCYmYhJBrAFb9O_Bn_spLek_9HofLeYE,2051
@@ -277,9 +273,6 @@ atomicshop/wrappers/mongodbw/install_mongodb_ubuntu.py,sha256=2eEOb35T259lhn5koy
 atomicshop/wrappers/mongodbw/install_mongodb_win.py,sha256=64EUQYx7VuMC3ndO2x3nSErh5NZ_BsqMwGvPcybfC-Q,8499
 atomicshop/wrappers/mongodbw/mongo_infra.py,sha256=IjEF0jPzQz866MpTm7rnksnyyWQeUT_B2h2DA9ryAio,2034
 atomicshop/wrappers/mongodbw/mongodbw.py,sha256=CHbDfW9CXzXUs3V97DYQpt-dYlt_gB60JhwqG2tVFQY,56049
-atomicshop/wrappers/nodejsw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atomicshop/wrappers/nodejsw/install_nodejs_ubuntu.py,sha256=wjpJdfAaY92RYl_L9esDIWuBMGeYH35RHJ5BVgMof8Y,6260
-atomicshop/wrappers/nodejsw/install_nodejs_windows.py,sha256=WvXIcEVnKcQYD-KNwhVP094s__1tt0Ir2Y87MABl8Nc,6283
 atomicshop/wrappers/playwrightw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/playwrightw/_tryouts.py,sha256=l1BLkFsiIMNlgv7nfZd1XGEvXQkIQkIcg48__9OaC00,4920
 atomicshop/wrappers/playwrightw/base.py,sha256=WeRpx8otdXuKSr-BjY-uCJTze21kbPpfitoOjKQz5-g,9818
@@ -337,9 +330,9 @@ atomicshop/wrappers/socketw/statistics_csv.py,sha256=_gA8bMX6Sw_UCXKi2y9wNAwlqif
 atomicshop/wrappers/winregw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/winregw/winreg_installed_software.py,sha256=Qzmyktvob1qp6Tjk2DjLfAqr_yXV0sgWzdMW_9kwNjY,2345
 atomicshop/wrappers/winregw/winreg_network.py,sha256=ih0BVNwByLvf9F_Lac4EdmDYYJA3PzMvmG0PieDZrsE,9905
-atomicshop-3.3.4.dist-info/licenses/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
-atomicshop-3.3.4.dist-info/METADATA,sha256=AA-i4jzN5U9DaSNf-Hv_TuHfoMUeOR9-53KcyzR2xik,9288
-atomicshop-3.3.4.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-atomicshop-3.3.4.dist-info/entry_points.txt,sha256=SJEgEP0KoFtfxuGwe5tOzKfXkjR9Dv6YYug33KNYxyY,69
-atomicshop-3.3.4.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
-atomicshop-3.3.4.dist-info/RECORD,,
+atomicshop-3.3.6.dist-info/licenses/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
+atomicshop-3.3.6.dist-info/METADATA,sha256=IL5-xRKSd3KMQq1-z8F1hdeVTz9jNmhxtEdbXTAeKtM,9311
+atomicshop-3.3.6.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+atomicshop-3.3.6.dist-info/entry_points.txt,sha256=SJEgEP0KoFtfxuGwe5tOzKfXkjR9Dv6YYug33KNYxyY,69
+atomicshop-3.3.6.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
+atomicshop-3.3.6.dist-info/RECORD,,

atomicshop/a_installs/ubuntu/nodejs.py

@@ -1,12 +0,0 @@
-#! /usr/bin/env python3
-import sys
-
-from atomicshop.wrappers.nodejsw import install_nodejs_ubuntu
-
-
-def main():
-    install_nodejs_ubuntu.install_nodejs_main()
-
-
-if __name__ == "__main__":
-    sys.exit(main())

atomicshop/a_installs/win/nodejs.py

@@ -1,11 +0,0 @@
-import sys
-
-from atomicshop.wrappers.nodejsw import install_nodejs_windows
-
-
-def main():
-    install_nodejs_windows.install_nodejs_windows()
-
-
-if __name__ == "__main__":
-    sys.exit(main())

atomicshop/a_installs/win/robocorp.py

@@ -1,82 +0,0 @@
-import sys
-import subprocess
-import tempfile
-
-from atomicshop.print_api import print_api
-from atomicshop.wrappers import githubw
-from atomicshop.permissions import permissions
-from atomicshop.wrappers.nodejsw import install_nodejs_windows
-
-
-WINDOWS_TESSERACT_DEFAULT_INSTALLATION_DIRECTORY: str = r"C:\Program Files\Tesseract-OCR"
-
-
-def main():
-    if not permissions.is_admin():
-        print_api("Please run this script as an Administrator.", color="red")
-        return 1
-
-    if not install_nodejs_windows.is_nodejs_installed():
-        install_nodejs_windows.install_nodejs_windows()
-    install_nodejs_windows.add_nodejs_to_path()
-    if not install_nodejs_windows.is_nodejs_installed():
-        print_api("Node.js installation failed.", color="red")
-        return 1
-
-    print_api("PIP Installing Robocorp.", color="blue")
-    subprocess.check_call(["pip", "install", "--upgrade", "rpaframework"])
-
-    print_api("PIP Installing Robocorp-Browser.", color="blue")
-    subprocess.check_call(["pip", "install", "--upgrade", "robotframework-browser"])
-
-    print_api("PIP Installing Robocorp-Recognition.", color="blue")
-    subprocess.check_call(["pip", "install", "--upgrade", "rpaframework-recognition"])
-
-    print_api("PIP Installing pynput.", color="blue")
-    subprocess.check_call(["pip", "install", "--upgrade", "pynput"])
-
-    print_api("Installing Playwright browsers.", color="blue")
-    subprocess.check_call(["playwright", "install"])
-
-    print_api("Initializing Robocorp Browser.", color="blue")
-    subprocess.check_call(["rfbrowser", "init"])
-
-    print_api("Installing Additional modules.", color="blue")
-    subprocess.check_call(["pip", "install", "--upgrade", "matplotlib", "imagehash"])
-
-    print_api("Installing Tesseract OCR.", color="blue")
-    github_wrapper = githubw.GitHubWrapper(
-        user_name="tesseract-ocr",
-        repo_name="tesseract",
-        branch="main")
-    github_wrapper.build_links_from_user_and_repo()
-    temp_file_path: str = tempfile.gettempdir()
-    tesseract_installer = github_wrapper.download_latest_release(
-        target_directory=temp_file_path,
-        string_pattern="*tesseract*exe")
-
-    # The Admin needed to install Tesseract.
-    subprocess.check_call([tesseract_installer, "/S"])
-
-    # Add Tesseract to the PATH.
-    subprocess.check_call(["setx", "PATH", f"%PATH%;{WINDOWS_TESSERACT_DEFAULT_INSTALLATION_DIRECTORY}"])
-
-    # Patch robocorp: Remove mouse to the center of the screen on control command.
-    # Import the library to find its path.
-    print_api("Patching: .\RPA\Windows\keywords\window.py", color="blue")
-    import RPA.Windows.keywords.window as window
-    window_file_path = window.__file__
-
-    # Patch the file.
-    with open(window_file_path, "r") as file:
-        file_content = file.read()
-    file_content = file_content.replace(
-        "window.item.MoveCursorToMyCenter(simulateMove=self.ctx.simulate_move)",
-        "# window.item.MoveCursorToMyCenter(simulateMove=self.ctx.simulate_move)    # Patched to remove center placement during foreground window control."
-    )
-    with open(window_file_path, "w") as file:
-        file.write(file_content)
-
-
-if __name__ == '__main__':
-    sys.exit(main())

atomicshop/wrappers/msiw.py

@@ -1,148 +0,0 @@
-import subprocess
-
-from ..print_api import print_api
-from ..permissions import permissions
-from ..import get_process_list
-from .psutilw import processes
-
-
-ERROR_CODES = {
-    '1603': 'The App is already installed or Insufficient permissions',
-    '1619': 'This installation package could not be opened. Verify that the package exists and that you can '
-            'install it manually, also check the installation command line switches'
-}
-
-
-class MsiInstallationError(Exception):
-    pass
-
-
-def get_current_msiexec_processes(msi_file_path: str = None) -> dict:
-    """
-    Get the current msiexec processes.
-    :param msi_file_path: string, OPTIONAL path to the MSI file to check in the command line.
-    :return: list of dicts, each key represents a pid and its values are process name and cmdline.
-    """
-
-    current_processes: dict = (
-        get_process_list.GetProcessList(get_method='pywin32', connect_on_init=True).get_processes())
-
-    current_msiexec_dict: dict = {}
-    for pid, process_info in current_processes.items():
-        if 'msiexec.exe' in process_info['name']:
-            if msi_file_path:
-                if msi_file_path in process_info['cmdline']:
-                    current_msiexec_dict[pid] = process_info
-            else:
-                current_msiexec_dict[pid] = process_info
-
-    return current_msiexec_dict
-
-
-def wait_for_msiexec_processes_to_finish(msi_file_path: str):
-    """
-    Wait for the msiexec processes to finish.
-    :param msi_file_path: string, path to the MSI file.
-    :return:
-    """
-
-    current_msiexec: dict = get_current_msiexec_processes(msi_file_path)
-    current_pid = list(current_msiexec.keys())[0]
-
-    result_code = processes.wait_for_process(current_pid)
-    if result_code != 0:
-        raise Exception(f"MSI Installation failed. Return code: {result_code}")
-
-
-def install_msi(
-        msi_path,
-        silent_no_gui: bool = False,
-        silent_progress_bar: bool = False,
-        no_restart: bool = False,
-        terminate_required_processes: bool = False,
-        additional_args: str = None,
-        create_log_near_msi: bool = False,
-        log_file_path: str = None,
-        scan_log_for_errors: bool = False,
-        # as_admin=True,
-        print_kwargs: dict = None):
-    """
-    Install an MSI file silently.
-    :param msi_path: str, path to the MSI file.
-    :param silent_no_gui: bool, whether to run the installation silently, without showing GUI.
-    :param silent_progress_bar: bool, whether to show a progress bar during silent installation.
-    :param no_restart: bool, whether to restart the computer after installation.
-    :param terminate_required_processes: bool, whether to terminate processes that are required by the installation.
-    :param additional_args: str, additional arguments to pass to the msiexec command.
-    :param create_log_near_msi: bool, whether to create a log file near the MSI file.
-        If the msi file located in 'c:\\path\\to\\file.msi', the log file will be created in 'c:\\path\\to\\file.log'.
-        The log options that will be used: /l*v c:\\path\\to\\file.log
-    :param log_file_path: str, path to the log file. Even if 'create_log_near_msi' is False, you can specify a custom
-        path for the log file, and it will be created.
-        The log options that will be used: /l*v c:\\path\\to\\file.log
-    :param scan_log_for_errors: bool, whether to scan the log file for errors in case of failure.
-    # :param as_admin: bool, whether to run the installation as administrator.
-    :param print_kwargs: dict, print_api kwargs.
-    :return:
-    """
-
-    if not permissions.is_admin():
-        raise PermissionError("This function requires administrator privileges.")
-
-    if silent_progress_bar and silent_no_gui:
-        raise ValueError("silent_progress_bar and silent_no_gui cannot be both True.")
-
-    if create_log_near_msi and log_file_path:
-        raise ValueError("create_log_near_msi and log_file_path cannot be both set.")
-
-    if create_log_near_msi:
-        log_file_path = msi_path.replace('.msi', '.log')
-
-    if scan_log_for_errors and not log_file_path:
-        raise ValueError("[scan_log_for_errors] is set, but [log_file_path] or [create_log_near_msi] is not set.")
-
-    # Define the msiexec command
-    command = f'msiexec /i "{msi_path}"'
-
-    if silent_no_gui:
-        command = f"{command} /qn"
-    if silent_progress_bar:
-        command = f"{command} /qb"
-    if no_restart:
-        command = f"{command} /norestart"
-
-    if log_file_path:
-        command = f"{command} /l*v {log_file_path}"
-
-    if terminate_required_processes:
-        command = f"{command} REBOOT=ReallySuppress"
-
-    if additional_args:
-        if additional_args.startswith(' '):
-            additional_args = additional_args[1:]
-        command = f"{command} {additional_args}"
-
-    # if as_admin:
-    #     command = win_permissions.get_command_to_run_as_admin_windows(command)
-
-    # Run the command
-    result = subprocess.run(command, capture_output=True, text=True)
-
-    # Check the result
-    if result.returncode == 0:
-        print_api("MSI Installation completed.", color="green", **(print_kwargs or {}))
-    else:
-        message = (f"Installation failed. Return code: {result.returncode}\n{ERROR_CODES.get(str(result.returncode), '')}\n"
-                   f"MSI path: {msi_path}\nCommand: {command}\nOutput: {result.stdout}\nError: {result.stderr}")
-
-        if scan_log_for_errors:
-            with open(log_file_path, 'r', encoding='utf-16 le') as f:
-                log_content = f.read()
-            if 'error' in log_content.lower():
-                # Get the error text of the lines that contain 'error'.
-                error_lines = [line for line in log_content.split('\n') if 'error' in line.lower()]
-                for line in error_lines:
-                    message += f"\n{line}"
-
-        print_api(message, color="red", **(print_kwargs or {}))
-        raise MsiInstallationError("MSI Installation Failed.")

atomicshop/wrappers/nodejsw/install_nodejs_ubuntu.py

@@ -1,183 +0,0 @@
-import subprocess
-import requests
-import argparse
-
-from ...basics import booleans
-from .. import githubw, ubuntu_terminal
-from ...print_api import print_api
-
-
-def is_nodejs_installed():
-    """
-    The function will check if Node.js is installed.
-    :return: bool.
-    """
-
-    try:
-        # Run the command 'node -v'
-        result = subprocess.run(['node', '-v'], stdout=subprocess.PIPE, stderr=subprocess.PIPE, text=True)
-
-        # Check if the command was successful
-        if result.returncode == 0:
-            message = f"Node.js installed. Version: {result.stdout.strip()}"
-            print_api(message, color='green')
-            return True
-        else:
-            print_api("Node.js is not installed.")
-            return False
-    except FileNotFoundError:
-        print_api("Node command not found. Node.js is not installed.")
-        return False
-
-
-def get_nodejs_latest_version_number(
-        by_github_api: bool = True,
-        _by_nodejs_website: bool = False,
-        get_major: bool = False
-) -> str:
-    """
-    The function will get the latest version number of Node.js.
-    :param by_github_api: bool, if True, the function will get the version number using the GitHub API.
-        Limitations: rate limits apply.
-    :param _by_nodejs_website: bool, if True, the function will get the version number using the Node.js website.
-        Limitations: the website structure can change and the json file is relatively large.
-        This is only for reference, it is not tested.
-    :param get_major: bool, if True, the function will return only the major version number string.
-    :return: str.
-    """
-
-    if by_github_api and _by_nodejs_website:
-        raise ValueError("Only one of the arguments can be True.")
-    elif not by_github_api and not _by_nodejs_website:
-        raise ValueError("At least one of the arguments must be True.")
-
-    latest_version = ''
-    if by_github_api:
-        github_wrapper = githubw.GitHubWrapper('nodejs', 'node')
-        latest_version = github_wrapper.get_the_latest_release_version_number()
-    elif _by_nodejs_website:
-        url = "https://nodejs.org/dist/index.json"
-        response = requests.get(url)
-        versions = response.json()
-        latest_version = versions[0]['version']  # Assuming the first one is the latest.
-
-    if get_major:
-        latest_version = latest_version.replace('v', '')
-        latest_version = latest_version.split('.')[0]
-
-    return latest_version
-
-
-def install_nodejs_ubuntu(
-        install_latest_version: bool = False,
-        install_lts: bool = True,
-        install_by_version_number: str = None,
-        force_install: bool = False
-):
-    """
-    The function will install Node.js on Ubuntu.
-
-    :param install_latest_version: bool, if True, the function will install the latest version of Node.js.
-    :param install_lts: bool, if True, the function will install the LTS version of Node.js.
-    :param install_by_version_number: str, the version number of Node.js to install.
-    :param force_install: bool, if True, the function will install Node.js even if it is already installed.
-
-    :return:
-    """
-
-    booleans.is_only_1_true_in_list(
-        booleans_list_of_tuples=[
-            (install_latest_version, 'install_latest_version'),
-            (install_lts, 'install_lts'),
-            (install_by_version_number, 'install_by_version_number')
-        ],
-        raise_if_all_false=True
-    )
-
-    # Check if Node.js is already installed.
-    if is_nodejs_installed():
-        if not force_install:
-            return
-
-    # NodeSource is listed as source under official Node.js GitHub repository:
-    # https://github.com/nodejs/node?tab=readme-ov-file#current-and-lts-releases
-    print_api("Adding NodeSource repository...")
-
-    # Fetch and execute the NodeSource repository setup script.
-    if install_latest_version:
-        install_by_version_number: str = get_nodejs_latest_version_number(get_major=True)
-
-    command: str = ''
-    if install_latest_version or install_by_version_number:
-        command = f"curl -fsSL https://deb.nodesource.com/setup_{install_by_version_number}.x | sudo -E bash -"
-    elif install_lts:
-        command = "curl -fsSL https://deb.nodesource.com/setup_current.x | sudo -E bash -"
-
-    _ = subprocess.check_output(command, shell=True, stderr=subprocess.STDOUT)
-
-    ubuntu_terminal.update_system_packages()
-    ubuntu_terminal.install_packages(['nodejs'])
-
-    # Check if Node.js is installed.
-    is_nodejs_installed()
-
-
-def install_nodejs_main():
-    """
-    The function will install Node.js on Ubuntu.
-    :return:
-    """
-
-    # Create the parser.
-    parser = argparse.ArgumentParser(description="Install Node.js on Ubuntu.")
-    parser.add_argument(
-        '--latest',
-        action='store_true',
-        help="Install the latest version of Node.js."
-    )
-    parser.add_argument(
-        '--lts',
-        action='store_true',
-        help="Install the LTS version of Node.js."
-    )
-    parser.add_argument(
-        '--version',
-        type=str,
-        help="Install a specific version of Node.js."
-    )
-    parser.add_argument(
-        '--force',
-        action='store_true',
-        help="Force the installation of Node.js."
-    )
-
-    # Parse the arguments.
-    args = parser.parse_args()
-
-    install_nodejs_ubuntu(
-        install_latest_version=args.latest,
-        install_lts=args.lts,
-        install_by_version_number=args.version,
-        force_install=args.force
-    )
-
-
-def install_npm_package_ubuntu(package_name: str, sudo: bool = True):
-    """
-    The function will install a npm package on Ubuntu.
-    :param package_name: str, the name of the package to install.
-    :param sudo: bool, if True, the function will use sudo.
-        NPM commands require sudo to install global packages.
-    :return:
-    """
-
-    # Check if Node.js is installed.
-    if not is_nodejs_installed():
-        return
-
-    command = f"npm install -g {package_name}"
-
-    if sudo:
-        command = f"sudo {command}"
-
-    _ = subprocess.check_output(command, shell=True, stderr=subprocess.STDOUT)

atomicshop/wrappers/nodejsw/install_nodejs_windows.py

@@ -1,180 +0,0 @@
-import subprocess
-import os
-import requests
-import time
-import tempfile
-
-from ... import web
-from ...permissions import permissions
-from .. import msiw
-from ...print_api import print_api
-
-
-WINDOWS_X64_SUFFIX: str = "x64.msi"
-
-
-class NodeJSWindowsInstallerNoVersionsFound(Exception):
-    pass
-
-
-class NodeJSWindowsInstallerMoreThanOneVersionFound(Exception):
-    pass
-
-
-class NodeJSWindowsInstallerFailedToExtractFileNameFromString(Exception):
-    pass
-
-
-class NodeJSWindowsInstallerFailedToExtractVersionInString(Exception):
-    pass
-
-
-def is_nodejs_installed():
-    """
-    Check if Node.js is installed by trying to run 'node -v'.
-    """
-    print_api("Checking if Node.js is installed...")
-    try:
-        try:
-            node_version = subprocess.check_output(["node", "-v"], text=True)
-        except FileNotFoundError:
-            print_api(f"node.exe is not found.", color="red")
-            raise
-
-        node_version = node_version.replace("\n", "")
-        print_api(f"node.exe is found. Version: {node_version}", color="green")
-
-        try:
-            npm_version = subprocess.check_output(["npm.cmd", "-v"], text=True).strip()
-        except FileNotFoundError:
-            print_api(f"npm.cmd is not found.", color="red")
-            raise
-
-        npm_version = npm_version.replace("\n", "")
-        print_api(f"npm.cmd is found. Version: {npm_version}", color="green")
-        print_api("Node.js is installed.")
-        return True
-    except FileNotFoundError:
-        print_api("Node.js is not installed.")
-        return False
-
-
-def add_nodejs_to_path():
-    """
-    Add Node.js to the PATH for the current CMD session.
-    """
-    print_api("Adding Node.js to the PATH for the current session...")
-    # Get the installation directory from the default Node.js install path
-    program_files = os.environ.get("ProgramFiles", "C:\\Program Files")
-    nodejs_path = os.path.join(program_files, "nodejs")
-
-    if os.path.exists(nodejs_path):
-        print_api(f"Node.js installation found at: {nodejs_path}")
-        current_path = os.environ.get("PATH", "")
-        if nodejs_path not in current_path:
-            # Add Node.js to the PATH for the current process
-            os.environ["PATH"] = f"{nodejs_path};{current_path}"
-            print_api("Node.js has been added to the PATH for this session.")
-        else:
-            print_api("Node.js is already in the PATH.")
-    else:
-        print_api("Node.js installation directory not found.")
-
-
-def get_latest_nodejs_version():
-    """
-    Fetch the latest Node.js version from the official Node.js website.
-    """
-    print_api("Fetching the latest Node.js version...")
-    url = "https://nodejs.org/dist/latest/SHASUMS256.txt"
-
-    response = requests.get(url, timeout=10)
-    response.raise_for_status()
-    # Parse the file for the Node.js version
-    found_versions: list = []
-    for line in response.text.splitlines():
-        if line.endswith(WINDOWS_X64_SUFFIX):
-            found_versions.append(line)
-
-    if not found_versions:
-        raise NodeJSWindowsInstallerNoVersionsFound("No Node.js versions found in [https://nodejs.org/dist/latest/SHASUMS256.txt]")
-    elif len(found_versions) > 1:
-        raise NodeJSWindowsInstallerMoreThanOneVersionFound(f"More than one Node.js version found:\n"
-                                                            f"{'\n'.join(found_versions)}")
-
-    try:
-        file_name = found_versions[0].split("  ")[-1]
-    except IndexError:
-        raise NodeJSWindowsInstallerFailedToExtractFileNameFromString("Failed to extract the file name from the string.")
-
-    try:
-        version = file_name.replace("node-v", "").replace(f"-{WINDOWS_X64_SUFFIX}", "")
-    except Exception:
-        raise NodeJSWindowsInstallerFailedToExtractVersionInString("Failed to extract the version from the string.")
-
-    print_api(f"Latest Node.js version: {version}")
-    return version
-
-
-def download_nodejs_installer(version):
-    """
-    Download the Node.js MSI installer for Windows.
-    """
-
-    version = f"v{version}"
-    nodejs_base_url = f"https://nodejs.org/dist/{version}/"
-    file_name = f"node-{version}-x64.msi"
-    download_url = nodejs_base_url + file_name
-    print_api(f"Downloading Node.js installer from: {download_url}")
-
-    # Make temporary directory to store the installer
-    temp_dir = tempfile.gettempdir()
-    temp_file_path = web.download(download_url, temp_dir)
-    return temp_file_path
-
-
-def clean_up(installer_path):
-    """
-    Remove the installer file after installation.
-    """
-    try:
-        if os.path.exists(installer_path):
-            os.remove(installer_path)
-            print_api(f"Removed installer: {installer_path}")
-    except Exception as e:
-        print_api(f"Failed to clean up the installer: {e}")
-
-
-def install_nodejs_windows() -> int:
-    """
-    Install Node.js on Windows.
-    If you're installing as part of a cmd script that continues and installs npm packages, you can do something like this:
-        if not install_nodejs_windows.is_nodejs_installed():
-            install_nodejs_windows.is_nodejs_installed()
-        install_nodejs_windows.install_nodejs_windows()
-        install_nodejs_windows.add_nodejs_to_path()
-        if not install_nodejs_windows.is_nodejs_installed():
-            print_api("Node.js installation failed.")
-            return 1
-    :return:
-    """
-    if not permissions.is_admin():
-        print_api("This script requires administrative privileges to install Node.js.")
-        return 1
-
-    print_api("Starting Node.js installation process...")
-    version = get_latest_nodejs_version()
-    if not version:
-        print_api("Exiting: Could not fetch the latest Node.js version.")
-        return 1
-
-    installer_path = download_nodejs_installer(version)
-    if not installer_path:
-        print_api("Exiting: Failed to download the Node.js installer.")
-        return 1
-
-    msiw.install_msi(installer_path, silent_progress_bar=True)
-    time.sleep(5)  # Wait a few seconds for the installation to complete
-    clean_up(installer_path)
-    print_api("Installation process finished.")
-    return 0