macss-modular-api-sqlserver 0.4.7__tar.gz → 0.6.0__tar.gz

{macss_modular_api_sqlserver-0.4.7 → macss_modular_api_sqlserver-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: macss-modular-api-sqlserver
-Version: 0.4.7
+Version: 0.6.0
 Summary: Official MACSS SQL Server integration package for Python.
 Author: ccisne.dev
 License-Expression: MIT
@@ -56,10 +56,12 @@ else:
 
 See [example/example.py](example/example.py) for a complete in-memory wiring sample.
 
-## Current slice
+## What this package provides
 
 - normalized SQL Server connection defaults and redacted summaries
 - engine-agnostic `DbClient`, `DbRepository`, and transaction contracts
 - explicit lease ownership semantics for package-owned and application-owned sessions
 - health contributor and GraphQL support bundle for higher-level integrations
-- real driver bindings intentionally remain outside this first slice
+- the application supplies the driver binding (adapter) for its chosen engine and driver
+
+This package is **contracts-only by design** and will never ship a driver binding; you choose your engine and driver and provide the adapter. See [ADR-0004](../../../docs/adr/0004-contracts-only-database-packages.md).

{macss_modular_api_sqlserver-0.4.7 → macss_modular_api_sqlserver-0.6.0}/README.md

@@ -32,10 +32,12 @@ else:
 
 See [example/example.py](example/example.py) for a complete in-memory wiring sample.
 
-## Current slice
+## What this package provides
 
 - normalized SQL Server connection defaults and redacted summaries
 - engine-agnostic `DbClient`, `DbRepository`, and transaction contracts
 - explicit lease ownership semantics for package-owned and application-owned sessions
 - health contributor and GraphQL support bundle for higher-level integrations
-- real driver bindings intentionally remain outside this first slice
+- the application supplies the driver binding (adapter) for its chosen engine and driver
+
+This package is **contracts-only by design** and will never ship a driver binding; you choose your engine and driver and provide the adapter. See [ADR-0004](../../../docs/adr/0004-contracts-only-database-packages.md).

{macss_modular_api_sqlserver-0.4.7 → macss_modular_api_sqlserver-0.6.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "macss-modular-api-sqlserver"
-version = "0.4.7"
+version = "0.6.0"
 description = "Official MACSS SQL Server integration package for Python."
 readme = "README.md"
 license = "MIT"

{macss_modular_api_sqlserver-0.4.7 → macss_modular_api_sqlserver-0.6.0}/src/macss_modular_api_sqlserver.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: macss-modular-api-sqlserver
-Version: 0.4.7
+Version: 0.6.0
 Summary: Official MACSS SQL Server integration package for Python.
 Author: ccisne.dev
 License-Expression: MIT
@@ -56,10 +56,12 @@ else:
 
 See [example/example.py](example/example.py) for a complete in-memory wiring sample.
 
-## Current slice
+## What this package provides
 
 - normalized SQL Server connection defaults and redacted summaries
 - engine-agnostic `DbClient`, `DbRepository`, and transaction contracts
 - explicit lease ownership semantics for package-owned and application-owned sessions
 - health contributor and GraphQL support bundle for higher-level integrations
-- real driver bindings intentionally remain outside this first slice
+- the application supplies the driver binding (adapter) for its chosen engine and driver
+
+This package is **contracts-only by design** and will never ship a driver binding; you choose your engine and driver and provide the adapter. See [ADR-0004](../../../docs/adr/0004-contracts-only-database-packages.md).

{macss_modular_api_sqlserver-0.4.7 → macss_modular_api_sqlserver-0.6.0}/src/modular_api_sqlserver/__init__.py

@@ -14,6 +14,9 @@ from .db_client import (
     DbHealthContributor,
     DbHealthReport,
     DbHealthStatus,
+    DbParameter,
+    DbParameterDirection,
+    DbProcedureOutcome,
     DbProviderDescription,
     DbRepository,
     DbRepositoryContext,
@@ -40,6 +43,9 @@ __all__ = [
     "DbHealthContributor",
     "DbHealthReport",
     "DbHealthStatus",
+    "DbParameter",
+    "DbParameterDirection",
+    "DbProcedureOutcome",
     "DbProviderDescription",
     "DbRepository",
     "DbRepositoryContext",

{macss_modular_api_sqlserver-0.4.7 → macss_modular_api_sqlserver-0.6.0}/src/modular_api_sqlserver/db_client.py

@@ -17,6 +17,13 @@ class DbCommandKind(str, Enum):
     EXECUTE = "execute"
     BATCH = "batch"
     SCALAR = "scalar"
+    PROCEDURE = "procedure"
+
+
+class DbParameterDirection(str, Enum):
+    INPUT = "input"
+    OUTPUT = "output"
+    INPUT_OUTPUT = "inputOutput"
 
 
 class DbFailureKind(str, Enum):
@@ -84,6 +91,39 @@ class DbConnectionSettings:
         )
 
 
+@dataclass(frozen=True, slots=True)
+class DbParameter:
+    name: str
+    value: object | None = None
+    direction: DbParameterDirection = DbParameterDirection.INPUT
+    type_hint: str | None = None
+
+    @classmethod
+    def input(cls, name: str, value: object | None, type_hint: str | None = None) -> DbParameter:
+        return cls(name=name, value=value, direction=DbParameterDirection.INPUT, type_hint=type_hint)
+
+    @classmethod
+    def output(cls, name: str, type_hint: str | None = None) -> DbParameter:
+        return cls(name=name, direction=DbParameterDirection.OUTPUT, type_hint=type_hint)
+
+    @classmethod
+    def input_output(
+        cls, name: str, value: object | None, type_hint: str | None = None
+    ) -> DbParameter:
+        return cls(
+            name=name,
+            value=value,
+            direction=DbParameterDirection.INPUT_OUTPUT,
+            type_hint=type_hint,
+        )
+
+
+@dataclass(frozen=True, slots=True)
+class DbProcedureOutcome:
+    return_value: object | None = None
+    output_parameters: Mapping[str, object] | None = None
+
+
 @dataclass(frozen=True, slots=True)
 class DbCommand:
     kind: DbCommandKind
@@ -104,12 +144,14 @@ class DbExecutionMetadata:
 class DbRowSet:
     rows: list[Mapping[str, object]]
     metadata: DbExecutionMetadata
+    procedure: DbProcedureOutcome | None = None
 
 
 @dataclass(frozen=True, slots=True)
 class DbExecutionSummary:
     affected_count: int
     metadata: DbExecutionMetadata
+    procedure: DbProcedureOutcome | None = None
 
 
 @dataclass(frozen=True, slots=True)

{macss_modular_api_sqlserver-0.4.7 → macss_modular_api_sqlserver-0.6.0}/tests/test_db_client.py

@@ -16,6 +16,9 @@ from modular_api_sqlserver import (
     DbGraphqlSupport,
     DbHealthContributor,
     DbHealthStatus,
+    DbParameter,
+    DbParameterDirection,
+    DbProcedureOutcome,
     DbProviderDescription,
     DbRepository,
     DbRepositoryContext,
@@ -473,4 +476,98 @@ class _UserStatsRepository(DbRepository[str]):
                 label="users.count",
             )
         )
-        return result.map(lambda value: int(value.value))
+        return result.map(lambda value: int(value.value))
+
+
+# --- 0.6.0: typed parameters and stored-procedure support ---
+
+
+def test_db_parameter_input_captures_name_value_and_optional_type_hint() -> None:
+    plain = DbParameter.input("id", 42)
+    assert plain.name == "id"
+    assert plain.value == 42
+    assert plain.direction is DbParameterDirection.INPUT
+    assert plain.type_hint is None
+
+    hinted = DbParameter.input("picture", b"\x01\x02\x03", "varbinary(max)")
+    assert hinted.direction is DbParameterDirection.INPUT
+    assert hinted.type_hint == "varbinary(max)"
+
+
+def test_db_parameter_output_carries_no_input_value_and_defaults_direction() -> None:
+    out = DbParameter.output("total", "int")
+    assert out.name == "total"
+    assert out.value is None
+    assert out.direction is DbParameterDirection.OUTPUT
+    assert out.type_hint == "int"
+
+
+def test_db_parameter_input_output_marks_bidirectional_parameters() -> None:
+    io = DbParameter.input_output("counter", 1, "int")
+    assert io.direction is DbParameterDirection.INPUT_OUTPUT
+    assert io.value == 1
+
+
+def test_db_parameter_defaults_direction_to_input_when_constructed_directly() -> None:
+    param = DbParameter(name="name", value="foto.jpg")
+    assert param.direction is DbParameterDirection.INPUT
+
+
+def test_db_parameter_flows_through_db_command_parameters_unchanged() -> None:
+    command = DbCommand(
+        kind=DbCommandKind.PROCEDURE,
+        text="spEliminarFoto",
+        parameters=(DbParameter.input("nombre", "foto.jpg"), "positional-still-allowed"),
+    )
+    assert len(command.parameters) == 2
+    assert isinstance(command.parameters[0], DbParameter)
+    assert command.parameters[0].name == "nombre"
+    assert command.parameters[1] == "positional-still-allowed"
+
+
+def test_db_command_kind_exposes_procedure() -> None:
+    assert DbCommandKind.PROCEDURE.value == "procedure"
+
+
+def test_db_procedure_outcome_carries_return_value_and_output_parameters() -> None:
+    outcome = DbProcedureOutcome(return_value=0, output_parameters={"total": 5})
+    assert outcome.return_value == 0
+    assert outcome.output_parameters == {"total": 5}
+
+
+def test_db_procedure_outcome_allows_both_fields_to_be_absent() -> None:
+    empty = DbProcedureOutcome()
+    assert empty.return_value is None
+    assert empty.output_parameters is None
+
+
+def test_db_procedure_outcome_attaches_optionally_to_db_row_set() -> None:
+    without_outcome = DbRowSet(
+        rows=[{"id": 1}],
+        metadata=DbExecutionMetadata(duration=1),
+    )
+    assert without_outcome.procedure is None
+
+    with_outcome = DbRowSet(
+        rows=[{"id": 1}],
+        metadata=DbExecutionMetadata(duration=1),
+        procedure=DbProcedureOutcome(return_value=0),
+    )
+    assert with_outcome.procedure is not None
+    assert with_outcome.procedure.return_value == 0
+
+
+def test_db_procedure_outcome_attaches_optionally_to_db_execution_summary() -> None:
+    without_outcome = DbExecutionSummary(
+        affected_count=1,
+        metadata=DbExecutionMetadata(duration=1),
+    )
+    assert without_outcome.procedure is None
+
+    with_outcome = DbExecutionSummary(
+        affected_count=1,
+        metadata=DbExecutionMetadata(duration=1),
+        procedure=DbProcedureOutcome(output_parameters={"id": 99}),
+    )
+    assert with_outcome.procedure is not None
+    assert with_outcome.procedure.output_parameters == {"id": 99}

{macss_modular_api_sqlserver-0.4.7 → macss_modular_api_sqlserver-0.6.0}/tests/test_db_conformance.py

@@ -3,7 +3,16 @@ from __future__ import annotations
 import json
 from pathlib import Path
 
-from modular_api_sqlserver import DbConnectionSettings, DbFailure, DbFailureKind, DbResult
+from modular_api_sqlserver import (
+    DbCommand,
+    DbCommandKind,
+    DbConnectionSettings,
+    DbFailure,
+    DbFailureKind,
+    DbParameter,
+    DbProcedureOutcome,
+    DbResult,
+)
 
 
 def _load_fixture() -> dict[str, object]:
@@ -65,4 +74,45 @@ def test_matches_the_shared_db_result_fixture() -> None:
         )
     )
 
-    assert mapped_failure.failure.code == result_fixture["wrappedFailureCode"]
+    assert mapped_failure.failure.code == result_fixture["wrappedFailureCode"]
+
+
+def test_matches_the_shared_typed_parameter_and_stored_procedure_fixture() -> None:
+    command_fixture = _load_fixture()["command"]
+    input_fixture = command_fixture["inputParameter"]
+
+    input_parameter = DbParameter.input(
+        input_fixture["name"], input_fixture["value"], input_fixture["typeHint"]
+    )
+    assert input_parameter.name == input_fixture["name"]
+    assert input_parameter.value == input_fixture["value"]
+    assert input_parameter.type_hint == input_fixture["typeHint"]
+    assert input_parameter.direction.value == input_fixture["expectedDirection"]
+
+    output_fixture = command_fixture["outputParameter"]
+    output_parameter = DbParameter.output(output_fixture["name"], output_fixture["typeHint"])
+    assert output_parameter.value is None
+    assert output_parameter.direction.value == output_fixture["expectedDirection"]
+
+    command = DbCommand(
+        kind=DbCommandKind.PROCEDURE,
+        text=command_fixture["procedureName"],
+        parameters=(input_parameter,),
+    )
+    assert command.kind.value == "procedure"
+    assert command.text == command_fixture["procedureName"]
+    assert isinstance(command.parameters[0], DbParameter)
+
+    outcome_fixture = command_fixture["outcome"]
+    outcome = DbProcedureOutcome(
+        return_value=outcome_fixture["returnValue"],
+        output_parameters={
+            outcome_fixture["outputParameterName"]: outcome_fixture["outputParameterValue"]
+        },
+    )
+    assert outcome.return_value == outcome_fixture["returnValue"]
+    assert outcome.output_parameters is not None
+    assert (
+        outcome.output_parameters[outcome_fixture["outputParameterName"]]
+        == outcome_fixture["outputParameterValue"]
+    )