Are these patterns applicable to any Rust project?

While the examples are based on the html-to-markdown library, the architectural principles and code structures are universally applicable to any Rust library being exposed to other languages.

Does this handle memory safety in FFI?

Yes, it includes specific guidelines on transferring ownership, managing pointers, and avoiding dangling references in C-style interfaces.

What languages are supported by these patterns?

The skill covers standardized patterns for Python (PyO3), Node.js (NAPI-RS), Ruby (Magnus), PHP (ext-php-rs), WebAssembly (wasm-bindgen), and C-compatible languages via FFI.

Can I use these patterns for asynchronous Rust functions?

The patterns include specific instructions on using blocking thread pools and async bridges to prevent blocking host runtimes like Node.js or Python.

How do I handle Rust errors in the host language?

It provides templates for mapping Rust's Result types and custom error enums to native exceptions or error types appropriate for each supported language.

Binding Crate Architecture Patterns

Name: Binding Crate Architecture Patterns
Author: kreuzberg-dev

bykreuzberg-dev

•

480

Developer Tools

Standardizes the creation of Rust binding crates across multiple languages including Python, Node.js, and WebAssembly.

About

This skill provides comprehensive architectural patterns and implementation guides for exposing Rust libraries to host languages through binding crates. It covers industry-standard frameworks like PyO3 for Python, NAPI-RS for Node.js, and Magnus for Ruby, ensuring consistent type translation, memory safety, and error handling across various ecosystems. By following these established patterns, developers can build high-performance, polyglot interfaces for their Rust projects while avoiding common anti-patterns like memory leaks, improper async handling, or leaking Rust internals to the host environment.

Key Features

Best practices for memory safety and asynchronous bridge management
FFI implementation guides for C-compatible languages like Go, Java, and C#
Multi-language binding templates for Python, Node.js, Ruby, PHP, and WebAssembly
Standardized type mapping conventions between Rust and host languages
Robust error conversion patterns from Rust results to native exceptions
480 GitHub stars

Use Cases

Implementing WebAssembly bindings to run Rust code directly in web browsers
Building stable C FFI interfaces for cross-language interoperability and legacy systems
Creating Python or Node.js wrappers for performance-critical Rust libraries

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kreuzberg-dev/html-to-markdown binding-crate-architecture-patterns

For use in Claude.ai and ChatGPT

Download Skill

GitHub