config.yml

version: 2.1

orbs:
  win: circleci/windows@5.0
  macos: circleci/macos@2.4.1

executors:
  linux-node:
    docker:
      - image: cimg/node:24.13.1
  ubuntu-lts:
    docker:
      - image: emscripten/emscripten-ci:jammy.v2
    environment:
      LANG: "C.UTF-8"
      EMCC_CORES: "4"
      EMSDK_NOTTY: "1"
      EMTEST_WASI_SYSROOT: "~/wasi-sdk/wasi-sysroot"
      EMTEST_DETECT_TEMPFILE_LEAKS: "1"
  mac-arm64:
    environment:
      EMSDK_NOTTY: "1"
    macos:
      xcode: "16.4.0"
    resource_class: m4pro.medium

commands:
  install-browser:
    description: "Install browser"
    parameters:
      browser_name:
        description: "Name of the the browser to install"
        type: string
    steps:
      - run:
          name: download browser (<< parameters.browser_name >>)
          command: |
            npx --yes @puppeteer/browsers install << parameters.browser_name >> --format={{path}} | tee browser_path.txt
            BROWSER_PATH=`cat browser_path.txt`
            echo "browser installed to: ${BROWSER_PATH}"
            "${BROWSER_PATH}" --version
            echo "export EMTEST_BROWSER=\"${BROWSER_PATH}\"" >> $BASH_ENV
  emsdk-env:
    description: "emsdk_env.sh"
    steps:
      - run:
          name: emsdk_env.sh
          command: |
            EMSDK_BASH=1 ~/emsdk/emsdk construct_env >> $BASH_ENV
            # In order make our external version of emscripten use the emsdk
            # config we need to explicitly set EM_CONFIG here.
            echo "export EM_CONFIG=~/emsdk/.emscripten" >> $BASH_ENV
  bootstrap:
    description: "bootstrap"
    steps:
      - run: "$EMSDK_PYTHON ./bootstrap.py"
  pip-install:
    description: "pip install"
    parameters:
      python:
        description: "Python executable to use"
        type: string
        default: python3
    steps:
      - run:
          name: pip install
          command: << parameters.python >> -m pip install -r requirements-dev.txt
  install-rust:
    steps:
      - run:
          name: install rust and wasm-bindgen
          # rust and wasm-bindgen are always installed together so there is no
          # CI environment with one but not the other. The wasm-bindgen-cli
          # version is pinned to match the library the test crate depends on;
          # wasm-bindgen requires the CLI and the library to be the exact same
          # version.
          command: |
            curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
            export PATH=${HOME}/.cargo/bin:${PATH}
            rustup target add wasm32-unknown-emscripten
            echo "export PATH=\"\$HOME/.cargo/bin:\$PATH\"" >> $BASH_ENV
            cargo install wasm-bindgen-cli --version 0.2.126 --locked
  install-node-version:
    description: "install a specific version of node"
    parameters:
      node_version:
        description: "version of node to install"
        type: string
      canary:
        description: "install a canary version of node"
        type: boolean
        default: false
    steps:
      - run:
          name: setup node v<< parameters.node_version >>
          command: |
            cd $HOME
            version=<< parameters.node_version >>
            if [[ << parameters.canary >> == "true" ]]; then
              wget https://nodejs.org/download/v8-canary/v${version}/node-v${version}-linux-x64.tar.xz
            else
              wget https://nodejs.org/dist/v${version}/node-v${version}-linux-x64.tar.xz
            fi
            tar xf node-v${version}-linux-x64.tar.xz
            echo "NODE_JS_TEST = [os.path.expanduser('~/node-v${version}-linux-x64/bin/node')]" >> ~/emsdk/.emscripten
            echo "JS_ENGINES = [NODE_JS_TEST]" >> ~/emsdk/.emscripten
            echo "if os.path.exists(V8_ENGINE[0]): JS_ENGINES.append(V8_ENGINE)" >> ~/emsdk/.emscripten
            cat ~/emsdk/.emscripten
            echo "export PATH=\"$HOME/node-v${version}-linux-x64/bin:\$PATH\"" >> $BASH_ENV
  install-node-oldest:
    description: "install node 18.3.0 (oldest)"
    steps:
      - install-node-version:
          # Keep this in sync with `OLDEST_SUPPORTED_NODE` in `feature_matrix.py`
          node_version: "18.3.0"
  install-node-lts:
    description: "install node 22.21.0 (current LTS)"
    steps:
      - install-node-version:
         node_version: "22.21.0"
  install-node-newest:
    description: "install node 26.3.0 (newest)"
    steps:
      - install-node-version:
         node_version: "26.3.0"
  install-v8:
    description: "install v8 using jsvu"
    steps:
      - run:
          name: get v8
          command: |
            # We can't use a more recent version of node here because the linux
            # image we are using doesn't have a recent enough glibc.
            cd $HOME
            wget https://nodejs.org/dist/v15.14.0/node-v15.14.0-linux-x64.tar.xz
            tar -xf node-v15.14.0-linux-x64.tar.xz
            export PATH="`pwd`/node-v15.14.0-linux-x64/bin:${PATH}"
            npm install jsvu -g
            jsvu --os=default --engines=v8
  install-emsdk:
    description: "Install emsdk"
    steps:
      - run:
          name: install emsdk
          command: |
            curl -# -L -o ~/emsdk-main.tar.gz https://github.com/emscripten-core/emsdk/archive/main.tar.gz
            tar -C ~ -xf ~/emsdk-main.tar.gz
            mv ~/emsdk-main ~/emsdk
            cd ~/emsdk
            ./emsdk install tot
            ./emsdk activate tot
            # Write the version of clang into a file for use in the ccache key
            ./upstream/bin/clang --version > clang_version.txt
            echo "clang version:"
            cat ~/emsdk/clang_version.txt
            # Remove the emsdk version of emscripten to save space in the
            # persistent workspace and to avoid any confusion with the version
            # we are trying to test.
            rm -Rf emscripten
            echo "import os" >> .emscripten
            # We use an out-of-tree cache directory so it can be part of the
            # persisted workspace (see below).
            echo "CACHE = os.path.expanduser('~/cache')" >> .emscripten
            # Refer to commit 0bc3640 if we need to pin V8 version.
            echo "V8_ENGINE = [os.path.expanduser('~/.jsvu/bin/v8')]" >> .emscripten
            echo "JS_ENGINES = [NODE_JS]" >> .emscripten
            echo "if os.path.exists(V8_ENGINE[0]): JS_ENGINES.append(V8_ENGINE)" >> .emscripten
            echo "WASM_ENGINES = []" >> .emscripten
            test -f ~/vms/wasmtime && echo "WASMTIME = os.path.expanduser(os.path.join('~', 'vms', 'wasmtime')) ; WASM_ENGINES.append(WASMTIME)" >> .emscripten || true
            test -f ~/vms/wasmer && echo "WASMER = os.path.expanduser(os.path.join('~', 'vms', 'wasmer')) ; WASM_ENGINES.append(WASMER)" >> .emscripten || true
            test -d ~/wasi-sdk && cp -a ~/wasi-sdk/lib/ $(~/emsdk/upstream/bin/clang -print-resource-dir)
            cd -
            echo "final .emscripten:"
            cat ~/emsdk/.emscripten
      - emsdk-env
      - bootstrap
  build-libs:
    description: "Build all libraries"
    steps:
      - run:
          name: clear cache
          command: |
            ./emcc --clear-cache
      - pip-install
      - run: apt-get install -q -y ninja-build ccache
      - run:
          name: Ccache stats and configuration
          command: |
            ccache -s
            ccache --print-stats
            ccache -p
      - run:
          name: embuilder build ALL
          command: |
            ./embuilder build ALL
            ./test/runner test_hello_world
      - run:
          name: embuilder (LTO)
          command: |
            ./embuilder build MINIMAL --lto
      - run:
          name: embuilder (WASM64)
          command: |
            ./embuilder build MINIMAL --wasm64
      - run:
          name: embuilder (PIC)
          command: |
            ./embuilder build MINIMAL_PIC --pic
      - run:
          name: embuilder (PIC+WASM64)
          command: |
            ./embuilder build MINIMAL_PIC --pic --wasm64
      - run:
          name: embuilder (PIC+LTO)
          command: |
            ./embuilder build MINIMAL --pic --lto
      - run:
          name: "Ccache stats and configuration"
          command: |
            ls -l ~/cache/sysroot/lib/wasm32-emscripten || echo "no build"
            ls -l ~/cache/sysroot/include/emscripten/heap.h
            cat ~/cache/sysroot/lib/wasm32-emscripten/crtbegin-mt.o.ccache-log
            date
            cat ~/cache/build/libclang_rt.builtins/absvdi2.o.ccache-log
            ccache -s
            ccache --print-stats
            ccache -p
            ccache --zero-stats

  persist:
    description: "Persist the emsdk, libraries, and engines"
    steps:
      - persist_to_workspace:
          # Must be an absolute path, or relative path from working_directory
          root: ~/
          # Must be relative path from root
          paths:
            - emsdk/
            - cache/
            - vms/
            - wasi-sdk/
            - .jsvu/
      - when:
          # Only the main branch will store its cache results, and only the non-main branches
          # will use cached results. This prevents untrusted PRs from polluting caches used
          # by other branches.
          condition:
            equal: [ "main", << pipeline.git.branch >> ]
          steps:
            - save_cache:
                name: "Save Ccache cache"
                paths:
                  - ~/.ccache
                key: clang-{{ checksum "~/emsdk/clang_version.txt" }}

  prepare-for-tests:
    description: "Setup emscripten tests"
    steps:
      - attach_workspace:
          # Must be absolute path or relative path from working_directory
          at: ~/
      - checkout
      - emsdk-env
      - bootstrap
      - pip-install
      - when:
          # We only set EMTEST_RETRY_FLAKY on pull requests.  When we run
          # normal CI jobs on branches like main we still want to be able to
          # detect flakyness.
          condition: ${CIRCLE_PULL_REQUEST}
          steps:
            - set-retry-flaky-tests
  remove-linux-binaries:
    description: "Remove linux binaries from workspace"
    steps:
      - run:
          name: "Remove Linux binaries"
          command: rm -rf ~/emsdk ~/vms ~/.jsvu ~/wasi-sdk
  upload-test-results:
    description: "Upload test results"
    steps:
      - store_test_results:
          path: out/test-results.xml
  run-tests:
    description: "Runs emscripten tests"
    parameters:
      test_targets:
        description: "Test suites to run"
        type: string
      title:
        description: "Name of given test suite"
        type: string
        default: ""
      extra-cflags:
        description: "Extra EMCC_CFLAGS"
        type: string
        default: ""
    steps:
      - run:
          name: run tests (<< parameters.title >>)
          environment:
            EMCC_CFLAGS: << parameters.extra-cflags >>
          command: |
            env
            ./test/runner << parameters.test_targets >>
            $EMSDK_PYTHON ./test/check_clean.py
  freeze-cache:
    description: "Freeze emscripten cache"
    steps:
      - run:
          name: Add EM_FROZEN_CACHE to bash env
          command: echo "export EM_FROZEN_CACHE=1" >> $BASH_ENV
  set-retry-flaky-tests:
    description: "Set EMTEST_RETRY_FLAKY"
    steps:
      - run:
          name: Add EMTEST_RETRY_FLAKY to bash env
          command: echo "export EMTEST_RETRY_FLAKY=2" >> $BASH_ENV
  run-tests-linux:
    description: "Runs emscripten tests"
    parameters:
      test_targets:
        description: "Test suites to run"
        type: string
      frozen_cache:
        description: "Run with cache frozen"
        type: boolean
        default: true
      title:
        description: "Name of given test suite"
        type: string
        default: ""
    steps:
      - prepare-for-tests
      - when:
          condition: << parameters.frozen_cache >>
          steps:
            - freeze-cache
      - run-tests:
          test_targets: << parameters.test_targets >>
          title: << parameters.title >>
      - upload-test-results
  run-tests-chrome:
    description: "Runs browser tests under chrome"
    parameters:
      test_targets:
        description: "Test suites to run"
        type: string
      title:
        description: "Name of given test suite"
        type: string
        default: ""
    steps:
      - prepare-for-tests
      - install-browser:
          browser_name: chrome@canary
      - run:
          name: run tests (<< parameters.title >>)
          environment:
            EMTEST_DETECT_TEMPFILE_LEAKS: "0"
            EMTEST_HEADLESS: "1"
            EMTEST_CORES: "2"
          command: |
            # There are tests in the browser test suite that using libraries
            # that are not included by "./embuilder build ALL".  For example the
            # PIC version of libSDL which is used by test_sdl2_misc_main_module
            export EM_FROZEN_CACHE=""
            test/runner << parameters.test_targets >>
      - upload-test-results
  setup-macos:
    steps:
      - macos/install-rosetta
      - run:
          name: Install brew package dependencies
          environment:
            HOMEBREW_NO_AUTO_UPDATE: "1"
          # Use --force-bottle to force homebrew use binary packages avoiding
          # costly build times.
          command: brew install --force-bottle cmake ninja pkg-config
      - attach_workspace:
          at: ~/
      - checkout
      - remove-linux-binaries
  run-tests-firefox:
    description: "Runs emscripten tests under firefox"
    parameters:
      test_targets:
        description: "Test suites to run"
        type: string
      title:
        description: "Name of given test suite"
        type: string
        default: ""
    steps:
      - install-browser:
          browser_name: firefox@nightly
      - run:
          name: Add audio dependencies
          command: |
            # This should add and start PulseAudio's dummy mixer. It will warn
            # that "This program is not intended to be run as root" but it can
            # be ignored.
            # (Use the presence of apt-get here to detect linux, where we don't
            # want to run this elsewhere).
            if which apt-get; then
              pulseaudio --start
            fi
      - run:
          name: run tests (<< parameters.title >>)
          environment:
            GALLIUM_DRIVER: softpipe # TODO: use the default llvmpipe when it supports more extensions
            # TODO: Do GL testing when https://bugzil.la/1375585 (lack of WebGL
            #       support in headless mode) resolves
            EMTEST_LACKS_GRAPHICS_HARDWARE: "1"
            # TODO(https://github.com/emscripten-core/emscripten/issues/24205)
            EMTEST_LACKS_SOUND_HARDWARE: "1"
            EMTEST_LACKS_WEBGPU: "1"
            EMTEST_DETECT_TEMPFILE_LEAKS: "0"
            EMTEST_HEADLESS: "1"
            EMTEST_CORES: "2"
            DISPLAY: ":0"
          command: |
            # There are tests in the browser test suite that using libraries
            # that are not included by "./embuilder build ALL".  For example the
            # PIC version of libSDL which is used by test_sdl2_misc_main_module
            export EM_FROZEN_CACHE=""
            echo "-----"
            echo "Running browser tests (EMTEST_BROWSER=$EMTEST_BROWSER)"
            echo "-----"
            test/runner << parameters.test_targets >>
            # posix and emrun suites are disabled because firefox errors on
            #  "Firefox is already running, but is not responding."
            # TODO: find out a way to shut down and restart firefox
      - upload-test-results
  test-sockets-chrome:
    description: "Runs emscripten sockets tests under chrome"
    steps:
      - prepare-for-tests
      - install-browser:
          browser_name: chrome@canary
      - run:
          name: run sockets tests
          environment:
            EMTEST_LACKS_SOUND_HARDWARE: "1"
            EMTEST_DETECT_TEMPFILE_LEAKS: "0"
            EMTEST_HEADLESS: "1"
            EMTEST_CORES: "2"
          command: |
            test/runner sockets
      - upload-test-results

jobs:
  build-docs:
    executor: ubuntu-lts
    steps:
      - checkout
      - pip-install
      - run: tools/maint/update_settings_docs.py --check
      - run: make -C site text
      - run: tools/maint/check_emcc_help_text.py
      - run: make -C site html
  ruff:
    executor: ubuntu-lts
    steps:
      - checkout
      - pip-install
      - run: ruff check
  vulture:
    executor: ubuntu-lts
    steps:
      - checkout
      - pip-install
      - run: vulture . --min-confidence 100
  mypy:
    executor: ubuntu-lts
    steps:
      - checkout
      - pip-install
      - run: mypy
  eslint:
    executor: linux-node
    steps:
      - checkout
      - run: npm ci
      - run: |
          npm run lint
          npm run check
  test-sanity:
    executor: ubuntu-lts
    steps:
      - run-tests-linux:
          frozen_cache: false
          test_targets: "sanity"
  build-linux:
    executor: ubuntu-lts
    # xlarge has 4x the cores of the default medium, costs 4x as much, and runs
    # in about 1/2 the time, so it is not cost-effective (overall it is 2x the
    # cost for the same work), but given this blocks almost all the other jobs
    # we want it to finish asap
    resource_class: xlarge
    environment:
      EMCC_CORES: 16
      EMCC_USE_NINJA: 1
      EM_COMPILER_WRAPPER: "ccache"
    steps:
      - checkout
      - run:
          name: get wasmer
          command: |
            wget https://github.com/wasmerio/wasmer/releases/download/v3.1.1/wasmer-linux-amd64.tar.gz
            tar -xf wasmer-linux-amd64.tar.gz
            mkdir ~/vms
            cp bin/wasmer ~/vms
      - run:
          name: get wasmtime
          command: |
            # use a pinned version due to https://github.com/bytecodealliance/wasmtime/issues/714
            export VERSION=v0.33.0
            wget https://github.com/bytecodealliance/wasmtime/releases/download/$VERSION/wasmtime-$VERSION-x86_64-linux.tar.xz
            tar -xf wasmtime-$VERSION-x86_64-linux.tar.xz
            cp wasmtime-$VERSION-x86_64-linux/wasmtime ~/vms
      - run:
          name: get wasi-sdk-sysroot
          command: |
            wget https://github.com/WebAssembly/wasi-sdk/releases/download/wasi-sdk-11/libclang_rt.builtins-wasm32-wasi-11.0.tar.gz
            wget https://github.com/WebAssembly/wasi-sdk/releases/download/wasi-sdk-11/wasi-sysroot-11.0.tar.gz
            mkdir ~/wasi-sdk
            tar xvf libclang_rt.builtins-wasm32-wasi-11.0.tar.gz -C ~/wasi-sdk
            tar xvf wasi-sysroot-11.0.tar.gz -C ~/wasi-sdk/
      - install-v8
      - install-emsdk
      - when:
          condition:
            not:
              equal: [ "main", << pipeline.git.branch >> ]
          steps:
            - restore_cache:
                name: "Restore Ccache cache"
                key: clang-{{ checksum "~/emsdk/clang_version.txt" }}
      - run:
          name: Configure ccache
          command: |
            mkdir -p ~/.ccache
            cat .circleci/ccache.conf
            cp .circleci/ccache.conf ~/.ccache
      - build-libs
      - run:
          name: Clean build directory
          command: rm -rf ~/cache/build
      - persist
  # Perhaps we don't need to run this suite with every commit. Consider moving this to FYI bot.
  test-posixtest:
    executor: ubuntu-lts
    steps:
      - run-tests-linux:
          test_targets: "posixtest"
  test-core0:
    executor: ubuntu-lts
    environment:
      EMTEST_SKIP_NODE_25: "1"
    steps:
      - run-tests-linux:
          test_targets: "core0"
  test-core2:
    executor: ubuntu-lts
    environment:
      EMTEST_BROWSER: "node"
      EMTEST_SKIP_NODE_25: "1"
    steps:
      - run-tests-linux:
          # also run a few asan tests.  Run these with frozen_cache disabled
          # since we don't pre-build all the asan libraries.
          frozen_cache: false
          title: "asan+lsan"
          test_targets: "
            asan.test_stat
            asan.test_stack
            asan.test_float_builtins
            asan.test_embind*
            asan.test_abort_on_exceptions
            asan.test_ubsan_full_left_shift_fsanitize_integer
            asan.test_pthread*
            asan.test_dyncall_specific_minimal_runtime
            asan.test_async_hello
            asan.test_dlfcn_basic
            asan.test_async_hello_jspi
            asan.test_cubescript
            asan.test_externref_emjs_dynlink
            asan.test_asyncify_longjmp
            asan.test_pthread_run_on_main_thread
            asan.test_minimal_runtime_global_initializer
            asan.test_fs_js_api_wasmfs
            asan.test_modularize_instance_pthreads
            asan.test_minimal_runtime_hello_world
            asan.test_select_blocking
            asan.test_ppoll_blocking
            lsan.test_dylink_dso_needed
            lsan.test_stdio_locking
            lsan.test_dlfcn_basic
            lsan.test_pthread_create
            lsan.test_pthread_exit_main_stub
            lsan.test_dylink_iostream
            lsan.test_embind_lib_with_asyncify
            ubsan.test_dlfcn_self
            ubsan.test_externref_emjs_dynlink"
      - freeze-cache
      - run-tests:
          # also run a single test of EMTEST_BROWSER=node.
          # also run a corez test of dynamic linking + forced syslibs.
          title: "core2+extras"
          test_targets: "
            core2
            browser.test_pthread_join
            corez.test_dylink_syslibs_all"
      - upload-test-results
  test-core3:
    executor: ubuntu-lts
    environment:
      EMTEST_SKIP_NODE_25: "1"
    steps:
      - run-tests-linux:
          frozen_cache: false
          # also add a little select testing for wasm2js in -O3
          # also add a little select wasmfs testing
          title: "core3+extras"
          test_targets: "
            lto2.test_dylink_syslibs_all
            lto2.test_float_builtins
            lto2.test_avx_nontrapping
            lto0.test_exceptions_allowed_uncaught
            lto0.test_longjmp_standalone_standalone
            lto0.test_embind_i64_val
            lto0.test_wasm_worker_futex_wait
            thinlto0.test_pthread_dlsym
            core3
            core2g.test_externref
            corez.test_dylink_iostream
            core2ss.test_pthread_dylink
            core2ss.test_pthread_dylink_tls
            core2ss.test_pthread_thread_local_storage
            core2ss.test_wasm_worker_futex_wait
            core2s.test_dylink_syslibs_missing_assertions
            core2s.test_module_wasm_memory
            cores.test_minimal_runtime_safe_heap
            wasm2js0.test_autodebug_wasm
            wasm2js3.test_memorygrowth_2
            wasm2js2.test_pthread_proxying
            wasmfs.test_hello_world
            wasmfs.test_pipe_select
            wasmfs.test_unistd_links*
            wasmfs.test_atexit_standalone
            wasmfs.test_emscripten_get_now
            wasmfs.test_dyncall_specific_minimal_runtime
            wasmfs.test_fcntl_misc
            wasmfs.test_readdir_rawfs
            wasmfs.test_utime
            wasmfs.test_unistd_unlink
            wasmfs.test_unistd_dup
            wasmfs.test_unistd_access
            wasmfs.test_unistd_close
            wasmfs.test_unistd_truncate
            wasmfs.test_readdir
            wasmfs.test_readdir_unlink
            wasmfs.test_unistd_pipe
            wasmfs.test_unistd_io
            wasmfs.test_unistd_curdir
            wasmfs.test_poll
            wasmfs.test_fs_64bit
            wasmfs.test_fs_write
            wasmfs.test_fs_writev
            wasmfs.test_fs_writev_rawfs
            wasmfs.test_fs_readv
            wasmfs.test_fs_write
            wasmfs.test_fs_readv_rawfs
            wasmfs.test_fs_nodefs_nofollow
            wasmfs.test_fs_nodefs_readdir
            wasmfs.test_fs_nodefs_home
            wasmfs.test_fs_nodefs_cloexec
            wasmfs.test_fs_nodefs_cloexec_rawfs
            wasmfs.test_fs_errorstack
            wasmfs.test_fs_errorstack_rawfs
            wasmfs.test_fs_emptyPath
            wasmfs.test_webidl
            wasmfs.test_dlfcn_self
            wasmfs.test_dlfcn_unique_sig
            wasmfs.test_dylink_basics
            wasmfs.test_exit_status
            wasmfs.test_minimal_runtime_memorygrowth
            wasmfs.test_mmap_anon*
            wasmfs.test_mount
            wasmfs.test_getcwd_with_non_ascii_name
            wasmfs.test_stat
            wasmfs.test_fstatat
            wasmfs.test_futimens
            wasmfs.test_unistd_links
            wasmfs.test_fcntl_open
            wasmfs.test_fs_llseek
            wasmfs.test_fs_llseek_rawfs
            wasmfs.test_freetype
            wasmfs.test_unistd_close_rawfs
            wasmfs.test_exceptions_minimal_runtime
            wasmfs.test_minimal_runtime_safe_heap
            wasmfs.test_minimal_runtime_global_initializer
            wasmfs.test_minimal_runtime_hello_world*
            wasmfs.test_dlmalloc
            minimal0.test_utf
            minimal0.test_ubsan_full_stack_trace_gsource_map
            minimal0.test_static_variable
            minimal0.test_stack_overflow
            omitexports0.test_asyncify_longjmp
            omitexports0.test_emscripten_api
            strict.test_no_declare_asm_module_exports
            strict.test_dylink_global_inits_reversed
            strict.test_wasm_worker_futex_wait_pthreads
            "
  test-modularize-instance:
    executor: ubuntu-lts
    environment:
      EMTEST_SKIP_NODE_25: "1"
    steps:
      - run-tests-linux:
          test_targets: "instance"
  test-stress:
    executor: ubuntu-lts
    environment:
      EMTEST_SKIP_NODE_25: "1"
    steps:
      - run-tests-linux:
          test_targets: "stress"
  test-esm-integration:
    executor: ubuntu-lts
    steps:
      - prepare-for-tests
      - install-node-newest
      - run-tests:
          title: "esm_integration"
          test_targets: "esm_integration"
      - upload-test-results
  test-wasm2js1:
    environment:
      EMTEST_SKIP_NODE_25: "1"
    executor: ubuntu-lts
    steps:
      - run-tests-linux:
          test_targets: "wasm2js1"
  test-wasm64-4gb:
    environment:
      LANG: "C.UTF-8"
    executor: ubuntu-lts
    steps:
      - prepare-for-tests
      - install-node-newest
      # When running wasm64 tests we need to make sure we use the latest
      # version of node when running the compiler output (e.g. in configure
      # tests).
      - run:
          name: configure node (newest)
          command: echo "NODE_JS = NODE_JS_TEST" >> ~/emsdk/.emscripten
      - run-tests:
          title: "wasm64_4gb"
          test_targets: "wasm64_4gb"
      - upload-test-results
  test-wasm64-misc:
    environment:
      LANG: "C.UTF-8"
    executor: ubuntu-lts
    steps:
      - prepare-for-tests
      - install-node-newest
      # When running wasm64 tests we need to make sure we use the latest
      # version of node when running the compiler output (e.g. in configure
      # tests).
      - run:
          name: configure node (newest)
          command: echo "NODE_JS = NODE_JS_TEST" >> ~/emsdk/.emscripten
      - run-tests:
          title: "wasm64"
          test_targets: "
            other.*_wasm64*
            core_2gb.test_*em_asm*
            core_2gb.test_*embind*
            core_2gb.test_fs_js_api_wasmfs
            wasm64.test_safe_stack
            wasm64.test_promise_await*
            wasm64.test_pthread_join_and_asyncify
            wasm64l.test_hello_world
            wasm64l.test_bigswitch
            wasm64l.test_module_wasm_memory
            wasm64l.test_longjmp2_emscripten
            wasm64l.test_embind_val_basics_legacy"
      - upload-test-results
  test-bun:
    executor: ubuntu-lts
    environment:
      EMTEST_SKIP_NEW_CMAKE: "1"
      EMTEST_SKIP_WASM64: "1"
    steps:
      - checkout
      - pip-install
      - install-emsdk
      - run:
          name: install bun
          command: |
            curl -fsSL https://bun.com/install | bash
            echo "BUN = os.path.expanduser('~/.bun/bin/bun')" >> ~/emsdk/.emscripten
            echo "JS_ENGINES = [BUN]" >> ~/emsdk/.emscripten
      - run-tests:
          test_targets: "--crossplatform-only"
  test-deno:
    executor: ubuntu-lts
    environment:
      EMTEST_SKIP_NEW_CMAKE: "1"
    steps:
      - checkout
      - pip-install
      - install-emsdk
      - run:
          name: install deno
          command: |
            curl -fsSL https://deno.land/install.sh | sh
            echo "DENO = os.path.expanduser('~/.deno/bin/deno')" >> ~/emsdk/.emscripten
            echo "JS_ENGINES = [DENO]" >> ~/emsdk/.emscripten
      - run-tests:
          test_targets: "--crossplatform-only"
  test-jsc:
    executor: ubuntu-lts
    steps:
      - checkout
      - pip-install
      - install-emsdk
      - run:
          name: install jsc
          command: |
            cd $HOME
            wget https://nodejs.org/dist/v18.12.0/node-v18.12.0-linux-x64.tar.xz
            tar -xf node-v18.12.0-linux-x64.tar.xz
            export PATH="`pwd`/node-v18.12.0-linux-x64/bin:${PATH}"
            npm install jsvu -g
            jsvu --os=default --engines=javascriptcore
            echo "JSC_ENGINE = [os.path.expanduser('~/.jsvu/bin/javascriptcore')]" >> ~/emsdk/.emscripten
            echo "JS_ENGINES = [JSC_ENGINE]" >> ~/emsdk/.emscripten
      - run-tests:
          test_targets: "
            core0.test_hello_argc
            other.test_modularize_incoming
            other.test_modularize_incoming_export_name"
  test-spidermonkey:
    executor: ubuntu-lts
    steps:
      - checkout
      - pip-install
      - install-emsdk
      - run:
          name: install spidermonkey
          command: |
            cd $HOME
            wget https://nodejs.org/dist/v18.12.0/node-v18.12.0-linux-x64.tar.xz
            tar -xf node-v18.12.0-linux-x64.tar.xz
            export PATH="`pwd`/node-v18.12.0-linux-x64/bin:${PATH}"
            npm install jsvu -g
            jsvu --os=default --engines=spidermonkey
            echo "SPIDERMONKEY_ENGINE = [os.path.expanduser('~/.jsvu/bin/spidermonkey')]" >> ~/emsdk/.emscripten
            echo "JS_ENGINES = [SPIDERMONKEY_ENGINE]" >> ~/emsdk/.emscripten
      - run-tests:
          test_targets: "
            other.test_prepost_jspi
            other.test_stdint_limits_wasm64
            core0.test_hello_argc
            core2.test_demangle_stacks_symbol_map"
      - upload-test-results
  test-node-compat:
    executor: ubuntu-lts
    environment:
      LANG: "C.UTF-8"
      EMTEST_SKIP_V8: "1"
    steps:
      - checkout
      - pip-install
      - install-emsdk
      # `install-node-version` only changes the NODE_JS_TEST (the version of
      # node used to run test), not NODE_JS (the version of node used to run the
      # compiler itself).
      # In order to test that the compiler itself can run under the oldest
      # supported version of node, we run all the tests in the runner under that
      # version.
      # Keep this in sync with MINIMUM_NODE_VERSION in tools/shared.py.
      - install-node-version:
          node_version: "18.3.0"
      - run:
          name: configure compiler to use 18.3.0
          command: echo "NODE_JS = '$(which node)'" >> ~/emsdk/.emscripten
      # Run some basic tests with the minimum version of node that we currently
      # support in the generated code.
      - install-node-oldest
      - run-tests:
          title: "node (oldest / 18.3.0)"
          # We include most but not all of the nodefs and node rawfs tests here.
          # test_fs_nodefs_rw, test_fs_nodefs_statvfs, and test_unistd_io_nodefs_bigint fail.
          test_targets: "
            other.test_embind_tsgen_remove_relaxed_simd
            other.test_gen_struct_info
            other.test_native_call_before_init
            other.test_js_optimizer_verbose
            other.test_file_packager_separate_metadata
            other.test_full_js_library*
            core2.test_hello_world
            core2.test_fcntl_open_nodefs
            core2.test_fcntl_open_rawfs
            core2.test_fgetc_ungetc_nodefs
            core2.test_fgetc_ungetc_rawfs
            core2.test_fs_append_rawfs
            core2.test_fs_emptyPath_rawfs
            core2.test_fs_enotdir_nodefs
            core2.test_fs_enotdir_rawfs
            core2.test_fs_errorstack_rawfs
            core2.test_fs_llseek_rawfs
            core2.test_fs_mkdir_dotdot_nodefs
            core2.test_fs_mkdir_dotdot_rawfs
            core2.test_fs_mmap_nodefs
            core2.test_fs_mmap_rawfs
            core2.test_fs_nodefs_cloexec
            core2.test_fs_nodefs_cloexec_rawfs
            core2.test_fs_nodefs_dup
            core2.test_fs_nodefs_dup_rawfs
            core2.test_fs_nodefs_home
            core2.test_fs_nodefs_nofollow
            core2.test_fs_nodefs_readdir
            core2.test_fs_noderawfs_nofollow
            core2.test_fs_readdir_ino_matches_stat_ino_nodefs
            core2.test_fs_readdir_ino_matches_stat_ino_rawfs
            core2.test_fs_readv_rawfs
            core2.test_fs_rename_on_existing_nodefs
            core2.test_fs_rename_on_existing_rawfs
            core2.test_fs_symlink_resolution_nodefs
            core2.test_fs_symlink_resolution_rawfs
            core2.test_fs_writeFile*
            core2.test_fs_write_rawfs
            core2.test_fs_writev_rawfs
            core2.test_futimens_rawfs
            core2.test_readdir_rawfs
            core2.test_stat_chmod_rawfs
            core2.test_unistd_access_nodefs
            core2.test_unistd_access_rawfs
            core2.test_unistd_close_rawfs
            core2.test_unistd_dup_rawfs
            core2.test_unistd_io_nodefs
            core2.test_unistd_links_nodefs
            core2.test_unistd_misc_nodefs
            core2.test_unistd_pipe_rawfs
            core2.test_unistd_symlink_on_nodefs
            core2.test_unistd_truncate_nodefs
            core2.test_unistd_truncate_rawfs
            core2.test_unistd_unlink_nodefs
            core2.test_unistd_unlink_rawfs
            core2.test_unistd_write_broken_link_rawfs
            "
      # Run a few test with the most recent LTS version of node
      - install-node-lts
      - run-tests:
          # Run tests that on older versions of node would require flags, but
          # those flags should not be injected on newer versions.
          title: "node (lts)"
          test_targets: "-v
            other.test_gen_struct_info
            other.test_native_call_before_init
            other.test_js_optimizer_verbose
            other.test_min_node_version
            other.test_node_emscripten_num_logical_cores
            other.test_exceptions_stack_trace*
            other.test_exceptions_rethrow_stack_trace*
            core2.test_pthread_create
            core2.test_i64_invoke_bigint
            core2.test_sse2
            core2.test_source_map
            core2.test_exceptions_wasm_legacy
            core2.test_pthread_unhandledrejection
            "
      # Run a few test with the most recent version of node
      - install-node-newest
      - run-tests:
          # Run tests that on older versions of node would require flags, but
          # those flags should not be injected on newer versions.
          title: "node (newest)"
          test_targets: "-v
            other.test_deterministic
            other.test_gen_struct_info
            other.test_native_call_before_init
            other.test_*growable_arraybuffers
            other.test_add_js_function_bigint_memory64
            other.test_js_optimizer_verbose
            other.test_min_node_version
            other.test_node_emscripten_num_logical_cores
            other.test_js_base64_api
            other.test_pthread_growth*
            other.test_memory_growth
            core2.test_hello_world
            core2.test_pthread_create
            core2.test_i64_invoke_bigint
            core2.test_sse2
            core2.test_source_map
            core2.test_exceptions_wasm_legacy
            core2.test_pthread_unhandledrejection
            core2.test_esm_integration*
            core0.test_esm_integration*
            core0.test_pthread_join_and_asyncify
            core0.test_async_ccall_promise_jspi*
            core0.test_cubescript_jspi
            core0.test_pthread_wait_suspending*
            core0.test_poll_blocking_asyncify_jspi
            core0.test_promise_await*
            "
      - upload-test-results
  test-other:
    executor: ubuntu-lts
    environment:
      EMTEST_SKIP_NODE_25: "1"
      EMTEST_SKIP_RUST: "1"
      EMTEST_SKIP_WASM64: "1"
      EMTEST_SKIP_NEW_CMAKE: "1"
    steps:
      - install-rust
      - run: apt-get install -q -y ninja-build scons ccache
      - run-tests-linux:
          # some native-dependent tests fail because of the lack of native
          # headers on emsdk-bundled clang
          test_targets: "other jslib skip:other.test_native_link_error_message"
      - run-tests-linux:
          # Include a single test from test_benchmark.py to ensure it's always
          # kept functional. Must be run separately from above because we cannot
          # run non-parallel tests in the same run as parallel tests.
          test_targets: "benchmark.test_primes"
  test-browser-chrome:
    executor: ubuntu-lts
    environment:
      EMTEST_LACKS_WEBGPU: "1"
    steps:
      - checkout
      - pip-install
      - install-emsdk
      - run-tests-chrome:
          title: "browser"
          # Just tests that don't run in browser 2G mode
          test_targets: "
            browser.test_gl_stride
            browser.test_memory_growth_during_startup
            browser.test_pthread_memgrowth_stale_views
            browser.test_pthread_large_pthread_allocation
            browser.test_pthread_sbrk*
            browser.test_pthread_asan*
            browser.test_webgl_multi_draw*
            browser.test_pthread_growth*
            browser.test_4gb
            browser.test_emmalloc_3gb*
            browser.test_dlmalloc_3gb
            browser.test_2gb_fail
            browser.test_audio_worklet*
            "
  test-browser-chrome-wasm64:
    executor: ubuntu-lts
    environment:
      EMTEST_LACKS_WEBGPU: "1"
      EMTEST_VISUALIZE: "1"
    steps:
      - run-tests-chrome:
          title: "browser64"
          # Just tests that don't run in browser64 4G mode
          # TODO: restore this coverage (and the corresponding wasm64) and/or
          # make this exclusion list a bit more automatic.
          test_targets: "
            browser64.test_emscripten_animate_canvas_element_size*
            browser64.test_*malloc_*gb*
            browser64.test_emmalloc_memgrowth
            browser64.test_subdata_es2*
            browser64.test_webgl2_garbage_free_entrypoints*
            browser64.test_gl_stride
            browser64.test_webgl2_get_buffer_sub_data
            browser64.test_webgl2_pbo
            browser64.test_webgl2_sokol*
            browser64.test_memory_growth_during_startup
            browser64.test_pthread_large_pthread_allocation
            browser64.test_pthread_sbrk*
            browser64.test_pthread_asan*
            browser64.test_webgl_multi_draw*
            browser64.test_pthread_growth*"
      - run:
          name: Check profile
          command: file -E out/graph.html
  test-browser-chrome-2gb:
    executor: ubuntu-lts
    environment:
      EMTEST_LACKS_WEBGPU: "1"
    steps:
      - run-tests-chrome:
          title: "browser_2gb"
          # Disabling test_mainScriptUrlOrBlob due to
          # https://github.com/emscripten-core/emscripten/issues/26882
          test_targets: "browser_2gb skip:browser_2gb.test_mainScriptUrlOrBlob*"
  test-browser-chrome-wasm64-4gb:
    executor: ubuntu-lts
    environment:
      EMTEST_LACKS_WEBGPU: "1"
    steps:
      - run-tests-chrome:
          title: "browser64_4gb"
          # Disabling test_mainScriptUrlOrBlob due to
          # https://github.com/emscripten-core/emscripten/issues/26882
          test_targets: "browser64_4gb skip:browser64_4gb.test_mainScriptUrlOrBlob*"
  test-browser-firefox:
    executor: ubuntu-lts
    environment:
      # Deserializing a growable SharedArrayBuffer is currently broken in Firefox.
      # See: https://github.com/emscripten-core/emscripten/issues/27118
      # See: https://bugzilla.mozilla.org/show_bug.cgi?id=2021136
      EMTEST_LACKS_GROWABLE_ARRAYBUFFERS: "1"
    steps:
      - prepare-for-tests
      - run-tests-firefox:
          title: "browser"
          # browser.test_sdl2_mouse and/or SDL2 should be fixed. The case happens
          # to be failing here, and the root cause might be related with the
          # initial position of the mouse pointer relative to the canvas.
          # browser.test_html5_webgl_create_context is skipped because
          # anti-aliasing is not well supported.
          test_targets: "
            browser
            skip:browser.test_sdl2_mouse
            skip:browser.test_html5_webgl_create_context
            skip:browser.test_glut_glutget
            "
  test-browser-firefox-wasm64:
    executor: ubuntu-lts
    steps:
      - checkout
      - pip-install
      - install-emsdk
      - run-tests-firefox:
          title: "browser64"
          test_targets: "
            browser64.test_sdl_image
            browser64.test_dylink_many
            "
  test-windows-browser-firefox:
    # Use spaces and other special chars in the path to emsdk to flush out
    # issues with windows.  In particular, the .bat file launchers can have
    # trouble with these.
    working_directory: "~/path with spaces ()/"
    executor:
      name: win/server-2019
      shell: bash.exe -eo pipefail
    environment:
      PYTHONUNBUFFERED: "1"
      EMSDK_NOTTY: "1"
    steps:
      - checkout
      - run:
          name: Install packages
          command: |
            choco install -y cmake.portable ninja pkgconfiglite
      - install-emsdk
      - pip-install:
          python: "$EMSDK_PYTHON"
      - run-tests-firefox:
          title: "browser on firefox on windows"
          # skip browser.test_glbook, as it requires mingw32-make, which is not
          # installed on CircleCI.
          # skip browser.test_sdl2_mixer_wav_dash_l, fails to build on Windows
          # on CircleCI (works locally)
          #
          # For now, just run a small subset of tests that are know to work.
          # TODO: Include more tests here.
          test_targets: "
            browser.test_sdl_image
            browser.test_dylink_many
            skip:browser.test_glbook
            skip:browser.test_sdl2_mixer_wav_dash_l
            "
  test-browser-chrome-emrun:
    executor: ubuntu-lts
    steps:
      - checkout
      - pip-install
      - install-emsdk
      - run-tests-chrome:
          test_targets: "emrun"
  test-sockets-chrome:
    executor: ubuntu-lts
    steps:
      - test-sockets-chrome

  build-windows-launcher:
    executor:
      name: win/server-2022
      shell: bash.exe -eo pipefail
    steps:
      - checkout
      - run:
          name: "build pylauncher"
          shell: cmd.exe
          command: .circleci\setup_vs2022.bat && cd tools\pylauncher && call build.bat
      - store_artifacts:
          path: tools/pylauncher/pylauncher.exe
          destination: pylauncher.exe
      - install-emsdk
      - pip-install:
          python: "$EMSDK_PYTHON"
      - run:
          name: "create_entry_points"
          command: $EMSDK_PYTHON tools/maint/create_entry_points.py --exe-files
      - run:
          name: "crossplatform tests"
          command: test/runner.exe core0.test_hello_world


  # windows and mac do not have separate build and test jobs, as they only run
  # a limited set of tests; it is simpler and faster to do it all in one job.
  test-windows:
    # Use spaces and other special chars in the path to emsdk to flush out
    # issues with windows.  In particular, the .bat file launchers can have
    # trouble with these.
    working_directory: "~/path with spaces ()/"
    executor:
      name: win/server-2019
      shell: bash.exe -eo pipefail
    environment:
      PYTHONUNBUFFERED: "1"
      EMSDK_NOTTY: "1"
      # clang can compile but not link in the current setup, see
      # https://github.com/emscripten-core/emscripten/pull/11382#pullrequestreview-428902638
      EMTEST_LACKS_NATIVE_CLANG: "1"
      EMTEST_SKIP_V8: "1"
      EMTEST_SKIP_WASM_LEGACY_EH: "1"
      EMTEST_SKIP_WASM_EH: "1"
      EMTEST_SKIP_WASM64: "1"
      EMTEST_SKIP_SCONS: "1"
      EMTEST_SKIP_RUST: "1"
      EMTEST_SKIP_NODE_25: "1"
      EMTEST_BROWSER: "0"
    steps:
      - checkout
      - run:
          name: Build launcher
          command: call .circleci\setup_vs2019.bat && cd tools\pylauncher && call build.bat
          shell: cmd.exe
      - run:
          name: Install packages
          command: |
            choco install -y cmake.portable ninja pkgconfiglite
      # note we do *not* build all libraries and freeze the cache; as we run
      # only limited tests here, it's more efficient to build on demand
      - install-emsdk
      - pip-install:
          python: "$EMSDK_PYTHON"
      - run:
          name: "crossplatform tests"
          command: test/runner --crossplatform-only
      - upload-test-results
      # Run a single websockify-based test to ensure it works on windows.
      - run:
          name: "sockets.test_nodejs_sockets_echo*"
          command: "test/runner sockets.test_nodejs_sockets_echo*"
      - upload-test-results
      - run:
          name: "check clean"
          command: |
            git checkout tools/pylauncher
            $EMSDK_PYTHON test/check_clean.py

  test-mac-arm64:
    executor: mac-arm64
    environment:
      # We don't install d8 or modern node on the mac runner so we skip any
      # tests that depend on those.
      EMTEST_SKIP_V8: "1"
      EMTEST_SKIP_WASM_LEGACY_EH: "1"
      EMTEST_SKIP_WASM_EH: "1"
      EMTEST_SKIP_WASM64: "1"
      EMTEST_SKIP_SCONS: "1"
      EMTEST_SKIP_RUST: "1"
      # Some native clang tests assume x86 clang (e.g. -sse2)
      EMTEST_LACKS_NATIVE_CLANG: "1"
      EMCC_SKIP_SANITY_CHECK: "1"
    steps:
      - setup-macos
      - install-emsdk
      - pip-install:
          python: "$EMSDK_PYTHON"
      - freeze-cache
      - run-tests:
          title: "crossplatform tests"
          test_targets: "--crossplatform-only"
      - upload-test-results

workflows:
  build-test:
    jobs:
      - ruff
      - mypy
      - vulture
      - eslint
      - build-docs
      - build-linux
      - test-sanity:
          requires:
            - build-linux
      - test-posixtest:
          requires:
            - build-linux
      - test-core0:
          requires:
            - build-linux
      - test-core2:
         requires:
           - build-linux
      - test-core3:
          requires:
            - build-linux
      - test-wasm64-misc:
          requires:
            - build-linux
      - test-wasm64-4gb:
          requires:
            - build-linux
      - test-wasm2js1:
          requires:
            - build-linux
      - test-other:
          requires:
            - build-linux
      - test-modularize-instance:
          requires:
            - build-linux
      - test-esm-integration:
         requires:
           - build-linux
      - test-stress:
          requires:
            - build-linux
      - test-browser-chrome
      - test-browser-chrome-emrun
      - test-browser-chrome-2gb:
          requires:
            - build-linux
      - test-browser-chrome-wasm64:
          requires:
            - build-linux
      - test-browser-chrome-wasm64-4gb:
          requires:
            - build-linux
      - test-browser-firefox:
          requires:
            - build-linux
      - test-browser-firefox-wasm64
      - test-sockets-chrome:
          requires:
            - build-linux
      - test-bun
      - test-deno
      - test-jsc
      - test-spidermonkey
      - test-node-compat
      - test-windows
      - test-windows-browser-firefox
      - build-windows-launcher
      - test-mac-arm64:
         requires:
           - build-linux