Skip to content

Releases: rushairer/batchflow

BatchFlow v1.1.1

09 Apr 05:41

Choose a tag to compare

BatchFlow v1.1.1 Release Notes

发布日期:2026-04-09

亮点

  • 补齐 Close() / Wait() / Done() 的可编译示例与行为测试
  • NewRequest 新增更多基础整数 typed setter,减少调用侧手动类型转换
  • README、API 参考、示例指南与 docs-check 同步到最新公开 API

新增

生命周期示例

  • ExampleBatchFlow_Close
  • ExampleBatchFlow_Done

Request typed setter

  • SetInt
  • SetInt8
  • SetInt16
  • SetUint
  • SetUint8
  • SetUint16
  • SetUint32
  • SetUint64

变更

测试

  • 新增 Wait() / Done() 契约测试,覆盖:
    • Close() 后退出信号关闭
    • 重复 Close() 幂等
    • 父上下文取消时 Wait() 返回值
  • 新增 typed setter 列值保真测试,确认基础整数类型不会被隐式改写

文档

  • README 增加生命周期常见用法与 request setter 说明
  • docs/api/reference.md 同步公开 setter 列表与 Wait() / Done() 模式
  • docs/guides/examples.md 增加 Wait / Done 与 typed setter 示例
  • scripts/check-doc-consistency.sh 新增 Done()SetIntSetUint64 契约检查

兼容性

这是一个向后兼容的 patch 版本更新。

  • 现有构造函数保持不变
  • 现有执行器与 metrics 接口保持不变
  • 现有调用方式继续可用;只是补充更多 setter 与示例

验证

  • go test ./... 通过
  • go test -run '^$' ./... 通过
  • make docs-check 通过
  • make release-check 通过

BatchFlow v1.1.0

09 Apr 03:53

Choose a tag to compare

BatchFlow v1.1.0 Release Notes

发布日期:2026-04-09

亮点

  • 补齐 BatchFlow 生命周期接口:Close()Wait()Done()
  • 收敛 metrics 契约,新增真实的队列等待采样与 BatchFlow 自身流程指标
  • 重写 README、API、监控与示例文档,统一到当前实现口径
  • 增加 docs-check,避免文档再次漂移到过期 API/指标名

新增

生命周期

  • BatchFlow.Close()
  • BatchFlow.Wait()
  • BatchFlow.Done()

Metrics

  • BatchFlowMetricsReporter
  • submit_rejected_total
  • pipeline_flush_size
  • schema_groups_per_flush

变更

Metrics 语义

  • ObserveDequeueLatency 现在由 BatchFlow 真实采样,不再只是文档预留接口。
  • batch_size 的语义固定为“单个 schema 执行批大小”。
  • ObserveExecuteDuration 不再重复顺手记录 batch_size,避免双计数。

文档

  • README 改成当前推荐用法:NewXxxBatchFlow + PipelineConfig + Submit + Close
  • examples/metrics/prometheus 现在是官方推荐的监控接入方式
  • 新增 docs/guides/metrics-spec.md 作为指标语义 source of truth

兼容性

这是一个向后兼容的 minor 版本更新。

  • 现有核心构造函数仍然保留
  • 现有执行器接口仍然保留
  • 模块路径没有变化

验证

  • go test ./... 通过
  • go test -run '^$' ./... 通过
  • make docs-check 通过

发布备注

本次版本已完成 make release-check,包含文档一致性检查、lint 与测试,满足打 tag 发布条件。

BatchFlow v1.0.3

02 Dec 01:56

Choose a tag to compare

Release Notes for v1.0.3

Release Date: 2025-12-02 01:53:03 UTC

Changes since v1.0.2

  • fix: format (dd9441f)
  • docs: 更新性能指标文档,统一标签体系为 instance_id (61a8e32)

Test Results

  • ✅ All unit tests passed
  • ✅ MySQL integration tests passed
  • ✅ PostgreSQL integration tests passed
  • ✅ Redis integration tests passed
  • ✅ Monitoring system tests passed
  • ⚠️ SQLite tests show expected architectural limitations

Features

  • 🚀 Multi-database support: MySQL, PostgreSQL, SQLite, Redis
  • 📊 Prometheus + Grafana monitoring integration
  • 📚 Complete documentation system in docs/ directory
  • 🧪 Comprehensive test suite with 95%+ pass rate

Installation

go get github.com/rushairer/batchflow@v1.0.3

BatchFlow v1.0.2

02 Nov 15:13

Choose a tag to compare

Release Notes for v1.0.2

Release Date: 2025-11-02 15:04:54 UTC

Changes since v1.0.1

  • feat: release 1.0.2 (0e47d35)
  • feat: 更新go-pipeline v2.2.2 (97401fa)
  • chore: fix lint issues (6e92632)
  • feat: 漏掉提交的文件 (1a77c0b)
  • docs: add go-pipeline v2.2.0 metrics integration guide and changelog; grafana dashboard refined (p50/p95/p99, units, alignment); integration Prometheus reporter exports new pipeline metrics; adapter hooks wired (1700905)

Test Results

  • ✅ All unit tests passed
  • ✅ MySQL integration tests passed
  • ✅ PostgreSQL integration tests passed
  • ✅ Redis integration tests passed
  • ✅ Monitoring system tests passed
  • ⚠️ SQLite tests show expected architectural limitations

Features

  • 🚀 Multi-database support: MySQL, PostgreSQL, SQLite, Redis
  • 📊 Prometheus + Grafana monitoring integration
  • 📚 Complete documentation system in docs/ directory
  • 🧪 Comprehensive test suite with 95%+ pass rate

Installation

go get github.com/rushairer/batchflow@v1.0.2

BatchFlow v1.0.1

09 Oct 05:09

Choose a tag to compare

Release Notes for v1.0.1

Release Date: 2025-10-09 05:00:16 UTC

Changes since v1.0.1-beta

  • feat: 增加收尾策略 (29053e8)

Test Results

  • ✅ All unit tests passed
  • ✅ MySQL integration tests passed
  • ✅ PostgreSQL integration tests passed
  • ✅ Redis integration tests passed
  • ✅ Monitoring system tests passed
  • ⚠️ SQLite tests show expected architectural limitations

Features

  • 🚀 Multi-database support: MySQL, PostgreSQL, SQLite, Redis
  • 📊 Prometheus + Grafana monitoring integration
  • 📚 Complete documentation system in docs/ directory
  • 🧪 Comprehensive test suite with 95%+ pass rate

Installation

go get github.com/rushairer/batchflow@v1.0.1

BatchFlow v1.0.1-beta

06 Oct 06:19

Choose a tag to compare

BatchFlow v1.0.1-beta Pre-release
Pre-release

Release Notes for v1.0.1-beta

Release Date: 2025-10-06 06:10:46 UTC

Changes since v1.0.0-beta.1

  • feat: 并发限制API (f549e55)
  • docs: 同步超时/重试策略与处理器说明;更新监控/调优文档与 PromQL;README 章节顺序调整(摘要保留);新增 Grafana 仪表盘;补充代码注释(WithTimeoutCause/重试分类器/Redis 快速退出/SQL 空操作校验) (2a26479)

Test Results

  • ✅ All unit tests passed
  • ✅ MySQL integration tests passed
  • ✅ PostgreSQL integration tests passed
  • ✅ Redis integration tests passed
  • ✅ Monitoring system tests passed
  • ⚠️ SQLite tests show expected architectural limitations

Features

  • 🚀 Multi-database support: MySQL, PostgreSQL, SQLite, Redis
  • 📊 Prometheus + Grafana monitoring integration
  • 📚 Complete documentation system in docs/ directory
  • 🧪 Comprehensive test suite with 95%+ pass rate

Installation

go get github.com/rushairer/batchflow@v1.0.1-beta

BatchFlow v1.0.0-beta.1

04 Oct 09:32

Choose a tag to compare

Pre-release

Release Notes for v1.0.0-beta.1

Release Date: 2025-10-04 09:23:40 UTC

Changes since v1.0.0-beta

  • feat: 使 release 版本符合语义化版本规范(SemVer) (4720d00)
  • feat: 更新文档中过时的API (0f15146)

Test Results

  • ✅ All unit tests passed
  • ✅ MySQL integration tests passed
  • ✅ PostgreSQL integration tests passed
  • ✅ Redis integration tests passed
  • ✅ Monitoring system tests passed
  • ⚠️ SQLite tests show expected architectural limitations

Features

  • 🚀 Multi-database support: MySQL, PostgreSQL, SQLite, Redis
  • 📊 Prometheus + Grafana monitoring integration
  • 📚 Complete documentation system in docs/ directory
  • 🧪 Comprehensive test suite with 95%+ pass rate

Installation

go get github.com/rushairer/batchflow@v1.0.0-beta.1

BatchFlow v1.0.0-beta

04 Oct 01:30

Choose a tag to compare

BatchFlow v1.0.0-beta Pre-release
Pre-release

Release Notes for v1.0.0-beta

Release Date: 2025-10-04 01:11:35 UTC

Changes since v1.0.0-beta.0

  • feat: 为了提高github action release测试通过率,降低redis测试内存压力 (4463500)

Test Results

  • ✅ All unit tests passed
  • ✅ MySQL integration tests passed
  • ✅ PostgreSQL integration tests passed
  • ✅ Redis integration tests passed
  • ✅ Monitoring system tests passed
  • ⚠️ SQLite tests show expected architectural limitations

Features

  • 🚀 Multi-database support: MySQL, PostgreSQL, SQLite, Redis
  • 📊 Prometheus + Grafana monitoring integration
  • 📚 Complete documentation system in docs/ directory
  • 🧪 Comprehensive test suite with 95%+ pass rate

Installation

go get github.com/rushairer/batchflow@v1.0.0-beta