python-backpack 1.0.5__tar.gz → 2.0.0__tar.gz

python_backpack-2.0.0/PKG-INFO

@@ -0,0 +1,12 @@
+Metadata-Version: 2.4
+Name: python-backpack
+Version: 2.0.0
+Summary: A collection of personal scripts for json, File/Folder Operations, String Validation, Custom Errors, Cache and stuff.
+License-File: LICENSE
+Author: Maximiliano Rocamora
+Requires-Python: >=3.11,<4.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/cache.py

@@ -3,17 +3,20 @@
 # Maximiliano Rocamora / maxirocamora@gmail.com
 # https://github.com/MaxRocamora/python-backpack
 # ----------------------------------------------------------------------------------------
+from datetime import datetime, timedelta, timezone
 from functools import lru_cache, wraps
-from datetime import datetime, timedelta
-from datetime import timezone
+from typing import Any, Callable, TypeVar, cast
 
 from backpack.logger import get_logger
 
 log = get_logger('Python Backpack - Cache')
 
+F = TypeVar('F', bound=Callable[..., Any])
+
+
+def timed_lru_cache(seconds: int, maxsize: int = 128) -> Callable[[F], F]:
+    """Lru_cache with expiration time.
 
-def timed_lru_cache(seconds: int, maxsize: int = 128):
-    ''' lru_cache with expiration time
     Args:
         seconds (int): expiration time in seconds
         maxsize (int): maxsize for lru_cache
@@ -34,34 +37,35 @@ def timed_lru_cache(seconds: int, maxsize: int = 128):
         # * to clear the cache, use force_clear=True on the function call
         my_function(force_clear=True)
 
-    '''
-
-    def wrapper_cache(func):
+    """
 
-        func = lru_cache(maxsize=maxsize)(func)
-        func.lifetime = timedelta(seconds=seconds)
-        func.expiration = datetime.now(timezone.utc) + func.lifetime
+    def wrapper_cache(func: F) -> F:
+        cached_func = cast(Any, lru_cache(maxsize=maxsize)(func))
+        cached_func.lifetime = timedelta(seconds=seconds)
+        cached_func.expiration = datetime.now(timezone.utc) + cached_func.lifetime
 
         @wraps(func)
         def wrapped_func(*args, force_clear: bool = False, show_log: bool = False, **kwargs):
-            ''' wrapper function for lru_cache with expiration time
+            """Wrapper function for lru_cache with expiration time.
+
             Args:
+                *args: function arguments
                 force_clear (bool): forces a clear cache
                 show_log (bool): show log on clear
+                **kwargs: function keyword arguments
             Returns:
                 function result
-            '''
-
-            if force_clear or datetime.now(timezone.utc) >= func.expiration:
+            """
 
+            if force_clear or datetime.now(timezone.utc) >= cached_func.expiration:
                 if show_log:
-                    log.debug(f'Cache cleared for {func.__name__}')
+                    log.debug(f'Cache cleared for {cached_func.__name__}')
 
-                func.cache_clear()
-                func.expiration = datetime.now(timezone.utc) + func.lifetime
+                cached_func.cache_clear()
+                cached_func.expiration = datetime.now(timezone.utc) + cached_func.lifetime
 
-            return func(*args, **kwargs)
+            return cached_func(*args, **kwargs)
 
-        return wrapped_func
+        return cast(F, wrapped_func)
 
     return wrapper_cache

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/custom_errors.py

@@ -4,33 +4,34 @@
 # https://github.com/MaxRocamora/python-backpack
 # ----------------------------------------------------------------------------------------
 
-class EnvironmentVariableNotFound(Exception):
 
+class EnvironmentVariableNotFoundError(Exception):
     def __init__(self, var_name: str) -> None:
-        '''Error Raised when a required environment variable is missing from os.
+        """Error Raised when a required environment variable is missing from os.
 
         Args:
             var_name (str): name of the required variable missing
-        '''
+        """
         self.var_name = var_name
         self.message = f'Required Environment Variable [{var_name}] not found.'
         super().__init__(self.message)
 
     def __str__(self):
+        """Return the error message."""
         return self.message
 
 
-class ApplicationNotFound(Exception):
-
+class ApplicationNotFoundError(Exception):
     def __init__(self, app_name: str) -> None:
-        '''Error Raised when an Application Name required is not found.
+        """Error Raised when an Application Name required is not found.
 
         Args:
             app_name (str): name of the required application missing
-        '''
+        """
         self.app_name = app_name
         self.message = f'Application ({app_name}) not found.'
         super().__init__(self.message)
 
     def __str__(self):
+        """Return the error message."""
         return self.message

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/file_utils.py

@@ -12,19 +12,21 @@ log = get_logger('Python Backpack - FileUtils')
 
 
 def replace_strings_in_file(ascii_file: str, strings: list, new_string: str) -> None:
-    ''' Opens ascii file and replaces all occurrences from strings into new_string.
+    """Opens ascii file and replaces all occurrences from strings into new_string.
+
     In this class we use a full path to avoid use of os.dirname, which
     causes string encode problems.
+
     Args:
-        ascii_file (fullpath) file to open
-        strings (list) strings to replace
-        new_string (string) new string or path to set
-    '''
+        ascii_file: (fullpath string) file to open
+        strings: (list) strings to replace
+        new_string: (string) new string or path to set
+    """
 
     # force forward slashes
-    new_string = new_string.replace("\\", "/")
+    new_string = new_string.replace('\\', '/')
 
-    log.info(f"Replacing Strings, Opening File: {ascii_file}")
+    log.info(f'Replacing Strings, Opening File: {ascii_file}')
 
     with open(ascii_file) as f:
         file_data = f.read()
@@ -37,37 +39,43 @@ def replace_strings_in_file(ascii_file: str, strings: list, new_string: str) ->
     with open(ascii_file, 'w') as f:
         f.write(file_data)
         f.close()
-        log.info(f"Closing File: {ascii_file}")
+        log.info(f'Closing File: {ascii_file}')
+
 
+def remove_line_from_file(ascii_file: str, strings: list, verbose: bool = False) -> None:
+    """Removes given lines from ascii file.
 
-def remove_line_from_file(ascii_file: str, strings: str) -> None:
-    ''' removes given lines from ascii file.
     Args:
-        ascii_file (path) ASCII file to process
-        strings (list) match lines to remove
-    '''
+        ascii_file: (string path) ASCII file to process
+        strings: (list) match lines to remove
+        verbose: (bool) if true, prints removed lines
+    """
 
     with open(ascii_file) as f:
         file_content = f.read().splitlines()
 
     for line in file_content:
-        print('file line', line)
+        if verbose:
+            log.info(f'Checking line: {line}')
         with contextlib.suppress(ValueError):
             if line in strings:
+                if verbose:
+                    log.info(f'Removing line: {line}')
                 file_content.pop(file_content.index(line))
 
-    with open(ascii_file, "w") as f:
-        contents = "\n".join(file_content)
+    with open(ascii_file, 'w') as f:
+        contents = '\n'.join(file_content)
         f.write(contents)
 
 
 def file_is_writeable(filepath: str) -> bool:
-    ''' checks if a file is locked and can be overwritten
+    """Checks if a file is locked and can be overwritten.
+
     Args:
-        filepath (str)) file to check
+        filepath: (str) file to check
     Returns:
         bool : true if file is writeable
-    '''
+    """
     try:
         with open(filepath, 'r+') as _:
             return True

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/folder_utils.py

@@ -14,38 +14,39 @@ log = get_logger('Python Backpack - FolderUtils')
 
 
 def browse_folder(folder: str) -> bool:
-    ''' Open windows explorer on folder
+    """Open windows explorer on folder.
+
     Args:
-        folder (path) folder to open
-    '''
+        folder: (string path) folder to open
+    """
     if folder and os.path.isdir(folder):
-        subprocess.Popen(f"explorer {os.path.abspath(folder)}")
+        subprocess.Popen(f'explorer {os.path.abspath(folder)}')
         return True
 
-    log.warning(f"Unable to open folder {folder}")
+    log.warning(f'Unable to open folder {folder}')
     return False
 
 
 def create_folders(folders: list, force_empty: bool = False, verbose: bool = False):
-    ''' Creates multiple folders on disc.
+    """Creates multiple folders on disc.
 
     Args:
         folders (list): folder list
         force_empty (bool, optional): forces clearing folder content. Defaults to False.
         verbose (bool, optional):shows log. Defaults to False.
-    '''
+    """
     for folder in folders:
         create_folder(folder, force_empty=force_empty, verbose=verbose)
 
 
 def create_folder(path: str, force_empty: bool = False, verbose: bool = True):
-    '''creates a folder
+    """Creates a folder.
 
     Args:
         path (str): folder path
         force_empty (bool, optional): forces clearing folder content. Defaults to False.
         verbose (bool, optional): show log. Defaults to True.
-    '''
+    """
     abspath = os.path.abspath(path)
     if verbose:
         log.info(f'Creating Folder {abspath}')
@@ -56,14 +57,14 @@ def create_folder(path: str, force_empty: bool = False, verbose: bool = True):
         elif force_empty:
             remove_files_in_dir(abspath)
     except OSError as e:
-        log.warning(f"Unable to create folder: {path}")
+        log.warning(f'Unable to create folder: {path}')
         log.error(str(e))
 
     return True
 
 
 def remove_files_in_dir(path: str):
-    ''' clears all content in given directory '''
+    """Clears all content in given directory."""
     for root, dirs, files in os.walk(path):
         for f in files:
             os.unlink(os.path.join(root, f))
@@ -72,12 +73,12 @@ def remove_files_in_dir(path: str):
 
 
 def recursive_dir_copy(source_path: str, target_path: str):
-    ''' Copy all files src dir to dest dir, including sub-directories.
+    """Copy all files src dir to dest dir, including sub-directories.
 
     Args:
         source_path (str): source path
         target_path (str): destination path
-    '''
+    """
 
     create_folder(source_path)
     create_folder(target_path)

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/json_metadata.py

@@ -3,62 +3,59 @@
 # Maximiliano Rocamora / maxirocamora@gmail.com
 # https://github.com/MaxRocamora/python-backpack
 # ----------------------------------------------------------------------------------------
-import sys
+import inspect
 import os
+import platform
+import sys
 import time
-import inspect
 from datetime import datetime
-import platform
 from typing import Any
 
 from backpack.json_utils import json_load, json_save
 from backpack.version import version
 
 
-class JsonMetaFile():
-
-    PREFIX = "MD_"
+class JsonMetaFile:
+    PREFIX = 'MD_'
 
     def __init__(self, name: str, path: str) -> None:
-        '''saves/load a class/dict as a json metadata file
+        """saves/load a class/dict as a json metadata file.
 
         Args:
             name (str): name of the file/class
             path (str, optional): filepath. Defaults to None.
-        '''
+        """
         self._name = name
         self._path = path
-        self._data = {
-            "_about": {'package': 'python-backpack', 'version': self.version}
-        }
+        self._data = {'_about': {'package': 'python-backpack', 'version': self.version}}
 
     @property
     def name(self) -> str:
-        ''' name of this metadata class'''
+        """Name of this metadata class."""
         return self._name
 
     @property
     def version(self) -> str:
-        ''' version of this metadata class'''
+        """Version of this metadata class."""
         return version
 
     @property
     def filename(self) -> str:
-        ''' Returns default filename with prefix and extension '''
+        """Returns default filename with prefix and extension."""
         return self.PREFIX + self.name + '.json'
 
     @property
     def filepath(self) -> str:
-        ''' full json metadata filepath '''
+        """Full json metadata filepath."""
         return os.path.join(self.path, self.filename)
 
     @property
     def path(self) -> str:
-        ''' base path location of metadata json file '''
+        """Base path location of metadata json file."""
         return self._path
 
     def has_file(self) -> bool:
-        ''' returns true if file exists '''
+        """Returns true if file exists."""
         return os.path.exists(self.filepath)
 
     # ------------------------------------------------------------------------------------
@@ -66,20 +63,20 @@ class JsonMetaFile():
     # ------------------------------------------------------------------------------------
 
     def load(self) -> None:
-        ''' loads metadata from disk '''
+        """Loads metadata from disk."""
         self._data = json_load(self.filepath) if self.has_file() else {}
 
     def insert(self, key: str, value: Any) -> None:
-        ''' inserts value into metadata '''
+        """Inserts value into metadata."""
         self._data[key] = value
 
     def remove(self, key: str) -> None:
-        ''' remove key from metadata '''
+        """Remove key from metadata."""
         if key in self._data.keys():
             del self._data[key]
 
     def save(self) -> None:
-        ''' Save current metadata into json file. '''
+        """Save current metadata into json file."""
         if not os.path.exists(self.path):
             os.makedirs(self.path)
 
@@ -91,12 +88,12 @@ class JsonMetaFile():
     # ------------------------------------------------------------------------------------
 
     def load_as_class(self) -> type:
-        ''' returns the metadata dict as a class obj '''
-        metadataClass = type(self.name, (), self._data)
-        return metadataClass
+        """Returns the metadata dict as a class obj."""
+        metadata_class = type(self.name, (), self._data)
+        return metadata_class
 
     def insert_class(self, _class: type) -> None:
-        ''' load all attributes from  a  given class into this class metadata '''
+        """Load all attributes from  a  given class into this class metadata."""
         attributes = {}
         for name in dir(_class):
             value = getattr(_class, name)
@@ -110,7 +107,7 @@ class JsonMetaFile():
     # ------------------------------------------------------------------------------------
 
     def _system_data(self) -> dict:
-        ''' add system metadata to the default data before save '''
+        """Add system metadata to the default data before save."""
         return {
             'name': self.name,
             'app': os.path.basename(sys.executable),
@@ -121,15 +118,15 @@ class JsonMetaFile():
         }
 
     def _current_time_metadata(self) -> dict:
-        ''' Get export time info. '''
-        ftime = time.strftime("%Y,%b,%d,%j,%H:%M", time.localtime())
-        times = ftime.split(",")
+        """Get export time info."""
+        ftime = time.strftime('%Y,%b,%d,%j,%H:%M', time.localtime())
+        times = ftime.split(',')
         td = {
-            "year": times[0],
-            "month": times[1],
-            "day": times[2],
-            "year_day": times[3],
-            "time": times[4],
-            'save_time': datetime.now().ctime()
+            'year': times[0],
+            'month': times[1],
+            'day': times[2],
+            'year_day': times[3],
+            'time': times[4],
+            'save_time': datetime.now().ctime(),
         }
         return td

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/json_user_settings.py

@@ -1,29 +1,32 @@
 # ----------------------------------------------------------------------------------------
 # Json Settings Class
 # This class handle load/save json files on win/linux local user folder
-''' Usage:
+
+"""Usage.
+
 us = JsonUserSettings('my_app')
 us.save(someDict)
 data = us.load()
 
-'''
+"""
+
 # ----------------------------------------------------------------------------------------
 import os
 
+from backpack.json_utils import json_load, json_save
 from backpack.logger import get_logger
-from backpack.json_utils import json_save, json_load
 
 log = get_logger('Python Backpack - UserSettings')
 
 
-class JsonUserSettings():
+class JsonUserSettings:
     def __init__(self, folder: str, name: str) -> None:
-        '''Manages saving/loading json file on local user folder
+        """Manages saving/loading json file on local user folder.
 
         Args:
             folder (str): name of sub folder inside user path. Defaults to 'json_settings'.
-            filename (str): name used for the json file. Defaults to 'user_data'.
-        '''
+            name (str): name used for the json file. Defaults to 'user_data'.
+        """
         self.name = name
         self.folder = folder
         self._user_data = {}
@@ -31,18 +34,18 @@ class JsonUserSettings():
 
     @property
     def filepath(self) -> str:
-        ''' Returns user filepath '''
+        """Returns user filepath."""
         path = os.path.join(self.os_user_folder, self.folder, f'{self.name}.json')
         return os.path.abspath(path)
 
     @property
     def os_user_folder(self) -> str:
-        ''' returns os users home directory '''
+        """Returns os users home directory."""
         return os.path.expanduser('~')
 
     @property
     def user_data(self) -> dict:
-        ''' override this property to modify saving dict '''
+        """Override this property to modify saving dict."""
         return self._user_data
 
     @user_data.setter
@@ -50,20 +53,23 @@ class JsonUserSettings():
         self._user_data = v
 
     def _verify_path(self) -> bool:
-        ''' Checks for target directory or make it '''
+        """Checks for target directory or make it."""
         path = os.path.dirname(self.filepath)
         if not os.path.exists(path):
             os.makedirs(path)
 
         return True
 
-    def save_settings(self, data=False) -> bool:
-        ''' Saves a dictionary into a json file (os user path)
+    def save_settings(self, data: dict | None = None) -> bool | None:
+        """Saves a dictionary into a json file (os user path).
+
         Args:
-            data (dictionary) : info dictionary to save, if set to False,
+            data (dictionary): info dictionary to save, if not provided,
                 saves instead local self.user_data property
-        '''
-        if not data:
+        Returns:
+            bool | None: True if file was saved, False if error, None if no data to save.
+        """
+        if data is None:
             data = self.user_data
 
         r = json_save(data, self.filepath)
@@ -71,8 +77,8 @@ class JsonUserSettings():
             log.info('json settings file saved! [%s]', self.filepath)
         return r
 
-    def load_settings(self) -> dict:
-        ''' Load json file from path and returns its contents '''
+    def load_settings(self) -> dict | bool:
+        """Load json file from path and returns its contents."""
         try:
             return json_load(self.filepath)
         except OSError:

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/json_utils.py

@@ -1,5 +1,5 @@
-import os
 import json
+import os
 
 from backpack.logger import get_logger
 
@@ -7,33 +7,37 @@ log = get_logger('Python Backpack - JsonUtils')
 
 
 def json_load(json_file: str) -> dict:
-    ''' Reads a json file
+    """Reads a json file.
+
     Args:
-        json_file (filepath) json file to read data.
+        json_file: (string filepath) json file to read data.
+
     Returns:
         dict (file content)
-    '''
+    """
     if not os.path.exists(json_file):
-        raise OSError(f"json_load: File not found: {json_file}.")
+        raise OSError(f'json_load: File not found: {json_file}.')
 
     with open(json_file) as json_file_opened:
         try:
             value = json.load(json_file_opened)
         except ValueError as e:
             json_file_opened.close()
-            raise OSError(f"{json_file} \n JSON File issue: {str(e)}") from e
+            raise OSError(f'{json_file} \n JSON File issue: {str(e)}') from e
 
     return value
 
 
 def json_save(data: dict, json_file: str) -> bool:
-    ''' Saves a dictionary into a json file
+    """Saves a dictionary into a json file.
+
     Args:
-        data (dict) : dictionary to save
-        json_file (filepath) json file to save data.
+        data: (dict) dictionary to save
+        json_file: (string filepath) json file to save data.
+
     Returns:
         bool (True if success)
-    '''
+    """
 
     if not os.path.exists(os.path.dirname(json_file)):
         os.makedirs(os.path.dirname(json_file))

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/logger.py

@@ -1,8 +1,8 @@
 import logging
 
 
-def get_logger(name: str):
-    ''' basic log'''
+def get_logger(name: str) -> logging.Logger:
+    """Returns a logger object with a stream handler."""
     _log = logging.getLogger(name)
     _log.propagate = False
     _log.setLevel(logging.DEBUG)

{python-backpack-1.0.5 → python_backpack-2.0.0}/backpack/patterns.py

@@ -5,8 +5,9 @@
 # ----------------------------------------------------------------------------------------
 
 
-class Singleton():
-    ''' Python Singleton BaseClass
+class Singleton:
+    """Python Singleton BaseClass.
+
     Usage:
 
         class MyClass(Singleton, otherClass):
@@ -14,11 +15,12 @@ class Singleton():
 
         obj = MyClass() # any new object will be taken from the same instance
 
-    '''
+    """
 
     _instance = None
 
     def __new__(cls, *args, **kwargs):
+        """Singleton __new__ method."""
         if not isinstance(cls._instance, cls):
             # print(f'Initializing {cls.__name__}')
             cls._instance = object.__new__(cls)