The source code for ist.js is accessible on GitHub. The master branch contains the latest released (and hopefully stable) version, while the devel branch features the latest developments but may be unstable.
You can also directly grab the source code as a zip archive or a tar.gz archive.
Installing build dependencies
You will need make, nodejs and npm to build or test ist.js. Just clone the repository or download a source tarball, and run
npm install from the repository root to install build dependencies. The following dependencies are installed:
- pegjs to build the template parser
- requirejs to build ist.js components into a single file and to run tests
- karma to run the test suite, including support for Chrome and Firefox
- karma-opera-launcher to run the test suite on Opera
- karma-sauce-launcher to run the test suite on Sauce Labs. This is only used when running tests from Travis.
make from the repository root to build both ist.js and the minified version. You can also run
make ist or
make ist-min to only build one version at a time. Output files are created in the repository root.
ist.js includes a thorough test suite which uses Karma and Jasmine. There are two ways to run the test suite from a local repository clone:
make testruns the test suite with PhantomJS, Chrome, Firefox and Opera, and then exits. You must have both those browsers installed for this to succeed (except for PhantomJS, which is built-in with Karma).
make test-devlaunches Karma but does not launch any browsers. You can then point any browser to http://localhost:9876/ to run the test suite with this browser.
ist.js builds are tested automatically on Travis with Sauce Labs.
Don't hesitate to report bugs on GitHub, even the little hitches do matter. You can also fork ist.js and send me pull requests. Also please feel free to contact me as @njoyard on twitter.