valgo 是一个为 Go 语言设计的类型安全、表达性强且可扩展的验证库。该库的特点包括：
github.com/cohesivestack/valgo
- 类型安全：利用 Go 语言的泛型特性（从 Go 1.18 版本开始支持），确保验证逻辑的类型安全。
- 表达性：验证规则通过函数链式调用来定义，而非传统的结构体标签，这提供了更灵活和自由的方式来决定数据在哪里及如何被验证。
- 可扩展性：支持自定义验证器和局部化验证消息，使得库能够适应多种场景。
- 灵活性：验证规则直接写在函数中，而非依赖于结构体标签，提高了代码的可读性和可维护性。
- 局部化：支持验证消息的定制和本地化，便于多语言环境下的错误反馈。
- JSON 输出：错误信息可以输出为 JSON 格式，便于集成到 RESTful API 中。
快速示例
以下是一个使用 valgo 进行基本验证的示例：
package main
import (
"encoding/json"
"fmt"
"github.com/cohesivestack/valgo"
)
func main() {
validation := valgo.Is(
valgo.String("test", "name").Not().Blank().OfLengthBetween(8, 20),
valgo.Number(18, "age").GreaterThan(20),
)
if !validation.Valid() {
out, _ := json.MarshalIndent(validation.Error(), "", " ")
fmt.Println(string(out))
}
}
在这个例子中，我们验证了两个条件：
name（全名）必须是非空字符串且长度在8到20个字符之间。age（年龄）必须大于20。
输出结果（当验证不通过时）可能是这样的 JSON 错误信息：
{
"age": [
"Age must be greater than 20"
],
"name": [
"name must have a length between 8 and 20"
]
}
自定义验证器
valgo 还允许创建自定义验证器。例如，假设我们想验证一个自定义的 ID 结构体：
type ID struct {
Phone string
Email string
}
func IDValue(value ID, nameAndTitle ...string) *valgo.ValidatorID {
return &valgo.ValidatorID{context: valgo.NewContext(value, nameAndTitle...)}
}
type ValidatorID struct {
context *valgo.ValidatorContext
}
func (validator *ValidatorID) Context() *valgo.ValidatorContext {
return validator.context
}
// 示例验证规则：至少提供 Phone 或 Email
func (validator *ValidatorID) HasContactInfo() *ValidatorID {
validator.context.Add(
func() bool {
return validator.context.Value().(*ID).Phone != "" || validator.context.Value().(*ID).Email != ""
},
"At least one contact method (phone or email) must be provided.",
)
return validator
}
使用自定义验证器示例
id := ID{Phone: "1234567890"}
validation := valgo.Is(IDValue(id).HasContactInfo())
if !validation.Valid() {
// 处理错误
}
这个例子展示了如何定义一个 ID 类型的验证器，并添加了一个规则来检查是否至少提供了一种联系方式（电话或电子邮件）。这体现了 valgo 库的高度可扩展性。
