Crate wasm_metadata

Read and manipulate WebAssembly metadata

Examples

Read metadata from a Wasm binary

use wasm_metadata::Payload;
use std::fs;

let wasm = fs::read("program.wasm")?;
let metadata = Payload::from_binary(&wasm)?.metadata();

Add metadata to a Wasm binary

use wasm_metadata::*;
use std::fs;

let wasm = fs::read("program.wasm")?;

let mut add = AddMetadata ::default();
add.name = Some("program".to_owned());
add.language = vec![("tunalang".to_owned(), "1.0.0".to_owned())];
add.processed_by = vec![("chashu-tools".to_owned(), "1.0.1".to_owned())];
add.sdk = vec![];
add.authors = Some(Authors::new("Chashu Cat"));
add.description = Some(Description::new("Chashu likes tuna"));
add.licenses = Some(Licenses::new("Apache-2.0 WITH LLVM-exception")?);
add.source = Some(Source::new("https://github.com/chashu/chashu-tools")?);
add.homepage = Some(Homepage::new("https://github.com/chashu/chashu-tools")?);
add.revision = Some(Revision::new("de978e17a80c1118f606fce919ba9b7d5a04a5ad"));
add.version = Some(Version::new("1.0.0"));

let wasm = add.to_wasm(&wasm)?;
fs::write("program.wasm", &wasm)?;

Structs

AddMetadata

Add metadata (module name, producers) to a WebAssembly file.

Authorsoci

Contact details of the people or organization responsible, encoded as a freeform string.

ComponentNames

Helper for rewriting a component’s component-name section with a new component name.

Dependenciesoci

Human-readable description of the binary

Descriptionoci

Human-readable description of the binary

Homepageoci

URL to find more information on the binary

Licensesoci

License(s) under which contained software is distributed as an SPDX License Expression.

Metadataoci

Metadata associated with a Wasm Component or Module

ModuleNames

Helper for rewriting a module’s name section with a new module name.

Producers

A representation of a WebAssembly producers section.

ProducersField

Contents of a producers field

Revisionoci

Source control revision identifier for the packaged software.

Sourceoci

URL to get source code for building the image

Versionoci

Version of the packaged software

Enums

Payloadoci

Data representing either a Wasm Component or module