toolsCLI Reference

CLI Reference

Complete command reference for the orp command-line tool.

Installation

pip install orp-validator
orp --version  # Verify installation

Commands

orp new

Create a new ORP document with interactive prompts or flags.

# Interactive mode
orp new my-document.yaml
 
# Non-interactive mode
orp new doc.yaml --title "My Policy" --domain policy --author "Name" \
  --compliance basic --non-interactive

Options:

  • --title TEXT - Document title
  • --domain [policy|research|business] - Document domain
  • --author TEXT - Author name
  • --compliance [basic|standard|full] - Compliance level
  • --format [yaml|json] - Output format (default: yaml)
  • --non-interactive - Skip prompts, use flags only
  • --quiet - Suppress output except errors

orp validate

Validate document against ORP JSON Schema.

orp validate my-document.yaml
orp validate doc.json --verbose
orp validate doc.yaml --json  # Machine-readable output
orp validate segment.yaml --profile ORP-Ads  # v0.3: validate against a profile

Options:

  • --verbose - Show detailed validation report
  • --json - Output JSON format for automation
  • --profile [ORP-Core|ORP-Policy|ORP-Ads|ORP-AI] - v0.3 only: validate against a specific profile (default: the document’s own profile field, else ORP-Core). For v0.3 documents the report also shows the profile and the trust tier.

Exit Codes:

  • 0 - Valid document
  • 1 - Invalid document
  • 2 - File not found or parse error

orp check

Quick compliance level check without full validation.

orp check my-document.yaml
orp check doc.yaml --json

Faster than validate for checking which layers are present.

Options:

  • --json - Machine-readable output
  • --quiet - Only output compliance level

Exit Codes:

  • 0 - ORP-Full
  • 1 - ORP-Standard
  • 2 - ORP-Basic
  • 3 - Non-compliant
  • 4 - Error

orp conform

Run the ORP v0.3 conformance suite (schema, usage-policy, and lineage fixtures). An implementation claims conformance by passing it.

orp conform
orp conform --profile ORP-Ads   # filter the schema fixtures to one profile
orp conform --json              # machine-readable report

Exit Codes:

  • 0 - Conformant (all fixtures pass)
  • 1 - Not conformant

orp diff

Compare two ORP documents.

orp diff original.yaml modified.yaml
orp diff doc1.yaml doc2.yaml --filter-metadata
orp diff doc1.yaml doc2.yaml --json

Options:

  • --filter-metadata - Exclude last_modified and created from comparison
  • --json - Machine-readable output

Output:

  • Lists all differences with field paths
  • Detects fork relationships
  • Shows added, removed, and changed fields

Examples

Create and validate

# Create Basic document
orp new policy.yaml --compliance basic --title "Education Funding" \
  --domain policy --author "Jane Doe" --non-interactive
 
# Validate it
orp validate policy.yaml
 
# Check compliance
orp check policy.yaml

Compare documents

# Create two versions
orp new v1.yaml --title "Version 1" --non-interactive
orp new v2.yaml --title "Version 2" --non-interactive
 
# Compare them
orp diff v1.yaml v2.yaml

See Quick Start Guide for more examples.

Online ValidatorPython API