macss-modular-api-sqlserver 0.4.7__py3-none-any.whl → 0.6.0__py3-none-any.whl

{macss_modular_api_sqlserver-0.4.7.dist-info → macss_modular_api_sqlserver-0.6.0.dist-info}/METADATA

@@ -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.6.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+modular_api_sqlserver/__init__.py,sha256=m-ExxV6JLGD41Gx1nodhzLcevLdqDYMbBz08hU26q_0,1230
+modular_api_sqlserver/db_client.py,sha256=KhF0HYsHHGeg3HxAastZJc5p5mY88r4MO7YBlrJeS9c,14355
+macss_modular_api_sqlserver-0.6.0.dist-info/METADATA,sha256=_AXCyo20lOoux3FTVhjTSAWSnetPvm5w0sbcI5gqEhk,2460
+macss_modular_api_sqlserver-0.6.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+macss_modular_api_sqlserver-0.6.0.dist-info/top_level.txt,sha256=n0TFMe-mbowNietmYzSthEnQ-gmZLPXaLJ6h0HhuX84,22
+macss_modular_api_sqlserver-0.6.0.dist-info/RECORD,,

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",

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.dist-info/RECORD

@@ -1,6 +0,0 @@
-modular_api_sqlserver/__init__.py,sha256=oc7QvcB8Ed6B8jVwzetvRrZBA3hROJs1WrC37bHv5fE,1090
-modular_api_sqlserver/db_client.py,sha256=jVTiw9urV2AGqpg7sQzW-ID3PfUdWxSrMxG-I83pZ_c,13045
-macss_modular_api_sqlserver-0.4.7.dist-info/METADATA,sha256=DWSUnJrI8AFMOPf2969GRZYNuI5_mHE_zYF2nKu6q_M,2208
-macss_modular_api_sqlserver-0.4.7.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-macss_modular_api_sqlserver-0.4.7.dist-info/top_level.txt,sha256=n0TFMe-mbowNietmYzSthEnQ-gmZLPXaLJ6h0HhuX84,22
-macss_modular_api_sqlserver-0.4.7.dist-info/RECORD,,