Function explain

crates/flowtrace-cli/src/explain.rs:37–49

Entry point: render the schema rooted at `path` in the requested format.

(path: &str, fmt: ExplainFormat)

/// Entry point: render the schema rooted at `path` in the requested format.
pub fn explain(path: &str, fmt: ExplainFormat) -> Result<String> {
    let (root, rest) = split_root(path)?;
    let schema = root_schema_for(root);
    let target =
        navigate(&schema, &schema.schema, &rest).with_context(|| {
            format!("path `{}` does not exist in `{}` schema", path, root)
        })?;
    Ok(match fmt {
        ExplainFormat::Plaintext => render_plaintext(root, &rest, &schema, &target),
        ExplainFormat::Example => render_example(&schema, &target),
        ExplainFormat::Jsonschema => render_jsonschema(&schema, &target),
    })
}

/// Split `reply.evidence.figure` into (`reply`, `["evidence", "figure"]`).
/// Errors with a hint if the root is unknown.