热门 Skills
中文
English 简体中文 français

搜索

PythonReactSEOPDF
GitHub Skill

binding-crate-architecture-patterns

Instructions for binding crate architecture patterns.

kreuzberg-dev☆ 560 仓库 Stars50 仓库 Forks
查看来源 ↗安装与使用

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

查看来源 ↗使用指南

技能说明

priority: high

Binding Crate Architecture Patterns

Principles

  1. Minimal wrapper: Bindings are glue only — call Rust core, convert types, convert errors
  2. Type translation: Clear Rust ↔ host language mapping
  3. Error conversion: Rust errors → native exceptions/error types
  4. Memory safety: Respect language-specific ownership models
  5. Testing: Language-native test suite, not just Rust tests

Crate Naming

{lib}-{language}: -py (PyO3), -node (NAPI-RS), -rb (Magnus), -php (ext-php-rs), -wasm (wasm-bindgen), -ffi (C FFI for Go/Java/C#)

Framework Patterns

Framework Macro Constructor Error Pattern
PyO3 #[pyclass] / #[pymethods] #[new] .map_err(|e| PyException::new_err(e.to_string()))
NAPI-RS #[napi] #[napi(constructor)] napi::Error::new(Status::GenericFailure, msg)
Magnus #[magnus::wrap] define_method("new", ...) Into<magnus::RError>
ext-php-rs #[php_class] / #[php_impl] pub fn new() Return error string
wasm-bindgen #[wasm_bindgen] #[wasm_bindgen(constructor)] JsValue::from_str(&e.to_string())
C FFI #[no_mangle] extern "C" _new() -> Handle Return null + error code

Type Mapping

Rust Python Node.js Ruby C/FFI
String/&str str string String char*/const char*
u64 int BigInt Integer uint64_t
Result<T> Exception Error thrown raises null/error code
Option<T> None/T null/T nil/T NULL/T

Distribution (packages/)

python/ (PyPI), typescript/ (npm), ruby/ (RubyGems), php/ (Composer), go/ (Go module), java/ (Maven), csharp/ (.NET NuGet)

Anti-Patterns

  • Exposing Rust internals to users
  • Blocking in async contexts (use spawn_blocking)
  • Dangling pointers in FFI returns
  • Panicking instead of returning errors (unwrap() in binding code)

使用示例

查看来源仓库中的使用示例与配置说明。

查看来源 ↗

来源历史

收录时间
2026-03-11
索引更新时间
2026-03-11
Branch
main

收录与同步日期属于本站记录。源码修改历史请查看来源仓库。

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!