digestify 0.2.0

Verify a file against a digest/hash/checksum.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

# Digestify

Command line tool to make verification of digests/checksums/hashes on downloaded files a little easier.  Just specity the file and the hash listed on the download host.  It will infer the possible digest algorithm(s) from the length.   It will succeed

## Supported Digests

 <br/>Algorithm                                                          | Bit<br/>Length | Hexadecimal<br/>Length |
 :----------------------------------------------------------------: | :--------: | :----------------: |
 [SHA-512](https://en.wikipedia.org/wiki/SHA-2)                     |  512       |  128
 [SHA-256](https://en.wikipedia.org/wiki/SHA-2)                     |  256       |   64
 [SHA-1](https://en.wikipedia.org/wiki/SHA-1)                     ‡ |  160       |   40 
 [MD5](https://en.wikipedia.org/wiki/MD5)                         ‡ |  128       |   32
 [CRC-32](https://en.wikipedia.org/wiki/Cyclic_redundancy_check)  ‡ |   32       |    8

_‡ Yeah, yeah.  But some sites still use these_

## Usage

```
$ digestify -h
digestify 0.1.0
Verify a file against a digest/checksum/hash.

USAGE:
    digestify <FILE> <DIGEST>

FLAGS:
    -h, --help       Prints help information
    -V, --version    Prints version information

ARGS:
    <FILE>      File to verify
    <DIGEST>    Digest to compare to.  Must be specified as a
                hexadecimal string.  Case does not matter.
```

If a match is found against one of the digest algorithms, the command will succeed.  Otherwise, it will fail.

## Example Usages

```
# digestify Cargo.lock ac4a0ad1af6773ce6980cc9958cfd18820275f28b8055b93e4d69688e2fd72c8

Verifying 'Cargo.lock' against provided digest of size 64 hex chars / 256 bits.  Candidate digest(s): SHA-256.

 SHA-256: MATCHES
    Expected=ac4a0ad1af6773ce6980cc9958cfd18820275f28b8055b93e4d69688e2fd72c8
      Actual=ac4a0ad1af6773ce6980cc9958cfd18820275f28b8055b93e4d69688e2fd72c8

# echo $?
0
```

```
# digestify Cargo.toml f26c2e4e001349b737a3a5cc5fc4afc87b423773
Verifying 'Cargo.toml' against provided digest of size 40 hex chars / 160 bits.  Candidate digest(s): SHA-1.

 SHA-1: FAIL
        Expected=f26c2e4e001349b737a3a5cc5fc4afc87b423773
          Actual=a30d387b67f1e4d26fd59b3ddb94cfde58d23287

# echo $?
254
```