Skip to main content

assorted python tools for building (packing, aggregating) javascript libraries

Project description

‘JSTools’ is a collection of utilities for managing JavaScript libraries.


Until jstools is released into pypi, we suggest checking out jstools and installing using either ‘python install’ or ‘python develop’ from within your checkout.


Should be python 2.4 friendly, tested most on python 2.5

Easy Install

$ easy_install jstools

This will put the following scripts in ‘/your/python/distribution/bin’:

$ bin/jsbuild
$ bin/jsmin

Depending on your system, this action may require sudo.

Environment Install

‘jstools’ includes a script to create a contained python environment. This script also automatically downloads the yui compressor and puts it in a place jstools can find it.

This script will turn a folder of your choice into a python environment [1] with the jstools scripts installed in a directory called ‘bin’:

$ easy_install -b ./ -e jstools
$ python jstools/install_jstools ./jsdir

This makes ‘jsdir’ jstools enabled with it’s own ‘bin’. source the script ‘bin/activate’, and now jsbuild and jsmin are on your path:

$ cd jsdir
$ . bin/activate

Other Distribution Options

You can download jstools in whatever flavor your prefer:

$ wget
$ svn co # not currently working
$ git clone git://



Merges and compresses files according to a configuration file. jsbuild will walk each root directory specified in configuration, index all the files ending with .js and then compile an aggregate source based on the specification in the config file and the dependencies declared inside the files themselves.


jsbuild <config_file> [options]


Usage: jsbuild [options] filename1.cfg [filename2.cfg…]

-h, --help

show this help message and exit

-u, --uncompress

Don’t compresses aggregated javascript. jsbuild defaults to applying ‘jsmin’ to all output.

-v, --verbose

print more info

-l, --list-only

Only list javascript files that would have been merged


Output directory for files jsbuild creates (defaults to current directory)


base directory for resource files (for interpolation)

-b ROOT_DIR, --base-dir=ROOT_DIR

base directory for root dirs (defaults to current directory)


New in 1.1: Only create file for this section

-s CONCAT, --single-file-build=CONCAT

New in 1.1. Create a single file of all of possible output


New in 1.1. Specify compressor plugin to use in form {specifier}:{‘arguments_string’}.

Configuration Format

A config file may have multiple uniquely named output files (ie multiple sections).

A section is formatted in the following fashion:






The files listed in the first section will be forced to load before all other files (in the order listed). The files in last section will be forced to load after all the other files (in the order listed).

The files list in the exclude section will not be imported. An exclude entry can be a relative path to a file or directory, or can be a python regular expression starting with pattern r:, see python re syntax:

The configuration allows for the interpolation of variables defined in the config file. ‘%(resource-dir)s’ may be subsituted for the value of the -r flag.

Lines commented using ‘#’ will be ignored.

If an include section is defined, jsbuild will only build listed files from this section and theirs dependencies, else all files from root section will be built.

Dependency Syntax

File merging uses cues inside the candidate javascript files to determine dependencies. Two types of dependencies are specified with two different comment formats within source files.

To specify that a target files must be included before a given source file, include a comment of the following format:

// @requires <file path>


// @requires Geo/DataSource.js

To specify that a target file must be included at any place in the merged build - before or after a given source file - include a comment in the source file of the following format:

// @include <file path>


// @include Geo/DataSource.js

Note that the “exclude” list in a configuration file will override dependencies specified by the @requires and @include comment directives described above.


Compresses an input stream of javascript to an output stream


jsmin < cat some.js > some-compressed.js


– The Software shall be used for Good, not Evil. –

see file for complete copyright


Mixed. same as OpenLayers unless otherwhise noted

Buildout Support

see jstools/bo.txt

Run Tests

in the src dir in an environment w/ yuicomp installed:

$ easy_install nose
$ paver get_yuicomp
$ cd test
$ nosetests {options}

or most simply:

$ python test


jstools started as a collection of build scripts as part of the OpenLayers Project[#]_.

Whit Morriss (whit at repackaged these scripts as jstools and Tim Schaub (tschaub at did extensive reworking of tsort.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

JSTools-1.0.tar.gz (20.8 kB view hashes)

Uploaded source

Built Distribution

JSTools-1.0-py2-none-any.whl (25.0 kB view hashes)

Uploaded 2 7

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page