datacontract-cli 0.12.1__tar.gz → 0.12.3__tar.gz

{datacontract_cli-0.12.1/datacontract_cli.egg-info → datacontract_cli-0.12.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datacontract-cli
-Version: 0.12.1
+Version: 0.12.3
 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@innoq.com>, Stefan Negele <stefan.negele@innoq.com>, Simon Harrer <simon.harrer@innoq.com>
 License-Expression: MIT
@@ -11,17 +11,16 @@ Classifier: Operating System :: OS Independent
 Requires-Python: <3.13,>=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: typer<0.25,>=0.18.0
+Requires-Dist: typer<0.26,>=0.18.0
 Requires-Dist: pydantic<2.14.0,>=2.8.2
 Requires-Dist: pyyaml~=6.0.1
-Requires-Dist: requests<2.34,>=2.31
+Requires-Dist: requests<2.35,>=2.31
 Requires-Dist: fastjsonschema<2.22.0,>=2.19.1
 Requires-Dist: jsonschema<5.0.0,>=4.23.0
 Requires-Dist: pytz>=2024.1
 Requires-Dist: python-multipart<1.0.0,>=0.0.20
 Requires-Dist: rich<16.0,>=13.7
 Requires-Dist: sqlglot<31.0.0,>=26.6.0
-Requires-Dist: setuptools>=60
 Requires-Dist: python-dotenv<2.0.0,>=1.0.0
 Requires-Dist: boto3<2.0.0,>=1.34.41
 Requires-Dist: Jinja2<4.0.0,>=3.1.5
@@ -29,6 +28,7 @@ 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<4.0.0,>=3.1.2
 Requires-Dist: deepdiff<10.0.0,>=6.0.0
+Requires-Dist: setuptools>=70
 Provides-Extra: avro
 Requires-Dist: avro==1.12.1; extra == "avro"
 Provides-Extra: bigquery
@@ -41,7 +41,7 @@ Provides-Extra: databricks
 Requires-Dist: soda-core-spark-df<3.6.0,>=3.3.20; extra == "databricks"
 Requires-Dist: soda-core-spark[databricks]<3.6.0,>=3.3.20; extra == "databricks"
 Requires-Dist: databricks-sql-connector<4.3.0,>=3.7.0; extra == "databricks"
-Requires-Dist: databricks-sdk<0.104.0; extra == "databricks"
+Requires-Dist: databricks-sdk<0.109.0; extra == "databricks"
 Requires-Dist: pyspark<5.0.0,>=3.5.0; extra == "databricks"
 Provides-Extra: iceberg
 Requires-Dist: pyiceberg==0.11.1; extra == "iceberg"
@@ -51,14 +51,16 @@ Requires-Dist: soda-core-spark-df<3.6.0,>=3.3.20; extra == "kafka"
 Requires-Dist: pyspark<5.0.0,>=3.5.0; extra == "kafka"
 Provides-Extra: mysql
 Requires-Dist: soda-core-mysql<3.6.0,>=3.3.20; extra == "mysql"
-Requires-Dist: mysql-connector-python<10.0.0,>=8.0.30; extra == "mysql"
+Requires-Dist: mysql-connector-python<9.7.0,>=8.0.30; extra == "mysql"
 Provides-Extra: postgres
 Requires-Dist: soda-core-postgres<3.6.0,>=3.3.20; extra == "postgres"
+Provides-Extra: redshift
+Requires-Dist: soda-core-redshift<3.6.0,>=3.3.20; extra == "redshift"
 Provides-Extra: s3
 Requires-Dist: s3fs<2027.0.0,>=2025.2.0; extra == "s3"
-Requires-Dist: aiobotocore<3.5.0,>=2.17.0; extra == "s3"
+Requires-Dist: aiobotocore<3.8.0,>=2.17.0; extra == "s3"
 Provides-Extra: snowflake
-Requires-Dist: snowflake-connector-python[pandas]<4.5,>=3.6; extra == "snowflake"
+Requires-Dist: snowflake-connector-python[pandas]<4.6,>=3.6; extra == "snowflake"
 Requires-Dist: soda-core-snowflake<3.6.0,>=3.3.20; extra == "snowflake"
 Provides-Extra: sqlserver
 Requires-Dist: soda-core-sqlserver<3.6.0,>=3.3.20; extra == "sqlserver"
@@ -68,8 +70,8 @@ Provides-Extra: athena
 Requires-Dist: soda-core-athena<3.6.0,>=3.3.20; extra == "athena"
 Provides-Extra: trino
 Requires-Dist: soda-core-trino<3.6.0,>=3.3.20; extra == "trino"
-Provides-Extra: dbt
-Requires-Dist: dbt-core>=1.8.0; extra == "dbt"
+Provides-Extra: impala
+Requires-Dist: soda-core-impala<3.6.0,>=3.3.20; extra == "impala"
 Provides-Extra: dbml
 Requires-Dist: pydbml>=1.1.1; extra == "dbml"
 Provides-Extra: duckdb
@@ -80,24 +82,24 @@ 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.136.0; extra == "api"
-Requires-Dist: uvicorn==0.44.0; extra == "api"
+Requires-Dist: fastapi==0.136.1; extra == "api"
+Requires-Dist: uvicorn<0.47.0,>=0.44.0; extra == "api"
 Provides-Extra: protobuf
-Requires-Dist: grpcio-tools>=1.53; extra == "protobuf"
+Requires-Dist: protobuf<8.0,>=3.20; extra == "protobuf"
 Provides-Extra: all
-Requires-Dist: datacontract-cli[api,athena,bigquery,csv,databricks,dbml,dbt,duckdb,excel,iceberg,kafka,mysql,oracle,parquet,postgres,protobuf,rdf,s3,snowflake,sqlserver,trino]; extra == "all"
+Requires-Dist: datacontract-cli[api,athena,bigquery,csv,databricks,dbml,duckdb,excel,iceberg,impala,kafka,mysql,oracle,parquet,postgres,protobuf,rdf,redshift,s3,snowflake,sqlserver,trino]; 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.1.22; extra == "dev"
+Requires-Dist: moto==5.2.1; extra == "dev"
 Requires-Dist: pandas>=2.1.0; extra == "dev"
-Requires-Dist: pre-commit<4.6.0,>=3.7.1; extra == "dev"
+Requires-Dist: pre-commit<4.7.0,>=3.7.1; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: pymssql==2.3.13; extra == "dev"
-Requires-Dist: ruff==0.15.11; extra == "dev"
+Requires-Dist: ruff==0.15.12; extra == "dev"
 Requires-Dist: testcontainers[kafka,minio,mssql,mysql,postgres]==4.14.2; extra == "dev"
 Requires-Dist: trino==0.337.0; extra == "dev"
 Dynamic: license-file
@@ -230,6 +232,9 @@ $ datacontract changelog v1.odcs.yaml v2.odcs.yaml
 # execute schema and quality checks (define credentials as environment variables)
 $ datacontract test odcs.yaml
 
+# generate dbt tests from a contract into your dbt project and run `dbt test`
+$ datacontract dbt sync orders.odcs.yaml --project-dir ./warehouse
+
 # export data contract as html (other formats: avro, dbt-models, dbt-sources, dbt-staging-sql, jsonschema, odcs, rdf, sql, sodacl, terraform, ...)
 $ datacontract export html datacontract.yaml --output odcs.html
 
@@ -345,23 +350,26 @@ A list of available extras:
 | Amazon Athena           | `pip install datacontract-cli[athena]`     |
 | Avro Support            | `pip install datacontract-cli[avro]`       |
 | Google BigQuery         | `pip install datacontract-cli[bigquery]`   |
+| CSV                     | `pip install datacontract-cli[csv]`        |
 | Databricks Integration  | `pip install datacontract-cli[databricks]` |
+| DBML                    | `pip install datacontract-cli[dbml]`       |
 | DuckDB (local/S3/GCS/Azure file testing) | `pip install datacontract-cli[duckdb]` |
+| Excel                   | `pip install datacontract-cli[excel]`      |
 | Iceberg                 | `pip install datacontract-cli[iceberg]`    |
+| Impala                  | `pip install datacontract-cli[impala]`     |
 | Kafka Integration       | `pip install datacontract-cli[kafka]`      |
 | MySQL Integration       | `pip install datacontract-cli[mysql]`      |
+| Oracle                  | `pip install datacontract-cli[oracle]`     |
+| Parquet                 | `pip install datacontract-cli[parquet]`    |
 | PostgreSQL Integration  | `pip install datacontract-cli[postgres]`   |
+| protobuf                | `pip install datacontract-cli[protobuf]`   |
+| RDF                     | `pip install datacontract-cli[rdf]`        |
+| Amazon Redshift         | `pip install datacontract-cli[redshift]`   |
 | S3 Integration          | `pip install datacontract-cli[s3]`         |
 | Snowflake Integration   | `pip install datacontract-cli[snowflake]`  |
 | Microsoft SQL Server    | `pip install datacontract-cli[sqlserver]`  |
 | Trino                   | `pip install datacontract-cli[trino]`      |
-| Impala                  | `pip install datacontract-cli[impala]` 	   |
-| dbt                     | `pip install datacontract-cli[dbt]`        |
-| DBML                    | `pip install datacontract-cli[dbml]`       |
-| Parquet                 | `pip install datacontract-cli[parquet]`    |
-| RDF                     | `pip install datacontract-cli[rdf]`        |
 | API (run as web server) | `pip install datacontract-cli[api]`        |
-| protobuf                | `pip install datacontract-cli[protobuf]`   |
 
 
 ## Documentation
@@ -372,6 +380,7 @@ Commands
 - [lint](#lint)
 - [changelog](#changelog)
 - [test](#test)
+- [dbt](#dbt-sync)
 - [ci](#ci)
 - [export](#export)
 - [import](#import)
@@ -442,13 +451,19 @@ Commands
  Show a changelog between two data contracts.                                                       
                                                                                                     
 ╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮
-│ *    v1      TEXT  The location (path) of the source (before) data contract YAML. [required]     │
-│ *    v2      TEXT  The location (path) of the target (after) data contract YAML. [required]      │
+│ *    v1      TEXT  The location (url or path) of the source (before) data contract YAML.         │
+│                    [required]                                                                    │
+│ *    v2      TEXT  The location (url or path) of the target (after) data contract YAML.          │
+│                    [required]                                                                    │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
 │ --debug    --no-debug      Enable debug logging                                                  │
 │ --help                     Show this message and exit.                                           │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+                                                                                                    
+ Example: datacontract changelog datacontract-v1.yaml datacontract-v2.yaml                          
+                                                                                                    
+
 ```
 
 ```bash
@@ -1042,6 +1057,52 @@ models:
 
 </details>
 
+<details markdown="1">
+<summary><strong>Amazon Redshift</strong></summary>
+
+Data Contract CLI can test data in Amazon Redshift (both provisioned clusters and Redshift Serverless).
+
+##### Example
+
+datacontract.yaml
+```yaml
+servers:
+  redshift:
+    type: redshift
+    host: my-workgroup.123456789012.us-east-1.redshift-serverless.amazonaws.com
+    port: 5439
+    database: dev
+    schema: analytics
+models:
+  my_table_1: # corresponds to a table
+    type: table
+    fields:
+      my_column_1: # corresponds to a column
+        type: varchar
+```
+
+##### Environment Variables
+All [parameters supported by Soda](https://docs.soda.io/soda/connect-redshift.html), uppercased and prepended by `DATACONTRACT_REDSHIFT_` prefix.
+For example:
+
+| Soda parameter      | Environment Variable                      | Details             |
+|---------------------|-------------------------------------------|---------------------|
+| `username`          | `DATACONTRACT_REDSHIFT_USERNAME`          |                     |
+| `password`          | `DATACONTRACT_REDSHIFT_PASSWORD`          | leave unset for IAM |
+| `region`            | `DATACONTRACT_REDSHIFT_REGION`            | for IAM             |
+| `access_key_id`     | `DATACONTRACT_REDSHIFT_ACCESS_KEY_ID`     | for IAM             |
+| `secret_access_key` | `DATACONTRACT_REDSHIFT_SECRET_ACCESS_KEY` | for IAM             |
+| `role_arn`          | `DATACONTRACT_REDSHIFT_ROLE_ARN`          | for IAM             |
+
+IAM credentials can be supplied in two ways:
+
+1. **AWS_PROFILE** — set `AWS_PROFILE` in your shell to a profile defined in `~/.aws/credentials` and `DATACONTRACT_REDSHIFT_REGION`.
+2. **Explicit keys** — set `DATACONTRACT_REDSHIFT_REGION`, `..._ACCESS_KEY_ID`, `..._SECRET_ACCESS_KEY`, and `..._SESSION_TOKEN` for temporary credentials, or `..._ROLE_ARN` to assume a role.
+
+>IAM authentication is supported only for **provisioned** Redshift clusters.
+
+</details>
+
 <details markdown="1">
 <summary><strong>MySQL</strong></summary>
 
@@ -1221,6 +1282,84 @@ models:
 
 </details>
 
+### dbt sync
+> The `dbt sync` command is still work in progress and will receive further functionality and documentation soon.
+```
+                                                                                                    
+ Usage: datacontract dbt sync [OPTIONS] [CONTRACT]                                                  
+                                                                                                    
+ Generate dbt tests from an ODCS contract and run them.                                             
+                                                                                                    
+ Within the specified dbt project, this command wipes `<model-paths>/datacontract_cli/` and         
+ `<test-paths>/datacontract_cli/`, regenerates them from the contract, then runs `dbt test`.        
+                                                                                                    
+╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮
+│   contract      [CONTRACT]  Path to the ODCS data contract. If omitted, searches for a single    │
+│                             `*.odcs.yaml` in the current directory and its subdirectories.       │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
+│ --project-dir                                  PATH                 Path to the dbt project root │
+│                                                                     (must contain                │
+│                                                                     `dbt_project.yml`). Defaults │
+│                                                                     to the current directory.    │
+│ --schema-name                                  TEXT                 Which ODCS schema object to  │
+│                                                                     sync, by name.               │
+│                                                                     [default: all]               │
+│ --model-resolution                             [name|physicalName]  How to map an ODCS schema to │
+│                                                                     a dbt model name.            │
+│                                                                     [default: name]              │
+│ --target                                       TEXT                 Forwarded to `dbt test       │
+│                                                                     --target`.                   │
+│ --profiles-dir                                 PATH                 Forwarded to `dbt test       │
+│                                                                     --profiles-dir`.             │
+│ --skip-tests          --run-tests                                   Generate tests but skip      │
+│                                                                     running `dbt test`.          │
+│                                                                     [default: run-tests]         │
+│ --publish                                      TEXT                 The url to publish the       │
+│                                                                     results after the test.      │
+│ --server                                       TEXT                 ODCS server name for         │
+│                                                                     published test results.      │
+│                                                                     Auto-selected if the         │
+│                                                                     contract contains only one   │
+│                                                                     server. Otherwise defaults   │
+│                                                                     to --target.                 │
+│ --ssl-verification    --no-ssl-verification                         SSL verification when        │
+│                                                                     publishing test results.     │
+│                                                                     [default: ssl-verification]  │
+│ --debug               --no-debug                                    Enable debug logging         │
+│ --help                                                              Show this message and exit.  │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+                                                                                                    
+ Example: datacontract dbt sync orders.odcs.yaml --project-dir ./warehouse                          
+                                                                                                    
+
+```
+
+`datacontract dbt sync` generates dbt tests from an ODCS data contract directly into your dbt project and (by default) runs `dbt test` against them. The contract becomes the single source of truth for column-level constraints and quality checks. It is recommended to remove existing dbt tests to avoid duplication.
+
+On each run, the command:
+
+- **Wipes and regenerates** the `models/datacontract_cli/` and `tests/datacontract_cli/` directories under your dbt project. The paths honor `model-paths` and `test-paths` in `dbt_project.yml`.
+- **Emits one YAML model file per ODCS schema** that uses dbt's built-in tests and [`dbt_utils`](https://github.com/dbt-labs/dbt-utils).
+- **Emits singular SQL tests** for all ODCS `quality` that can't be expressed as native YAML tests.
+- **Runs `dbt test --select tag:datacontract_cli`** to run the generated tests; pre-existing dbt tests are untouched. Pass `--skip-tests` to regenerate without invoking dbt.
+
+Prerequisites: `dbt-core` plus an adapter (e.g. `dbt-duckdb`, `dbt-postgres`) on `PATH`, [`dbt_utils`](https://github.com/dbt-labs/dbt-utils) installed in your dbt project's `packages.yml`.
+
+```bash
+# Auto-discover a contract named *.odcs.yaml in a dbt project
+$ datacontract dbt sync
+
+# Explicit contract, run against a specific dbt target
+$ datacontract dbt sync orders.odcs.yaml --project-dir ./warehouse --target dev
+
+# Only generate dbt tests, don't run them
+$ datacontract dbt sync orders.odcs.yaml --skip-tests
+
+# Run and publish results to an Entropy Data instance
+$ datacontract dbt sync orders.odcs.yaml --publish https://api.entropy-data.com/api/test-results
+```
+
 ### ci
 ```
                                                                                                     
@@ -1271,6 +1410,9 @@ models:
 │ --help                                                                Show this message and      │
 │                                                                       exit.                      │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+                                                                                                    
+ Example: datacontract ci datacontract.yaml --output test-results.xml --output-format junit         
+                                                                                                    
 
 ```
 
@@ -1395,7 +1537,7 @@ steps:
                                                                                                     
  Example: datacontract export html datacontract.yaml --output datacontract.html                     
  For SQL dialects (postgres, mysql, snowflake, databricks, sqlserver, trino, oracle), use           
- `datacontract export sql --dialect <dialect>`.                                                 
+ `datacontract export sql --dialect <dialect>`.                                                     
                                                                                                     
 
 ```
@@ -1742,9 +1884,9 @@ For more information about the Excel template structure, visit the [ODCS Excel T
 │ --help          Show this message and exit.                                                      │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
+│ dbt         Import a data contract from a dbt manifest file.                                     │
 │ sql         Import a data contract from a SQL DDL file.                                          │
 │ avro        Import a data contract from an Avro schema file.                                     │
-│ dbt         Import a data contract from a dbt manifest file.                                     │
 │ dbml        Import a data contract from a DBML file.                                             │
 │ glue        Import a data contract from AWS Glue.                                                │
 │ bigquery    Import a data contract from BigQuery.                                                │
@@ -1972,7 +2114,17 @@ datacontract import csv --source "test.csv"
 <details markdown="1">
 <summary><strong>protobuf</strong></summary>
 
-Importing from protobuf File. Specify file in `source` parameter. 
+Importing from protobuf File. Specify file in `source` parameter.
+
+Requires the `protoc` compiler installed on the system. Install with:
+
+| Platform       | Command                              |
+|----------------|--------------------------------------|
+| macOS          | `brew install protobuf`              |
+| Debian/Ubuntu  | `sudo apt install protobuf-compiler` |
+| Fedora/RHEL    | `sudo dnf install protobuf-compiler` |
+| Arch           | `sudo pacman -S protobuf`            |
+| Windows        | `choco install protoc` (or [download a release](https://github.com/protocolbuffers/protobuf/releases)) |
 
 Example:
 
@@ -2124,9 +2276,9 @@ Create a data contract based on the actual data. This is the fastest way to get
 
 4. Set up a CI pipeline that executes daily for continuous quality checks. Use the [`ci`](#ci) command for
    CI-optimized output (GitHub Actions annotations and step summary, Azure DevOps annotations).
-   You can also report the test results to tools like [Data Mesh Manager](https://datamesh-manager.com).
+   You can also report the test results to tools like [Entropy Data](https://entropy-data.com).
    ```bash
-   $ datacontract ci --publish https://api.datamesh-manager.com/api/test-results
+   $ datacontract ci --publish https://api.entropy-data.com/api/test-results
    ```
 
 ### Contract-First

{datacontract_cli-0.12.1 → datacontract_cli-0.12.3}/README.md

@@ -126,6 +126,9 @@ $ datacontract changelog v1.odcs.yaml v2.odcs.yaml
 # execute schema and quality checks (define credentials as environment variables)
 $ datacontract test odcs.yaml
 
+# generate dbt tests from a contract into your dbt project and run `dbt test`
+$ datacontract dbt sync orders.odcs.yaml --project-dir ./warehouse
+
 # export data contract as html (other formats: avro, dbt-models, dbt-sources, dbt-staging-sql, jsonschema, odcs, rdf, sql, sodacl, terraform, ...)
 $ datacontract export html datacontract.yaml --output odcs.html
 
@@ -241,23 +244,26 @@ A list of available extras:
 | Amazon Athena           | `pip install datacontract-cli[athena]`     |
 | Avro Support            | `pip install datacontract-cli[avro]`       |
 | Google BigQuery         | `pip install datacontract-cli[bigquery]`   |
+| CSV                     | `pip install datacontract-cli[csv]`        |
 | Databricks Integration  | `pip install datacontract-cli[databricks]` |
+| DBML                    | `pip install datacontract-cli[dbml]`       |
 | DuckDB (local/S3/GCS/Azure file testing) | `pip install datacontract-cli[duckdb]` |
+| Excel                   | `pip install datacontract-cli[excel]`      |
 | Iceberg                 | `pip install datacontract-cli[iceberg]`    |
+| Impala                  | `pip install datacontract-cli[impala]`     |
 | Kafka Integration       | `pip install datacontract-cli[kafka]`      |
 | MySQL Integration       | `pip install datacontract-cli[mysql]`      |
+| Oracle                  | `pip install datacontract-cli[oracle]`     |
+| Parquet                 | `pip install datacontract-cli[parquet]`    |
 | PostgreSQL Integration  | `pip install datacontract-cli[postgres]`   |
+| protobuf                | `pip install datacontract-cli[protobuf]`   |
+| RDF                     | `pip install datacontract-cli[rdf]`        |
+| Amazon Redshift         | `pip install datacontract-cli[redshift]`   |
 | S3 Integration          | `pip install datacontract-cli[s3]`         |
 | Snowflake Integration   | `pip install datacontract-cli[snowflake]`  |
 | Microsoft SQL Server    | `pip install datacontract-cli[sqlserver]`  |
 | Trino                   | `pip install datacontract-cli[trino]`      |
-| Impala                  | `pip install datacontract-cli[impala]` 	   |
-| dbt                     | `pip install datacontract-cli[dbt]`        |
-| DBML                    | `pip install datacontract-cli[dbml]`       |
-| Parquet                 | `pip install datacontract-cli[parquet]`    |
-| RDF                     | `pip install datacontract-cli[rdf]`        |
 | API (run as web server) | `pip install datacontract-cli[api]`        |
-| protobuf                | `pip install datacontract-cli[protobuf]`   |
 
 
 ## Documentation
@@ -268,6 +274,7 @@ Commands
 - [lint](#lint)
 - [changelog](#changelog)
 - [test](#test)
+- [dbt](#dbt-sync)
 - [ci](#ci)
 - [export](#export)
 - [import](#import)
@@ -338,13 +345,19 @@ Commands
  Show a changelog between two data contracts.                                                       
                                                                                                     
 ╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮
-│ *    v1      TEXT  The location (path) of the source (before) data contract YAML. [required]     │
-│ *    v2      TEXT  The location (path) of the target (after) data contract YAML. [required]      │
+│ *    v1      TEXT  The location (url or path) of the source (before) data contract YAML.         │
+│                    [required]                                                                    │
+│ *    v2      TEXT  The location (url or path) of the target (after) data contract YAML.          │
+│                    [required]                                                                    │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
 │ --debug    --no-debug      Enable debug logging                                                  │
 │ --help                     Show this message and exit.                                           │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+                                                                                                    
+ Example: datacontract changelog datacontract-v1.yaml datacontract-v2.yaml                          
+                                                                                                    
+
 ```
 
 ```bash
@@ -938,6 +951,52 @@ models:
 
 </details>
 
+<details markdown="1">
+<summary><strong>Amazon Redshift</strong></summary>
+
+Data Contract CLI can test data in Amazon Redshift (both provisioned clusters and Redshift Serverless).
+
+##### Example
+
+datacontract.yaml
+```yaml
+servers:
+  redshift:
+    type: redshift
+    host: my-workgroup.123456789012.us-east-1.redshift-serverless.amazonaws.com
+    port: 5439
+    database: dev
+    schema: analytics
+models:
+  my_table_1: # corresponds to a table
+    type: table
+    fields:
+      my_column_1: # corresponds to a column
+        type: varchar
+```
+
+##### Environment Variables
+All [parameters supported by Soda](https://docs.soda.io/soda/connect-redshift.html), uppercased and prepended by `DATACONTRACT_REDSHIFT_` prefix.
+For example:
+
+| Soda parameter      | Environment Variable                      | Details             |
+|---------------------|-------------------------------------------|---------------------|
+| `username`          | `DATACONTRACT_REDSHIFT_USERNAME`          |                     |
+| `password`          | `DATACONTRACT_REDSHIFT_PASSWORD`          | leave unset for IAM |
+| `region`            | `DATACONTRACT_REDSHIFT_REGION`            | for IAM             |
+| `access_key_id`     | `DATACONTRACT_REDSHIFT_ACCESS_KEY_ID`     | for IAM             |
+| `secret_access_key` | `DATACONTRACT_REDSHIFT_SECRET_ACCESS_KEY` | for IAM             |
+| `role_arn`          | `DATACONTRACT_REDSHIFT_ROLE_ARN`          | for IAM             |
+
+IAM credentials can be supplied in two ways:
+
+1. **AWS_PROFILE** — set `AWS_PROFILE` in your shell to a profile defined in `~/.aws/credentials` and `DATACONTRACT_REDSHIFT_REGION`.
+2. **Explicit keys** — set `DATACONTRACT_REDSHIFT_REGION`, `..._ACCESS_KEY_ID`, `..._SECRET_ACCESS_KEY`, and `..._SESSION_TOKEN` for temporary credentials, or `..._ROLE_ARN` to assume a role.
+
+>IAM authentication is supported only for **provisioned** Redshift clusters.
+
+</details>
+
 <details markdown="1">
 <summary><strong>MySQL</strong></summary>
 
@@ -1117,6 +1176,84 @@ models:
 
 </details>
 
+### dbt sync
+> The `dbt sync` command is still work in progress and will receive further functionality and documentation soon.
+```
+                                                                                                    
+ Usage: datacontract dbt sync [OPTIONS] [CONTRACT]                                                  
+                                                                                                    
+ Generate dbt tests from an ODCS contract and run them.                                             
+                                                                                                    
+ Within the specified dbt project, this command wipes `<model-paths>/datacontract_cli/` and         
+ `<test-paths>/datacontract_cli/`, regenerates them from the contract, then runs `dbt test`.        
+                                                                                                    
+╭─ Arguments ──────────────────────────────────────────────────────────────────────────────────────╮
+│   contract      [CONTRACT]  Path to the ODCS data contract. If omitted, searches for a single    │
+│                             `*.odcs.yaml` in the current directory and its subdirectories.       │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
+│ --project-dir                                  PATH                 Path to the dbt project root │
+│                                                                     (must contain                │
+│                                                                     `dbt_project.yml`). Defaults │
+│                                                                     to the current directory.    │
+│ --schema-name                                  TEXT                 Which ODCS schema object to  │
+│                                                                     sync, by name.               │
+│                                                                     [default: all]               │
+│ --model-resolution                             [name|physicalName]  How to map an ODCS schema to │
+│                                                                     a dbt model name.            │
+│                                                                     [default: name]              │
+│ --target                                       TEXT                 Forwarded to `dbt test       │
+│                                                                     --target`.                   │
+│ --profiles-dir                                 PATH                 Forwarded to `dbt test       │
+│                                                                     --profiles-dir`.             │
+│ --skip-tests          --run-tests                                   Generate tests but skip      │
+│                                                                     running `dbt test`.          │
+│                                                                     [default: run-tests]         │
+│ --publish                                      TEXT                 The url to publish the       │
+│                                                                     results after the test.      │
+│ --server                                       TEXT                 ODCS server name for         │
+│                                                                     published test results.      │
+│                                                                     Auto-selected if the         │
+│                                                                     contract contains only one   │
+│                                                                     server. Otherwise defaults   │
+│                                                                     to --target.                 │
+│ --ssl-verification    --no-ssl-verification                         SSL verification when        │
+│                                                                     publishing test results.     │
+│                                                                     [default: ssl-verification]  │
+│ --debug               --no-debug                                    Enable debug logging         │
+│ --help                                                              Show this message and exit.  │
+╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+                                                                                                    
+ Example: datacontract dbt sync orders.odcs.yaml --project-dir ./warehouse                          
+                                                                                                    
+
+```
+
+`datacontract dbt sync` generates dbt tests from an ODCS data contract directly into your dbt project and (by default) runs `dbt test` against them. The contract becomes the single source of truth for column-level constraints and quality checks. It is recommended to remove existing dbt tests to avoid duplication.
+
+On each run, the command:
+
+- **Wipes and regenerates** the `models/datacontract_cli/` and `tests/datacontract_cli/` directories under your dbt project. The paths honor `model-paths` and `test-paths` in `dbt_project.yml`.
+- **Emits one YAML model file per ODCS schema** that uses dbt's built-in tests and [`dbt_utils`](https://github.com/dbt-labs/dbt-utils).
+- **Emits singular SQL tests** for all ODCS `quality` that can't be expressed as native YAML tests.
+- **Runs `dbt test --select tag:datacontract_cli`** to run the generated tests; pre-existing dbt tests are untouched. Pass `--skip-tests` to regenerate without invoking dbt.
+
+Prerequisites: `dbt-core` plus an adapter (e.g. `dbt-duckdb`, `dbt-postgres`) on `PATH`, [`dbt_utils`](https://github.com/dbt-labs/dbt-utils) installed in your dbt project's `packages.yml`.
+
+```bash
+# Auto-discover a contract named *.odcs.yaml in a dbt project
+$ datacontract dbt sync
+
+# Explicit contract, run against a specific dbt target
+$ datacontract dbt sync orders.odcs.yaml --project-dir ./warehouse --target dev
+
+# Only generate dbt tests, don't run them
+$ datacontract dbt sync orders.odcs.yaml --skip-tests
+
+# Run and publish results to an Entropy Data instance
+$ datacontract dbt sync orders.odcs.yaml --publish https://api.entropy-data.com/api/test-results
+```
+
 ### ci
 ```
                                                                                                     
@@ -1167,6 +1304,9 @@ models:
 │ --help                                                                Show this message and      │
 │                                                                       exit.                      │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
+                                                                                                    
+ Example: datacontract ci datacontract.yaml --output test-results.xml --output-format junit         
+                                                                                                    
 
 ```
 
@@ -1291,7 +1431,7 @@ steps:
                                                                                                     
  Example: datacontract export html datacontract.yaml --output datacontract.html                     
  For SQL dialects (postgres, mysql, snowflake, databricks, sqlserver, trino, oracle), use           
- `datacontract export sql --dialect <dialect>`.                                                 
+ `datacontract export sql --dialect <dialect>`.                                                     
                                                                                                     
 
 ```
@@ -1638,9 +1778,9 @@ For more information about the Excel template structure, visit the [ODCS Excel T
 │ --help          Show this message and exit.                                                      │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Commands ───────────────────────────────────────────────────────────────────────────────────────╮
+│ dbt         Import a data contract from a dbt manifest file.                                     │
 │ sql         Import a data contract from a SQL DDL file.                                          │
 │ avro        Import a data contract from an Avro schema file.                                     │
-│ dbt         Import a data contract from a dbt manifest file.                                     │
 │ dbml        Import a data contract from a DBML file.                                             │
 │ glue        Import a data contract from AWS Glue.                                                │
 │ bigquery    Import a data contract from BigQuery.                                                │
@@ -1868,7 +2008,17 @@ datacontract import csv --source "test.csv"
 <details markdown="1">
 <summary><strong>protobuf</strong></summary>
 
-Importing from protobuf File. Specify file in `source` parameter. 
+Importing from protobuf File. Specify file in `source` parameter.
+
+Requires the `protoc` compiler installed on the system. Install with:
+
+| Platform       | Command                              |
+|----------------|--------------------------------------|
+| macOS          | `brew install protobuf`              |
+| Debian/Ubuntu  | `sudo apt install protobuf-compiler` |
+| Fedora/RHEL    | `sudo dnf install protobuf-compiler` |
+| Arch           | `sudo pacman -S protobuf`            |
+| Windows        | `choco install protoc` (or [download a release](https://github.com/protocolbuffers/protobuf/releases)) |
 
 Example:
 
@@ -2020,9 +2170,9 @@ Create a data contract based on the actual data. This is the fastest way to get
 
 4. Set up a CI pipeline that executes daily for continuous quality checks. Use the [`ci`](#ci) command for
    CI-optimized output (GitHub Actions annotations and step summary, Azure DevOps annotations).
-   You can also report the test results to tools like [Data Mesh Manager](https://datamesh-manager.com).
+   You can also report the test results to tools like [Entropy Data](https://entropy-data.com).
    ```bash
-   $ datacontract ci --publish https://api.datamesh-manager.com/api/test-results
+   $ datacontract ci --publish https://api.entropy-data.com/api/test-results
    ```
 
 ### Contract-First