blob: ff37c8a465a921bab99ffc67de3959d0f8aeccc1 [file] [log] [blame]
#!/usr/bin/env python
# Copyright 2019 the V8 project authors. All rights reserved.
# Use of this source code is governed by a BSD-style license that can be
# found in the LICENSE file.
Helper script for compiling and running the Wasm C/C++ API examples.
Usage: tools/ outdir tempdir [filters...]
"outdir" is the build output directory containing libwee8, e.g. out/x64.release
"tempdir" is a temporary dir where this script may put its artifacts. It is
the caller's responsibility to clean it up afterwards.
By default, this script builds and runs all examples, both the respective
C and C++ versions, both with GCC ("gcc" and "g++" binaries found in $PATH)
and V8's bundled Clang in third_party/llvm-build/. You can use any number
of "filters" arguments to run only a subset:
- "c": run C versions of examples
- "cc": run C++ versions of examples
- "gcc": compile with GCC
- "clang": compile with Clang
- "hello" etc.: run "hello" example
from __future__ import print_function
import os
import shutil
import subprocess
import sys
CFLAGS = "-DDEBUG -Wall -Werror -O0 -ggdb -fsanitize=address"
CHECKOUT_PATH = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
WASM_PATH = os.path.join(CHECKOUT_PATH, "third_party", "wasm-api")
CLANG_PATH = os.path.join(CHECKOUT_PATH, "third_party", "llvm-build",
"Release+Asserts", "bin")
EXAMPLES = ["hello", "callback", "trap", "reflect", "global", "table",
"memory", "finalize", "serialize", "threads", "hostref", "multi",
"name": "Clang",
"c": os.path.join(CLANG_PATH, "clang"),
"cc": os.path.join(CLANG_PATH, "clang++"),
"ldflags": "-fsanitize-memory-track-origins -fsanitize-memory-use-after-dtor",
GCC = {
"name": "GCC",
"c": "gcc",
"cc": "g++",
"ldflags": "",
C = {
"name": "C",
"suffix": "c",
"cflags": "",
CXX = {
"name": "C++",
"suffix": "cc",
"cflags": "-std=c++11",
MIN_ARGS = 3 # Script, outdir, tempdir
def _Call(cmd_list, silent=False):
cmd = " ".join(cmd_list)
if not silent: print("# %s" % cmd)
return, shell=True)
class Runner(object):
def __init__(self, name, outdir, tempdir): = name
self.outdir = outdir
self.tempdir = tempdir
self.src_file_basename = os.path.join(WASM_PATH, "example", name)
self.dst_file_basename = os.path.join(tempdir, name)
self.lib_file = os.path.join(outdir, "obj", "libwee8.a")
if not os.path.exists(self.lib_file):
print("libwee8 library not found, make sure to pass the outdir as "
"first argument; see --help")
src_wasm_file = self.src_file_basename + ".wasm"
dst_wasm_file = self.dst_file_basename + ".wasm"
shutil.copyfile(src_wasm_file, dst_wasm_file)
def _Error(self, step, lang, compiler, code):
print("Error: %s failed. To repro: tools/ "
"%s %s %s %s %s" %
(step, self.outdir, self.tempdir,, lang,
return code
def CompileAndRun(self, compiler, language):
print("==== %s %s/%s ====" %
(, language["name"], compiler["name"]))
lang = language["suffix"]
src_file = self.src_file_basename + "." + lang
exe_file = self.dst_file_basename + "-" + lang
obj_file = exe_file + ".o"
# Compile.
c = _Call([compiler[lang], "-c", language["cflags"], CFLAGS,
"-I", WASM_PATH, "-o", obj_file, src_file])
if c: return self._Error("compilation", lang, compiler, c)
# Link.
c = _Call([compiler["cc"], CFLAGS, compiler["ldflags"], obj_file,
"-o", exe_file, self.lib_file, "-ldl -pthread"])
if c: return self._Error("linking", lang, compiler, c)
# Execute.
exe_file = "./%s-%s" % (, lang)
c = _Call(["cd", self.tempdir, ";", exe_file])
if c: return self._Error("execution", lang, compiler, c)
return 0
def Main(args):
if (len(args) < MIN_ARGS or args[1] in ("-h", "--help", "help")):
return 1
outdir = sys.argv[1]
tempdir = sys.argv[2]
result = 0
examples = EXAMPLES
compilers = (GCC, CLANG)
languages = (C, CXX)
if len(args) > MIN_ARGS:
custom_compilers = []
custom_languages = []
custom_examples = []
for i in range(MIN_ARGS, len(args)):
arg = args[i]
if arg == "c" and C not in custom_languages:
elif arg in ("cc", "cpp", "cxx", "c++") and CXX not in custom_languages:
elif arg in ("gcc", "g++") and GCC not in custom_compilers:
elif arg in ("clang", "clang++") and CLANG not in custom_compilers:
elif arg in EXAMPLES and arg not in custom_examples:
print("Didn't understand '%s'" % arg)
return 1
if custom_compilers:
compilers = custom_compilers
if custom_languages:
languages = custom_languages
if custom_examples:
examples = custom_examples
for example in examples:
runner = Runner(example, outdir, tempdir)
for compiler in compilers:
for language in languages:
c = runner.CompileAndRun(compiler, language)
if c: result = c
if result:
print("\nFinished with errors.")
print("\nFinished successfully.")
return result
if __name__ == "__main__":