Metadata-Version: 2.4
Name: minimindslab-list-chunk
Version: 0.1.0
Summary: Deterministically split Python sequences or plain iterables into fixed-size chunks, with optional strict validation for positive chunk sizes.
Author: MiniMindsLab
License: MIT
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# MiniMindsLab List Chunk

Deterministically split Python sequences or plain iterables into fixed-size chunks, with strict validation for positive chunk sizes.

## Install

```bash
pip install minimindslab-list-chunk
```

## Usage

```python
from minimindslab_list_chunk import chunk

result = chunk([1, 2, 3, 4, 5], 2)
# [[1, 2], [3, 4], [5]]
```

Works with any iterable, including generators:

```python
from minimindslab_list_chunk import chunk

def numbers():
    for i in range(5):
        yield i

result = chunk(numbers(), 2)
# [[0, 1], [2, 3], [4]]
```

## API

### `chunk(iterable, size)`

- `iterable`: Any Python iterable.
- `size`: Positive integer chunk size.

Returns a list of lists containing chunked values in original order.

Raises:
- `ValueError` if `size <= 0`
