39 lines
1.5 KiB
Markdown
39 lines
1.5 KiB
Markdown
|
# Nyash Fixture Plugin
|
||
|
|
|
||
|
|
Minimal, deterministic plugin for smoke tests. Provides `FixtureBox` with:
|
||
|
|
|
||
|
|
- Methods
|
||
|
|
- `birth` (id=0): creates an instance; returns instance id as raw u32 (4 bytes)
|
||
|
|
- `echo` (id=1): returns the input string (TLV tag=6)
|
||
|
|
- `get` (id=2): returns constant string "ok"
|
||
|
|
- `fini` (id=0xFFFF_FFFF): destroys the instance
|
||
|
|
|
||
|
|
- TypeBox FFI symbol: `nyash_typebox_FixtureBox`
|
||
|
|
- Legacy entry (compat): `nyash_plugin_invoke`
|
||
|
|
- Spec file: `nyash_box.toml` (type_id=101, method ids)
|
||
|
|
|
||
|
|
Build
|
||
|
|
|
||
|
|
```
|
||
|
|
cargo build --release -p nyash-fixture-plugin
|
||
|
|
```
|
||
|
|
|
||
|
|
Resulting artifacts (by platform):
|
||
|
|
- Linux: `target/release/libnyash_fixture_plugin.so`
|
||
|
|
- macOS: `target/release/libnyash_fixture_plugin.dylib`
|
||
|
|
- Windows: `target/release/nyash_fixture_plugin.dll`
|
||
|
|
|
||
|
|
Copy the built file to the project plugin folder (platform name preserved):
|
||
|
|
- Linux: `plugins/nyash-fixture-plugin/libnyash_fixture_plugin.so`
|
||
|
|
- macOS: `plugins/nyash-fixture-plugin/libnyash_fixture_plugin.dylib`
|
||
|
|
- Windows: `plugins/nyash-fixture-plugin/nyash_fixture_plugin.dll`
|
||
|
|
|
||
|
|
Use in smokes
|
||
|
|
- Profile: `tools/smokes/v2/run.sh --profile plugins`
|
||
|
|
- Test: Fixture autoload is auto-detected and run when the platform file is present
|
||
|
|
- The smoke script auto-detects extension: `.so` (Linux), `.dylib` (macOS), `.dll` (Windows)
|
||
|
|
|
||
|
|
Notes
|
||
|
|
- On Windows, plugin filenames do not start with `lib`.
|
||
|
|
- The plugins smoke uses `using kind="dylib"` autoload; it is safe by default and only enabled when `NYASH_USING_DYLIB_AUTOLOAD=1` is set (the runner handles this).
|