numbox

numbox

NumberMan 的 Go 工具箱，包含错误码、集合、随机抽样、时间、环境变量和常用数据结构。 模块路径为 github.com/NumberMan1/numbox，按需导入各子包。

安装与环境

要求 Go 1.25.1 或以上版本。在使用方的 Go module 中执行：

go get github.com/NumberMan1/numbox@latest

可将 @latest 替换为 已有 tag 以固定版本。 项目仍处于 v0 阶段，升级前请阅读 变更记录 与版本之间的差异。

所有组件均可在 CGO_ENABLED=0 下构建，pkg/go-zset 已改为纯 Go，支持原生 Windows。 CI 配置覆盖 Ubuntu、macOS 和 Windows；竞态检测本身仍需要 Go 工具链的 CGo 支持。

快速开始

package main

import (
    "fmt"

    "github.com/NumberMan1/numbox/pkg/collection"
)

func main() {
    names := collection.NewSet("alice", "bob")
    names.Add("alice", "carol")
    names.Remove("bob")

    fmt.Println(names.Contains("alice")) // true
    fmt.Println(names.Contains("bob"))   // false
}

工具索引

工具按职责位于 utils/convutil、utils/sliceutil、utils/maputil、utils/jsonutil 等子包； 根 utils 没有可导入的 Go 包。有状态组件、数据结构和算法保留在 pkg/*。 原 pkg/utils 或根 utils 的使用方需按函数职责更新导入，详见 工具索引 和 迁移说明。 内嵌敏感词组件已移除，需要匹配时显式构造 pkg/matcher 并提供自己的词表。 锁不再自动过期，迁移规则见 lock 说明。

具体 API 见 Go 文档 和对应包源码。 不同工具的并发与生命周期约定各异，例如 bitmap.BitMap 不支持并发修改， 使用前应阅读对应接口说明。

开发与验证

在仓库根目录执行（竞态检测本身需要 CGo 工具链）：

go mod download all
CGO_ENABLED=0 go build ./...
go test -race -count=1 ./...
go vet ./...
git diff --check

CI 配置见 .github/workflows/ci.yml。 贡献流程、依赖维护与验证要求见 CONTRIBUTING.md。

社区与许可

• 获取帮助 · 报告问题
• 贡献指南 · 行为准则
• 安全政策 · 维护者与发布流程
• 变更记录 · 第三方来源与许可说明

项目原创内容采用 MIT 许可证。第三方代码、依赖和数据的权利以其原始许可为准； 尚待确认的历史来源见第三方说明。