🖥️ CLI Reference

fimod s -i <INPUT> -m <MOLD> [OPTIONS]
fimod s -i <INPUT> -e '<EXPRESSION>' [OPTIONS]
fimod s --no-input -m <MOLD> [OPTIONS]

# Fetch JSON from an API
fimod s -i https://api.github.com/repos/pytgaen/fimod -e 'data["name"]' --output-format txt

# Multiple URLs in batch mode
fimod s -i https://jsonplaceholder.typicode.com/users/1 https://jsonplaceholder.typicode.com/users/2 -e 'data' -o responses/

# Authenticated API
fimod s -i https://api.github.com/user \
    --http-header "Authorization: Bearer $GITHUB_TOKEN" \
    -e 'data["login"]' --output-format txt

# Disable redirects to inspect the Location header
fimod s -i https://github.com/pytgaen/fimod/releases/latest \
    --input-format http --no-follow \
    -e 'data["headers"]["location"]' --output-format txt

data = {
    "status": 200,
    "headers": {"content-type": "application/json", "location": "..."},
    "body": "..."  # raw response body as a string
}

# Get the redirect target of a URL
fimod s -i https://github.com/pytgaen/fimod/releases/latest \
    --input-format http --no-follow \
    -e 'data["headers"]["location"].split("/")[-1]' --output-format txt
# → v0.3.0

# Combine with set_input_format() to re-parse the body
fimod s -i https://api.github.com/repos/pytgaen/fimod/releases/latest \
    --input-format http \
    -e 'set_input_format("json"); data["body"]' \
    -e 'data["tag_name"]' --output-format txt

# 🔗 Two separate JSON objects → array of two
printf '{"a":1}\n{"b":2}' | fimod s --slurp -e 'len(data)'
# → 2

# 📂 Combine multiple JSON files via cat (JSON only)
cat file1.json file2.json | fimod s --slurp -e '[item for item in data if item.get("active")]'

# ➕ List mode — access by index, cross-format (JSON + YAML)
fimod s -i base.json -i override.yaml -s -e 'data[1]["env"]'

# 🏷️ Named mode — auto stem as key
fimod s -i defaults.json: -i prod.toml: -s \
  -e 'data["defaults"]["timeout"]'

# 🏷️ Named mode — explicit aliases (resolves stem collisions)
fimod s -i config/base.json:base -i other/base.json:fallback -s \
  -e 'data["fallback"]["host"]'

# 🔍 Diff two files (with df_ helpers, once implemented)
fimod s -i before.json:old -i after.json:new -s \
  -e 'df_diff(data["old"], data["new"])'

# 💾 Write result to a file
fimod s -i a.yaml -i b.yaml -s -e 'data[0]' -o merged.yaml

fimod s --no-input -e '{"status": "ok", "ts": args["ts"]}' --arg ts="2024-01-01"

fimod s --no-input -m generate.py --arg count=5

# generate.py
def transform(data, args, env, headers):
    n = int(args["count"])
    return [{"id": i, "value": i * i} for i in range(n)]

# ✅ Validate a record
fimod s -i record.json -e 'data.get("email") and data.get("name")' --check

# 🔀 Use in a shell conditional
if fimod s -i config.json -m validate.py --check; then
    echo "✅ Config is valid"
else
    echo "❌ Config has errors" >&2
    exit 1
fi

fimod registry setup                                     # 🚀 First-run setup (official catalog)
fimod registry add my ~/molds/                          # ➕ Add local registry
fimod registry add official https://github.com/org/molds # ➕ Add GitHub registry
fimod registry list                                      # 📋 List registries
fimod registry show my                                   # 🔍 Show details
fimod registry remove my                                 # 🗑️ Remove
fimod registry set-default official                      # ⭐ Change default
fimod registry build-catalog my                          # 📦 Generate catalog.toml

fimod registry setup           # interactive — asks before adding
fimod registry setup --yes     # non-interactive / CI — skips the prompt
fimod registry setup --force   # promote official registry to default even if another default exists

# Anonymous — resolves @mold
FIMOD_REGISTRY=./molds fimod s -i data.json -m @clean

# Named — resolves @ci/mold and @mold
FIMOD_REGISTRY="ci=./molds,staging=https://github.com/org/molds" fimod s -i data.json -m @ci/clean

# Mixed anonymous + named
FIMOD_REGISTRY="ci=./molds,/opt/shared-molds" fimod s -i data.json -m @clean

# Register a local collection once…
fimod registry add my ~/molds/

# …then reference molds by name
fimod s -i messy.csv -m @cleanup          # default registry
fimod s -i messy.csv -m @my/cleanup       # named registry

# Branch — standard github.com URL
fimod registry add mylib https://github.com/org/repo/tree/main/molds

# Semver tag — standard github.com URL
fimod registry add mylib https://github.com/org/repo/tree/v1.2.0/molds

# Non-semver tag — raw URL required
fimod registry add mylib https://raw.githubusercontent.com/org/repo/refs/tags/stable/molds

fimod mold list              # list molds in the default registry
fimod mold list official     # list molds in a specific registry

fimod registry build-catalog my   # scans ~/molds/ and writes catalog.toml

[molds.normalize]
description = "Normalise field names to snake_case"

[molds.filter_active]
description = "Keep only active records"

"""Normalise field names to snake_case."""
def transform(data, args, env, headers):
    ...

# 🔀 CSV → TSV
fimod s -i data.csv -e 'data' --output-format csv --csv-output-delimiter '\t'

# 📦 Compact JSON: one-line JSON for piping
fimod s -i data.json -e 'data' --output-format json-compact
# {"name":"Alice","age":30}

# 🐚 TXT: evaluate string without JSON quotes (ideal for shell variables)
NAME=$(fimod s -i data.json -e 'data["name"]' --output-format txt)
echo "Hello $NAME"   # Hello Alice

# 📥 Raw: download binary streams or raw bytes (no parsing, bypass pipeline)
fimod shape -i https://example.com/file.bin --output-format raw -o file.bin

fimod s -i users.json --arg threshold=30 -e '
  [u for u in data if u["age"] > int(args["threshold"])]
'

# Or via mold:
fimod s -i data.json -m filter.py --arg threshold=30 --arg prefix="A"

fimod s -i config.yaml -e 'data' -o config.toml
fimod s -i data.csv -e 'data' --output-format json
fimod s -i users.json -e 'data' --output-format lines

fimod s -i data.json -m transform.py --debug

fimod s -i data.json -m transform.py --quiet              # errors only
fimod s -i data.json -m transform.py --msg-level=verbose  # + msg_verbose()
fimod s -i data.json -m transform.py --msg-level=trace    # + msg_trace()

fimod s -i config.json -e '{"host": data["host"], "port": data["port"]}' --in-place

# 📥 Read from stdin
cat data.json | fimod s -e '{"count": len(data)}'

# 🔗 Pipe chain
curl -s https://jsonplaceholder.typicode.com/todos | fimod s -e '[d for d in data if d["completed"]]' | jq .

fimod monty repl
# Monty REPL v0.0.8 — fimod v0.1.0-alpha.1 (exit or Ctrl+D to quit)
# >>> 2 + 2
# 4
# >>> [x ** 2 for x in range(5)]
# [0, 1, 4, 9, 16]
# >>> exit