quickbase-extract 0.4.0__tar.gz → 0.4.2__tar.gz

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/.pre-commit-config.yaml

@@ -9,7 +9,7 @@ repos:
       - id: debug-statements    # Prevents accidental pdb/breakpoint commits
 
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.1.11
+    rev: v0.15.11
     hooks:
       - id: ruff
         args: [--fix]

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.2] - 2026-05-13
+
+### Fixed
+
+- Fixed type signature of `get_data_parallel()` `ask_values` parameter from `dict[ReportConfig, dict[str, str | list[str]] | None] | None` to `dict[ReportConfig, dict[str, str | list[str]]] | None` to correctly reflect that inner dict values should not be `None`
+- Fixed api_handlers functions to properly indicate they can return `None` on all code paths
+
+## [0.4.1] - 2026-05-01
+
+### Fixed
+
+- `load_report_metadata()` return type changed from `dict` to `dict[ReportConfig, dict]` to match `load_report_metadata_batch()` and ensure consistent API with `get_data()`
+- Fixed incompatibility where `load_report_metadata()` result could not be directly passed to `get_data()` due to format mismatch
+
 ## [0.4.0] - 2026-04-29
 
 ### Added
@@ -107,9 +121,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 - `cache_freshness.py` module — functionality consolidated into `cache_manager.py` (use `ensure_cache_freshness()` instead)
 - `check_cache_freshness()`, `get_cache_files()`, `get_cache_summary()` functions — use `CacheManager` methods directly or `ensure_cache_freshness()` for orchestration
-- `refresh_all()` function**: Use `ensure_cache_freshness()` for cache management
-- `client.py` module**: Users must create Quickbase clients directly using `quickbase-api` package
-- `get_cache_manager()` singleton**: Users must create `CacheManager` instances explicitly
+- `refresh_all()` function\*\*: Use `ensure_cache_freshness()` for cache management
+- `client.py` module\*\*: Users must create Quickbase clients directly using `quickbase-api` package
+- `get_cache_manager()` singleton\*\*: Users must create `CacheManager` instances explicitly
 - `find_report()` function from utils - no longer needed with `ReportConfig`
 - Dict-based report config format - all configs must use `ReportConfig` NamedTuple
 - Nested `report` object from metadata - simplified structure

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: quickbase-extract
-Version: 0.4.0
+Version: 0.4.2
 Summary: Extract and cache Quickbase report data with built-in error handling and S3 support
 Project-URL: Homepage, https://github.com/tbrezler/quickbase-extract
 Project-URL: Repository, https://github.com/tbrezler/quickbase-extract.git
@@ -20,8 +20,8 @@ Requires-Dist: boto3>=1.26.0
 Requires-Dist: quickbase-api>=0.3.1
 Provides-Extra: dev
 Requires-Dist: pytest-cov>=4.0; extra == 'dev'
-Requires-Dist: pytest>=7.0; extra == 'dev'
-Requires-Dist: ruff>=0.1.0; extra == 'dev'
+Requires-Dist: pytest>=9.0.3; extra == 'dev'
+Requires-Dist: ruff>=0.15.11; extra == 'dev'
 Description-Content-Type: text/markdown
 
 # Quickbase Extract
@@ -47,7 +47,7 @@ pip install quickbase-extract
 
 ### Requirements
 
-- Python 3.9+
+- Python 3.12+
 - `quickbase-api` - Quickbase API client
 - `boto3` - AWS SDK (for Lambda/S3 support)
 

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/README.md

@@ -21,7 +21,7 @@ pip install quickbase-extract
 
 ### Requirements
 
-- Python 3.9+
+- Python 3.12+
 - `quickbase-api` - Quickbase API client
 - `boto3` - AWS SDK (for Lambda/S3 support)
 

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "quickbase-extract"
-version = "0.4.0"
+version = "0.4.2"
 description = "Extract and cache Quickbase report data with built-in error handling and S3 support"
 readme = "README.md"
 requires-python = ">=3.12"
@@ -29,9 +29,9 @@ dependencies = [
 
 [project.optional-dependencies]
 dev = [
-    "pytest>=7.0",
+    "pytest>=9.0.3",
     "pytest-cov>=4.0",
-    "ruff>=0.1.0",
+    "ruff>=0.15.11",
 ]
 
 [project.urls]

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/src/quickbase_extract/api_handlers.py

@@ -26,7 +26,7 @@ def handle_upsert(
     data: list[dict],
     description: str = "",
     max_retries: int = 3,
-) -> dict:
+) -> dict | None:
     """Execute a Quickbase upsert with error handling, retry logic, and logging.
 
     Retries on rate limiting (429 errors) with exponential backoff and jitter.
@@ -85,7 +85,7 @@ def handle_delete(
     where: str,
     description: str = "",
     max_retries: int = 3,
-) -> int:
+) -> int | None:
     """Execute a Quickbase delete with error handling, logging, and rate limit retry.
 
     Only retries on rate limiting (429 errors) with exponential backoff and jitter.
@@ -144,7 +144,7 @@ def handle_query(
     options: dict | None = None,
     description: str = "",
     max_retries: int = 3,
-) -> dict:
+) -> dict | None:
     """Execute a Quickbase query with error handling, retry logic, and logging.
 
     Retries on rate limiting (429 errors) with exponential backoff and jitter.

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/src/quickbase_extract/cache_orchestration.py

@@ -123,7 +123,7 @@ def _refresh_data_cache(
     cache_manager: CacheManager,
     reports_to_refresh: list[ReportConfig],
     reasons: list[str],
-    ask_values: dict[ReportConfig, dict[str, str | list[str]] | None] | None = None,
+    ask_values: dict[ReportConfig, dict[str, str | list[str]]] | None = None,
 ) -> None:
     """Refresh data cache for specified reports.
 
@@ -164,7 +164,7 @@ def ensure_cache_freshness(
     cache_manager: CacheManager,
     report_configs_all: list[ReportConfig],
     report_configs_to_cache: list[ReportConfig] | None = None,
-    ask_values: dict[ReportConfig, dict[str, str | list[str]] | None] | None = None,
+    ask_values: dict[ReportConfig, dict[str, str | list[str]]] | None = None,
     metadata_stale_hours: float | None = None,
     data_stale_hours: float | None = None,
     cache_all_data: bool = False,

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/src/quickbase_extract/report_data.py

@@ -300,7 +300,7 @@ def get_data_parallel(
     report_metadata: dict,
     cache: bool = False,
     max_workers: int = 8,
-    ask_values: dict[ReportConfig, dict[str, str | list[str]] | None] | None = None,
+    ask_values: dict[ReportConfig, dict[str, str | list[str]]] | None = None,
 ) -> dict[ReportConfig, list[dict]]:
     """Fetch multiple reports in parallel using cached report metadata.
 

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/src/quickbase_extract/report_metadata.py

@@ -238,7 +238,7 @@ def get_report_metadata_parallel(
 def load_report_metadata(
     cache_manager: CacheManager,
     report_config: ReportConfig,
-) -> dict:
+) -> dict[ReportConfig, dict]:
     """Load cached report metadata from disk.
 
     Args:
@@ -246,7 +246,8 @@ def load_report_metadata(
         report_config: ReportConfig identifying the report to load.
 
     Returns:
-        Dict containing table ID, field mappings, query config, and filters.
+        Dict mapping ReportConfig -> metadata dict (table ID, field mappings,
+        query config, and filters).
 
     Raises:
         FileNotFoundError: If cached metadata does not exist.
@@ -255,6 +256,7 @@ def load_report_metadata(
         >>> cache_manager = CacheManager(cache_root=Path("my_project/dev/cache"))
         >>> config = ReportConfig("bq8xyx9z", "Accounts", "Python")
         >>> metadata = load_report_metadata(cache_manager, config)
+        >>> config_metadata = metadata[config]
     """
     # Normalize names to match how they were saved
     app_name = normalize_name(report_config.app_name)
@@ -268,7 +270,8 @@ def load_report_metadata(
             f"Report metadata not found for {report_config}. Run get_report_metadata() first. Expected: {md_path}"
         )
 
-    return json.loads(cache_manager.read_file(md_path))
+    metadata_dict = json.loads(cache_manager.read_file(md_path))
+    return {report_config: metadata_dict}
 
 
 def load_report_metadata_batch(
@@ -304,7 +307,7 @@ def load_report_metadata_batch(
 
     metadata: dict[ReportConfig, dict] = {}
     for config in report_configs:
-        metadata[config] = load_report_metadata(cache_manager, config)
+        metadata.update(load_report_metadata(cache_manager, config))
 
     return metadata
 

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/tests/conftest.py

@@ -218,5 +218,3 @@ def mock_s3_client():
     from unittest.mock import MagicMock
 
     return MagicMock()
-    return MagicMock()
-    return MagicMock()

{quickbase_extract-0.4.0 → quickbase_extract-0.4.2}/tests/test_report_metadata.py

@@ -300,10 +300,12 @@ class TestLoadReportMetadata:
         # Now load it
         metadata = load_report_metadata(cache_mgr, config)
 
-        assert metadata["table_id"] == "tblXYZ123"
-        assert metadata["table_name"] == "test_table"
-        assert "fields" in metadata
-        assert "filter" in metadata
+        # Metadata is now dict[ReportConfig, dict]
+        assert config in metadata
+        assert metadata[config]["table_id"] == "tblXYZ123"
+        assert metadata[config]["table_name"] == "test_table"
+        assert "fields" in metadata[config]
+        assert "filter" in metadata[config]
 
     def test_load_nonexistent_metadata(self, temp_cache_dir, sample_report_configs):
         """Test error when loading non-cached metadata."""
@@ -335,7 +337,8 @@ class TestLoadReportMetadata:
 
         # Should be able to load with original config
         metadata = load_report_metadata(cache_mgr, config)
-        assert metadata is not None
+        assert config in metadata
+        assert metadata[config] is not None
 
 
 class TestLoadReportMetadataBatch: