csum

简介

csum 是一个CLI程序，允许您验证校验和。 csum 的目标是当您下载文件并想要验证校验和时，尽量减少所需的工作量。

csum 支持最常见的校验和算法

• MD5
• SHA256
• SHA512
• SHA1

此外，它还支持 SHA3_512、SHA224、BLAKE2S、SHA3_224、SHA3_256、SHA3_384、SHA384 和 BLAKE2B。

需求

您需要安装Python 3.6或更高版本。这将允许您使用Python的包管理器 pip 安装 csum。

如何安装

要使用 pip 安装 csum，请运行以下命令

pip install csum

在完成此命令后， csum 可执行文件应位于PATH中。

快速开始

csum 被设计得尽可能简单易用。因此，您不需要指定校验和类型（例如 sha256）；csum 将首先迭代最常用的类型。

用法示例

文件和校验和

您可以使用文件名和校验和调用 csum

csum file.zip 40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2

或者校验和和文件名

csum 40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2  file.zip 

接受绝对或相对路径，以及包含波浪号（~）的路径

csum ~/Downloads/file.zip 40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2  

预格式化的校验和/文件名

有时您会得到以下形式的校验和

40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2 file.zip

假设文件位于当前工作目录中，您可以直接复制此文本并在csum命令后粘贴

csum 40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2  file.zip

如果您愿意，也可以将其作为单个参数提供

csum "40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2  file.zip"

提示：在两种情况下，校验和与文件名之间的空格数量都不重要。

手动选择算法

如果您更喜欢选择特定的算法而不是迭代它们，可以使用-a/--algorithm参数。

例如，仅使用SHA256算法

csum -a sha256 file.zip 40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2

提示：您可以将算法名称提供为小写或大写，例如sha256或SHA256。

预期输出

当您使用csum时，正面响应的形式为

        --------------------------------------------------------------------------------

        File: file.zip
        Algorithm: SHA256

        Expected checksum:    40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2
        Calculated checksum:  40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2

        Checksums match ✔

        --------------------------------------------------------------------------------

SUCCESS: SHA256 checksum matched file.

负面响应的形式为

        --------------------------------------------------------------------------------

        File: file.zip
        Expected checksum:    40f66f20b1ecb05cb11a9627520aafafbc8cd86b33eb8019cbea9925d8ca83ce2

        Checksums do NOT match.

        --------------------------------------------------------------------------------

FAILED: algorithm(s) did not match the checksum.

许可证

您可以根据MIT许可证的条款自由使用、修改和重新分发此程序。请参阅LICENSE。