PR #12 follow-up: docs, CI, gitignore for Rust example

- .gitignore: scope target/ and Cargo.lock to examples/rust/
- book en/ja c-api.md: add Rust FFI quickstart section + example ref
- ci.yml: add Rust FFI example build+run step after Setup Rust

Author: chaploud

.github/workflows/ci.yml

@@ -66,6 +66,10 @@ jobs:
           rustup target add wasm32-wasip1
           rustc --version
 
+      - name: Run Rust FFI example
+        if: runner.os != 'Windows'
+        run: cd examples/rust && cargo run
+
       - name: Install wasm-tools
         run: |
           source .github/tool-versions

.gitignore

@@ -12,9 +12,9 @@ zig-cache/
 # Python
 __pycache__/
 
-# Rust
-target/
-Cargo.lock
+# Rust example build artifacts
+examples/rust/target/
+examples/rust/Cargo.lock
 
 # Editor
 *.swp

book/en/src/c-api.md

@@ -116,6 +116,32 @@ zig build lib
 python3 examples/python/basic.py
 ```
 
+## Quickstart: Rust (FFI)
+
+Rust can call the same C API via `extern "C"` bindings:
+
+```rust
+#[link(name = "zwasm")]
+unsafe extern "C" {
+    fn zwasm_module_new(wasm_ptr: *const u8, len: usize) -> *mut zwasm_module_t;
+    fn zwasm_module_invoke(
+        module: *mut zwasm_module_t, name: *const std::ffi::c_char,
+        args: *const u64, nargs: u32, results: *mut u64, nresults: u32,
+    ) -> bool;
+    fn zwasm_module_delete(module: *mut zwasm_module_t);
+}
+```
+
+Build and run (requires Rust 1.85+ for edition 2024):
+
+```bash
+zig build shared-lib
+cd examples/rust && cargo run
+# f() = 42
+```
+
+See `examples/rust/` for the full working example.
+
 ## API reference
 
 Functions are grouped by domain. All signatures live in `include/zwasm.h`.
@@ -285,5 +311,5 @@ zwasm_module_delete(mod);
 ## Next steps
 
 - [Build Configuration](./build-configuration.md) — customize which features are compiled in
-- `examples/c/` and `examples/python/` — working examples in the repository
+- `examples/c/`, `examples/python/`, and `examples/rust/` — working examples in the repository
 - `include/zwasm.h` — the complete C header with doc comments

book/ja/src/c-api.md

@@ -116,6 +116,32 @@ zig build lib
 python3 examples/python/basic.py
 ```
 
+## クイックスタート: Rust (FFI)
+
+Rust からも `extern "C"` バインディングで同じ C API を呼び出せます:
+
+```rust
+#[link(name = "zwasm")]
+unsafe extern "C" {
+    fn zwasm_module_new(wasm_ptr: *const u8, len: usize) -> *mut zwasm_module_t;
+    fn zwasm_module_invoke(
+        module: *mut zwasm_module_t, name: *const std::ffi::c_char,
+        args: *const u64, nargs: u32, results: *mut u64, nresults: u32,
+    ) -> bool;
+    fn zwasm_module_delete(module: *mut zwasm_module_t);
+}
+```
+
+ビルドと実行 (Rust 1.85+ が必要、edition 2024):
+
+```bash
+zig build shared-lib
+cd examples/rust && cargo run
+# f() = 42
+```
+
+完全な動作例は `examples/rust/` を参照してください。
+
 ## API リファレンス
 
 関数はドメインごとにグループ化されています。すべてのシグネチャは `include/zwasm.h` に定義されています。
@@ -285,5 +311,5 @@ zwasm_module_delete(mod);
 ## 次のステップ
 
 - [ビルド設定](./build-configuration.md) — コンパイルに含める機能のカスタマイズ
-- `examples/c/` と `examples/python/` — リポジトリ内の動作する例
+- `examples/c/`、`examples/python/`、`examples/rust/` — リポジトリ内の動作する例
 - `include/zwasm.h` — ドキュメントコメント付きの完全な C ヘッダ