Interop with Python/pandas

Q: How do I ship Rust extensions?

Use maturin develop locally and maturin build for wheels in CI - pair with a pyproject.toml pointing at your crate.

Q: Does this work in notebooks?

Yes - write IPC to /tmp, read in the next cell. For large data, mmap keeps RAM stable.

Q: How do I debug schema mismatches?

Print table.schema on both sides before transforms. Fail fast in Rust with explicit Schema on write.

Move tables between Rust and Python with Apache Arrow - avoid slow JSON serialization and preserve dtypes.

Recipe

Quick-reference recipe card - copy-paste ready.

use polars::prelude::*;
use std::fs::File;
 
fn export_arrow_ipc(df: &mut DataFrame, path: &str) -> PolarsResult<()> {
    let mut file = File::create(path)?;
    IpcWriter::new(&mut file).finish(df)?;
    Ok(())
}

import pyarrow as pa
import pyarrow.ipc as ipc
 
with pa.memory_map("/tmp/frame.arrow", "r") as source:
    table = ipc.open_file(source).read_all()
df = table.to_pandas()

When to reach for this:

Rust ETL core with Python notebooks for exploration
Serving features built in Rust to pandas/sklearn downstream
Validating Polars output in Jupyter without CSV round-trip
Gradual migration off pandas hotspots

Working Example

Rust side writes IPC; Python reads into pandas without parsing CSV.

use polars::prelude::*;
 
fn main() -> PolarsResult<()> {
    let mut df = df! {
        "user_id" => [1i64, 2, 3],
        "score" => [0.9, 0.4, 0.7],
    }?;
    let mut f = std::fs::File::create("/tmp/users.arrow")?;
    IpcWriter::new(&mut f).finish(&mut df)?;
    Ok(())
}

import pandas as pd
import pyarrow.ipc as ipc
 
with open("/tmp/users.arrow", "rb") as f:
    reader = ipc.open_file(f)
    table = reader.read_all()
pdf = table.to_pandas(types_mapper=pd.ArrowDtype)
assert pdf["user_id"].dtype.name.startswith("int")

What this demonstrates:

Polars IpcWriter producing a file Python understands
pandas reading Arrow-backed dtypes without string inference
Round-trip fidelity on numeric columns

Deep Dive

How It Works

Arrow defines canonical memory layout both ecosystems decode.
IPC file format embeds schema + column buffers for mmap-friendly reads.
PyO3 lets Rust functions accept/return PyArrow objects in-process (zero IPC file).
pandas 2.x prefers Arrow-backed dtypes via pd.ArrowDtype for nullable integers.

Interop Paths

Path	Copies	Best for
Arrow IPC file	Minimal with mmap	Batch handoff between jobs
PyO3 + pyarrow	In-process	Hot loops in Python calling Rust
Parquet on disk	Decode cost	Durable shared lake between teams
CSV	Full parse	Debugging only

Rust Notes

// When exposing PyO3, use maturin to build wheels:
// #[pyfunction] fn transform(py: Python, table: Bound<PyAny>) -> PyResult<PyObject> { ... }

Gotchas

JSON intermediate - 10x slower and loses nullable int semantics. Fix: standardize on Arrow IPC or Parquet.
Timezone-naive datetime mismatch - pandas vs Polars interpret offsets differently. Fix: store UTC nanoseconds in schema metadata.
Categorical/string dictionary drift - joins fail across languages. Fix: agree on Utf8 vs categorical in schema registry.
GIL-bound PyO3 for long CPU work - blocks other Python threads. Fix: release GIL with py.allow_threads around Rust compute.
Different Polars/pyarrow versions - decode errors on new extension types. Fix: pin versions in both Cargo.lock and requirements.txt.

Alternatives

Alternative	Use When	Don't Use When
Parquet lake only	Async batch between teams	Interactive sub-second notebook loops
gRPC + Arrow Flight	Service-to-service streaming	Simple local CLI handoff
DuckDB in both	SQL contract over files	Heavy custom Rust kernels
Pure Python Polars	Team stays in Python API	Rust ownership of performance-critical path

FAQs

Is zero-copy guaranteed from Rust to Python?

With IPC mmap and compatible buffers, often yes. In-process PyO3 may still copy depending on array ownership - benchmark your path.

Can pandas write back to Rust?

Yes - write Arrow IPC or Parquet from pandas via PyArrow, read with Polars scan_ipc / read_parquet.

Do I need PyO3 for interop?

No for file/batch pipelines. PyO3 helps when Python orchestrates and Rust accelerates tight loops in one process.

What about NumPy arrays?

Arrow bridges to NumPy for numeric columns without object dtype boxes - prefer Arrow table as the contract.

How do I ship Rust extensions?

Use maturin develop locally and maturin build for wheels in CI - pair with a pyproject.toml pointing at your crate.

Does this work in notebooks?

Yes - write IPC to /tmp, read in the next cell. For large data, mmap keeps RAM stable.

How do I debug schema mismatches?

Print table.schema on both sides before transforms. Fail fast in Rust with explicit Schema on write.

Can I use polars Python instead of pandas?

Polars Python shares the same Rust core - IPC between Rust Polars and Python Polars is especially smooth.

What about nullable integers?

Use Arrow int64 with null bitmap; avoid pandas float NaN sentinel for IDs.

Where does Apache Arrow fit?

See Apache Arrow for RecordBatch fundamentals underlying this handoff.

Apache Arrow - columnar contract
Polars - Rust DataFrame export
CSV/Parquet I/O - Parquet as alternative handoff
Building Data CLIs & Services - Rust producer binaries

Stack versions: This page was written for Rust 1.97.0 (edition 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, and Polars 0.46+.

Recipe

Quick-reference recipe card - copy-paste ready.

use polars::prelude::*;
use std::fs::File;
 
fn export_arrow_ipc(df: &mut DataFrame, path: &str) -> PolarsResult<()> {
    let mut file = File::create(path)?;
    IpcWriter::new(&mut file).finish(df)?;
    Ok(())
}

import pyarrow as pa
import pyarrow.ipc as ipc
 
with pa.memory_map("/tmp/frame.arrow", "r") as source:
    table = ipc.open_file(source).read_all()
df = table.to_pandas()

When to reach for this:

Rust ETL core with Python notebooks for exploration
Serving features built in Rust to pandas/sklearn downstream
Validating Polars output in Jupyter without CSV round-trip
Gradual migration off pandas hotspots

Working Example

Rust side writes IPC; Python reads into pandas without parsing CSV.

use polars::prelude::*;
 
fn main() -> PolarsResult<()> {
    let mut df = df! {
        "user_id" => [1i64, 2, 3],
        "score" => [0.9, 0.4, 0.7],
    }?;
    let mut f = std::fs::File::create("/tmp/users.arrow")?;
    IpcWriter::new(&mut f).finish(&mut df)?;
    Ok(())
}

import pandas as pd
import pyarrow.ipc as ipc
 
with open("/tmp/users.arrow", "rb") as f:
    reader = ipc.open_file(f)
    table = reader.read_all()
pdf = table.to_pandas(types_mapper=pd.ArrowDtype)
assert pdf["user_id"].dtype.name.startswith("int")

What this demonstrates:

Polars IpcWriter producing a file Python understands
pandas reading Arrow-backed dtypes without string inference
Round-trip fidelity on numeric columns

Deep Dive

How It Works

Arrow defines canonical memory layout both ecosystems decode.
IPC file format embeds schema + column buffers for mmap-friendly reads.
PyO3 lets Rust functions accept/return PyArrow objects in-process (zero IPC file).
pandas 2.x prefers Arrow-backed dtypes via pd.ArrowDtype for nullable integers.

Interop Paths

Path	Copies	Best for
Arrow IPC file	Minimal with mmap	Batch handoff between jobs
PyO3 + pyarrow	In-process	Hot loops in Python calling Rust
Parquet on disk	Decode cost	Durable shared lake between teams
CSV	Full parse	Debugging only

Rust Notes

// When exposing PyO3, use maturin to build wheels:
// #[pyfunction] fn transform(py: Python, table: Bound<PyAny>) -> PyResult<PyObject> { ... }

Gotchas

JSON intermediate - 10x slower and loses nullable int semantics. Fix: standardize on Arrow IPC or Parquet.
Timezone-naive datetime mismatch - pandas vs Polars interpret offsets differently. Fix: store UTC nanoseconds in schema metadata.
Categorical/string dictionary drift - joins fail across languages. Fix: agree on Utf8 vs categorical in schema registry.
GIL-bound PyO3 for long CPU work - blocks other Python threads. Fix: release GIL with py.allow_threads around Rust compute.
Different Polars/pyarrow versions - decode errors on new extension types. Fix: pin versions in both Cargo.lock and requirements.txt.

Alternatives

Alternative	Use When	Don't Use When
Parquet lake only	Async batch between teams	Interactive sub-second notebook loops
gRPC + Arrow Flight	Service-to-service streaming	Simple local CLI handoff
DuckDB in both	SQL contract over files	Heavy custom Rust kernels
Pure Python Polars	Team stays in Python API	Rust ownership of performance-critical path

FAQs

Is zero-copy guaranteed from Rust to Python?

With IPC mmap and compatible buffers, often yes. In-process PyO3 may still copy depending on array ownership - benchmark your path.

Can pandas write back to Rust?

Yes - write Arrow IPC or Parquet from pandas via PyArrow, read with Polars scan_ipc / read_parquet.

Do I need PyO3 for interop?

No for file/batch pipelines. PyO3 helps when Python orchestrates and Rust accelerates tight loops in one process.

What about NumPy arrays?

Arrow bridges to NumPy for numeric columns without object dtype boxes - prefer Arrow table as the contract.

How do I ship Rust extensions?

Use maturin develop locally and maturin build for wheels in CI - pair with a pyproject.toml pointing at your crate.

Does this work in notebooks?

Yes - write IPC to /tmp, read in the next cell. For large data, mmap keeps RAM stable.

How do I debug schema mismatches?

Print table.schema on both sides before transforms. Fail fast in Rust with explicit Schema on write.

Can I use polars Python instead of pandas?

Polars Python shares the same Rust core - IPC between Rust Polars and Python Polars is especially smooth.

What about nullable integers?

Use Arrow int64 with null bitmap; avoid pandas float NaN sentinel for IDs.

Where does Apache Arrow fit?

See Apache Arrow for RecordBatch fundamentals underlying this handoff.

Apache Arrow - columnar contract
Polars - Rust DataFrame export
CSV/Parquet I/O - Parquet as alternative handoff
Building Data CLIs & Services - Rust producer binaries

Stack versions: This page was written for Rust 1.97.0 (edition 2024), Tokio 1.x, Axum 0.8, serde 1.0, sqlx 0.8, clap 4, and Polars 0.46+.

Interop with Python/pandas

Search Documentation

Interop with Python/pandas