Emscripten: An LLVM-to-JavaScript Compiler
Перейти к файлу
Sam Clegg 26a8fd13fd
circleci: macOS: don't try to brew install packages that are already installed (#14069)
It seems that circleci recently started pre-installing python3 which
broke our CI with:

```
Error: python@3.9 3.9.0_1 is already installed
To upgrade to 3.9.4, run:
  brew upgrade python@3.9
```

This is kind of shame that brew can't just handle this case cleanly.  I
chose this approach over the `brew bundle` because it seemed a little
simple to me (someone who doesn't know brew or brew bundle).

See https://apple.stackexchange.com/questions/284379/with-homebrew-how-to-check-if-a-software-package-is-installed
See https://github.com/Homebrew/brew/issues/2491
2021-05-01 10:04:12 -07:00
.circleci circleci: macOS: don't try to brew install packages that are already installed (#14069) 2021-05-01 10:04:12 -07:00
.github Switch primary git branch from `master` to `main` (#13624) 2021-03-08 15:51:21 -08:00
cmake/Modules Update Emscripten.cmake to support C++20 (#13616) 2021-03-07 12:37:56 -08:00
docs Mark EMMAKEN_NO_SDK as deprecated. (#14051) 2021-04-29 15:22:46 -07:00
media Remove artifacts from Emscripten_logo_full, added single logo svg/png (#13790) 2021-03-30 16:08:55 -07:00
site Update SIMD instruction names (#14057) 2021-04-30 12:31:38 -07:00
src Use `asmLibraryArg` when resolving symbols dynamically (#13949) 2021-04-30 04:05:18 +02:00
system Update SIMD instruction names (#14057) 2021-04-30 12:31:38 -07:00
tests Update SIMD instruction names (#14057) 2021-04-30 12:31:38 -07:00
third_party Use third_party leb128 implementation. NFC (#13833) 2021-04-07 19:46:03 -07:00
tools Fix a couple of spelling errors. NFC. (#14059) 2021-04-29 19:32:41 -07:00
.clang-format Add .clang-format file (copied from binaryen) (#7164) 2018-09-21 11:12:41 -07:00
.coveragerc Bring emcoverage tool back to life. NFC (#13598) 2021-03-04 10:48:02 -08:00
.editorconfig Add .editorconfig (#8359) 2019-03-28 09:52:16 -07:00
.eslintrc.yml Add eslint for linting our build-time JS code (#13305) 2021-01-26 12:58:39 -08:00
.flake8 Fix flake8 warnings in webidl_binder.py. NFC (#13823) 2021-04-06 12:03:49 -07:00
.gitattributes Fix typo in .gitattributes (#11060) 2020-05-01 16:18:49 -07:00
.gitignore Bring emcoverage tool back to life. NFC (#13598) 2021-03-04 10:48:02 -08:00
.gitmodules Update posixtestsuite submodule (#13013) 2020-12-11 13:24:29 -08:00
.style.yapf Add .style.yapf for the YAPF python formatter (#6782) 2018-06-29 17:25:55 -07:00
AUTHORS Update list of supported extensions (#14043) 2021-04-29 10:34:34 -07:00
CONTRIBUTING.md Link to emscripten.org for contributing info. (#10612) 2020-03-02 13:43:34 -08:00
ChangeLog.md Restore support for --cache command line flag (#13954) 2021-04-27 13:09:40 +03:00
LICENSE mention third_party in LICENSE 2016-04-13 11:06:10 -07:00
Makefile Run npm install as part of the install (#12899) 2020-12-05 08:17:25 -08:00
README.md Switch primary git branch from `master` to `main` (#13624) 2021-03-08 15:51:21 -08:00
em++ Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
em++.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
em++.py Add option to not default for C++ (which matches clang/gcc behaviour) (#10879) 2020-04-10 19:49:48 -07:00
em-config Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
em-config.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
em-config.py Split config file handling out of shared.py. NFC. (#12699) 2020-11-09 08:06:33 -08:00
emar Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emar.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emar.py Reinstate --cache flag in its original form (#14039) 2021-04-28 13:57:30 -07:00
embuilder Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
embuilder.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
embuilder.py Declare setting object in settings.py (#13918) 2021-04-16 13:01:28 -07:00
emcc Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emcc.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emcc.py Fix a couple of spelling errors. NFC. (#14059) 2021-04-29 19:32:41 -07:00
emcmake Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emcmake.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emcmake.py Move cmake/configure/make code out of shared.py and into the scripts themselves. NFC. (#13772) 2021-03-25 23:38:25 +01:00
emconfigure Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emconfigure.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emconfigure.py Move cmake/configure/make code out of shared.py and into the scripts themselves. NFC. (#13772) 2021-03-25 23:38:25 +01:00
emdump Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emdump.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emmake Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emmake.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emmake.py Fix windows-only typo in emmake.py (#13813) 2021-04-05 16:26:28 -07:00
emprofile Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emprofile.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emranlib Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emranlib.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emranlib.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
emrun Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emrun.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emrun.py Partially revert commit that broke using emrun.py outside the tree (#13412) 2021-03-16 19:54:26 +02:00
emscons Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emscons.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emscons.py Switch the #! lines in all .py files to python3 (#10357) 2020-02-05 15:27:36 -08:00
emscripten-version.txt 2.0.18 (#13990) 2021-04-23 18:57:02 -07:00
emscripten.py Improve undefined symbol reporting. NFC (#14022) 2021-04-27 09:55:15 -07:00
emsize Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emsize.bat Add "do not edit" message to python entry points. NFC (#13731) 2021-03-22 11:43:02 -07:00
emsize.py Remove python2 support. NFC. (#12610) 2020-10-28 15:32:49 -07:00
package-lock.json Add eslint for linting our build-time JS code (#13305) 2021-01-26 12:58:39 -08:00
package.json Add eslint for linting our build-time JS code (#13305) 2021-01-26 12:58:39 -08:00
requirements-dev.txt Update flake8. NFC. (#13761) 2021-03-24 11:39:28 -07:00

README.md

emscripten logo

Main project page: https://emscripten.org

GitHub CI status: CircleCI

Chromium builder status: emscripten-releases

Overview

Emscripten compiles C and C++ to WebAssembly using LLVM and Binaryen. Emscripten output can run on the Web, in Node.js, and in wasm runtimes.

Emscripten provides Web support for popular portable APIs such as OpenGL and SDL2, allowing complex graphical native applications to be ported, such as the Unity game engine and Google Earth. It can probably port your codebase, too!

While Emscripten mostly focuses on compiling C and C++ using Clang, it can be integrated with other LLVM-using compilers (for example, Rust has Emscripten integration, with the wasm32-unknown-emscripten and asmjs-unknown-emscripten targets).

License

Emscripten is available under 2 licenses, the MIT license and the University of Illinois/NCSA Open Source License.

Both are permissive open source licenses, with little if any practical difference between them.

The reason for offering both is that (1) the MIT license is well-known and suitable for a compiler toolchain, while (2) LLVM's original license, the University of Illinois/NCSA Open Source License, was also offered to allow Emscripten's code to be integrated upstream into LLVM. The second reason became less important after Emscripten switched to the LLVM wasm backend, at which point there isn't any code we expect to move back and forth between the projects; also, LLVM relicensed to Apache 2.0 + exceptions meanwhile. In practice you can just consider Emscripten as MIT licensed (which allows you to do pretty much anything you want with a compiler, including commercial and non-commercial use).

See LICENSE for the full content of the licenses.