celq

celq Plugin

Common Expression Language (CEL) CLI tool. Evaluate CEL expressions against JSON, JSON5, YAML, TOML, and XML input. Filter, transform, and validate structured data with a familiar expression syntax.

Commands

Data Querying

• celq data query — Evaluate CEL expression against structured data

Utility

• celq self version — Print celq version
• celq _ _ — Passthrough to celq CLI

Usage Examples

• "Filter JSON array elements that contain the letter 'a'"
• "Evaluate a CEL expression with arguments"
• "Validate JSON data using a CEL condition"
• "Transform YAML data with a CEL expression"

Installation

cargo install celq

Examples

# Filter array elements containing 'a'
echo '["apples", "bananas", "blueberry"]' | celq data query 'this.filter(s, s.contains("a"))'

# Evaluate expression without stdin input
celq data query -n --arg='fruit:string=apple' 'fruit.contains("a")'

# Check if all array elements satisfy a condition
echo '[1, 2, 3]' | celq data query 'this.all(x, x > 0)'

# Map and transform data
echo '[1, 2, 3]' | celq data query 'this.map(x, x * 2)'

# Filter objects in an array
echo '[{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]' | celq data query 'this.filter(p, p.age >= 28)'

# Evaluate with multiple arguments
celq data query -n --arg='x:int=10' --arg='y:int=20' 'x + y'

# Check string contains substring
echo '{"message": "Hello, world!"}' | celq data query 'this.message.contains("world")'

Supported Input Formats

• JSON — Standard JSON
• JSON5 — JSON with comments and relaxed syntax
• YAML — YAML documents
• TOML — TOML configuration files
• XML — XML documents
• NDJSON — Newline-delimited JSON

Key Features

• Common Expression Language (CEL) — Google-developed expression language
• Multiple input formats — JSON, JSON5, YAML, TOML, XML, NDJSON
• No-input mode — Evaluate expressions with --arg flags and -n
• Pipes-friendly — Reads from STDIN, outputs to STDOUT
• Type-safe — CEL is strongly typed with automatic conversions
• Familiar syntax — Similar to JavaScript/Python expressions

Notes

• CEL expressions use this to refer to the input data
• The -n flag is used when you only want to evaluate an expression with arguments, without reading from STDIN
• Arguments use the format --arg='name:type=value' (e.g. --arg='count:int=5')
• celq supports CEL macros like filter, map, all, exists, size, has, etc.
• For detailed CEL syntax and recipes, see the celq manual