# Development Guide for neotoma-py

## Prerequisites

- Rust (latest stable)
- Python 3.8+
- maturin (`pip install maturin`)

## Building

To build the Python bindings in development mode:

```bash
maturin build
```

Or manually:

```bash
maturin develop
```

## Testing

## Building Wheels

To build distributable wheels:

```bash
maturin build --release
```

## Architecture

The Python bindings expose the core neotoma grammar functionality:

- `Grammar`: Python wrapper around the Rust `Grammar` type
- `parse_with_grammar()`: One-shot parsing function

## Error Handling

The bindings convert Rust errors to appropriate Python exceptions:
- Parse errors become `ValueError`
- IO errors become `IOError`

## Performance

The bindings use PyO3's efficient data exchange between Python and
Rust. Large parsing operations should have minimal overhead compared
to pure Rust usage.