bite sized node.js testing
specify is the simplest way i could think to do node.js testing.
It works with sync code and async code all the same.
Please use versions
~0.6.x for node
~1.0.x for node
0.8 or higher.
If you don't like reading and want to see some code you can look at nano's tests and learn there. Also read the
specify source code; it's just a couple of lines of code.
var specify = ;;specify;
The assert calls are callback functions that wrap the assert module.
specify figures out how many callbacks you are calling by static-analysis. To put it simply, it counts the number of times you wrote
assert. When that number of assertions is met, or when a timeout occurs, that test is complete and we can execute the next one.
Static analysis does not work for a
for loop and some other flow control constructs. In that case you can use
assert.expect(nr) to tell specify how many assertions to expect:
specify runs tests one by one, not in parallel. If you set
assert.expect higher than the number of
assert function calls the execution will stop, and your current test will never finish. You can circumvent this by setting a timeout:
Because tests are serialized,
specify can catch uncaught exceptions and continue to run. You will get a report about the error that was thrown somewhere in your stack. This is analogous to the functionality the community refers to as
specify is standalone; you don't need any special binaries to run it.
If you think all these
specify functions make your code look bloated, you can also run a single function:
var specify =request =;specify;
npm install specify
var specify = require('specify');
specify you specify which tests you want to run:
var specify =filters = processargv;;;;specify;
If you feel like the output sent to
stdout is ugly, you can write your own reporter and send in a pull request.
Now use it:
You can also do this with a function if you like:
Samples are available in the
Everyone is welcome to contribute. Patches, bug-fixes, reporters, new features.
git checkout -b feature_name
git push origin feature_name
git clone git://github.com/dscape/specify.git
(oO)--',- in caos
Copyright 2012 nuno job <nunojob.com>
Licensed under the apache license, version 2.0 (the "license"); You may not use this file except in compliance with the license. You may obtain a copy of the license at
Unless required by applicable law or agreed to in writing, software distributed under the license is distributed on an "as is" basis, without warranties or conditions of any kind, either express or implied. see the license for the specific language governing permissions and limitations under the license.