WebAssembly / binaryen

Optimizer and compiler/toolchain library for WebAssembly
Apache License 2.0
7.49k stars 741 forks source link

Formal spec on binaryen text input? #5591

Open bobzhang opened 1 year ago

bobzhang commented 1 year ago

I was aware of this but do we have a formal spec of the text syntax? Or using the binaryen API is the only recommended way to use binaryen? Thank you

tlively commented 1 year ago

No, unfortunately we don't have a comprehensive list of the differences between Binaryen's text format and the standard WebAssembly text format. I have a side project to replace Binaryen's text parser so that it will use the standard text format, but that's not finished.

In the meantime, you can look at Binaryen's tests to see what kind of text format it expects (although some things might need to be tweaked once we switch to parsing the standard text format).

Besides using the C API, the most stable way to use Binaryen will always be to pass it a WebAssembly binary, since we already support the standard binary format and it has strict backward compatibility guarantees.