ferray-numpy-interop 0.2.3

Python/NumPy interop via PyO3 and Arrow/Polars for ferray
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

# ferray-numpy-interop

Zero-copy conversions between ferray arrays and Python/Arrow/Polars for the [ferray](https://crates.io/crates/ferray) scientific computing library.

## What's in this crate

- **NumPy** (feature `python`): `AsFerray` and `IntoNumPy` traits via PyO3
- **Apache Arrow** (feature `arrow`): `FromArrow`, `ToArrow` conversion traits
- **Polars** (feature `polars`): `FromPolars`, `ToPolars` conversion traits
- Zero-copy when arrays are C-contiguous, safe copy otherwise
- Dtype validation on all conversions

All backends are feature-gated and disabled by default.

## Usage

```toml
[dependencies.ferray-numpy-interop]
version = "0.1"
features = ["python"]  # or "arrow", "polars"
```

```rust
use ferray_numpy_interop::{AsFerray, IntoNumPy};
use pyo3::prelude::*;
use numpy::PyReadonlyArray1;

fn process(py: Python<'_>, arr: PyReadonlyArray1<'_, f64>) -> PyResult<()> {
    let ferray_arr = arr.as_ferray()?;
    // ... process ...
    Ok(())
}
```

This crate is re-exported through the main [`ferray`](https://crates.io/crates/ferray) crate with the `numpy` feature.

## License

MIT OR Apache-2.0