A JavaScript bundle optimizer.
Go to file
Nikolai Tillmann 2a584d5557 - add option to log hierarchy of require() dependencies
- add ability to tracer to wrap around / detour a call
- use that feature to delay require() calls that trigger unsupported operations
- adding tests
2017-04-21 13:39:13 -07:00
flow-typed/npm Break ecma deps (#400) 2017-04-14 15:09:34 -07:00
src - add option to log hierarchy of require() dependencies 2017-04-21 13:39:13 -07:00
test - add option to log hierarchy of require() dependencies 2017-04-21 13:39:13 -07:00
.babelrc Initial commit 2017-03-28 20:52:41 -07:00
.eslintignore Initial commit 2017-03-28 20:52:41 -07:00
.eslintrc Initial commit 2017-03-28 20:52:41 -07:00
.flowconfig Mechanical search+replace renaming of everything relating to serializer. 2017-04-10 18:00:47 -07:00
.gitignore Create a webpack bundle entry point (#364) 2017-04-06 18:52:15 -07:00
.gitmodules Initial commit 2017-03-28 20:52:41 -07:00
circle.yml Do not introduce new block scopes for eval scripts (#432) 2017-04-20 10:35:38 -07:00
CONTRIBUTING.md Initial commit 2017-03-28 20:52:41 -07:00
LICENSE Initial commit 2017-03-28 20:52:41 -07:00
package.json Do not introduce new block scopes for eval scripts (#432) 2017-04-20 10:35:38 -07:00
PATENTS Initial commit 2017-03-28 20:52:41 -07:00
README.md Removing another redundant section. 2017-04-19 13:37:15 -07:00
webpack.config.js Splitting up serializer into types/serializer/visitors. Adding Flow annotations as needed at module boundaries. 2017-04-11 10:30:46 -07:00

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.

Status

How to get the code

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

How to build, lint, type check

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

How to run tests

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

You can run individual test suites as follows.

  • npm run test-serializer
    This tests the interpreter and serializer. All tests should pass.
  • npm run 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 npm run build or npm run watch
  3. npm run 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 npm run build or npm run 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. npm run prepack /tmp/sample.js
    Try --help for more options.

How to validate changes

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

How to edit the website

The content for prepack.io resides in the gh-pages branch 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, run python -m SimpleHTTPServer from the cloned gh-pages branch.

At this time, a particular bundled version of Prepack is checked in to the gh-pages branch at js/prepack.min.js. To update the bundle, run npm run build-bundle from the master branch, and copy the resulting prepack.min.js file into the gh-pages branch into the js directory, and submit a pull request for that change.

How to contribute

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.