sqlrules-mssql 1.0.0__py3-none-any.whl

sqlrules_mssql/__init__.py

@@ -0,0 +1,59 @@
+from __future__ import annotations
+
+from sqlrules.plugins import PLUGIN_API_VERSION
+from sqlrules.translators import TranslatorRegistry
+from sqlrules_mssql.json import translate_json_contains, translate_json_has_key
+from sqlrules_mssql.length import translate_max_length, translate_min_length
+from sqlrules_mssql.type_check import translate_type_check
+
+__version__ = "1.0.0"
+
+
+class MssqlPlugin:
+    """Register SQL Server constraint translators.
+
+    Does not register ``pattern`` — SQL Server has no portable regex operator
+    that SQLRules can emit deterministically. Provide a custom translator if
+    needed. ``type_check`` is registered with a limited approximation matrix.
+    """
+
+    name = "mssql"
+    api_version = PLUGIN_API_VERSION
+
+    def register(self, registry: TranslatorRegistry) -> None:
+        registry.register_constraint(
+            "min_length",
+            translate_min_length,
+            on_conflict="replace",
+        )
+        registry.register_constraint(
+            "max_length",
+            translate_max_length,
+            on_conflict="replace",
+        )
+        registry.register_constraint(
+            "type_check",
+            translate_type_check,
+            on_conflict="replace",
+        )
+        registry.register_constraint(
+            "json_contains",
+            translate_json_contains,
+            on_conflict="replace",
+        )
+        registry.register_constraint(
+            "json_has_key",
+            translate_json_has_key,
+            on_conflict="replace",
+        )
+
+
+__all__ = [
+    "MssqlPlugin",
+    "__version__",
+    "translate_json_contains",
+    "translate_json_has_key",
+    "translate_max_length",
+    "translate_min_length",
+    "translate_type_check",
+]

sqlrules_mssql/json.py

@@ -0,0 +1,125 @@
+from __future__ import annotations
+
+import json
+from typing import Any, cast
+
+from sqlalchemy import String, exists, func, literal, select, type_coerce
+from sqlalchemy import cast as sa_cast
+from sqlalchemy import column as sa_column
+from sqlalchemy.sql.elements import ColumnElement
+
+from sqlrules.ir import CompilationContext, Constraint
+
+
+def _json_path_for_key(key: Any) -> str:
+    """Build a JSONPath for a single object key (never a full-path escape hatch)."""
+    text = str(key)
+    # SQL Server JSON path quotes use doubled double-quotes inside the name.
+    escaped = text.replace('"', '""')
+    return f'$."{escaped}"'
+
+
+def _compact_dumps(value: Any) -> str:
+    return json.dumps(value, separators=(",", ":"))
+
+
+def _openjson_key_exists(
+    column: ColumnElement[Any],
+    key: str,
+    *,
+    json_type: str | None = None,
+) -> ColumnElement[bool]:
+    """True when OPENJSON lists ``key`` (optionally with a specific JSON type)."""
+    oj = (
+        func.openjson(column)
+        .table_valued(
+            sa_column("key", String),
+            sa_column("value", String),
+            sa_column("type", String),
+        )
+        .render_derived(name="oj", with_types=True)
+        .alias("oj")
+    )
+    predicate = oj.c.key == key
+    if json_type is not None:
+        predicate = predicate & (oj.c.type == json_type)
+    return cast(ColumnElement[bool], exists(select(1).select_from(oj).where(predicate)))
+
+
+def translate_json_contains(
+    constraint: Constraint,
+    column: ColumnElement[Any],
+    context: CompilationContext,
+) -> ColumnElement[bool]:
+    """Translate ``json_contains`` using SQL Server JSON functions.
+
+    Object payloads use shallow key checks via ``JSON_VALUE`` /
+    ``JSON_QUERY`` / ``OPENJSON``. Nested deep-merge containment is not
+    emulated.
+    """
+    value = constraint.value
+    if isinstance(value, dict):
+        if not value:
+            # Align with PostgreSQL ``@> '{}'``: require a non-NULL JSON object.
+            return cast(
+                ColumnElement[bool],
+                column.is_not(None)
+                & (func.isjson(column) == 1)
+                & func.json_query(column, "$").is_not(None),
+            )
+        parts: list[ColumnElement[bool]] = []
+        for key, expected in value.items():
+            path = _json_path_for_key(key)
+            key_text = str(key)
+            if expected is None:
+                parts.append(_openjson_key_exists(column, key_text, json_type="null"))
+            elif isinstance(expected, (dict, list)):
+                compact = _compact_dumps(expected)
+                parts.append(
+                    cast(
+                        ColumnElement[bool],
+                        func.json_query(column, path)
+                        == func.json_query(sa_cast(literal(compact), String), "$"),
+                    )
+                )
+            elif isinstance(expected, bool):
+                expected_text = "true" if expected else "false"
+                parts.append(
+                    cast(
+                        ColumnElement[bool],
+                        func.json_value(column, path) == literal(expected_text),
+                    )
+                )
+            elif isinstance(expected, str):
+                parts.append(
+                    cast(
+                        ColumnElement[bool],
+                        func.json_value(column, path) == literal(expected),
+                    )
+                )
+            else:
+                parts.append(
+                    cast(
+                        ColumnElement[bool],
+                        func.json_value(column, path) == literal(str(expected)),
+                    )
+                )
+        expression = parts[0]
+        for part in parts[1:]:
+            expression = expression & part
+        return cast(ColumnElement[bool], expression)
+
+    compact = _compact_dumps(value)
+    return cast(
+        ColumnElement[bool],
+        type_coerce(column, String) == func.json_query(sa_cast(literal(compact), String), "$"),
+    )
+
+
+def translate_json_has_key(
+    constraint: Constraint,
+    column: ColumnElement[Any],
+    context: CompilationContext,
+) -> ColumnElement[bool]:
+    """Translate ``json_has_key`` via ``OPENJSON`` key presence (includes JSON null)."""
+    return _openjson_key_exists(column, str(constraint.value))

sqlrules_mssql/length.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from typing import Any, cast
+
+from sqlalchemy import func, literal
+from sqlalchemy.sql.elements import ColumnElement
+
+from sqlrules.ir import CompilationContext, Constraint
+
+
+def _char_length(column: ColumnElement[Any]) -> ColumnElement[Any]:
+    """Character length including trailing spaces (``LEN`` alone strips them)."""
+    return func.len(column.concat(literal("."))) - 1
+
+
+def translate_min_length(
+    constraint: Constraint,
+    column: ColumnElement[Any],
+    context: CompilationContext,
+) -> ColumnElement[bool]:
+    """Override portable ``length`` with trailing-space-aware SQL Server length."""
+    return cast(ColumnElement[bool], _char_length(column) >= constraint.value)
+
+
+def translate_max_length(
+    constraint: Constraint,
+    column: ColumnElement[Any],
+    context: CompilationContext,
+) -> ColumnElement[bool]:
+    """Override portable ``length`` with trailing-space-aware SQL Server length."""
+    return cast(ColumnElement[bool], _char_length(column) <= constraint.value)

sqlrules_mssql/type_check.py

@@ -0,0 +1,232 @@
+from __future__ import annotations
+
+from datetime import date, datetime, time
+from decimal import Decimal
+from typing import Any, cast
+from uuid import UUID
+
+from sqlalchemy import Boolean, Date, DateTime, Float, Integer, Numeric, String, Time
+from sqlalchemy import cast as sa_cast
+from sqlalchemy.sql.elements import ColumnElement
+from sqlalchemy.sql.sqltypes import NullType
+from sqlalchemy.types import TypeEngine
+
+from sqlrules.constraints import type_spec
+from sqlrules.errors import UnsupportedConstraintError
+from sqlrules.ir import CompilationContext, Constraint, TypeSpec
+
+_UUID_LIKE = (
+    "[0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f]"
+    "[0-9A-Fa-f][0-9A-Fa-f]-"
+    "[0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f]-"
+    "[0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f]-"
+    "[0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f]-"
+    "[0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f]"
+    "[0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f][0-9A-Fa-f]"
+)
+
+
+def _is_type(column: ColumnElement[Any], *bases: type[TypeEngine[Any]]) -> bool:
+    col_type = column.type
+    if isinstance(col_type, NullType):
+        return False
+    return isinstance(col_type, bases)
+
+
+def _wrap_none(
+    column: ColumnElement[Any],
+    predicate: ColumnElement[bool],
+    *,
+    allow_none: bool,
+) -> ColumnElement[bool]:
+    if allow_none:
+        return cast(ColumnElement[bool], column.is_(None) | predicate)
+    return predicate
+
+
+def _unsupported(field: str, spec: TypeSpec, suggestion: str) -> None:
+    raise UnsupportedConstraintError(
+        field=field,
+        operator="type_check",
+        value=spec,
+        suggestion=suggestion,
+    )
+
+
+def _predicate_int(
+    column: ColumnElement[Any],
+    spec: TypeSpec,
+    field: str,
+) -> ColumnElement[bool]:
+    if _is_type(column, Integer):
+        return cast(ColumnElement[bool], column.isnot(None))
+    if spec.strict:
+        _unsupported(
+            field,
+            spec,
+            "SQL Server strict int type_check requires an Integer column.",
+        )
+    if _is_type(column, String):
+        unsigned = column.like("[0-9]%") & ~column.like("%[^0-9]%")
+        signed = column.like("[-+][0-9]%") & ~column.like("[-+]%[^0-9]%")
+        return cast(ColumnElement[bool], unsigned | signed)
+    if _is_type(column, Float, Numeric):
+        return cast(
+            ColumnElement[bool],
+            column == sa_cast(sa_cast(column, Integer), Float),
+        )
+    _unsupported(
+        field,
+        spec,
+        "SQL Server lax int type_check supports Integer, String, Float, or Numeric columns.",
+    )
+    raise AssertionError("unreachable")
+
+
+def _predicate_bool(
+    column: ColumnElement[Any],
+    spec: TypeSpec,
+    field: str,
+) -> ColumnElement[bool]:
+    if spec.strict:
+        if _is_type(column, Boolean, Integer):
+            return cast(ColumnElement[bool], column.in_((True, False, 0, 1)))
+        _unsupported(
+            field,
+            spec,
+            "SQL Server strict bool type_check requires a Boolean/Integer column.",
+        )
+    _unsupported(
+        field,
+        spec,
+        "SQL Server lax bool type_check is not supported. Use strict=True.",
+    )
+    raise AssertionError("unreachable")
+
+
+def _predicate_str(
+    column: ColumnElement[Any],
+    spec: TypeSpec,
+    field: str,
+) -> ColumnElement[bool]:
+    if _is_type(column, String):
+        return cast(ColumnElement[bool], column.isnot(None))
+    _unsupported(
+        field,
+        spec,
+        "SQL Server str type_check requires a String/Text column.",
+    )
+    raise AssertionError("unreachable")
+
+
+def _predicate_float(
+    column: ColumnElement[Any],
+    spec: TypeSpec,
+    field: str,
+) -> ColumnElement[bool]:
+    if _is_type(column, Float, Numeric, Integer):
+        return cast(ColumnElement[bool], column.isnot(None))
+    if spec.strict:
+        _unsupported(
+            field,
+            spec,
+            "SQL Server strict float/Decimal type_check requires a numeric column.",
+        )
+    if _is_type(column, String):
+        _unsupported(
+            field,
+            spec,
+            "SQL Server lax float/Decimal type_check on String columns is not "
+            "supported (no portable numeric shape check). Use a numeric column "
+            "or strict=True with Float/Numeric/Integer.",
+        )
+    _unsupported(
+        field,
+        spec,
+        "SQL Server float/Decimal type_check supports Float, Numeric, or Integer columns.",
+    )
+    raise AssertionError("unreachable")
+
+
+def _predicate_temporal(
+    column: ColumnElement[Any],
+    spec: TypeSpec,
+    field: str,
+    *,
+    sa_types: tuple[type[TypeEngine[Any]], ...],
+) -> ColumnElement[bool]:
+    if _is_type(column, *sa_types):
+        return cast(ColumnElement[bool], column.isnot(None))
+    type_name = spec.python_type.__name__
+    _unsupported(
+        field,
+        spec,
+        f"SQL Server {type_name} type_check requires a typed {type_name} column "
+        "(string date parsing is not emitted without a portable regex).",
+    )
+    raise AssertionError("unreachable")
+
+
+def _predicate_uuid(
+    column: ColumnElement[Any],
+    spec: TypeSpec,
+    field: str,
+) -> ColumnElement[bool]:
+    if "uuid" in type(column.type).__name__.lower():
+        return cast(ColumnElement[bool], column.isnot(None))
+    if spec.strict:
+        _unsupported(
+            field,
+            spec,
+            "SQL Server strict UUID type_check requires a UUID column.",
+        )
+    if _is_type(column, String):
+        return cast(ColumnElement[bool], column.like(_UUID_LIKE))
+    _unsupported(
+        field,
+        spec,
+        "SQL Server UUID type_check supports UUID or String columns.",
+    )
+    raise AssertionError("unreachable")
+
+
+def _build_predicate(
+    column: ColumnElement[Any],
+    spec: TypeSpec,
+    field: str,
+) -> ColumnElement[bool]:
+    python_type = spec.python_type
+    if python_type is int:
+        return _predicate_int(column, spec, field)
+    if python_type is bool:
+        return _predicate_bool(column, spec, field)
+    if python_type is str:
+        return _predicate_str(column, spec, field)
+    if python_type in {float, Decimal}:
+        return _predicate_float(column, spec, field)
+    if python_type is date:
+        return _predicate_temporal(column, spec, field, sa_types=(Date,))
+    if python_type is datetime:
+        return _predicate_temporal(column, spec, field, sa_types=(DateTime,))
+    if python_type is time:
+        return _predicate_temporal(column, spec, field, sa_types=(Time,))
+    if python_type is UUID:
+        return _predicate_uuid(column, spec, field)
+    _unsupported(
+        field,
+        spec,
+        f"SQL Server type_check has no translator for {python_type!r}.",
+    )
+    raise AssertionError("unreachable")
+
+
+def translate_type_check(
+    constraint: Constraint,
+    column: ColumnElement[Any],
+    context: CompilationContext,
+) -> ColumnElement[bool]:
+    """Translate ``type_check`` into SQL Server shape/type predicates."""
+    del context
+    spec = type_spec(constraint.value)
+    predicate = _build_predicate(column, spec, constraint.field)
+    return _wrap_none(column, predicate, allow_none=spec.allow_none)

sqlrules_mssql-1.0.0.dist-info/METADATA

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: sqlrules-mssql
+Version: 1.0.0
+Summary: SQL Server dialect plugin for SQLRules (JSON and LEN string ops).
+Project-URL: Homepage, https://github.com/eddiethedean/sqlrules
+Project-URL: Repository, https://github.com/eddiethedean/sqlrules
+Project-URL: Issues, https://github.com/eddiethedean/sqlrules/issues
+Author: SQLRules Contributors
+License-Expression: MIT
+License-File: LICENSE
+Keywords: mssql,pydantic,sqlalchemy,sqlrules,sqlserver
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: sqlalchemy<3,>=2.0
+Requires-Dist: sqlrules<2,>=1
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# sqlrules-mssql
+
+SQL Server dialect plugin for [SQLRules](https://github.com/eddiethedean/sqlrules).
+
+## Install
+
+```bash
+pip install sqlrules-mssql
+```
+
+## Usage
+
+```python
+from typing import Annotated, Any
+
+from pydantic import BaseModel, Field
+
+from sqlrules import Compiler, JsonContains, JsonHasKey
+from sqlrules_mssql import MssqlPlugin
+
+class RowFilter(BaseModel):
+    name: Annotated[str, Field(min_length=2, max_length=40)]
+    meta: Annotated[dict[str, Any], JsonContains({"active": True}), JsonHasKey("active")]
+
+compiler = Compiler(plugins=[MssqlPlugin()], dialect="mssql")
+```
+
+## Operators
+
+| IR operator | Notes |
+|---|---|
+| `min_length` / `max_length` | `LEN(column)` instead of portable `length()` |
+| `type_check` | Limited shape checks (typed columns; LIKE for some String forms) |
+| `json_contains` | Shallow `JSON_VALUE` / `JSON_QUERY` checks |
+| `json_has_key` | `JSON_VALUE` / `JSON_QUERY` IS NOT NULL |
+
+`pattern` is intentionally not registered — prefer a custom translator over
+guessing LIKE semantics.

sqlrules_mssql-1.0.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+sqlrules_mssql/__init__.py,sha256=vQ2s7iirF9f2ABu0MdxnpsPiKdAaHE82x_LfEHN5TFg,1735
+sqlrules_mssql/json.py,sha256=hf1oSKv2HTJkMT2H3tCYiBlW-AUdNWaj8s-Z_hwonZs,4328
+sqlrules_mssql/length.py,sha256=pHsdRQO_T2bM_zeldbWV4sna3DiwdfBDXMeGbc5elv8,1034
+sqlrules_mssql/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+sqlrules_mssql/type_check.py,sha256=fgae3S5QVfJ0655c7DfkAUQiDriVwmlGXsKb72yt9SU,7191
+sqlrules_mssql-1.0.0.dist-info/METADATA,sha256=04Fyfprle2CLZHSddMDwzAG0NkYLXQvG0qEjLMRGGbY,1871
+sqlrules_mssql-1.0.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+sqlrules_mssql-1.0.0.dist-info/licenses/LICENSE,sha256=cLMlkCH6RhjWAkXBWR7LazV98TOG0WkPtCKB5zqqkAs,1078
+sqlrules_mssql-1.0.0.dist-info/RECORD,,

sqlrules_mssql-1.0.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

sqlrules_mssql-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 SQLRules Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.