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

atomicshop/a_installs/win/robocorp.py

@@ -32,6 +32,9 @@ def main():
     print_api("PIP Installing Robocorp-Recognition.")
     subprocess.check_call(["pip", "install", "--upgrade", "rpaframework-recognition"])
 
+    print_api("PIP Installing pynput.")
+    subprocess.check_call(["pip", "install", "--upgrade", "pynput"])
+
     print_api("Installing Playwright browsers.")
     subprocess.check_call(["playwright", "install"])
 

atomicshop/a_mains/github_wrapper.py

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

atomicshop/etws/_pywintrace_fix.py

@@ -0,0 +1,17 @@
+"""
+Need to fix the
+etw.etw
+file, in the
+EventConsumer._unpackSimpleType
+function.
+"""
+"""
+data = formatted_data.value
+# Convert the formatted data if necessary
+if isinstance(data, str):
+    if data.endswith(' '):
+        data = data[:-1]
+else:
+    if out_type in tdh.TDH_CONVERTER_LOOKUP and type(data) != tdh.TDH_CONVERTER_LOOKUP[out_type]:
+        data = tdh.TDH_CONVERTER_LOOKUP[out_type](data)
+"""

atomicshop/etws/trace.py

@@ -1,6 +1,7 @@
 import queue
 import sys
 import time
+import multiprocessing.managers
 
 # Import FireEye Event Tracing library.
 import etw
@@ -11,19 +12,16 @@ from ..process_poller import simple_process_pool
 from ..wrappers.psutilw import psutilw
 
 
-WAIT_FOR_PROCESS_POLLER_PID_SECONDS: int = 3
-WAIT_FOR_PROCESS_POLLER_PID_COUNTS: int = WAIT_FOR_PROCESS_POLLER_PID_SECONDS * 10
-
-
 class EventTrace(etw.ETW):
     def __init__(
             self,
             providers: list,
-            event_callback=None,
+            event_callback: callable = None,
             event_id_filters: list = None,
             session_name: str = None,
             close_existing_session_name: bool = True,
-            enable_process_poller: bool = False
+            enable_process_poller: bool = False,
+            process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy = None
     ):
         """
         :param providers: List of tuples with provider name and provider GUID.
@@ -39,6 +37,13 @@ class EventTrace(etw.ETW):
         :param enable_process_poller: Boolean to enable process poller. Gets the process PID, Name and CommandLine.
             Since the DNS events doesn't contain the process name and command line, only PID.
             Then DNS events will be enriched with the process name and command line from the process poller.
+        :param process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy,
+            multiprocessing shared dict proxy that contains current processes.
+            Check the 'atomicshop\process_poller\simple_process_pool.py' SimpleProcessPool class for more information.
+
+            If None, the process poller will create a new shared dict proxy.
+            If provided, then the provided shared dict proxy will be used.
+            Off course valid only if 'enable_process_poller' is True.
 
         ------------------------------------------
 
@@ -62,6 +67,7 @@ class EventTrace(etw.ETW):
         self.event_queue = queue.Queue()
         self.close_existing_session_name: bool = close_existing_session_name
         self.enable_process_poller: bool = enable_process_poller
+        self.process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy = process_pool_shared_dict_proxy
 
         # If no callback function is provided, we will use the default one, which will put the event in the queue.
         if not event_callback:
@@ -75,8 +81,16 @@ class EventTrace(etw.ETW):
         for provider in providers:
             etw_format_providers.append(etw.ProviderInfo(provider[0], etw.GUID(provider[1])))
 
+        self.self_hosted_poller: bool = False
         if self.enable_process_poller:
-            self.process_poller = simple_process_pool.SimpleProcessPool()
+            if not self.process_pool_shared_dict_proxy:
+                self.self_hosted_poller = True
+                self.process_poller = simple_process_pool.SimpleProcessPool()
+                self.multiprocessing_manager: multiprocessing.managers.SyncManager = multiprocessing.Manager()
+                self.process_pool_shared_dict_proxy = self.multiprocessing_manager.dict()
+
+            self.pid_process_converter = simple_process_pool.PidProcessConverter(
+                process_pool_shared_dict_proxy=self.process_pool_shared_dict_proxy)
 
         super().__init__(
             providers=etw_format_providers, event_callback=function_callable, event_id_filters=event_id_filters,
@@ -112,6 +126,9 @@ class EventTrace(etw.ETW):
         if self.enable_process_poller:
             self.process_poller.stop()
 
+            if self.self_hosted_poller:
+                self.multiprocessing_manager.shutdown()
+
     def emit(self):
         """
         The Function will return the next event from the queue.
@@ -143,21 +160,9 @@ class EventTrace(etw.ETW):
         }
 
         if self.enable_process_poller:
-            processes = self.process_poller.get_processes()
-            if event_dict['pid'] not in processes:
-                counter = 0
-                while counter < WAIT_FOR_PROCESS_POLLER_PID_COUNTS:
-                    processes = self.process_poller.get_processes()
-                    if event_dict['pid'] not in processes:
-                        time.sleep(0.1)
-                        counter += 1
-                    else:
-                        break
-
-                if counter == WAIT_FOR_PROCESS_POLLER_PID_COUNTS:
-                    print_api(f"Error: Couldn't get the process name for PID: {event_dict['pid']}.", color='red')
-
-            event_dict = psutilw.cross_single_connection_with_processes(event_dict, processes)
+            process_info: dict = self.pid_process_converter.get_process_by_pid(event_dict['pid'])
+            event_dict['name'] = process_info['name']
+            event_dict['cmdline'] = process_info['cmdline']
 
         return event_dict
 

atomicshop/etws/traces/trace_dns.py

@@ -1,6 +1,8 @@
+import multiprocessing.managers
+
 from .. import trace, const
 from ...basics import dicts
-from ... import dns
+from ... import dns, ip_addresses
 
 
 ETW_DEFAULT_SESSION_NAME: str = 'AtomicShopDnsTrace'
@@ -9,9 +11,6 @@ PROVIDER_NAME: str = const.ETW_DNS['provider_name']
 PROVIDER_GUID: str = const.ETW_DNS['provider_guid']
 REQUEST_RESP_EVENT_ID: int = const.ETW_DNS['event_ids']['dns_request_response']
 
-WAIT_FOR_PROCESS_POLLER_PID_SECONDS: int = 3
-WAIT_FOR_PROCESS_POLLER_PID_COUNTS: int = WAIT_FOR_PROCESS_POLLER_PID_SECONDS * 10
-
 
 class DnsRequestResponseTrace:
     """DnsTrace class use to trace DNS events from Windows Event Tracing for EventId 3008."""
@@ -20,7 +19,8 @@ class DnsRequestResponseTrace:
             attrs: list = None,
             session_name: str = None,
             close_existing_session_name: bool = True,
-            skip_record_list: list = None
+            skip_record_list: list = None,
+            process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy = None
     ):
         """
         :param attrs: List of attributes to return. If None, all attributes will be returned.
@@ -32,6 +32,13 @@ class DnsRequestResponseTrace:
                 created. Instead, the existing session will be used. If there is a buffer from the previous session,
                 you will get the events from the buffer.
         :param skip_record_list: List of DNS Records to skip emitting. Example: ['PTR', 'SRV']
+        :param process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy, multiprocessing shared dict proxy
+            that contains current processes.
+            Check the 'atomicshop\process_poller\simple_process_pool.py' SimpleProcessPool class for more information.
+
+            For this specific class it means that you can run the process poller outside of this class and pass the
+            'process_pool_shared_dict_proxy' to this class. Then you can get the process name and command line for
+            the DNS events from the 'process_pool_shared_dict_proxy' and use it also in other classes.
 
         -------------------------------------------------
 
@@ -53,6 +60,7 @@ class DnsRequestResponseTrace:
         """
 
         self.attrs = attrs
+        self.process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy = process_pool_shared_dict_proxy
 
         if skip_record_list:
             self.skip_record_list: list = skip_record_list
@@ -68,7 +76,8 @@ class DnsRequestResponseTrace:
             event_id_filters=[REQUEST_RESP_EVENT_ID],
             session_name=session_name,
             close_existing_session_name=close_existing_session_name,
-            enable_process_poller=True
+            enable_process_poller=True,
+            process_pool_shared_dict_proxy=self.process_pool_shared_dict_proxy
         )
 
     def start(self):
@@ -90,13 +99,51 @@ class DnsRequestResponseTrace:
         :return: Dictionary with the event data.
         """
 
+        # Get the event from ETW as is.
         event = self.event_trace.emit()
 
+        # Get the raw query results string from the event.
+        query_results: str = event['EventHeader']['QueryResults']
+
+        if query_results != '':
+            query_results_list: list = query_results.split(';')
+
+            addresses_ips: list = list()
+            addresses_cnames: list = list()
+            for query_result in query_results_list:
+                # If there is a type in the query result, it means it is a cname (domain).
+                if 'type' in query_result:
+                    query_result = query_result.split(' ')[-1]
+
+                # But we'll still make sure that the query result is an IP address or not.
+                if ip_addresses.is_ip_address(query_result):
+                    addresses_ips.append(query_result)
+                # If it is not empty, then it is a cname.
+                elif query_result != '':
+                    addresses_cnames.append(query_result)
+        # if the query results are empty, then we'll just set the addresses to empty lists.
+        else:
+            addresses_ips: list = list()
+            addresses_cnames: list = list()
+
+        status_id: str = str(event['EventHeader']['QueryStatus'])
+
+        # Getting the 'QueryStatus' key. If DNS Query Status is '0' then it was executed successfully.
+        # And if not, it means there was an error. The 'QueryStatus' indicate what number of an error it is.
+        if status_id == '0':
+            status = 'Success'
+        else:
+            status = 'Error'
+
         event_dict: dict = {
             'event_id': event['EventId'],
-            'domain': event['EventHeader']['QueryName'],
+            'query': event['EventHeader']['QueryName'],
             'query_type_id': str(event['EventHeader']['QueryType']),
             'query_type': dns.TYPES_DICT[str(event['EventHeader']['QueryType'])],
+            'result_ips': ','.join(addresses_ips),
+            'result_cnames': ','.join(addresses_cnames),
+            'status_id': status_id,
+            'status': status,
             'pid': event['pid'],
             'name': event['name'],
             'cmdline': event['cmdline']
@@ -107,42 +154,6 @@ class DnsRequestResponseTrace:
         if event_dict['query_type'] in self.skip_record_list:
             return self.emit()
 
-        # Defining list if ips and other answers, which aren't IPs.
-        list_of_ips = list()
-        list_of_other_domains = list()
-        # Parse DNS results, only if 'QueryResults' key isn't empty, since many of the events are, mostly due errors.
-        if event['EventHeader']['QueryResults']:
-            # 'QueryResults' key contains a string with all the 'Answers' divided by type and ';' character.
-            # Basically, we can parse each type out of string, but we need only IPs and other answers.
-            list_of_parameters = event['EventHeader']['QueryResults'].split(';')
-
-            # Iterating through all the parameters that we got from 'QueryResults' key.
-            for parameter in list_of_parameters:
-                # If 'type' string is present it means that entry is a domain;
-                if 'type' in parameter:
-                    # Remove the 'type' string and get the domain name.
-                    current_iteration_parameter = parameter.rsplit(' ', maxsplit=1)[1]
-                    # Add the variable to the list of other answers.
-                    list_of_other_domains.append(current_iteration_parameter)
-                # If 'type' string is not present it means that entry is an IP.
-                else:
-                    # Sometimes the last parameter in the 'QueryResults' key after ';' character will be empty, skip it.
-                    if parameter:
-                        list_of_ips.append(parameter)
-
-        event_dict['ips'] = list_of_ips
-        event_dict['other_domains'] = list_of_other_domains
-
-        # Getting the 'QueryStatus' key.
-        event_dict['status_id'] = event['EventHeader']['QueryStatus']
-
-        # Getting the 'QueryStatus' key. If DNS Query Status is '0' then it was executed successfully.
-        # And if not, it means there was an error. The 'QueryStatus' indicate what number of an error it is.
-        if event['EventHeader']['QueryStatus'] == '0':
-            event_dict['status'] = 'Success'
-        else:
-            event_dict['status'] = 'Error'
-
         if self.attrs:
             event_dict = dicts.reorder_keys(
                 event_dict, self.attrs, skip_keys_not_in_list=True)

atomicshop/monitor/checks/dns.py

@@ -25,7 +25,7 @@ class DnsCheck:
 
         self.fetch_engine: trace_dns.DnsRequestResponseTrace = (
             trace_dns.DnsRequestResponseTrace(
-                attrs=['name', 'cmdline', 'domain', 'query_type'],
+                attrs=['name', 'cmdline', 'query', 'query_type'],
                 session_name=self.etw_session_name,
                 close_existing_session_name=True,
                 skip_record_list=self.settings['skip_record_list'],

atomicshop/process_poller/simple_process_pool.py

@@ -1,14 +1,19 @@
 import threading
 from pathlib import Path
 import time
+import multiprocessing.managers
 
 from ..wrappers.pywin32w.win_event_log.subscribes import process_create, process_terminate
-from .. import get_process_list
+from .. import get_process_list, get_process_name_cmd_dll
+from ..print_api import print_api
 
 
 WAIT_BEFORE_PROCESS_TERMINATION_CHECK_SECONDS: float = 3
 WAIT_BEFORE_PROCESS_TERMINATION_CHECK_COUNTS: float = WAIT_BEFORE_PROCESS_TERMINATION_CHECK_SECONDS * 10
 
+WAIT_FOR_PROCESS_POLLER_PID_SECONDS: int = 3
+WAIT_FOR_PROCESS_POLLER_PID_COUNTS: int = WAIT_FOR_PROCESS_POLLER_PID_SECONDS * 10
+
 
 class SimpleProcessPool:
     """
@@ -22,14 +27,48 @@ class SimpleProcessPool:
 
     def __init__(
             self,
-            wait_before_pid_remove_seconds: float = 5
+            wait_before_pid_remove_seconds: float = 5,
+            process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy = None
     ):
         """
         :param wait_before_pid_remove_seconds: float, how many seconds to wait before the process is removed from
             the pool after process termination event is received for that pid.
+        :param process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy, shared dict proxy to update
+            the process pool.
+            If you run a function from other multiprocessing.Process, you can pass the shared_dict_proxy to the function
+            and update the process pool from that function.
+
+            Example:
+            import multiprocessing.managers
+
+            manager: multiprocessing.managers.SyncManager = multiprocessing.Manager()
+            multiprocess_dict_proxy: multiprocessing.managers.DictProxy = manager.dict()
+
+            process_poller = SimpleProcessPool()
+            process_poller.start()
+
+            while True:
+                #============================
+                # your function where you get info with pid
+                # result = {
+                #    'pid': 1234,
+                #    'info': 'some info'
+                # }
+                #============================
+                info_with_process_details = {
+                    'pid': result['pid'],
+                    'info': result['info']
+                    'process_details': shared_dict_proxy[result['pid']]
+                }
+
+                break
+
+            process_poller.stop()
+            manager.shutdown()
         """
 
         self.wait_before_pid_remove_seconds: float = wait_before_pid_remove_seconds
+        self.process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy = process_pool_shared_dict_proxy
 
         self._processes: dict = dict()
         self._running: bool = False
@@ -69,6 +108,11 @@ class SimpleProcessPool:
                 'cmdline': command_line
             }
 
+            # Update the multiprocessing shared dict proxy.
+            if self.process_pool_shared_dict_proxy:
+                self.process_pool_shared_dict_proxy.clear()
+                self.process_pool_shared_dict_proxy.update(self._processes)
+
             # print_api(f'Process [{process_id}] added to the pool.', color='blue')
 
     def _thread_process_termination(self):
@@ -109,3 +153,56 @@ class SimpleProcessPool:
         time.sleep(self.wait_before_pid_remove_seconds)
         _ = self._processes.pop(process_id, None)
         # print_api(f'Process [{process_id}] removed from the pool.', color='yellow')
+
+
+class PidProcessConverter:
+    """
+    This class is used to get the process details by PID from the process pool shared dict proxy.
+    """
+
+    def __init__(
+            self,
+            process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy
+    ):
+        """
+        :param process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy, multiprocessing shared dict proxy.
+        """
+
+        self.process_pool_shared_dict_proxy: multiprocessing.managers.DictProxy = process_pool_shared_dict_proxy
+
+        self.get_process_with_dll_instance = get_process_name_cmd_dll.ProcessNameCmdline(load_dll=True)
+
+    def get_process_by_pid(self, pid: int):
+        """
+        THIS FUNCTION WILL RUN OUTSIDE THE PROCESS POOL PROCESS. Inside the function that needs
+        the pid to process conversion.
+        Get the process details by PID from the process pool shared dict proxy.
+
+        :param pid: int, the process ID.
+        :return: dict, the process details.
+        """
+
+        counter = 0
+        process_dict: dict = dict()
+        while counter < WAIT_FOR_PROCESS_POLLER_PID_COUNTS:
+            if pid not in self.process_pool_shared_dict_proxy:
+                time.sleep(0.1)
+                counter += 1
+            else:
+                process_dict = self.process_pool_shared_dict_proxy[pid]
+                break
+
+        if counter == WAIT_FOR_PROCESS_POLLER_PID_COUNTS and not process_dict:
+            # Last resort, try to get the process name by current process snapshot.
+            processes = self.get_process_with_dll_instance.get_process_details(as_dict=True)
+            if pid not in processes:
+                print_api(f"Error: Couldn't get the process name for PID: {pid}.", color='red')
+                process_dict = {
+                    'name': pid,
+                    'cmdline': ''
+                }
+            else:
+                process_dict = processes[pid]
+
+        return process_dict
+

atomicshop/web.py

@@ -153,6 +153,7 @@ def download(
         file_url: str,
         target_directory: str = None,
         file_name: str = None,
+        headers: dict = None,
         **kwargs
 ) -> str:
     """
@@ -163,6 +164,7 @@ def download(
         If not specified, temporary directory will be used.
     :param file_name: string, file name (example: file.zip) that you want the downloaded file to be saved as.
         If not specified, the default filename from 'file_url' will be used.
+    :param headers: dictionary, HTTP headers to use when downloading the file.
     :return: string, full file path of downloaded file. If download failed, 'None' will be returned.
     """
 
@@ -194,7 +196,10 @@ def download(
     # In order to use 'urllib.request', it is not enough to 'import urllib', you need to 'import urllib.request'.
     # Open the URL for data gathering with SSL context from certifi
     ssl_context = ssl.create_default_context(cafile=certifi.where())
-    file_to_download = urllib.request.urlopen(file_url, context=ssl_context)
+
+    # Build a Request object with headers if provided.
+    req = urllib.request.Request(file_url, headers=headers or {})
+    file_to_download = urllib.request.urlopen(req, context=ssl_context)
 
     # Check status of url.
     if not is_status_ok(status_code=file_to_download.status, **kwargs):
@@ -225,6 +230,7 @@ def download(
             else:
                 print_to_console()
                 break
+
     if aggregated_bytes_int == file_size_bytes_int:
         print_api.print_api(f'Successfully Downloaded to: {file_path}', color="green", **kwargs)
     else:
@@ -236,8 +242,13 @@ def download(
 
 
 def download_and_extract_file(
-        file_url: str, target_directory: str, file_name: str = str(), archive_remove_first_directory: bool = False,
-        **kwargs):
+        file_url: str,
+        target_directory: str,
+        file_name: str = str(),
+        archive_remove_first_directory: bool = False,
+        headers: dict = None,
+        **kwargs
+):
     """
     This function will download the branch file from GitHub, extract the file and remove the file, leaving
     only the extracted folder.
@@ -248,12 +259,13 @@ def download_and_extract_file(
     :param target_directory: string, target directory where to save the file.
     :param archive_remove_first_directory: boolean, sets if archive extract function will extract the archive without
         first directory in the archive. Check reference in the 'extract_archive_with_zipfile' function.
+    :param headers: dictionary, HTTP headers to use when downloading the file.
     :return:
     """
 
     # Download the repo to current working directory and return full file path of downloaded file.
     file_path = download(
-        file_url=file_url, target_directory=target_directory, file_name=file_name, **kwargs)
+        file_url=file_url, target_directory=target_directory, file_name=file_name, headers=headers, **kwargs)
 
     # Extract the archive and remove the first directory.
     zips.extract_archive_with_zipfile(

atomicshop/web_apis/google_llm.py

@@ -33,11 +33,21 @@ class GoogleLLM:
         os.environ["API_KEY"] = llm_api_key
         genai.configure(api_key=os.environ["API_KEY"])
 
-    def get_current_models(self) -> list[str]:
-        """ Function to get the current models available in the Gemini API """
-        result_list: list[str] = []
+    def get_current_models(
+            self,
+            full_info: bool = False
+    ) -> list:
+        """
+        Function to get the current models available in the Gemini API
+
+        :param full_info: bool, if True, returns the full information about the models, otherwise only the names for API usage.
+        """
+        result_list: list = []
         for model in self.genai.list_models():
-            result_list.append(model.name)
+            if full_info:
+                result_list.append(model)
+            else:
+                result_list.append(model.name)
 
         return result_list
 
@@ -57,7 +67,7 @@ class GoogleLLM:
             number_of_characters_per_link: int = 15000,
             temperature: float = 0,
             max_output_tokens: int = 4096,
-            model_name: str = 'gemini-pro'
+            model_name: str = 'gemini-2.0-flash-thinking-exp-01-21'
     ) -> str:
         """
         Function to get the answer to a question by searching Google Custom Console API and processing the content using Gemini API.

atomicshop/wrappers/githubw.py

@@ -3,7 +3,6 @@ import fnmatch
 
 from .. import web, urls
 from ..print_api import print_api
-from ..basics import strings
 
 
 class MoreThanOneReleaseFoundError(Exception):
@@ -14,13 +13,14 @@ class NoReleaseFoundError(Exception):
 
 
 class GitHubWrapper:
-    # You also can use '.tar.gz' as extension.
     def __init__(
             self,
             user_name: str = None,
             repo_name: str = None,
             repo_url: str = None,
             branch: str = 'master',
+            path: str = None,
+            pat: str = None,
             branch_file_extension: str = '.zip'
     ):
         """
@@ -34,7 +34,11 @@ class GitHubWrapper:
             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 path: str, the path to the file/folder inside the repo that we'll do certain actions on.
+             Actions example: get_latest_commit_comment, download_path_from_branch.
+        :param pat: str, the personal access token to the repo.
         :param branch_file_extension: str, the branch file extension. The default is '.zip'.
+            You also can use '.tar.gz' as extension.
 
         ================================================================================================================
         Usage to download the 'master' branch file:
@@ -84,6 +88,8 @@ class GitHubWrapper:
         self.repo_name: str = repo_name
         self.repo_url: str = repo_url
         self.branch: str = branch
+        self.path: str = path
+        self.pat: str = pat
         self.branch_file_extension: str = branch_file_extension
 
         # Default variables.
@@ -94,7 +100,10 @@ class GitHubWrapper:
         # Initialize variables.
         self.branch_download_link: str = str()
         self.branch_downloaded_folder_name: str = str()
+        self.api_url: str = str()
         self.latest_release_json_url: str = str()
+        self.commits_url: str = str()
+        self.contents_url: str = str()
 
         if self.user_name and self.repo_name and not self.repo_url:
             self.build_links_from_user_and_repo()
@@ -102,21 +111,33 @@ class GitHubWrapper:
         if self.repo_url and not self.user_name and not self.repo_name:
             self.build_links_from_repo_url()
 
+    def _get_headers(self) -> dict:
+        """
+        Returns headers for the GitHub API requests. If a personal access token (PAT) is provided, it adds the
+        'Authorization' header.
+        """
+        headers = {}
+        if self.pat:
+            headers['Authorization'] = f'token {self.pat}'
+        return headers
+
     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."
-            print_api(message, color="red", error_type=True, **kwargs)
+            raise ValueError("'user_name' or 'repo_name' is empty.")
 
         self.repo_url = f'https://{self.domain}/{self.user_name}/{self.repo_name}'
         self.branch_download_link = f'{self.repo_url}/{self.archive_directory}/{self.branch_file_name}'
         self.branch_downloaded_folder_name = f'{self.repo_name}-{self.branch}'
-        self.latest_release_json_url: str = \
-            f'https://api.{self.domain}/repos/{self.user_name}/{self.repo_name}/releases/latest'
+
+        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.commits_url: str = f'{self.api_url}/commits'
+        self.contents_url: str = f'{self.api_url}/contents'
 
     def build_links_from_repo_url(self, **kwargs):
         if not self.repo_url:
-            message = "'repo_url' is empty."
-            print_api(message, color="red", error_type=True, **kwargs)
+            raise ValueError("'repo_url' is empty.")
 
         repo_url_parsed = urls.url_parser(self.repo_url)
         self.check_github_domain(repo_url_parsed['netloc'])
@@ -134,25 +155,70 @@ class GitHubWrapper:
             self,
             target_directory: str,
             archive_remove_first_directory: bool = False,
+            download_each_file: bool = False,
             **kwargs
     ):
         """
         This function will download the branch file from GitHub, extract the file and remove the file, leaving
         only the extracted folder.
+        If the 'path' was specified during the initialization of the class, only the path will be downloaded.
 
-        :param target_directory:
-        :param archive_remove_first_directory: boolean, sets if archive extract function will extract the archive
+        :param target_directory: str, the target directory to download the branch/path.
+        :param archive_remove_first_directory: boolean, available only if 'path' was not specified during the initialization
+            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 download_each_file: bool, available only if 'path' was specified during the initialization of the class.
+            Sets if each file will be downloaded separately.
+
+            True: Meaning the directory '/home/user/Downloads/files/' will be created and each file will be downloaded
+                ('file1.txt', 'file2.txt', 'file3.txt') separately to this directory.
+            False: The branch file will be downloaded to temp directory then the provided path
+                will be extracted from there, then the downloaded branch directory will be removed.
         :return:
         """
 
-        # Download the repo to current working directory, extract and remove the archive.
-        web.download_and_extract_file(
-            file_url=self.branch_download_link,
-            target_directory=target_directory,
-            archive_remove_first_directory=archive_remove_first_directory,
-            **kwargs)
+        headers: dict = self._get_headers()
+
+        if not download_each_file:
+            # Download the repo to current working directory, extract and remove the archive.
+            web.download_and_extract_file(
+                file_url=self.branch_download_link,
+                target_directory=target_directory,
+                archive_remove_first_directory=archive_remove_first_directory,
+                headers=headers,
+                **kwargs)
+        else:
+            # Build the URL for the contents API
+            contents_url = f"{self.contents_url}/{self.path}"
+            params = {'ref': self.branch}
+
+            response = requests.get(contents_url, headers=headers, params=params)
+            response.raise_for_status()
+
+            items = response.json()
+
+            # Ensure the target directory exists.
+            os.makedirs(target_directory, exist_ok=True)
+
+            for item in items:
+                item_path = os.path.join(target_directory, item['name'])
+                if item['type'] == 'file':
+                    # Download the file using the provided download URL.
+                    file_url = item['download_url']
+                    # You can reuse your download function here, passing the headers.
+                    download(
+                        file_url=file_url,
+                        target_directory=target_directory,
+                        file_name=item['name'],
+                        headers=headers
+                    )
+                elif item['type'] == 'dir':
+                    # Recursively download subdirectories.
+                    self.download_folder_contents(
+                        folder_path=os.path.join(folder_path, item['name']),
+                        target_directory=item_path
+                    )
 
     def get_latest_release_url(
             self,
@@ -212,10 +278,13 @@ class GitHubWrapper:
         :return:
         """
 
+        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)
 
-        downloaded_file_path = web.download(file_url=found_url, target_directory=target_directory, **kwargs)
+        downloaded_file_path = web.download(
+            file_url=found_url, target_directory=target_directory, headers=headers, **kwargs)
         return downloaded_file_path
 
     def download_and_extract_latest_release(
@@ -238,6 +307,8 @@ class GitHubWrapper:
         :return:
         """
 
+        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)
 
@@ -245,6 +316,7 @@ class GitHubWrapper:
             file_url=found_url,
             target_directory=target_directory,
             archive_remove_first_directory=archive_remove_first_directory,
+            headers=headers,
             **kwargs)
 
     def get_the_latest_release_json(self):
@@ -252,7 +324,10 @@ class GitHubWrapper:
         This function will get the latest releases json.
         :return:
         """
-        response = requests.get(self.latest_release_json_url)
+
+        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):
@@ -261,3 +336,114 @@ class GitHubWrapper:
         :return:
         """
         return self.get_the_latest_release_json()['tag_name']
+
+    def get_latest_commit_comment(self):
+        """
+        This function retrieves the commit message (comment) of the latest commit on the specified branch.
+        It uses the GitHub API endpoint for commits.
+
+        :return: str, the commit message of the latest commit.
+        """
+
+        headers: dict = self._get_headers()
+
+        # Use query parameters to filter commits by branch (sha) and limit results to 1
+        params: dict = {
+            'sha': self.branch,
+            'per_page': 1
+        }
+
+        if self.path:
+            params['path'] = self.path
+
+        response = requests.get(self.commits_url, headers=headers, params=params)
+        response.raise_for_status()  # Raises an HTTPError if the HTTP request returned an unsuccessful status code.
+
+        commits = response.json()
+        if not commits:
+            return None
+
+        commit_message = commits[0].get("commit", {}).get("message", "")
+        return commit_message
+
+
+def parse_github_args():
+    import argparse
+
+    parser = argparse.ArgumentParser(description='GitHub Wrapper')
+    parser.add_argument(
+        '-u', '--repo_url', type=str, required=True,
+        help='The repository url. Example: https://github.com/{user_name}/{repo_name}')
+    parser.add_argument(
+        '-b', '--branch', type=str, required=True,
+        help='The branch name. The specific branch from the repo you want to operate on.')
+    parser.add_argument(
+        '-p', '--path', type=str, default=None,
+        help="The path to the file/folder inside the repo that we'll do certain actions on.\n"
+             "Available actions: get_latest_commit_comment, download_path_from_branch.")
+    parser.add_argument(
+        '-t', '--target_directory', type=str, default=None,
+        help='The target directory to download the file/folder.'
+    )
+    parser.add_argument(
+        '--pat', type=str, default=None,
+        help='The personal access token to the repo.')
+    parser.add_argument(
+        '-glcc', '--get_latest_commit_comment', action='store_true', default=False,
+        help='Sets if the latest commit comment will be printed.')
+    parser.add_argument(
+        '-db', '--download_branch', action='store_true', default=False,
+        help='Sets if the branch will be downloaded. In conjunction with path, only the path will be downloaded.')
+
+    return parser.parse_args()
+
+
+def github_wrapper_main(
+        repo_url: str,
+        branch: str,
+        path: str = None,
+        target_directory: str = None,
+        pat: str = None,
+        get_latest_commit_comment: bool = False,
+        download_branch: bool = False
+):
+    """
+    This function is the main function for the GitHubWrapper class.
+    :param repo_url: str, the repository url.
+        Example: https://github.com/{user_name}/{repo_name}
+    :param branch: str, the branch name. The specific branch from the repo you want to operate on.
+    :param path: str, the path to the file/folder for which the commit message should be retrieved.
+    :param target_directory: str, the target directory to download the file/folder.
+    :param pat: str, the personal access token to the repo.
+    :param get_latest_commit_comment: bool, sets if the latest commit comment will be printed.
+    :param download_branch: bool, sets if the branch will be downloaded. In conjunction with path, only the path will be
+        downloaded.
+    :return:
+    """
+
+    git_wrapper = GitHubWrapper(repo_url=repo_url, branch=branch, path=path, pat=pat)
+
+    if get_latest_commit_comment:
+        commit_comment = git_wrapper.get_latest_commit_comment()
+        print_api(commit_comment)
+        return 0
+
+    if download_branch:
+        git_wrapper.download_and_extract_branch(
+            target_directory=target_directory, download_each_file=True, download_branch_and_extract=False,
+            archive_remove_first_directory=True)
+
+        return 0
+
+
+def github_wrapper_main_with_args():
+    args = parse_github_args()
+
+    return github_wrapper_main(
+        repo_url=args.repo_url,
+        branch=args.branch,
+        path=args.path,
+        target_directory=args.target_directory,
+        pat=args.pat,
+        get_latest_commit_comment=args.get_latest_commit_comment
+    )

atomicshop/wrappers/mongodbw/mongodbw.py

@@ -404,6 +404,33 @@ class MongoDBWrapper:
 
         return count
 
+    def aggregate_entries_in_collection(
+            self,
+            collection_name: str,
+            pipeline: list[dict]
+    ) -> list[dict]:
+        """
+        Aggregate entries in a MongoDB collection by query.
+
+        :param collection_name: str, the name of the collection.
+        :param pipeline: list of dictionaries, the pipeline to search for.
+            Example, search for all entries with column name 'name' equal to 'John':
+                pipeline = [{'$match': {'name': 'John'}}]
+            Example, return all entries from collection:
+                pipeline = []
+
+        :return: list of dictionaries, the list of entries that match the query.
+        """
+
+        self.connect()
+
+        aggregation: list[dict] = aggregate_entries_in_collection(
+            database=self.db, collection_name=collection_name,
+            pipeline=pipeline, mongo_client=self.client, close_client=False)
+
+        return aggregation
+
+
     def get_client(self):
         return self.client
 
@@ -1148,6 +1175,60 @@ def count_entries_in_collection(
     return count
 
 
+def aggregate_entries_in_collection(
+        database: Union[str, pymongo.database.Database],
+        collection_name: str,
+        pipeline: list,
+        mongo_client: pymongo.MongoClient = None,
+        close_client: bool = False
+) -> list:
+    """
+    Perform an aggregation pipeline operation on a MongoDB collection.
+    For example, we count the number of entries with the same 'sha256' value that is provided in a list:
+        pipeline = [
+            {"$match": {"sha256": {"$in": ["hash1", "hash2"]}}},
+            {"$group": {"_id": "$sha256", "count": {"$sum": 1}}}
+        ]
+    And we will get the result:
+        [
+            {"_id": "hash1", "count": 1},
+            {"_id": "hash2", "count": 1}
+        ]
+    Meaning we will get separate counts for each 'sha256' value in the list.
+
+    :param database: String or the database object.
+        str - the name of the database. In this case the database object will be created.
+        pymongo.database.Database - the database object that will be used instead of creating a new one.
+    :param collection_name: str, the name of the collection.
+    :param pipeline: list, the aggregation pipeline to execute.
+        Example:
+            pipeline = [
+                {"$match": {"sha256": {"$in": ["hash1", "hash2"]}}},
+                {"$group": {"_id": "$sha256", "count": {"$sum": 1}}}
+            ]
+    :param mongo_client: pymongo.MongoClient, the connection object.
+        If None, a new connection will be created to default URI.
+    :param close_client: bool, if True, the connection will be closed after the operation.
+
+    :return: list, the results of the aggregation pipeline.
+    """
+    if not mongo_client:
+        mongo_client = connect()
+        close_client = True
+
+    db = _get_pymongo_db_from_string_or_pymongo_db(database, mongo_client)
+    collection = db[collection_name]
+
+    # Perform aggregation
+    results = collection.aggregate(pipeline)
+
+    if close_client:
+        mongo_client.close()
+
+    # Return the results as a list
+    return list(results)
+
+
 def delete_all_entries_from_collection(
         database: Union[str, pymongo.database.Database],
         collection_name: str,

atomicshop/wrappers/pywin32w/win_event_log/subscribes/process_create.py

@@ -69,7 +69,7 @@ def enable_audit_process_creation(print_kwargs: dict = None):
     :param print_kwargs: Optional keyword arguments for the print function.
     """
     if is_audit_process_creation_enabled():
-        print_api("Audit Process Creation is already enabled.", color='yellow', **(print_kwargs or {}))
+        print_api("Audit Process Creation is already enabled.", color='blue', **(print_kwargs or {}))
         return
 
     # Enable "Audit Process Creation" policy
@@ -124,7 +124,7 @@ def enable_command_line_auditing(print_kwargs: dict = None):
 
     if is_command_line_auditing_enabled():
         print_api(
-            "'Include command line in process creation events' is already enabled.", color='yellow',
+            "[Include command line in process creation events] is already enabled.", color='blue',
             **(print_kwargs or {}))
         return
 
@@ -135,11 +135,11 @@ def enable_command_line_auditing(print_kwargs: dict = None):
             winreg.SetValueEx(reg_key, PROCESS_CREATION_INCLUDE_CMDLINE_VALUE, 0, winreg.REG_DWORD, 1)
 
         print_api(
-            "Successfully enabled 'Include command line in process creation events'.",
+            "Successfully enabled [Include command line in process creation events].",
             color='green', **(print_kwargs or {}))
     except WindowsError as e:
         print_api(
-            f"Failed to enable 'Include command line in process creation events': {e}", error_type=True,
+            f"Failed to enable [Include command line in process creation events]: {e}", error_type=True,
             color='red', **(print_kwargs or {}))
 
 

atomicshop/wrappers/pywin32w/win_event_log/subscribes/process_terminate.py

@@ -58,7 +58,7 @@ def enable_audit_process_termination(print_kwargs: dict = None):
     :param print_kwargs: Optional keyword arguments for the print function.
     """
     if is_audit_process_termination_enabled():
-        print_api("Audit Process Termination is already enabled.", color='yellow', **(print_kwargs or {}))
+        print_api("Audit Process Termination is already enabled.", color='blue', **(print_kwargs or {}))
         return
 
     audit_policy_command = [

{atomicshop-2.19.7.dist-info → atomicshop-2.19.9.dist-info}/METADATA

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

{atomicshop-2.19.7.dist-info → atomicshop-2.19.9.dist-info}/RECORD

@@ -1,4 +1,4 @@
-atomicshop/__init__.py,sha256=mP4RKVYs6CFRxy4SuFUKdwycVZS11TlGgfMVUl8GYy4,123
+atomicshop/__init__.py,sha256=miL9aLeTH24dv_rrq3_DNotYp3c4Vv78Z3CWjZQyXrA,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
@@ -45,7 +45,7 @@ atomicshop/urls.py,sha256=aJ0NGS9qqaKeqjkkWBs80jaBBg6MYBiPuLIyPGxscVc,1557
 atomicshop/uuids.py,sha256=JSQdm3ZTJiwPQ1gYe6kU0TKS_7suwVrHc8JZDGYlydM,2214
 atomicshop/venvs.py,sha256=D9lwOoObkYoRx-weuoAmbvN-RdSHhVm4DE9TVl-utAs,903
 atomicshop/virtualization.py,sha256=LPP4vjE0Vr10R6DA4lqhfX_WaNdDGRAZUW0Am6VeGco,494
-atomicshop/web.py,sha256=GLdTXgMxg1_0UQaXC4bOvARVyuFg7SPIeJdsCHV8rNE,11662
+atomicshop/web.py,sha256=No3hExQis7cmMay0GdHULG67RMLd5txg-3a-C7CWMd0,12052
 atomicshop/websocket_parse.py,sha256=aLHWyKqaYqEn_MRBWm2L6rIl6QPmqbVrjEXE_rBzwCw,16711
 atomicshop/a_installs/ubuntu/docker_rootless.py,sha256=9IPNtGZYjfy1_n6ZRt7gWz9KZgR6XCgevjqq02xk-o0,281
 atomicshop/a_installs/ubuntu/docker_sudo.py,sha256=JzayxeyKDtiuT4Icp2L2LyFRbx4wvpyN_bHLfZ-yX5E,281
@@ -57,9 +57,10 @@ atomicshop/a_installs/win/fibratus.py,sha256=TU4e9gdZ_zI73C40uueJ59pD3qmN-UFGdX5
 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=tCUrBHFynAZK81To8vRBvchOwY6BWc4LhBgTxXb0az4,2132
+atomicshop/a_installs/win/robocorp.py,sha256=2E28iaRlAZROoxmXwiXv8rqTjVcdBT2UJ3B8nxrtmkc,2245
 atomicshop/a_installs/win/wsl_ubuntu_lts.py,sha256=dZbPRLNKFeMd6MotjkE6UDY9cOiIaaclIdR1kGYWI50,139
 atomicshop/a_mains/dns_gateway_setting.py,sha256=ncc2rFQCChxlNP59UshwmTonLqC6MWblrVAzbbz-13M,149
+atomicshop/a_mains/github_wrapper.py,sha256=F-PoZknVCxWPN0PTO6l7ZNiaYvo7OVFKFI_zlPt56ps,169
 atomicshop/a_mains/msi_unpacker.py,sha256=5hrkqETYt9HIqR_3PMf32_q06kCrIcsdm_RJV9oY438,188
 atomicshop/a_mains/search_for_hyperlinks_in_docx.py,sha256=HkIdo_Sz9nPbbbJf1mwfwFkyI7vkvpH8qiIkuYopN4w,529
 atomicshop/a_mains/FACT/factw_fact_extractor_docker_image_main_sudo.py,sha256=DDKX3Wp2SmzMCEtCIEOUbEKMob2ZQ7VEQGLEf9uYXrs,320
@@ -112,12 +113,13 @@ atomicshop/basics/threads.py,sha256=xvgdDJdmgN0wmmARoZ-H7Kvl1GOcEbvgaeGL4M3Hcx8,
 atomicshop/basics/timeit_template.py,sha256=fYLrk-X_dhdVtnPU22tarrhhvlggeW6FdKCXM8zkX68,405
 atomicshop/basics/tracebacks.py,sha256=pMdnTUTYKdY9SVtMPNBUKL_4uSKulc54NNQjOIHjKxE,506
 atomicshop/etws/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+atomicshop/etws/_pywintrace_fix.py,sha256=nHrtnAb796eOZ6FlCqcsuRh_TSqSPp6JXLN6TBIz-Us,418
 atomicshop/etws/const.py,sha256=v3x_IdCYeSKbCGywiZFOZln80ldpwKW5nuMDuUe51Jg,1257
 atomicshop/etws/providers.py,sha256=CXNx8pYdjtpLIpA66IwrnE64XhY4U5ExnFBMLEb8Uzk,547
 atomicshop/etws/sessions.py,sha256=b_KeiOvgOBJezJokN81TRlrvJiQNJlIWN4Z6UVjuxP0,1335
-atomicshop/etws/trace.py,sha256=QcB_NYP-KPOaafYd6jCFdPPQsBu4jzac4QicJdWJAoE,7359
+atomicshop/etws/trace.py,sha256=LC5b_WGwk5LTVggnQ55F4Iklis7B7hVFWusOt1jEHnI,8068
 atomicshop/etws/traces/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atomicshop/etws/traces/trace_dns.py,sha256=WvOZm7KNdP4r6ofkZhUGi9WjtYlkV3mUp_yxita3Qg4,6399
+atomicshop/etws/traces/trace_dns.py,sha256=0a8zoq59NyJqy6Z6lf1qkvxrHcrCSnyYEAfLfBdJIuI,6880
 atomicshop/etws/traces/trace_sysmon_process_creation.py,sha256=OM-bkK38uYMwWLZKNOTDa0Xdk3sO6sqsxoMUIiPvm5g,4656
 atomicshop/file_io/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/file_io/csvs.py,sha256=zv0kKjRT-ZWRi0WpMIUQ_FKyP9Dt0f5Bc98Qsj6ClPU,9495
@@ -155,7 +157,7 @@ atomicshop/mitm/statistic_analyzer_helper/moving_average_helper.py,sha256=UnnY_F
 atomicshop/monitor/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/monitor/change_monitor.py,sha256=K5NlVp99XIDDPnQQMdru4BDmua_DtcDIhVAzkTOvD5s,7673
 atomicshop/monitor/checks/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atomicshop/monitor/checks/dns.py,sha256=GHBQ2GEPaU3hAmK6l2vM2PKTcBNzDDF9ThZixqnl9Qk,7108
+atomicshop/monitor/checks/dns.py,sha256=714NedT1ULW7DFk_LM5S4VXYALurKybWXKhVOiEzZjs,7107
 atomicshop/monitor/checks/file.py,sha256=2tIDSlX2KZNc_9i9ji1tcOqupbFTIOj7cKXLyBEDWMk,3263
 atomicshop/monitor/checks/network.py,sha256=CGZWl4WlQrxayZeVF9JspJXwYA-zWx8ECWTVGSlXc98,3825
 atomicshop/monitor/checks/process_running.py,sha256=x66wd6-l466r8sbRQaIli0yswyGt1dH2DVXkGDL6O0Q,1891
@@ -166,7 +168,7 @@ atomicshop/permissions/ubuntu_permissions.py,sha256=n8z1vcIXDts4zLVue33dtJiTopjg
 atomicshop/permissions/win_permissions.py,sha256=eDQm1jfK9x_hkbLqIJjFTwfqinAWQ0iSr0kW3XrF1BE,1272
 atomicshop/process_poller/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/process_poller/process_pool.py,sha256=4Qs427qd7OcBxu5PMFU5PTmyuxRy0vgj2GLsRt0IoEw,9565
-atomicshop/process_poller/simple_process_pool.py,sha256=zHSxNlY2RTIXdqIyq8pg6kbXrTK7nqrz8iVWvyGWIE8,4505
+atomicshop/process_poller/simple_process_pool.py,sha256=tbeuw30MvNFbore1YooEra1ozZvFR8maKbcGNlBpBKc,8484
 atomicshop/process_poller/tracer_base.py,sha256=IOiHcnmF-MccOSCErixN5mve9RifZ9cPnGVHCIRchrs,1091
 atomicshop/process_poller/pollers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/process_poller/pollers/psutil_pywin32wmi_dll.py,sha256=XRRfOIy62iOYU8IKRcyECWiL0rqQ35DeYbPsv_SHDVM,4510
@@ -181,7 +183,7 @@ atomicshop/startup/win/startup_folder.py,sha256=2RZEyF-Mf8eWPlt_-OaoGKKnMs6YhELE
 atomicshop/startup/win/task_scheduler.py,sha256=qALe-8sfthYxsdCViH2r8OsH3x-WauDqteg5RzElPdk,4348
 atomicshop/web_apis/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/web_apis/google_custom_search.py,sha256=R1BnUmBFWZIWkfizSRWoSYoZTdPEjLJ28F_sS2g1jGQ,1558
-atomicshop/web_apis/google_llm.py,sha256=X_sG3leUvskPCPryN6YszDFih_X2Ne0OSMA3UbDMKIg,6741
+atomicshop/web_apis/google_llm.py,sha256=JcWkorK0Fu5C3SkZLSzI0TO4CwDscjFsWu1bDhfGYww,7056
 atomicshop/wrappers/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/_process_wrapper_curl.py,sha256=XkZZXYl7D0Q6UfdWqy-18AvpU0yVp9i2BVD2qRcXlkk,841
 atomicshop/wrappers/_process_wrapper_tar.py,sha256=WUMZFKNrlG4nJP9tWZ51W7BR1j_pIjsjgyAStmWjRGs,655
@@ -189,7 +191,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=LfzTnwvJE03G6WZryOOf43VKhhnyMakzHpn8DPPCoy4,13252
 atomicshop/wrappers/ffmpegw.py,sha256=wcq0ZnAe0yajBOuTKZCCaKI7CDBjkq7FAgdW5IsKcVE,6031
-atomicshop/wrappers/githubw.py,sha256=Ft-QQ4sewzjEWEiW89A_nv9wcKVaQdq76TWvVS6r9mI,12576
+atomicshop/wrappers/githubw.py,sha256=razdRRkO-f00-E0cZs7LE8qoLd-Mm8hLOWlqKR3Ng0U,20343
 atomicshop/wrappers/msiw.py,sha256=GQLqud72nfex3kvO1bJSruNriCYTYX1_G1gSf1MPkIA,6118
 atomicshop/wrappers/numpyw.py,sha256=sBV4gSKyr23kXTalqAb1oqttzE_2XxBooCui66jbAqc,1025
 atomicshop/wrappers/olefilew.py,sha256=biD5m58rogifCYmYhJBrAFb9O_Bn_spLek_9HofLeYE,2051
@@ -266,7 +268,7 @@ atomicshop/wrappers/mongodbw/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NM
 atomicshop/wrappers/mongodbw/install_mongodb_ubuntu.py,sha256=2eEOb35T259lhn5koynfTIm1hanxD02zN97ExGSBM2o,4021
 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=ih3Gd45rg_70y4sGeu0eEJ3sJd9tEN4I5IqHZelRZJw,52854
+atomicshop/wrappers/mongodbw/mongodbw.py,sha256=it1TDnOF64YgDbkkBvUmUb9XGuUg6SwGnHhuqar3aHE,55929
 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
@@ -299,8 +301,8 @@ atomicshop/wrappers/pywin32w/winshell.py,sha256=i2bKiMldPU7_azsD5xGQDdMwjaM7suKJ
 atomicshop/wrappers/pywin32w/win_event_log/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 atomicshop/wrappers/pywin32w/win_event_log/subscribe.py,sha256=FYo2X0Xm3lb3GIdIt_8usoj7JPSDWj0iwsIJ4OwZLQM,8156
 atomicshop/wrappers/pywin32w/win_event_log/subscribes/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-atomicshop/wrappers/pywin32w/win_event_log/subscribes/process_create.py,sha256=1PrPiDiuiVfzfzN5BUuxMfUoCgGW7RGgH6HVrjpTnQc,6064
-atomicshop/wrappers/pywin32w/win_event_log/subscribes/process_terminate.py,sha256=0k09fiAwKDJO404bjxUWSSSLOiNANl-VTJDD_YLq-I8,3763
+atomicshop/wrappers/pywin32w/win_event_log/subscribes/process_create.py,sha256=IuXABBz60iGCLbvYkeTyn8ZzCiBn9OvyfJdO4q5LLnQ,6060
+atomicshop/wrappers/pywin32w/win_event_log/subscribes/process_terminate.py,sha256=OJFWywGGGkBHq1N0MKGtHSFFQMFQSDVU6FXCRIdssg8,3761
 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
@@ -325,8 +327,8 @@ atomicshop/wrappers/socketw/statistics_csv.py,sha256=fgMzDXI0cybwUEqAxprRmY3lqbh
 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=AENV88H1qDidrcpyM9OwEZxX5svfi-Jb4N6FkS1xtqA,8851
-atomicshop-2.19.7.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
-atomicshop-2.19.7.dist-info/METADATA,sha256=eWuLCGUrAwVSQ15odcFHEUvTyhT1m9roQxiCYJk1_t8,10630
-atomicshop-2.19.7.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
-atomicshop-2.19.7.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
-atomicshop-2.19.7.dist-info/RECORD,,
+atomicshop-2.19.9.dist-info/LICENSE.txt,sha256=lLU7EYycfYcK2NR_1gfnhnRC8b8ccOTElACYplgZN88,1094
+atomicshop-2.19.9.dist-info/METADATA,sha256=Q4n9PKQsRSE0ite3_TvSdyFuO7agblLmWIMekjlvmx4,10630
+atomicshop-2.19.9.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+atomicshop-2.19.9.dist-info/top_level.txt,sha256=EgKJB-7xcrAPeqTRF2laD_Np2gNGYkJkd4OyXqpJphA,11
+atomicshop-2.19.9.dist-info/RECORD,,