atomicshop 3.3.3__py3-none-any.whl → 3.3.5__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.3'
+__version__ = '3.3.5'

atomicshop/wrappers/githubw.py

@@ -78,7 +78,7 @@ class GitHubWrapper:
         Usage to download the latest release where the file name is 'test_file.zip':
             git_wrapper = GitHubWrapper(user_name='user_name', repo_name='repo_name')
             git_wrapper.download_and_extract_latest_release(
-                target_directory='target_directory', string_pattern='test_*.zip')
+                target_directory='target_directory', asset_pattern='test_*.zip')
         ================================================================================================================
         Usage to get the latest release json:
             git_wrapper = GitHubWrapper(user_name='user_name', repo_name='repo_name')
@@ -116,6 +116,10 @@ class GitHubWrapper:
         self.commits_url: str = str()
         self.contents_url: str = str()
 
+        self.releases_url: str = str()
+        self.releases_per_page: int = 100
+        self.releases_starting_page: int = 1
+
         if self.user_name and self.repo_name and not self.repo_url:
             self.build_links_from_user_and_repo()
 
@@ -143,6 +147,7 @@ class GitHubWrapper:
         self.api_url = f'https://api.{self.domain}/repos/{self.user_name}/{self.repo_name}'
 
         self.latest_release_json_url: str = f'{self.api_url}/releases/latest'
+        self.releases_url: str = f'{self.api_url}/releases'
         self.commits_url: str = f'{self.api_url}/commits'
         self.contents_url: str = f'{self.api_url}/contents'
         self.branch_download_link = f'{self.api_url}/{self.branch_type_directory}/{self.branch}'
@@ -272,21 +277,133 @@ class GitHubWrapper:
 
             download_directory(self.path, current_target_directory, headers)
 
+    def get_releases_json(
+            self,
+            asset_pattern: str = None,
+            latest: bool = False,
+            per_page: int = None,
+            starting_page: int = None,
+            all_assets: bool = False,
+    ):
+        """
+        This function will get the releases json.
+        :param asset_pattern: str, the string pattern to search in the asset names of releases. Wildcards can be used.
+            If there is a match, the release will be added to the result list.
+        :param latest: bool, if True, will get only the latest release.
+            If 'asset_pattern' is provided, 'latest' will find the latest release matching the pattern.
+            Of course if you want to get it from all releases, you must set 'all_assets' to True.
+        :param per_page: int, the number of releases per page. Default is 100.
+        :param starting_page: int, the starting page number. Default is 1.
+        :param all_assets: bool, if True, will get all releases matching the pattern across all pages
+            OR all assets if no pattern is provided.
+        :return:
+        """
+
+        # If 'latest' is True and no 'asset_pattern' is provided, we only need to get 1 release from page 1.
+        # No need to get more assets than the first one.
+        if latest and not asset_pattern:
+            per_page = 1
+            starting_page = 1
+            all_assets = False
+        # In all other cases, get the releases according to the provided parameters or defaults.
+        else:
+            if not per_page:
+                per_page = self.releases_per_page
+
+            if not starting_page:
+                starting_page = self.releases_starting_page
+
+        headers: dict = self._get_headers()
+
+        params: dict = {
+            'per_page': per_page,
+            'page': starting_page
+        }
+
+        all_releases = []
+        while True:
+            response = requests.get(self.releases_url, headers=headers, params=params)
+            releases = response.json()
+            # If no releases found on current page, there will be none on the next as well, break the loop.
+            if not releases:
+                break
+
+            # If 'asset_pattern' is provided, filter releases to only those that have matching assets.
+            if asset_pattern:
+                for release in releases:
+                    assets = release.get('assets', [])
+                    matching_assets = [asset for asset in assets if fnmatch.fnmatch(asset.get('name', ''), asset_pattern)]
+                    if matching_assets:
+                        all_releases.append(release)
+
+                        if latest:
+                            return all_releases
+            else:
+                all_releases.extend(releases)
+
+            if not all_assets:
+                break
+
+            params['page'] += 1
+
+        return all_releases
+
+    def get_latest_release_json(
+            self,
+            asset_pattern: str = None
+    ) -> dict:
+        """
+        This function will get the latest releases json.
+        :param asset_pattern: str, the string pattern to search in the asset names of releases. Wildcards can be used.
+            If there is a match, the release will be added to the result list.
+        :return: dict, the latest release json.
+        """
+
+        if asset_pattern:
+            releases = self.get_releases_json(
+                asset_pattern=asset_pattern,
+                latest=True,
+                all_assets=True
+            )
+        else:
+            releases = self.get_releases_json(latest=True)
+
+        if not releases:
+            return {}
+        else:
+            return releases[0]
+
+    def get_latest_release_version(
+            self,
+            asset_pattern: str = None
+    ) -> str:
+        """
+        This function will get the latest release version number.
+
+        :param asset_pattern: str, the string pattern to search in the asset names of releases. Wildcards can be used.
+            If there is a match, the release will be added to the result list.
+        :return: str, the latest release version number.
+        """
+
+        latest_release_json: dict = self.get_latest_release_json(asset_pattern=asset_pattern)
+        latest_release_version: str = latest_release_json['tag_name']
+        return latest_release_version
+
     def get_latest_release_url(
             self,
-            string_pattern: str,
-            exclude_string: str = None,
+            asset_pattern: str,
+            exclude_pattern: str = None,
             **kwargs):
         """
         This function will return the latest release url.
-        :param string_pattern: str, the string pattern to search in the latest release. Wildcards can be used.
-        :param exclude_string: str, the string to exclude from the search. No wildcards can be used.
+        :param asset_pattern: str, the string pattern to search in the latest release. Wildcards can be used.
+        :param exclude_pattern: str, the string to exclude from the search. No wildcards can be used.
         :param kwargs: dict, the print arguments for the 'print_api' function.
         :return: str, the latest release url.
         """
 
         # Get the 'assets' key of the latest release json.
-        github_latest_releases_list = self.get_the_latest_release_json()['assets']
+        github_latest_releases_list = self.get_latest_release_json()['assets']
 
         # Get only download urls of the latest releases.
         download_urls: list = list()
@@ -294,13 +411,13 @@ class GitHubWrapper:
             download_urls.append(single_dict['browser_download_url'])
 
         # Exclude urls against 'exclude_string'.
-        if exclude_string:
+        if exclude_pattern:
             for download_url in download_urls:
-                if exclude_string in download_url:
+                if exclude_pattern in download_url:
                     download_urls.remove(download_url)
 
-        # Find urls against 'string_pattern'.
-        found_urls: list = fnmatch.filter(download_urls, string_pattern)
+        # Find urls against 'asset_pattern'.
+        found_urls: list = fnmatch.filter(download_urls, asset_pattern)
 
         # If more than 1 url answer the criteria, we can't download it. The user must be more specific in his input
         # strings.
@@ -317,15 +434,15 @@ class GitHubWrapper:
     def download_latest_release(
             self,
             target_directory: str,
-            string_pattern: str,
+            asset_pattern: str,
             exclude_string: str = None,
             **kwargs):
         """
         This function will download the latest release from the GitHub repository.
         :param target_directory: str, the target directory to download the file.
-        :param string_pattern: str, the string pattern to search in the latest release. Wildcards can be used.
+        :param asset_pattern: str, the string pattern to search in the latest release. Wildcards can be used.
         :param exclude_string: str, the string to exclude from the search. No wildcards can be used.
-            The 'excluded_string' will be filtered before the 'string_pattern' entries.
+            The 'excluded_string' will be filtered before the 'asset_pattern' entries.
         :param kwargs: dict, the print arguments for the 'print_api' function.
         :return:
         """
@@ -333,7 +450,7 @@ class GitHubWrapper:
         headers: dict = self._get_headers()
 
         # Get the latest release url.
-        found_url = self.get_latest_release_url(string_pattern=string_pattern, exclude_string=exclude_string, **kwargs)
+        found_url = self.get_latest_release_url(asset_pattern=asset_pattern, exclude_string=exclude_string, **kwargs)
 
         downloaded_file_path = web.download(
             file_url=found_url, target_directory=target_directory, headers=headers, **kwargs)
@@ -342,7 +459,7 @@ class GitHubWrapper:
     def download_and_extract_latest_release(
             self,
             target_directory: str,
-            string_pattern: str,
+            asset_pattern: str,
             exclude_string: str = None,
             archive_remove_first_directory: bool = False,
             **kwargs):
@@ -350,7 +467,7 @@ class GitHubWrapper:
         This function will download the latest release from the GitHub repository, extract the file and remove the file,
         leaving only the extracted folder.
         :param target_directory: str, the target directory to download and extract the file.
-        :param string_pattern: str, the string pattern to search in the latest release. Wildcards can be used.
+        :param asset_pattern: str, the string pattern to search in the latest release. Wildcards can be used.
         :param exclude_string: str, the string to exclude from the search. No wildcards can be used.
         :param archive_remove_first_directory: bool, sets if archive extract function will extract the archive
             without first directory in the archive. Check reference in the
@@ -362,7 +479,7 @@ class GitHubWrapper:
         headers: dict = self._get_headers()
 
         # Get the latest release url.
-        found_url = self.get_latest_release_url(string_pattern=string_pattern, exclude_string=exclude_string, **kwargs)
+        found_url = self.get_latest_release_url(asset_pattern=asset_pattern, exclude_string=exclude_string, **kwargs)
 
         web.download_and_extract_file(
             file_url=found_url,
@@ -371,24 +488,6 @@ class GitHubWrapper:
             headers=headers,
             **kwargs)
 
-    def get_the_latest_release_json(self):
-        """
-        This function will get the latest releases json.
-        :return:
-        """
-
-        headers: dict = self._get_headers()
-
-        response = requests.get(self.latest_release_json_url, headers=headers)
-        return response.json()
-
-    def get_the_latest_release_version_number(self):
-        """
-        This function will get the latest release version number.
-        :return:
-        """
-        return self.get_the_latest_release_json()['tag_name']
-
     def get_latest_commit(self) -> dict:
         """
         This function retrieves the latest commit on the specified branch.

atomicshop/wrappers/socketw/sni.py

@@ -274,7 +274,7 @@ class SNIHandler:
 
             # Setting "server_hostname" as a domain.
             self.sni_received_parameters.ssl_socket.server_hostname = self.sni_received_parameters.destination_name
-            print_api("SNI Passed: True", color="yellow", **(print_kwargs or {}))
+            print_api("SNI Passed: True", **(print_kwargs or {}))
             message = (
                 f"SNI Handler: port {self.sni_received_parameters.ssl_socket.getsockname()[1]}: "
                 f"Incoming connection for [{self.sni_received_parameters.ssl_socket.server_hostname}]")

{atomicshop-3.3.3.dist-info → atomicshop-3.3.5.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atomicshop
-Version: 3.3.3
+Version: 3.3.5
 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.3.dist-info → atomicshop-3.3.5.dist-info}/RECORD

@@ -1,4 +1,4 @@
-atomicshop/__init__.py,sha256=A47BWVHvVET6LMVlCSW87U79q8X9M4kwmxOtynSkYqA,122
+atomicshop/__init__.py,sha256=lCOFyywOc7EF6Esxu6aQIR9lx9HA8beRu1ut7lEQ3oU,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
@@ -54,11 +54,9 @@ 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
@@ -197,8 +195,7 @@ atomicshop/wrappers/astw.py,sha256=VkYfkfyc_PJLIOxByT6L7B8uUmKY6-I8XGZl4t_z828,4
 atomicshop/wrappers/configparserw.py,sha256=JwDTPjZoSrv44YKwIRcjyUnpN-FjgXVfMqMK_tJuSgU,22800
 atomicshop/wrappers/cryptographyw.py,sha256=QEUpDn8vUvMg3ADz6-4oC2kbDNC_woDlw7C0zU7qFVM,14233
 atomicshop/wrappers/ffmpegw.py,sha256=wcq0ZnAe0yajBOuTKZCCaKI7CDBjkq7FAgdW5IsKcVE,6031
-atomicshop/wrappers/githubw.py,sha256=DrFF_oN-rulPQV1iKgVzZadCjuYuCC5eKAjZp_3YD0g,23476
-atomicshop/wrappers/msiw.py,sha256=GQLqud72nfex3kvO1bJSruNriCYTYX1_G1gSf1MPkIA,6118
+atomicshop/wrappers/githubw.py,sha256=bds_8fgyFyHXKwty6-SBS3H3Ueta2IMM5UQFpiFmgHQ,27554
 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 +274,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
@@ -328,7 +322,7 @@ atomicshop/wrappers/socketw/exception_wrapper.py,sha256=qW_1CKyPgGlsIt7_jusKkMV4
 atomicshop/wrappers/socketw/get_process.py,sha256=aJC-_qFUv3NgWCSUzDI72E4z8_-VTZE9NVZ0CwUoNlM,5698
 atomicshop/wrappers/socketw/receiver.py,sha256=9B3MvcDqr4C3x2fsnjG5SQognd1wRqsBgikxZa0wXG8,8243
 atomicshop/wrappers/socketw/sender.py,sha256=aX_K8l_rHjd5AWb8bi5mt8-YTkMYVRDB6DnPqK_XDUE,4754
-atomicshop/wrappers/socketw/sni.py,sha256=GaYnn-CFFmA1WcyFXqICnSLfkM2CNAeS8fTZsruLoaI,17927
+atomicshop/wrappers/socketw/sni.py,sha256=YlKavbExcPFfHFLYAJ3i3W6QorY7o4mbQp39g-DnDKA,17911
 atomicshop/wrappers/socketw/socket_client.py,sha256=McBd3DeCy787oDGCEMUEP2awWy3vdkPqr9w-aFh2fBM,22502
 atomicshop/wrappers/socketw/socket_server_tester.py,sha256=Qobmh4XV8ZxLUaw-eW4ESKAbeSLecCKn2OWFzMhadk0,6420
 atomicshop/wrappers/socketw/socket_wrapper.py,sha256=u_v0pjMMrgsdtI0iPPddiLe2wXnBoqTgNM9Y3zjGD4U,41013
@@ -337,9 +331,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.3.dist-info/licenses/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
-atomicshop-3.3.3.dist-info/METADATA,sha256=_zTFWmzEYji52hVTJBoGFrdrjSxlo6wS1AhAhq0qHqQ,9288
-atomicshop-3.3.3.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-atomicshop-3.3.3.dist-info/entry_points.txt,sha256=SJEgEP0KoFtfxuGwe5tOzKfXkjR9Dv6YYug33KNYxyY,69
-atomicshop-3.3.3.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
-atomicshop-3.3.3.dist-info/RECORD,,
+atomicshop-3.3.5.dist-info/licenses/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
+atomicshop-3.3.5.dist-info/METADATA,sha256=QAiSikiYm60q_UBleSyptTY9jvGM6s_7fk2yrncVrec,9311
+atomicshop-3.3.5.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+atomicshop-3.3.5.dist-info/entry_points.txt,sha256=SJEgEP0KoFtfxuGwe5tOzKfXkjR9Dv6YYug33KNYxyY,69
+atomicshop-3.3.5.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
+atomicshop-3.3.5.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/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