pkg

pkg

微工具集 25 合 1（零第三方依赖，仅标准库）——bloomx/bufiox/cache/cli/container/contextx/convert/encoding/enumx/errors/httpjson/jsonrepair/mathx/pack/pagination/pathx/ptrx/secretx/shellx/singleflighttest/slicex/stringx/strmap/timex/urlguard

🌐 项目主页：https://oekit.github.io/ · 名称由来：Open Easy Kit（开源 · 易用 · 工具集合） 🤖 AI Agent：本仓规范与硬规则见 AGENTS.md；机器可读索引见 llms.txt（接口签名以源码为准）。

安装

go get github.com/oekit/pkg@v0.37.1

这个仓库做什么

pkg 是 oekit 的基础工具集：24 个经过生产验证的小工具包合成一个 module， 覆盖错误处理、字符串/切片/类型转换、泛型容器、时间与 cron、JSON 修复、 HTTP JSON 调用、分页、glob 匹配、进程内缓存、零拷贝缓冲 IO、GC 友好只读字典、 CLI 子命令分发、迁移包容器等日常高频需求。标识与校验（uidgen/validator）已拆分至 kitx。

设计原则：

• 按包编译：import 哪个子包用哪个，go.mod 只多一条 require，二进制零冗余
• 零第三方依赖（本仓硬规则，CI 强制）：go.mod 永不出现 require——全部子包仅依赖标准库；需要三方能力的基础工具拆独立仓（先例：validator/uidgen → kitx）
• 生产验证：全部代码源自 enjoydream 后端服务多年共用积累，带完整单元测试（24/24 包）

包清单

快速使用

import (
    "github.com/oekit/pkg/errors"
    "github.com/oekit/pkg/jsonrepair"
    "github.com/oekit/pkg/stringx"
)

// 错误链：nil-safe 包装 + kv 关联字段，Is/As 语义保持
err := errors.Wrap(io.ErrUnexpectedEOF, "read config", "path", "/etc/app.yaml")

// 脏 JSON 修复（LLM 场景）
fixed := jsonrepair.Repair(`{"name": "oekit",) `)

fmt.Println(stringx.Pluralize(3, "module")) // 3 modules

import (
    "github.com/oekit/pkg/bufiox"
    "github.com/oekit/pkg/strmap"
)

// 零拷贝解析：Peek 定长头 → Next 出负载视图，全程无字段级拷贝
r := bufiox.NewDefaultReader(conn)
hdr, _ := r.Peek(4)                  // 零拷贝视图
_ = r.Skip(4)
payload, _ := r.Next(int(binary.BigEndian.Uint32(hdr)))
defer r.Release(nil)                 // Release 后视图失效

// GC 友好只读字典：构建后只读，Get 无 map 开销
var canon = strmap.NewStr2StrFromMap(map[string]string{
    "content-type": "Content-Type",
})
name, ok := canon.Get("content-type") // "Content-Type", true

边界

• 需要并发原语（safe-go/重试/限流）→ concurrency
• 需要日志 → logx；需要数据库 → gormx
• 本仓不依赖矩阵内任何其他模块（validator→errors、httpjson→stringx、bloomx→encoding 三条内部边除外）

矩阵总览（24 活跃模块，自动生成）

依赖严格自底向上；微库已合并为 pkg，旧微库仓已删除。

本仓在矩阵中的位置与依赖见上表「矩阵内依赖」列。历史沿革：源自 ekit 单体库 （git.enjoye.top/enjoydream/ekit v0.34.0，冻结维护），2026-10 拆分为独立 module。

License

MIT — 见 LICENSE