osbot-utils 1.11.0__py3-none-any.whl → 1.13.0__py3-none-any.whl

osbot_utils/helpers/sqlite/Sqlite__Cursor.py

@@ -84,4 +84,7 @@ class Sqlite__Cursor(Kwargs_To_Self):
         self.execute(sql_query)
         all_rows   = self.cursor().fetchall()
         all_values = [cell.get(cell_name) for cell in all_rows]
-        return all_values
+        return all_values
+
+    def vacuum(self):
+        return self.execute("VACUUM")

osbot_utils/helpers/sqlite/Sqlite__Database.py

@@ -130,8 +130,11 @@ class Sqlite__Database(Kwargs_To_Self):
             table_names.append('sqlite_master')
         return table_names
 
+    def purge_database(self):       # this fells like a better name than vacuum :)
+        return self.vacuum()
 
-
+    def vacuum(self):
+        return self.cursor().vacuum()
 
 
 

osbot_utils/helpers/sqlite/Sqlite__Table.py

@@ -130,6 +130,7 @@ class Sqlite__Table(Kwargs_To_Self):
         rows              = table_sqlite_master.cursor().execute__fetch_all(sql_query, params)
         return table_sqlite_master.list_of_field_name_from_rows(rows, field_name)
 
+
     def new_row_obj(self, row_data=None):
         if self.row_schema:
             new_obj = self.row_schema()
@@ -154,6 +155,7 @@ class Sqlite__Table(Kwargs_To_Self):
                         picked_row_data[field_name] = field_value
                 return picked_row_data
         return row_data
+
     def parse_row(self, row):
         if row and self.auto_pickle_blob:
             fields = self.fields__cached()
@@ -169,6 +171,14 @@ class Sqlite__Table(Kwargs_To_Self):
     def print(self, **kwargs):
         return Print_Table(**kwargs).print(self.rows())
 
+    def row(self, where, fields=None):
+        if fields is None:
+            return self.select_row_where(**where)
+
+        sql_query, params = self.sql_builder(limit=1).query_select_fields_with_conditions(fields, where)
+        row               = self.cursor().execute__fetch_one(sql_query, params)
+        return self.parse_row(row)
+
     def row_add(self, row_obj=None):
         invalid_reason = self.sql_builder().validate_row_obj(row_obj)
         if invalid_reason:

osbot_utils/helpers/sqlite/domains/Sqlite__DB__Files.py

@@ -1,3 +1,4 @@
+from osbot_utils.decorators.lists.index_by import index_by
 from osbot_utils.decorators.methods.cache_on_self import cache_on_self
 from osbot_utils.helpers.sqlite.domains.Sqlite__DB__Local import Sqlite__DB__Local
 from osbot_utils.helpers.sqlite.tables.Sqlite__Table__Files import Sqlite__Table__Files
@@ -11,12 +12,33 @@ class Sqlite__DB__Files(Sqlite__DB__Local):
     def add_file(self, path, contents=None, metadata=None):
         return self.table_files().add_file(path, contents, metadata)
 
+    def clear_table(self):
+        self.table_files().clear()
+
+    def delete_file(self, path):
+        return self.table_files().delete_file(path)
+
+    def file(self, path, include_contents=False):
+        return self.table_files().file(path, include_contents=include_contents)
+
+    def file_exists(self, path):
+        return self.table_files().file_exists(path)
+
+    def file_names(self):
+        return self.table_files().select_field_values('path')
     @cache_on_self
     def table_files(self):
         return Sqlite__Table__Files(database=self).setup()
 
-    def files(self):
-        return self.table_files().files()
+    @index_by
+    def files(self,include_contents=False):
+        return self.table_files().files(include_contents=include_contents)
+
+    def files__with_content(self):
+        return self.files(include_contents=True)
+
+    def files__by_path(self):
+        return self.files(index_by='path')
 
     def setup(self):
         self.table_files()

osbot_utils/helpers/sqlite/domains/Sqlite__DB__Local.py

@@ -10,7 +10,8 @@ class Sqlite__DB__Local(Sqlite__Database):
     db_name: str
 
     def __init__(self, db_path=None, db_name=None):
-        self.db_name = db_name or random_text('db_local') + '.sqlite'
+        if hasattr(self, 'db_name') is False:
+            self.db_name = db_name or random_text('db_local') + '.sqlite'
         super().__init__(db_path=db_path or self.path_local_db())
 
     def path_db_folder(self):

osbot_utils/helpers/sqlite/tables/Sqlite__Table__Files.py

@@ -1,6 +1,7 @@
 from osbot_utils.base_classes.Kwargs_To_Self import Kwargs_To_Self
 from osbot_utils.helpers.sqlite.Sqlite__Table import Sqlite__Table
-from osbot_utils.utils.Misc import timestamp_utc_now
+from osbot_utils.utils.Misc import timestamp_utc_now, bytes_sha256, str_sha256
+from osbot_utils.utils.Status import status_warning, status_ok
 
 SQLITE__TABLE_NAME__FILES = 'files'
 
@@ -21,10 +22,32 @@ class Sqlite__Table__Files(Sqlite__Table):
         super().__init__(**kwargs)
 
     def add_file(self, path, contents=None, metadata= None):
-        if self.contains(path=path):                                     # don't allow multiple entries for the same file path (until we add versioning support)
-            return None
-        row_data = self.create_node_data(path, contents, metadata)
-        return self.add_row_and_commit(**row_data)
+        if self.contains(path=path):                                                    # don't allow multiple entries for the same file path (until we add versioning support)
+            return status_warning(f"File not added, since file with path '{path}' already exists in the database")
+        if metadata is None:
+            metadata = {}
+        metadata.update(self.create_contents_metadata(contents))
+        row_data    = self.create_node_data(path, contents, metadata)
+        new_row_obj = self.add_row_and_commit(**row_data)
+        return status_ok(message='file added', data= new_row_obj)
+
+    def create_contents_metadata(self, contents):
+        file_size       = len(contents)
+        file_is_binary = type(contents) is bytes
+        if file_is_binary:
+            file_hash  = bytes_sha256(contents)
+        else:
+            file_hash = str_sha256(str(contents))
+        return dict(file_contents=dict(hash      = file_hash      ,
+                                       is_binary = file_is_binary ,
+                                       size      = file_size      ))
+
+    def delete_file(self, path):
+        if self.not_contains(path=path):                                                    # don't allow multiple entries for the same file path (until we add versioning support)
+            return status_warning(f"File not deleted, since file with path '{path}' did not exist in the database")
+
+        self.rows_delete_where(path=path)
+        return status_ok(message='file deleted')
 
     def create_node_data(self, path, contents=None, metadata= None):
         node_data = {'path'    : path     ,
@@ -34,9 +57,27 @@ class Sqlite__Table__Files(Sqlite__Table):
             node_data['timestamp'] = timestamp_utc_now()
         return node_data
 
+    def field_names_without_content(self):                      # todo: refactor to get this directly from the schema
+        return ['id', 'path', 'metadata', 'timestamp']          #       and so that these values are not hard-coded here
+
+    def file(self, path, include_contents=True):
+        if include_contents:
+            fields = ['*']
+        else:
+            fields = self.field_names_without_content()
+        return self.row(where=dict(path=path), fields = fields)
+
+    def file_without_contents(self, path):
+        return self.file(path, include_contents=False)
+
+    def file_exists(self, path):
+        return self.contains(path=path)
 
-    def files(self):
-        return self.rows()
+    def files(self, include_contents=False):
+        if include_contents:
+            return self.rows()
+        fields_names = self.field_names_without_content()
+        return self.rows(fields_names)
 
     def setup(self):
         if self.exists() is False:

osbot_utils/testing/Temp_File.py

@@ -1,11 +1,11 @@
-from osbot_utils.utils.Files import Files, file_delete, folder_delete_all, files_list, file_create, file_name, \
+from osbot_utils.utils.Files import Files, file_delete, folder_delete_all, files_list, file_create, \
     parent_folder, file_exists, file_contents
 from osbot_utils.utils.Misc import random_filename
 
 
 class Temp_File:
-    def __init__(self, contents='...', extension='tmp'):
-        self.tmp_file            = random_filename(extension)
+    def __init__(self, contents='...', extension='tmp',file_name=None, ):
+        self.tmp_file            = file_name or random_filename(extension)
         self.tmp_folder          = None
         self.file_path           = None
         self.original_contents   = contents
@@ -30,7 +30,7 @@ class Temp_File:
         return file_exists(self.file_path)
 
     def file_name(self):
-        return file_name(self.path())
+        return Files.file_name(self.path())
 
     def files_in_folder(self):
         return files_list(self.tmp_folder)

osbot_utils/utils/Env.py

@@ -0,0 +1,76 @@
+# In Misc.py
+import os
+
+from osbot_utils.utils.Files import all_parent_folders
+from osbot_utils.utils.Misc import list_set
+from osbot_utils.utils.Str import strip_quotes
+
+
+def env_value(var_name):
+    return env_vars().get(var_name, None)
+
+def env_vars_list():
+    return list_set(env_vars())
+
+def env_vars(reload_vars=False):
+    """
+    if reload_vars reload data from .env file
+    then return dictionary with current environment variables
+    """
+    if reload_vars:
+        load_dotenv()
+    vars = os.environ
+    data = {}
+    for key in vars:
+        data[key] = vars[key]
+    return data
+
+def env_load_from_file(path, override=False):
+    if os.path.exists(path):
+        with open(path) as f:
+            for line in f:
+                line = line.strip()
+                if not line or line.startswith('#'):                # Strip whitespace and ignore comments
+                    continue
+                key, value = line.split(sep='=', maxsplit=1)        # Split the line into key and value
+                value = strip_quotes(value.strip())                 # Handle case when the value is in quotes
+                if override or key.strip() not in os.environ:       # Set the environment variable
+                    os.environ[key.strip()] = value.strip()
+
+def env_unload_from_file(path):
+    if os.path.exists(path):
+        with open(path) as f:
+            for line in f:
+                line = line.strip()
+                if not line or line.startswith('#'):  # Strip whitespace and ignore comments
+                    continue
+                key, _ = line.split(sep='=', maxsplit=1)  # Split the line into key and value
+                key = key.strip()
+                if key in os.environ:  # Remove the environment variable if it exists
+                    del os.environ[key]
+
+def load_dotenv(dotenv_path=None, override=False):
+    if dotenv_path:                                                 # If a specific dotenv path is provided, load from it
+        env_load_from_file(dotenv_path, override)
+    else:
+        directories = all_parent_folders(include_path=True)         # Define the possible directories to search for the .env file (which is this and all parent folders)
+        for directory in directories:                               # Iterate through the directories and load the .env file if found
+            env_path = os.path.join(directory, '.env')              # Define the path to the .env file
+            if os.path.exists(env_path):                            # If we found one
+                env_load_from_file(env_path, override)              # Process it
+                break                                               # Stop after loading the first .env file                                                     # Stop after loading the first .env file
+
+
+def unload_dotenv(dotenv_path=None):
+    if dotenv_path:                                                 # If a specific dotenv path is provided, unload from it
+        env_unload_from_file(dotenv_path)
+    else:
+        directories = all_parent_folders(include_path=True)         # Define the possible directories to search for the .env file (which is this and all parent folders)
+        for directory in directories:                               # Iterate through the directories and unload the .env file if found
+            env_path = os.path.join(directory, '.env')              # Define the path to the .env file
+            if os.path.exists(env_path):                            # If we found one
+                env_unload_from_file(env_path)                      # Process it
+                break                                               # Stop after unloading the first .env file
+
+
+env_load = load_dotenv

osbot_utils/utils/Files.py

@@ -21,7 +21,7 @@ class Files:
     def copy(source:str, destination:str) -> str:
         if file_exists(source):                                     # make sure source file exists
             destination_parent_folder = parent_folder(destination)  # get target parent folder
-            folder_create(destination_parent_folder)                # ensure targer folder exists       # todo: check if this is still needed (we should be using a copy method that creates the required fodlers)
+            folder_create(destination_parent_folder)                # ensure target folder exists       # todo: check if this is still needed (we should be using a copy method that creates the required fodlers)
             return shutil.copy(source, destination)                 # copy file and returns file destination
 
     @staticmethod
@@ -308,7 +308,11 @@ class Files:
     @staticmethod
     def path_combine(path1, path2):
         if type(path1) in [str, Path] and type(path2) in [str, Path]:
-            return abspath(join(str(path1), str(path2)))
+            parent_path = str(path1)
+            sub_path    = str(path2)
+            if sub_path.startswith('/'):
+                sub_path = sub_path[1:]
+            return abspath(join(parent_path,sub_path))
 
     @staticmethod
     def parent_folder(path):
@@ -424,13 +428,53 @@ class Files:
             file.write(contents)
         return path
 
-# todo: refactor the methods above into static methods
+# todo: refactor the methods above into static methods (as bellow)
 
+def all_parent_folders(path=None, include_path=False):
+    if path is None:
+        path = os.getcwd()
+    parent_directories = []
 
+    # Optionally include the starting path
+    if include_path:
+        parent_directories.append(path)
+
+    while True:                                         # Split the path into parts
+        path, tail = os.path.split(path)
+        if tail:
+            parent_directories.append(path)
+        else:
+            if path and path not in parent_directories:  # to handle the root path case
+                parent_directories.append(path)
+            break
+
+    return parent_directories
+def file_move(source_file, target_file):
+    if file_exists(source_file):
+        file_copy(source_file, target_file)
+        if file_exists(target_file):
+            if file_delete(source_file):
+                return True
+    return False
+
+def folders_names_in_folder(target):
+    folders = folders_in_folder(target)
+    return folders_names(folders)
+
+def stream_to_bytes(stream):
+    return stream.read()
+
+def stream_to_file(stream, path=None):
+    if path is None:                        # if path is not defined
+        path = Files.temp_file()            # save it to a temp file
+    with open(path, 'wb') as file:          # Write the content to the file
+        file.write(stream.read())
+    return path
 
 # helper methods
 # todo: all all methods above (including the duplicated mappings at the top)
 
+bytes_to_file                  = Files.write_bytes
 create_folder                  = Files.folder_create
 create_folder_in_parent        = Files.folder_create_in_parent
 create_temp_file               = Files.write
@@ -465,6 +509,7 @@ file_open_gz                   = Files.open_gz
 file_open_bytes                = Files.open_bytes
 file_to_base64                 = Files.file_to_base64
 file_from_base64               = Files.file_from_base64
+file_from_bytes                = Files.write_bytes
 file_save                      = Files.save
 file_sha256                    = Files.contents_sha256
 file_size                      = Files.file_size

osbot_utils/utils/Objects.py

@@ -7,8 +7,6 @@ import pickle
 import types
 from typing import get_origin, Union, get_args
 
-from dotenv import load_dotenv
-
 from osbot_utils.utils.Misc import list_set
 from osbot_utils.utils.Str  import str_unicode_escape, str_max_width
 
@@ -88,24 +86,6 @@ def enum_from_value(enum_type, value):
     except KeyError:
         raise ValueError(f"Value '{value}' is not a valid member of {enum_type.__name__}.")     # Handle the case where the value does not match any Enum member
 
-def env_value(var_name):
-    return env_vars().get(var_name, None)
-
-def env_vars_list():
-    return list_set(env_vars())
-
-def env_vars(reload_vars=False):
-    """
-    if reload_vars reload data from .env file
-    then return dictionary with current environment variables
-    """
-    if reload_vars:
-        load_dotenv()
-    vars = os.environ
-    data = {}
-    for key in vars:
-        data[key] = vars[key]
-    return data
 
 def get_field(target, field, default=None):
     if target is not None:

osbot_utils/utils/Str.py

@@ -3,13 +3,19 @@ from html import escape, unescape
 
 from osbot_utils.utils.Files import safe_file_name
 
+# todo: refactor this this class all str related methods (mainly from the Misc class)
 
-def html_escape(value):
+def html_escape(value: str):
     return escape(value)
 
-def html_unescape(value):
+def html_unescape(value: str):
     return unescape(value)
 
+def strip_quotes(value: str):                           # Remove surrounding quotes (single or double)
+    if (value.startswith("'") and value.endswith("'")) or (value.startswith('"') and value.endswith('"')):
+        return value[1:-1]
+    return value
+
 def str_dedent(value, strip=True):
     result = textwrap.dedent(value)
     if strip:

osbot_utils/utils/Zip.py

@@ -1,11 +1,41 @@
+import gzip
 import io
 import os
 import shutil
+import tarfile
 import zipfile
 from os.path import abspath
 
-from osbot_utils.utils.Files import temp_folder, folder_files, temp_file, is_file
+from osbot_utils.utils.Files import temp_folder, folder_files, temp_file, is_file, file_copy, file_move
+
+
+def gz_tar_bytes_file_list(gz_bytes):
+    gz_buffer_from_bytes = io.BytesIO(gz_bytes)
+    with gzip.GzipFile(fileobj=gz_buffer_from_bytes, mode='rb') as gz:
+        decompressed_data = gz.read()
+        tar_buffer_from_bytes = io.BytesIO(decompressed_data)                       # Assuming the decompressed data is a tag file, process it
+        with tarfile.open(fileobj=tar_buffer_from_bytes, mode='r:') as tar:
+            return sorted(tar.getnames())
+
+def gz_tar_bytes_get_file(gz_bytes, tar_file_path):
+    gz_buffer_from_bytes = io.BytesIO(gz_bytes)
+    with gzip.GzipFile(fileobj=gz_buffer_from_bytes, mode='rb') as gz:
+        decompressed_data = gz.read()
+        tar_buffer_from_bytes = io.BytesIO(decompressed_data)
+        with tarfile.open(fileobj=tar_buffer_from_bytes, mode='r:') as tar:
+            extracted_file = tar.extractfile(tar_file_path)
+            if extracted_file:
+                return extracted_file.read()
+            else:
+                raise FileNotFoundError(f"The file {tar_file_path} was not found in the tar archive.")
 
+def gz_zip_bytes_file_list(gz_bytes):
+    gz_buffer_from_bytes = io.BytesIO(gz_bytes)
+    with gzip.GzipFile(fileobj=gz_buffer_from_bytes, mode='rb') as gz:
+        decompressed_data = gz.read()
+        zip_buffer_from_bytes = io.BytesIO(decompressed_data)                   # Assuming the decompressed data is a zip file, process it
+        with zipfile.ZipFile(zip_buffer_from_bytes, 'r') as zf:
+            return sorted(zf.namelist())
 
 def unzip_file(zip_file, target_folder=None, format='zip'):
     target_folder = target_folder or temp_folder()
@@ -28,6 +58,14 @@ def zip_bytes_get_file(zip_bytes, zip_file_path):
     with zipfile.ZipFile(zip_buffer, 'r') as zf:
         return zf.read(zip_file_path)
 
+def zip_bytes_extract_to_folder(zip_bytes, target_folder=None):
+    target_folder = target_folder or temp_folder()              # Use the provided target folder or create a temporary one
+    zip_buffer = io.BytesIO(zip_bytes)                          # Create a BytesIO buffer from the zip bytes
+    with zipfile.ZipFile(zip_buffer, 'r') as zf:          # Open the zip file from the buffer
+        zf.extractall(target_folder)                            # Extract all files to the target folder
+    return target_folder                                        # Return the path of the target folder
+
+
 def zip_bytes_file_list(zip_bytes):
     zip_buffer_from_bytes = io.BytesIO(zip_bytes)
     with zipfile.ZipFile(zip_buffer_from_bytes, 'r') as zf:
@@ -61,6 +99,11 @@ def zip_files_to_bytes(target_files, root_folder=None):
 def zip_folder(root_dir, format='zip'):
     return shutil.make_archive(base_name=root_dir, format=format, root_dir=root_dir)
 
+def zip_folder_to_file (root_dir, target_file):
+    zip_file = zip_folder(root_dir)
+    return file_move(zip_file, target_file)
+
+
 def zip_folder_to_bytes(root_dir):      # todo add unit test
     zip_buffer = io.BytesIO()                                                   # Create a BytesIO buffer to hold the zipped file
     with zipfile.ZipFile(zip_buffer, 'w', zipfile.ZIP_DEFLATED) as zf:          # Create a ZipFile object with the buffer as the target

osbot_utils/utils/__init__.py

@@ -1,16 +0,0 @@
-"""
-In this class you will find the following helper classes:
-
-- Assert
-- Dev
-- Files
-- Http
-- Json
-- Lists
-- Misc
-- Png
-- Process
-- Temp_File
-- Unzip_File
-- Zip_Folder
-"""

osbot_utils/version

@@ -1 +1 @@
-v1.11.0
+v1.13.0

{osbot_utils-1.11.0.dist-info → osbot_utils-1.13.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: osbot_utils
-Version: 1.11.0
+Version: 1.13.0
 Summary: OWASP Security Bot - Utils
 Home-page: https://github.com/owasp-sbot/OSBot-Utils
 License: MIT
@@ -11,7 +11,6 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
-Requires-Dist: python-dotenv
 Project-URL: Repository, https://github.com/owasp-sbot/OSBot-Utils
 Description-Content-Type: text/markdown
 
@@ -19,14 +18,14 @@ Description-Content-Type: text/markdown
 
 Powerful Python util methods and classes that simplify common apis and tasks.
 
-![Current Release](https://img.shields.io/badge/release-v1.11.0-blue)
+![Current Release](https://img.shields.io/badge/release-v1.13.0-blue)
 [![codecov](https://codecov.io/gh/owasp-sbot/OSBot-Utils/graph/badge.svg?token=GNVW0COX1N)](https://codecov.io/gh/owasp-sbot/OSBot-Utils)
 
 
 
 ## Install - Release 1.x
 
-**for main branch**: add to requirements.txt
+**for main branch**: just get it from pypi
 
 ```
 pip install osbot-utils

{osbot_utils-1.11.0.dist-info → osbot_utils-1.13.0.dist-info}/RECORD

@@ -169,21 +169,21 @@ osbot_utils/helpers/pubsub/schemas/Schema__Event__Message.py,sha256=rt8W-DGitmR-
 osbot_utils/helpers/pubsub/schemas/Schema__PubSub__Client.py,sha256=yOQSn4o1bIsEoyhnQJYen372so89Ben1wMWUO12G4h8,239
 osbot_utils/helpers/pubsub/schemas/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/sqlite/Capture_Sqlite_Error.py,sha256=GSuRYgs1yKQjxMszPoaI7fsfMfuUqhb64AaIysRE6Cs,1747
-osbot_utils/helpers/sqlite/Sqlite__Cursor.py,sha256=0O7xEVNP4rk9GFo95AlL8F--Q3qb5FG2pIWHm5FzqjU,3303
-osbot_utils/helpers/sqlite/Sqlite__Database.py,sha256=wovss-inRP2ioLSyEgnqtJJWmHIp6zGZNeiB9f5t2So,5261
+osbot_utils/helpers/sqlite/Sqlite__Cursor.py,sha256=k5G9Tkk3nx6nHoSanLmpuJG_TceAmN7uRBCt0bo6sIc,3364
+osbot_utils/helpers/sqlite/Sqlite__Database.py,sha256=XcyZ7sqXQeV0dAyERiE3kYFeMubfhKidLbrlrZXLzQI,5432
 osbot_utils/helpers/sqlite/Sqlite__Field.py,sha256=oBWglAOKN0EWVtaRwiQFxmR1FQ61lQ35yKkWXjSiihs,2911
 osbot_utils/helpers/sqlite/Sqlite__Globals.py,sha256=aP6uIy_y4xzl2soTUCFIJRjsb8JyfxfL6qIEZKIWy_4,230
-osbot_utils/helpers/sqlite/Sqlite__Table.py,sha256=LTRCn9X2ciF29HEM9aKMHcZ0ZO4xTP2de9L2PvcUCOA,14805
+osbot_utils/helpers/sqlite/Sqlite__Table.py,sha256=FsFSolFN2N5V8DfZPp4gZL9xmCXaOhmG38wQmgRrvp8,15145
 osbot_utils/helpers/sqlite/Sqlite__Table__Create.py,sha256=3Z6erCsfuVWU9AjeaXsIZQbM-a0_dKrzEOksp1H3ZHo,3825
 osbot_utils/helpers/sqlite/Temp_Sqlite__Database__Disk.py,sha256=-BhK0_3lSJPWDt-QS8IQDfrw2K_drjtn-yXyf9GbER4,520
 osbot_utils/helpers/sqlite/Temp_Sqlite__Table.py,sha256=Na2dOHlYSVUKK7STHwdzBYbQgvW2a6cEhUnlC0-T8wk,729
 osbot_utils/helpers/sqlite/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/sqlite/domains/Sqlite__Cache__Requests.py,sha256=w5HmzkXqikGggS93obZWsqPRp6d2g7Vs74U9WI_u6Vc,10362
 osbot_utils/helpers/sqlite/domains/Sqlite__Cache__Requests__Patch.py,sha256=XiqSPnMUP7VIUBy2QZc_ql-pfG2kueTWNsjqt9pdhoY,2322
-osbot_utils/helpers/sqlite/domains/Sqlite__DB__Files.py,sha256=ofk9e0iUXhoLE8MdYWzmjgcCRhlK_OgEyY2NtBu4iQU,768
+osbot_utils/helpers/sqlite/domains/Sqlite__DB__Files.py,sha256=tirQs4VjnjzGagaT17NigqprMuQiELHm5FwAE5PJT1U,1510
 osbot_utils/helpers/sqlite/domains/Sqlite__DB__Graph.py,sha256=aGykK4Qll5Rn0xJR4RvF5bN6llNEjx-Vst52XTVSNio,1751
 osbot_utils/helpers/sqlite/domains/Sqlite__DB__Json.py,sha256=ILx1wOsmwmvV2yb_fMzLzo18uGNub8cxhBrRfYxCCqA,3808
-osbot_utils/helpers/sqlite/domains/Sqlite__DB__Local.py,sha256=NV0NkwjWwhU7Dq-l_sL1RqsQVxjYtkZJPqH5G96TYFc,882
+osbot_utils/helpers/sqlite/domains/Sqlite__DB__Local.py,sha256=n5kGCVkVC16JBEBfwh8sXmCJMSAtrkAUtSgXggHXVkc,932
 osbot_utils/helpers/sqlite/domains/Sqlite__DB__Requests.py,sha256=8Txl9kX1kHMTEpL-bIjJbzcCfMFb4nHeLrhdIiBtgAc,1541
 osbot_utils/helpers/sqlite/domains/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/sqlite/domains/schemas/Schema__Table__Requests.py,sha256=dewvm_GZhGT5gfX6pVK55wVF_7mtSik2IUHus6bNS6E,443
@@ -197,7 +197,7 @@ osbot_utils/helpers/sqlite/sql_builder/SQL_Builder__Select.py,sha256=_5fszoWTknE
 osbot_utils/helpers/sqlite/sql_builder/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/sqlite/tables/Sqlite__Table__Config.py,sha256=M-h6fYQgmX7Yaq3cSmpePutajLVeVy_IDUrDk97EH6U,2061
 osbot_utils/helpers/sqlite/tables/Sqlite__Table__Edges.py,sha256=YwlWj9GYBDeotqDFdjMOb6MyuHhPZKasndAtuHiLrkQ,1635
-osbot_utils/helpers/sqlite/tables/Sqlite__Table__Files.py,sha256=vtu9g78bw36mfdgeGe2BoGIC-kNStFRcNOWOsjZz6kc,1510
+osbot_utils/helpers/sqlite/tables/Sqlite__Table__Files.py,sha256=ZlhTqroHd9T8vqNwYpRv5cYHw7Fi-F6fxANh_Fr0nt4,3613
 osbot_utils/helpers/sqlite/tables/Sqlite__Table__Nodes.py,sha256=GT8h3wD4hGvEtqQuBs0sBbcu2ydktRHTi95PEL2ffHQ,1721
 osbot_utils/helpers/sqlite/tables/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 osbot_utils/helpers/trace/Trace_Call.py,sha256=xTmR5U2u0vKnIgMSu-4NAibWKIV4-Eql3vACwOr1lkw,6329
@@ -222,7 +222,7 @@ osbot_utils/testing/Patch_Print.py,sha256=RfY4HGIM06dF6JTKibnN1Uco8YL05xPWe1jS4M
 osbot_utils/testing/Profiler.py,sha256=K2KjIQVmrKW1bp6vwm90PO2rzFbjWaAQ_m1kDcUXo4M,3255
 osbot_utils/testing/Stderr.py,sha256=wi1gfjpsxnBK3aOl2jzCTWI-0En1HtPgEin97148_MQ,459
 osbot_utils/testing/Stdout.py,sha256=XQ9OlOW1aHXY1TiNu8O5b75RoDnoaX5RyMHml3OjlKw,459
-osbot_utils/testing/Temp_File.py,sha256=U7lP3ucqqKIADBF3M-4rPiYqT-i7loDn-cWNFsN5_ow,1410
+osbot_utils/testing/Temp_File.py,sha256=gL1BJ6aRNg2o4LeUJ4f3bxKc75iw1qp0WKP9T3rS_WU,1435
 osbot_utils/testing/Temp_Folder.py,sha256=wZQhCi5Cy0dQQAXuu3_jArDz5T94Q_JX68GENU6nTMo,4793
 osbot_utils/testing/Temp_Sys_Path.py,sha256=gOMD-7dQYQlejoDYUqsrmuZQ9DLC07ymPZB3zYuNmG4,256
 osbot_utils/testing/Temp_Web_Server.py,sha256=0A-gZsd0_3wRj2YuBEOWyV2rhT6dcS2BlArngPXGTtk,3186
@@ -235,8 +235,9 @@ osbot_utils/utils/Assert.py,sha256=u9XLgYn91QvNWZGyPi29SjPJSXRHlm9andIn3NJEVog,1
 osbot_utils/utils/Call_Stack.py,sha256=MAq_0vMxnbeLfCe9qQz7GwJYaOuXpt3qtQwN6wiXsU0,6595
 osbot_utils/utils/Csv.py,sha256=oHLVpjRJqrLMz9lubMCNEoThXWju5rNTprcwHc1zq2c,1012
 osbot_utils/utils/Dev.py,sha256=HibpQutYy_iG8gGV8g1GztxNN4l29E4Bi7UZaVL6-L8,1203
+osbot_utils/utils/Env.py,sha256=J_Viw_Lt7a845WUK9u7WD1_YAgtjR31EIG9OEljHrgg,3739
 osbot_utils/utils/Exceptions.py,sha256=KyOUHkXQ_6jDTq04Xm261dbEZuRidtsM4dgzNwSG8-8,389
-osbot_utils/utils/Files.py,sha256=zJ9-B99AkRKcZCd-xiAuqt9YSlNOHogQOciBmOMbwf4,17807
+osbot_utils/utils/Files.py,sha256=HRMdDq1ZctDfCkIfuZGgQ3fG6O03qJEFEIkb8HTYzfU,19407
 osbot_utils/utils/Functions.py,sha256=0E6alPJ0fJpBiJgFOWooCOi265wSRyxxXAJ5CELBnso,3498
 osbot_utils/utils/Http.py,sha256=Z8V149M2HDrKBoXkDD5EXgqTGx6vQoUqXugXK__wcuw,4572
 osbot_utils/utils/Int.py,sha256=oDWQmop18IFfYVa2drz4qA5LxlL8T5Isjjo3fFN_vBw,130
@@ -244,17 +245,17 @@ osbot_utils/utils/Json.py,sha256=AfOXYBxAGzqwaNeHZ-aC-RpurNmHzPxGoym7MMY8UN4,636
 osbot_utils/utils/Json_Cache.py,sha256=mLPkkDZN-3ZVJiDvV1KBJXILtKkTZ4OepzOsDoBPhWg,2006
 osbot_utils/utils/Lists.py,sha256=CLEjgZwAixJAFlubWEKjnUUhUN85oqvR7UqExVW7rdY,5502
 osbot_utils/utils/Misc.py,sha256=R7BMg4XcQ_83PntNP4mNylkpLjoIwMnsswllaDJVbbY,16486
-osbot_utils/utils/Objects.py,sha256=6MBSqQH4XedEyWmHDnf2OizRx38NTsCHUoaWj16V9_Q,13817
+osbot_utils/utils/Objects.py,sha256=bsbuYniXM5ztEEY2xBcZfIpiM1qT5Rlsd0ZSeikx9Uw,13361
 osbot_utils/utils/Png.py,sha256=V1juGp6wkpPigMJ8HcxrPDIP4bSwu51oNkLI8YqP76Y,1172
 osbot_utils/utils/Process.py,sha256=lr3CTiEkN3EiBx3ZmzYmTKlQoPdkgZBRjPulMxG-zdo,2357
 osbot_utils/utils/Python_Logger.py,sha256=z_20FlFdaLoUgJ0cmqXnyA7icgFIpBz8Ej1_xVKWsWM,11245
 osbot_utils/utils/Status.py,sha256=Yq4s0TelXgn0i2QjCP9V8mP30GabXp_UL-jjM6Iwiw4,4305
-osbot_utils/utils/Str.py,sha256=nc7cVdQ3ugcgxqpHIjuuf6WRXCiBLy1oDPLnsk5lVAw,1398
+osbot_utils/utils/Str.py,sha256=gcStFbB57ol74ASIr00pWImpd6ObBr5BLpSB0VUKNTE,1749
 osbot_utils/utils/Version.py,sha256=Ww6ChwTxqp1QAcxOnztkTicShlcx6fbNsWX5xausHrg,422
-osbot_utils/utils/Zip.py,sha256=ogn_vkTD2rJ6Yq1MQ5_9UQnYIscby1bx25cMN4QsnX8,4503
-osbot_utils/utils/__init__.py,sha256=AtewTFWWgEjSqHBn8uP6H9ZgY0U3dMtS-1grgneSKdI,172
-osbot_utils/version,sha256=prx7MCno_OAZwhbe9147hDB8kAgdP_7KZU_T1QeHj_I,8
-osbot_utils-1.11.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
-osbot_utils-1.11.0.dist-info/METADATA,sha256=NnsjD88LY1EU8RNg3Og0kfSUzJL0e4QEX-ctzsRWxns,1097
-osbot_utils-1.11.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
-osbot_utils-1.11.0.dist-info/RECORD,,
+osbot_utils/utils/Zip.py,sha256=YFahdBguVK71mLdYy4m7mqVAQ5al-60QnTmYK-txCfY,6784
+osbot_utils/utils/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+osbot_utils/version,sha256=rUUdM3JyA9c1QRTbuda9dilaTWxvsSHNvG8GnX2tEQw,8
+osbot_utils-1.13.0.dist-info/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
+osbot_utils-1.13.0.dist-info/METADATA,sha256=mnNYG7ohU7BXICZbanuZR2R8oFllk1lm3P_Df3mygt0,1066
+osbot_utils-1.13.0.dist-info/WHEEL,sha256=sP946D7jFCHeNz5Iq4fL4Lu-PrWrFsgfLXbbkciIZwg,88
+osbot_utils-1.13.0.dist-info/RECORD,,