refactor: align packaging metadata and CI for 2.0.3

Author: MaxRocamora

.github/workflows/codecov_tests.yml

@@ -9,7 +9,7 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.11']
+        python-version: ['3.11', '3.12', '3.13', '3.14']
 
     steps:
     - uses: actions/checkout@v6
@@ -19,20 +19,29 @@ jobs:
       with:
         python-version: ${{ matrix.python-version }}
 
-    - name: Add path to PYTHONPATH
-      run: |
-        echo "PYTHONPATH=$GITHUB_WORKSPACE" >> $GITHUB_ENV
-
     - name: Install dependencies
       run: |
         python -m pip install --upgrade pip
         pip install uv
         uv sync --dev
 
-    - name: Run tests with coverage
+    - name: Run Ruff
+      if: ${{ matrix.python-version == '3.11' }}
+      run: uv run ruff check .
+
+    - name: Run Pyright
+      if: ${{ matrix.python-version == '3.11' }}
+      run: uv run pyright backpack tests
+
+    - name: Run tests
+      if: ${{ matrix.python-version != '3.11' }}
+      run: uv run pytest
+
+    - name: Run tests with branch coverage
+      if: ${{ matrix.python-version == '3.11' }}
       run: |
-        uv run coverage run --source=backpack -m pytest
-        uv run coverage report -m --fail-under=70
+        uv run coverage run --branch --source=backpack -m pytest
+        uv run coverage report -m --fail-under=99
         uv run coverage xml
 
     - name: Upload coverage.xml

backpack/version.py

@@ -11,12 +11,13 @@
 # 1.1.4 07/2025 - Moved from pipenv to poetry for dependency management.toml
 # 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
+# 2.0.3 06/2026 - Add type hints to backpack.cache, backpack.folder_utils, backpack.json_user_settings, backpack.json_utils, and backpack.logger, refactor backpack.cache to use functools.lru_cache, and add tests for backpack.cache and backpack.folder_utils.
 # ----------------------------------------------------------------------------------------
 
-VERSION_MAJOR = 2
-VERSION_MINOR = 0
-VERSION_PATCH = 2
+__version__ = '2.0.3'
 
-version = f'{VERSION_MAJOR}.{VERSION_MINOR}.{VERSION_PATCH}'
+VERSION_MAJOR, VERSION_MINOR, VERSION_PATCH = map(int, __version__.split('.'))
+
+version = __version__
 
 app_name = 'python-backpack'

pyproject.toml

@@ -1,13 +1,31 @@
 [project]
 name = "python-backpack"
-version = "2.0.2"
-description = "A collection of personal scripts for json, File/Folder Operations, String Validation, Custom Errors, Cache and stuff."
-readme = "README.md"
+dynamic = ["version"]
+description = "Lightweight utilities for JSON, filesystem operations, strings, caching, and scripting."
+readme = { file = "README.md", content-type = "text/markdown" }
+license = "GPL-3.0-only"
+license-files = ["LICENSE"]
 authors = [
-    { name = "Maximiliano Rocamora" }
+    { name = "Maximiliano Rocamora", email = "maxirocamora@gmail.com" }
 ]
+keywords = ["cache", "filesystem", "json", "strings", "utilities"]
 requires-python = ">=3.11"
 dependencies = []
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Utilities",
+]
+
+[project.urls]
+Homepage = "https://github.com/MaxRocamora/python-backpack"
+Repository = "https://github.com/MaxRocamora/python-backpack.git"
 
 [dependency-groups]
 dev = [
@@ -16,6 +34,7 @@ dev = [
     "mock>=5.2.0",
     "pytest>=9.0.3",
     "pytest-cov>=7.1.0",
+    "pyright>=1.1.411",
 ]
 
 [build-system]
@@ -25,6 +44,9 @@ build-backend = "hatchling.build"
 [tool.hatch.build.targets.wheel]
 packages = ["backpack"]
 
+[tool.hatch.version]
+path = "backpack/version.py"
+
 [tool.pytest.ini_options]
 addopts = "-p no:cacheprovider"
 testpaths = ["tests"]

ruff.toml

@@ -13,8 +13,10 @@ select = ["D", "F", "N", "I", "W"]
 ignore = ["E402", "D100", "D202", "D101", "D104"]
 
 [lint.per-file-ignores]
-# Ignore `E402` (import violations) in all `__init__.py` files.
-"__init__.py" = ["E402"]
+# Ignore `E402` (import violations) and `N999` (invalid module name) in all
+# `__init__.py` files. `N999` is triggered by the repository/package layout on
+# this project, not by an actionable module rename inside the repo.
+"__init__.py" = ["E402", "N999"]
 
 [lint.pydocstyle]
 convention = "google"  # Accepts: "google", "numpy", or "pep257".