A JavaScript bundle optimizer.
Clone or download
Sapan Bhatia and facebook-github-bot Optionally remove optimized module factory functions (#2602)
Summary:
When module factory functions optimized by Prepack are reachable from the global code, they are residualized, even though there is an implicit contract that they will not be used. This PR implements an option to remove them. This is a short-term fix, and may be refined in the future and generalized to be more flexible.

Test cases coming up.
Pull Request resolved: #2602

Differential Revision: D10402515

Pulled By: sb98052

fbshipit-source-id: 7ad3a84a754e4347774e0e95df197c2348f9d332
Latest commit 2954b93 Oct 16, 2018
Permalink
Failed to load latest commit information.
.circleci Re-land typed descriptors and printer (#2511) Aug 31, 2018
assets Adding raw Prepack Logo assets (#2189) Jul 3, 2018
bin Cleanup files Dec 12, 2017
fb-www Make React tests fast (#2187) Jul 2, 2018
flow-libs Set up adapter communication channel with Prepack Oct 27, 2017
flow-typed/npm Substitute `v8-profiler` with `v8-profiler-node8` (#2525) Sep 7, 2018
fuzzer Fuzzer (#2374) Aug 9, 2018
scripts Optionally remove optimized module factory functions (#2602) Oct 16, 2018
src Optionally remove optimized module factory functions (#2602) Oct 16, 2018
test Optionally remove optimized module factory functions (#2602) Oct 16, 2018
website Website code and warnings (#2528) Sep 17, 2018
.eslintignore Upgrade Prepack to Babel 7 (#2256) Jul 14, 2018
.eslintrc Prettier 1.13.4 fixes Jun 6, 2018
.flowconfig Use Flow server for local development (#2245) Jul 18, 2018
.gitignore Ignore project node_modules Aug 8, 2018
.gitmodules Initial commit Mar 29, 2017
.prettierrc Run Prettier checks on CI (#2212) Jul 10, 2018
.watchmanconfig Add React functional component folding Nov 6, 2017
CODE_OF_CONDUCT.md Updated the code of conduct links. (#2284) Jul 18, 2018
CONTRIBUTING.md Updated the code of conduct links. (#2284) Jul 18, 2018
LICENSE Initial commit Mar 29, 2017
PATENTS Initial commit Mar 29, 2017
README.md Adding raw Prepack Logo assets (#2189) Jul 3, 2018
babel.config.js Add serializer mode for test262 execution (#2290) Jul 19, 2018
package.json New weekly branch: 0.2.55-alpha.0 Oct 4, 2018
webpack.config.js Upgrade Prepack to Babel 7 (#2256) Jul 14, 2018
yarn.lock Bump flow version (#2557) Sep 20, 2018

README.md

Prepack Circle CI

Prepack is a partial evaluator for JavaScript. Prepack rewrites a JavaScript bundle, resulting in JavaScript code that executes more efficiently. For initialization-heavy code, Prepack works best in an environment where JavaScript parsing is effectively cached.

See the official prepack.io website for an introduction and an interactive REPL playground.

How to use Prepack

Install the CLI via npm,

$ npm install -g prepack

Or if you prefer yarn, make sure you get yarn first,

$ npm install -g yarn

and then install the Prepack CLI via yarn:

$ yarn global add prepack

You may need to prepend (pun intended!) the command with sudo in some cases.

Let the party begin

To compile a file and print the output to the console:

$ prepack script.js

If you want to compile a file and output to another file:

$ prepack script.js --out script-processed.js

Detailed instructions and the API can be found at Prepack CLI: Getting Started

Plugins to other tools

The following are a few plugins to other tools. They have been created and are maintained separately from Prepack itself. If you run into any issues with those plugins, please ask the plugin maintainers for support.

Status

How to get the code

  1. Clone repository and make it your current directory.
  2. git submodule init
  3. git submodule update --init
  4. Get yarn and node, then do yarn

Note: For development work you really need yarn, as many scripts require it.

How to build, lint, type check

  1. Get the code
  2. yarn build
    You can later run yarn watch in the background to just compile changed files on the fly.
  3. yarn lint
  4. yarn flow

How to run tests

  1. Get the code
  2. Make sure the code is built, either by running yarn build or yarn watch
  3. yarn test

You can run individual test suites as follows:

  • yarn test-serializer
    This tests the interpreter and serializer. All tests should pass.
  • yarn test-test262
    This tests conformance against the test262 suite. Not all will pass, increasing conformance is work in progress.

How to run the interpreter

  1. Get the code
  2. Make sure the code is built, either by running yarn build or yarn watch
  3. yarn repl
    This starts an interactive interpreter session.

How to run Prepack

  1. Get the code

  2. Make sure the code is built, either by running yarn build or yarn watch.

  3. Have a JavaScript file handy that you want to prepack, for example:
    echo "function hello() { return 'hello'; } function world() { return 'world'; } s = hello() + ' ' + world();" >/tmp/sample.js

  4. cat /tmp/sample.js | yarn prepack-cli
    Try --help for more options.

How to validate changes

Instead of building, linting, type checking, testing separately, the following does everything together:
yarn validate

How to edit the website

The content for prepack.io resides in the website directory of this repository. To make changes, submit a pull request, just like for any code changes.

In order to run the website locally at localhost:8000:

  1. Build prepack into the website: yarn build && mv prepack.min.js website/js
  2. Run python -m SimpleHTTPServer (Python 2) or python -m http.server (Python 3) from the website/ directory

How to contribute

To read more about the project, check out this suggested reading wiki

For more information about contributing pull requests and issues, see our Contribution Guidelines.

License

Prepack is BSD-licensed. We also provide an additional patent grant.