datacontract-cli 1.2.7__tar.gz → 1.2.9__tar.gz

{datacontract_cli-1.2.7/datacontract_cli.egg-info → datacontract_cli-1.2.9}/PKG-INFO

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: datacontract-cli
-Version: 1.2.7
+Version: 1.2.9
 Summary: The datacontract CLI is an open source command-line tool for working with Data Contracts. It uses data contract YAML files to lint the data contract, connect to data sources and execute schema and quality tests, detect breaking changes, and export to different formats. The tool is written in Python. It can be used as a standalone CLI tool, in a CI/CD pipeline, or directly as a Python library.
 Author-email: Jochen Christ <jochen.christ@entropy-data.com>, Stefan Negele <stefan.negele@innoq.com>, Simon Harrer <simon.harrer@entropy-data.com>
 License-Expression: MIT
 Project-URL: Homepage, https://cli.datacontract.com
-Project-URL: Documentation, https://docs.datacontract.com
+Project-URL: Documentation, https://cli.datacontract.com
 Project-URL: Repository, https://github.com/datacontract/datacontract-cli
 Project-URL: Issues, https://github.com/datacontract/datacontract-cli/issues
-Project-URL: Changelog, https://docs.datacontract.com/release-notes
+Project-URL: Changelog, https://cli.datacontract.com/release-notes
 Keywords: data-contract,data-contracts,odcs,open-data-contract-standard,data-quality,data-governance,data-mesh,data-product,data-engineering,schema,dbt,snowflake,databricks,bigquery
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Environment :: Console
@@ -47,7 +47,7 @@ Requires-Dist: Jinja2<4.0.0,>=3.1.5
 Requires-Dist: jinja_partials<1.0.0,>=0.2.1
 Requires-Dist: datacontract-specification<2.0.0,>=1.2.3
 Requires-Dist: open-data-contract-standard<3.3.0,>=3.2.0
-Requires-Dist: deepdiff<10.0.0,>=6.0.0
+Requires-Dist: deepdiff<10.0.0,>=8.0.0
 Provides-Extra: avro
 Requires-Dist: avro==1.12.2; extra == "avro"
 Provides-Extra: bigquery
@@ -59,6 +59,9 @@ Provides-Extra: csv
 Requires-Dist: datacontract-cli[duckdb]; extra == "csv"
 Provides-Extra: excel
 Requires-Dist: openpyxl<4.0.0,>=3.1.5; extra == "excel"
+Provides-Extra: xlsx
+Requires-Dist: datacontract-cli[duckdb]; extra == "xlsx"
+Requires-Dist: duckdb-extension-excel<1.6.0,>=1.5.0; extra == "xlsx"
 Provides-Extra: dataframe
 Requires-Dist: ibis-framework<13.0.0,>=10.0.0; extra == "dataframe"
 Requires-Dist: numpy<3,>=1.23.2; extra == "dataframe"
@@ -70,7 +73,7 @@ Requires-Dist: rich>=12.4.4; extra == "dataframe"
 Provides-Extra: databricks
 Requires-Dist: ibis-framework[databricks]<13.0.0,>=10.0.0; extra == "databricks"
 Requires-Dist: databricks-sql-connector<4.7.0,>=3.7.0; extra == "databricks"
-Requires-Dist: databricks-sdk<0.152.0; extra == "databricks"
+Requires-Dist: databricks-sdk<0.157.0; extra == "databricks"
 Requires-Dist: packaging<27.0,>=21.3; extra == "databricks"
 Provides-Extra: databricks-runtime
 Requires-Dist: datacontract-cli[databricks]; extra == "databricks-runtime"
@@ -102,10 +105,11 @@ Provides-Extra: azure
 Requires-Dist: datacontract-cli[duckdb]; extra == "azure"
 Requires-Dist: duckdb-extension-azure<1.6.0,>=1.5.0; extra == "azure"
 Requires-Dist: azure-identity<1.27,>=1.17.1; extra == "azure"
-Requires-Dist: azure-storage-blob<12.31,>=12.24; extra == "azure"
+Requires-Dist: azure-storage-blob<12.32,>=12.24; extra == "azure"
 Provides-Extra: snowflake
-Requires-Dist: snowflake-connector-python[pandas]<4.9,>=3.6; extra == "snowflake"
+Requires-Dist: snowflake-connector-python[pandas]<5.2,>=3.17; extra == "snowflake"
 Requires-Dist: ibis-framework[snowflake]<13.0.0,>=10.0.0; extra == "snowflake"
+Requires-Dist: packaging<27.0,>=21.3; extra == "snowflake"
 Provides-Extra: sqlserver
 Requires-Dist: ibis-framework[mssql]<13.0.0,>=10.0.0; extra == "sqlserver"
 Requires-Dist: packaging<27.0,>=21.3; extra == "sqlserver"
@@ -141,30 +145,30 @@ Requires-Dist: pyarrow>=18.1.0; extra == "parquet"
 Provides-Extra: rdf
 Requires-Dist: rdflib==7.6.0; extra == "rdf"
 Provides-Extra: api
-Requires-Dist: fastapi<0.143.0,>=0.115.0; extra == "api"
+Requires-Dist: fastapi<0.162.0,>=0.115.0; extra == "api"
 Requires-Dist: uvicorn<0.55.0,>=0.44.0; extra == "api"
 Provides-Extra: protobuf
 Requires-Dist: proto-schema-parser<3.0,>=1.0; extra == "protobuf"
 Provides-Extra: xml
 Requires-Dist: xmlschema<5.0,>=4.0; extra == "xml"
 Provides-Extra: all
-Requires-Dist: datacontract-cli[api,athena,avro,azure,bigquery,clickhouse,csv,databricks,dataframe,dbml,duckdb,exasol,excel,gcs,hive,iceberg,impala,kafka,mysql,oracle,parquet,postgres,protobuf,rdf,redshift,s3,snowflake,sqlserver,trino,xml]; extra == "all"
+Requires-Dist: datacontract-cli[api,athena,avro,azure,bigquery,clickhouse,csv,databricks,dataframe,dbml,duckdb,exasol,excel,gcs,hive,iceberg,impala,kafka,mysql,oracle,parquet,postgres,protobuf,rdf,redshift,s3,snowflake,sqlserver,trino,xlsx,xml]; extra == "all"
 Provides-Extra: dev
 Requires-Dist: datacontract-cli[all]; extra == "dev"
 Requires-Dist: httpx==0.28.1; extra == "dev"
 Requires-Dist: kafka-python; extra == "dev"
 Requires-Dist: minio==7.2.20; extra == "dev"
-Requires-Dist: moto==5.2.3; extra == "dev"
+Requires-Dist: moto==5.2.4; extra == "dev"
 Requires-Dist: openapi-spec-validator<0.10,>=0.7; extra == "dev"
 Requires-Dist: pandas>=2.1.0; extra == "dev"
 Requires-Dist: pre-commit<4.7.0,>=3.7.1; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-cov; extra == "dev"
 Requires-Dist: pytest-xdist; extra == "dev"
-Requires-Dist: pymssql==2.4.4; extra == "dev"
+Requires-Dist: pymssql==2.4.5; extra == "dev"
 Requires-Dist: psycopg2-binary<3.0,>=2.9; extra == "dev"
-Requires-Dist: mysql-connector-python<26.8.0,>=8.0.30; extra == "dev"
-Requires-Dist: ruff==0.16.10; extra == "dev"
+Requires-Dist: mysql-connector-python<26.11.0,>=8.0.30; extra == "dev"
+Requires-Dist: ruff==0.17.2; extra == "dev"
 Requires-Dist: testcontainers[kafka,minio,mssql,mysql,postgres]==4.15.0; extra == "dev"
 Requires-Dist: trino==0.340.0; extra == "dev"
 Dynamic: license-file
@@ -191,11 +195,11 @@ It can be used as a standalone CLI tool, in a CI/CD pipeline, or directly as a P
 
 ![Main features of the Data Contract CLI](datacontractcli.png)
 
-> 📖 **Full documentation: [docs.datacontract.com](https://docs.datacontract.com)**
+> 📖 **Full documentation: [cli.datacontract.com](https://cli.datacontract.com)**
 >
-> Quick links: [Quickstart](https://docs.datacontract.com/quickstart) · [Commands](https://docs.datacontract.com/commands) · [Best Practices](https://docs.datacontract.com/best-practices) · [Custom Export and Import](https://docs.datacontract.com/extending) · [Release Notes](https://docs.datacontract.com/release-notes) · [Development Setup](#development-setup)
+> Quick links: [Quickstart](https://cli.datacontract.com/quickstart) · [Commands](https://cli.datacontract.com/commands) · [Best Practices](https://cli.datacontract.com/best-practices) · [Custom Export and Import](https://cli.datacontract.com/extending) · [Release Notes](https://cli.datacontract.com/release-notes) · [Development Setup](#development-setup)
 >
-> For LLMs: [docs.datacontract.com/llms.txt](https://docs.datacontract.com/llms.txt) · [docs.datacontract.com/llms-full.txt](https://docs.datacontract.com/llms-full.txt) · [Data Contract Skills](https://github.com/datacontract/datacontract-skills) for coding agents
+> For LLMs: [cli.datacontract.com/llms.txt](https://cli.datacontract.com/llms.txt) · [cli.datacontract.com/llms-full.txt](https://cli.datacontract.com/llms-full.txt) · [Data Contract Skills](https://github.com/datacontract/datacontract-skills) for coding agents
 
 ## Getting started
 
@@ -269,9 +273,9 @@ $ datacontract import snowflake --source <account> --database ORDER_DB --schema
 $ datacontract test datacontract.yaml
 ```
 
-Copy-paste guides with credentials setup are available for [Snowflake](https://docs.datacontract.com/testing/snowflake), [BigQuery](https://docs.datacontract.com/testing/bigquery), [Databricks](https://docs.datacontract.com/testing/databricks), and [15+ other sources](https://docs.datacontract.com/testing).
+Copy-paste guides with credentials setup are available for [Snowflake](https://cli.datacontract.com/testing/snowflake), [BigQuery](https://cli.datacontract.com/testing/bigquery), [Databricks](https://cli.datacontract.com/testing/databricks), and [15+ other sources](https://cli.datacontract.com/testing).
 
-We can also use the data contract metadata to export in many [formats](https://docs.datacontract.com/exports), e.g., to generate a SQL DDL:
+We can also use the data contract metadata to export in many [formats](https://cli.datacontract.com/exports), e.g., to generate a SQL DDL:
 
 ```bash
 $ datacontract export sql https://datacontract.com/orders-v1.odcs.yaml
@@ -357,7 +361,7 @@ if not run.has_passed():
 
 - [How to integrate Data Contract CLI in your CI/CD pipeline as a GitHub Action](https://github.com/datacontract/datacontract-action/)
 - [How to let your coding agent (Claude Code, Codex, GitHub Copilot) create and test data contracts with the Data Contract Skills](https://github.com/datacontract/datacontract-skills)
-- [How to run the Data Contract CLI API to test data contracts with POST requests](https://docs.datacontract.com/api)
+- [How to run the Data Contract CLI API to test data contracts with POST requests](https://cli.datacontract.com/api)
 - [How to run Data Contract CLI in a Databricks pipeline](https://www.datamesh-architecture.com/howto/build-a-dataproduct-with-databricks#test-the-data-product)
 
 
@@ -427,7 +431,7 @@ alias datacontract='docker run --rm -v "${PWD}:/home/datacontract" datacontract/
 
 _Note:_ The output of Docker command line messages is limited to 80 columns and may include line breaks. Don't pipe docker output to files if you want to export code. Use the `--output` option instead.
 
-Released images are signed with [cosign](https://docs.sigstore.dev/cosign/signing/overview/) keyless signing. See [Verifying the image](https://docs.datacontract.com/installation#verifying-the-image) to check a signature before you run it.
+Released images are signed with [cosign](https://docs.sigstore.dev/cosign/signing/overview/) keyless signing. See [Verifying the image](https://cli.datacontract.com/installation#verifying-the-image) to check a signature before you run it.
 
 
 
@@ -455,6 +459,7 @@ A list of available extras:
 | DuckDB (local file, CSV import and API response testing) | `pip install datacontract-cli[duckdb]` |
 | Exasol | `pip install datacontract-cli[exasol]` |
 | Excel | `pip install datacontract-cli[excel]` |
+| Excel workbooks (testing) | `pip install datacontract-cli[xlsx]` |
 | GCS | `pip install datacontract-cli[gcs]` |
 | SAP HANA / Datasphere | `pip install datacontract-cli[hana]` (not part of `all`: `hdbcli` is proprietary) |
 | Apache Iceberg (schema import and export, REST catalog testing) | `pip install datacontract-cli[iceberg]` |
@@ -476,18 +481,18 @@ A list of available extras:
 
 ## Documentation
 
-📖 **The full documentation is at [docs.datacontract.com](https://docs.datacontract.com).**
+📖 **The full documentation is at [cli.datacontract.com](https://cli.datacontract.com).**
 
 It covers everything in depth, including the complete command reference:
 
-- [Quickstart](https://docs.datacontract.com/quickstart) — install and run your first test
-- [Open Data Contract Standard](https://docs.datacontract.com/open-data-contract-standard) — the contract format
-- [Test your Data](https://docs.datacontract.com/testing) — schema & quality tests against 18+ data sources
-- [Define your Quality Rules](https://docs.datacontract.com/quality-rules) — SQL, library, text, and custom checks
-- [Sync with dbt](https://docs.datacontract.com/dbt) · [Edit your contract](https://docs.datacontract.com/editor)
-- [Imports](https://docs.datacontract.com/imports) and [Exports](https://docs.datacontract.com/exports) — convert to/from 25+ formats
-- [API](https://docs.datacontract.com/api) and [Python Library](https://docs.datacontract.com/python-library)
-- [Command reference](https://docs.datacontract.com/commands) — `init`, `lint`, `test`, `export`, `import`, `dbt`, `ci`, `catalog`, `publish`, `api`, and more
+- [Quickstart](https://cli.datacontract.com/quickstart) — install and run your first test
+- [Open Data Contract Standard](https://cli.datacontract.com/open-data-contract-standard) — the contract format
+- [Test your Data](https://cli.datacontract.com/testing) — schema & quality tests against 18+ data sources
+- [Define your Quality Rules](https://cli.datacontract.com/quality-rules) — SQL, library, text, and custom checks
+- [Sync with dbt](https://cli.datacontract.com/dbt) · [Edit your contract](https://cli.datacontract.com/editor)
+- [Imports](https://cli.datacontract.com/imports) and [Exports](https://cli.datacontract.com/exports) — convert to/from 25+ formats
+- [API](https://cli.datacontract.com/api) and [Python Library](https://cli.datacontract.com/python-library)
+- [Command reference](https://cli.datacontract.com/commands) — `init`, `lint`, `test`, `export`, `import`, `dbt`, `ci`, `catalog`, `publish`, `api`, and more
 
 ## Development Setup
 

{datacontract_cli-1.2.7 → datacontract_cli-1.2.9}/README.md

@@ -20,11 +20,11 @@ It can be used as a standalone CLI tool, in a CI/CD pipeline, or directly as a P
 
 ![Main features of the Data Contract CLI](datacontractcli.png)
 
-> 📖 **Full documentation: [docs.datacontract.com](https://docs.datacontract.com)**
+> 📖 **Full documentation: [cli.datacontract.com](https://cli.datacontract.com)**
 >
-> Quick links: [Quickstart](https://docs.datacontract.com/quickstart) · [Commands](https://docs.datacontract.com/commands) · [Best Practices](https://docs.datacontract.com/best-practices) · [Custom Export and Import](https://docs.datacontract.com/extending) · [Release Notes](https://docs.datacontract.com/release-notes) · [Development Setup](#development-setup)
+> Quick links: [Quickstart](https://cli.datacontract.com/quickstart) · [Commands](https://cli.datacontract.com/commands) · [Best Practices](https://cli.datacontract.com/best-practices) · [Custom Export and Import](https://cli.datacontract.com/extending) · [Release Notes](https://cli.datacontract.com/release-notes) · [Development Setup](#development-setup)
 >
-> For LLMs: [docs.datacontract.com/llms.txt](https://docs.datacontract.com/llms.txt) · [docs.datacontract.com/llms-full.txt](https://docs.datacontract.com/llms-full.txt) · [Data Contract Skills](https://github.com/datacontract/datacontract-skills) for coding agents
+> For LLMs: [cli.datacontract.com/llms.txt](https://cli.datacontract.com/llms.txt) · [cli.datacontract.com/llms-full.txt](https://cli.datacontract.com/llms-full.txt) · [Data Contract Skills](https://github.com/datacontract/datacontract-skills) for coding agents
 
 ## Getting started
 
@@ -98,9 +98,9 @@ $ datacontract import snowflake --source <account> --database ORDER_DB --schema
 $ datacontract test datacontract.yaml
 ```
 
-Copy-paste guides with credentials setup are available for [Snowflake](https://docs.datacontract.com/testing/snowflake), [BigQuery](https://docs.datacontract.com/testing/bigquery), [Databricks](https://docs.datacontract.com/testing/databricks), and [15+ other sources](https://docs.datacontract.com/testing).
+Copy-paste guides with credentials setup are available for [Snowflake](https://cli.datacontract.com/testing/snowflake), [BigQuery](https://cli.datacontract.com/testing/bigquery), [Databricks](https://cli.datacontract.com/testing/databricks), and [15+ other sources](https://cli.datacontract.com/testing).
 
-We can also use the data contract metadata to export in many [formats](https://docs.datacontract.com/exports), e.g., to generate a SQL DDL:
+We can also use the data contract metadata to export in many [formats](https://cli.datacontract.com/exports), e.g., to generate a SQL DDL:
 
 ```bash
 $ datacontract export sql https://datacontract.com/orders-v1.odcs.yaml
@@ -186,7 +186,7 @@ if not run.has_passed():
 
 - [How to integrate Data Contract CLI in your CI/CD pipeline as a GitHub Action](https://github.com/datacontract/datacontract-action/)
 - [How to let your coding agent (Claude Code, Codex, GitHub Copilot) create and test data contracts with the Data Contract Skills](https://github.com/datacontract/datacontract-skills)
-- [How to run the Data Contract CLI API to test data contracts with POST requests](https://docs.datacontract.com/api)
+- [How to run the Data Contract CLI API to test data contracts with POST requests](https://cli.datacontract.com/api)
 - [How to run Data Contract CLI in a Databricks pipeline](https://www.datamesh-architecture.com/howto/build-a-dataproduct-with-databricks#test-the-data-product)
 
 
@@ -256,7 +256,7 @@ alias datacontract='docker run --rm -v "${PWD}:/home/datacontract" datacontract/
 
 _Note:_ The output of Docker command line messages is limited to 80 columns and may include line breaks. Don't pipe docker output to files if you want to export code. Use the `--output` option instead.
 
-Released images are signed with [cosign](https://docs.sigstore.dev/cosign/signing/overview/) keyless signing. See [Verifying the image](https://docs.datacontract.com/installation#verifying-the-image) to check a signature before you run it.
+Released images are signed with [cosign](https://docs.sigstore.dev/cosign/signing/overview/) keyless signing. See [Verifying the image](https://cli.datacontract.com/installation#verifying-the-image) to check a signature before you run it.
 
 
 
@@ -284,6 +284,7 @@ A list of available extras:
 | DuckDB (local file, CSV import and API response testing) | `pip install datacontract-cli[duckdb]` |
 | Exasol | `pip install datacontract-cli[exasol]` |
 | Excel | `pip install datacontract-cli[excel]` |
+| Excel workbooks (testing) | `pip install datacontract-cli[xlsx]` |
 | GCS | `pip install datacontract-cli[gcs]` |
 | SAP HANA / Datasphere | `pip install datacontract-cli[hana]` (not part of `all`: `hdbcli` is proprietary) |
 | Apache Iceberg (schema import and export, REST catalog testing) | `pip install datacontract-cli[iceberg]` |
@@ -305,18 +306,18 @@ A list of available extras:
 
 ## Documentation
 
-📖 **The full documentation is at [docs.datacontract.com](https://docs.datacontract.com).**
+📖 **The full documentation is at [cli.datacontract.com](https://cli.datacontract.com).**
 
 It covers everything in depth, including the complete command reference:
 
-- [Quickstart](https://docs.datacontract.com/quickstart) — install and run your first test
-- [Open Data Contract Standard](https://docs.datacontract.com/open-data-contract-standard) — the contract format
-- [Test your Data](https://docs.datacontract.com/testing) — schema & quality tests against 18+ data sources
-- [Define your Quality Rules](https://docs.datacontract.com/quality-rules) — SQL, library, text, and custom checks
-- [Sync with dbt](https://docs.datacontract.com/dbt) · [Edit your contract](https://docs.datacontract.com/editor)
-- [Imports](https://docs.datacontract.com/imports) and [Exports](https://docs.datacontract.com/exports) — convert to/from 25+ formats
-- [API](https://docs.datacontract.com/api) and [Python Library](https://docs.datacontract.com/python-library)
-- [Command reference](https://docs.datacontract.com/commands) — `init`, `lint`, `test`, `export`, `import`, `dbt`, `ci`, `catalog`, `publish`, `api`, and more
+- [Quickstart](https://cli.datacontract.com/quickstart) — install and run your first test
+- [Open Data Contract Standard](https://cli.datacontract.com/open-data-contract-standard) — the contract format
+- [Test your Data](https://cli.datacontract.com/testing) — schema & quality tests against 18+ data sources
+- [Define your Quality Rules](https://cli.datacontract.com/quality-rules) — SQL, library, text, and custom checks
+- [Sync with dbt](https://cli.datacontract.com/dbt) · [Edit your contract](https://cli.datacontract.com/editor)
+- [Imports](https://cli.datacontract.com/imports) and [Exports](https://cli.datacontract.com/exports) — convert to/from 25+ formats
+- [API](https://cli.datacontract.com/api) and [Python Library](https://cli.datacontract.com/python-library)
+- [Command reference](https://cli.datacontract.com/commands) — `init`, `lint`, `test`, `export`, `import`, `dbt`, `ci`, `catalog`, `publish`, `api`, and more
 
 ## Development Setup
 

datacontract_cli-1.2.9/datacontract/__init__.py

@@ -0,0 +1,30 @@
+# Configuration so that yaml.safe_dump dumps strings with line breaks with yaml literal |
+import warnings
+
+import yaml
+
+yaml.SafeDumper.org_represent_str = yaml.SafeDumper.represent_str
+
+
+def repr_str(dumper, data):
+    if "\n" in data:
+        return dumper.represent_scalar("tag:yaml.org,2002:str", data, style="|")
+    return dumper.org_represent_str(data)
+
+
+yaml.add_representer(str, repr_str, Dumper=yaml.SafeDumper)
+
+# snowflake-connector-python 5.x warns on every connection about a changing logout default, and about the 4.x
+# parameter names we keep passing because Python 3.10 installs still get 4.x.
+warnings.filterwarnings(
+    "ignore", message="enable_server_session_keep_alive_auto_detection was not set", category=FutureWarning
+)
+warnings.filterwarnings(
+    "ignore",
+    message="'(private_key_file_pwd|network_timeout|socket_timeout)' is deprecated",
+    category=DeprecationWarning,
+)
+
+from datacontract.config import Config  # noqa: E402
+
+__all__ = ["Config"]

{datacontract_cli-1.2.7 → datacontract_cli-1.2.9}/datacontract/api.py

@@ -12,7 +12,7 @@ from fastapi.security.api_key import APIKeyHeader
 from pydantic import BaseModel, Field, ValidationError
 
 from datacontract.config import Config, known_env_names
-from datacontract.config.variables import CONTRACT_VARIABLES_ENV, allowed_environment, resolve_variables
+from datacontract.config.variables import CONTRACT_VARIABLES_ENV, allowed_environment, resolve_server_variables
 from datacontract.data_contract import DataContract, ExportFormat
 from datacontract.model.breaking import BreakingChangeEntry, Perspective
 from datacontract.model.changelog import ChangelogEntry
@@ -273,7 +273,7 @@ headers, which are matched case-insensitively and map mechanically to the enviro
 Per-request headers are never written to the process environment, so one server can serve several
 tenants. Send them over HTTPS only.
 
-See [Configuration](https://docs.datacontract.com/configuration) for the full list of options.
+See [Configuration](https://cli.datacontract.com/configuration) for the full list of options.
 """
 
 # The endpoints are plain `def`, not `async def`: they block on data sources, and FastAPI runs
@@ -290,7 +290,7 @@ app = FastAPI(
     },
     contact={
         "name": "Data Contract CLI",
-        "url": "https://docs.datacontract.com/",
+        "url": "https://cli.datacontract.com/",
     },
     # Relative, so the document works for any deployment. A second, absolute entry would
     # show up as a target in the Swagger UI dropdown and invite sending contracts there.
@@ -301,7 +301,7 @@ app = FastAPI(
             "description": "Run the schema and quality tests of a data contract against the actual data.",
             "externalDocs": {
                 "description": "Documentation",
-                "url": "https://docs.datacontract.com/testing/",
+                "url": "https://cli.datacontract.com/testing/",
             },
         },
         {
@@ -309,7 +309,7 @@ app = FastAPI(
             "description": "Validate that a data contract is syntactically correct and follows the standard.",
             "externalDocs": {
                 "description": "Documentation",
-                "url": "https://docs.datacontract.com/commands/lint",
+                "url": "https://cli.datacontract.com/commands/lint",
             },
         },
         {
@@ -317,7 +317,7 @@ app = FastAPI(
             "description": "Convert a data contract into another format, such as SQL DDL, Avro, or dbt.",
             "externalDocs": {
                 "description": "Documentation",
-                "url": "https://docs.datacontract.com/exports/",
+                "url": "https://cli.datacontract.com/exports/",
             },
         },
         {
@@ -325,7 +325,7 @@ app = FastAPI(
             "description": "Compare two versions of a data contract and list what changed.",
             "externalDocs": {
                 "description": "Documentation",
-                "url": "https://docs.datacontract.com/commands/changelog",
+                "url": "https://cli.datacontract.com/commands/changelog",
             },
         },
         {
@@ -333,7 +333,7 @@ app = FastAPI(
             "description": "Compare two versions of a data contract and grade each change by compatibility impact.",
             "externalDocs": {
                 "description": "Documentation",
-                "url": "https://docs.datacontract.com/commands/breaking",
+                "url": "https://cli.datacontract.com/commands/breaking",
             },
         },
     ],
@@ -368,7 +368,7 @@ def _openapi_with_external_docs() -> dict:
         "externalDocs",
         {
             "description": "Data Contract CLI documentation",
-            "url": "https://docs.datacontract.com/api",
+            "url": "https://cli.datacontract.com/api",
         },
     )
     return schema
@@ -443,6 +443,22 @@ AUTHENTICATION_RESPONSES: dict[int | str, dict] = {
 
 _CONFIG_HEADER_PREFIX = "datacontract-"
 
+# Options naming a file or folder on the server's disk, or the server's own workload identity: the operator's
+# to choose, never the caller's, or a caller could have the server log in as the operator to a host of their choosing.
+_SERVER_ONLY_OPTIONS = frozenset(
+    {
+        "DATACONTRACT_CUSTOM_QUALITY_CHECKS",
+        "DATACONTRACT_SNOWFLAKE_PRIVATE_KEY_FILE",
+        "DATACONTRACT_SNOWFLAKE_PRIVATE_KEY_PATH",
+        "DATACONTRACT_SNOWFLAKE_TOKEN_FILE_PATH",
+        "DATACONTRACT_SNOWFLAKE_WORKLOAD_IDENTITY_PROVIDER",
+        "DATACONTRACT_BIGQUERY_ACCOUNT_INFO_JSON_PATH",
+        "DATACONTRACT_DATABRICKS_PROFILE",
+        "DATACONTRACT_ORACLE_CLIENT_DIR",
+        "DATACONTRACT_DUCKDB_DATABASE",
+    }
+)
+
 
 def config_from_headers(headers) -> "Config | None":
     """Build a per-request Config from configuration option headers.
@@ -452,8 +468,8 @@ def config_from_headers(headers) -> "Config | None":
     → ``DATACONTRACT_SNOWFLAKE_PASSWORD``, ``entropy-data-api-key`` →
     ``ENTROPY_DATA_API_KEY``. Returns None when no config headers are present,
     so env-var-configured deployments behave exactly as before. Unknown
-    ``datacontract-*`` option names are rejected with a 400, and so is the
-    custom quality checks folder.
+    ``datacontract-*`` option names are rejected with a 400, and so are options
+    only the operator may set.
     """
     known = known_env_names()
     values = {}
@@ -461,11 +477,10 @@ def config_from_headers(headers) -> "Config | None":
         lowered = name.lower()
         env = lowered.upper().replace("-", "_")
         if lowered.startswith(_CONFIG_HEADER_PREFIX) or env in known:
-            if env == "DATACONTRACT_CUSTOM_QUALITY_CHECKS":
-                # A folder on the server's disk is the operator's to choose, never the caller's.
+            if env in _SERVER_ONLY_OPTIONS:
                 raise HTTPException(
                     status_code=status.HTTP_400_BAD_REQUEST,
-                    detail="The custom quality checks folder is configured by the API server, not per request.",
+                    detail=f"{env} is set on the API server. It is not possible to override it per request.",
                 )
             values[env] = value
     if not values:
@@ -516,12 +531,25 @@ _ENVIRONMENT_CREDENTIAL_TARGETS: dict[str, tuple[str, str | None, tuple[str, ...
     "hive": ("host", "hive_host", ("hive_password",)),
     "redshift": ("host", "redshift_host", ("redshift_password",)),
     "sqlserver": ("host", "sqlserver_host", ("sqlserver_password",)),
+    "mssql": ("host", "sqlserver_host", ("sqlserver_password",)),
     "snowflake": (
         "account",
         "snowflake_account",
-        ("snowflake_password", "snowflake_token", "snowflake_private_key"),
+        (
+            "snowflake_password",
+            "snowflake_token",
+            "snowflake_private_key",
+            "snowflake_private_key_file",
+            "snowflake_private_key_path",
+            "snowflake_token_file_path",
+            "snowflake_workload_identity_provider",
+        ),
+    ),
+    "databricks": (
+        "host",
+        "databricks_server_hostname",
+        ("databricks_token", "databricks_client_secret", "databricks_profile"),
     ),
-    "databricks": ("host", "databricks_server_hostname", ("databricks_token", "databricks_client_secret")),
     # Kafka's broker host is always the contract's `server.host` (no environment
     # option pins it), so an environment-held SASL password can never be paired
     # with a posted contract safely -- host_field is None, so it is always rejected.
@@ -539,13 +567,17 @@ def _selected_server(body: str, server_name: str | None, config):
     """
     from datacontract.engines.data_contract_test import get_server
     from datacontract.lint import resolve
+    from datacontract.model.server import get_server_type
 
     try:
         data_contract = resolve.resolve_data_contract(data_contract_str=body, config=config)
         server = get_server(data_contract, server_name)
-        # Guard the server type the test will run against, not a ${VAR:-local} reference to it.
-        variables = allowed_environment(_allowed_contract_variables())
-        return server and server.model_copy(update={"type": resolve_variables(server.type, variables=variables)})
+        if server is None:
+            return None
+        # Guard the server type the test will connect to: references like ${VAR:-local} resolved, and
+        # `custom` + customType or an ODCS synonym such as `postgresql` mapped to the type the CLI dispatches on.
+        server = resolve_server_variables(server, allowed_environment(_allowed_contract_variables()))
+        return server.model_copy(update={"type": get_server_type(server)})
     except Exception:
         return None
 
@@ -630,11 +662,23 @@ def _reject_environment_credentials_to_untrusted_host(body: str, server_name: st
     target_attr, host_field, secret_fields = guard
     if not any(resolved.option_source(field) == "env" for field in secret_fields):
         return  # no environment-held secret for this server type; nothing to protect
-    if host_field is not None and resolved.option_source(host_field) == "env":
-        return  # the operator pinned the target host; the contract's host is ignored
     held = [
         env_name(field, Config.model_fields[field]) for field in secret_fields if resolved.option_source(field) == "env"
     ]
+    if host_field is not None and resolved.option_source(host_field) == "env":
+        # Snowflake's host and port override the address the pinned account resolves to.
+        redirects = [
+            env_name(field, Config.model_fields[field])
+            for field in ("snowflake_host", "snowflake_port")
+            if server.type == "snowflake" and resolved.option_source(field) == "request"
+        ]
+        if not redirects:
+            return  # the operator pinned the target host; the contract's host is ignored
+        raise HTTPException(
+            status_code=status.HTTP_422_UNPROCESSABLE_ENTITY,
+            detail=f"{', '.join(redirects)} cannot be set per request while the API server uses its own Snowflake "
+            f"credential ({', '.join(held)}). Remove it, or send all credentials with the request.",
+        )
     if host_field is not None:
         env_var = env_name(host_field, Config.model_fields[host_field])
         detail = (