Repository navigation
Releases: griot-cloud/parcel
Release list
0.0.4
parcel validate CONTRACT: checks a contract compiles. No data needed.parcel lint CONTRACT: validates, then reportsadmit-reads-only-ctx,
unsatisfiable-callers,constant-rule,duplicate-condition,unused-extension, and
notes.--deny-warningsexits 1 on warnings.--schemais optional forvalidate,lintandcompile. Column types come from the
binding's local Parquet data, elseexpose. Without data, a rule reading a column not in
exposeis refused.parcel checkreports one section per caller: exposed columns, rows received, each policy
(decide,admit,transform,shape) and each quality rule over the caller's rows, with
pass rates and the commonest failing values. A refused caller shows the rule, its condition
and the caller's value. All counts run concurrently, each with a progress bar on a terminal.versionis a semantic version:1.0.0,2.1.0-beta.1. A whole number N reads as N.0.0;
a decimal such as1.10is refused with the fix (1.10.0).parcel_core::Versionreplaces
u32on documents and compiled contracts, and serialises as a string, so contract hashes
change. ODCS import keeps the full version.- Rules take an optional
message, shown incheckoutput and kept in the compiled report
(ReportEntry::message). Contracts without it hash as before. - Every structural problem in a document is reported at once, with its line and a fix.
ContractDoc::parse_allreturns them all. Diagnostichashelpandline. Messages suggest close names for columns,ctxfields,
functions and types (integer→int64), name the operation that fits a namespace, and
catchand,=andis null.- A whole-number literal beside a double is a double (
row.cost > 0); beside an unsigned
column, unsigned. Only exact literals are converted. - Output:
error[Code]with the source line andhelp:, aligned columns, colour on
terminals only (none when piped or withNO_COLOR).parcelwith no command prints help. compileprints each rule's op and tier; reasons are in--json. Anadmitthat reads
onlyctxis reported as plan time.- A compiled contract round-trips through bytes:
Compilation::to_bytesand
Compilation::from_bytes(parcel_runtime::compiled). Loading never compiles. - The
parcel-bundle/1bundle andBundle::verify, which recompiled it, are removed.
parcel compile -owrites the compiled bytes.BundledFunction,ColumnDefand the schema
helpers move toparcel_runtime::compiled.
Install
Linux and macOS: curl -LsSf https://github.com/griot-cloud/parcel/releases/latest/download/install.sh | sh
Windows: powershell -ExecutionPolicy ByPass -c "irm https://github.com/griot-cloud/parcel/releases/latest/download/install.ps1 | iex"
Or download the archive for your platform below and check it against its .sha256.
0.0.3
- Embedding columns: a contract can expose
fixed_size_list<float32, N>with a positive
dimension N. The checker refuses other element types, a zero or negative dimension, and a
column whose dimension differs from the data's or from the function that produces it. - CEL and DataFusion both evaluate rules over embeddings and agree, null rows included,
keeping float32 and the dimension;sizeworks on an embedding. - A bundle keeps an embedding schema through serialisation and verification, and fails
verification if the declared dimension is changed. - WebAssembly functions take and return embeddings: in Rust,
parcel_udf::export!accepts
[f32; N], and function signatures may namefixed_size_list<float32, N>. The host refuses
output of the wrong dimension or length. - The residency check and the embedding decoder now pass clippy on Rust 1.98, with no change
in behaviour. - 0.0.2 was not published on its own; its changes ship in this release.
Install
Linux and macOS: curl -LsSf https://github.com/griot-cloud/parcel/releases/latest/download/install.sh | sh
Windows: powershell -ExecutionPolicy ByPass -c "irm https://github.com/griot-cloud/parcel/releases/latest/download/install.ps1 | iex"
Or download the archive for your platform below and check it against its .sha256.
0.0.1
- The contract language: seven operations (
decide,expose,admit,assert,transform,
guarantee,shape) over three namespaces (ctx,dataset,row), checked against the
data's Arrow schema. - The compiler: CompiledContract, ValidationPlan and WritePlan sharing one hash, and the
parcel-bundle/1artifact an engine verifies by recompiling. - Shapes: small-cell suppression, sampling, and Laplace noise at the row or the aggregate.
- Exports: SQL for seven dialects, Substrait, and ODCS v3 import.
- Tenant functions as WebAssembly modules, pinned by hash.
- The
parcelcommand:check,compile,schema,import odcs,function verify. - Binaries for Linux, macOS and Windows, with
install.shandinstall.ps1installers.
Install
Linux and macOS: curl -LsSf https://github.com/griot-cloud/parcel/releases/latest/download/install.sh | sh
Windows: powershell -ExecutionPolicy ByPass -c "irm https://github.com/griot-cloud/parcel/releases/latest/download/install.ps1 | iex"
Or download the archive for your platform below and check it against its .sha256.