Data Product CLI
The dataproduct CLI is an open-source command-line tool for working with
data products defined with the
Open Data Product Standard (ODPS).
It is the data-product sibling of
datacontract-cli (which
targets the Open Data Contract Standard) and mirrors its technology and
release mechanism. The tool is written in Python and can be used standalone, in
CI/CD, or as a Python library.
The behavior of each command is specified in
specs/.
Install
uv tool install --python python3.11 dataproduct-cli
# or
pip install dataproduct-cli
Commands
init — create a data product
dataproduct init # writes ./dataproduct.odps.yaml
dataproduct init my.odps.yaml # custom path
dataproduct init --overwrite # replace an existing file
dataproduct init --template <url|path> # seed from a template or existing product
lint — validate against the ODPS standard
dataproduct lint # lints ./dataproduct.odps.yaml
dataproduct lint my.odps.yaml
dataproduct lint --all-errors # report every schema violation
dataproduct lint --output-format junit --output TEST-dataproduct.xml
dataproduct lint --json-schema ./odps.schema.json # validate against a custom schema
Validation is schema-only in 0.1: the data product is checked against the
bundled ODPS v1.0.0 JSON Schema. Exit code is 0 when valid, 1 otherwise.
publish — publish to Entropy Data
export ENTROPY_DATA_API_KEY=... # from Entropy Data → Settings → API Keys
dataproduct publish my.odps.yaml
publish sends PUT {host}/api/dataproducts/{id} with an x-api-key header.
The host defaults to https://api.entropy-data.com and can be overridden with
ENTROPY_DATA_HOST. The referenced team must already exist in your org.
Configuration
| Purpose | Variable (with fallbacks) |
|---|---|
| API host | ENTROPY_DATA_HOST → DATAMESH_MANAGER_HOST → DATACONTRACT_MANAGER_HOST → https://api.entropy-data.com |
| API key | ENTROPY_DATA_API_KEY → DATAMESH_MANAGER_API_KEY → DATACONTRACT_MANAGER_API_KEY |
.env files are loaded automatically.
Use as a library
from dataproduct.data_product import DataProduct
run = DataProduct(data_product_file="dataproduct.odps.yaml").lint()
assert run.result == "passed"
DataProduct(data_product_file="dataproduct.odps.yaml").publish()
Development
See AGENTS.md.
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file dataproduct_cli-0.1.0.tar.gz.
File metadata
- Download URL: dataproduct_cli-0.1.0.tar.gz
- Upload date:
- Size: 19.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
58738907591095a4291bccf5a9ed5f06540b26b69e4ea3f00de767395808c592
|
|
| MD5 |
47cb92093cc97c2d021ed4cb41805948
|
|
| BLAKE2b-256 |
206c4576d81dbb53a70918b932fb49dab7557ed2bc01f2d40ce45681975331cf
|
Provenance
The following attestation bundles were made for dataproduct_cli-0.1.0.tar.gz:
Publisher:
release.yaml on datacontract/dataproduct-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dataproduct_cli-0.1.0.tar.gz -
Subject digest:
58738907591095a4291bccf5a9ed5f06540b26b69e4ea3f00de767395808c592 - Sigstore transparency entry: 2407442885
- Sigstore integration time:
-
Permalink:
datacontract/dataproduct-cli@ab046570db4b70f27f54a27dffa3201c19c28cc4 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/datacontract
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@ab046570db4b70f27f54a27dffa3201c19c28cc4 -
Trigger Event:
push
-
Statement type:
File details
Details for the file dataproduct_cli-0.1.0-py3-none-any.whl.
File metadata
- Download URL: dataproduct_cli-0.1.0-py3-none-any.whl
- Upload date:
- Size: 22.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
db2d443afc987bda74ce4ebb48d2066fa0389fd330a0247530ee6fd64472f13a
|
|
| MD5 |
83f530f13c42c0ad63bd006f939476ef
|
|
| BLAKE2b-256 |
d52596e21892934c20fe0ff63f51805e2a76a68f40ad3ee229596451a448a9d6
|
Provenance
The following attestation bundles were made for dataproduct_cli-0.1.0-py3-none-any.whl:
Publisher:
release.yaml on datacontract/dataproduct-cli
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
dataproduct_cli-0.1.0-py3-none-any.whl -
Subject digest:
db2d443afc987bda74ce4ebb48d2066fa0389fd330a0247530ee6fd64472f13a - Sigstore transparency entry: 2407442969
- Sigstore integration time:
-
Permalink:
datacontract/dataproduct-cli@ab046570db4b70f27f54a27dffa3201c19c28cc4 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/datacontract
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yaml@ab046570db4b70f27f54a27dffa3201c19c28cc4 -
Trigger Event:
push
-
Statement type:
