asfaload-cli get-digest

• Usage: asfaload-cli get-digest [OPTIONS] <FILE>
• Source: src/commands/get_digest.rs

Compute the SHA-512 digest of a local file or a file served over HTTP(S) and display it together with its “bishop art” — a small picture derived from the digest bytes that acts as a visual fingerprint, easy to compare by eye.

The digest is the same value the backend uses to identify pending files, and the value expected by sign-pending --digest.

Arguments

<FILE>

Either a path to a local file, or an http:///https:// URL (e.g. the URL of an artifact on a release page).

Options

--json

Emit output as JSON instead of human-readable text.

Output

Human-readable (default): the digest on the first line, then the bishop art:

sha512:2e2fde4ead7c6846656431dd4f2d2f3013e2b35d31fc32978fc03a32f54034589d65ab6666a72aab3835bf409dc7b86fdab6b2f488486c4012c0acffc41438d7
+----[SHA-512]----+
|▍  ▏ ▏   ▎▃▎▏▍▂ ▏|
| ▎▁ ▁ E ▏▏▎▎▃▏▎▎▁|
|▁ ▏▁ ▏   ▎▁▏ ▎▁▍▏|
|▏▁  ▏  ▏ ▎▂▎▁▁▎▏▂|
| ▏▏▁  ▏ S▎▎▎▃▏▏▍▏|
|  ▏▁▁▏▁▏▎▎▁▂▏▁▏ ▏|
|   ▁▎▏▁▎▂▎▏▏▏    |
|   ▁▁▁▏▄▃▍▎▏     |
|    ▁▁▎▍▅▋▍▏     |
+---[2e2fde4e…]---+

The top border labels the hash algorithm (SHA-512), the bottom border shows the first 8 characters of the digest. Two files with the same digest always render the same art, so matching pictures mean matching files.

JSON (with --json): the art is included as a plain string, without ANSI colors:

{"digest":"sha512:2e2fde4ead7c6846656431dd4f2d2f3013e2b35d31fc32978fc03a32f54034589d65ab6666a72aab3835bf409dc7b86fdab6b2f488486c4012c0acffc41438d7","bishop_art":"+----[SHA-512]----+\n|▍  ▏ ▏   ▎▃▎▏▍▂ ▏|\n| ▎▁ ▁ E ▏▏▎▎▃▏▎▎▁|\n|▁ ▏▁ ▏   ▎▁▏ ▎▁▍▏|\n|▏▁  ▏  ▏ ▎▂▎▁▁▎▏▂|\n| ▏▏▁  ▏ S▎▎▎▃▏▏▍▏|\n|  ▏▁▁▏▁▏▎▎▁▂▏▁▏ ▏|\n|   ▁▎▏▁▎▂▎▏▏▏    |\n|   ▁▁▁▏▄▃▍▎▏     |\n|    ▁▁▎▍▅▋▍▏     |\n+---[2e2fde4e…]---+"}

Examples

# digest of a local file
asfaload-cli get-digest release.tar.gz

# digest of a remote artifact
asfaload-cli get-digest https://github.com/acme/repo/releases/download/v1.0.0/release.tar.gz

# JSON output, e.g. to extract the digest in a script
asfaload-cli get-digest --json release.tar.gz | jq -r .digest

Exit codes

• 0 — digest computed.
• non-zero — error (file not found, invalid URL, network error).