extern/nushell
1
0
Fork 1
mirror of https://github.com/nushell/nushell.git synced 2024-11-22 16:33:37 +01:00
Code Issues Packages Projects Releases Wiki Activity
690ec9abfa
nushell/crates/nu-plugin
History
Jakub Žádník 047081fa72
Add a README about changing capnp schema (#4998) 
* Add a README about changing schema

* Add example PRs
2022-03-27 19:02:19 -05:00
..
src Add search terms to Command and Signature (#4980) 2022-03-27 22:25:30 +03:00
Cargo.toml Bump nushell to 0.60.1 (#4987) 2022-03-27 16:18:47 +13:00
README.md Add a README about changing capnp schema (#4998) 2022-03-27 19:02:19 -05:00

README.md

nu-plugin

Updating Cap'n Proto schema

When modifying a protocol's struct that is used in plugins (such as Signature), you need to update the capnproto schema file and recompile it into the Rust source code. The steps are as follows:

  1. Change src/serializers/capnp/schema/plugin.capnp as necessary
  2. Install capnp tool (it's a C++ binary, commonly available in package managers)
  3. Install Rust support for capnp called capnpc-rust:
    1. git clone https://github.com/capnproto/capnproto-rust somewhere
    2. cd capnproto-rust/capnpc
    3. cargo install --path=.
  4. Then, call capnp compile -orust plugin.capnp (change path as necessary)
  5. The result should be plugin_capnp.rs file: Use it to replace the old src/plugin_capnp.rs.
  6. It needs to be autoformatted (cargo fmt --all)
  7. Modify the serialize/deserialize functions. Check the following PRs for details: