datacontract-cli 0.10.14__py3-none-any.whl → 0.10.16__py3-none-any.whl

datacontract/lint/linters/example_model_linter.py

@@ -5,6 +5,7 @@ import json
 import yaml
 
 from datacontract.model.data_contract_specification import DataContractSpecification, Example
+
 from ..lint import Linter, LinterResult
 
 

datacontract/lint/linters/field_pattern_linter.py

@@ -1,6 +1,7 @@
 import re
 
 from datacontract.model.data_contract_specification import DataContractSpecification
+
 from ..lint import Linter, LinterResult
 
 

datacontract/lint/linters/field_reference_linter.py

@@ -1,4 +1,5 @@
 from datacontract.model.data_contract_specification import DataContractSpecification
+
 from ..lint import Linter, LinterResult
 
 

datacontract/lint/linters/notice_period_linter.py

@@ -1,6 +1,7 @@
 import re
 
 from datacontract.model.data_contract_specification import DataContractSpecification
+
 from ..lint import Linter, LinterResult
 
 

datacontract/lint/linters/quality_schema_linter.py

@@ -1,6 +1,7 @@
 import yaml
 
 from datacontract.model.data_contract_specification import DataContractSpecification, Model
+
 from ..lint import Linter, LinterResult
 
 

datacontract/lint/linters/valid_constraints_linter.py

@@ -1,4 +1,5 @@
 from datacontract.model.data_contract_specification import DataContractSpecification, Field
+
 from ..lint import Linter, LinterResult
 
 

datacontract/lint/resolve.py

@@ -9,7 +9,11 @@ from datacontract.imports.odcs_v3_importer import import_odcs_v3_from_str
 from datacontract.lint.resources import read_resource
 from datacontract.lint.schema import fetch_schema
 from datacontract.lint.urls import fetch_resource
-from datacontract.model.data_contract_specification import DataContractSpecification, Definition, Quality
+from datacontract.model.data_contract_specification import (
+    DataContractSpecification,
+    Definition,
+    DeprecatedQuality,
+)
 from datacontract.model.exceptions import DataContractException
 from datacontract.model.odcs import is_open_data_contract_standard
 
@@ -156,7 +160,7 @@ def _fetch_file(path) -> str:
         return file.read()
 
 
-def _resolve_quality_ref(quality: Quality):
+def _resolve_quality_ref(quality: DeprecatedQuality):
     """
     Return the content of a ref file path
     @param quality data contract quality specification
@@ -199,7 +203,7 @@ def _resolve_data_contract_from_str(
 
     if is_open_data_contract_standard(yaml_dict):
         # if ODCS, then validate the ODCS schema and import to DataContractSpecification directly
-        data_contract_specification = DataContractSpecification(dataContractSpecification="0.9.3")
+        data_contract_specification = DataContractSpecification(dataContractSpecification="1.1.0")
         return import_odcs_v3_from_str(data_contract_specification, source_str=data_contract_str)
 
     _validate_data_contract_specification_schema(yaml_dict, schema_location)

datacontract/lint/schema.py

@@ -1,6 +1,6 @@
 import json
 import os
-from typing import Dict, Any
+from typing import Any, Dict
 
 import requests
 

datacontract/model/data_contract_specification.py

@@ -1,5 +1,5 @@
 import os
-from typing import List, Dict, Optional, Any
+from typing import Any, Dict, List, Optional
 
 import pydantic as pyd
 import yaml
@@ -147,6 +147,7 @@ class Field(pyd.BaseModel):
     format: str = None
     required: bool = None
     primary: bool = None
+    primaryKey: bool = None
     unique: bool | None = None
     references: str = None
     description: str | None = None
@@ -213,7 +214,8 @@ class Example(pyd.BaseModel):
     data: str | object = None
 
 
-class Quality(pyd.BaseModel):
+# Deprecated Quality class
+class DeprecatedQuality(pyd.BaseModel):
     type: str = None
     specification: str | object = None
 
@@ -282,9 +284,14 @@ class DataContractSpecification(pyd.BaseModel):
     terms: Terms = None
     models: Dict[str, Model] = {}
     definitions: Dict[str, Definition] = {}
-    # schema: Dict[str, str]
-    examples: List[Example] = []
-    quality: Quality = None
+    examples: List[Example] = pyd.Field(
+        default_factory=list,
+        deprecated="Removed in Data Contract Specification " "v1.1.0. Use models.examples instead.",
+    )
+    quality: DeprecatedQuality = pyd.Field(
+        default=None,
+        deprecated="Removed in Data Contract Specification v1.1.0. Use " "model-level and field-level quality instead.",
+    )
     servicelevels: Optional[ServiceLevel] = None
     links: Dict[str, str] = {}
     tags: List[str] = []
@@ -292,7 +299,7 @@ class DataContractSpecification(pyd.BaseModel):
     @classmethod
     def from_file(cls, file):
         if not os.path.exists(file):
-            raise (f"The file '{file}' does not exist.")
+            raise FileNotFoundError(f"The file '{file}' does not exist.")
         with open(file, "r") as file:
             file_content = file.read()
         return DataContractSpecification.from_string(file_content)

datacontract/model/run.py

@@ -1,15 +1,24 @@
 import logging
 from datetime import datetime, timezone
+from enum import Enum
 from typing import List, Optional
 from uuid import UUID, uuid4
 
 from pydantic import BaseModel
 
 
+class ResultEnum(str, Enum):
+    passed = "passed"
+    warning = "warning"
+    failed = "failed"
+    error = "error"
+    unknown = "unknown"
+
+
 class Check(BaseModel):
     type: str
     name: Optional[str]
-    result: str  # passed, failed, warning, unknown
+    result: ResultEnum
     engine: str
     reason: Optional[str] = None
     model: Optional[str] = None
@@ -33,29 +42,29 @@ class Run(BaseModel):
     server: Optional[str] = None
     timestampStart: datetime
     timestampEnd: datetime
-    result: str = "unknown"  # passed, warning, failed, error, unknown
+    result: ResultEnum = ResultEnum.unknown
     checks: List[Check]
     logs: List[Log]
 
     def has_passed(self):
         self.calculate_result()
-        return self.result == "passed"
+        return self.result == ResultEnum.passed
 
     def finish(self):
         self.timestampEnd = datetime.now(timezone.utc)
         self.calculate_result()
 
     def calculate_result(self):
-        if any(check.result == "error" for check in self.checks):
-            self.result = "error"
-        elif any(check.result == "failed" for check in self.checks):
-            self.result = "failed"
-        elif any(check.result == "warning" for check in self.checks):
-            self.result = "warning"
-        elif any(check.result == "passed" for check in self.checks):
-            self.result = "passed"
+        if any(check.result == ResultEnum.error for check in self.checks):
+            self.result = ResultEnum.error
+        elif any(check.result == ResultEnum.failed for check in self.checks):
+            self.result = ResultEnum.failed
+        elif any(check.result == ResultEnum.warning for check in self.checks):
+            self.result = ResultEnum.warning
+        elif any(check.result == ResultEnum.passed for check in self.checks):
+            self.result = ResultEnum.passed
         else:
-            self.result = "unknown"
+            self.result = ResultEnum.unknown
 
     def log_info(self, message: str):
         logging.info(message)

datacontract/templates/index.html

@@ -78,17 +78,17 @@
 
               <li class="col-span-1 rounded-lg bg-white shadow hover:bg-gray-50"
                   data-search="{{
-    contract.spec.info.title|lower }} {{
-    contract.spec.info.owner|lower if contract.spec.info.owner else '' }} {{
-    contract.spec.info.description|lower }} {%
+    contract.spec.info.title|lower|e }} {{
+    contract.spec.info.owner|lower|e if contract.spec.info.owner else '' }} {{
+    contract.spec.info.description|lower|e }} {%
     for model_name, model in contract.spec.models.items() %}
-      {{ model.description|lower }} {%
+      {{ model.description|lower|e }} {%
       for field_name, field in model.fields.items() %}
-        {{ field_name|lower }} {{ field.description|lower if field.description else '' }} {%
+        {{ field_name|lower|e }} {{ field.description|lower|e if field.description else '' }} {%
       endfor %}
     {% endfor %}
   ">
-                <a href="{{contract.html_link}}" >
+                <a href="{{contract.html_link|e}}" >
                   <div class="flex w-full justify-between space-x-1 p-6 pb-4">
                     <div class="flex-1 truncate">
                       <div class="flex items-center space-x-3">

datacontract/web.py

@@ -1,11 +1,10 @@
-from typing import Annotated, Union, Optional
+from typing import Annotated, Optional, Union
 
 import typer
 from fastapi import FastAPI, File
-from fastapi.responses import HTMLResponse
+from fastapi.responses import HTMLResponse, PlainTextResponse
 
 from datacontract.data_contract import DataContract, ExportFormat
-from fastapi.responses import PlainTextResponse
 
 app = FastAPI()
 

{datacontract_cli-0.10.14.dist-info → datacontract_cli-0.10.16.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: datacontract-cli
-Version: 0.10.14
+Version: 0.10.16
 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>
 Project-URL: Homepage, https://cli.datacontract.com
@@ -11,71 +11,72 @@ Classifier: Operating System :: OS Independent
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: typer<0.13,>=0.12
-Requires-Dist: pydantic<2.10.0,>=2.8.2
+Requires-Dist: typer<0.15,>=0.12
+Requires-Dist: pydantic<2.11.0,>=2.8.2
 Requires-Dist: pyyaml~=6.0.1
 Requires-Dist: requests<2.33,>=2.31
-Requires-Dist: fastapi==0.115.2
-Requires-Dist: uvicorn==0.30.6
-Requires-Dist: fastjsonschema<2.21.0,>=2.19.1
-Requires-Dist: fastparquet==2024.5.0
-Requires-Dist: python-multipart==0.0.12
+Requires-Dist: fastapi==0.115.6
+Requires-Dist: uvicorn==0.32.1
+Requires-Dist: fastjsonschema<2.22.0,>=2.19.1
+Requires-Dist: fastparquet==2024.11.0
+Requires-Dist: python-multipart==0.0.19
 Requires-Dist: rich<13.10,>=13.7
 Requires-Dist: simple-ddl-parser==1.7.1
 Requires-Dist: duckdb==1.1.2
-Requires-Dist: soda-core-duckdb<3.4.0,>=3.3.1
+Requires-Dist: soda-core-duckdb<3.5.0,>=3.3.1
 Requires-Dist: setuptools>=60
 Requires-Dist: python-dotenv~=1.0.0
 Requires-Dist: rdflib==7.0.0
 Requires-Dist: opentelemetry-exporter-otlp-proto-grpc~=1.16
 Requires-Dist: opentelemetry-exporter-otlp-proto-http~=1.16
-Requires-Dist: boto3<1.35.45,>=1.34.41
-Requires-Dist: jinja-partials>=0.2.1
-Provides-Extra: all
-Requires-Dist: datacontract-cli[bigquery,databricks,dbml,dbt,iceberg,kafka,postgres,s3,snowflake,sqlserver,trino]; extra == "all"
+Requires-Dist: boto3<1.35.69,>=1.34.41
+Requires-Dist: jinja_partials>=0.2.1
 Provides-Extra: avro
 Requires-Dist: avro==1.12.0; extra == "avro"
 Provides-Extra: bigquery
-Requires-Dist: soda-core-bigquery<3.4.0,>=3.3.1; extra == "bigquery"
+Requires-Dist: soda-core-bigquery<3.5.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: soda-core-spark-df<3.5.0,>=3.3.1; extra == "databricks"
 Requires-Dist: databricks-sql-connector<3.6.0,>=3.1.2; extra == "databricks"
-Requires-Dist: databricks-sdk<0.36.0,>=0.32.0; extra == "databricks"
-Requires-Dist: soda-core-spark[databricks]<3.4.0,>=3.3.1; extra == "databricks"
-Provides-Extra: dbml
-Requires-Dist: pydbml>=1.1.1; extra == "dbml"
+Requires-Dist: databricks-sdk<0.39.0,>=0.32.0; extra == "databricks"
+Requires-Dist: soda-core-spark[databricks]<3.5.0,>=3.3.1; extra == "databricks"
+Provides-Extra: iceberg
+Requires-Dist: pyiceberg==0.8.1; extra == "iceberg"
+Provides-Extra: kafka
+Requires-Dist: datacontract-cli[avro]; extra == "kafka"
+Requires-Dist: soda-core-spark-df<3.5.0,>=3.3.1; extra == "kafka"
+Provides-Extra: postgres
+Requires-Dist: soda-core-postgres<3.5.0,>=3.3.1; extra == "postgres"
+Provides-Extra: s3
+Requires-Dist: s3fs==2024.10.0; extra == "s3"
+Provides-Extra: snowflake
+Requires-Dist: snowflake-connector-python[pandas]<3.13,>=3.6; extra == "snowflake"
+Requires-Dist: soda-core-snowflake<3.5.0,>=3.3.1; extra == "snowflake"
+Provides-Extra: sqlserver
+Requires-Dist: soda-core-sqlserver<3.5.0,>=3.3.1; extra == "sqlserver"
+Provides-Extra: trino
+Requires-Dist: soda-core-trino<3.5.0,>=3.3.1; extra == "trino"
 Provides-Extra: dbt
 Requires-Dist: dbt-core>=1.8.0; extra == "dbt"
+Provides-Extra: dbml
+Requires-Dist: pydbml>=1.1.1; extra == "dbml"
+Provides-Extra: parquet
+Requires-Dist: pyarrow>=12.0.0; extra == "parquet"
+Provides-Extra: all
+Requires-Dist: datacontract-cli[bigquery,databricks,dbml,dbt,iceberg,kafka,parquet,postgres,s3,snowflake,sqlserver,trino]; extra == "all"
 Provides-Extra: dev
 Requires-Dist: datacontract-cli[all]; extra == "dev"
-Requires-Dist: httpx==0.27.2; extra == "dev"
+Requires-Dist: httpx==0.28.1; extra == "dev"
 Requires-Dist: kafka-python; extra == "dev"
-Requires-Dist: moto==5.0.18; extra == "dev"
+Requires-Dist: moto==5.0.22; extra == "dev"
 Requires-Dist: pandas>=2.1.0; extra == "dev"
-Requires-Dist: pre-commit<3.9.0,>=3.7.1; extra == "dev"
-Requires-Dist: pyarrow>=12.0.0; extra == "dev"
+Requires-Dist: pre-commit<4.1.0,>=3.7.1; extra == "dev"
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-xdist; extra == "dev"
-Requires-Dist: pymssql==2.3.1; extra == "dev"
+Requires-Dist: pymssql==2.3.2; extra == "dev"
 Requires-Dist: ruff; extra == "dev"
-Requires-Dist: testcontainers[kafka,minio,mssql,postgres]==4.8.2; extra == "dev"
+Requires-Dist: testcontainers[kafka,minio,mssql,postgres]==4.9.0; extra == "dev"
 Requires-Dist: trino==0.330.0; extra == "dev"
-Provides-Extra: iceberg
-Requires-Dist: pyiceberg==0.7.1; extra == "iceberg"
-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.9.0; extra == "s3"
-Provides-Extra: snowflake
-Requires-Dist: snowflake-connector-python[pandas]<3.13,>=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: trino
-Requires-Dist: soda-core-trino<3.4.0,>=3.3.1; extra == "trino"
 
 # Data Contract CLI
 
@@ -273,6 +274,7 @@ A list of available extras:
 | Avro Support           | `pip install datacontract-cli[avro]`       |
 | Google BigQuery        | `pip install datacontract-cli[bigquery]`   |
 | Databricks Integration | `pip install datacontract-cli[databricks]` |
+| Iceberg                | `pip install datacontract-cli[iceberg]`    |
 | Kafka Integration      | `pip install datacontract-cli[kafka]`      |
 | PostgreSQL Integration | `pip install datacontract-cli[postgres]`   |
 | S3 Integration         | `pip install datacontract-cli[s3]`         |
@@ -280,6 +282,8 @@ A list of available extras:
 | Microsoft SQL Server   | `pip install datacontract-cli[sqlserver]`  |
 | Trino                  | `pip install datacontract-cli[trino]`      |
 | Dbt                    | `pip install datacontract-cli[dbt]`        |
+| Dbml                   | `pip install datacontract-cli[dbml]`       |
+| Parquet                | `pip install datacontract-cli[parquet]`    |
 
 
 
@@ -825,19 +829,19 @@ models:
 ### export
 
 ```
-
- 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. Saves to file specified by `output` option if present, otherwise prints to stdout.      
+                                                                                                                                  
 ╭─ Arguments ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
 │   location      [LOCATION]  The location (url or path) of the data contract yaml. [default: datacontract.yaml]                 │
 ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
 │ *  --format        [jsonschema|pydantic-model|sodacl|dbt|dbt-sources|db  The export format. [default: None] [required]         │
-│                    t-staging-sql|odcs|rdf|avro|protobuf|great-expectati                                                        │
-│                    ons|terraform|avro-idl|sql|sql-query|html|go|bigquer                                                        │
-│                    y|dbml|spark|sqlalchemy|data-caterer|dcs]                                                                       │
+│                    t-staging-sql|odcs|odcs_v2|odcs_v3|rdf|avro|protobuf                                                        │
+│                    |great-expectations|terraform|avro-idl|sql|sql-query                                                        │
+│                    |html|go|bigquery|dbml|spark|sqlalchemy|data-caterer                                                        │
+│                    |dcs|iceberg]                                                                                                       │
 │    --output        PATH                                                  Specify the file path where the exported data will be │
 │                                                                          saved. If no path is provided, the output will be     │
 │                                                                          printed to stdout.                                    │
@@ -847,6 +851,12 @@ models:
 │                                                                          file to refer to a model, e.g., `orders`, or `all`    │
 │                                                                          for all models (default).                             │
 │                                                                          [default: all]                                        │
+│    --schema        TEXT                                                  The location (url or path) of the Data Contract       │
+│                                                                          Specification JSON Schema                             │
+│                                                                          [default:                                             │
+│                                                                          https://datacontract.com/datacontract.schema.json]    │
+│    --engine        TEXT                                                  [engine] The engine used for great expection run.     │
+│                                                                          [default: None]                                       │
 │    --help                                                                Show this message and exit.                           │
 ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ╭─ RDF Options ──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
@@ -857,12 +867,11 @@ models:
 │                                detect the sql dialect via the specified servers in the data contract.                          │
 │                                [default: auto]                                                                                 │
 ╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
-
 ```
 
 ```bash
 # Example export data contract as HTML
-datacontract export --format html > datacontract.html
+datacontract export --format html --output datacontract.html
 ```
 
 Available export options:
@@ -893,11 +902,13 @@ Available export options:
 | `sqlalchemy`         | Export to SQLAlchemy Models                             | ✅      |
 | `data-caterer`       | Export to Data Caterer in YAML format                   | ✅      |
 | `dcs`                | Export to Data Contract Specification in YAML format    | ✅      |
+| `iceberg`            | Export to an Iceberg JSON Schema Definition             | partial |
 | Missing something?   | Please create an issue on GitHub                        | TBD    |
 
+
 #### Great Expectations
 
-The export function transforms a specified data contract into a comprehensive Great Expectations JSON suite.
+The `export` function transforms a specified data contract into a comprehensive Great Expectations JSON suite.
 If the contract includes multiple models, you need to specify the names of the model you wish to export.
 
 ```shell
@@ -907,7 +918,22 @@ datacontract  export datacontract.yaml --format great-expectations --model order
 The export creates a list of expectations by utilizing:
 
 - The data from the Model definition with a fixed mapping
-- The expectations provided in the quality field for each model (find here the expectations gallery https://greatexpectations.io/expectations/)
+- The expectations provided in the quality field for each model (find here the expectations gallery: [Great Expectations Gallery](https://greatexpectations.io/expectations/))
+
+### Additional Arguments
+
+To further customize the export, the following optional arguments are available:
+
+- **`suite_name`**: The name of the expectation suite. This suite groups all generated expectations and provides a convenient identifier within Great Expectations. If not provided, a default suite name will be generated based on the model name(s).
+
+- **`engine`**: Specifies the engine used to run Great Expectations checks. Accepted values are:
+  - `pandas` — Use this when working with in-memory data frames through the Pandas library.
+  - `spark` — Use this for working with Spark dataframes.
+  - `sql` — Use this for working with SQL databases.
+
+- **`sql_server_type`**: Specifies the type of SQL server to connect with when `engine` is set to `sql`.
+
+  Providing `sql_server_type` ensures that the appropriate SQL dialect and connection settings are applied during the expectation validation.
 
 #### RDF
 
@@ -1000,18 +1026,81 @@ models:
     - **avroLogicalType**: Specifies the logical type of the field in Avro. In this example, it is `local-timestamp-micros`.
     - **avroDefault**: Specifies the default value for the field in Avro. In this example, it is 1672534861000000 which corresponds to ` 2023-01-01 01:01:01 UTC`.
 
+#### Iceberg
+
+Exports to an [Iceberg Table Json Schema Definition](https://iceberg.apache.org/spec/#appendix-c-json-serialization).
 
-### import
+This export only supports a single model export at a time because Iceberg's schema definition is for a single table and the exporter maps 1 model to 1 table, use the `--model` flag
+to limit your contract export to a single model.
 
+```bash
+ $ datacontract export --format iceberg --model orders https://datacontract.com/examples/orders-latest/datacontract.yaml --output /tmp/orders_iceberg.json
+ 
+ $ cat /tmp/orders_iceberg.json | jq '.'
+{
+  "type": "struct",
+  "fields": [
+    {
+      "id": 1,
+      "name": "order_id",
+      "type": "string",
+      "required": true
+    },
+    {
+      "id": 2,
+      "name": "order_timestamp",
+      "type": "timestamptz",
+      "required": true
+    },
+    {
+      "id": 3,
+      "name": "order_total",
+      "type": "long",
+      "required": true
+    },
+    {
+      "id": 4,
+      "name": "customer_id",
+      "type": "string",
+      "required": false
+    },
+    {
+      "id": 5,
+      "name": "customer_email_address",
+      "type": "string",
+      "required": true
+    },
+    {
+      "id": 6,
+      "name": "processed_timestamp",
+      "type": "timestamptz",
+      "required": true
+    }
+  ],
+  "schema-id": 0,
+  "identifier-field-ids": [
+    1
+  ]
+}
 ```
- Usage: datacontract import [OPTIONS]
 
- Create a data contract from the given source location. Prints to stdout.                                                      
+### import
+
+```
+ Usage: datacontract import [OPTIONS]                                                                                          
+                                                                                                                               
+ Create a data contract from the given source location. Saves to file specified by `output` option if present, otherwise
+ prints to stdout.                                                                                                                    
                                                                                                                                
 ╭─ Options ───────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
-│ *  --format                       [sql|avro|dbt|glue|jsonschema|bigquery|odcs  The format of the source file.               │
-│                                   |unity|spark|iceberg]                        [default: None]                              │
+│ *  --format                       [sql|avro|dbt|dbml|glue|jsonschema|bigquery  The format of the source file.               │
+│                                   |odcs|unity|spark|iceberg|parquet]           [default: None]                              │
 │                                                                                [required]                                   │
+│    --output                       PATH                                         Specify the file path where the Data         │
+│                                                                                Contract will be saved. If no path is        │
+│                                                                                provided, the output will be printed to      │
+│                                                                                stdout.                                      │
+│                                                                                [default: None]                              │
 │    --source                       TEXT                                         The path to the file or Glue Database that   │
 │                                                                                should be imported.                          │
 │                                                                                [default: None]                              │
@@ -1041,7 +1130,8 @@ models:
 │                                                                                empty for all tables in the file).           │
 │                                                                                [default: None]                              │
 │    --iceberg-table                TEXT                                         Table name to assign to the model created    │
-│                                                                                from the Iceberg schema. [default: None]     │
+│                                                                                from the Iceberg schema.                     │
+│                                                                                [default: None]                              │
 │    --help                                                                      Show this message and exit.                  │
 ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```
@@ -1050,6 +1140,8 @@ Example:
 ```bash
 # Example import from SQL DDL
 datacontract import --format sql --source my_ddl.sql
+# To save to file
+datacontract import --format sql --source my_ddl.sql --output datacontract.yaml
 ```
 
 Available import options:
@@ -1068,6 +1160,7 @@ Available import options:
 | `dbml`             | Import from DBML models                        | ✅      |
 | `protobuf`         | Import from Protobuf schemas                   | TBD    |
 | `iceberg`          | Import from an Iceberg JSON Schema Definition  | partial |
+| `parquet`          | Import from Parquet File Metadta               | ✅      |
 | Missing something? | Please create an issue on GitHub               | TBD    |
 
 
@@ -1270,6 +1363,16 @@ datacontract import --format iceberg --source ./tests/fixtures/iceberg/simple_sc
 ╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
 ```
 
+Examples:
+
+```
+# create a catalog right in the current folder
+datacontract catalog --output "."
+
+# Create a catalog based on a filename convention
+datacontract catalog --files "*.odcs.yaml"
+```
+
 ### Publish
 
 ```
@@ -1587,7 +1690,7 @@ if __name__ == "__main__":
 Output
   
 ```yaml
-dataContractSpecification: 0.9.3
+dataContractSpecification: 1.1.0
 id: uuid-custom
 info:
   title: my_custom_imported_data