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

{python_backpack-1.1.4 → python_backpack-2.0.0}/PKG-INFO

@@ -1,12 +1,12 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-backpack
-Version: 1.1.4
+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.9,<4.0
+Requires-Python: >=3.11,<4.0
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
 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.1.4 → python_backpack-2.0.0}/backpack/cache.py

@@ -5,13 +5,16 @@
 # ----------------------------------------------------------------------------------------
 from datetime import datetime, timedelta, timezone
 from functools import lru_cache, wraps
+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):
+
+def timed_lru_cache(seconds: int, maxsize: int = 128) -> Callable[[F], F]:
     """Lru_cache with expiration time.
 
     Args:
@@ -36,10 +39,10 @@ def timed_lru_cache(seconds: int, maxsize: int = 128):
 
     """
 
-    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):
@@ -54,15 +57,15 @@ def timed_lru_cache(seconds: int, maxsize: int = 128):
                 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.1.4 → python_backpack-2.0.0}/backpack/json_user_settings.py

@@ -9,6 +9,7 @@ us.save(someDict)
 data = us.load()
 
 """
+
 # ----------------------------------------------------------------------------------------
 import os
 
@@ -59,14 +60,16 @@ class JsonUserSettings:
 
         return True
 
-    def save_settings(self, data=False) -> bool:
+    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
+        Returns:
+            bool | None: True if file was saved, False if error, None if no data to save.
         """
-        if not data:
+        if data is None:
             data = self.user_data
 
         r = json_save(data, self.filepath)
@@ -74,7 +77,7 @@ class JsonUserSettings:
             log.info('json settings file saved! [%s]', self.filepath)
         return r
 
-    def load_settings(self) -> dict:
+    def load_settings(self) -> dict | bool:
         """Load json file from path and returns its contents."""
         try:
             return json_load(self.filepath)

{python_backpack-1.1.4 → python_backpack-2.0.0}/backpack/strings.py

@@ -8,8 +8,11 @@ import contextlib
 import re
 
 
-def reformat_input_string(
-    input_string: str, under_spaces: bool = True, under_hyphen: bool = True
+def normalize_input_string(
+    input_string: str,
+    under_spaces: bool = True,
+    under_hyphen: bool = True,
+    replacer: str = '_',
 ) -> str:
     """Reformat the user input string.
 
@@ -20,6 +23,7 @@ def reformat_input_string(
         input_string (str): input string to reformat
         under_spaces (bool, optional): replaces spaces. Defaults to True.
         under_hyphen (bool, optional): replaces hyphens. Defaults to True.
+        replacer (str, optional): char to replace spaces and hyphens. Defaults to '_'.
 
     Returns:
         str: reformatted string
@@ -30,13 +34,13 @@ def reformat_input_string(
         regex = re.sub('[^A-Za-z0-9 _-]+', '', input_string)
 
     for char in regex:
-        # replacing " " for "_"
+        # replacing " " for replacer
         if under_spaces and char == ' ':
-            regex = regex.replace(' ', '_')
+            regex = regex.replace(' ', replacer)
 
-        # replacing "-" for "_"
+        # replacing "-" for replacer
         if under_hyphen and char == '-':
-            regex = regex.replace('-', '_')
+            regex = regex.replace('-', replacer)
 
     return regex
 
@@ -85,6 +89,7 @@ def camelcase_to_snakecase(input_string: str) -> str:
     Examples:
         OneDayCaseChar > one_day_case_char
         oneCamelCaseChar > one_camel_case_char
+        HTTPServer > http_server
         _TwoCamel_CaseChar > _two_camel_case_char
         _LeadingUnderscore_case_ > _leading_underscore_case_
     """
@@ -97,18 +102,28 @@ def camelcase_to_snakecase(input_string: str) -> str:
             snake_str += char
             continue
 
-        if char.isupper() and index == 0:
-            snake_str += char.lower()
-            continue
-
-        if char.isupper():
-            if input_string[index - 1] != '_':
-                snake_str += '_' + char.lower()
-            else:
-                snake_str += char.lower()
-
+        if not char.isupper():
+            snake_str += char
             continue
 
-        snake_str += char
+        prev_char = input_string[index - 1] if index > 0 else ''
+        next_char = input_string[index + 1] if index + 1 < len(input_string) else ''
+
+        # Add underscore only at real word boundaries.
+        # This keeps acronyms together: HTTPServer -> http_server.
+        should_add_underscore = (
+            index > 0
+            and prev_char != '_'
+            and (
+                prev_char.islower()
+                or prev_char.isdigit()
+                or (prev_char.isupper() and next_char.islower())
+            )
+        )
+
+        if should_add_underscore:
+            snake_str += '_'
+
+        snake_str += char.lower()
 
     return snake_str

{python_backpack-1.1.4 → python_backpack-2.0.0}/backpack/test_utils.py

@@ -12,7 +12,7 @@ from backpack.logger import get_logger
 log = get_logger('Python Backpack - TestUtils')
 
 
-def random_string(length: str = 10) -> str:
+def random_string(length: int = 10) -> str:
     """Generates a random string of fixed length.
 
     Args:

{python_backpack-1.1.4 → python_backpack-2.0.0}/backpack/version.py

@@ -9,11 +9,12 @@
 # 1.1.2 07/2025 - Update actions versions, remove unused badge from README
 # 1.1.3 07/2025 - Improve test class names and docstrings for clarity, ruff formatting
 # 1.1.4 07/2025 - Moved from pipenv to poetry for dependency management.toml
+# 2.0.0 03/2026 - Remove tox workflow and setup.py, standardize Poetry + coverage tooling
 # ----------------------------------------------------------------------------------------
 
-VERSION_MAJOR = 1
-VERSION_MINOR = 1
-VERSION_PATCH = 4
+VERSION_MAJOR = 2
+VERSION_MINOR = 0
+VERSION_PATCH = 0
 
 version = f'{VERSION_MAJOR}.{VERSION_MINOR}.{VERSION_PATCH}'
 

{python_backpack-1.1.4 → python_backpack-2.0.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [tool.poetry]
 name = "python-backpack"
-version = "1.1.4"
+version = "2.0.0"
 description = "A collection of personal scripts for json, File/Folder Operations, String Validation, Custom Errors, Cache and stuff."
 authors = ["Maximiliano Rocamora"]
 packages = [
@@ -8,16 +8,15 @@ packages = [
 ]
 
 [tool.poetry.dependencies]
-python = "^3.9"
+python = "^3.11"
 
 [tool.poetry.group.dev.dependencies]
-tox = "^4.0"
-ruff = "^0.0.289"
+ruff = "^0.15.8"
 mock = "^5.2.0"
-coverage = "^7.9.2"
-pytest-cov = "^6.2.1"
-tox-gh-actions = "^3.3.0"
+coverage = "^7.13.5"
+pytest = "^8.4.2"
+pytest-cov = "^7.1.0"
 
 [build-system]
-requires = ["poetry-core>=1.0.0"]
+requires = ["poetry-core>=2.3.2"]
 build-backend = "poetry.core.masonry.api"