wasm-compose
| Crates.io | wasm-compose |
| lib.rs | wasm-compose |
| version | 0.219.1 |
| source | src |
| created_at | 2022-06-28 03:05:24.539793 |
| updated_at | 2024-10-10 15:49:12.455785 |
| description | A library for composing WebAssembly components. |
| homepage | https://github.com/bytecodealliance/wasm-tools/tree/main/crates/wasm-compose |
| repository | https://github.com/bytecodealliance/wasm-tools/tree/main/crates/wasm-compose |
| max_upload_size | |
| id | 614530 |
| size | 260,208 |
wasmtime-publish (github:bytecodealliance:wasmtime-publish)
documentation
README
Overview
IMPORTANT: wasm-compose has been been deprecated in favor of wac.
wasm-compose is a library for composing WebAssembly components
from other WebAssembly components.
It is made available as the compose subcommand of wasm-tools.
Usage
To compose a component, run the compose command:
wasm-tools compose -o composed.wasm component.wasm
This will automatically search for dependencies at the same location
as the input component, component.wasm, and create a composed
component named composed.wasm.
Any unresolved dependencies will remain as imports in the composed component.
Configuration
See configuring wasm-compose for more information on authoring configuration files.
How it works
wasm-compose starts with the input component and then processes each of the component's instance imports.
For each instance import, wasm-compose will consult its configuration to determine how to locate a dependency with the same name as the import.
If the dependency is not specified in the configuration, wasm-compose will search the configured search paths for a matching component file.
If a component to satisfy the dependency cannot be found, it will remain as an instance import in the composed component; at least one dependency must be satisfied for the component to be composed.
wasm-compose then repeats this process for all of the transitive imports of dependent components that have been found.
The composed component will, by default, define the transitive component dependencies directly in the composed component; it will then instantiate the dependencies in a topological order.
Finally the input component is instantiated and all of its exports are then exported from the composed component.
Example
See the example directory for a complete example of composing WebAssembly components together.
License
This project is licensed under the Apache 2.0 license with the LLVM exception. See LICENSE for more details.
Contribution
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be licensed as above, without any additional terms or conditions.