sql-testing-library 0.23.1__tar.gz → 0.24.0__tar.gz

{sql_testing_library-0.23.1 → sql_testing_library-0.24.0}/CHANGELOG.md

@@ -5,6 +5,12 @@ 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.24.0 (2026-11-09)
+
+### Fix
+
+- **core**: keep NULL results as None under pandas 3 (#213)
+
 ## 0.23.1 (2026-10-02)
 
 ### Fix

{sql_testing_library-0.23.1 → sql_testing_library-0.24.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sql-testing-library
-Version: 0.23.1
+Version: 0.24.0
 Summary: SQL Testing Framework for Python: Unit test SQL queries with mock data injection for BigQuery, Snowflake, Redshift, Athena, Trino, DuckDB, and ClickHouse. Simplify data engineering ETL testing and analytics validation.
 License: MIT
 License-File: LICENSE
@@ -9,7 +9,7 @@ Author: Gurmeet Saran
 Author-email: gurmeetx@gmail.com
 Maintainer: Gurmeet Saran
 Maintainer-email: gurmeetx@gmail.com
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Classifier: Development Status :: 4 - Beta
 Classifier: Environment :: Console
 Classifier: Framework :: Pytest
@@ -20,7 +20,6 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Natural Language :: English
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
@@ -1266,7 +1265,6 @@ tox
 
 # Test specific Python version
 tox -e py39  # Python 3.9
-tox -e py310 # Python 3.10
 tox -e py311 # Python 3.11
 tox -e py312 # Python 3.12
 ```

{sql_testing_library-0.23.1 → sql_testing_library-0.24.0}/README.md

@@ -1206,7 +1206,6 @@ tox
 
 # Test specific Python version
 tox -e py39  # Python 3.9
-tox -e py310 # Python 3.10
 tox -e py311 # Python 3.11
 tox -e py312 # Python 3.12
 ```

{sql_testing_library-0.23.1 → sql_testing_library-0.24.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "sql-testing-library"
-version = "0.23.1"
+version = "0.24.0"
 description = "SQL Testing Framework for Python: Unit test SQL queries with mock data injection for BigQuery, Snowflake, Redshift, Athena, Trino, DuckDB, and ClickHouse. Simplify data engineering ETL testing and analytics validation."
 authors = ["Gurmeet Saran <gurmeetx@gmail.com>", "Kushal Thakkar <kushal.thakkar@gmail.com>"]
 maintainers = ["Gurmeet Saran <gurmeetx@gmail.com>", "Kushal Thakkar <kushal.thakkar@gmail.com>"]
@@ -59,7 +59,6 @@ classifiers = [
     "Topic :: Scientific/Engineering :: Information Analysis",
     "License :: OSI Approved :: MIT License",
     "Programming Language :: Python :: 3",
-    "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: Implementation :: CPython",
@@ -84,7 +83,7 @@ include = ["LICENSE", "README.md", "CHANGELOG.md", "py.typed", "src/sql_testing_
 "Contributing" = "https://github.com/gurmeetsaran/sqltesting/blob/master/CONTRIBUTING.md"
 
 [tool.poetry.dependencies]
-python = ">=3.10"
+python = ">=3.11"
 sqlglot = ">=26.0.0"
 pydantic = ">=2.0.0"
 pandas = ">=1.0.0"
@@ -145,7 +144,7 @@ mocksmith = ">=6.0.1"
 sql_testing = "sql_testing_library._pytest_plugin"
 
 [tool.pyright]
-pythonVersion = "3.10"
+pythonVersion = "3.11"
 include = ["src"]
 exclude = ["tests", "scripts"]
 reportMissingImports = true

{sql_testing_library-0.23.1 → sql_testing_library-0.24.0}/src/sql_testing_library/__init__.py

@@ -27,7 +27,7 @@ try:
 except ImportError:
     __all__ = []
 
-__version__ = "0.23.1"
+__version__ = "0.24.0"
 __all__.extend(
     [
         "SQLTestFramework",

{sql_testing_library-0.23.1 → sql_testing_library-0.24.0}/src/sql_testing_library/_core.py

@@ -892,29 +892,33 @@ class SQLTestFramework:
 
     def _deserialize_results(self, result_df: "pd.DataFrame", result_class: Type[T]) -> List[T]:
         """Deserialize query results to typed objects."""
-        import numpy as np
-
         if result_df.empty:
             return []
 
-        # STEP 1: Convert database-returned NaN values to Python None
+        # STEP 1: Convert database-returned missing values (NaN / NA / NaT) to Python None
         #
         # WHY THIS IS NEEDED:
-        # - SQL databases return NULL values which pandas converts to NaN
-        # - Different database adapters may return NaN for null numeric/float columns
-        # - NaN values break object serialization (dataclass/Pydantic instantiation)
+        # - SQL databases return NULL values which pandas stores as NaN/NA/NaT
+        # - Missing-value sentinels break object serialization (dataclass/Pydantic instantiation)
         # - Python None is the correct representation for nullable/optional fields
         #
+        # WHY astype(object) + where, AND to_dict() INSTEAD OF iterrows():
+        # - pandas 3 infers its dedicated string dtype for all-string data and stores
+        #   missing values there as NaN, never None. Adapters such as Athena return every
+        #   column as strings, so a plain replace() is undone as soon as iterrows() rebuilds
+        #   each row as a Series and re-infers the string dtype.
+        # - Forcing plain object dtype and iterating dict records keeps None intact.
+        #
         # RELATIONSHIP TO mock_table.py NaN HANDLING:
         # - mock_table.py: Handles NaN created during DataFrame dtype conversion (input side)
         # - core.py (here): Handles NaN returned from actual database queries (output side)
         # - Both are needed because NaN can appear at different pipeline stages
-        result_df = result_df.replace([np.nan], [None])
+        result_df = result_df.astype(object).where(result_df.notna(), None)
         # Get type hints from the result class
         type_hints = get_type_hints(result_class)
 
         results: List[T] = []
-        for _, row in result_df.iterrows():
+        for row in result_df.to_dict(orient="records"):
             # Convert row to dictionary with proper types
             converted_row: Dict[str, Any] = {}
             for col_name, value in row.items():