Skip to content

research build wiring

Caleb Buxton edited this page Jul 2, 2026 · 1 revision

Build Wiring Research

How to wire up the native extension so the gem compiles: cdylib crate layout, extconf.rb content, Rakefile changes, and CI configuration.

Documents

File Description
Extension Crate Layout The new ext/duckling/ Rust crate that must be created: cdylib type, Cargo.toml shape, build.rs question, and open dependency questions for duckling.
extconf.rb Pattern What ext/duckling/extconf.rb must contain, how create_rust_makefile works, and how it compares to the verified rust_blank example.
Rakefile Setup The Rake::ExtensionTask addition needed in the Rakefile and why lib_dir = "lib/duckling" is the right setting.
CI Configuration CI changes needed: Rust toolchain setup, compile step, Rust version pinning strategy, and the source-gem vs pre-compiled-binary tradeoff.

Clone this wiki locally