python-backpack 2.0.0__py3-none-any.whl → 2.0.2__py3-none-any.whl

backpack/file_utils.py

@@ -84,3 +84,44 @@ def file_is_writeable(filepath: str) -> bool:
         log.info(x.strerror)
 
     return False
+
+
+def get_version_from_filename(filename: str) -> str:
+    """Extracts version from filename.
+
+    Args:
+        filename: (str) file name to extract version from
+    Returns:
+        str : version extracted from filename
+
+    Examples:
+        get_version_from_filename('myfile_23.txt') -> '23'
+        get_version_from_filename('myfile-9.txt') -> '9'
+        get_version_from_filename('myfile.130.txt') -> '130'
+        get_version_from_filename('myfile_v1002.txt') -> '1002'
+
+    """
+
+    filename_no_ext = filename.rsplit('.', 1)[0]
+
+    # guess is the separator is an underscore, dash, dot or v, and the version is the last part before the extension
+    separators = ['_', '-', '.', 'v']
+    if not any(sep in filename_no_ext for sep in separators):
+        log.info(f'No separator found in filename: {filename_no_ext}. Using fallback extraction.')
+    else:
+        for sep in separators:
+            if sep in filename_no_ext:
+                parts = filename_no_ext.split(sep)
+                version_part = parts[-1].split('.')[0]  # Get the last part before the extension
+                if version_part.replace('.', '').isdigit():  # Check if it's a valid version number
+                    log.info(
+                        f'Extracted version: {version_part} from filename: {filename} using separator: {sep}'
+                    )
+                    return version_part
+
+    # Fallback: extract from the entire filename
+    version = filename_no_ext.lstrip('v')
+    version = version.replace('_', '.').replace('-', '.')
+    version = version if version.replace('.', '').isdigit() else '0'
+    log.info(f'Extracted version: {version} from filename: {filename}')
+    return version

backpack/json_utils.py

@@ -40,7 +40,7 @@ def json_save(data: dict, json_file: str) -> bool:
     """
 
     if not os.path.exists(os.path.dirname(json_file)):
-        os.makedirs(os.path.dirname(json_file))
+        os.makedirs(os.path.dirname(json_file), exist_ok=True)
 
     try:
         with open(json_file, 'w') as f:

backpack/version.py

@@ -9,12 +9,13 @@
 # 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
+# 2.0.1 05/2026 - Remove tox workflow and setup.py, standardize uv + coverage tooling
+# 2.0.2 05/2026 - Add PyPI long description metadata and release polish
 # ----------------------------------------------------------------------------------------
 
 VERSION_MAJOR = 2
 VERSION_MINOR = 0
-VERSION_PATCH = 0
+VERSION_PATCH = 2
 
 version = f'{VERSION_MAJOR}.{VERSION_MINOR}.{VERSION_PATCH}'
 

python_backpack-2.0.2.dist-info/METADATA

@@ -0,0 +1,155 @@
+Metadata-Version: 2.4
+Name: python-backpack
+Version: 2.0.2
+Summary: A collection of personal scripts for json, File/Folder Operations, String Validation, Custom Errors, Cache and stuff.
+Author: Maximiliano Rocamora
+License-File: LICENSE
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+
+[![PyPI Supported Python Versions](https://img.shields.io/pypi/pyversions/python-backpack.svg?style=flat-square&logo=appveyor)](https://pypi.python.org/pypi/python-backpack/)
+[![PyPI version](https://badge.fury.io/py/python-backpack.svg?style=flat-square&logo=appveyor)](https://badge.fury.io/py/python-backpack)
+[![GitHub version](https://badge.fury.io/gh/MaxRocamora%2Fpython-backpack.svg?style=flat-square&logo=appveyor)](https://badge.fury.io/gh/MaxRocamora%2Fpython-backpack)
+[![codecov](https://codecov.io/gh/MaxRocamora/python-backpack/graph/badge.svg?token=6D1xwYdXW2)](https://codecov.io/gh/MaxRocamora/python-backpack)
+
+
+# Python-Backpack
+
+Python-Backpack is a lightweight utility collection for common scripting tasks:
+
+- JSON load/save helpers with validation
+- user settings persistence under the OS user directory
+- metadata export/import to JSON files
+- file and folder operations
+- string normalization and case conversion
+- cache decorator with expiration support
+- custom exceptions, logging helper, singleton pattern, and testing helpers
+
+## Compatibility
+
+- Python 3.11+
+
+## Installation
+
+```bash
+pip install python-backpack
+```
+
+## Package API Reference
+
+### Cache (`backpack.cache`)
+
+- `timed_lru_cache(seconds: int, maxsize: int = 128)`
+    - `functools.lru_cache` decorator with expiration time.
+    - Wrapped calls support `force_clear=True` and `show_log=True`.
+
+### Custom Errors (`backpack.custom_errors`)
+
+- `EnvironmentVariableNotFoundError(var_name: str)`
+    - Raised when a required environment variable is missing.
+- `ApplicationNotFoundError(app_name: str)`
+    - Raised when a required application is not found.
+
+### File Utils (`backpack.file_utils`)
+
+- `replace_strings_in_file(ascii_file: str, strings: list, new_string: str) -> None`
+    - Replaces multiple string occurrences in a text file.
+- `remove_line_from_file(ascii_file: str, strings: list, verbose: bool = False) -> None`
+    - Removes exact matching lines from a text file.
+- `file_is_writeable(filepath: str) -> bool`
+    - Checks whether a file can be opened for read/write.
+- `get_version_from_filename(filename: str) -> str`
+    - Extracts a numeric version token from a filename.
+
+### Folder Utils (`backpack.folder_utils`)
+
+- `browse_folder(folder: str) -> bool`
+    - Opens a folder in Windows Explorer.
+- `create_folders(folders: list, force_empty: bool = False, verbose: bool = False)`
+    - Creates multiple folders.
+- `create_folder(path: str, force_empty: bool = False, verbose: bool = True)`
+    - Creates a folder and optionally clears it if it already exists.
+- `remove_files_in_dir(path: str)`
+    - Removes all files and subdirectories inside a directory.
+- `recursive_dir_copy(source_path: str, target_path: str)`
+    - Recursively copies files and subfolders from source to target.
+
+### JSON Utils (`backpack.json_utils`)
+
+- `json_load(json_file: str) -> dict`
+    - Loads JSON data from file with validation and error handling.
+- `json_save(data: dict, json_file: str) -> bool`
+    - Saves a dictionary to JSON file.
+
+### JSON Metadata (`backpack.json_metadata`)
+
+- `JsonMetaFile(name: str, path: str)`
+    - Manages a metadata JSON file with package/system/time information.
+    - Main public methods:
+        - `has_file() -> bool`
+        - `load() -> None`
+        - `insert(key: str, value: Any) -> None`
+        - `remove(key: str) -> None`
+        - `save() -> None`
+        - `load_as_class() -> type`
+        - `insert_class(_class: type) -> None`
+
+### JSON User Settings (`backpack.json_user_settings`)
+
+- `JsonUserSettings(folder: str, name: str)`
+    - Saves and loads JSON settings in the current user's home directory.
+    - Main public methods:
+        - `save_settings(data: dict | None = None) -> bool | None`
+        - `load_settings() -> dict | bool`
+
+### Logger (`backpack.logger`)
+
+- `get_logger(name: str) -> logging.Logger`
+    - Returns a configured logger with stream handler.
+
+### Patterns (`backpack.patterns`)
+
+- `Singleton`
+    - Base class implementing singleton behavior via `__new__`.
+
+### Strings (`backpack.strings`)
+
+- `normalize_input_string(input_string: str, under_spaces: bool = True, under_hyphen: bool = True, replacer: str = '_') -> str`
+    - Keeps alphanumeric/space/hyphen characters and normalizes separators.
+- `begin_or_end_with_numbers(input_string: str) -> bool`
+    - Checks whether first or last character is numeric.
+- `begin_with_number(input_string: str) -> bool`
+    - Checks whether the first character is numeric.
+- `has_numbers(input_string: str) -> bool`
+    - Checks whether any character is numeric.
+- `camelcase_to_snakecase(input_string: str) -> str`
+    - Converts CamelCase to snake_case.
+    - Handles acronym prefixes, for example `HTTPServer -> http_server`.
+
+### Test Utils (`backpack.test_utils`)
+
+- `random_string(length: int = 10) -> str`
+    - Generates a random lowercase string.
+- `time_function_decorator(method: type)`
+    - Decorator that logs execution time.
+
+## Quick Example
+
+```python
+from backpack.cache import timed_lru_cache
+from backpack.strings import camelcase_to_snakecase, normalize_input_string
+from backpack.json_utils import json_save, json_load
+
+
+@timed_lru_cache(seconds=60)
+def expensive_call():
+        return {'ok': True}
+
+
+value = camelcase_to_snakecase('HTTPServer')
+clean = normalize_input_string('Blade Runner-2049')
+
+json_save({'value': value, 'clean': clean}, 'data.json')
+data = json_load('data.json')
+```
+

{python_backpack-2.0.0.dist-info → python_backpack-2.0.2.dist-info}/RECORD

@@ -1,17 +1,17 @@
 backpack/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 backpack/cache.py,sha256=NlKyeGSXHaA9-RFLSN9Dblt0s7kL9fKzqQhGPHpgGbM,2508
 backpack/custom_errors.py,sha256=tkn0AnV-Ihnge9X197nPeRpCFD6Feu9lLntejNTNpik,1358
-backpack/file_utils.py,sha256=neJN9PL866H8gNFJMbWe06PqENY9UKO61YQa39ujjgY,2743
+backpack/file_utils.py,sha256=VgwVyZFGHJFpaqp0jkqUCAAFfFKFywoK9LTUngsD3bQ,4478
 backpack/folder_utils.py,sha256=RxfVHBLDTL2EdU2w_EMOWsdtCQh-f5BHMzGIRo3UEI8,2983
 backpack/json_metadata.py,sha256=KHsXTCDcrKa68p_HgtQfy_AjXmDCxiA99NIuZfKn2I8,4561
 backpack/json_user_settings.py,sha256=RwdxIZYD4jkcIrWxMn7ZrlKejaGIYOt2TXTGob7nCUg,2676
-backpack/json_utils.py,sha256=ZMl_aGb6oU9sQByOqT5OFTdgAKL2iB-DxsVkVuSCOjA,1324
+backpack/json_utils.py,sha256=wQhGzZVltiob_-W4FN40mmq6sO6lw6KSiL1mOQiokH0,1339
 backpack/logger.py,sha256=yoo4_4Ok9MAdd3GSTeeSGaIKJ4c-KwdhI6q7lg_39oo,518
 backpack/patterns.py,sha256=qBwgbpfzMrap4KHtLLsg1CJmsmstGGXfzYLpkuUdbMI,889
 backpack/strings.py,sha256=boYfBi1wPtfkngpb2uIAxiJC2yo32EaL5wUD_3JjWGo,3811
 backpack/test_utils.py,sha256=0VqVZB6snc_XM6MsmIanlFGWo5T2zswFq9Cn-HpZntE,1165
-backpack/version.py,sha256=WBEIf90Avless1yHQdpQSg-8LGK2ekKoGI1aSbhFXvs,1073
-python_backpack-2.0.0.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
-python_backpack-2.0.0.dist-info/METADATA,sha256=Tx9wVjs9b5jS_296ngOXGCHkiRdGIxjgUNTGx4B2TbU,518
-python_backpack-2.0.0.dist-info/WHEEL,sha256=Vz2fHgx6HFtSwhs8KvkHLqH5Ea4w1_rner5uNVGCeIE,88
-python_backpack-2.0.0.dist-info/RECORD,,
+backpack/version.py,sha256=Fq5KuzRZRp4ddDxWlq_4cagPvUSdThBTweQYxzXrPRs,1142
+python_backpack-2.0.2.dist-info/METADATA,sha256=gPzzEs-rVOgn8mlF0Rr7bHKxq4flNSjZkseZ59o4V8g,5736
+python_backpack-2.0.2.dist-info/WHEEL,sha256=QccIxa26bgl1E6uMy58deGWi-0aeIkkangHcxk2kWfw,87
+python_backpack-2.0.2.dist-info/licenses/LICENSE,sha256=IwGE9guuL-ryRPEKi6wFPI_zOhg7zDZbTYuHbSt_SAk,35823
+python_backpack-2.0.2.dist-info/RECORD,,

{python_backpack-2.0.0.dist-info → python_backpack-2.0.2.dist-info}/WHEEL

@@ -1,4 +1,4 @@
 Wheel-Version: 1.0
-Generator: poetry-core 2.3.2
+Generator: hatchling 1.29.0
 Root-Is-Purelib: true
 Tag: py3-none-any

python_backpack-2.0.0.dist-info/METADATA

@@ -1,12 +0,0 @@
-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