feat(hash): 添加 BLAKE2b 校验和算法支持

- 在 `hash` 模块中新增 `blake2b` 子包,实现 BLAKE2b 系列散列算法
- 支持多种输出长度:224、256、384 和 512 位
- 提供字节及十六进制字符串两种格式的散列计算函数
- 支持对字节数组和文件进行散列计算
- 更新 go.mod 使用 Go 1.24.0 并引入 golang.org/x/crypto 和 golang.org/x/sys 依赖
- 更新 README.md 标记 BLAKE2b 功能为已完成
This commit is contained in:
徐涛
2025-10-07 22:29:05 +08:00
parent 53330ceab9
commit 357b19d9ad
4 changed files with 126 additions and 3 deletions

117
hash/blake2b/blake2b.go Normal file
View File

@@ -0,0 +1,117 @@
// 提供Blake2B系列散列算法函数和校验和函数。
package blake2b
import (
"encoding/hex"
"fmt"
"hash"
"io"
"os"
"golang.org/x/crypto/blake2b"
)
// 根据给定的位数返回一个散列算法的Hash实例。
func hasherSelect(bitSize int) hash.Hash {
switch bitSize {
case 224:
hasher, _ := blake2b.New256(nil)
return hasher
case 256:
hasher, _ := blake2b.New256(nil)
return hasher
case 384:
hasher, _ := blake2b.New384(nil)
return hasher
case 512:
hasher, _ := blake2b.New512(nil)
return hasher
default:
hasher, _ := blake2b.New256(nil)
return hasher
}
}
// 计算给定字节数组的Blake2B校验和返回字节数组。
func Blake2b(data []byte) []byte {
hasher := hasherSelect(512)
hasher.Write(data)
return hasher.Sum(nil)
}
// 计算给定字节数组的Blake2B/256校验和返回字节数组。
func Blake2b_256(data []byte) []byte {
hasher := hasherSelect(256)
hasher.Write(data)
return hasher.Sum(nil)
}
// 计算给定字节数组的Blake2B/384校验和返回字节数组。
func Blake2b_384(data []byte) []byte {
hasher := hasherSelect(384)
hasher.Write(data)
return hasher.Sum(nil)
}
// 计算给定字节数组的Blake2B/224校验和返回字节数组。
func Blake2b_224(data []byte) []byte {
hasher := hasherSelect(224)
hasher.Write(data)
return hasher.Sum(nil)
}
// 计算给定字节数组的Blake2B校验和返回十六进制字符串。
func Blake2bHex(data []byte) string {
return hex.EncodeToString(Blake2b(data))
}
// 计算给定字节数组的Blake2B/256校验和返回十六进制字符串。
func Blake2b_256Hex(data []byte) string {
return hex.EncodeToString(Blake2b_256(data))
}
// 计算给定字节数组的Blake2B/384校验和返回十六进制字符串。
func Blake2b_384Hex(data []byte) string {
return hex.EncodeToString(Blake2b_384(data))
}
// 计算给定字节数组的Blake2B/224校验和返回十六进制字符串。
func Blake2b_224Hex(data []byte) string {
return hex.EncodeToString(Blake2b_224(data))
}
// 根据给定位数计算一个字节数组的Blake2B校验和返回字节数组。
func Sum(data []byte, bitSize ...int) []byte {
hasher := hasherSelect(append(bitSize, 512)[0])
hasher.Write(data)
return hasher.Sum(nil)
}
// 根据给定位数计算一个字节数组的Blake2B校验和返回十六进制字符串。
func SumHex(data []byte, bitSize ...int) string {
return hex.EncodeToString(Sum(data, bitSize...))
}
// 根据给定位数计算一个文件的Blake2B校验和返回字节数组。
func SumFile(file string, bitSize ...int) ([]byte, error) {
f, err := os.Open(file)
if err != nil {
return nil, fmt.Errorf("未能打开指定文件,%w", err)
}
defer f.Close()
hasher := hasherSelect(append(bitSize, 512)[0])
if _, err := io.Copy(hasher, f); err != nil {
return nil, fmt.Errorf("未能读取指定文件的内容,%w", err)
}
return hasher.Sum(nil), nil
}
// 根据给定位数计算一个文件的Blake2B校验和返回十六进制字符串。
func SumFileHex(file string, bitSize ...int) (string, error) {
hash, err := SumFile(file, bitSize...)
if err != nil {
return "", err
}
return hex.EncodeToString(hash), nil
}