rust-python-sdk

Design Rust and Python SDK integration with PyO3 bindings and Maturin packaging.

Updated May 25, 2026
One-click install
npx skills add https://github.com/Yairama/mine-rs --skill rust-python-sdk
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: rust-python-sdk
Source: https://github.com/Yairama/mine-rs/tree/main/.github/skills/rust-python-sdk
Command: npx skills add https://github.com/Yairama/mine-rs --skill rust-python-sdk

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps engineers design and implement a consistent Rust and Python SDK architecture for mine-rs, reducing duplication and avoiding unstable interfaces between core mining logic and user-facing workflows.

Core Features & Use Cases

  • Rust-Python Integration: Guides Rust core development, PyO3 bindings, Maturin packaging, and Python SDK exposure patterns.
  • Data Interoperability: Supports pandas, numpy, Arrow, and Parquet workflows with explicit type handling, metadata preservation, and conversion decisions.
  • SDK Quality Practices: Defines error handling, testing, API stability, and notebook-first ergonomics for mining software development.

Quick Start

Use the rust-python-sdk skill to design a new Python binding for a Rust mining data structure while following the mine-rs SDK architecture.

Frequently Asked Questions about rust-python-sdk

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I build Python bindings for a Rust library using PyO3?

To build Python bindings for a Rust library using PyO3, you define stable Rust facades and expose them as Python APIs. This Skill guides creating explicit type mappings, handling errors domain-specifically, and packaging with Maturin.

How do I package a Rust project into a Python SDK with Maturin?

Packaging a Rust project into a Python SDK with Maturin involves configuring Maturin to compile Rust code into a Python-compatible wheel. This ensures stable integration between core mining logic and Python ergonomics.

How do I handle Arrow and Parquet data interoperability between Rust and Python?

Handling Arrow and Parquet data interoperability between Rust and Python requires explicit type handling and metadata preservation. This Skill guides conversion decisions to ensure seamless data workflows across pandas and numpy.

Can I use pandas and numpy with a Rust core mining logic?

Yes, you can use pandas and numpy with a Rust core by applying explicit type mappings. This architecture separates deterministic mining logic from notebook-first Python ergonomics, ensuring reliable data exchange.

What is the best way to test Rust and Python SDK integrations?

The best way to test Rust and Python SDK integrations is by writing deterministic tests that validate both the Rust core and Python API layers. This ensures API stability and reliable notebook-driven developer experiences.

Why should I separate core mining logic from Python API ergonomics?

Separating core mining logic from Python API ergonomics avoids unstable interfaces and reduces code duplication. This architectural decision ensures stable Rust facades while providing user-friendly Python workflows.