Skip to content

v1.0.0

Choose a tag to compare

View all tags
@ymj4023 ymj4023 released this 01 Sep 13:07
· 10 commits to main since this release
v1.0.0
2abad05

bytebufferpool v1.0.0

The first stable release of github.com/ymj4023/bytebufferpool.

Highlights

  • Lease-first ownership with Pool provenance, Generation tracking, copy checks, duplicate-release detection, and stale-generation rejection.
  • Explicit Raw Slice API for callers that accept weaker lifecycle guarantees.
  • Fast and Bounded retention modes under one immutable Pool configuration.
  • Deterministic Capacity Classes, exact-capacity release routing, oversize rejection, and an exact Retained Capacity budget in Bounded mode.
  • Append-oriented Buffer with Go Writer/Reader contracts, failure-atomic growth, and safe self-alias handling during growth.
  • Optional full-capacity clearing, enhanced Raw Slice validation, and operational statistics.
  • Go 1.22 minimum version and no third-party runtime dependencies in the library module.

Performance evidence

The repository includes reproducible raw output and benchstat summaries for fixed, mixed, boundary, parallel, lifecycle, post-GC, and budget-exhaustion workloads. It also includes 33 isolated peak-memory runs, 66 summaries, and 33 heap profiles.

Results are workload-specific; this release does not claim universal superiority over other pools. See the Benchmark documentation and README.

Verification

  • Go 1.22 tests and vet
  • Stable Go tests, vet, and both fuzz targets
  • Root race detector
  • Benchmark adapter contracts and all-benchmark smoke
  • Parallel benchmark race detector
  • Isolated memory benchmark smoke
  • Independent Standards review: 0 hard violations
  • Independent Spec review: 0 findings

Install

go get github.com/ymj4023/bytebufferpool@v1.0.0

中文文档：README.ZH.md

Assets 2
Loading