Registry / data / delta-kernel-rust-sharing-wrapper

delta-kernel-rust-sharing-wrapper

JSON →
library0.3.3pypypi✓ verified 23d ago

This package (PyPI: `delta-kernel-rust-sharing-wrapper`) provides Python bindings to the `delta-kernel-rs` (Rust) crate, enabling Python users to read Delta Lake tables. It exports its functionality via the `delta_kernel_python` module. It serves as a foundational, low-level component, often consumed by higher-level Delta Lake Python clients. Current version is 0.3.1; releases are typically coordinated with updates to the underlying Rust kernel.

pip install delta-kernel-rust-sharing-wrapper
INSTALL
IMPORT
SIG · DELTA-KERNEL-RUST-
D
delta-kernel-rust-sharing-wrapper
datapythonv0.3.3
Install
2.1s avg
Import
Disk
53MB
Pass rate
4/ 10
Env Coverage4 / 10
glibc
3.93.13
musl
3.93.13
Install & Compatibility
Where this runs
tested against v0.3.3 · pip install
no network on importno background threads
Install × environment matrix
Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux
musl
glibc
py 3.10
✕ build_error
✓ 1.9s
py 3.11
✕ build_error
✓ 2s
py 3.12
✕ build_error
✓ 2.6s
py 3.13
✕ build_error
✓ 2.1s
py 3.9
✕ build_error
✕ build_error
53MB installed
● package 53MB
Code
Verified usage

Verified import paths — ran on the pinned version, not inferred.

PythonInterface
from delta_kernel_rust_sharing_wrapper import PythonInterface
from delta_kernel_python import scan_table
Table
from delta_kernel_rust_sharing_wrapper import Table
Scan
from delta_kernel_rust_sharing_wrapper import Scan

This quickstart demonstrates how to use `delta_kernel_python.scan_table` to read a Delta Lake table and process its data using PyArrow's Dataset API. It assumes a Delta table exists at `DELTA_TABLE_PATH` (or `./my_local_delta_table` by default). Cloud storage paths require correctly configured environment variables for credentials.

import delta_kernel_python import pyarrow.dataset as ds import os # Path to a Delta Lake table. # For a runnable example, ensure this path points to a valid Delta table. # For cloud paths (s3://, abfss://, etc.), ensure appropriate AWS/Azure credentials # are configured (e.g., via environment variables or default credential providers). # Example: Create a test table first using `delta-rs` or `pyspark`. table_path = os.environ.get("DELTA_TABLE_PATH", "./my_local_delta_table") print(f"Attempting to read Delta table at: {table_path}") try: # Scan the Delta table to get an Arrow Dataset object. # This object can then be used for querying and reading data. dataset: ds.Dataset = delta_kernel_python.scan_table(table_path) print(f"\nSchema of the Delta table:\n{dataset.schema}") print("\nFirst 5 records from the table:") # Read data in batches (e.g., as PyArrow RecordBatches). count = 0 for batch in dataset.to_batches(): print(batch.to_pylist()) count += len(batch) if count >= 5: break if count == 0: print("No records found or processed.") except Exception as e: print(f"\nERROR: Could not read Delta table at '{table_path}'.") print("Please ensure the path is correct and points to an existing Delta table.") print(f"Original error: {e}") print("Tip: You can create a simple Delta table for testing, e.g., with `delta-rs`:") print(" import pandas as pd\n from deltalake import write_deltalake\n df = pd.DataFrame({\"id\": [1, 2], \"value\": [\"A\", \"B\"]})\n write_deltalake(\"./my_local_delta_table\", df, mode=\"overwrite\")")
Debug
Known issues
gotchaThe PyPI package name (`delta-kernel-rust-sharing-wrapper`) differs from the Python module name (`delta_kernel_python`). Always import using `import delta_kernel_python`.
fix
Use `import delta_kernel_python` in your Python code.
affects: All versions
gotchaThis library has specific `pyarrow` version dependencies (e.g., `pyarrow >=10.0.1,<16` for version 0.3.1). Installing an incompatible `pyarrow` version can lead to runtime errors or crashes due to C/Rust FFI mismatches.
fix
Ensure your `pyarrow` version falls within the range specified by `pip install delta-kernel-rust-sharing-wrapper` or check the `pyproject.toml` of the specific library version.
affects: All versions
breakingAs this library is pre-1.0.0, its API (`delta_kernel_python` module) is subject to change without strict backward compatibility guarantees. Expect potential breaking changes in minor version updates.
fix
Pin your dependency to a specific minor version (e.g., `delta-kernel-rust-sharing-wrapper~=0.3.0`) and review release notes carefully when upgrading.
affects: <1.0.0
gotchaWhen reading tables from cloud storage (e.g., S3, ADLS Gen2), this library relies on the underlying storage client (e.g., `object_store` Rust crate) to pick up credentials. Ensure your environment variables (e.g., `AWS_ACCESS_KEY_ID`, `AWS_SECRET_ACCESS_KEY` for S3) or cloud-provider specific configurations are correctly set.
fix
Configure cloud storage credentials in your environment or via standard cloud provider SDK configuration methods before running applications that read from cloud-based Delta tables.
affects: All versions
Upgrade
Version history
0.3.3latest on PyPI · released Aug 12, 2026
Audit
Dependencies
pyarrowrequiredRequired for data interchange with Arrow Dataset API and columnar data processing.
Agent activity
17 hits · last 30 days
node
15
OpenAI (training)
1
Resources
delta-kernel-rust-sharing-wrapper — pip install delta-kernel-rust-sharing-wrapper · libregistry