The main purpose of Testacular is to make your TDD development easy, fast, and fun.
sudo npm install -g testacular # or install in a local folder (you have to create symlinks to binaries on your own) npm install testacular
You can install Testacular even without NPM, just get the latest package and create symlinks:
# replace x.y.z with latest version curl http://registry.npmjs.org/testacular/-/testacular-x.y.z.tgz | tar -xv && mv package testacular # create symlinks (optional) cd testacular sudo ln -s $PWD/bin/testacular /usr/local/bin/testacular
What is it good for?
Mostly for testing code in multiple browsers (desktop, mobile, tablets):
- executing tests locally during development
- executing tests on a continuous integration server
Let's do it!
Go into your project and create a testacular configuration. Basically you need to specify the source files that you want to execute.
For an example configuration, see test/client/testacular.conf.js which contains most of the options.
# create config file (testacular.conf.js by default) testacular init # start server testacular start # open browsers you want to test (if testacular is not configured to do it for you) open http://localhost:8080 # if you want to run tests manually (without auto watching file changes), you can: testacular run
Testing frameworks support
Testacular is not a testing framework, neither an assertion library, so for that you can use pretty much anything you like.
Why am I doing this?
git clone git://github.com/vojtajina/testacular.git # or clone your fork cd testacular sudo npm install . --dev # install all dev dependencies (such as grunt, jasmine-node, etc...)
Tips for contributing
- create a branch per feature/fix
- follow http://nodeguide.com/style.html (with exception of 100 characters per line)
- send pull request requesting a merge to
masterbranch (not to default
You can follow @TestacularJS as well.
Testacular uses Semantic Versioning. All even versions (eg.
0.4.x) are considered to
be stable - no breaking changes, only bug fixes.
Stable channel (branch "stable")
npm install -g testacular
Canary channel (branch "master")
npm install -g testacular@canary