libra hash-object

Compute the Git-compatible object ID for raw file contents or standard input.

libra hash-object [OPTIONS] <PATH>...
libra hash-object --stdin [OPTIONS]
libra hash-object --stdin-paths [OPTIONS]

It supports the four Git object types — blob (default), commit, tree, and tag — computing the object id from the <type> <size>\0<content> header using the current repository object format, byte-for-byte identical to git hash-object -t <type>. Without --literally, commit/tree/tag content is validated as a well-formed object of that type (a blob accepts any bytes). It does not apply clean filters, attributes, or LFS pointer conversion. --path is accepted as a Git compatibility path context and stdin JSON source label; it does not change the hashed bytes until path-based filters are implemented.

Read-only hashing does not require a Libra repository and defaults to SHA-1 when no repository object format is available. -w / --write requires a repository because it stores the object in the repository object database.

Options

Examples

Hash a file without writing the object:

libra hash-object README.md

Hash and write a file as a blob object:

libra hash-object -w src/main.rs

Hash file content as a typed object (the id matches git hash-object -t <type>); the content is validated as a well-formed object of that type unless --literally is given:

libra hash-object -t commit commit-payload
libra hash-object -t tag --literally arbitrary-bytes

Hash bytes from standard input:

printf 'hello' | libra hash-object --stdin

Hash stdin with a Git-compatible path context label:

printf 'hello' | libra hash-object --stdin --path README.md

Output

Human output prints one object ID per input:

b6fc4c620b67d95f953a5c1c1230aaab5db5a1b0

Structured output:

{
  "ok": true,
  "command": "hash-object",
  "data": {
    "object_type": "blob",
    "write": false,
    "objects": [
      {
        "source": "-",
        "oid": "b6fc4c620b67d95f953a5c1c1230aaab5db5a1b0",
        "size": 5,
        "written": false
      }
    ]
  }
}

Compatibility

Errors