datacontract-cli 0.10.7__tar.gz → 0.10.8__tar.gz

{datacontract_cli-0.10.7/datacontract_cli.egg-info → datacontract_cli-0.10.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: datacontract-cli
-Version: 0.10.7
+Version: 0.10.8
 Summary: Test data contracts
 Author-email: Jochen Christ <jochen.christ@innoq.com>, Stefan Negele <stefan.negele@innoq.com>
 Project-URL: Homepage, https://cli.datacontract.com
@@ -20,31 +20,46 @@ Requires-Dist: fastparquet==2024.5.0
 Requires-Dist: python-multipart==0.0.9
 Requires-Dist: rich~=13.7.0
 Requires-Dist: simple-ddl-parser==1.5.1
-Requires-Dist: soda-core-bigquery<3.4.0,>=3.3.1
 Requires-Dist: soda-core-duckdb<3.4.0,>=3.3.1
-Requires-Dist: soda-core-sqlserver<3.4.0,>=3.3.1
-Requires-Dist: soda-core-postgres<3.4.0,>=3.3.1
-Requires-Dist: soda-core-snowflake<3.4.0,>=3.3.1
-Requires-Dist: soda-core-spark[databricks]<3.4.0,>=3.3.1
-Requires-Dist: databricks-sql-connector<3.2.0,>=3.1.2
-Requires-Dist: soda-core-spark-df<3.4.0,>=3.3.1
 Requires-Dist: setuptools>=60
-Requires-Dist: snowflake-connector-python[pandas]<3.11,>=3.6
-Requires-Dist: duckdb==0.10.3
-Requires-Dist: fastjsonschema~=2.19.1
+Requires-Dist: duckdb==1.0.0
+Requires-Dist: fastjsonschema<2.21.0,>=2.19.1
 Requires-Dist: python-dotenv~=1.0.0
-Requires-Dist: s3fs==2024.5.0
 Requires-Dist: rdflib==7.0.0
-Requires-Dist: avro==1.11.3
 Requires-Dist: opentelemetry-exporter-otlp-proto-grpc~=1.16
 Requires-Dist: opentelemetry-exporter-otlp-proto-http~=1.16
-Requires-Dist: deltalake~=0.17.0
-Requires-Dist: boto3<1.34.114,>=1.34.41
-Requires-Dist: botocore<1.34.114,>=1.34.41
+Requires-Dist: boto3<1.34.130,>=1.34.41
+Requires-Dist: botocore<1.34.128,>=1.34.41
 Requires-Dist: jinja_partials>=0.2.1
+Provides-Extra: avro
+Requires-Dist: avro==1.11.3; extra == "avro"
+Provides-Extra: bigquery
+Requires-Dist: soda-core-bigquery<3.4.0,>=3.3.1; extra == "bigquery"
+Provides-Extra: databricks
+Requires-Dist: soda-core-spark-df<3.4.0,>=3.3.1; extra == "databricks"
+Requires-Dist: databricks-sql-connector<3.2.0,>=3.1.2; extra == "databricks"
+Requires-Dist: soda-core-spark[databricks]<3.4.0,>=3.3.1; extra == "databricks"
+Provides-Extra: deltalake
+Requires-Dist: deltalake<0.19,>=0.17; extra == "deltalake"
+Provides-Extra: kafka
+Requires-Dist: datacontract-cli[avro]; extra == "kafka"
+Requires-Dist: soda-core-spark-df<3.4.0,>=3.3.1; extra == "kafka"
+Provides-Extra: postgres
+Requires-Dist: soda-core-postgres<3.4.0,>=3.3.1; extra == "postgres"
+Provides-Extra: s3
+Requires-Dist: s3fs==2024.6.0; extra == "s3"
+Provides-Extra: snowflake
+Requires-Dist: snowflake-connector-python[pandas]<3.11,>=3.6; extra == "snowflake"
+Requires-Dist: soda-core-snowflake<3.4.0,>=3.3.1; extra == "snowflake"
+Provides-Extra: sqlserver
+Requires-Dist: soda-core-sqlserver<3.4.0,>=3.3.1; extra == "sqlserver"
+Provides-Extra: all
+Requires-Dist: datacontract-cli[bigquery,databricks,deltalake,kafka,postgres,s3,snowflake,sqlserver]; extra == "all"
 Provides-Extra: dev
+Requires-Dist: datacontract-cli[all]; extra == "dev"
 Requires-Dist: httpx==0.27.0; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
+Requires-Dist: pre-commit~=3.7.1; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-xdist; extra == "dev"
 Requires-Dist: moto; extra == "dev"
@@ -83,9 +98,10 @@ This data contract contains all information to connect to S3 and check that the
 
 Let's use [pip](https://pip.pypa.io/en/stable/getting-started/) to install the CLI (or use the [Docker image](#docker), if you prefer).
 ```bash
-$ python3 -m pip install datacontract-cli
+$ python3 -m pip install datacontract-cli[all]
 ```
 
+
 We run the tests:
 
 ```bash
@@ -155,6 +171,7 @@ $ datacontract export --format html https://datacontract.com/examples/orders-lat
 
 which will create this [HTML export](https://datacontract.com/examples/orders-latest/datacontract.html).
 
+
 ## Usage
 
 ```bash
@@ -207,13 +224,13 @@ Python 3.11 recommended.
 Python 3.12 available as pre-release release candidate for 0.9.3
 
 ```bash
-python3 -m pip install datacontract-cli
+python3 -m pip install datacontract-cli[all]
 ```
 
 ### pipx
 pipx installs into an isolated environment.
 ```bash
-pipx install datacontract-cli
+pipx install datacontract-cli[all]
 ```
 
 ### Docker
@@ -229,6 +246,32 @@ Or via an alias that automatically uses the latest version:
 alias datacontract='docker run --rm -v "${PWD}:/home/datacontract" datacontract/cli:latest'
 ```
 
+
+## Optional Dependencies
+
+The CLI tool defines several optional dependencies (also known as extras) that can be installed for using with specific servers types.
+With _all_, all server dependencies are included.
+
+```bash
+pip install datacontract-cli[all]
+```
+
+A list of available extras:
+
+| Dependency              | Installation Command                                        |
+|-------------------------|-------------------------------------------------------------|
+| Avro Support            | `pip install datacontract-cli[avro]`                        |
+| Google BigQuery         | `pip install datacontract-cli[bigquery]`                    |
+| Databricks Integration  | `pip install datacontract-cli[databricks]`                  |
+| Deltalake Integration   | `pip install datacontract-cli[deltalake]`                  |
+| Kafka Integration       | `pip install datacontract-cli[kafka]`                       |
+| PostgreSQL Integration  | `pip install datacontract-cli[postgres]`                    |
+| S3 Integration          | `pip install datacontract-cli[s3]`                          |
+| Snowflake Integration   | `pip install datacontract-cli[snowflake]`                   |
+| Microsoft SQL Server    | `pip install datacontract-cli[sqlserver]`                   |
+
+
+
 ## Documentation
 
 Commands
@@ -420,7 +463,7 @@ models:
 
 | Environment Variable                         | Example                   | Description                                             |
 |----------------------------------------------|---------------------------|---------------------------------------------------------|
-| `DATACONTRACT_BIGQUERY_ACCOUNT_INFO_JSON_PATH` | `~/service-access-key.json` | Service Access key as saved on key creation by BigQuery |
+| `DATACONTRACT_BIGQUERY_ACCOUNT_INFO_JSON_PATH` | `~/service-access-key.json` | Service Access key as saved on key creation by BigQuery. If this environment variable isn't set, the cli tries to use `GOOGLE_APPLICATION_CREDENTIALS` as a fallback, so if you have that set for using their Python library anyway, it should work seamlessly. |
 
 
 
@@ -544,7 +587,7 @@ models:
 
 Notebook
 ```python
-%pip install datacontract-cli
+%pip install datacontract-cli[databricks]
 dbutils.library.restartPython()
 
 from datacontract.data_contract import DataContract
@@ -688,10 +731,10 @@ models:
 
 ```
 
- Usage: datacontract export [OPTIONS] [LOCATION]                                                                                                                           
-                                                                                                                                                                           
- Convert data contract to a specific format. Prints to stdout or to the specified output file.                                                                                                     
-                                                                                                                                                                           
+ Usage: datacontract export [OPTIONS] [LOCATION]
+
+ Convert data contract to a specific format. Prints to stdout or to the specified output file.
+
 ╭─ Arguments ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
 │   location      [LOCATION]  The location (url or path) of the data contract yaml. [default: datacontract.yaml]                 │
 ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
@@ -792,13 +835,13 @@ data products, find the true domain owner of a field attribute)
 #### DBML
 
 The export function converts the logical data types of the datacontract into the specific ones of a concrete Database
-if a server is selected via the `--server` option (based on the `type` of that server). If no server is selected, the 
+if a server is selected via the `--server` option (based on the `type` of that server). If no server is selected, the
 logical data types are exported.
 
 
 #### Avro
 
-The export function converts the data contract specification into an avro schema. It supports specifying custom avro properties for logicalTypes and default values. 
+The export function converts the data contract specification into an avro schema. It supports specifying custom avro properties for logicalTypes and default values.
 
 ##### Custom Avro Properties
 
@@ -818,7 +861,7 @@ models:
         description: Example for AVRO with Timestamp (microsecond precision) https://avro.apache.org/docs/current/spec.html#Local+timestamp+%28microsecond+precision%29
         type: long
         example: 1672534861000000  # Equivalent to 2023-01-01 01:01:01 in microseconds
-        config:          
+        config:
           avroLogicalType: local-timestamp-micros
           avroDefault: 1672534861000000
 ```
@@ -842,21 +885,21 @@ models:
 ```
  Usage: datacontract import [OPTIONS]
 
- Create a data contract from the given source location. Prints to stdout.                                                              
-                                                                                                                                       
+ Create a data contract from the given source location. Prints to stdout.
+
 ╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
-│ *  --format                  [sql|avro|glue|bigquery|jsonschema]  The format of the source file. [default: None] [required]         │
-│    --source                  TEXT                                 The path to the file or Glue Database that should be imported.    │
-│                                                                   [default: None]                                                   │
-│    --glue-table              TEXT                                 List of table ids to import from the Glue Database (repeat for    │
-│                                                                   multiple table ids, leave empty for all tables in the dataset).   │
-│                                                                   [default: None]                                                   │
-│    --bigquery-project        TEXT                                 The bigquery project id. [default: None]                          │
-│    --bigquery-dataset        TEXT                                 The bigquery dataset id. [default: None]                          │
-│    --bigquery-table          TEXT                                 List of table ids to import from the bigquery API (repeat for     │
-│                                                                   multiple table ids, leave empty for all tables in the dataset).   │
-│                                                                   [default: None]                                                   │
-│    --help                                                         Show this message and exit.                                       │
+│ *  --format                  [sql|avro|glue|bigquery|jsonschema|unity]  The format of the source file. [default: None] [required]         │
+│    --source                  TEXT                                       The path to the file or Glue Database that should be imported.    │
+│                                                                         [default: None]                                                   │
+│    --glue-table              TEXT                                       List of table ids to import from the Glue Database (repeat for    │
+│                                                                         multiple table ids, leave empty for all tables in the dataset).   │
+│                                                                         [default: None]                                                   │
+│    --bigquery-project        TEXT                                       The bigquery project id. [default: None]                          │
+│    --bigquery-dataset        TEXT                                       The bigquery dataset id. [default: None]                          │
+│    --bigquery-table          TEXT                                       List of table ids to import from the bigquery API (repeat for     │
+│                                                                         multiple table ids, leave empty for all tables in the dataset).   │
+│                                                                         [default: None]                                                   │
+│    --help                                                               Show this message and exit.                                       │
 ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```
 
@@ -874,10 +917,11 @@ Available import options:
 | `avro`             | Import from AVRO schemas                       | ✅      |
 | `glue`             | Import from AWS Glue DataCatalog               | ✅      |
 | `protobuf`         | Import from Protobuf schemas                   | TBD     |
-| `jsonschema`       | Import from JSON Schemas                       | ✅      |
-| `bigquery`         | Import from BigQuery Schemas                   | ✅      |
+| `jsonschema`       | Import from JSON Schemas                       | ✅       |
+| `bigquery`         | Import from BigQuery Schemas                   | ✅       |
+| `unity`            | Import from Databricks Unity Catalog           | partial |
 | `dbt`              | Import from dbt models                         | TBD     |
-| `odcs`             | Import from Open Data Contract Standard (ODCS) | TBD     |
+| `odcs`             | Import from Open Data Contract Standard (ODCS) | ✅       |
 | Missing something? | Please create an issue on GitHub               | TBD     |
 
 
@@ -889,7 +933,7 @@ To import from the Bigquery API, you have to _omit_ `source` and instead need to
 
 For providing authentication to the Client, please see [the google documentation](https://cloud.google.com/docs/authentication/provide-credentials-adc#how-to) or the one [about authorizing client libraries](https://cloud.google.com/bigquery/docs/authentication#client-libs).
 
-Examples: 
+Examples:
 
 ```bash
 # Example import from Bigquery JSON
@@ -906,12 +950,26 @@ datacontract import --format bigquery --bigquery-project <project_id> --bigquery
 datacontract import --format bigquery --bigquery-project <project_id> --bigquery-dataset <dataset_id>
 ```
 
+#### Unity Catalog
+
+```bash
+# Example import from a Unity Catalog JSON file
+datacontract import --format unity --source my_unity_table.json
+```
+
+```bash
+# Example import single table from Unity Catalog via HTTP endpoint
+export DATABRICKS_IMPORT_INSTANCE="https://xyz.cloud.databricks.com"
+export DATABRICKS_IMPORT_ACCESS_TOKEN=<token>
+datacontract import --format unity --unity-table-full-name <table_full_name>
+```
+
 ### Glue
 
 Importing from Glue reads the necessary Data directly off of the AWS API.
 You may give the `glue-table` parameter to enumerate the tables that should be imported. If no tables are given, _all_ available tables of the database will be imported.
 
-Examples: 
+Examples:
 
 ```bash
 # Example import from AWS Glue with specifying the tables to import
@@ -1168,8 +1226,8 @@ source venv/bin/activate
 # Install Requirements
 pip install --upgrade pip setuptools wheel
 pip install -e '.[dev]'
-ruff check --fix
-ruff format
+pre-commit install
+pre-commit run --all-files
 pytest
 ```
 
@@ -1225,6 +1283,12 @@ We are happy to receive your contributions. Propose your change in an issue or d
 - [INNOQ](https://innoq.com)
 - And many more. To add your company, please create a pull request.
 
+## Related Tools
+
+- [Data Mesh Manager](https://www.datamesh-manager.com/) is a commercial tool to manage data products and data contracts. It supports the data contract specification and allows the user to import or export data contracts using this specification.
+- [Data Contract GPT](https://gpt.datacontract.com) is a custom GPT that can help you write data contracts.
+- [Data Contract Editor](https://editor.datacontract.com) is an editor for Data Contracts, including a live html preview.
+
 ## License
 
 [MIT License](LICENSE)

{datacontract_cli-0.10.7 → datacontract_cli-0.10.8}/README.md

@@ -25,9 +25,10 @@ This data contract contains all information to connect to S3 and check that the
 
 Let's use [pip](https://pip.pypa.io/en/stable/getting-started/) to install the CLI (or use the [Docker image](#docker), if you prefer).
 ```bash
-$ python3 -m pip install datacontract-cli
+$ python3 -m pip install datacontract-cli[all]
 ```
 
+
 We run the tests:
 
 ```bash
@@ -97,6 +98,7 @@ $ datacontract export --format html https://datacontract.com/examples/orders-lat
 
 which will create this [HTML export](https://datacontract.com/examples/orders-latest/datacontract.html).
 
+
 ## Usage
 
 ```bash
@@ -149,13 +151,13 @@ Python 3.11 recommended.
 Python 3.12 available as pre-release release candidate for 0.9.3
 
 ```bash
-python3 -m pip install datacontract-cli
+python3 -m pip install datacontract-cli[all]
 ```
 
 ### pipx
 pipx installs into an isolated environment.
 ```bash
-pipx install datacontract-cli
+pipx install datacontract-cli[all]
 ```
 
 ### Docker
@@ -171,6 +173,32 @@ Or via an alias that automatically uses the latest version:
 alias datacontract='docker run --rm -v "${PWD}:/home/datacontract" datacontract/cli:latest'
 ```
 
+
+## Optional Dependencies
+
+The CLI tool defines several optional dependencies (also known as extras) that can be installed for using with specific servers types.
+With _all_, all server dependencies are included.
+
+```bash
+pip install datacontract-cli[all]
+```
+
+A list of available extras:
+
+| Dependency              | Installation Command                                        |
+|-------------------------|-------------------------------------------------------------|
+| Avro Support            | `pip install datacontract-cli[avro]`                        |
+| Google BigQuery         | `pip install datacontract-cli[bigquery]`                    |
+| Databricks Integration  | `pip install datacontract-cli[databricks]`                  |
+| Deltalake Integration   | `pip install datacontract-cli[deltalake]`                  |
+| Kafka Integration       | `pip install datacontract-cli[kafka]`                       |
+| PostgreSQL Integration  | `pip install datacontract-cli[postgres]`                    |
+| S3 Integration          | `pip install datacontract-cli[s3]`                          |
+| Snowflake Integration   | `pip install datacontract-cli[snowflake]`                   |
+| Microsoft SQL Server    | `pip install datacontract-cli[sqlserver]`                   |
+
+
+
 ## Documentation
 
 Commands
@@ -362,7 +390,7 @@ models:
 
 | Environment Variable                         | Example                   | Description                                             |
 |----------------------------------------------|---------------------------|---------------------------------------------------------|
-| `DATACONTRACT_BIGQUERY_ACCOUNT_INFO_JSON_PATH` | `~/service-access-key.json` | Service Access key as saved on key creation by BigQuery |
+| `DATACONTRACT_BIGQUERY_ACCOUNT_INFO_JSON_PATH` | `~/service-access-key.json` | Service Access key as saved on key creation by BigQuery. If this environment variable isn't set, the cli tries to use `GOOGLE_APPLICATION_CREDENTIALS` as a fallback, so if you have that set for using their Python library anyway, it should work seamlessly. |
 
 
 
@@ -486,7 +514,7 @@ models:
 
 Notebook
 ```python
-%pip install datacontract-cli
+%pip install datacontract-cli[databricks]
 dbutils.library.restartPython()
 
 from datacontract.data_contract import DataContract
@@ -630,10 +658,10 @@ models:
 
 ```
 
- Usage: datacontract export [OPTIONS] [LOCATION]                                                                                                                           
-                                                                                                                                                                           
- Convert data contract to a specific format. Prints to stdout or to the specified output file.                                                                                                     
-                                                                                                                                                                           
+ Usage: datacontract export [OPTIONS] [LOCATION]
+
+ Convert data contract to a specific format. Prints to stdout or to the specified output file.
+
 ╭─ Arguments ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
 │   location      [LOCATION]  The location (url or path) of the data contract yaml. [default: datacontract.yaml]                 │
 ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
@@ -734,13 +762,13 @@ data products, find the true domain owner of a field attribute)
 #### DBML
 
 The export function converts the logical data types of the datacontract into the specific ones of a concrete Database
-if a server is selected via the `--server` option (based on the `type` of that server). If no server is selected, the 
+if a server is selected via the `--server` option (based on the `type` of that server). If no server is selected, the
 logical data types are exported.
 
 
 #### Avro
 
-The export function converts the data contract specification into an avro schema. It supports specifying custom avro properties for logicalTypes and default values. 
+The export function converts the data contract specification into an avro schema. It supports specifying custom avro properties for logicalTypes and default values.
 
 ##### Custom Avro Properties
 
@@ -760,7 +788,7 @@ models:
         description: Example for AVRO with Timestamp (microsecond precision) https://avro.apache.org/docs/current/spec.html#Local+timestamp+%28microsecond+precision%29
         type: long
         example: 1672534861000000  # Equivalent to 2023-01-01 01:01:01 in microseconds
-        config:          
+        config:
           avroLogicalType: local-timestamp-micros
           avroDefault: 1672534861000000
 ```
@@ -784,21 +812,21 @@ models:
 ```
  Usage: datacontract import [OPTIONS]
 
- Create a data contract from the given source location. Prints to stdout.                                                              
-                                                                                                                                       
+ Create a data contract from the given source location. Prints to stdout.
+
 ╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
-│ *  --format                  [sql|avro|glue|bigquery|jsonschema]  The format of the source file. [default: None] [required]         │
-│    --source                  TEXT                                 The path to the file or Glue Database that should be imported.    │
-│                                                                   [default: None]                                                   │
-│    --glue-table              TEXT                                 List of table ids to import from the Glue Database (repeat for    │
-│                                                                   multiple table ids, leave empty for all tables in the dataset).   │
-│                                                                   [default: None]                                                   │
-│    --bigquery-project        TEXT                                 The bigquery project id. [default: None]                          │
-│    --bigquery-dataset        TEXT                                 The bigquery dataset id. [default: None]                          │
-│    --bigquery-table          TEXT                                 List of table ids to import from the bigquery API (repeat for     │
-│                                                                   multiple table ids, leave empty for all tables in the dataset).   │
-│                                                                   [default: None]                                                   │
-│    --help                                                         Show this message and exit.                                       │
+│ *  --format                  [sql|avro|glue|bigquery|jsonschema|unity]  The format of the source file. [default: None] [required]         │
+│    --source                  TEXT                                       The path to the file or Glue Database that should be imported.    │
+│                                                                         [default: None]                                                   │
+│    --glue-table              TEXT                                       List of table ids to import from the Glue Database (repeat for    │
+│                                                                         multiple table ids, leave empty for all tables in the dataset).   │
+│                                                                         [default: None]                                                   │
+│    --bigquery-project        TEXT                                       The bigquery project id. [default: None]                          │
+│    --bigquery-dataset        TEXT                                       The bigquery dataset id. [default: None]                          │
+│    --bigquery-table          TEXT                                       List of table ids to import from the bigquery API (repeat for     │
+│                                                                         multiple table ids, leave empty for all tables in the dataset).   │
+│                                                                         [default: None]                                                   │
+│    --help                                                               Show this message and exit.                                       │
 ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```
 
@@ -816,10 +844,11 @@ Available import options:
 | `avro`             | Import from AVRO schemas                       | ✅      |
 | `glue`             | Import from AWS Glue DataCatalog               | ✅      |
 | `protobuf`         | Import from Protobuf schemas                   | TBD     |
-| `jsonschema`       | Import from JSON Schemas                       | ✅      |
-| `bigquery`         | Import from BigQuery Schemas                   | ✅      |
+| `jsonschema`       | Import from JSON Schemas                       | ✅       |
+| `bigquery`         | Import from BigQuery Schemas                   | ✅       |
+| `unity`            | Import from Databricks Unity Catalog           | partial |
 | `dbt`              | Import from dbt models                         | TBD     |
-| `odcs`             | Import from Open Data Contract Standard (ODCS) | TBD     |
+| `odcs`             | Import from Open Data Contract Standard (ODCS) | ✅       |
 | Missing something? | Please create an issue on GitHub               | TBD     |
 
 
@@ -831,7 +860,7 @@ To import from the Bigquery API, you have to _omit_ `source` and instead need to
 
 For providing authentication to the Client, please see [the google documentation](https://cloud.google.com/docs/authentication/provide-credentials-adc#how-to) or the one [about authorizing client libraries](https://cloud.google.com/bigquery/docs/authentication#client-libs).
 
-Examples: 
+Examples:
 
 ```bash
 # Example import from Bigquery JSON
@@ -848,12 +877,26 @@ datacontract import --format bigquery --bigquery-project <project_id> --bigquery
 datacontract import --format bigquery --bigquery-project <project_id> --bigquery-dataset <dataset_id>
 ```
 
+#### Unity Catalog
+
+```bash
+# Example import from a Unity Catalog JSON file
+datacontract import --format unity --source my_unity_table.json
+```
+
+```bash
+# Example import single table from Unity Catalog via HTTP endpoint
+export DATABRICKS_IMPORT_INSTANCE="https://xyz.cloud.databricks.com"
+export DATABRICKS_IMPORT_ACCESS_TOKEN=<token>
+datacontract import --format unity --unity-table-full-name <table_full_name>
+```
+
 ### Glue
 
 Importing from Glue reads the necessary Data directly off of the AWS API.
 You may give the `glue-table` parameter to enumerate the tables that should be imported. If no tables are given, _all_ available tables of the database will be imported.
 
-Examples: 
+Examples:
 
 ```bash
 # Example import from AWS Glue with specifying the tables to import
@@ -1110,8 +1153,8 @@ source venv/bin/activate
 # Install Requirements
 pip install --upgrade pip setuptools wheel
 pip install -e '.[dev]'
-ruff check --fix
-ruff format
+pre-commit install
+pre-commit run --all-files
 pytest
 ```
 
@@ -1167,6 +1210,12 @@ We are happy to receive your contributions. Propose your change in an issue or d
 - [INNOQ](https://innoq.com)
 - And many more. To add your company, please create a pull request.
 
+## Related Tools
+
+- [Data Mesh Manager](https://www.datamesh-manager.com/) is a commercial tool to manage data products and data contracts. It supports the data contract specification and allows the user to import or export data contracts using this specification.
+- [Data Contract GPT](https://gpt.datacontract.com) is a custom GPT that can help you write data contracts.
+- [Data Contract Editor](https://editor.datacontract.com) is an editor for Data Contracts, including a live html preview.
+
 ## License
 
 [MIT License](LICENSE)

{datacontract_cli-0.10.7 → datacontract_cli-0.10.8}/datacontract/cli.py

@@ -5,6 +5,7 @@ from typing import Iterable, Optional
 from typing import List
 
 import typer
+import uvicorn
 from click import Context
 from rich import box
 from rich.console import Console
@@ -12,6 +13,7 @@ from rich.table import Table
 from typer.core import TyperGroup
 from typing_extensions import Annotated
 
+from datacontract import web
 from datacontract.catalog.catalog import create_index_html, create_data_contract_html
 from datacontract.data_contract import DataContract, ExportFormat
 from datacontract.init.download_datacontract_file import download_datacontract_file, FileExistsException
@@ -183,6 +185,7 @@ def export(
     result = DataContract(data_contract_file=location, server=server).export(
         export_format=format,
         model=model,
+        server=server,
         rdf_base=rdf_base,
         sql_server_type=sql_server_type,
     )
@@ -201,6 +204,8 @@ class ImportFormat(str, Enum):
     glue = "glue"
     bigquery = "bigquery"
     jsonschema = "jsonschema"
+    odcs="odcs"
+    unity = "unity"
 
 
 @app.command(name="import")
@@ -223,11 +228,12 @@ def import_(
             help="List of table ids to import from the bigquery API (repeat for multiple table ids, leave empty for all tables in the dataset)."
         ),
     ] = None,
+    unity_table_full_name: Annotated[Optional[str], typer.Option(help="Full name of a table in the unity catalog")] = None,
 ):
     """
     Create a data contract from the given source location. Prints to stdout.
     """
-    result = DataContract().import_from_source(format, source, glue_table, bigquery_table, bigquery_project, bigquery_dataset)
+    result = DataContract().import_from_source(format, source, glue_table, bigquery_table, bigquery_project, bigquery_dataset, unity_table_full_name)
     console.print(result.to_yaml())
 
 
@@ -323,6 +329,18 @@ def diff(
     console.print(result.changelog_str())
 
 
+@app.command()
+def serve(
+    port: Annotated[int, typer.Option(help="Bind socket to this port.")] = 4242,
+    host: Annotated[str, typer.Option(help="Bind socket to this host.")] = "127.0.0.1",
+):
+    """
+    Start the datacontract web server.
+    """
+
+    uvicorn.run(web.app, port=port, host=host)
+
+
 def _handle_result(run):
     _print_table(run)
     if run.result == "passed":