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 -xvz && 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.
Please see the wiki for details on supported Browsers and how to configure non-default paths.
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