philiprehberger-batch-iter 0.1.0

Batch processing with progress tracking and error handling.

philiprehberger-batch-iter

Batch processing with progress tracking and error handling.

Installation

pip install philiprehberger-batch-iter

Usage

from philiprehberger_batch_iter import batch, collect_errors

# Split any iterable into fixed-size batches
for chunk in batch(range(10), size=3):
    print(chunk)
# [0, 1, 2]
# [3, 4, 5]
# [6, 7, 8]
# [9]

# Enable progress output to stderr
for chunk in batch(range(100), size=25, progress=True):
    process(chunk)
# batch 1: 25 items
# batch 2: 25 items
# ...

Error collection

from philiprehberger_batch_iter import collect_errors

def process_batch(items):
    for item in items:
        if item < 0:
            raise ValueError(f"negative value: {item}")

result = collect_errors([1, 2, -3, 4, 5, -6], size=2, fn=process_batch)
print(result.processed)     # 6
print(len(result.errors))   # 2
print(result.duration_ms)   # 0.12

Async batching

from philiprehberger_batch_iter import batch_async

async def process():
    async for chunk in batch_async(async_data_source(), size=50):
        await handle(chunk)

API

Function / Class	Description
batch(iterable, size, progress=False)	Yield fixed-size batches from an iterable
batch_async(async_iterable, size)	Async generator yielding fixed-size batches
collect_errors(iterable, size, fn)	Process batches and collect errors into a result
BatchResult	Dataclass with processed, errors, duration_ms

Development

pip install -e .
python -m pytest tests/ -v

License

MIT