plovr: a Closure build tool
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
closure/closure-library
package
scripts
src
test/org/plovr
testdata
third-party
tools
www
.buckconfig
.classpath
.dockerignore
.gitignore
.project
BUCK
Dockerfile
Dockerfile.base
README.md
build-package.sh
config.js
create-release.sh
externs_manifest.txt
library_manifest.txt
listfiles.sh
prod-globals.js
publish-documentation.sh
run-demo.sh
test-custom-passes.sh
third_party_manifest.txt
upload.py
www-globals.js

README.md

Plovr: A Closure build tool

plovr is a build tool that dynamically recompiles JavaScript and Closure Template code. It is designed to simplify Closure development, and to make it more enjoyable.

Using Plovr

Plovr requires Java 7 or higher.

Downloading Plovr

You can find Plovr JARs for download on the Releases page

Building Plovr from Source

The Plovr build requires the Java Development Kit (JDK) 7 or higher, Buck, and zip.

When following the Buck installation instructions, double-check that you are following the instructions for building Java projects and for your operating system. If you have trouble installing Buck (which can be non-trivial on Windows), please contact the Buck team.

To test:

buck fetch ...
buck test

To build:

buck fetch ...
buck build plovr

The output of the build will be in buck-out/gen/plovr.jar.

Building Plovr inside a Docker container

If you want to build plovr without installing Buck on your local machine, we have a Docker container with Buck installed.

The Plovr build is split into two Dockerfiles:

To test:

docker build .

downloads the plovr-deps container from docker, adds Plovr source, and runs all the Plovr tests.

If you want to build plovr-deps yourself:

docker build -t nicks/plovr-deps -f Dockerfile.base .

To Upgrade Closure Library

To upgrade one of Closure Library, go to the official repo and find the SHA digest of the commit you want to sync to. Then run.

scripts/update-closure-library.sh sha-digest

Sometimes this doesn't work because git subtree is buggy. If nothing updates, try running:

scripts/update-closure-library.sh master
git reset --hard origin/master
scripts/update-closure-library.sh sha-digest

This will bully git subtree into shape.

To Upgrade Closure Compiler, Closure Templates, or Closure Spreadsheets

The Closure Compiler, Template, and Spreadsheets depenencies are managed with Maven.

Follow the instructions in third-party/README.md.