github.com/bananabytelabs/wazero@v0.0.0-20240105073314-54b22a776da8/internal/integration_test/stdlibs/README.md (about)

     1  # Stdlibs benchmarks
     2  
     3  This directory contains a Makefile to build (a subset of) the stdlibs for Zig, TinyGo and Go (wasip1)
     4  and test them against the baseline compiler and the optimizing compiler.
     5  
     6  ## Requirements
     7  
     8  - Zig 0.11.0 in PATH, source code to zig 0.11.0
     9  - TinyGo in PATH
    10  - Go in PATH
    11  
    12  ## Usage
    13  
    14  First, build the test suite (the Zig source root has to be set explicitly):
    15  
    16      make all zigroot=/path/to/zig/source
    17  
    18  Then you can run the test suite against the baseline compiler and the optimizing compiler; e.g.:
    19  
    20      go test -bench=. --benchtime=1x
    21  
    22  If you want to run with the default settings, use `make run`.
    23  
    24  ## Caveats
    25  
    26  * The standard binary zig distribution does not ship some testdata.
    27    You should override with the zig source code path, otherwise some tests will fail.
    28  
    29  * Some tests might fail if Go has been installed with homebrew because
    30    the file system layout is different than what the tests expect.
    31    Easiest fix is to install Go without using brew.
    32