golem-wasm-rpc-stubgen

Crates.iogolem-wasm-rpc-stubgen
lib.rsgolem-wasm-rpc-stubgen
version0.0.19
sourcesrc
created_at2024-02-13 17:59:46.416292
updated_at2024-04-10 16:02:37.235786
descriptionGolem WASM RPC stub generator
homepagehttps://golem.cloud
repositoryhttps://github.com/golemcloud/wasm-rpc
max_upload_size
id1138761
Daniel Vigovszky

documentation

README

# golem-wasm-rpc-stubgen The `golem-wasm-rpc-stubgen` is a CLI tool to generate the RPC stubs from a component's WIT definition. ## Generate ```shell Usage: wasm-rpc-stubgen generate [OPTIONS] --source-wit-root --dest-crate-root Options: -s, --source-wit-root -d, --dest-crate-root -w, --world --stub-crate-version [default: 0.0.1] --wasm-rpc-path-override -h, --help Print help -V, --version Print version ``` - `source-wit-root`: The root directory of the component's WIT definition to be called via RPC - `dest-crate-root`: The target path to generate a new stub crate to - `world`: The world name to be used in the generated stub crate. If there is only a single world in the source root package, no need to specify. - `stub-crate-version`: The crate version of the generated stub crate - `wasm-rpc-path-override`: The path to the `wasm-rpc` crate to be used in the generated stub crate. If not specified, the latest version of `wasm-rpc` will be used. The command creates a new Rust crate that is ready to be compiled with ```shell cargo component build --release ``` The resulting WASM component implements the **stub interface** corresponding to the source interface, found in the target directory's `wit/_stub.wit` file. This WASM component is to be composed together with another component that calls the original interface via WASM RPC. ## Build ``` Usage: wasm-rpc-stubgen build [OPTIONS] --source-wit-root --dest-wasm --dest-wit-root Options: -s, --source-wit-root --dest-wasm --dest-wit-root -w, --world --stub-crate-version [default: 0.0.1] --wasm-rpc-path-override -h, --help Print help -V, --version Print version ``` - `source-wit-root`: The root directory of the component's WIT definition to be called via RPC - `dest-wasm`: The name of the stub WASM file to be generated - `dest-wit-root`: The directory name where the generated WIT files should be placed - `world`: The world name to be used in the generated stub crate. If there is only a single world in the source root package, no need to specify. - `stub-crate-version`: The crate version of the generated stub crate - `wasm-rpc-path-override`: The path to the `wasm-rpc` crate to be used in the generated stub crate. If not specified, the latest version of `wasm-rpc` will be used. It needs to be an **absolute path**. ## Add stub WIT dependency ```shell Usage: wasm-rpc-stubgen add-stub-dependency [OPTIONS] --stub-wit-root --dest-wit-root Options: -s, --stub-wit-root -d, --dest-wit-root -o, --overwrite -u, --update-cargo-toml -h, --help Print help -V, --version Print version ``` The command merges a generated RPC stub as a WIT dependency into an other component's WIT root. - `stub-wit-root`: The WIT root generated by either `generate` or `build` command - `dest-wit-root`: The WIT root of the component where the stub should be added as a dependency - `overwrite`: This command would not do anything if it detects that it would change an existing WIT file's contents at the destination. With this flag, it can be forced to overwrite those files. - `update-cargo-toml`: Enables updating the Cargo.toml file in the parent directory of `dest-wit-root` with the copied dependencies. - ## Compose the stub with the caller component ```shell Usage: wasm-rpc-stubgen compose --source-wasm --stub-wasm --dest-wasm Options: --source-wasm --stub-wasm --dest-wasm -h, --help Print help -V, --version Print version ``` The command composes a caller component's WASM (which uses the generated stub to call a remote worker) with the generated stub WASM, writing out a composed WASM which no longer depends on the stub interface, ready to use. - `source-wasm`: The WASM file of the caller component - `stub-wasm`: The WASM file of the generated stub. Multiple stubs can be listed. - `dest-wasm`: The name of the composed WASM file to be generated ## Initialize cargo make tasks for a workspace ```shell Usage: wasm-rpc-stubgen initialize-workspace [OPTIONS] --targets --callers Options: --targets List of subprojects to be called via RPC --callers List of subprojects using the generated stubs for calling remote workers --wasm-rpc-path-override ``` When both the target and the caller components are in the same Cargo workspace, this command can initialize a `cargo-make` file with dependent tasks performing the stub generation, WIT merging and WASM composition. Once the workspace is initialized, the following two commands become available: ```shell cargo make build-flow cargo make release-build-flow ```
Commit count: 141

cargo fmt