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

atomicshop/archiver/search_in_archive.py

@@ -107,18 +107,27 @@ def _search_in_archive(
 
     # Iterate over each file in the archive.
     for item_index, item in enumerate(file_info_list):
-        if item.filename.endswith('/'):  # Skip directories
-            continue
-
         # At this stage we will get the bytes of the archived file, which is an 'item' in the archive.
         archived_file_bytes = None
         # If the main archive is zip we will use the 'open' method, if it's 7z we will use the 'read' method.
         if archive_type == 'zip':
+            # Skip directories.
+            if item.filename.endswith('/'):
+                continue
+
             with arch_obj.open(item) as file_data:
                 archived_file_bytes = file_data.read()
         elif archive_type == '7z':
+            # Skip directories.
+            if item.is_directory:
+                continue
+
+            # If 'SevenZipFile.red()' is used once, the second time you need to read it you will need to reset the
+            # SevenZipFile object in order to read again:
+            # https://py7zr.readthedocs.io/en/latest/api.html#py7zr.SevenZipFile.read
             file_dict = arch_obj.read([item.filename])
             archived_file_bytes = file_dict[item.filename].read()
+            arch_obj.reset()
 
         # After we get the file bytes we will check if the file matches the callback functions.
         callback_matched = False
@@ -129,7 +138,7 @@ def _search_in_archive(
         if callback_matched:
             _handle_file_extraction(item, extract_file_to_path, archived_file_bytes)
         else:
-            if recursive and (zips.is_zip_zipfile(archived_file_bytes) or sevenzs.is_7z(archived_file_bytes)):
+            if recursive and (zips.is_zip_zipfile(archived_file_bytes) or sevenzs.is_7z_magic_number(archived_file_bytes)):
                 _search_archive_content(
                     archived_file_bytes, file_names, results, found_set, case_sensitive, return_first_only,
                     recursive, callback_functions, extract_file_to_path)
@@ -187,7 +196,7 @@ def _get_archive_type(file_object) -> Union[str, None]:
 
     if zips.is_zip_zipfile(file_object):
         return 'zip'
-    elif sevenzs.is_7z(file_object):
+    elif sevenzs.is_7z_magic_number(file_object):
         return '7z'
     else:
         raise UnknownArchiveType(f"{file_object[:10]} is not a known archive type.")

atomicshop/archiver/sevenzs.py

@@ -4,8 +4,50 @@ from typing import Union
 import py7zr
 
 
-def is_7z(file_object: Union[str, bytes]) -> bool:
+def is_7z_magic_number(
+        file_object: Union[str, bytes]
+) -> bool:
     """
+    Function checks if the file is a 7z file, by checking the magic number.
+
+    :param file_object: can be two types:
+        string, full path to the file.
+        bytes or BytesIO, the bytes of the file.
+    :return: boolean.
+    """
+
+    if isinstance(file_object, str):
+        with open(file_object, 'rb') as file:
+            data = file.read(6)
+    elif isinstance(file_object, bytes):
+        data = file_object
+    else:
+        raise TypeError(f'The file_object must be a string or bytes, not {type(file_object)}')
+
+    # Check if the data is at least 6 bytes long
+    if len(data) < 6:
+        return False
+
+    # 7z file signature (magic number)
+    # The signature is '7z' followed by 'BCAF271C'
+    seven_z_signature = b'7z\xBC\xAF\x27\x1C'
+
+    # Compare the first 6 bytes of the data with the 7z signature
+    result = data.startswith(seven_z_signature)
+
+    return result
+
+
+def _is_7z(file_object: Union[str, bytes]) -> bool:
+    """
+    THIS IS ONLY FOR THE REFERENCE.
+
+    Used to use this function since it raised 'py7zr.Bad7zFile' if the file was not a 7z file.
+    The problem that 'SevenZipFile.testzip()' checks archived files CRCs and returns the first bad file:
+    https://py7zr.readthedocs.io/en/latest/api.html#py7zr.SevenZipFile.testzip
+    The problem is when the file IS 7z file, but there can be other problems with the file, it can raise a RuntimeError.
+    So, better use the 'is_7z_magic_number' function.
+
     Function checks if the file is a 7z file.
     :param file_object: can be two types:
         string, full path to the file.
@@ -29,16 +71,3 @@ def is_7z(file_object: Union[str, bytes]) -> bool:
     except OSError as e:
         if e.args[0] == 22:
             return False
-
-
-def _is_7z_magic_number(data):
-    # Check if the data is at least 6 bytes long
-    if len(data) < 6:
-        return False
-
-    # 7z file signature (magic number)
-    # The signature is '7z' followed by 'BCAF271C'
-    seven_z_signature = b'7z\xBC\xAF\x27\x1C'
-
-    # Compare the first 6 bytes of the data with the 7z signature
-    return data.startswith(seven_z_signature)

atomicshop/filesystem.py

@@ -1280,70 +1280,20 @@ def create_dict_of_paths_list(list_of_paths: list) -> list:
 
 def create_dict_of_path(
         path: str,
-        # structure_dict: dict,
         structure_list: list,
-        add_data_to_entry: any = None,
-        add_data_key: str = 'addon',
-        parent_entry: str = None
+        add_data_to_entry: list[dict[str, any]] = None
 ):
     """
     The function receives a path and a list, and adds the path to the list.
-
     Check the working example from 'create_dict_of_paths_list' function.
 
     :param path: string, path.
     :param structure_list: list to add the path to.
-    :param add_data_to_entry: any, data to add to the entry.
-    :param add_data_key: string, key to add the data to.
-    :param parent_entry: string, for internal use to pass the current parent entry.
+    :param add_data_to_entry: a list of dicts with data to add to the entry.
+        dict format: {key: data}
     :return:
     """
 
-    # # Normalize path for cross-platform compatibility
-    # normalized_path = path.replace("\\", "/")
-    # parts = normalized_path.strip("/").split("/")
-    # current_level = structure_dict
-    #
-    # for part in parts[:-1]:  # Iterate through the directories
-    #     # If the part is not already a key in the current level of the structure, add it
-    #     if part not in current_level:
-    #         current_level[part] = {}
-    #     current_level = current_level[part]
-    #
-    # # Create the entry for the file with additional data
-    # file_entry = {"entry": parts[-1], add_data_key: add_data_to_entry}
-    #
-    # # We're adding file entries under numeric keys.
-    # if isinstance(current_level, dict) and all(isinstance(key, int) for key in current_level.keys()):
-    #     current_level[len(current_level)] = file_entry
-    # else:
-    #     # Handle cases where there's a mix of numeric keys and directory names
-    #     # Find the next available numeric key
-    #     next_key = max([key if isinstance(key, int) else -1 for key in current_level.keys()], default=-1) + 1
-    #     current_level[next_key] = file_entry
-
-    # entries_key_name = "__entries__"
-    #
-    # # Normalize path for cross-platform compatibility
-    # normalized_path = path.replace("\\", "/")
-    # parts = normalized_path.strip("/").split("/")
-    # current_level = structure_dict
-    #
-    # for part in parts[:-1]:  # Navigate through or create directory structure
-    #     if part not in current_level:
-    #         current_level[part] = {}
-    #     current_level = current_level[part]
-    #
-    # # Create the entry for the file with additional data
-    # file_entry = {"entry": parts[-1], add_data_key: add_data_to_entry}
-    #
-    # # If the current level (final directory) does not have an "entries" key for files, create it
-    # if entries_key_name not in current_level:
-    #     current_level[entries_key_name] = []
-    #
-    # # Append the file entry to the list associated with the "entries" key
-    # current_level[entries_key_name].append(file_entry)
-
     # Normalize path for cross-platform compatibility
     normalized_path = path.replace("\\", "/")
     parts = normalized_path.strip("/").split("/")
@@ -1351,29 +1301,36 @@ def create_dict_of_path(
     current_level = structure_list
 
     for i, part in enumerate(parts):
-        # Determine if this is the last part (a file)
+        # Determine if this is the last part (a file or final component of the path)
         is_last_part = (i == len(parts) - 1)
 
         # Try to find an existing entry for this part
-        # noinspection PyTypeChecker
         existing_entry = next((item for item in current_level if item["entry"] == part), None)
 
         if existing_entry is None:
-            # For the last part, add the additional data; for directories, just create the structure
-            if is_last_part:
-                new_entry = {"entry": part, add_data_key: add_data_to_entry, "included": []}
-            else:
-                new_entry = {"entry": part, "included": []}
+            # Create a new entry
+            new_entry = {"entry": part, "included": []}
+
+            # Add additional data if it's the last part
+            if is_last_part and add_data_to_entry:
+                for data_dict in add_data_to_entry:
+                    new_entry.update(data_dict)
 
             current_level.append(new_entry)
+
             # Only update current_level if it's not the last part
             if not is_last_part:
                 current_level = new_entry["included"]
         else:
-            # If it's not the last part and the entry exists, navigate deeper
+            # If the entry exists and it's not the last part, navigate deeper
             if not is_last_part:
                 current_level = existing_entry["included"]
 
+            # If the entry exists and it's the last part, update with additional data
+            if is_last_part and add_data_to_entry:
+                for data_dict in add_data_to_entry:
+                    existing_entry.update(data_dict)
+
 
 def list_open_files_in_directory(directory):
     """

atomicshop/ip_addresses.py

@@ -2,7 +2,12 @@ import ipaddress
 from typing import Union, Literal
 
 
-def is_ip_address(string_value: str, ip_type: Union[Literal['ipv4', 'ipv6'], None] = None) -> bool:
+def is_ip_address(
+        string_value: str,
+        ip_type: Union[
+            Literal['ipv4', 'ipv6'],
+            None] = None
+) -> bool:
     """
     The function checks if the string is an IPv4 or IPv6 address.
 

atomicshop/mitm/connection_thread_worker.py

@@ -1,6 +1,7 @@
 from datetime import datetime
 import threading
 import queue
+import copy
 
 from ..wrappers.socketw import receiver, sender, socket_client, base
 from .. import websocket_parse
@@ -297,7 +298,10 @@ def thread_worker_main(
                 if not isinstance(client_message, ClientMessage):
                     return
 
-                raw_responses: list[bytes] = create_responder_response(client_message)
+                if client_message.action == 'service_connect':
+                    raw_responses: list[bytes] = responder.create_connect_response(client_message)
+                else:
+                    raw_responses: list[bytes] = create_responder_response(client_message)
 
                 is_socket_closed: bool = False
                 for response_raw_bytes in raw_responses:
@@ -383,14 +387,14 @@ def thread_worker_main(
                 # the close on the opposite socket.
                 record_and_statistics_write(client_message)
 
-                # if is_socket_closed:
-                #     exception_or_close_in_receiving_thread = True
-                #     finish_thread()
-                #     return
+                if is_socket_closed:
+                    exception_or_close_in_receiving_thread = True
+                    finish_thread()
+                    return
 
                 # If we're in response mode, execute responder.
                 if config_static.TCPServer.server_response_mode:
-                    responder_queue.put(client_message)
+                    responder_queue.put(copy.deepcopy(client_message))
                 else:
                     # if side == 'Client':
                     #     raise NotImplementedError
@@ -543,7 +547,7 @@ def thread_worker_main(
             client_message_connection.timestamp = datetime.now()
             client_message_connection.action = 'service_connect'
             client_message_connection.info = 'Server Response Mode'
-            responder_queue.put(client_message_connection)
+            responder_queue.put(copy.deepcopy(client_message_connection))
 
         if connection_error:
             client_message_connection.timestamp = datetime.now()
@@ -552,30 +556,32 @@ def thread_worker_main(
             record_and_statistics_write(client_message_connection)
         else:
             client_exception_queue: queue.Queue = queue.Queue()
-            service_exception_queue: queue.Queue = queue.Queue()
-
             client_thread = threading.Thread(
                 target=receive_send_start, args=(client_socket, service_socket_instance, client_exception_queue),
                 name=f"Thread-{thread_id}-Client")
             client_thread.daemon = True
             client_thread.start()
 
-            service_thread = threading.Thread(
-                target=receive_send_start, args=(service_socket_instance, client_socket, service_exception_queue),
-                name=f"Thread-{thread_id}-Service")
-            service_thread.daemon = True
-            service_thread.start()
+            if not config_static.TCPServer.server_response_mode:
+                service_exception_queue: queue.Queue = queue.Queue()
+                service_thread = threading.Thread(
+                    target=receive_send_start, args=(service_socket_instance, client_socket, service_exception_queue),
+                    name=f"Thread-{thread_id}-Service")
+                service_thread.daemon = True
+                service_thread.start()
 
             client_thread.join()
-            service_thread.join()
             if config_static.TCPServer.server_response_mode:
                 responder_thread.join()
+            else:
+                service_thread.join()
 
             # If there was an exception in any of the threads, then we'll raise it here.
             if not client_exception_queue.empty():
                 raise client_exception_queue.get()
-            if not service_exception_queue.empty():
-                raise service_exception_queue.get()
+            if not config_static.TCPServer.server_response_mode:
+                if not service_exception_queue.empty():
+                    raise service_exception_queue.get()
 
         finish_thread()
     except Exception as e:

atomicshop/mitm/engines/__parent/responder___parent.py

@@ -103,8 +103,13 @@ class ResponderParent:
 
         return parameter_value
 
-    def build_byte_response_and_fill_lists(
-            self, http_version: str, status_code: int, headers: dict, body: bytes, client_message: ClientMessage):
+    def build_byte_response(
+            self,
+            http_version: str,
+            status_code: int,
+            headers: dict,
+            body: bytes
+    ) -> bytes:
         """
         Create genuine response from input parameters.
         ---------------
@@ -145,8 +150,7 @@ class ResponderParent:
         :param status_code: HTTP Status Code of Response in HTTP Status line.
         :param headers: HTTP Headers of Response.
         :param body: HTTP body data of Response, bytes.
-        :param client_message: client message class.
-        :return:
+        :return: bytes of the response.
         """
 
         try:
@@ -174,7 +178,6 @@ class ResponderParent:
             print_api(message, error_type=True, logger=self.logger, logger_method='error', color='red')
 
             response_raw_bytes = b''
-            pass
 
         # Parsing the response we created.
         response_parse_test = HTTPResponseParse(response_raw_bytes)
@@ -182,73 +185,15 @@ class ResponderParent:
         if response_parse_test.error:
             self.logger.error(response_parse_test.error)
             response_raw_bytes = b''
-            response_decoded = None
         else:
             self.logger.info("Created Valid Byte Response.")
-            response_decoded = response_parse_test.response_raw_decoded
-
-        # Add 'response_raw_bytes' and 'response_decoded' to appropriate response lists in 'class_message'.
-        self.add_response_elements_to_lists(client_message, response_raw_bytes, response_decoded)
 
-    @staticmethod
-    def add_response_elements_to_lists(class_client_message: ClientMessage, byte_response, decoded_response):
-        """
-        Function just adds the byte response to the 'response_list_of_raw_bytes'.
-        :param class_client_message:
-        :param byte_response:
-        :param decoded_response:
-        :return:
-        """
+        return response_raw_bytes
 
-        class_client_message.response_list_of_raw_bytes.append(byte_response)
-        class_client_message.response_list_of_raw_decoded.append(decoded_response)
+    def create_connect_response(self, class_client_message: ClientMessage):
+        """ This function should be overridden in the child class. """
+        pass
 
     def create_response(self, class_client_message: ClientMessage):
-        # noinspection GrazieInspection
-        """
-        Function to create Response based on ClientMessage and its Request.
-
-        :param class_client_message: contains request and other parameters to help creating response.
-        :return: "class_client_message.response_list_of_raw_bytes" is populated with list of responses in bytes.
-        -----------------------------------
-        # Remember that 'response_list_of_raw_bytes' is a list object that will contain byte response/s.
-
-        # Example of creating 'response_list_of_raw_bytes' using 'build_byte_response' function:
-        class_client_message.response_list_of_raw_bytes.append(
-            self.build_byte_response(
-                http_version=class_client_message.request_raw_decoded.request_version,
-                status_code=200,
-                headers=response_headers,
-                body=b''
-            )
-        )
-
-        # Or you can use the 'add_byte_response_to_response_list' function that will do it for you:
-        byte_response = self.build_byte_response(
-            http_version=class_client_message.request_raw_decoded.request_version,
-            status_code=200,
-            headers=response_headers,
-            body=b''
-        )
-        self.add_byte_response_to_response_list(class_client_message, byte_response)
-        -----------------------------------
-        # Example of extracting variables from URL PATH based on custom PATH TEMPLATE:
-        # (more examples in 'self.extract_variables_from_path_template' function description)
-        template_path: str = "/hithere/<variable1>/else/<variable2>/tested/"
-        path_variables: dict = extract_variables_from_path_template(
-            path=class_client_message.request_raw_decoded.path,
-            template_path=template_path
-        )
-        -----------------------------------
-        # Example of extracting value from URL PATH parameters after question mark:
-        parameter_value = extract_value_from_path_parameter(
-            path=class_client_message.request_raw_decoded.path,
-            parameter='test_id'
-        )
-        """
-
-        byte_response = None
-        decoded_response = None
-        # class_client_message.response_list_of_raw_bytes.append(byte_response)
-        self.add_response_elements_to_lists(class_client_message, byte_response, decoded_response)
-        self.logger.info(f"Response: {class_client_message.response_list_of_raw_bytes}")
+        """ This function should be overridden in the child class. """
+        pass

atomicshop/mitm/engines/__reference_general/responder___reference_general.py

@@ -1,6 +1,7 @@
 # These are specified with hardcoded paths instead of relative, because 'create_module_template.py' copies the content.
 from atomicshop.mitm.engines.__parent.responder___parent import ResponderParent
 from atomicshop.mitm.shared_functions import create_custom_logger
+from atomicshop.mitm.message import ClientMessage
 
 """
 import time
@@ -22,6 +23,63 @@ class ResponderGeneral(ResponderParent):
 
         self.logger = create_custom_logger()
 
+    def create_response(self, class_client_message: ClientMessage):
+        # noinspection GrazieInspection
+        """
+        Function to create Response based on ClientMessage and its Request.
+
+        :param class_client_message: contains request and other parameters to help creating response.
+        :return: list of responses in bytes.
+        -----------------------------------
+
+        # Example of creating list of bytes using 'build_byte_response' function:
+        result_list: list[bytes] = list()
+        result_list.append(
+            self.build_byte_response(
+                http_version=class_client_message.request_raw_decoded.request_version,
+                status_code=200,
+                headers=response_headers,
+                body=b''
+            )
+        )
+
+        return result_list
+        -----------------------------------
+        # Example of extracting variables from URL PATH based on custom PATH TEMPLATE:
+        # (more examples in 'self.extract_variables_from_path_template' function description)
+        template_path: str = "/hithere/<variable1>/else/<variable2>/tested/"
+        path_variables: dict = extract_variables_from_path_template(
+            path=class_client_message.request_raw_decoded.path,
+            template_path=template_path
+        )
+        -----------------------------------
+        # Example of extracting value from URL PATH parameters after question mark:
+        parameter_value = extract_value_from_path_parameter(
+            path=class_client_message.request_raw_decoded.path,
+            parameter='test_id'
+        )
+        """
+
+        # byte_response: bytes = b''
+        # self.logger.info(f"Response: {byte_response}")
+
+        response_bytes_list: list[bytes] = list()
+        # response_bytes_list.append(byte_response)
+        return response_bytes_list
+
+    def create_connect_response(self, class_client_message: ClientMessage):
+        """
+        This is almost the same as 'create_response' function, but it's used only when the client connects and before
+        sending any data.
+        """
+
+        # byte_response: bytes = b''
+        # self.logger.info(f"Response: {byte_response}")
+
+        response_bytes_list: list[bytes] = list()
+        # response_bytes_list.append(byte_response)
+        return response_bytes_list
+
     # ==================================================================================================================
     # Uncomment this section in order to begin building custom responder.
     # @staticmethod
@@ -89,7 +147,7 @@ class ResponderGeneral(ResponderParent):
     #     # === Building Headers. ===========================
     #     # Response Date example: 'Tue, 08 Nov 2022 14:23: 00 GMT'
     #     resp_headers = {
-    #         'Date': self.get_current_formatted_time(),
+    #         'Date': self.get_current_formatted_time_http(),
     #         'Content-Length': str(len(resp_body)),
     #     }
     #
@@ -109,7 +167,7 @@ class ResponderGeneral(ResponderParent):
     #     # === Building Headers. ===========================
     #     # Response Date example: 'Tue, 08 Nov 2022 14:23: 00 GMT'
     #     resp_headers = {
-    #         'Date': self.get_current_formatted_time(),
+    #         'Date': self.get_current_formatted_time_http(),
     #         'Content-Length': str(len(resp_body)),
     #         'Connection': 'keep-alive'
     #     }
@@ -118,10 +176,10 @@ class ResponderGeneral(ResponderParent):
     #
     # def create_response(self, class_client_message: ClientMessage):
     #     # Arranging important request entries to appropriate variables.
-    #     req_path = class_client_message.request_raw_decoded.path
-    #     req_command = class_client_message.request_raw_decoded.command
-    #     req_headers = class_client_message.request_raw_decoded.headers
-    #     req_body = class_client_message.request_raw_decoded.body
+    #     req_path = class_client_message.request_auto_parsed.path
+    #     req_command = class_client_message.request_auto_parsed.command
+    #     req_headers = class_client_message.request_auto_parsed.headers
+    #     req_body = class_client_message.request_auto_parsed.body
     #
     #     # ====================================
     #     # Case specific.
@@ -144,10 +202,12 @@ class ResponderGeneral(ResponderParent):
     #
     #     # ==============================================================================
     #     # === Building byte response. ==================================================
-    #     self.build_byte_response(
-    #         http_version=class_client_message.request_raw_decoded.request_version,
+    #     byte_response = self.build_byte_response(
+    #         http_version=class_client_message.request_auto_parsed.request_version,
     #         status_code=resp_status_code,
     #         headers=resp_headers,
-    #         body=resp_body_bytes,
-    #         client_message=class_client_message
+    #         body=resp_body_bytes
     #     )
+    #
+    #     result_response_list: list[bytes] = [byte_response]
+    #     return result_response_list

atomicshop/process.py

@@ -82,7 +82,18 @@ def execute_with_live_output(
     :return: Boolean, If execution was successful, return True, if not - False.
     """
 
-    cmd = _execution_parameters_processing(cmd, wsl)
+    if isinstance(cmd, str):
+        shell = True
+    elif isinstance(cmd, list):
+        shell = False
+    else:
+        raise TypeError(f'cmd must be a string or list, not {type(cmd)}')
+
+    if wsl:
+        if isinstance(cmd, str):
+            cmd = 'wsl ' + cmd
+        elif isinstance(cmd, list):
+            cmd = ['wsl'] + cmd
 
     # Needed imports:
     # from subprocess import Popen, PIPE, STDOUT
@@ -103,7 +114,7 @@ def execute_with_live_output(
     #   The buffer size is system-dependent and usually chosen by the underlying implementation to optimize performance.
     #   # bufsize=0: This means no buffering.
     #   The I/O is unbuffered, and data is written or read from the stream immediately.
-    with subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, bufsize=1, text=True) as process:
+    with subprocess.Popen(cmd, stdout=subprocess.PIPE, stderr=subprocess.STDOUT, bufsize=1, text=True, shell=shell) as process:
         # We'll count the number of lines from 'process.stdout'.
         counter: int = 0
         # And also get list of all the lines.

atomicshop/wrappers/mongodbw/mongodbw.py

@@ -698,6 +698,10 @@ def find(
 
             Example for searching for a value that starts with 'test':
             filter_query = {'field_name': {'$regex': '^test'}}
+
+            If you need to escape the string for regex special characters you will typically use:
+                re.escape(test)
+            If you're string contains characters like parentheses "()", you will need to escape them.
         $options: The options for the regex search.
             'i': case-insensitive search.
                 Example for case-insensitive search:

atomicshop/wrappers/playwrightw/scenarios.py

@@ -170,10 +170,24 @@ def fetch_urls_content_in_threads(
     return contents
 
 
-def _fetch_content(url, number_of_characters_per_link):
+def fetch_urls_content(
+        urls: list[str],
+        number_of_characters_per_link: int
+) -> list[str]:
+    """ The function to fetch all URLs not concurrently without using threads """
+    contents = []
+
+    for url in urls:
+        data = _fetch_content(url, number_of_characters_per_link)
+        contents.append(data)
+
+    return contents
+
+
+def _fetch_content(url, number_of_characters_per_link, headless: bool = True):
     """ Function to fetch content from a single URL using the synchronous Playwright API """
     with sync_playwright() as p:
-        browser = p.chromium.launch(headless=True)
+        browser = p.chromium.launch(headless=headless)
         page = browser.new_page()
         page.goto(url)
 

atomicshop/wrappers/pywin32w/wmis/win32networkadapter.py

@@ -67,6 +67,8 @@ def get_wmi_network_configuration(
     current_adapter = None
     if use_default_interface:
         default_connection_name_dict: dict = networks.get_default_connection_name()
+        if not default_connection_name_dict:
+            raise NetworkAdapterNotFoundError("Default network adapter not found.")
         # Get the first key from the dictionary.
         connection_name: str = list(default_connection_name_dict.keys())[0]
 

atomicshop/wrappers/winregw/winreg_network.py

@@ -142,6 +142,7 @@ def get_default_dns_gateway() -> tuple[bool, list[str]]:
     Get the default DNS gateway from the Windows registry.
 
     :return: tuple(is dynamic boolean, list of DNS server IPv4s).
+        If nothing found will return (None, None).
     """
 
     def get_current_interface_status(current_interface_settings: dict) -> tuple[bool, list[str]]:
@@ -199,5 +200,8 @@ def get_default_dns_gateway() -> tuple[bool, list[str]]:
 
                 break
 
+    if not function_result:
+        function_result = (None, None)
+
     # noinspection PyTypeChecker
     return function_result

{atomicshop-2.18.6.dist-info → atomicshop-2.18.8.dist-info}/METADATA

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

{atomicshop-2.18.6.dist-info → atomicshop-2.18.8.dist-info}/RECORD

@@ -1,4 +1,4 @@
-atomicshop/__init__.py,sha256=MFXW2AXFnL4Ju9Vx1r8oICO19rBqtQx1mgjqa83ULSM,123
+atomicshop/__init__.py,sha256=4FSjqwMFkYpX_2ecHcCr9_kKJr3wxoGRDCSyZgRd6Dw,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
@@ -14,19 +14,19 @@ atomicshop/dns.py,sha256=5Gimq_WY2arqg7BeGmR7P--fGfnH0Dsh8lrOt_H0jRY,6817
 atomicshop/domains.py,sha256=Rxu6JhhMqFZRcoFs69IoEd1PtYca0lMCG6F1AomP7z4,3197
 atomicshop/emails.py,sha256=I0KyODQpIMEsNRi9YWSOL8EUPBiWyon3HRdIuSj3AEU,1410
 atomicshop/file_types.py,sha256=-0jzQMRlmU1AP9DARjk-HJm1tVE22E6ngP2mRblyEjY,763
-atomicshop/filesystem.py,sha256=C5GaGmpcGTh11Bd2plZxJmJQVMOZNcZf35mqel2PUxo,60314
+atomicshop/filesystem.py,sha256=8Y5xLaTutQtEjWPxIwH_H88laN7plEMp2r4OLHk-3xc,58259
 atomicshop/functions.py,sha256=pK8hoCE9z61PtWCxQJsda7YAphrLH1wxU5x-1QJP-sY,499
 atomicshop/get_process_list.py,sha256=8cxb7gKe9sl4R6H2yMi8J6oe-RkonTvCdKjRFqi-Fs4,6075
 atomicshop/get_process_name_cmd_dll.py,sha256=CtaSp3mgxxJKCCVW8BLx6BJNx4giCklU_T7USiCEwfc,5162
 atomicshop/hashing.py,sha256=Le8qGFyt3_wX-zGTeQShz7L2HL_b6nVv9PnawjglyHo,3474
 atomicshop/http_parse.py,sha256=1Tna9YbOM0rE3t6i_M-klBlwd1KNSA9skA_BqKGXDFc,11861
 atomicshop/inspect_wrapper.py,sha256=sGRVQhrJovNygHTydqJj0hxES-aB2Eg9KbIk3G31apw,11429
-atomicshop/ip_addresses.py,sha256=Hvi4TumEFoTEpKWaq5WNF-YzcRzt24IxmNgv-Mgax1s,1190
+atomicshop/ip_addresses.py,sha256=penRFeJ1-LDVTko4Q0EwK4JiN5cU-KzCBR2VXg9qbUY,1238
 atomicshop/keyboard_press.py,sha256=1W5kRtOB75fulVx-uF2yarBhW0_IzdI1k73AnvXstk0,452
 atomicshop/on_exit.py,sha256=Rpg2SaF0aginuO7JYwA49YJYnS8F6K2jUqhjH65WzuU,6889
 atomicshop/pbtkmultifile_argparse.py,sha256=aEk8nhvoQVu-xyfZosK3ma17CwIgOjzO1erXXdjwtS4,4574
 atomicshop/print_api.py,sha256=q9dAQCASk3pHp_PtYIpr6iZmRcW_lvrV_gPPNwTMRsw,11152
-atomicshop/process.py,sha256=PeLvyixXaCfftdUF3oMbohI1L4MdLtvQVDx2V1Tz_Rk,16662
+atomicshop/process.py,sha256=dmje2YIDPVM8zS38ylAqyOhDBXk6ay_N1xeewKdEIX4,16966
 atomicshop/python_file_patcher.py,sha256=-uhbUX-um5k-If_XXuOfCr8wMzZ3QE6h9N8xGWw6W_o,5486
 atomicshop/python_functions.py,sha256=BPZ3sv5DgQs6Xrl3nIMdPABRpgrau3XSrsnDIz-LEwY,6175
 atomicshop/question_answer_engine.py,sha256=7nM6kGDSFjQNi87b87-kP9lYM0vTjBHn1rEQGNAfdGA,825
@@ -77,9 +77,9 @@ atomicshop/addons/process_list/compiled/Win10x64/process_list.exp,sha256=cbvukIT
 atomicshop/addons/process_list/compiled/Win10x64/process_list.lib,sha256=T2Ncs0MwKlAaCq8UKFMvfQAfcJdDx-nWiHVBfglrLIU,2112
 atomicshop/archiver/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/archiver/_search_in_zip.py,sha256=dd8qFSvIhcKmtnPj_uYNJFPmMwZp4tZys0kKgTw_ACw,8385
-atomicshop/archiver/search_in_archive.py,sha256=tCbYZZ53oJrdjatj8_AYre6AZujuii4wRF42PH9falY,11865
+atomicshop/archiver/search_in_archive.py,sha256=EmWif1EmIy-IpOLgcj-y-Sqrh2M3MtLN94aNQzUhrrQ,12300
 atomicshop/archiver/sevenz_app_w.py,sha256=BWcJb4f7jZEiETDBKyNLE0f5YLFPQx6B91_ObEIXWf8,3007
-atomicshop/archiver/sevenzs.py,sha256=5i_C50-deC1Cz_GQdMGofV2jeMPbbGWAvih-QnA72cg,1370
+atomicshop/archiver/sevenzs.py,sha256=b9rI-nF36ZNawwKsPWOgsnm0p-jYDfD1NYV3eA8LoQ0,2491
 atomicshop/archiver/shutils.py,sha256=BomnK7zT-nQXA1z0i2R2aTv8eu88wPx7tf2HtOdbmEc,1280
 atomicshop/archiver/zips.py,sha256=0Z_1MWs7YRiCBVpyaG8llnzRguHSO4R51KDMN3FJZt8,16984
 atomicshop/basics/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -127,7 +127,7 @@ atomicshop/file_io/xmls.py,sha256=zh3SuK-dNaFq2NDNhx6ivcf4GYCfGM8M10PcEwDSpxk,21
 atomicshop/mitm/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/mitm/config_static.py,sha256=HIzxyMEj7DZksYvJsN5VuKpB-_HSVvuR6U59ztS9gi0,7871
 atomicshop/mitm/config_toml_editor.py,sha256=2p1CMcktWRR_NW-SmyDwylu63ad5e0-w1QPMa8ZLDBw,1635
-atomicshop/mitm/connection_thread_worker.py,sha256=Of-QmuIbUO8Qd1N_BXdGQk2TnPpZd2z-Pxrj0wyq9S8,26758
+atomicshop/mitm/connection_thread_worker.py,sha256=9IWN4LP5ZoYqVJTpoIhaOUiusn6kXUbj7_g4kXOKFIU,27169
 atomicshop/mitm/import_config.py,sha256=0Ij14aISTllTOiWYJpIUMOWobQqGofD6uafui5uWllE,9272
 atomicshop/mitm/initialize_engines.py,sha256=NWz0yBErSrYBn0xWkJDBcHStBJ-kcsv9VtorcSP9x5M,8258
 atomicshop/mitm/message.py,sha256=mNo4Lphr_Jo6IlNX5mPJzABpogWGkjOhwI4meAivwHw,2987
@@ -141,11 +141,11 @@ atomicshop/mitm/engines/create_module_template_example.py,sha256=X5xhvbV6-g9jU_b
 atomicshop/mitm/engines/__parent/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/mitm/engines/__parent/parser___parent.py,sha256=HHaCXhScl3OlPjz6eUxsDpJaZyk6BNuDMc9xCkeo2Ws,661
 atomicshop/mitm/engines/__parent/recorder___parent.py,sha256=exfElkgOU57hupV6opRCeYPHw91GIkIZL6UY3f2OClM,5635
-atomicshop/mitm/engines/__parent/responder___parent.py,sha256=7WQeR3UmMnN74bDwn-0nz2OfhXJ3-ClXpNGUFZ7wJUE,12004
+atomicshop/mitm/engines/__parent/responder___parent.py,sha256=qIxfPiVZs4ZDDFYYeJJAiBWYg0cSfNDC-ibpGYnB2tA,8926
 atomicshop/mitm/engines/__reference_general/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/mitm/engines/__reference_general/parser___reference_general.py,sha256=57MEPZMAjTO6xBDZ-yt6lgGJyqRrP0Do5Gk_cgCiPns,2998
 atomicshop/mitm/engines/__reference_general/recorder___reference_general.py,sha256=El2_YHLoHUCiKfkAmGlXxtFpmSjsUFdsb8I1MvSAFaM,653
-atomicshop/mitm/engines/__reference_general/responder___reference_general.py,sha256=IUyQYMPeEhIARfALWiKPFeXagSQD6lRzAxUdi4ZIT88,7010
+atomicshop/mitm/engines/__reference_general/responder___reference_general.py,sha256=r7WMv59xlVNttz15ppUvQbH2j5eKHAI-yIy1SCCu2lw,9523
 atomicshop/mitm/statistic_analyzer_helper/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/mitm/statistic_analyzer_helper/analyzer_helper.py,sha256=pk6L1t1ea1kvlBoR9QEJptOmaX-mumhwLsP2GCKukbk,5920
 atomicshop/mitm/statistic_analyzer_helper/moving_average_helper.py,sha256=UnnY_FSTiXEfZ8SkDKU2s2qpgPYu1oOT99ghmY-zzas,19992
@@ -262,7 +262,7 @@ atomicshop/wrappers/mongodbw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NM
 atomicshop/wrappers/mongodbw/install_mongodb_ubuntu.py,sha256=pmI9AwWJ2cv5h8GionSpSJkllg6kfp0M381pk6y4Y5U,4015
 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=IkEw86QFyVRU-5p5s6_6yupvSxmaQxr59GKNgSEkAm4,52617
+atomicshop/wrappers/mongodbw/mongodbw.py,sha256=ih3Gd45rg_70y4sGeu0eEJ3sJd9tEN4I5IqHZelRZJw,52854
 atomicshop/wrappers/nodejsw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/nodejsw/install_nodejs.py,sha256=TKGa3jSlSqZTL2NA0nMkWDFtlkz7rxGGn44ywCg7MN8,5228
 atomicshop/wrappers/playwrightw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -275,7 +275,7 @@ atomicshop/wrappers/playwrightw/javascript.py,sha256=_bW7CAtm0Y8IHYrAalg5HpPFnk6
 atomicshop/wrappers/playwrightw/keyboard.py,sha256=zN3YddGO-qUkn6C0CRVFejP4cTuaUwXLDNFhFREjERY,422
 atomicshop/wrappers/playwrightw/locators.py,sha256=6wsLywZxDuii7mwv-zQsRbqQC8r7j96Bma5b5_7ZoVo,2411
 atomicshop/wrappers/playwrightw/mouse.py,sha256=-2FZbQtjgH7tdXWld6ZPGqlKFUdf5in0ujN0hewxa50,656
-atomicshop/wrappers/playwrightw/scenarios.py,sha256=RY56hH7UKvDoBr5j1JwP5xRoQtaz0AnCAkA602MurPk,8396
+atomicshop/wrappers/playwrightw/scenarios.py,sha256=HopJJ-caAHuXxH8kiJHtlcFSI-89Zx7Fc6caGPOHC2A,8786
 atomicshop/wrappers/playwrightw/waits.py,sha256=PBFdz_PoM7Fo7O8hLqMrxNPzBEYgPoXwZceFFCGGeu8,7182
 atomicshop/wrappers/psutilw/cpus.py,sha256=w6LPBMINqS-T_X8vzdYkLS2Wzuve28Ydp_GafTCngrc,236
 atomicshop/wrappers/psutilw/disks.py,sha256=3ZSVoommKH1TWo37j_83frB-NqXF4Nf5q5mBCX8G4jE,9221
@@ -299,7 +299,7 @@ atomicshop/wrappers/pywin32w/win_event_log/subscribes/process_terminate.py,sha25
 atomicshop/wrappers/pywin32w/win_event_log/subscribes/schannel_logging.py,sha256=8nxIcNcbeEuvoBwhujgh7-oIpL9A6J-gg1NM8hOGAVA,3442
 atomicshop/wrappers/pywin32w/wmis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/pywin32w/wmis/helpers.py,sha256=uMXa27UfBpqXInvnmk7CZlqwRI2pg_I_HXelxO9nLLg,5020
-atomicshop/wrappers/pywin32w/wmis/win32networkadapter.py,sha256=9H9MdS__GDBMm8H-xINEPFrJ8j-ErIb1ZqzkulTwLTo,5443
+atomicshop/wrappers/pywin32w/wmis/win32networkadapter.py,sha256=Jzl95viXZExrrlDTGHR0-wiXJo3jQRztmLXkigahFww,5574
 atomicshop/wrappers/pywin32w/wmis/win32process.py,sha256=qMzXtJ5hBZ5ydAyqpDbSx0nO2RJQL95HdmV5SzNKMhk,6826
 atomicshop/wrappers/socketw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/socketw/accepter.py,sha256=hZZKVYlF3LOHQJsSIEKXZUf6QXXWm-AtqXZevvaYigE,1732
@@ -318,9 +318,9 @@ atomicshop/wrappers/socketw/socket_wrapper.py,sha256=WtylpezgIIBuz-A6PfM0hO1sm9E
 atomicshop/wrappers/socketw/ssl_base.py,sha256=kmiif84kMhBr5yjQW17p935sfjR5JKG0LxIwBA4iVvU,2275
 atomicshop/wrappers/socketw/statistics_csv.py,sha256=fgMzDXI0cybwUEqAxprRmY3lqbh30KAV-jOpoFKT-m8,3395
 atomicshop/wrappers/winregw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atomicshop/wrappers/winregw/winreg_network.py,sha256=zZQfps-CdODQaTUADbHAwKHr5RUg7BLafnKWBbKaLN4,8728
-atomicshop-2.18.6.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
-atomicshop-2.18.6.dist-info/METADATA,sha256=sMVjybxEDSWZC48hrJM-Md_y3VH4v5p9UbmQEc1XdOg,10576
-atomicshop-2.18.6.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-atomicshop-2.18.6.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
-atomicshop-2.18.6.dist-info/RECORD,,
+atomicshop/wrappers/winregw/winreg_network.py,sha256=AENV88H1qDidrcpyM9OwEZxX5svfi-Jb4N6FkS1xtqA,8851
+atomicshop-2.18.8.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
+atomicshop-2.18.8.dist-info/METADATA,sha256=37oxDInywUGEbgwoNSHN5Lu2UUt4zTNruStPlhVdfmg,10576
+atomicshop-2.18.8.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+atomicshop-2.18.8.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
+atomicshop-2.18.8.dist-info/RECORD,,