ekit-network

module
v0.2.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Oct 14, 2026 License: MIT

README

ekit-network

轻量网络客户端——WebSocket、NATS、消息队列抽象、连接与流工具。

本仓库是 ekit(git.enjoye.top/enjoydream/ekit v0.34.0) 拆分出的独立 Go module,属于 yi-nology ekit 子项目矩阵(Round-2 深拆粒度)。

安装

go get github.com/yi-nology/ekit-network@v0.2.0

包清单

  • `wsutil/` — WebSocket 广播器(背压安全)
  • `nats/`、`mq/` — NATS 客户端与 MQ 抽象
  • `conn/`、`streamx/` — 连接管理与流工具
  • `octopus/` — Octopus 推送客户端

HTTP 客户端(httpx)与负载均衡已迁 ekit-httpx。

依赖关系

子项目矩阵与依赖方向(自底向上,19 仓):

ekit-core            文本/数据工具 + governance/lifecycle/version      (零内部依赖)
ekit-concurrency     并发与流控原语                                     (零内部依赖)
ekit-logx            日志门面 + shutdown                                (零内部依赖)
ekit-istio           Istio Proxyless                                    (零内部依赖)
  ekit-metrics       Prometheus 门面                          → core
  ekit-tracing       OTel + traceid                           → logx
  ekit-registry      注册发现 + 配置                          → core, logx
    ekit-data        缓存抽象 + 定时任务                      → core, logx, concurrency
      ekit-gorm      SQL/GORM 全家                            → core, logx
      ekit-redis     Redis 全家                               → data, core, logx
    ekit-httpx       HTTP 客户端 + 负载均衡                   → core, concurrency, logx, metrics, tracing, registry
      ekit-nns       服务治理客户端                           → httpx, registry, core, logx, tracing, metrics
        ekit-bootstrap 应用引导
    ekit-middleware  Hertz 中间件栈                           → core, concurrency, logx, metrics, tracing, registry
    ekit-hertz       Hertz 运行时/适配/instrumentation        → middleware, gorm, nns, registry, metrics, tracing, logx, core
    ekit-kitex       Kitex 生态                               → nns, registry, core, concurrency, logx, metrics
  ekit-workflow      流程编排                                 → concurrency, logx

注:ekit-observability 已在 Round-2 深拆中解散——logx 迁 [ekit-logx]、metrics 迁 [ekit-metrics]、 tracing/traceid 迁 [ekit-tracing]、shutdown 迁 [ekit-logx];原仓库已归档。

依赖:ekit-core、ekit-logx、ekit-tracing、ekit-concurrency。

与 ekit 单体仓库的关系

  • 代码与 ekit v0.34.0 等价,module 路径 git.enjoye.top/enjoydream/ekit/... → github.com/yi-nology/ekit-network/...
  • 各子仓库独立发版(SemVer);开发规范沿用 ekit AGENTS.md 约定

License

见 LICENSE

Directories

Path Synopsis
network
conn
Package conn 提供连接管理相关的工具。
Package conn 提供连接管理相关的工具。
mq
Package mq 提供消息队列统一门面。
Package mq 提供消息队列统一门面。
nats
Package nats 提供 NATS 消息队列客户端封装。
Package nats 提供 NATS 消息队列客户端封装。
octopus
Package octopus octopus 消息平台推送客户端(公司 IM 基建件,收编自 argus internal/notify,v0.32.0):POST /api/v2/send/quick,X-User-Id 机器账号头(octopus AuthMiddleware 按 header 自动建账号)+ 可选 Bearer。
Package octopus octopus 消息平台推送客户端(公司 IM 基建件,收编自 argus internal/notify,v0.32.0):POST /api/v2/send/quick,X-User-Id 机器账号头(octopus AuthMiddleware 按 header 自动建账号)+ 可选 Bearer。
streamx
Package streamx 提供跨 SSE / WebSocket / Chunked Transfer 协议的 流式响应抽象(Event/Source/Sink/Hub),跟 ekit 已有 hertz/sse(Stream 单连接 SSE)+ network/wsutil(Broadcaster 房间广播) 协同工作,业务可一次写 Event,多协议扇出。
Package streamx 提供跨 SSE / WebSocket / Chunked Transfer 协议的 流式响应抽象(Event/Source/Sink/Hub),跟 ekit 已有 hertz/sse(Stream 单连接 SSE)+ network/wsutil(Broadcaster 房间广播) 协同工作,业务可一次写 Event,多协议扇出。
wsutil
Package wsutil 提供通用 WebSocket 基础设施。
Package wsutil 提供通用 WebSocket 基础设施。

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL