sql-testing-library 0.17.0__tar.gz → 0.19.0__tar.gz

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/CHANGELOG.md

@@ -5,6 +5,37 @@ 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.19.0 (2025-12-07)
+
+### Feat
+
+- reorganize documentation navigation for better learning flow
+- comprehensive SEO optimization for better search visibility
+- restrict CodeCov uploads to master branch only
+- enable CodeCov carryforward for all coverage flags
+
+### Fix
+
+- add support for Python 3.10+ pipe-none (X | None) union syntax (#133)
+- sanitize CTE aliases and sync package version (#132)
+- align robots.txt and sitemap with Google's official guidelines
+- shorten page titles for better readability and display
+- optimize robots.txt for better Google Search Console compatibility
+
+## 0.18.0 (2025-12-01)
+
+### Feat
+
+- add Google Analytics tracking
+- improve SEO across PyPI, GitHub, and documentation
+
+### Fix
+
+- update codecov-action parameter from 'file' to 'files'
+- handle pytest-xdist environment in worker ID test
+- shorten site title to prevent display issues
+- update Twitter handle to @saran_gurmeet and remove non-existent image references
+
 ## 0.17.0 (2025-11-20)
 
 ### Feat

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/PKG-INFO

@@ -1,10 +1,10 @@
 Metadata-Version: 2.4
 Name: sql-testing-library
-Version: 0.17.0
-Summary: A powerful Python framework for unit testing SQL queries across BigQuery, Snowflake, Redshift, Athena, Trino, and DuckDB with mock data
+Version: 0.19.0
+Summary: SQL Testing Framework for Python: Unit test SQL queries with mock data injection for BigQuery, Snowflake, Redshift, Athena, Trino, and DuckDB. Simplify data engineering ETL testing and analytics validation.
 License: MIT
 License-File: LICENSE
-Keywords: sql,testing,unit-testing,mock-data,database-testing,bigquery,snowflake,redshift,athena,trino,duckdb,data-engineering,etl-testing,sql-validation,query-testing
+Keywords: sql,testing,unit-testing,mock-data,database-testing,bigquery,snowflake,redshift,athena,trino,duckdb,data-engineering,etl-testing,sql-validation,query-testing,pytest,data-quality,analytics-testing,sql-unit-test,database-mocking,sql-mock,data-warehouse-testing,cloud-database,aws-athena,google-bigquery,amazon-redshift,snowflake-testing,ci-cd-testing,test-automation
 Author: Gurmeet Saran
 Author-email: gurmeetx@gmail.com
 Maintainer: Gurmeet Saran
@@ -60,7 +60,11 @@ Description-Content-Type: text/markdown
 
 # SQL Testing Library
 
-A powerful Python framework for unit testing SQL queries with mock data injection across BigQuery, Snowflake, Redshift, Athena, Trino, and DuckDB.
+> **A powerful Python framework for unit testing SQL queries with mock data injection**
+>
+> Test SQL queries across BigQuery, Snowflake, Redshift, Athena, Trino, and DuckDB with type-safe mock data, pytest integration, and automatic table resolution. Perfect for data engineering, ETL pipeline testing, and analytics validation.
+
+**Quick Links:** [Installation](#installation) | [Quick Start](#quick-start) | [Documentation](https://gurmeetsaran.github.io/sqltesting/) | [Examples](https://gurmeetsaran.github.io/sqltesting/examples.html) | [PyPI Package](https://pypi.org/project/sql-testing-library/)
 
 [![Unit Tests](https://github.com/gurmeetsaran/sqltesting/actions/workflows/tests.yaml/badge.svg)](https://github.com/gurmeetsaran/sqltesting/actions/workflows/tests.yaml)
 [![Athena Integration](https://github.com/gurmeetsaran/sqltesting/actions/workflows/athena-integration.yml/badge.svg)](https://github.com/gurmeetsaran/sqltesting/actions/workflows/athena-integration.yml)

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/README.md

@@ -1,6 +1,10 @@
 # SQL Testing Library
 
-A powerful Python framework for unit testing SQL queries with mock data injection across BigQuery, Snowflake, Redshift, Athena, Trino, and DuckDB.
+> **A powerful Python framework for unit testing SQL queries with mock data injection**
+>
+> Test SQL queries across BigQuery, Snowflake, Redshift, Athena, Trino, and DuckDB with type-safe mock data, pytest integration, and automatic table resolution. Perfect for data engineering, ETL pipeline testing, and analytics validation.
+
+**Quick Links:** [Installation](#installation) | [Quick Start](#quick-start) | [Documentation](https://gurmeetsaran.github.io/sqltesting/) | [Examples](https://gurmeetsaran.github.io/sqltesting/examples.html) | [PyPI Package](https://pypi.org/project/sql-testing-library/)
 
 [![Unit Tests](https://github.com/gurmeetsaran/sqltesting/actions/workflows/tests.yaml/badge.svg)](https://github.com/gurmeetsaran/sqltesting/actions/workflows/tests.yaml)
 [![Athena Integration](https://github.com/gurmeetsaran/sqltesting/actions/workflows/athena-integration.yml/badge.svg)](https://github.com/gurmeetsaran/sqltesting/actions/workflows/athena-integration.yml)

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/pyproject.toml

@@ -4,8 +4,8 @@ build-backend = "poetry.core.masonry.api"
 
 [tool.poetry]
 name = "sql-testing-library"
-version = "0.17.0"
-description = "A powerful Python framework for unit testing SQL queries across BigQuery, Snowflake, Redshift, Athena, Trino, and DuckDB with mock data"
+version = "0.19.0"
+description = "SQL Testing Framework for Python: Unit test SQL queries with mock data injection for BigQuery, Snowflake, Redshift, Athena, Trino, and DuckDB. 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>"]
 license = "MIT"
@@ -28,7 +28,21 @@ keywords = [
     "data-engineering",
     "etl-testing",
     "sql-validation",
-    "query-testing"
+    "query-testing",
+    "pytest",
+    "data-quality",
+    "analytics-testing",
+    "sql-unit-test",
+    "database-mocking",
+    "sql-mock",
+    "data-warehouse-testing",
+    "cloud-database",
+    "aws-athena",
+    "google-bigquery",
+    "amazon-redshift",
+    "snowflake-testing",
+    "ci-cd-testing",
+    "test-automation"
 ]
 classifiers = [
     "Development Status :: 4 - Beta",
@@ -292,3 +306,6 @@ update_changelog_on_bump = true
 major_version_zero = true
 changelog_merge_prerelease = true
 changelog_start_rev = "0.1.0"
+version_files = [
+    "src/sql_testing_library/__init__.py:__version__"
+]

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/src/sql_testing_library/__init__.py

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

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/src/sql_testing_library/_adapters/bigquery.py

@@ -10,7 +10,6 @@ from typing import (
     Optional,
     Tuple,
     Type,
-    Union,
     get_args,
     get_type_hints,
 )
@@ -22,7 +21,7 @@ if TYPE_CHECKING:
 
 # Heavy imports moved to function level for better performance
 from .._mock_table import BaseMockTable
-from .._types import BaseTypeConverter
+from .._types import BaseTypeConverter, is_union_type
 from .base import DatabaseAdapter
 
 
@@ -247,9 +246,9 @@ class BigQueryAdapter(DatabaseAdapter):
 
         schema = []
         for col_name, col_type in column_types.items():
-            # Handle Optional types
-            if hasattr(col_type, "__origin__") and col_type.__origin__ is Union:
-                # Extract the non-None type from Optional[T]
+            # Handle Optional types (both Optional[X] and X | None)
+            if is_union_type(col_type):
+                # Extract the non-None type from Optional[T] or T | None
                 non_none_types = [arg for arg in get_args(col_type) if arg is not type(None)]
                 if non_none_types:
                     col_type = non_none_types[0]
@@ -319,9 +318,9 @@ class BigQueryAdapter(DatabaseAdapter):
         type_hints = get_type_hints(struct_type)
 
         for field_name, field_type in type_hints.items():
-            # Handle Optional types
-            if hasattr(field_type, "__origin__") and field_type.__origin__ is Union:
-                # Extract the non-None type from Optional[T]
+            # Handle Optional types (both Optional[X] and X | None)
+            if is_union_type(field_type):
+                # Extract the non-None type from Optional[T] or T | None
                 non_none_types = [arg for arg in get_args(field_type) if arg is not type(None)]
                 if non_none_types:
                     field_type = non_none_types[0]
@@ -388,9 +387,9 @@ class BigQueryAdapter(DatabaseAdapter):
         column_types = mock_table.get_column_types()
 
         for col_name, col_type in column_types.items():
-            # Handle Optional types
-            if hasattr(col_type, "__origin__") and col_type.__origin__ is Union:
-                # Extract the non-None type from Optional[T]
+            # Handle Optional types (both Optional[X] and X | None)
+            if is_union_type(col_type):
+                # Extract the non-None type from Optional[T] or T | None
                 non_none_types = [arg for arg in get_args(col_type) if arg is not type(None)]
                 if non_none_types:
                     col_type = non_none_types[0]

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/src/sql_testing_library/_adapters/duckdb.py

@@ -10,7 +10,6 @@ from typing import (
     Optional,
     Tuple,
     Type,
-    Union,
     get_args,
     get_type_hints,
 )
@@ -22,7 +21,7 @@ if TYPE_CHECKING:
 
 # Heavy imports moved to function level for better performance
 from .._mock_table import BaseMockTable
-from .._types import BaseTypeConverter
+from .._types import BaseTypeConverter, is_union_type
 from .base import DatabaseAdapter
 
 
@@ -237,9 +236,9 @@ class DuckDBAdapter(DatabaseAdapter):
 
         column_defs = []
         for col_name, col_type in column_types.items():
-            # Handle Optional types
-            if hasattr(col_type, "__origin__") and col_type.__origin__ is Union:
-                # Extract the non-None type from Optional[T]
+            # Handle Optional types (both Optional[X] and X | None)
+            if is_union_type(col_type):
+                # Extract the non-None type from Optional[T] or T | None
                 non_none_types = [arg for arg in get_args(col_type) if arg is not type(None)]
                 if non_none_types:
                     col_type = non_none_types[0]
@@ -301,9 +300,9 @@ class DuckDBAdapter(DatabaseAdapter):
         field_defs = []
 
         for field_name, field_type in type_hints.items():
-            # Handle Optional types
-            if hasattr(field_type, "__origin__") and field_type.__origin__ is Union:
-                # Extract the non-None type from Optional[T]
+            # Handle Optional types (both Optional[X] and X | None)
+            if is_union_type(field_type):
+                # Extract the non-None type from Optional[T] or T | None
                 non_none_types = [arg for arg in get_args(field_type) if arg is not type(None)]
                 if non_none_types:
                     field_type = non_none_types[0]
@@ -360,9 +359,9 @@ class DuckDBAdapter(DatabaseAdapter):
         column_types = mock_table.get_column_types()
 
         for col_name, col_type in column_types.items():
-            # Handle Optional types
-            if hasattr(col_type, "__origin__") and col_type.__origin__ is Union:
-                # Extract the non-None type from Optional[T]
+            # Handle Optional types (both Optional[X] and X | None)
+            if is_union_type(col_type):
+                # Extract the non-None type from Optional[T] or T | None
                 non_none_types = [arg for arg in get_args(col_type) if arg is not type(None)]
                 if non_none_types:
                     col_type = non_none_types[0]

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/src/sql_testing_library/_adapters/presto.py

@@ -2,10 +2,10 @@
 
 from datetime import date, datetime
 from decimal import Decimal
-from typing import Any, List, Tuple, Type, Union, get_args
+from typing import Any, List, Tuple, Type, get_args
 
 from .._mock_table import BaseMockTable
-from .._types import BaseTypeConverter, is_struct_type
+from .._types import BaseTypeConverter, is_struct_type, is_union_type
 from .base import DatabaseAdapter
 
 
@@ -77,9 +77,9 @@ class PrestoBaseAdapter(DatabaseAdapter):
         """Convert Python type to SQL type string."""
         from .._sql_utils import get_sql_type_string
 
-        # Handle Optional types
-        if hasattr(python_type, "__origin__") and python_type.__origin__ is Union:
-            # Extract the non-None type from Optional[T]
+        # Handle Optional types (both Optional[X] and X | None)
+        if is_union_type(python_type):
+            # Extract the non-None type from Optional[T] or T | None
             non_none_types = [arg for arg in get_args(python_type) if arg is not type(None)]
             if non_none_types:
                 python_type = non_none_types[0]
@@ -164,8 +164,8 @@ class PrestoBaseAdapter(DatabaseAdapter):
 
             # Handle Optional types by extracting the non-None type for proper formatting
             actual_type = col_type
-            if hasattr(col_type, "__origin__") and col_type.__origin__ is Union:
-                # Extract the non-None type from Optional[T]
+            if is_union_type(col_type):
+                # Extract the non-None type from Optional[T] or T | None
                 non_none_types = [arg for arg in get_args(col_type) if arg is not type(None)]
                 if non_none_types:
                     actual_type = non_none_types[0]
@@ -186,8 +186,8 @@ class PrestoBaseAdapter(DatabaseAdapter):
 
                 # Handle Optional types by extracting the non-None type for proper formatting
                 actual_type = col_type
-                if hasattr(col_type, "__origin__") and col_type.__origin__ is Union:
-                    # Extract the non-None type from Optional[T]
+                if is_union_type(col_type):
+                    # Extract the non-None type from Optional[T] or T | None
                     non_none_types = [arg for arg in get_args(col_type) if arg is not type(None)]
                     if non_none_types:
                         actual_type = non_none_types[0]

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/src/sql_testing_library/_adapters/redshift.py

@@ -2,7 +2,7 @@
 
 from datetime import date, datetime
 from decimal import Decimal
-from typing import TYPE_CHECKING, Any, List, Optional, Tuple, Type, Union, get_args
+from typing import TYPE_CHECKING, Any, List, Optional, Tuple, Type, get_args
 
 
 if TYPE_CHECKING:
@@ -12,7 +12,7 @@ if TYPE_CHECKING:
 
 # Heavy import moved to function level for better performance
 from .._mock_table import BaseMockTable
-from .._types import BaseTypeConverter
+from .._types import BaseTypeConverter, is_union_type
 from .base import DatabaseAdapter
 
 
@@ -202,9 +202,9 @@ class RedshiftAdapter(DatabaseAdapter):
             # Generate column definitions
             column_defs = []
             for col_name, col_type in column_types.items():
-                # Handle Optional types
-                if hasattr(col_type, "__origin__") and col_type.__origin__ is Union:
-                    # Extract the non-None type from Optional[T]
+                # Handle Optional types (both Optional[X] and X | None)
+                if is_union_type(col_type):
+                    # Extract the non-None type from Optional[T] or T | None
                     non_none_types = [arg for arg in get_args(col_type) if arg is not type(None)]
                     if non_none_types:
                         col_type = non_none_types[0]

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/src/sql_testing_library/_adapters/snowflake.py

@@ -13,7 +13,6 @@ from typing import (
     Optional,
     Tuple,
     Type,
-    Union,
     get_args,
 )
 
@@ -23,7 +22,7 @@ if TYPE_CHECKING:
 
 # Heavy import moved to function level for better performance
 from .._mock_table import BaseMockTable
-from .._types import BaseTypeConverter
+from .._types import BaseTypeConverter, is_union_type
 from .base import DatabaseAdapter
 
 
@@ -364,9 +363,9 @@ class SnowflakeAdapter(DatabaseAdapter):
             # Generate column definitions
             column_defs = []
             for col_name, col_type in column_types.items():
-                # Handle Optional types
-                if hasattr(col_type, "__origin__") and col_type.__origin__ is Union:
-                    # Extract the non-None type from Optional[T]
+                # Handle Optional types (both Optional[X] and X | None)
+                if is_union_type(col_type):
+                    # Extract the non-None type from Optional[T] or T | None
                     non_none_types = [arg for arg in get_args(col_type) if arg is not type(None)]
                     if non_none_types:
                         col_type = non_none_types[0]

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/src/sql_testing_library/_mock_table.py

@@ -196,5 +196,11 @@ class BaseMockTable(ABC):
         return df
 
     def get_cte_alias(self) -> str:
-        """Get the CTE alias name (database__tablename)."""
-        return f"{self.get_database_name().replace('-', '_').replace('.', '_')}__{self.get_table_name()}"  # noqa: E501
+        """Get the CTE alias name (database__tablename).
+
+        Replaces '-' and '.' with '_' to ensure valid BigQuery CTE names,
+        as BigQuery CTEs cannot contain hyphens or dots.
+        """
+        db_name = self.get_database_name().replace("-", "_").replace(".", "_")
+        table_name = self.get_table_name().replace("-", "_").replace(".", "_")
+        return f"{db_name}__{table_name}"

{sql_testing_library-0.17.0 → sql_testing_library-0.19.0}/src/sql_testing_library/_types.py

@@ -29,6 +29,35 @@ except ImportError:
     pydantic_available = False
 
 
+def is_union_type(type_hint: Type) -> bool:
+    """Check if a type is a Union type (including Optional).
+
+    This function handles both:
+    - typing.Optional[X] / typing.Union[X, None] (Python 3.9+)
+    - X | None syntax (Python 3.10+)
+
+    Args:
+        type_hint: The type to check
+
+    Returns:
+        True if the type is a union type, False otherwise
+    """
+    origin = get_origin(type_hint)
+    if origin is None:
+        return False
+
+    # Handle typing.Union (used by Optional[X])
+    if origin is Union:
+        return True
+
+    # Handle types.UnionType (used by X | None in Python 3.10+)
+    # We check the name because types.UnionType may not be available in Python 3.9
+    if hasattr(origin, "__name__") and origin.__name__ == "UnionType":
+        return True
+
+    return False
+
+
 def is_pydantic_model_class(cls: Type) -> bool:
     """Check if a class is a Pydantic model class."""
     if not pydantic_available or BaseModel is None:
@@ -42,9 +71,9 @@ def is_pydantic_model_class(cls: Type) -> bool:
 
 def is_struct_type(type_hint: Type) -> bool:
     """Check if a type is a struct type (dataclass or Pydantic model)."""
-    # Handle Optional types
-    if hasattr(type_hint, "__origin__") and type_hint.__origin__ is Union:
-        # Extract the non-None type from Optional[T]
+    # Handle Optional types (both Optional[X] and X | None)
+    if is_union_type(type_hint):
+        # Extract the non-None type from Optional[T] or T | None
         non_none_types = [arg for arg in get_args(type_hint) if arg is not type(None)]
         if non_none_types:
             type_hint = non_none_types[0]
@@ -427,15 +456,17 @@ class BaseTypeConverter:
 
 
 def unwrap_optional_type(col_type: Type[Any]) -> Type[Any]:
-    """Unwrap Optional[T] to T, leave other types unchanged.
+    """Unwrap Optional[T] or T | None to T, leave other types unchanged.
 
     This is a utility function that can be used by adapters and mock tables
-    to handle Optional types consistently.
+    to handle Optional types consistently. Supports both:
+    - typing.Optional[T] / typing.Union[T, None] (Python 3.9+)
+    - T | None syntax (Python 3.10+)
     """
-    # Check if this is a Union type (which Optional[T] is)
-    if get_origin(col_type) is Union:
+    # Check if this is a Union type (which Optional[T] and T | None both are)
+    if is_union_type(col_type):
         args = get_args(col_type)
-        # Optional[T] is Union[T, None], so filter out NoneType
+        # Optional[T] or T | None is Union[T, None], so filter out NoneType
         non_none_types = [arg for arg in args if arg is not type(None)]
         if non_none_types:
             return cast(Type[Any], non_none_types[0])  # Return the first non-None type