libra rev-parse

Parse revision names and print normalized commit IDs, symbolic refs, or repository paths.

Synopsis

libra rev-parse [OPTIONS] [SPEC]...

Description

libra rev-parse resolves a revision-like input into one of three forms:

• the full commit ID (default)
• a short commit ID with --short
• a symbolic branch name with --abbrev-ref

It also supports --show-toplevel to print the absolute repository root for a working tree. When no <SPEC> is provided, the command defaults to HEAD; multiple <SPEC> arguments are each resolved on their own line. The output-filter flags (--flags/--no-flags/--revs-only/--no-revs) instead classify each argument as a flag, revision, or path and print a filtered subset.

Options

Common Commands

libra rev-parse
libra rev-parse HEAD~1
libra rev-parse --short HEAD
libra rev-parse --abbrev-ref HEAD
libra rev-parse --show-toplevel
libra rev-parse --is-inside-git-dir
libra rev-parse --absolute-git-dir
libra --json rev-parse --short HEAD

Human Output

Default output is a single line containing the resolved value.

abc1234def5678901234567890abcdef12345678

With --short:

abc1234

With --abbrev-ref:

main

With --show-toplevel:

/home/alice/project

Structured Output

{
  "ok": true,
  "command": "rev-parse",
  "data": {
    "mode": "short",
    "input": "HEAD",
    "value": "abc1234"
  }
}

mode is one of resolve, short, abbrev_ref, symbolic_full_name, symbolic, show_toplevel, show_prefix, show_cdup, is_inside_work_tree, is_inside_git_dir, is_bare_repository, git_dir, or absolute_git_dir.

With a single <SPEC>, data is one such object (the shape above). With multiple <SPEC> arguments, data is a JSON array of those objects, one per spec, in order. In an output-filter mode (--flags/--no-flags/--revs-only/--no-revs), data is a JSON array of strings — the filtered tokens (resolved object names for revisions, verbatim for kept flags/paths).

Parameter Comparison: Libra vs Git vs jj

A -- separator splits revisions from paths in every mode (rev-parse <rev> -- <path>): arguments after -- are paths, never revisions, and the -- is echoed where path output applies. The single-revision modes --verify and --short print only the one resolved object (never the paths).

Intentional divergence from Git: combining --verify or --short with any output-filter flag (--flags/--no-flags/--revs-only/--no-revs) is rejected with a usage error (LBR-CLI-002, exit 129). Git's behavior for that combination is ill-defined, so Libra refuses it rather than guessing.

Error Handling