datacontract-cli 0.10.27__tar.gz → 0.10.29__tar.gz

{datacontract_cli-0.10.27/datacontract_cli.egg-info → datacontract_cli-0.10.29}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: datacontract-cli
-Version: 0.10.27
+Version: 0.10.29
 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
@@ -28,7 +28,7 @@ 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
 Requires-Dist: jinja_partials<1.0.0,>=0.2.1
-Requires-Dist: datacontract-specification<2.0.0,>=1.1.1
+Requires-Dist: datacontract-specification<2.0.0,>=1.2.0
 Requires-Dist: open-data-contract-standard<4.0.0,>=3.0.4
 Provides-Extra: avro
 Requires-Dist: avro==1.12.0; extra == "avro"
@@ -42,19 +42,21 @@ 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.1.0,>=3.7.0; extra == "databricks"
-Requires-Dist: databricks-sdk<0.51.0; extra == "databricks"
+Requires-Dist: databricks-sdk<0.58.0; extra == "databricks"
+Requires-Dist: pyspark<4.0.0,>=3.5.5; extra == "databricks"
 Provides-Extra: iceberg
-Requires-Dist: pyiceberg==0.8.1; extra == "iceberg"
+Requires-Dist: pyiceberg==0.9.1; extra == "iceberg"
 Provides-Extra: kafka
 Requires-Dist: datacontract-cli[avro]; extra == "kafka"
 Requires-Dist: soda-core-spark-df<3.6.0,>=3.3.20; extra == "kafka"
+Requires-Dist: pyspark<4.0.0,>=3.5.5; extra == "kafka"
 Provides-Extra: postgres
 Requires-Dist: soda-core-postgres<3.6.0,>=3.3.20; extra == "postgres"
 Provides-Extra: s3
 Requires-Dist: s3fs<2026.0.0,>=2025.2.0; extra == "s3"
 Requires-Dist: aiobotocore<2.23.0,>=2.17.0; extra == "s3"
 Provides-Extra: snowflake
-Requires-Dist: snowflake-connector-python[pandas]<3.15,>=3.6; extra == "snowflake"
+Requires-Dist: snowflake-connector-python[pandas]<3.16,>=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"
@@ -69,8 +71,8 @@ Requires-Dist: pyarrow>=18.1.0; extra == "parquet"
 Provides-Extra: rdf
 Requires-Dist: rdflib==7.0.0; extra == "rdf"
 Provides-Extra: api
-Requires-Dist: fastapi==0.115.12; extra == "api"
-Requires-Dist: uvicorn==0.34.2; extra == "api"
+Requires-Dist: fastapi==0.115.14; extra == "api"
+Requires-Dist: uvicorn==0.35.0; extra == "api"
 Provides-Extra: protobuf
 Requires-Dist: grpcio-tools>=1.53; extra == "protobuf"
 Provides-Extra: all
@@ -79,15 +81,15 @@ 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: moto==5.1.4; extra == "dev"
+Requires-Dist: moto==5.1.6; extra == "dev"
 Requires-Dist: pandas>=2.1.0; extra == "dev"
 Requires-Dist: pre-commit<4.3.0,>=3.7.1; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-xdist; extra == "dev"
-Requires-Dist: pymssql==2.3.4; extra == "dev"
+Requires-Dist: pymssql==2.3.6; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
 Requires-Dist: testcontainers[kafka,minio,mssql,postgres]==4.10.0; extra == "dev"
-Requires-Dist: trino==0.333.0; extra == "dev"
+Requires-Dist: trino==0.335.0; extra == "dev"
 Dynamic: license-file
 
 # Data Contract CLI
@@ -399,30 +401,38 @@ Commands
 │                             [default: datacontract.yaml]                                         │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
-│ --schema                                       TEXT     The location (url or path) of the Data   │
-│                                                         Contract Specification JSON Schema       │
-│                                                         [default: None]                          │
-│ --server                                       TEXT     The server configuration to run the      │
-│                                                         schema and quality tests. Use the key of │
-│                                                         the server object in the data contract   │
-│                                                         yaml file to refer to a server, e.g.,    │
-│                                                         `production`, or `all` for all servers   │
-│                                                         (default).                               │
-│                                                         [default: all]                           │
-│ --publish                                      TEXT     The url to publish the results after the │
-│                                                         test                                     │
-│                                                         [default: None]                          │
-│ --output                                       PATH     Specify the file path where the test     │
-│                                                         results should be written to (e.g.,      │
-│                                                         './test-results/TEST-datacontract.xml'). │
-│                                                         [default: None]                          │
-│ --output-format                                [junit]  The target format for the test results.  │
-│                                                         [default: None]                          │
-│ --logs                --no-logs                         Print logs [default: no-logs]            │
-│ --ssl-verification    --no-ssl-verification             SSL verification when publishing the     │
-│                                                         data contract.                           │
-│                                                         [default: ssl-verification]              │
-│ --help                                                  Show this message and exit.              │
+│ --schema                                               TEXT     The location (url or path) of    │
+│                                                                 the Data Contract Specification  │
+│                                                                 JSON Schema                      │
+│                                                                 [default: None]                  │
+│ --server                                               TEXT     The server configuration to run  │
+│                                                                 the schema and quality tests.    │
+│                                                                 Use the key of the server object │
+│                                                                 in the data contract yaml file   │
+│                                                                 to refer to a server, e.g.,      │
+│                                                                 `production`, or `all` for all   │
+│                                                                 servers (default).               │
+│                                                                 [default: all]                   │
+│ --publish-test-results    --no-publish-test-results             Publish the results after the    │
+│                                                                 test                             │
+│                                                                 [default:                        │
+│                                                                 no-publish-test-results]         │
+│ --publish                                              TEXT     DEPRECATED. The url to publish   │
+│                                                                 the results after the test.      │
+│                                                                 [default: None]                  │
+│ --output                                               PATH     Specify the file path where the  │
+│                                                                 test results should be written   │
+│                                                                 to (e.g.,                        │
+│                                                                 './test-results/TEST-datacontra… │
+│                                                                 [default: None]                  │
+│ --output-format                                        [junit]  The target format for the test   │
+│                                                                 results.                         │
+│                                                                 [default: None]                  │
+│ --logs                    --no-logs                             Print logs [default: no-logs]    │
+│ --ssl-verification        --no-ssl-verification                 SSL verification when publishing │
+│                                                                 the data contract.               │
+│                                                                 [default: ssl-verification]      │
+│ --help                                                          Show this message and exit.      │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 
 ```
@@ -996,6 +1006,21 @@ Available export options:
 | `custom`             | Export to Custom format with Jinja                      | ✅      |
 | Missing something?   | Please create an issue on GitHub                        | TBD    |
 
+#### SQL
+
+The `export` function converts a given data contract into a SQL data definition language (DDL).
+
+```shell
+datacontract export datacontract.yaml --format sql --output output.sql
+```
+
+If using Databricks, and an error is thrown when trying to deploy the SQL DDLs with `variant` columns set the following properties.
+
+```shell
+spark.conf.set(“spark.databricks.delta.schema.typeCheck.enabled”, “false”)
+from datacontract.model import data_contract_specification
+data_contract_specification.DATACONTRACT_TYPES.append(“variant”)
+```
 
 #### Great Expectations
 
@@ -1003,7 +1028,7 @@ The `export` function transforms a specified data contract into a comprehensive
 If the contract includes multiple models, you need to specify the names of the model you wish to export.
 
 ```shell
-datacontract  export datacontract.yaml --format great-expectations --model orders
+datacontract export datacontract.yaml --format great-expectations --model orders
 ```
 
 The export creates a list of expectations by utilizing:
@@ -1028,7 +1053,7 @@ To further customize the export, the following optional arguments are available:
 
 #### RDF
 
-The export function converts a given data contract into a RDF representation. You have the option to
+The `export` function converts a given data contract into a RDF representation. You have the option to
 add a base_url which will be used as the default prefix to resolve relative IRIs inside the document.
 
 ```shell
@@ -1261,9 +1286,9 @@ FROM
                                                                                                     
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
 │ *  --format                       [sql|avro|dbt|dbml|glue|jsonsc  The format of the source file. │
-│                                   hema|bigquery|odcs|unity|spark  [default: None]                │
-│                                   |iceberg|parquet|csv|protobuf|  [required]                     │
-│                                   excel]                                                         │
+│                                   hema|json|bigquery|odcs|unity|  [default: None]                │
+│                                   spark|iceberg|parquet|csv|prot  [required]                     │
+│                                   obuf|excel]                                                    │
 │    --output                       PATH                            Specify the file path where    │
 │                                                                   the Data Contract will be      │
 │                                                                   saved. If no path is provided, │
@@ -1273,6 +1298,10 @@ FROM
 │    --source                       TEXT                            The path to the file that      │
 │                                                                   should be imported.            │
 │                                                                   [default: None]                │
+│    --spec                         [datacontract_specification|od  The format of the data         │
+│                                   cs]                             contract to import.            │
+│                                                                   [default:                      │
+│                                                                   datacontract_specification]    │
 │    --dialect                      TEXT                            The SQL dialect to use when    │
 │                                                                   importing SQL files, e.g.,     │
 │                                                                   postgres, tsql, bigquery.      │
@@ -1361,11 +1390,11 @@ Available import options:
 | `jsonschema`       | Import from JSON Schemas                       | ✅      |
 | `odcs`             | Import from Open Data Contract Standard (ODCS) | ✅      |
 | `parquet`          | Import from Parquet File Metadata              | ✅      |
-| `protobuf`         | Import from Protobuf schemas                   | ✅    |
-| `spark`            | Import from Spark StructTypes                  | ✅      |
+| `protobuf`         | Import from Protobuf schemas                   | ✅      |
+| `spark`            | Import from Spark StructTypes, Variant         | ✅      |
 | `sql`              | Import from SQL DDL                            | ✅      |
 | `unity`            | Import from Databricks Unity Catalog           | partial |
-| Missing something? | Please create an issue on GitHub               | TBD    |
+| Missing something? | Please create an issue on GitHub               | TBD     |
 
 
 #### ODCS
@@ -1467,14 +1496,31 @@ datacontract import --format glue --source <database_name>
 
 #### Spark
 
-Importing from Spark table or view these must be created or accessible in the Spark context. Specify tables list in `source` parameter.
-
-Example:
+Importing from Spark table or view these must be created or accessible in the Spark context. Specify tables list in `source` parameter.  If the `source` tables are registered as tables in Databricks, and they have a table-level descriptions they will also be added to the Data Contract Specification.
 
 ```bash
+# Example: Import Spark table(s) from Spark context
 datacontract import --format spark --source "users,orders"
 ```
 
+```bash
+# Example: Import Spark table
+DataContract().import_from_source("spark", "users")
+DataContract().import_from_source(format = "spark", source = "users")
+
+# Example: Import Spark dataframe
+DataContract().import_from_source("spark", "users", dataframe = df_user)
+DataContract().import_from_source(format = "spark", source = "users", dataframe = df_user)
+
+# Example: Import Spark table + table description
+DataContract().import_from_source("spark", "users", description = "description") 
+DataContract().import_from_source(format = "spark", source = "users", description = "description")
+
+# Example: Import Spark dataframe + table description
+DataContract().import_from_source("spark", "users", dataframe = df_user, description = "description")
+DataContract().import_from_source(format = "spark", source = "users", dataframe = df_user, description = "description")
+```
+
 #### DBML
 
 Importing from DBML Documents.
@@ -1666,6 +1712,8 @@ datacontract catalog --files "*.odcs.yaml"
  information.                                                                                       
  To connect to servers (such as a Snowflake data source), set the credentials as environment        
  variables as documented in https://cli.datacontract.com/#test                                      
+ It is possible to run the API with extra arguments for `uvicorn.run()` as keyword arguments, e.g.: 
+ `datacontract api --port 1234 --root_path /datacontract`.                                          
                                                                                                     
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
 │ --port        INTEGER  Bind socket to this port. [default: 4242]                                 │
@@ -1932,7 +1980,7 @@ if __name__ == "__main__":
 Output
 
 ```yaml
-dataContractSpecification: 1.1.0
+dataContractSpecification: 1.2.0
 id: uuid-custom
 info:
   title: my_custom_imported_data
@@ -1951,22 +1999,9 @@ models:
 ```
 ## Development Setup
 
-Python base interpreter should be 3.11.x (unless working on 3.12 release candidate).
-
-```bash
-# create venv
-python3.11 -m venv venv
-source venv/bin/activate
-
-# Install Requirements
-pip install --upgrade pip setuptools wheel
-pip install -e '.[dev]'
-pre-commit install
-pre-commit run --all-files
-pytest
-```
-
-### Use uv (recommended)
+- Install [uv](https://docs.astral.sh/uv/)
+- Python base interpreter should be 3.11.x .
+- Docker engine must be running to execute the tests.
 
 ```bash
 # make sure uv is installed
@@ -2048,6 +2083,7 @@ We are happy to receive your contributions. Propose your change in an issue or d
 - [INNOQ](https://innoq.com)
 - [Data Catering](https://data.catering/)
 - [Oliver Wyman](https://www.oliverwyman.com/)
+- [dmTECH](https://www.dmtech.tech/de)
 - And many more. To add your company, please create a pull request.
 
 ## Related Tools

{datacontract_cli-0.10.27 → datacontract_cli-0.10.29}/README.md

@@ -307,30 +307,38 @@ Commands
 │                             [default: datacontract.yaml]                                         │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
-│ --schema                                       TEXT     The location (url or path) of the Data   │
-│                                                         Contract Specification JSON Schema       │
-│                                                         [default: None]                          │
-│ --server                                       TEXT     The server configuration to run the      │
-│                                                         schema and quality tests. Use the key of │
-│                                                         the server object in the data contract   │
-│                                                         yaml file to refer to a server, e.g.,    │
-│                                                         `production`, or `all` for all servers   │
-│                                                         (default).                               │
-│                                                         [default: all]                           │
-│ --publish                                      TEXT     The url to publish the results after the │
-│                                                         test                                     │
-│                                                         [default: None]                          │
-│ --output                                       PATH     Specify the file path where the test     │
-│                                                         results should be written to (e.g.,      │
-│                                                         './test-results/TEST-datacontract.xml'). │
-│                                                         [default: None]                          │
-│ --output-format                                [junit]  The target format for the test results.  │
-│                                                         [default: None]                          │
-│ --logs                --no-logs                         Print logs [default: no-logs]            │
-│ --ssl-verification    --no-ssl-verification             SSL verification when publishing the     │
-│                                                         data contract.                           │
-│                                                         [default: ssl-verification]              │
-│ --help                                                  Show this message and exit.              │
+│ --schema                                               TEXT     The location (url or path) of    │
+│                                                                 the Data Contract Specification  │
+│                                                                 JSON Schema                      │
+│                                                                 [default: None]                  │
+│ --server                                               TEXT     The server configuration to run  │
+│                                                                 the schema and quality tests.    │
+│                                                                 Use the key of the server object │
+│                                                                 in the data contract yaml file   │
+│                                                                 to refer to a server, e.g.,      │
+│                                                                 `production`, or `all` for all   │
+│                                                                 servers (default).               │
+│                                                                 [default: all]                   │
+│ --publish-test-results    --no-publish-test-results             Publish the results after the    │
+│                                                                 test                             │
+│                                                                 [default:                        │
+│                                                                 no-publish-test-results]         │
+│ --publish                                              TEXT     DEPRECATED. The url to publish   │
+│                                                                 the results after the test.      │
+│                                                                 [default: None]                  │
+│ --output                                               PATH     Specify the file path where the  │
+│                                                                 test results should be written   │
+│                                                                 to (e.g.,                        │
+│                                                                 './test-results/TEST-datacontra… │
+│                                                                 [default: None]                  │
+│ --output-format                                        [junit]  The target format for the test   │
+│                                                                 results.                         │
+│                                                                 [default: None]                  │
+│ --logs                    --no-logs                             Print logs [default: no-logs]    │
+│ --ssl-verification        --no-ssl-verification                 SSL verification when publishing │
+│                                                                 the data contract.               │
+│                                                                 [default: ssl-verification]      │
+│ --help                                                          Show this message and exit.      │
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────╯
 
 ```
@@ -904,6 +912,21 @@ Available export options:
 | `custom`             | Export to Custom format with Jinja                      | ✅      |
 | Missing something?   | Please create an issue on GitHub                        | TBD    |
 
+#### SQL
+
+The `export` function converts a given data contract into a SQL data definition language (DDL).
+
+```shell
+datacontract export datacontract.yaml --format sql --output output.sql
+```
+
+If using Databricks, and an error is thrown when trying to deploy the SQL DDLs with `variant` columns set the following properties.
+
+```shell
+spark.conf.set(“spark.databricks.delta.schema.typeCheck.enabled”, “false”)
+from datacontract.model import data_contract_specification
+data_contract_specification.DATACONTRACT_TYPES.append(“variant”)
+```
 
 #### Great Expectations
 
@@ -911,7 +934,7 @@ The `export` function transforms a specified data contract into a comprehensive
 If the contract includes multiple models, you need to specify the names of the model you wish to export.
 
 ```shell
-datacontract  export datacontract.yaml --format great-expectations --model orders
+datacontract export datacontract.yaml --format great-expectations --model orders
 ```
 
 The export creates a list of expectations by utilizing:
@@ -936,7 +959,7 @@ To further customize the export, the following optional arguments are available:
 
 #### RDF
 
-The export function converts a given data contract into a RDF representation. You have the option to
+The `export` function converts a given data contract into a RDF representation. You have the option to
 add a base_url which will be used as the default prefix to resolve relative IRIs inside the document.
 
 ```shell
@@ -1169,9 +1192,9 @@ FROM
                                                                                                     
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
 │ *  --format                       [sql|avro|dbt|dbml|glue|jsonsc  The format of the source file. │
-│                                   hema|bigquery|odcs|unity|spark  [default: None]                │
-│                                   |iceberg|parquet|csv|protobuf|  [required]                     │
-│                                   excel]                                                         │
+│                                   hema|json|bigquery|odcs|unity|  [default: None]                │
+│                                   spark|iceberg|parquet|csv|prot  [required]                     │
+│                                   obuf|excel]                                                    │
 │    --output                       PATH                            Specify the file path where    │
 │                                                                   the Data Contract will be      │
 │                                                                   saved. If no path is provided, │
@@ -1181,6 +1204,10 @@ FROM
 │    --source                       TEXT                            The path to the file that      │
 │                                                                   should be imported.            │
 │                                                                   [default: None]                │
+│    --spec                         [datacontract_specification|od  The format of the data         │
+│                                   cs]                             contract to import.            │
+│                                                                   [default:                      │
+│                                                                   datacontract_specification]    │
 │    --dialect                      TEXT                            The SQL dialect to use when    │
 │                                                                   importing SQL files, e.g.,     │
 │                                                                   postgres, tsql, bigquery.      │
@@ -1269,11 +1296,11 @@ Available import options:
 | `jsonschema`       | Import from JSON Schemas                       | ✅      |
 | `odcs`             | Import from Open Data Contract Standard (ODCS) | ✅      |
 | `parquet`          | Import from Parquet File Metadata              | ✅      |
-| `protobuf`         | Import from Protobuf schemas                   | ✅    |
-| `spark`            | Import from Spark StructTypes                  | ✅      |
+| `protobuf`         | Import from Protobuf schemas                   | ✅      |
+| `spark`            | Import from Spark StructTypes, Variant         | ✅      |
 | `sql`              | Import from SQL DDL                            | ✅      |
 | `unity`            | Import from Databricks Unity Catalog           | partial |
-| Missing something? | Please create an issue on GitHub               | TBD    |
+| Missing something? | Please create an issue on GitHub               | TBD     |
 
 
 #### ODCS
@@ -1375,14 +1402,31 @@ datacontract import --format glue --source <database_name>
 
 #### Spark
 
-Importing from Spark table or view these must be created or accessible in the Spark context. Specify tables list in `source` parameter.
-
-Example:
+Importing from Spark table or view these must be created or accessible in the Spark context. Specify tables list in `source` parameter.  If the `source` tables are registered as tables in Databricks, and they have a table-level descriptions they will also be added to the Data Contract Specification.
 
 ```bash
+# Example: Import Spark table(s) from Spark context
 datacontract import --format spark --source "users,orders"
 ```
 
+```bash
+# Example: Import Spark table
+DataContract().import_from_source("spark", "users")
+DataContract().import_from_source(format = "spark", source = "users")
+
+# Example: Import Spark dataframe
+DataContract().import_from_source("spark", "users", dataframe = df_user)
+DataContract().import_from_source(format = "spark", source = "users", dataframe = df_user)
+
+# Example: Import Spark table + table description
+DataContract().import_from_source("spark", "users", description = "description") 
+DataContract().import_from_source(format = "spark", source = "users", description = "description")
+
+# Example: Import Spark dataframe + table description
+DataContract().import_from_source("spark", "users", dataframe = df_user, description = "description")
+DataContract().import_from_source(format = "spark", source = "users", dataframe = df_user, description = "description")
+```
+
 #### DBML
 
 Importing from DBML Documents.
@@ -1574,6 +1618,8 @@ datacontract catalog --files "*.odcs.yaml"
  information.                                                                                       
  To connect to servers (such as a Snowflake data source), set the credentials as environment        
  variables as documented in https://cli.datacontract.com/#test                                      
+ It is possible to run the API with extra arguments for `uvicorn.run()` as keyword arguments, e.g.: 
+ `datacontract api --port 1234 --root_path /datacontract`.                                          
                                                                                                     
 ╭─ Options ────────────────────────────────────────────────────────────────────────────────────────╮
 │ --port        INTEGER  Bind socket to this port. [default: 4242]                                 │
@@ -1840,7 +1886,7 @@ if __name__ == "__main__":
 Output
 
 ```yaml
-dataContractSpecification: 1.1.0
+dataContractSpecification: 1.2.0
 id: uuid-custom
 info:
   title: my_custom_imported_data
@@ -1859,22 +1905,9 @@ models:
 ```
 ## Development Setup
 
-Python base interpreter should be 3.11.x (unless working on 3.12 release candidate).
-
-```bash
-# create venv
-python3.11 -m venv venv
-source venv/bin/activate
-
-# Install Requirements
-pip install --upgrade pip setuptools wheel
-pip install -e '.[dev]'
-pre-commit install
-pre-commit run --all-files
-pytest
-```
-
-### Use uv (recommended)
+- Install [uv](https://docs.astral.sh/uv/)
+- Python base interpreter should be 3.11.x .
+- Docker engine must be running to execute the tests.
 
 ```bash
 # make sure uv is installed
@@ -1956,6 +1989,7 @@ We are happy to receive your contributions. Propose your change in an issue or d
 - [INNOQ](https://innoq.com)
 - [Data Catering](https://data.catering/)
 - [Oliver Wyman](https://www.oliverwyman.com/)
+- [dmTECH](https://www.dmtech.tech/de)
 - And many more. To add your company, please create a pull request.
 
 ## Related Tools

{datacontract_cli-0.10.27 → datacontract_cli-0.10.29}/datacontract/api.py

@@ -10,7 +10,7 @@ from fastapi.security.api_key import APIKeyHeader
 from datacontract.data_contract import DataContract, ExportFormat
 from datacontract.model.run import Run
 
-DATA_CONTRACT_EXAMPLE_PAYLOAD = """dataContractSpecification: 1.1.0
+DATA_CONTRACT_EXAMPLE_PAYLOAD = """dataContractSpecification: 1.2.0
 id: urn:datacontract:checkout:orders-latest
 info:
   title: Orders Latest

{datacontract_cli-0.10.27 → datacontract_cli-0.10.29}/datacontract/cli.py

@@ -11,7 +11,7 @@ from typing_extensions import Annotated
 
 from datacontract.catalog.catalog import create_data_contract_html, create_index_html
 from datacontract.data_contract import DataContract, ExportFormat
-from datacontract.imports.importer import ImportFormat
+from datacontract.imports.importer import ImportFormat, Spec
 from datacontract.init.init_template import get_init_template
 from datacontract.integration.datamesh_manager import (
     publish_data_contract_to_datamesh_manager,
@@ -126,7 +126,8 @@ def test(
             "servers (default)."
         ),
     ] = "all",
-    publish: Annotated[str, typer.Option(help="The url to publish the results after the test")] = None,
+    publish_test_results: Annotated[bool, typer.Option(help="Publish the results after the test")] = False,
+    publish: Annotated[str, typer.Option(help="DEPRECATED. The url to publish the results after the test.")] = None,
     output: Annotated[
         Path,
         typer.Option(
@@ -149,6 +150,7 @@ def test(
     run = DataContract(
         data_contract_file=location,
         schema_location=schema,
+        publish_test_results=publish_test_results,
         publish_url=publish,
         server=server,
         ssl_verification=ssl_verification,
@@ -246,6 +248,10 @@ def import_(
         Optional[str],
         typer.Option(help="The path to the file that should be imported."),
     ] = None,
+    spec: Annotated[
+        Spec,
+        typer.Option(help="The format of the data contract to import. "),
+    ] = Spec.datacontract_specification,
     dialect: Annotated[
         Optional[str],
         typer.Option(help="The SQL dialect to use when importing SQL files, e.g., postgres, tsql, bigquery."),
@@ -265,7 +271,7 @@ def import_(
         ),
     ] = None,
     unity_table_full_name: Annotated[
-        Optional[str], typer.Option(help="Full name of a table in the unity catalog")
+        Optional[List[str]], typer.Option(help="Full name of a table in the unity catalog")
     ] = None,
     dbt_model: Annotated[
         Optional[List[str]],
@@ -312,6 +318,7 @@ def import_(
     result = DataContract().import_from_source(
         format=format,
         source=source,
+        spec=spec,
         template=template,
         schema=schema,
         dialect=dialect,
@@ -462,8 +469,26 @@ def diff(
     console.print(result.changelog_str())
 
 
-@app.command()
+def _get_uvicorn_arguments(port: int, host: str, context: typer.Context) -> dict:
+    """
+    Take the default datacontract uvicorn arguments and merge them with the
+    extra arguments passed to the command to start the API.
+    """
+    default_args = {
+        "app": "datacontract.api:app",
+        "port": port,
+        "host": host,
+        "reload": True,
+    }
+
+    # Create a list of the extra arguments, remove the leading -- from the cli arguments
+    trimmed_keys = list(map(lambda x : str(x).replace("--", ""),context.args[::2]))
+    # Merge the two dicts and return them as one dict
+    return default_args | dict(zip(trimmed_keys, context.args[1::2]))
+
+@app.command(context_settings={"allow_extra_args": True, "ignore_unknown_options": True})
 def api(
+    ctx: Annotated[typer.Context, typer.Option(help="Extra arguments to pass to uvicorn.run().")],    
     port: Annotated[int, typer.Option(help="Bind socket to this port.")] = 4242,
     host: Annotated[
         str, typer.Option(help="Bind socket to this host. Hint: For running in docker, set it to 0.0.0.0")
@@ -481,6 +506,9 @@ def api(
 
     To connect to servers (such as a Snowflake data source), set the credentials as environment variables as documented in
     https://cli.datacontract.com/#test
+
+    It is possible to run the API with extra arguments for `uvicorn.run()` as keyword arguments, e.g.:
+    `datacontract api --port 1234 --root_path /datacontract`.
     """
     import uvicorn
     from uvicorn.config import LOGGING_CONFIG
@@ -488,7 +516,11 @@ def api(
     log_config = LOGGING_CONFIG
     log_config["root"] = {"level": "INFO"}
 
-    uvicorn.run(app="datacontract.api:app", port=port, host=host, reload=True, log_config=LOGGING_CONFIG)
+    uvicorn_args = _get_uvicorn_arguments(port, host, ctx)
+    # Add the log config
+    uvicorn_args["log_config"] = log_config
+    # Run uvicorn
+    uvicorn.run(**uvicorn_args)
 
 
 def _print_logs(run):