zeropool 0.3.1

High-performance buffer pool with constant-time allocation, thread-safe operations, and 5x speedup over bytes crate
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [0.3.0] - 2025-11-23

### Changed
- **BREAKING**: `BufferPool::get()` now returns `PooledBuffer` instead of `Vec<u8>`
  - `PooledBuffer` implements `Deref<Target = Vec<u8>>` for transparent access
  - Buffers automatically return to pool when dropped (RAII pattern)
  - No more manual `pool.put()` calls needed
- **BREAKING**: `BufferPool::put()` is now internal-only (`pub(crate)`)
  - Users should rely on automatic return via `Drop`
  - For explicit early return, use `drop(buffer)`

### Added
- New `PooledBuffer` type providing automatic buffer return via Drop trait
- `PooledBuffer` implements:
  - `Deref<Target = Vec<u8>>` and `DerefMut` for transparent Vec API access
  - `AsRef<[u8]>` and `AsMut<[u8]>` for slice conversions
  - `Debug` with buffer length and capacity
  - `Send` and `Sync` for thread safety
- Configurable eviction policies (LIFO, ClockPro) for fine-tuned performance
- Profiling binaries for performance analysis:
  - `ml_checkpoint_loader`: ML model loading simulation
  - `network_server`: Multi-threaded network server simulation
  - `file_pipeline`: File processing pipeline simulation
  - `stress_test`: High-stress workload testing
- Modularized codebase with separate modules for buffer, config, pool, and utilities

### Fixed
- Removed all unsafe code blocks for improved safety
- Fixed all clippy warnings and formatting issues
- Improved code organization and documentation

### Migration Guide

#### Before (v0.2.x):
```rust
let buf = pool.get(1024);
// use buf
pool.put(buf); // Manual return
```

#### After (v0.3.0):
```rust
let buf = pool.get(1024);
// use buf
// Auto-returns on drop!

// For explicit early return:
drop(buf);
```

## [0.2.0] - Previous Release

See git history for earlier changes.