v0.5.0

Changed

• Breaking: package cm is now a separate module. This change was made in order to minimize the runtime dependencies of programs that depend on package cm but not the rest of the packages in this module. To update your code that depends on package cm, run go get -u go.bytecodealliance.org/....

Fixed

• #264: fix lowering for imported functions that return named bool types.

v0.4.1

Added

• wit-bindgen-go wit now accepts an --interface argument in the form of monotonic-clock, wasi:clocks/monotonic-clock, or wasi:clocks/[email protected]. This filters the serialized WIT to a specific interface and the other interface(s) it references. This can be used to generate focused WIT with a minimal set of dependencies, and can be combined with the --world argument to filter serialized WIT to the intersection of a specific world and interface.

Fixed

• #240: correctly handle cyclical data structures when generating variant lowering code.

Changed

• Breaking: package wit no longer interprets - to read from stdin when loading JSON or WIT using wit.LoadJSON or wit.LoadWIT. Use wit.DecodeJSON or wit.DecodeWIT to read JSON or WIT from an io.Reader.
• Breaking: wit.ParseWIT has been removed. Use wit.DecodeWIT(bytes.NewReader(b)) instead.

v0.4.0

This module has been renamed. Going forward, please use go.bytecodealliance.org instead of github.com/bytecodealliance/wasm-tools-go.

v0.3.1

Added

• wit-bindgen-go now accepts arguments that control the level of logging output on stderr. Verbose mode (-v or --verbose) will print informational log lines, warnings, and errors. Debug mode (-vv or --debug) will emit finer-grained debugging information. By default, wit-bindgen-go will print warnings or errors.
• New method (cm.Result).Result() (ok OK, err Err, isErr bool) added to streamline common patterns using result types. It has a value receiver, allowing it to be chained off a function call that returns a Result, eliminating the need to declare a temporary variable. For example: stream, err, isErr := stream.BlockingRead(n)

Fixed

• #215: generate variant accessor methods with the correct scope for Go names.

New Contributors

• @vados-cosmonic: #212 and #214 — verbose logging controls in wit-bindgen-go.

v0.3.0

Added

• Go type aliases are now generated for each WIT type alias (type foo = bar). Deep chains of type aliases (type b = a; type c = b;) are fully supported. Generated documentation now reflects whether a type is an alias. Fixes #204.
• go:wasmimport and go:wasmexport functions are now generated in a separate .wasm.go file. This helps enable testing or use of generated packages outside of WebAssembly.
• wit-bindgen-go generate now generates a WIT file for each WIT world in its corresponding Go package directory. For example the wasi:http/proxy world would generate wasi/http/proxy/proxy.wit.
• wit-bindgen-go wit now accepts a --world argument in the form of imports, wasi:clocks/imports, or wasi:clocks/[email protected]. This filters the serialized WIT to a specific world and interfaces it references. This can be used to generate focused WIT for a specific world with a minimal set of dependencies.

Changed

• Method wit.(*Package).WIT() now interprets the non-empty string name argument as signal to render in single-file, multi-package braced form.
• wit.(*Resolve).WIT() and wit.(*Package).WIT() now accept a *wit.World as context to filter serialized WIT to a specific world.
• Packages are now sorted topologically by dependency in generated WIT files. For example, wasi:cli would be followed by its dependencies like wasi:io, wasi:filesystem, or wasi:random.

v0.2.4

Added

• Generated variant shape types (...Shape) now include structs.HostLayout.

v0.2.3

Added

• wit-bindgen-go generate now accepts a remote registry reference to pull down a WIT package and generate the Go code. Example: wit-bindgen-go generate ghcr.io/webassembly/wasi/http:0.2.0.

Changed

• cm.List now stores list length as a uintptr, permitted by the Go wasm types proposal. It was previously a uint, which was removed from the list of permitted types. There should be no change in the memory layout in TinyGo GOARCH=wasm or Go GOARCH=wasm32 using 32-bit pointers.
• The helper functions cm.NewList, cm.LiftList, and cm.LiftString now accept any integer type for len, defined as cm.AnyInteger.
• cm.Option[T].Value() method now value receiver (not pointer receiver), so it can be chained.

v0.2.2

Added

• All struct types in package cm now include structs.HostLayout on Go 1.23 or later.
• Added type constraints AnyList, AnyResult, and AnyVariant in package cm to constrain generic functions accepting any of those types.
• Variant types now implement fmt.Stringer, with a String method. Breaking: variant cases named string map to String_ in Go.
• cm.Option[T] types now have a Value() convenience method that returns the zero value for T if the option represents the none case. For example, this simplifies getting an empty string or slice from option<string> or option<list<T>>, respectively.
• Added a release workflow to publish tagged releases to GitHub.

Fixed

• wit-bindgen-go --version now displays the version without empty ().

v0.2.1

Added

• Generated structs and structs in package cm now include a HostLayout field in order to conform with the relaxed types proposal for GOARCH=wasm32. The cm.HostLayout type is an alias for structs.HostLayout on Go 1.23 or later, and a polyfill for Go 1.22 or earlier.
• #163: added cm.F32ToU64() and cm.U64ToF32() for flattening f32 and u64 types in the Canonical ABI.
• Test data from bytecodealliance/wit-bindgen/tests/codegen.

Fixed

• #159: correctly escape all WIT keywords, including when used in package names.
• #160: fixed the use of Go reserved keywords in function returns as result types.
• #161: correctly handle constructor as a WIT keyword in wit.
• #165: fixed use of imported types in exported functions.
• #167: fixed a logic flaw in TestHasBorrow.
• #170: resolve implied names for interface imports and exports in a world.
• #175: generated correct symbol names for imported and exported functions in worlds ($root) or interfaces declared inline in worlds.

v0.2.0

This project has moved! wasm-tools-go is now an official Bytecode Alliance project.

Going forward, please update your Go imports from github.com/ydnar/wasm-tools-go to github.com/bytecodealliance/wasm-tools-go. Thanks to @ricochet, @mossaka, @lxfontes, and others for their help making this possible.

Changed

• Added support for @deprecated directive implemented in wasm-tools#1687.
• Removed support for @since feature gating implemented in wasm-tools#1741.

Fixed

• #151: backport support for JSON generated by wasm-tools prior to v1.209.0, which added @since and @unstable feature gates.