rhosocial-activerecord-postgres 1.0.0.dev3__tar.gz → 1.0.0.dev4__tar.gz

{rhosocial_activerecord_postgres-1.0.0.dev3 → rhosocial_activerecord_postgres-1.0.0.dev4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rhosocial_activerecord_postgres
-Version: 1.0.0.dev3
+Version: 1.0.0.dev4
 Summary: postgres backend implementation for rhosocial-activerecord, providing a robust and optimized postgres database support.
 Author-email: vistart <i@vistart.me>
 License:                                  Apache License
@@ -447,15 +447,30 @@ print(user.id)  # Populated automatically via RETURNING
 | Feature | Min Version | Notes |
 |---------|-------------|-------|
 | Basic operations | 8.0+ | Core functionality |
+| RETURNING | 8.2+ | INSERT/UPDATE/DELETE RETURNING |
 | CTEs | 8.4+ | WITH clauses |
 | Window functions | 8.4+ | ROW_NUMBER, RANK, etc. |
-| RETURNING | 8.2+ | INSERT/UPDATE/DELETE RETURNING |
+| TRUNCATE RESTART IDENTITY | 8.4+ | Reset sequences on truncate |
 | JSON | 9.2+ | Basic JSON support |
+| LATERAL joins | 9.3+ | LATERAL keyword |
 | JSONB | 9.4+ | Binary JSON, indexed |
+| FILTER clause | 9.4+ | Aggregate FILTER |
+| Ordered-set aggregates | 9.4+ | PERCENTILE_CONT, etc. |
 | UPSERT | 9.5+ | INSERT ... ON CONFLICT |
+| Advanced grouping | 9.5+ | ROLLUP, CUBE, GROUPING SETS |
+| SKIP LOCKED | 9.5+ | FOR UPDATE SKIP LOCKED |
+| MATERIALIZED CTE hints | 12.0+ | MATERIALIZED/NOT MATERIALIZED |
+| JSON_TABLE | 12.0+ | JSON table function |
+| MERGE | 15.0+ | MERGE statement |
+
+**Supported SQL Protocols:**
+- ✅ SetOperationSupport (UNION, INTERSECT, EXCEPT) — All versions
+- ✅ TruncateSupport (TRUNCATE TABLE) — All versions; RESTART IDENTITY ≥ 8.4
 
 **Recommended**: PostgreSQL 12+ for optimal feature support.
 
+See [PROTOCOL_SUPPORT.md](docs/PROTOCOL_SUPPORT.md) for complete protocol support matrix.
+
 ## Get Started with AI Code Agents
 
 This project supports AI-assisted development:

{rhosocial_activerecord_postgres-1.0.0.dev3 → rhosocial_activerecord_postgres-1.0.0.dev4}/README.md

@@ -196,15 +196,30 @@ print(user.id)  # Populated automatically via RETURNING
 | Feature | Min Version | Notes |
 |---------|-------------|-------|
 | Basic operations | 8.0+ | Core functionality |
+| RETURNING | 8.2+ | INSERT/UPDATE/DELETE RETURNING |
 | CTEs | 8.4+ | WITH clauses |
 | Window functions | 8.4+ | ROW_NUMBER, RANK, etc. |
-| RETURNING | 8.2+ | INSERT/UPDATE/DELETE RETURNING |
+| TRUNCATE RESTART IDENTITY | 8.4+ | Reset sequences on truncate |
 | JSON | 9.2+ | Basic JSON support |
+| LATERAL joins | 9.3+ | LATERAL keyword |
 | JSONB | 9.4+ | Binary JSON, indexed |
+| FILTER clause | 9.4+ | Aggregate FILTER |
+| Ordered-set aggregates | 9.4+ | PERCENTILE_CONT, etc. |
 | UPSERT | 9.5+ | INSERT ... ON CONFLICT |
+| Advanced grouping | 9.5+ | ROLLUP, CUBE, GROUPING SETS |
+| SKIP LOCKED | 9.5+ | FOR UPDATE SKIP LOCKED |
+| MATERIALIZED CTE hints | 12.0+ | MATERIALIZED/NOT MATERIALIZED |
+| JSON_TABLE | 12.0+ | JSON table function |
+| MERGE | 15.0+ | MERGE statement |
+
+**Supported SQL Protocols:**
+- ✅ SetOperationSupport (UNION, INTERSECT, EXCEPT) — All versions
+- ✅ TruncateSupport (TRUNCATE TABLE) — All versions; RESTART IDENTITY ≥ 8.4
 
 **Recommended**: PostgreSQL 12+ for optimal feature support.
 
+See [PROTOCOL_SUPPORT.md](docs/PROTOCOL_SUPPORT.md) for complete protocol support matrix.
+
 ## Get Started with AI Code Agents
 
 This project supports AI-assisted development:

{rhosocial_activerecord_postgres-1.0.0.dev3 → rhosocial_activerecord_postgres-1.0.0.dev4}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "rhosocial_activerecord_postgres"
-version = "1.0.0.dev3"
+version = "1.0.0.dev4"
 description = "postgres backend implementation for rhosocial-activerecord, providing a robust and optimized postgres database support."
 readme = "README.md"
 license = { file = "LICENSE" }

rhosocial_activerecord_postgres-1.0.0.dev4/src/rhosocial/activerecord/backend/impl/postgres/__init__.py

@@ -0,0 +1,346 @@
+# src/rhosocial/activerecord/backend/impl/postgres/__init__.py
+"""
+PostgreSQL backend implementation for the Python ORM.
+
+This module provides:
+- PostgreSQL synchronous backend with connection management and query execution
+- PostgreSQL asynchronous backend with async/await support
+- PostgreSQL-specific connection configuration
+- Type mapping and value conversion
+- Transaction management with savepoint support (sync and async)
+- PostgreSQL dialect and expression handling
+- PostgreSQL-specific type definitions and mappings
+
+Architecture:
+- PostgreSQLBackend: Synchronous implementation using psycopg
+- AsyncPostgreSQLBackend: Asynchronous implementation using psycopg
+- Independent from ORM frameworks - uses only native drivers
+"""
+
+from .backend import PostgresBackend, AsyncPostgresBackend
+from .config import PostgresConnectionConfig
+from .dialect import PostgresDialect
+from .transaction import PostgresTransactionManager, AsyncPostgresTransactionManager
+from .types import PostgresEnumType
+from .statements import (
+    CreateEnumTypeExpression,
+    DropEnumTypeExpression,
+    AlterEnumTypeAddValueExpression,
+    AlterEnumTypeRenameValueExpression,
+    CreateRangeTypeExpression,
+)
+from .adapters import (
+    PostgresEnumAdapter,
+    PostgresRangeAdapter,
+    PostgresMultirangeAdapter,
+)
+from .types.range import (
+    PostgresRange,
+    PostgresMultirange,
+)
+from .types.geometric import (
+    Point,
+    Line,
+    LineSegment,
+    Box,
+    Path,
+    Polygon,
+    Circle,
+)
+from .adapters.geometric import PostgresGeometryAdapter
+from .types.bit_string import PostgresBitString
+from .adapters.bit_string import PostgresBitStringAdapter
+from .types.monetary import PostgresMoney
+from .adapters.monetary import PostgresMoneyAdapter
+from .types.xml import PostgresXML
+from .adapters.xml import PostgresXMLAdapter
+from .types.network_address import PostgresMacaddr, PostgresMacaddr8
+from .adapters.network_address import PostgresMacaddrAdapter, PostgresMacaddr8Adapter
+from .types.text_search import (
+    PostgresTsVector,
+    PostgresTsQuery,
+    to_tsvector,
+    to_tsquery,
+    plainto_tsquery,
+    phraseto_tsquery,
+    websearch_to_tsquery,
+    ts_matches,
+    ts_matches_expr,
+    ts_rank,
+    ts_rank_cd,
+    ts_headline,
+    tsvector_concat,
+    tsvector_strip,
+    tsvector_setweight,
+    tsvector_length,
+)
+from .adapters.text_search import PostgresTsVectorAdapter, PostgresTsQueryAdapter
+from .types.pg_lsn import PostgresLsn
+from .adapters.pg_lsn import PostgresLsnAdapter
+from .types.object_identifier import (
+    OID,
+    RegClass,
+    RegType,
+    RegProc,
+    RegProcedure,
+    RegOper,
+    RegOperator,
+    RegConfig,
+    RegDictionary,
+    RegNamespace,
+    RegRole,
+    RegCollation,
+    XID,
+    XID8,
+    CID,
+    TID,
+)
+from .adapters.object_identifier import PostgresOidAdapter, PostgresXidAdapter, PostgresTidAdapter
+from .types.json import PostgresJsonPath
+from .adapters.json import PostgresJsonPathAdapter
+from .types.enum import EnumTypeManager
+
+# Import functions from functions module
+from .functions import (
+    # Range functions
+    range_contains,
+    range_contained_by,
+    range_contains_range,
+    range_overlaps,
+    range_adjacent,
+    range_strictly_left_of,
+    range_strictly_right_of,
+    range_not_extend_right,
+    range_not_extend_left,
+    range_union,
+    range_intersection,
+    range_difference,
+    range_lower,
+    range_upper,
+    range_is_empty,
+    range_lower_inc,
+    range_upper_inc,
+    range_lower_inf,
+    range_upper_inf,
+    # Geometry functions
+    geometry_distance,
+    geometry_contains,
+    geometry_contained_by,
+    geometry_overlaps,
+    geometry_strictly_left,
+    geometry_strictly_right,
+    geometry_not_extend_right,
+    geometry_not_extend_left,
+    geometry_area,
+    geometry_center,
+    geometry_length,
+    geometry_width,
+    geometry_height,
+    geometry_npoints,
+    # Enum functions
+    enum_range,
+    enum_first,
+    enum_last,
+    enum_lt,
+    enum_le,
+    enum_gt,
+    enum_ge,
+    # Bit string functions
+    bit_concat,
+    bit_and,
+    bit_or,
+    bit_xor,
+    bit_not,
+    bit_shift_left,
+    bit_shift_right,
+    bit_length,
+    bit_length_func,
+    bit_octet_length,
+    bit_get_bit,
+    bit_set_bit,
+    bit_count,
+    # JSON functions
+    json_path_root,
+    json_path_key,
+    json_path_index,
+    json_path_wildcard,
+    json_path_filter,
+    jsonb_path_query,
+    jsonb_path_query_first,
+    jsonb_path_exists,
+    jsonb_path_match,
+)
+
+
+__all__ = [
+    # Synchronous Backend
+    'PostgresBackend',
+
+    # Asynchronous Backend
+    'AsyncPostgresBackend',
+
+    # Configuration
+    'PostgresConnectionConfig',
+
+    # Dialect related
+    'PostgresDialect',
+
+    # Transaction - Sync and Async
+    'PostgresTransactionManager',
+    'AsyncPostgresTransactionManager',
+
+    # PostgreSQL-specific Type Helpers
+    'PostgresEnumType',
+    'PostgresEnumAdapter',
+
+    # PostgreSQL DDL Statements
+    'CreateEnumTypeExpression',
+    'DropEnumTypeExpression',
+    'AlterEnumTypeAddValueExpression',
+    'AlterEnumTypeRenameValueExpression',
+    'CreateRangeTypeExpression',
+
+    # Range Types
+    'PostgresRange',
+    'PostgresRangeAdapter',
+    'PostgresMultirange',
+    'PostgresMultirangeAdapter',
+    'range_contains',
+    'range_contained_by',
+    'range_contains_range',
+    'range_overlaps',
+    'range_adjacent',
+    'range_strictly_left_of',
+    'range_strictly_right_of',
+    'range_not_extend_right',
+    'range_not_extend_left',
+    'range_union',
+    'range_intersection',
+    'range_difference',
+    'range_lower',
+    'range_upper',
+    'range_is_empty',
+    'range_lower_inc',
+    'range_upper_inc',
+    'range_lower_inf',
+    'range_upper_inf',
+
+    # Geometry Types
+    'Point',
+    'Line',
+    'LineSegment',
+    'Box',
+    'Path',
+    'Polygon',
+    'Circle',
+    'PostgresGeometryAdapter',
+    'geometry_distance',
+    'geometry_contains',
+    'geometry_contained_by',
+    'geometry_overlaps',
+    'geometry_strictly_left',
+    'geometry_strictly_right',
+    'geometry_not_extend_right',
+    'geometry_not_extend_left',
+    'geometry_area',
+    'geometry_center',
+    'geometry_length',
+    'geometry_width',
+    'geometry_height',
+    'geometry_npoints',
+
+    # Bit String Types
+    'PostgresBitString',
+    'PostgresBitStringAdapter',
+    'bit_concat',
+    'bit_and',
+    'bit_or',
+    'bit_xor',
+    'bit_not',
+    'bit_shift_left',
+    'bit_shift_right',
+    'bit_length',
+    'bit_length_func',
+    'bit_octet_length',
+    'bit_get_bit',
+    'bit_set_bit',
+    'bit_count',
+
+    # Enum Types
+    'EnumTypeManager',
+    'enum_range',
+    'enum_first',
+    'enum_last',
+    'enum_lt',
+    'enum_le',
+    'enum_gt',
+    'enum_ge',
+
+    # Money Type
+    'PostgresMoney',
+    'PostgresMoneyAdapter',
+
+    # XML Type
+    'PostgresXML',
+    'PostgresXMLAdapter',
+
+    # MACADDR Types
+    'PostgresMacaddr',
+    'PostgresMacaddrAdapter',
+    'PostgresMacaddr8',
+    'PostgresMacaddr8Adapter',
+
+    # Text Search Types
+    'PostgresTsVector',
+    'PostgresTsVectorAdapter',
+    'PostgresTsQuery',
+    'PostgresTsQueryAdapter',
+    'to_tsvector',
+    'to_tsquery',
+    'plainto_tsquery',
+    'phraseto_tsquery',
+    'websearch_to_tsquery',
+    'ts_matches',
+    'ts_matches_expr',
+    'ts_rank',
+    'ts_rank_cd',
+    'ts_headline',
+    'tsvector_concat',
+    'tsvector_strip',
+    'tsvector_setweight',
+    'tsvector_length',
+
+    # LSN Type
+    'PostgresLsn',
+    'PostgresLsnAdapter',
+
+    # OID Types
+    'OID',
+    'RegClass',
+    'RegType',
+    'RegProc',
+    'RegProcedure',
+    'RegOper',
+    'RegOperator',
+    'RegConfig',
+    'RegDictionary',
+    'RegNamespace',
+    'RegRole',
+    'RegCollation',
+    'XID',
+    'XID8',
+    'CID',
+    'TID',
+    'PostgresOidAdapter',
+    'PostgresXidAdapter',
+    'PostgresTidAdapter',
+
+    # JSON Path Type
+    'PostgresJsonPath',
+    'PostgresJsonPathAdapter',
+    'json_path_root',
+    'json_path_key',
+    'json_path_index',
+    'json_path_wildcard',
+    'json_path_filter',
+]

rhosocial_activerecord_postgres-1.0.0.dev4/src/rhosocial/activerecord/backend/impl/postgres/adapters/__init__.py

@@ -0,0 +1,117 @@
+# src/rhosocial/activerecord/backend/impl/postgres/adapters/__init__.py
+"""
+PostgreSQL type adapters.
+
+This module exports all type adapters for PostgreSQL-specific types,
+organized according to PostgreSQL documentation structure.
+
+PostgreSQL Documentation: https://www.postgresql.org/docs/current/datatype.html
+
+Adapter modules and their corresponding PostgreSQL documentation:
+- base: Basic types (array, jsonb, network address, enum)
+- monetary: MONEY type - https://www.postgresql.org/docs/current/datatype-money.html
+- network_address: Network address types (inet, cidr, macaddr, macaddr8) - https://www.postgresql.org/docs/current/datatype-net-types.html
+- geometric: Geometric types (point, line, lseg, box, path, polygon, circle) - https://www.postgresql.org/docs/current/datatype-geometric.html
+- bit_string: Bit string types (bit, varbit) - https://www.postgresql.org/docs/current/datatype-bit.html
+- text_search: Text search types (tsvector, tsquery) - https://www.postgresql.org/docs/current/datatype-textsearch.html
+- object_identifier: Object identifier types (oid, regclass, etc.) - https://www.postgresql.org/docs/current/datatype-oid.html
+- json: JSON types (json, jsonb, jsonpath) - https://www.postgresql.org/docs/current/datatype-json.html
+- range: Range types - https://www.postgresql.org/docs/current/rangetypes.html
+- enum: Enum types - https://www.postgresql.org/docs/current/datatype-enum.html
+- xml: XML type - https://www.postgresql.org/docs/current/datatype-xml.html
+- pg_lsn: pg_lsn type - https://www.postgresql.org/docs/current/datatype-pg-lsn.html
+"""
+
+# Base types
+from .base import (
+    PostgresListAdapter,
+    PostgresJSONBAdapter,
+    PostgresEnumAdapter,
+)
+
+# Monetary types
+from .monetary import PostgresMoneyAdapter
+
+# Network address types
+from .network_address import (
+    PostgresNetworkAddressAdapter,
+    PostgresMacaddrAdapter,
+    PostgresMacaddr8Adapter,
+)
+
+# Geometric types
+from .geometric import PostgresGeometryAdapter
+
+# Bit string types
+from .bit_string import PostgresBitStringAdapter
+
+# Text search types
+from .text_search import (
+    PostgresTsVectorAdapter,
+    PostgresTsQueryAdapter,
+)
+
+# Object identifier types
+from .object_identifier import (
+    PostgresOidAdapter,
+    PostgresXidAdapter,
+    PostgresTidAdapter,
+)
+
+# JSON types
+from .json import PostgresJsonPathAdapter
+
+# Range types
+from .range import (
+    PostgresRangeAdapter,
+    PostgresMultirangeAdapter,
+)
+
+# pg_lsn type
+from .pg_lsn import PostgresLsnAdapter
+
+# XML type
+from .xml import PostgresXMLAdapter
+
+__all__ = [
+    # Basic types
+    'PostgresListAdapter',
+    'PostgresJSONBAdapter',
+    'PostgresNetworkAddressAdapter',
+    'PostgresEnumAdapter',
+
+    # Monetary types
+    'PostgresMoneyAdapter',
+
+    # Network address types
+    'PostgresMacaddrAdapter',
+    'PostgresMacaddr8Adapter',
+
+    # Geometric types
+    'PostgresGeometryAdapter',
+
+    # Bit string types
+    'PostgresBitStringAdapter',
+
+    # Text search types
+    'PostgresTsVectorAdapter',
+    'PostgresTsQueryAdapter',
+
+    # Object identifier types
+    'PostgresOidAdapter',
+    'PostgresXidAdapter',
+    'PostgresTidAdapter',
+
+    # JSON types
+    'PostgresJsonPathAdapter',
+
+    # Range types
+    'PostgresRangeAdapter',
+    'PostgresMultirangeAdapter',
+
+    # pg_lsn type
+    'PostgresLsnAdapter',
+
+    # XML type
+    'PostgresXMLAdapter',
+]

rhosocial_activerecord_postgres-1.0.0.dev3/src/rhosocial/activerecord/backend/impl/postgres/adapters.py → rhosocial_activerecord_postgres-1.0.0.dev4/src/rhosocial/activerecord/backend/impl/postgres/adapters/base.py

@@ -1,14 +1,16 @@
-# src/rhosocial/activerecord/backend/impl/postgres/adapters.py
-import datetime
+# src/rhosocial/activerecord/backend/impl/postgres/adapters/base.py
+"""
+Base PostgreSQL type adapters.
+
+This module contains basic type adapters for PostgreSQL.
+"""
 import json
-import uuid
-from decimal import Decimal
-from typing import Any, Dict, List, Type, Union, Optional
+from enum import Enum as PythonEnum
+from typing import Any, Dict, List, Type, Union, Optional, Set
 
 from psycopg.types.json import Jsonb
 
 from rhosocial.activerecord.backend.type_adapter import SQLTypeAdapter
-from rhosocial.activerecord.backend.schema import DatabaseType
 
 
 class PostgresListAdapter(SQLTypeAdapter):
@@ -108,3 +110,106 @@ class PostgresNetworkAddressAdapter(SQLTypeAdapter):
                 return ipaddress.ip_network(value)
             except (ImportError, ValueError):
                 return value
+
+
+class PostgresEnumAdapter(SQLTypeAdapter):
+    """PostgreSQL ENUM type adapter.
+
+    This adapter handles conversion between Python values and PostgreSQL enum values.
+
+    The adapter can work with:
+    - String values (validated against enum type)
+    - Python Enum instances
+    - None (NULL)
+    """
+
+    @property
+    def supported_types(self) -> Dict[Type, Set[Type]]:
+        """Return supported type mappings."""
+        return {str: {str}}
+
+    def to_database(
+        self,
+        value: Any,
+        target_type: Type,
+        options: Optional[Dict[str, Any]] = None
+    ) -> Optional[str]:
+        """Convert Python value to PostgreSQL enum value.
+
+        Args:
+            value: String, Python Enum, or None
+            target_type: Target type (not used for enums)
+            options: Optional conversion options
+                - 'enum_type': PostgresEnumType for validation
+
+        Returns:
+            Enum value string, or None
+        """
+        if value is None:
+            return None
+
+        # Handle Python Enum
+        if isinstance(value, PythonEnum):
+            result = value.name
+        elif isinstance(value, str):
+            result = value
+        else:
+            raise TypeError(f"Cannot convert {type(value).__name__} to enum value")
+
+        # Validate if enum_type provided
+        if options and 'enum_type' in options:
+            from ..types import PostgresEnumType
+            enum_type = options['enum_type']
+            if isinstance(enum_type, PostgresEnumType):
+                if not enum_type.validate_value(result):
+                    raise ValueError(f"Invalid enum value: '{result}'")
+
+        return result
+
+    def from_database(
+        self,
+        value: Any,
+        target_type: Type,
+        options: Optional[Dict[str, Any]] = None
+    ) -> Optional[str]:
+        """Convert PostgreSQL enum value to Python string.
+
+        Args:
+            value: Enum value from database
+            target_type: Target Python type
+            options: Optional conversion options
+                - 'enum_class': Python Enum class to convert to
+
+        Returns:
+            String value, Python Enum instance, or None
+        """
+        if value is None:
+            return None
+
+        # If already a string, check if we should convert to Python Enum
+        if isinstance(value, str):
+            if options and 'enum_class' in options:
+                enum_class = options['enum_class']
+                if issubclass(enum_class, PythonEnum):
+                    return enum_class[value]
+            return value
+
+        raise TypeError(f"Cannot convert {type(value).__name__} from enum")
+
+    def to_database_batch(
+        self,
+        values: List[Any],
+        target_type: Type,
+        options: Optional[Dict[str, Any]] = None
+    ) -> List[Any]:
+        """Batch convert values to database format."""
+        return [self.to_database(v, target_type, options) for v in values]
+
+    def from_database_batch(
+        self,
+        values: List[Any],
+        target_type: Type,
+        options: Optional[Dict[str, Any]] = None
+    ) -> List[Any]:
+        """Batch convert values from database format."""
+        return [self.from_database(v, target_type, options) for v in values]