sql-dialect-master 1.1.8__tar.gz → 1.1.9__tar.gz

{sql_dialect_master-1.1.8/sql_dialect_master.egg-info → sql_dialect_master-1.1.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sql-dialect-master
-Version: 1.1.8
+Version: 1.1.9
 Summary: SQL Dialect Master - Multi-database SQL conversion engine
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -36,7 +36,7 @@ Dynamic: license-file
 
 Enterprise-grade multi-database SQL conversion engine supporting 12 database dialects.
 
-Current release: 1.1.8
+Current release: 1.1.9
 
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -294,6 +294,7 @@ sql-dialect-master/
 | Endpoint | Method | Description |
 |----------|--------|-------------|
 | `/api/convert` | POST | Convert SQL between dialects; response includes `error_code` on failure |
+| `/api/convert/batch` | POST | Convert an ordered batch with one dialect pair and per-item results |
 | `/api/parse` | POST | Parse SQL and extract structural elements |
 | `/api/nl2sql` | POST | Generate SQL from natural language |
 | `/api/functions` | GET | Search SQL functions |
@@ -305,6 +306,24 @@ sql-dialect-master/
 | `/health/deep` | GET | Deep health check |
 | `/api/stats` | GET | Service and dataset statistics |
 
+For example, send this JSON body to `POST /api/convert/batch`:
+
+```json
+{
+  "statements": ["SELECT id FROM users", "SELECT user_id FROM orders"],
+  "source_dialect": "postgres",
+  "target_dialect": "mysql",
+  "pretty": true
+}
+```
+
+Results retain input order and include a zero-based `index` alongside the
+single-conversion response fields. The summary includes `count`, `succeeded`,
+and `failed`; top-level `success` is true only when every item succeeds.
+Ordinary item failures, including a batch where every item fails, return HTTP
+200 with per-item `error` and `error_code`. Request-level errors use the
+existing error envelope; 503/504 responses do not include partial results.
+
 ## 🧪 Quality, Validation & Performance
 
 The project maintains a 12 × 12 source-to-target dialect regression matrix, semantic regression tests, post-processing safety regressions, security boundary checks, deterministic rule-engine tests, cache-versioning tests, async concurrency tests, and stable error-code tests.
@@ -317,7 +336,14 @@ The semantic CI gate executes representative conversions against PostgreSQL and
 
 Security validation structurally detects stacked SQL statements using the parser when available, with configurable policy controlling whether dangerous input is blocked or only warned about.
 
-The async batch API bounds concurrent work and preserves input order. A reproducible transpiler benchmark is available under `backend/benchmarks/` and is also executed in CI for performance observability. The benchmark intentionally reports measurements without failing the build on a fixed latency threshold because hosted CI timing is variable.
+The SDK's `batch_transpile_async` bounds concurrent work and preserves input
+order. REST batch conversion runs sequentially in one API worker slot, and the
+entire batch shares the default 30-second queue-plus-execution budget
+(`SDM_REQUEST_TIMEOUT`). HTTP 504 does not cancel the background batch. See
+the [deployment limits](docs/deployment.md#1-deployment-model) for capacity
+and timeout behavior.
+
+A reproducible transpiler benchmark is available under `backend/benchmarks/` and is also executed in CI for performance observability. The benchmark intentionally reports measurements without failing the build on a fixed latency threshold because hosted CI timing is variable.
 
 README source-of-truth checks run in CI and verify the release version, Python requirement, supported dialect list, and benchmark references against repository sources.
 

{sql_dialect_master-1.1.8 → sql_dialect_master-1.1.9}/README.md

@@ -2,7 +2,7 @@
 
 Enterprise-grade multi-database SQL conversion engine supporting 12 database dialects.
 
-Current release: 1.1.8
+Current release: 1.1.9
 
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -260,6 +260,7 @@ sql-dialect-master/
 | Endpoint | Method | Description |
 |----------|--------|-------------|
 | `/api/convert` | POST | Convert SQL between dialects; response includes `error_code` on failure |
+| `/api/convert/batch` | POST | Convert an ordered batch with one dialect pair and per-item results |
 | `/api/parse` | POST | Parse SQL and extract structural elements |
 | `/api/nl2sql` | POST | Generate SQL from natural language |
 | `/api/functions` | GET | Search SQL functions |
@@ -271,6 +272,24 @@ sql-dialect-master/
 | `/health/deep` | GET | Deep health check |
 | `/api/stats` | GET | Service and dataset statistics |
 
+For example, send this JSON body to `POST /api/convert/batch`:
+
+```json
+{
+  "statements": ["SELECT id FROM users", "SELECT user_id FROM orders"],
+  "source_dialect": "postgres",
+  "target_dialect": "mysql",
+  "pretty": true
+}
+```
+
+Results retain input order and include a zero-based `index` alongside the
+single-conversion response fields. The summary includes `count`, `succeeded`,
+and `failed`; top-level `success` is true only when every item succeeds.
+Ordinary item failures, including a batch where every item fails, return HTTP
+200 with per-item `error` and `error_code`. Request-level errors use the
+existing error envelope; 503/504 responses do not include partial results.
+
 ## 🧪 Quality, Validation & Performance
 
 The project maintains a 12 × 12 source-to-target dialect regression matrix, semantic regression tests, post-processing safety regressions, security boundary checks, deterministic rule-engine tests, cache-versioning tests, async concurrency tests, and stable error-code tests.
@@ -283,7 +302,14 @@ The semantic CI gate executes representative conversions against PostgreSQL and
 
 Security validation structurally detects stacked SQL statements using the parser when available, with configurable policy controlling whether dangerous input is blocked or only warned about.
 
-The async batch API bounds concurrent work and preserves input order. A reproducible transpiler benchmark is available under `backend/benchmarks/` and is also executed in CI for performance observability. The benchmark intentionally reports measurements without failing the build on a fixed latency threshold because hosted CI timing is variable.
+The SDK's `batch_transpile_async` bounds concurrent work and preserves input
+order. REST batch conversion runs sequentially in one API worker slot, and the
+entire batch shares the default 30-second queue-plus-execution budget
+(`SDM_REQUEST_TIMEOUT`). HTTP 504 does not cancel the background batch. See
+the [deployment limits](docs/deployment.md#1-deployment-model) for capacity
+and timeout behavior.
+
+A reproducible transpiler benchmark is available under `backend/benchmarks/` and is also executed in CI for performance observability. The benchmark intentionally reports measurements without failing the build on a fixed latency threshold because hosted CI timing is variable.
 
 README source-of-truth checks run in CI and verify the release version, Python requirement, supported dialect list, and benchmark references against repository sources.
 

{sql_dialect_master-1.1.8 → sql_dialect_master-1.1.9}/backend/api/main.py

@@ -27,10 +27,18 @@ from fastapi import Depends, FastAPI, HTTPException, Query, Request
 from fastapi.middleware.cors import CORSMiddleware
 from fastapi.middleware.gzip import GZipMiddleware
 from fastapi.responses import JSONResponse
-from pydantic import BaseModel, ConfigDict, Field
+from pydantic import BaseModel, ConfigDict, Field, StrictStr
 
 from backend.api.auth import require_api_access
-from backend.api.metrics import MetricsMiddleware, configure_runtime_metrics, metrics_response, record_transpile_request
+from backend.api.metrics import (
+    MetricsMiddleware,
+    configure_runtime_metrics,
+    metrics_response,
+    observe_transpile_batch_size,
+    record_transpile_batch_items,
+    record_transpile_batch_request,
+    record_transpile_request,
+)
 from backend.api.rate_limit_store import InMemoryRateLimitStore
 from backend.api.readiness import health_probe_response
 from backend.api.workers import BoundedWorkerPool, WorkerCapacityError
@@ -392,6 +400,38 @@ class ConvertResponse(BaseModel):
     )
     timestamp: str = Field(default_factory=lambda: datetime.now().isoformat(), description="Response timestamp")
 
+
+class BatchConvertRequest(BaseModel):
+    """Convert an ordered, bounded list using one dialect pair."""
+
+    statements: List[StrictStr] = Field(
+        ...,
+        min_length=1,
+        max_length=settings.max_batch_size,
+        description="SQL statements in input order; each item is converted independently",
+    )
+    source_dialect: str
+    target_dialect: str
+    pretty: bool = settings.transpiler_pretty_default
+
+
+class BatchConvertItemResponse(ConvertResponse):
+    """A conversion result associated with its original input position."""
+
+    index: int = Field(..., ge=0, description="Zero-based index in the input statements")
+
+
+class BatchConvertResponse(BaseModel):
+    """Ordered conversion results, including ordinary per-item failures."""
+
+    success: bool
+    results: List[BatchConvertItemResponse]
+    count: int
+    succeeded: int
+    failed: int
+    timestamp: str = Field(default_factory=lambda: datetime.now().isoformat())
+
+
 class NL2SQLRequest(BaseModel):
     """Natural language to SQL request model."""
     text: str = Field(..., description="Natural language query (Chinese or English)")
@@ -620,6 +660,60 @@ async def convert_sql(request: ConvertRequest):
         target_validation_state=result.target_validation_state,
     )
 
+@app.post("/api/convert/batch", response_model=BatchConvertResponse, tags=["conversion"])
+async def convert_sql_batch(request: BatchConvertRequest):
+    """Convert statements sequentially in one worker slot, preserving input order.
+
+    Ordinary item failures, including a batch where every item fails, return
+    HTTP 200 with per-item errors. Request-level failures use the existing
+    error envelope. A 504 ends the wait but does not cancel the worker batch.
+    """
+    source_dialect = target_dialect = "unknown"
+    try:
+        source_dialect = normalize_dialect(request.source_dialect, "source dialect")
+        target_dialect = normalize_dialect(request.target_dialect, "target dialect")
+        observe_transpile_batch_size(len(request.statements))
+        batch_results = await _run_cpu_bound(
+            transpiler.batch_transpile,
+            list(request.statements),
+            source_dialect,
+            target_dialect,
+            request.pretty,
+        )
+        results = [
+            BatchConvertItemResponse(index=index, **result.to_dict())
+            for index, result in enumerate(batch_results)
+        ]
+        count = len(results)
+        succeeded = sum(item.success for item in results)
+        failed = count - succeeded
+        response = BatchConvertResponse(
+            success=failed == 0,
+            results=results,
+            count=count,
+            succeeded=succeeded,
+            failed=failed,
+        )
+    except HTTPException as exc:
+        record_transpile_batch_request(
+            source_dialect,
+            target_dialect,
+            "validation_error" if exc.status_code == 400 else "error",
+        )
+        raise
+    except Exception:
+        record_transpile_batch_request(source_dialect, target_dialect, "error")
+        raise
+
+    record_transpile_batch_items(source_dialect, target_dialect, succeeded, failed)
+    record_transpile_batch_request(
+        source_dialect,
+        target_dialect,
+        "success" if failed == 0 else "partial_failure" if succeeded else "error",
+    )
+    return response
+
+
 @app.post("/api/parse", tags=["conversion"])
 async def parse_sql(request: ParseRequest):
     """

{sql_dialect_master-1.1.8 → sql_dialect_master-1.1.9}/backend/api/metrics.py

@@ -48,6 +48,24 @@ TRANSPILE_REQUESTS = Counter(
     ["source", "target", "result"],
     registry=REGISTRY,
 )
+TRANSPILE_BATCH_REQUESTS = Counter(
+    "sdm_transpile_batch_requests_total",
+    "Batch conversion handler outcomes by dialect pair and result",
+    ["source", "target", "result"],
+    registry=REGISTRY,
+)
+TRANSPILE_BATCH_ITEMS = Counter(
+    "sdm_transpile_batch_items_total",
+    "Items in complete batch results received by the API handler",
+    ["source", "target", "result"],
+    registry=REGISTRY,
+)
+TRANSPILE_BATCH_SIZE = Histogram(
+    "sdm_transpile_batch_size",
+    "Statement count of validated batches before worker admission",
+    buckets=(1, 2, 5, 10, 20, 50, 100),
+    registry=REGISTRY,
+)
 
 _transpiler_provider: Callable[[], object] | None = None
 _worker_provider: Callable[[], object] | None = None
@@ -130,6 +148,21 @@ def record_transpile_request(source: str, target: str, result: str) -> None:
     TRANSPILE_REQUESTS.labels(source=source, target=target, result=result).inc()
 
 
+def record_transpile_batch_request(source: str, target: str, result: str) -> None:
+    TRANSPILE_BATCH_REQUESTS.labels(source=source, target=target, result=result).inc()
+
+
+def record_transpile_batch_items(source: str, target: str, succeeded: int, failed: int) -> None:
+    if succeeded:
+        TRANSPILE_BATCH_ITEMS.labels(source=source, target=target, result="success").inc(succeeded)
+    if failed:
+        TRANSPILE_BATCH_ITEMS.labels(source=source, target=target, result="error").inc(failed)
+
+
+def observe_transpile_batch_size(size: int) -> None:
+    TRANSPILE_BATCH_SIZE.observe(size)
+
+
 def _authorized(request: Request) -> bool:
     configured = settings.metrics_token
     expected = configured.get_secret_value().strip() if configured else ""

{sql_dialect_master-1.1.8 → sql_dialect_master-1.1.9}/backend/core/metadata.py

@@ -17,8 +17,8 @@ Design rules:
 from __future__ import annotations
 
 # ── Release version facts (sole source of truth) ────────────────────────
-PROJECT_VERSION = "1.1.8"
-API_VERSION = "1.1.8"
+PROJECT_VERSION = "1.1.9"
+API_VERSION = "1.1.9"
 # Frontend v2 architecture — independent of the product release version.
 FRONTEND_ARCHITECTURE_VERSION = 2
 

{sql_dialect_master-1.1.8 → sql_dialect_master-1.1.9}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "sql-dialect-master"
-version = "1.1.8"
+version = "1.1.9"
 description = "SQL Dialect Master - Multi-database SQL conversion engine"
 readme = "README.md"
 requires-python = ">=3.11"

{sql_dialect_master-1.1.8 → sql_dialect_master-1.1.9/sql_dialect_master.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sql-dialect-master
-Version: 1.1.8
+Version: 1.1.9
 Summary: SQL Dialect Master - Multi-database SQL conversion engine
 Requires-Python: >=3.11
 Description-Content-Type: text/markdown
@@ -36,7 +36,7 @@ Dynamic: license-file
 
 Enterprise-grade multi-database SQL conversion engine supporting 12 database dialects.
 
-Current release: 1.1.8
+Current release: 1.1.9
 
 [![Python 3.11+](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
@@ -294,6 +294,7 @@ sql-dialect-master/
 | Endpoint | Method | Description |
 |----------|--------|-------------|
 | `/api/convert` | POST | Convert SQL between dialects; response includes `error_code` on failure |
+| `/api/convert/batch` | POST | Convert an ordered batch with one dialect pair and per-item results |
 | `/api/parse` | POST | Parse SQL and extract structural elements |
 | `/api/nl2sql` | POST | Generate SQL from natural language |
 | `/api/functions` | GET | Search SQL functions |
@@ -305,6 +306,24 @@ sql-dialect-master/
 | `/health/deep` | GET | Deep health check |
 | `/api/stats` | GET | Service and dataset statistics |
 
+For example, send this JSON body to `POST /api/convert/batch`:
+
+```json
+{
+  "statements": ["SELECT id FROM users", "SELECT user_id FROM orders"],
+  "source_dialect": "postgres",
+  "target_dialect": "mysql",
+  "pretty": true
+}
+```
+
+Results retain input order and include a zero-based `index` alongside the
+single-conversion response fields. The summary includes `count`, `succeeded`,
+and `failed`; top-level `success` is true only when every item succeeds.
+Ordinary item failures, including a batch where every item fails, return HTTP
+200 with per-item `error` and `error_code`. Request-level errors use the
+existing error envelope; 503/504 responses do not include partial results.
+
 ## 🧪 Quality, Validation & Performance
 
 The project maintains a 12 × 12 source-to-target dialect regression matrix, semantic regression tests, post-processing safety regressions, security boundary checks, deterministic rule-engine tests, cache-versioning tests, async concurrency tests, and stable error-code tests.
@@ -317,7 +336,14 @@ The semantic CI gate executes representative conversions against PostgreSQL and
 
 Security validation structurally detects stacked SQL statements using the parser when available, with configurable policy controlling whether dangerous input is blocked or only warned about.
 
-The async batch API bounds concurrent work and preserves input order. A reproducible transpiler benchmark is available under `backend/benchmarks/` and is also executed in CI for performance observability. The benchmark intentionally reports measurements without failing the build on a fixed latency threshold because hosted CI timing is variable.
+The SDK's `batch_transpile_async` bounds concurrent work and preserves input
+order. REST batch conversion runs sequentially in one API worker slot, and the
+entire batch shares the default 30-second queue-plus-execution budget
+(`SDM_REQUEST_TIMEOUT`). HTTP 504 does not cancel the background batch. See
+the [deployment limits](docs/deployment.md#1-deployment-model) for capacity
+and timeout behavior.
+
+A reproducible transpiler benchmark is available under `backend/benchmarks/` and is also executed in CI for performance observability. The benchmark intentionally reports measurements without failing the build on a fixed latency threshold because hosted CI timing is variable.
 
 README source-of-truth checks run in CI and verify the release version, Python requirement, supported dialect list, and benchmark references against repository sources.