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

atomicshop/archiver/search_in_archive.py

@@ -3,7 +3,7 @@ import zipfile
 from io import BytesIO
 from typing import Union
 
-from . import zip, sevenz
+from . import zips, sevenzs
 from .. import file_types
 
 import py7zr
@@ -37,12 +37,12 @@ def _get_unique_filename(directory, filename):
 
 def _is_zip_file(file, zip_obj):
     with zip_obj.open(file) as file_data:
-        return zip.is_zip_zipfile(file_data.read())
+        return zips.is_zip_zipfile(file_data.read())
 
 
 def _is_7z_file(file, sevenz_obj):
     with sevenz_obj.open(file) as file_data:
-        return sevenz.is_7z(file_data.read())
+        return sevenzs.is_7z(file_data.read())
 
 
 def _match_file_name(target, current, case_sensitive):
@@ -158,9 +158,9 @@ def _get_archive_type(file_object) -> Union[str, None]:
     if file_mime not in SUPPORTED_ARCHIVE_MIMES:
         return None
 
-    if zip.is_zip_zipfile(file_object):
+    if zips.is_zip_zipfile(file_object):
         return 'zip'
-    elif sevenz.is_7z(file_object):
+    elif sevenzs.is_7z(file_object):
         return '7z'
     else:
         raise UnknownArchiveType(f"{file_object[:10]} is not a known archive type.")

atomicshop/basics/dicts.py

@@ -244,6 +244,58 @@ def convert_object_with_attributes_to_dict(
     return obj_dict
 
 
+def convert_complex_object_to_dict(data):
+    """ Function that converts complex objects to dict recursively """
+
+    # 1. Extracts only the first level of objects. No byte decoding.
+    # new_dict = dict()
+    # for key, value in vars(obj).items():
+    #     new_dict.update({key: str(value)})
+    # return new_dict
+
+    # 2. Extracts only the first level of objects. Tries to decode bytes, if exception rises stores string as is.
+    # new_dict = dict()
+    # for key, value in vars(obj).items():
+    #     try:
+    #         new_dict.update({key: value.decode('utf-8')})
+    #     except Exception:
+    #         new_dict.update({key: str(value)})
+    # return new_dict
+
+    # 3. Decompress all the objects, save objects as is (no byte decoding).
+    if hasattr(data, "__dict__"):
+        # 'vars' return a dictionary of all the variables in a class / object.
+        # 'map' iterates through function 'dict_converter' all the values of the second argument and returns a list
+        # of all iterations of the function result.
+        function_return = dict(map(convert_complex_object_to_dict, vars(data).items()))
+        # If 'data' type is 'bytes'
+    elif isinstance(data, dict):
+        function_return = dict(map(convert_complex_object_to_dict, data.items()))
+    elif isinstance(data, tuple):
+        function_return = tuple(map(convert_complex_object_to_dict, data))
+    elif isinstance(data, list):
+        function_return = list(map(convert_complex_object_to_dict, data))
+    # One value objects.
+    elif isinstance(data, datetime.datetime):
+        function_return = data.strftime('%Y-%m-%d-%H:%M:%S')
+    elif isinstance(data, bytes) or isinstance(data, bytearray):
+        function_return = str(data)
+
+        # Don't want to use the next method, since there will be different formatted strings / messages. And we don't
+        # want that, since we can't manipulate it easily later.
+        # # Try to decode, if fails, return string.
+        # try:
+        #     function_return = data.decode(encoding='utf-8')
+        # except Exception:
+        #     function_return = str(data)
+        #     pass
+    # Any other type will return as is (something that 'dict()' function can handle), like strings and integers.
+    else:
+        function_return = data
+
+    return function_return
+
+
 def convert_tuples_to_lists(obj):
     """
     Convert all tuples in object to lists. The first  input 'obj' can be a dictionary, list or tuple.

atomicshop/mitm/shared_functions.py

@@ -1,11 +1,9 @@
-# v1.0.2 - 21.03.2023 13:50
 import json
-# Needed to convert datetime objects inside 'dict_converter' function.
-import datetime
 # Needed to get the function caller module.
 import inspect
 
 from ..wrappers.loggingw import loggingw
+from ..basics import dicts
 
 
 # If the string has several dot characters (".") - return the most right string after the last dot.
@@ -40,59 +38,7 @@ def create_custom_logger():
     return loggingw.get_logger_with_level(logger_name)
 
 
-def dict_converter(data):
-    """ Function that converts complex objects to dict recursively """
-
-    # 1. Extracts only the first level of objects. No byte decoding.
-    # new_dict = dict()
-    # for key, value in vars(obj).items():
-    #     new_dict.update({key: str(value)})
-    # return new_dict
-
-    # 2. Extracts only the first level of objects. Tries to decode bytes, if exception rises stores string as is.
-    # new_dict = dict()
-    # for key, value in vars(obj).items():
-    #     try:
-    #         new_dict.update({key: value.decode('utf-8')})
-    #     except Exception:
-    #         new_dict.update({key: str(value)})
-    # return new_dict
-
-    # 3. Decompress all the objects, save objects as is (no byte decoding).
-    if hasattr(data, "__dict__"):
-        # 'vars' return a dictionary of all the variables in a class / object.
-        # 'map' iterates through function 'dict_converter' all the values of the second argument and returns a list
-        # of all iterations of the function result.
-        function_return = dict(map(dict_converter, vars(data).items()))
-        # If 'data' type is 'bytes'
-    elif isinstance(data, dict):
-        function_return = dict(map(dict_converter, data.items()))
-    elif isinstance(data, tuple):
-        function_return = tuple(map(dict_converter, data))
-    elif isinstance(data, list):
-        function_return = list(map(dict_converter, data))
-    # One value objects.
-    elif isinstance(data, datetime.datetime):
-        function_return = data.strftime('%Y-%m-%d-%H:%M:%S')
-    elif isinstance(data, bytes) or isinstance(data, bytearray):
-        function_return = str(data)
-
-        # Don't want to use the next method, since there will be different formatted strings / messages. And we don't
-        # want that, since we can't manipulate it easily later.
-        # # Try to decode, if fails, return string.
-        # try:
-        #     function_return = data.decode(encoding='utf-8')
-        # except Exception:
-        #     function_return = str(data)
-        #     pass
-    # Any other type will return as is (something that 'dict()' function can handle), like strings and integers.
-    else:
-        function_return = data
-
-    return function_return
-
-
 def get_json(obj):
     """ Convert any nested object to json / dict and values to string as is """
 
-    return json.dumps(obj, default=dict_converter)
+    return json.dumps(obj, default=dicts.convert_complex_object_to_dict)

atomicshop/web.py

@@ -2,7 +2,7 @@ import os
 import urllib.request
 
 from .print_api import print_api
-from .archiver import zip
+from .archiver import zips
 from .urls import url_parser
 from .file_io import file_io
 from .wrappers.playwrightw import scenarios
@@ -239,7 +239,7 @@ def download_and_extract_file(
         file_url=file_url, target_directory=target_directory, file_name=file_name, **kwargs)
 
     # Extract the archive and remove the first directory.
-    zip.extract_archive_with_zipfile(
+    zips.extract_archive_with_zipfile(
         archive_path=f'{file_path}', extract_directory=target_directory,
         remove_first_directory=archive_remove_first_directory, **kwargs)
 

atomicshop/wrappers/elasticsearchw/config_basic.py

@@ -6,10 +6,15 @@ DEFAULT_KIBANA_PORT: str = '5601'
 DEFAULT_KIBANA_HOST: str = 'localhost'
 DEFAULT_KIBANA_URL: str = f"http://{DEFAULT_KIBANA_HOST}:{DEFAULT_KIBANA_PORT}"
 
-ELASTIC_CONFIG_FILE: str = "/etc/elasticsearch/elasticsearch.yml"
-ELASTIC_JVM_OPTIONS_FILE: str = "/etc/elasticsearch/jvm.options"
+ELASTIC_SEARCH_CONFIG_DIRECTORY: str = "/etc/elasticsearch"
+
+ELASTIC_CONFIG_FILE: str = f"{ELASTIC_SEARCH_CONFIG_DIRECTORY}/elasticsearch.yml"
 XPACK_SECURITY_SETTING_NAME: str = "xpack.security.enabled"
 
+ELASTIC_JVM_OPTIONS_DIRECTORY: str = f"{ELASTIC_SEARCH_CONFIG_DIRECTORY}/jvm.options.d"
+ELASTIC_JVM_OPTIONS_CUSTOM_FILE: str = f"{ELASTIC_JVM_OPTIONS_DIRECTORY}/custom.options"
+ELASTIC_JVM_OPTIONS_4GB_MEMORY_USAGE: list[str] = ['-Xms4g', '-Xmx4g']
+
 UBUNTU_DEPENDENCY_PACKAGES: list[str] = ['apt-transport-https', 'openjdk-11-jdk', 'wget']
 UBUNTU_ELASTIC_PACKAGE_NAME: str = 'elasticsearch'
 UBUNTU_ELASTIC_SERVICE_NAME: str = 'elasticsearch'

atomicshop/wrappers/elasticsearchw/infrastructure.py

@@ -170,6 +170,29 @@ def modify_xpack_security_setting(
             print_api(f"The setting is already set to [{setting}].")
 
 
+def create_jvm_options_custom_file(file_path: str = None, options: list = None):
+    """
+    The function creates a custom JVM options file for Elasticsearch.
+    The default file path is 'config_basic.ELASTIC_JVM_OPTIONS_CUSTOM_FILE'.
+    The default options are 'config_basic.ELASTIC_JVM_OPTIONS_4GB_MEMORY_USAGE'.
+    The 4GB memory usage options are needed for the Elasticsearch to work properly and not to crash.
+    :param file_path: str, the path to the custom JVM options file.
+    :param options: list, the list of JVM options.
+    :return:
+    """
+
+    if not file_path:
+        file_path = config_basic.ELASTIC_JVM_OPTIONS_CUSTOM_FILE
+
+    if not options:
+        options = config_basic.ELASTIC_JVM_OPTIONS_4GB_MEMORY_USAGE
+
+    # Write the options to the file.
+    with open(file_path, 'w') as file:
+        for option in options:
+            file.write(f"{option}\n")
+
+
 def is_server_available(
         max_attempts: int = 5,
         wait_between_attempts_seconds: float = 10,

atomicshop/wrappers/elasticsearchw/install_elastic.py

@@ -215,6 +215,12 @@ def install_elastic_kibana_ubuntu(install_elastic: bool = True, install_kibana:
 
         infrastructure.start_elastic_and_check_service_availability()
 
+        print_api("Creating custom JVM options file with 4GB memory usage.")
+        infrastructure.create_jvm_options_custom_file(
+            file_path=config_basic.ELASTIC_JVM_OPTIONS_CUSTOM_FILE,
+            options=config_basic.ELASTIC_JVM_OPTIONS_4GB_MEMORY_USAGE
+        )
+
     if install_kibana:
         # Install Kibana.
         ubuntu_terminal.install_packages([config_basic.UBUNTU_KIBANA_PACKAGE_NAME])

atomicshop/wrappers/factw/install/pre_install_and_install_before_restart.py

@@ -3,13 +3,19 @@ from pathlib import Path
 import sys
 
 from .... import permissions, filesystem
+from ....archiver import zips
 from ....print_api import print_api
-from ... import githubw, ubuntu_terminal
+from ... import githubw
 from ...dockerw import install_docker
 from .. import config_install
 
 
-def install_before_restart(installation_directory: str, remove_existing_installation_directory: bool = True):
+def install_before_restart(
+        installation_directory: str,
+        remove_existing_installation_directory: bool = True,
+        fact_source_archive_path: str = None,
+        print_kwargs: dict = None
+):
     """
     This function will install the FACT_core before the restart of the computer.
     :param installation_directory: string, the directory to install the FACT_core to.
@@ -17,6 +23,13 @@ def install_before_restart(installation_directory: str, remove_existing_installa
         if True, the existing installation directory will be removed.
         if False, the existing installation directory will not be removed and FACT installation scripts will do their
             best to install the FACT_core to the existing installation directory.
+    :param fact_source_archive_path: string, the path to the FACT_core source archive.
+        This is used when the FACT_core source archive is already downloaded, and you want to use the specific archive
+        instead of downloading it again. Or you want to use a specific version of the FACT_core.
+        This is optional, if not provided, the latest version of the FACT_core will be downloaded.
+        The archive should be an exact copy of the FACT_core repository of the master branch as you download it from
+        GitHub.
+    :param print_kwargs: dict, the print kwargs for the print_api function.
     :return:
     """
 
@@ -36,20 +49,27 @@ def install_before_restart(installation_directory: str, remove_existing_installa
     if remove_existing_installation_directory:
         filesystem.remove_directory(installation_directory)
 
+    # Since you run the script with sudo, we need to change the permissions to the current user.
     with permissions.temporary_regular_permissions():
         # Create the FACT_core directory.
         filesystem.create_directory(installation_directory)
 
-        # Download the FACT_core repo.
-        if not filesystem.get_file_paths_from_directory(installation_directory):
-            git_wrapper = githubw.GitHubWrapper(repo_url=config_install.FACT_CORE_GITHUB_URL)
-            git_wrapper.build_links_from_repo_url()
-            git_wrapper.download_and_extract_branch(
-                target_directory=installation_directory,
-                archive_remove_first_directory=True)
+        if not fact_source_archive_path:
+            # Download the FACT_core repo.
+            if not filesystem.get_file_paths_from_directory(installation_directory):
+                git_wrapper = githubw.GitHubWrapper(repo_url=config_install.FACT_CORE_GITHUB_URL)
+                git_wrapper.build_links_from_repo_url()
+                git_wrapper.download_and_extract_branch(
+                    target_directory=installation_directory,
+                    archive_remove_first_directory=True)
+        else:
+            # Extract the archive and remove the first directory.
+            zips.extract_archive_with_zipfile(
+                archive_path=fact_source_archive_path, extract_directory=installation_directory,
+                remove_first_directory=True, **(print_kwargs or {}))
 
-    # Set the executable permission on the pre-install file.
-    permissions.set_executable_permission(fact_core_pre_install_file_path)
+        # Set the executable permission on the pre-install file.
+        permissions.set_executable_permission(fact_core_pre_install_file_path)
 
     # Run the shell script
     subprocess.run(['bash', fact_core_pre_install_file_path])

atomicshop/wrappers/githubw.py

@@ -1,18 +1,79 @@
 import requests
 import fnmatch
 
-from ..web import download_and_extract_file
+from .. import web, urls
 from ..print_api import print_api
-from ..urls import url_parser
 
 
 class GitHubWrapper:
     # You also can use '.tar.gz' as extension.
     def __init__(
-            self, user_name: str = str(), repo_name: str = str(), repo_url: str = str(),
-            branch: str = 'master', branch_file_extension: str = '.zip'):
+            self,
+            user_name: str = None,
+            repo_name: str = None,
+            repo_url: str = None,
+            branch: str = 'master',
+            branch_file_extension: str = '.zip'
+    ):
+        """
+        This class is a wrapper for GitHub repositories. It can download the branch file from the repository and extract
+        it to the target directory and more.
+
+        :param user_name: str, the user-name of the repository.
+             https://github.com/{user_name}/{repo_name}
+        :param repo_name: str, the repository name.
+        :param repo_url: str, the repository url.
+            You can provide the full url to the repository directly and then extract the user_name and repo_name from it
+            with the 'build_links_from_repo_url' function.
+        :param branch: str, the branch name. The default is 'master'.
+        :param branch_file_extension: str, the branch file extension. The default is '.zip'.
+
+        ================================================================================================================
+        Usage to download the 'master' branch file:
+            git_wrapper = GitHubWrapper(user_name='user_name', repo_name='repo_name')
+            git_wrapper.download_and_extract_branch(target_directory='target_directory')
+
+        Usage to download the 'main' branch file:
+            git_wrapper = GitHubWrapper(user_name='user_name', repo_name='repo_name', branch='main')
+            git_wrapper.download_and_extract_branch(target_directory='target_directory')
+
+        You can provide the user_name and repo_name after the initialization of the class:
+            git_wrapper = GitHubWrapper()
+            git_wrapper.user_name = 'user_name'
+            git_wrapper.repo_name = 'repo_name'
+            git_wrapper.build_links_from_user_and_repo()
+            git_wrapper.download_and_extract_branch(target_directory='target_directory')
+        ================================================================================================================
+        Usage to download the 'master' branch file from the repository url:
+            git_wrapper = GitHubWrapper(repo_url='http://github.com/user_name/repo_name')
+            git_wrapper.download_and_extract_branch(target_directory='target_directory')
+
+        Usage to download the 'main' branch file from the repository url:
+            git_wrapper = GitHubWrapper(repo_url='http://github.com/user_name/repo_name', branch='main')
+            git_wrapper.download_and_extract_branch(target_directory='target_directory')
+
+        You can provide the repo_url after the initialization of the class:
+            git_wrapper = GitHubWrapper()
+            git_wrapper.repo_url = 'http://github.com/user_name/repo_name'
+            git_wrapper.build_links_from_repo_url()
+            git_wrapper.download_and_extract_branch(target_directory='target_directory')
+        ================================================================================================================
+        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')
+        ================================================================================================================
+        Usage to get the latest release json:
+            git_wrapper = GitHubWrapper(user_name='user_name', repo_name='repo_name')
+            git_wrapper.get_the_latest_release_json()
+        ================================================================================================================
+        Usage to get the latest release version:
+            git_wrapper = GitHubWrapper(user_name='user_name', repo_name='repo_name')
+            git_wrapper.get_the_latest_release_version_number()
+        """
+
         self.user_name: str = user_name
-        self.repo_name = repo_name
+        self.repo_name: str = repo_name
         self.repo_url: str = repo_url
         self.branch: str = branch
         self.branch_file_extension: str = branch_file_extension
@@ -27,6 +88,12 @@ class GitHubWrapper:
         self.branch_downloaded_folder_name: str = str()
         self.latest_release_json_url: str = str()
 
+        if self.user_name and self.repo_name and not self.repo_url:
+            self.build_links_from_user_and_repo()
+
+        if self.repo_url and not self.user_name and not self.repo_name:
+            self.build_links_from_repo_url()
+
     def build_links_from_user_and_repo(self, **kwargs):
         if not self.user_name or not self.repo_name:
             message = "'user_name' or 'repo_name' is empty."
@@ -43,7 +110,7 @@ class GitHubWrapper:
             message = "'repo_url' is empty."
             print_api(message, color="red", error_type=True, **kwargs)
 
-        repo_url_parsed = url_parser(self.repo_url)
+        repo_url_parsed = urls.url_parser(self.repo_url)
         self.check_github_domain(repo_url_parsed['netloc'])
         self.user_name = repo_url_parsed['directories'][0]
         self.repo_name = repo_url_parsed['directories'][1]
@@ -73,20 +140,32 @@ class GitHubWrapper:
         """
 
         # Download the repo to current working directory, extract and remove the archive.
-        download_and_extract_file(
+        web.download_and_extract_file(
             file_url=self.branch_download_link,
             target_directory=target_directory,
             archive_remove_first_directory=archive_remove_first_directory,
             **kwargs)
 
     def download_and_extract_latest_release(
-            self, target_directory: str, string_pattern: str,
-            archive_remove_first_directory: bool = False, **kwargs):
-        # Download latest release url.
-        response = requests.get(self.latest_release_json_url)
-        # Response from the latest releases page is json. Convert response to json from downloaded format and get
-        # 'assets' key.
-        github_latest_releases_list = response.json()['assets']
+            self,
+            target_directory: str,
+            string_pattern: str,
+            archive_remove_first_directory: bool = False,
+            **kwargs):
+        """
+        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 archive_remove_first_directory: bool, sets if archive extract function will extract the archive
+            without first directory in the archive. Check reference in the
+            'archiver.zip.extract_archive_with_zipfile' function.
+        :param kwargs: dict, the print arguments for the 'print_api' function.
+        :return:
+        """
+
+        # Get the 'assets' key of the latest release json.
+        github_latest_releases_list = self.get_the_latest_release_json()['assets']
 
         # Get only download urls of the latest releases.
         download_urls: list = list()
@@ -103,8 +182,23 @@ class GitHubWrapper:
                       f'{found_urls}'
             print_api(message, color="red", error_type=True, **kwargs)
 
-        download_and_extract_file(
+        web.download_and_extract_file(
             file_url=found_urls[0],
             target_directory=target_directory,
             archive_remove_first_directory=archive_remove_first_directory,
             **kwargs)
+
+    def get_the_latest_release_json(self):
+        """
+        This function will get the latest releases json.
+        :return:
+        """
+        response = requests.get(self.latest_release_json_url)
+        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']

atomicshop/wrappers/nodejsw/install_nodejs.py

@@ -1,7 +1,8 @@
 import subprocess
-import getpass
+import requests
 
-from ... import process, filesystem, permissions
+from ...basics import booleans
+from .. import githubw, ubuntu_terminal
 from ...print_api import print_api
 
 
@@ -28,22 +29,105 @@ def is_nodejs_installed():
         return False
 
 
-def install_nodejs_ubuntu():
+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.check_3_booleans_when_only_1_can_be_true(
+        (install_latest_version, 'install_latest_version'),
+        (install_lts, 'install_lts'),
+        (install_by_version_number, 'install_by_version_number')
+    )
+
     # Check if Node.js is already installed.
     if is_nodejs_installed():
-        return
+        if not force_install:
+            return
 
-    # Add the Node.js repository.
-    process.run_command(['curl', '-sL', 'https://deb.nodesource.com/setup_14.x', '-o', '/tmp/nodesource_setup.sh'])
-    process.run_command(['bash', '/tmp/nodesource_setup.sh'])
+    # 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...")
 
-    # Install Node.js
-    process.run_command(['apt-get', 'install', '-y', 'nodejs'])
+    # 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_npm_package_ubuntu(package_name: str):
+    """
+    The function will install a npm package on Ubuntu.
+    :param package_name: str, the name of the package to install.
+    :return:
+    """
 
     # Check if Node.js is installed.
-    is_nodejs_installed()
+    if not is_nodejs_installed():
+        return
+
+    command = f"npm install -g {package_name}"
+    _ = subprocess.check_output(command, shell=True, stderr=subprocess.STDOUT)

{atomicshop-2.9.33.dist-info → atomicshop-2.10.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: atomicshop
-Version: 2.9.33
+Version: 2.10.1
 Summary: Atomic functions and classes to make developer life easier
 Author: Denis Kras
 License: MIT License

{atomicshop-2.9.33.dist-info → atomicshop-2.10.1.dist-info}/RECORD

@@ -1,4 +1,4 @@
-atomicshop/__init__.py,sha256=xZ_X7wkuj9RC8hITqUIPCnbV_tPMEP3Ct3FVSt2GWdM,123
+atomicshop/__init__.py,sha256=ukl6aqshNmALeGqIPGLVnag3oMdx9rXTGHupAsgJhXk,123
 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
@@ -44,7 +44,7 @@ atomicshop/timer.py,sha256=KxBBgVM8po6pUJDW8TgY1UXj0iiDmRmL5XDCq0VHAfU,1670
 atomicshop/urls.py,sha256=CQl1j1kjEVDlAuYJqYD9XxPF1SUSgrmG8PjlcXNEKsQ,597
 atomicshop/uuids.py,sha256=JSQdm3ZTJiwPQ1gYe6kU0TKS_7suwVrHc8JZDGYlydM,2214
 atomicshop/virtualization.py,sha256=LPP4vjE0Vr10R6DA4lqhfX_WaNdDGRAZUW0Am6VeGco,494
-atomicshop/web.py,sha256=K3UndqJqHO9bTogZUWDz-IEZN776KNhpk28m3Ct_pbc,11069
+atomicshop/web.py,sha256=7WPV6Q4xZX7bByEeCl2VAfPlyMY42BpR_byVX0Gu7Js,11071
 atomicshop/addons/PlayWrightCodegen.cmd,sha256=Z5cnllsyXD4F1W2h-WLEnyFkg5nZy0-hTGHRWXVOuW4,173
 atomicshop/addons/ScriptExecution.cmd,sha256=8iC-uHs9MX9qUD_C2M7n9Xw4MZvwOfxT8H5v3hluVps,93
 atomicshop/addons/a_setup_scripts/install_psycopg2_ubuntu.sh,sha256=lM7LkXQ2AxfFzDGyzSOfIS_zpg9bAD1k3JJ-qu5CdH8,81
@@ -67,16 +67,16 @@ atomicshop/addons/process_list/compiled/Win10x64/process_list.lib,sha256=n9c2MVP
 atomicshop/archiver/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/archiver/_search_in_zip.py,sha256=dd8qFSvIhcKmtnPj_uYNJFPmMwZp4tZys0kKgTw_ACw,8385
 atomicshop/archiver/archiver.py,sha256=BomnK7zT-nQXA1z0i2R2aTv8eu88wPx7tf2HtOdbmEc,1280
-atomicshop/archiver/search_in_archive.py,sha256=mEngDfULXBd3Oio8a2SUtynfJASVLsH74XIYJOWVkH0,10467
-atomicshop/archiver/sevenz.py,sha256=5i_C50-deC1Cz_GQdMGofV2jeMPbbGWAvih-QnA72cg,1370
-atomicshop/archiver/zip.py,sha256=k742K1bEDtc_4N44j_Waebi-uOkxxavqltvV6q-BLW4,14402
+atomicshop/archiver/search_in_archive.py,sha256=kui33oobL2F3VLgAE8L037rHR8Ud3HpXz_E0tbuiDD4,10473
+atomicshop/archiver/sevenzs.py,sha256=5i_C50-deC1Cz_GQdMGofV2jeMPbbGWAvih-QnA72cg,1370
+atomicshop/archiver/zips.py,sha256=k742K1bEDtc_4N44j_Waebi-uOkxxavqltvV6q-BLW4,14402
 atomicshop/basics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/basics/ansi_escape_codes.py,sha256=WtIkm-BjSZS5J5irDUdAMBNvdX-qXFZcTX98jcBMpJE,3140
 atomicshop/basics/argparse_template.py,sha256=horwgSf3MX1ZgRnYxtmmQuz9OU_vKrKggF65gmjlmfg,5836
 atomicshop/basics/booleans.py,sha256=va3LYIaSOhjdifW4ZEesnIQxBICNHyQjUAkYelzchhE,2047
 atomicshop/basics/bytes_arrays.py,sha256=WvSRDhIGt1ywF95t-yNgpxLm1nlZUbM1Dz6QckcyE8Y,5915
 atomicshop/basics/classes.py,sha256=EijW_g4EhdNBnKPMG3nT3HjFspTchtM7to6zm9Ad_Mk,9771
-atomicshop/basics/dicts.py,sha256=N696f-vamrCcLpLOvtRpHrEmLfyOqkCyW8JDZnwYLpg,11295
+atomicshop/basics/dicts.py,sha256=JevEkLsQdH4Tqn8rspSey40jW6h8pJ2SP5fcuFBR4dU,13651
 atomicshop/basics/dicts_nested.py,sha256=StYxYnYPa0SEJr1lmEwAv5zfERWWqoULeyG8e0zRAwE,4107
 atomicshop/basics/enumerations.py,sha256=41VVQYh_vnVapggxKg2IRU5e_EiMpZzX1n1mtxvoSzM,1364
 atomicshop/basics/enums.py,sha256=CeV8MfqWHihK7vvV6Mbzq7rD9JykeQfrJeFdLVzfHI4,3547
@@ -111,7 +111,7 @@ atomicshop/mitm/import_config.py,sha256=_V-IVJ7a1L6E-VOR4CDfZj-S1odbsIlBe13ij0Nl
 atomicshop/mitm/initialize_engines.py,sha256=UGdT5DKYNri3MNOxESP7oeSxYiUDrVilJ4jic_nwdew,8055
 atomicshop/mitm/initialize_mitm_server.py,sha256=aXNZlRu1_RGjC7lagvs2Q8rjQiygxYucy-U4C_SBnsk,13871
 atomicshop/mitm/message.py,sha256=u2U2f2SOHdBNU-6r1Ik2W14ai2EOwxUV4wVfGZA098k,1732
-atomicshop/mitm/shared_functions.py,sha256=NeHABBlY-tmQRooWGVl2jZQx1wSTKJtEqG7mMvF2Jqo,4268
+atomicshop/mitm/shared_functions.py,sha256=PaK_sbnEA5zo9k2ktEOKLmvo-6wRUunxzSNRr41uXIQ,1924
 atomicshop/mitm/statistic_analyzer.py,sha256=1g5l6X-NbnHvh_TREJRumTDWgE4ixUNJ8pKGneKcf4Y,23524
 atomicshop/mitm/engines/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/mitm/engines/create_module_template.py,sha256=tRjVSm1sD6FzML71Qbuwvita0qsusdFGm8NZLsZ-XMs,4853
@@ -143,7 +143,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=H5NaHHDkr97QYhUrHFO9vY218u8k3N3Zgh6bQRnicUE,13140
 atomicshop/wrappers/ffmpegw.py,sha256=wcq0ZnAe0yajBOuTKZCCaKI7CDBjkq7FAgdW5IsKcVE,6031
-atomicshop/wrappers/githubw.py,sha256=AjD0VUlV2Kcddns2OaGmyX-FOAvdps-8SPSWS05E0QA,4809
+atomicshop/wrappers/githubw.py,sha256=mQGtj6up1HIvjOD2t0bmOWjLooJLYvuIa7d7H-tknrw,9998
 atomicshop/wrappers/numpyw.py,sha256=sBV4gSKyr23kXTalqAb1oqttzE_2XxBooCui66jbAqc,1025
 atomicshop/wrappers/process_wrapper_pbtk.py,sha256=ycPmBRnv627RWks6N8OhxJQe8Gu3h3Vwj-4HswPOw0k,599
 atomicshop/wrappers/pyopensslw.py,sha256=OBWxA6EJ2vU_Qlf4M8m6ilcG3hyYB4yB0EsXUf7NhEU,6804
@@ -156,10 +156,10 @@ atomicshop/wrappers/dockerw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMp
 atomicshop/wrappers/dockerw/dockerw.py,sha256=w8zSJr5C7cbvbuG09ORCpAe0BOcibqqL_Z2EKEBHYK4,6266
 atomicshop/wrappers/dockerw/install_docker.py,sha256=eF0raR1EO9Xk1MVH7CvtkFI2Fgu9zL12MIYV_1vPTQk,4799
 atomicshop/wrappers/elasticsearchw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atomicshop/wrappers/elasticsearchw/config_basic.py,sha256=XJMKKfDrUq9ZKxYnQ-xFJxSA51z31Nn4eB8_n_hryVk,800
+atomicshop/wrappers/elasticsearchw/config_basic.py,sha256=q9Ybr8TTeNPy6FxtiYCln8WNuwOQjdPazTRoGl7Lk8w,1066
 atomicshop/wrappers/elasticsearchw/elasticsearchw.py,sha256=7TqFdEFznO8NlligJhEKk1vm641ALpCYdaRl1uoXdzM,9768
-atomicshop/wrappers/elasticsearchw/infrastructure.py,sha256=J1hKIEQA8ImRUmkM25fbmwHbZPC9VnT9NK1_kOfXitA,8311
-atomicshop/wrappers/elasticsearchw/install_elastic.py,sha256=EeMZ2zSZIE3bvQ3HHJ4ed2TXLg1ufwKlDon79X5mhIU,8467
+atomicshop/wrappers/elasticsearchw/infrastructure.py,sha256=Sy15gLVe_LAk9WpAoFxu5YApecFlYeJzzJ8lk5NYQEw,9217
+atomicshop/wrappers/elasticsearchw/install_elastic.py,sha256=5CNgIoPIDnTCk5kU7Zcyb48TP4JScvUzeZmhcWt63sI,8754
 atomicshop/wrappers/elasticsearchw/queries/__init__.py,sha256=KBjT-bAt75CJsx1Apko9mpuFU4pfZV8DcGWQvpX65RU,78
 atomicshop/wrappers/elasticsearchw/queries/aggregation.py,sha256=N9a5yMMnb10sMa_x1qJBFQpgyJ49UWo8_vxuqmUtZ1A,1742
 atomicshop/wrappers/elasticsearchw/queries/info.py,sha256=P_VhhBo8MvRI4Shi-bh4RsYtlYNRKRBzScXPC64Up_Q,2900
@@ -177,7 +177,7 @@ atomicshop/wrappers/factw/fact_extractor/docker_image.py,sha256=jJAoJNQ4aoATjn3x
 atomicshop/wrappers/factw/fact_extractor/get_extractor.py,sha256=2mfOAftHIlCcGt1s7MWdq7DsDCuI6wX3MtvcEZ4SK-0,756
 atomicshop/wrappers/factw/install/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/factw/install/install_after_restart.py,sha256=roM1W2hkDynpEKda55xd7AsZxodsFj8i4wmFGt_HHzA,1558
-atomicshop/wrappers/factw/install/pre_install_and_install_before_restart.py,sha256=xPMYgXoyA7y1MHyG5paoqKTWuklhsSGym2ObPcex75M,3036
+atomicshop/wrappers/factw/install/pre_install_and_install_before_restart.py,sha256=fAH53sJgWoXOOhjeAmME2SHYm-5YQAgEi1neaok82Lk,4246
 atomicshop/wrappers/factw/postgresql/__init__.py,sha256=xMBn2d3Exo23IPP2F_9-SXmOlhFbwWDgS9KwozSTjA0,162
 atomicshop/wrappers/factw/postgresql/analysis.py,sha256=2Rxzy2jyq3zEKIo53z8VkjuslKE_i5mq2ZpmJAvyd6U,716
 atomicshop/wrappers/factw/postgresql/file_object.py,sha256=VRiCXnsd6yDbnsE-TEKYPC-gkAgFVkE6rygRrJLQShI,713
@@ -199,7 +199,7 @@ atomicshop/wrappers/loggingw/loggers.py,sha256=DHOOTAtqkwn1xgvLHSkOiBm6yFGNuQy1k
 atomicshop/wrappers/loggingw/loggingw.py,sha256=v9WAseZXB50LluT9rIUcRvvevg2nLVKPgz3dbGejfV0,12151
 atomicshop/wrappers/loggingw/reading.py,sha256=xs7L6Jo-vedrhCVP7m-cJo0VhWmoSoK86avR4Tm0kG4,3675
 atomicshop/wrappers/nodejsw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atomicshop/wrappers/nodejsw/install_nodejs.py,sha256=an7zX_sEG4CF57tdeR3jldDSNnS8Z4vRfSY9y1OjF4g,1440
+atomicshop/wrappers/nodejsw/install_nodejs.py,sha256=VZvefvdeSzoyetCx1y8zg_liX3_GtFtpOpjw7P5iMLk,4956
 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
@@ -232,8 +232,8 @@ atomicshop/wrappers/socketw/socket_server_tester.py,sha256=AhpurHJmP2kgzHaUbq5ey
 atomicshop/wrappers/socketw/socket_wrapper.py,sha256=aXBwlEIJhFT0-c4i8iNlFx2It9VpCEpsv--5Oqcpxao,11624
 atomicshop/wrappers/socketw/ssl_base.py,sha256=k4V3gwkbq10MvOH4btU4onLX2GNOsSfUAdcHmL1rpVE,2274
 atomicshop/wrappers/socketw/statistics_csv.py,sha256=t3dtDEfN47CfYVi0CW6Kc2QHTEeZVyYhc57IYYh5nmA,826
-atomicshop-2.9.33.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
-atomicshop-2.9.33.dist-info/METADATA,sha256=xhGDHuJiZxOFiXby5r0kKvwrMjy6bJN59Vx0ynMYkFU,10423
-atomicshop-2.9.33.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-atomicshop-2.9.33.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
-atomicshop-2.9.33.dist-info/RECORD,,
+atomicshop-2.10.1.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
+atomicshop-2.10.1.dist-info/METADATA,sha256=Bhbu_I_0laKqCOs51DFk4MH4r7BgeHumK5kATL_9cwM,10423
+atomicshop-2.10.1.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+atomicshop-2.10.1.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
+atomicshop-2.10.1.dist-info/RECORD,,