vulcan 0.2.5 → 0.3.0
Sign up to get free protection for your applications and to get access to all the features.
- data/README.md +1 -80
- data/lib/vulcan/cli.rb +12 -33
- data/lib/vulcan/version.rb +1 -1
- data/server/bin/make +3 -1
- data/server/lib/spawner.js +4 -9
- data/server/node_modules/connect-form/node_modules/formidable/Readme.md +2 -13
- data/server/node_modules/connect-form/node_modules/formidable/lib/incoming_form.js +7 -19
- data/server/node_modules/connect-form/node_modules/formidable/lib/multipart_parser.js +1 -12
- data/server/node_modules/connect-form/node_modules/formidable/package.json +1 -1
- data/server/node_modules/connect-form/node_modules/formidable/test/fixture/http/special-chars-in-filename/osx-chrome-13.http +10 -0
- data/server/node_modules/connect-form/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-chrome-12.http +9 -0
- data/server/node_modules/connect-form/node_modules/formidable/test/legacy/simple/test-multipart-parser.js +1 -1
- data/server/node_modules/cradle/lib/cradle.js +1 -0
- data/server/node_modules/cradle/node_modules/vows/LICENSE +20 -0
- data/server/node_modules/cradle/node_modules/vows/Makefile +7 -0
- data/server/node_modules/cradle/node_modules/vows/README.md +39 -0
- data/server/node_modules/cradle/node_modules/vows/bin/vows +515 -0
- data/server/node_modules/cradle/node_modules/vows/lib/assert/error.js +27 -0
- data/server/node_modules/cradle/node_modules/vows/lib/assert/macros.js +215 -0
- data/server/node_modules/cradle/node_modules/vows/lib/assert/utils.js +77 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows.js +193 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/console.js +131 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/context.js +55 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/file.js +29 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/fragments/coverage-foot.html +2 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/fragments/coverage-head.html +61 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/report-html.js +54 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/report-json.js +54 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/report-plain.js +38 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/extras.js +28 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/dot-matrix.js +67 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/json.js +16 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/silent.js +8 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/spec.js +44 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/watch.js +39 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/xunit.js +90 -0
- data/server/node_modules/cradle/node_modules/vows/lib/vows/suite.js +319 -0
- data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/LICENSE +20 -0
- data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/Makefile +4 -0
- data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/README.md +72 -0
- data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/lib/eyes.js +233 -0
- data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/package.json +14 -0
- data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/test/eyes-test.js +55 -0
- data/server/node_modules/cradle/node_modules/vows/package.json +14 -0
- data/server/node_modules/cradle/node_modules/vows/test/assert-test.js +135 -0
- data/server/node_modules/cradle/node_modules/vows/test/fixtures/isolate/failing.js +18 -0
- data/server/node_modules/cradle/node_modules/vows/test/fixtures/isolate/log.js +18 -0
- data/server/node_modules/cradle/node_modules/vows/test/fixtures/isolate/passing.js +17 -0
- data/server/node_modules/cradle/node_modules/vows/test/fixtures/isolate/stderr.js +18 -0
- data/server/node_modules/cradle/node_modules/vows/test/isolate-test.js +140 -0
- data/server/node_modules/cradle/node_modules/vows/test/testInherit.js +133 -0
- data/server/node_modules/cradle/node_modules/vows/test/vows-error-test.js +51 -0
- data/server/node_modules/cradle/node_modules/vows/test/vows-test.js +374 -0
- data/server/node_modules/cradle/package.json +3 -3
- data/server/node_modules/cradle/test/cache-test.js +7 -6
- data/server/node_modules/cradle/test/cradle-test.js +5 -4
- data/server/node_modules/cradle/test/response-test.js +6 -5
- data/server/node_modules/express/History.md +1 -53
- data/server/node_modules/express/Makefile +9 -3
- data/server/node_modules/express/Readme.md +1 -3
- data/server/node_modules/express/bin/express +66 -65
- data/server/node_modules/express/lib/express.js +1 -1
- data/server/node_modules/express/lib/request.js +9 -23
- data/server/node_modules/express/lib/response.js +2 -3
- data/server/node_modules/express/lib/utils.js +0 -13
- data/server/node_modules/express/lib/view.js +16 -19
- data/server/node_modules/express/lib/view/view.js +1 -2
- data/server/node_modules/express/node_modules/connect/lib/connect.js +1 -1
- data/server/node_modules/express/node_modules/connect/lib/http.js +0 -2
- data/server/node_modules/express/node_modules/connect/lib/middleware/bodyParser.js +31 -135
- data/server/node_modules/express/node_modules/connect/lib/middleware/limit.js +1 -5
- data/server/node_modules/express/node_modules/connect/lib/middleware/session.js +2 -2
- data/server/node_modules/express/node_modules/connect/lib/middleware/static.js +21 -26
- data/server/node_modules/express/node_modules/connect/lib/middleware/staticCache.js +38 -91
- data/server/node_modules/express/node_modules/connect/lib/middleware/vhost.js +1 -1
- data/server/node_modules/express/node_modules/connect/lib/utils.js +4 -11
- data/server/node_modules/express/node_modules/connect/package.json +6 -7
- data/server/node_modules/express/node_modules/connect/test.js +31 -44
- data/server/node_modules/express/node_modules/mime/index.js +1 -0
- data/server/node_modules/express/node_modules/mime/mime.js +3 -3
- data/server/node_modules/express/node_modules/mime/{types/mime.types → mime.types} +0 -0
- data/server/node_modules/express/node_modules/mime/{types/node.types → node.types} +0 -17
- data/server/node_modules/express/node_modules/mime/package.json +10 -21
- data/server/node_modules/express/node_modules/mime/test.js +3 -2
- data/server/node_modules/express/node_modules/qs/History.md +0 -11
- data/server/node_modules/express/node_modules/qs/Makefile +3 -1
- data/server/node_modules/express/node_modules/qs/Readme.md +4 -2
- data/server/node_modules/express/node_modules/qs/lib/querystring.js +74 -100
- data/server/node_modules/express/node_modules/qs/package.json +2 -9
- data/server/node_modules/express/node_modules/qs/support/expresso/History.md +128 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/Makefile +53 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/Readme.md +61 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/bin/expresso +856 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/docs/api.html +1080 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/docs/index.html +377 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/docs/index.md +290 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/docs/layout/foot.html +3 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/docs/layout/head.html +42 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/lib/bar.js +4 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/lib/foo.js +16 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/package.json +12 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/test/assert.test.js +91 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/test/async.test.js +12 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/test/bar.test.js +13 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/test/foo.test.js +14 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/test/http.test.js +146 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/test/serial/async.test.js +39 -0
- data/server/node_modules/express/node_modules/qs/support/expresso/test/serial/http.test.js +48 -0
- data/server/node_modules/express/node_modules/qs/support/should/History.md +22 -0
- data/server/node_modules/express/node_modules/qs/support/should/Makefile +6 -0
- data/server/node_modules/express/node_modules/qs/support/should/Readme.md +248 -0
- data/server/node_modules/express/node_modules/qs/support/should/examples/runner.js +53 -0
- data/server/node_modules/express/node_modules/qs/support/should/index.js +2 -0
- data/server/node_modules/express/node_modules/qs/support/should/lib/eql.js +91 -0
- data/server/node_modules/express/node_modules/qs/support/should/lib/should.js +548 -0
- data/server/node_modules/express/node_modules/qs/support/should/package.json +8 -0
- data/server/node_modules/express/node_modules/qs/support/should/test/should.test.js +358 -0
- data/server/node_modules/express/node_modules/qs/test/{parse.js → parse.test.js} +2 -1
- data/server/node_modules/express/node_modules/qs/test/{stringify.js → stringify.test.js} +0 -0
- data/server/node_modules/express/package.json +8 -9
- data/server/node_modules/node-uuid/README.md +67 -166
- data/server/node_modules/node-uuid/package.json +3 -5
- data/server/node_modules/node-uuid/{benchmark → test}/benchmark-native.c +0 -0
- data/server/node_modules/node-uuid/test/benchmark.js +27 -0
- data/server/node_modules/node-uuid/test/test.html +0 -3
- data/server/node_modules/node-uuid/test/test.js +57 -214
- data/server/node_modules/node-uuid/uuid.js +56 -225
- data/server/node_modules/restler/README.md +7 -20
- data/server/node_modules/restler/bin/restler +1 -1
- data/server/node_modules/restler/lib/multipartform.js +8 -9
- data/server/node_modules/restler/lib/restler.js +22 -64
- data/server/node_modules/restler/package.json +2 -2
- data/server/node_modules/restler/test/restler.js +2 -22
- data/server/node_modules/restler/test/test_helper.js +1 -20
- data/server/package.json +10 -10
- data/server/web.js +7 -30
- metadata +96 -89
- data/server/node_modules/connect-form/node_modules/formidable/test/fixture/file/plain.txt +0 -1
- data/server/node_modules/connect-form/node_modules/formidable/test/fixture/http/no-filename/generic.http +0 -13
- data/server/node_modules/connect-form/node_modules/formidable/test/fixture/js/no-filename.js +0 -3
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/Makefile +0 -14
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/Readme.md +0 -286
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/TODO +0 -3
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/benchmark/bench-multipart-parser.js +0 -70
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/example/post.js +0 -43
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/example/upload.js +0 -48
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/index.js +0 -1
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/file.js +0 -61
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/incoming_form.js +0 -377
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/index.js +0 -3
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/multipart_parser.js +0 -312
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/querystring_parser.js +0 -25
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/util.js +0 -6
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/package.json +0 -22
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/common.js +0 -19
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/file/funkyfilename.txt +0 -1
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/file/plain.txt +0 -1
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/no-filename/generic.http +0 -13
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/info.md +0 -3
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/osx-chrome-13.http +0 -26
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/osx-firefox-3.6.http +0 -24
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/osx-safari-5.http +0 -23
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-chrome-12.http +0 -24
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-ie-7.http +0 -22
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-ie-8.http +0 -22
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-safari-5.http +0 -22
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/js/no-filename.js +0 -3
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/js/special-chars-in-filename.js +0 -21
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/multi_video.upload +0 -0
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/multipart.js +0 -72
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/integration/test-fixtures.js +0 -89
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/common.js +0 -24
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/integration/test-multipart-parser.js +0 -80
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/simple/test-file.js +0 -104
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/simple/test-incoming-form.js +0 -715
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/simple/test-multipart-parser.js +0 -50
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/simple/test-querystring-parser.js +0 -45
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/system/test-multi-video-upload.js +0 -72
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/run.js +0 -2
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/unit/test-incoming-form.js +0 -63
- data/server/node_modules/express/node_modules/connect/node_modules/formidable/tool/record.js +0 -47
- data/server/node_modules/express/node_modules/mkdirp/LICENSE +0 -21
- data/server/node_modules/express/node_modules/mkdirp/README.markdown +0 -21
- data/server/node_modules/express/node_modules/mkdirp/examples/pow.js +0 -6
- data/server/node_modules/express/node_modules/mkdirp/examples/pow.js.orig +0 -6
- data/server/node_modules/express/node_modules/mkdirp/examples/pow.js.rej +0 -19
- data/server/node_modules/express/node_modules/mkdirp/index.js +0 -20
- data/server/node_modules/express/node_modules/mkdirp/package.json +0 -23
- data/server/node_modules/express/node_modules/mkdirp/test/mkdirp.js +0 -28
- data/server/node_modules/express/node_modules/mkdirp/test/race.js +0 -41
- data/server/node_modules/express/node_modules/mkdirp/test/rel.js +0 -32
- data/server/node_modules/express/node_modules/qs/test/mocha.opts +0 -2
- data/server/node_modules/express/testing/foo/app.js +0 -35
- data/server/node_modules/express/testing/foo/package.json +0 -9
- data/server/node_modules/express/testing/foo/public/stylesheets/style.css +0 -8
- data/server/node_modules/express/testing/foo/routes/index.js +0 -10
- data/server/node_modules/express/testing/foo/views/index.jade +0 -2
- data/server/node_modules/express/testing/foo/views/layout.jade +0 -6
- data/server/node_modules/express/testing/index.js +0 -43
- data/server/node_modules/express/testing/public/test.txt +0 -2971
- data/server/node_modules/express/testing/views/page.html +0 -1
- data/server/node_modules/express/testing/views/page.jade +0 -3
- data/server/node_modules/express/testing/views/test.md +0 -1
- data/server/node_modules/express/testing/views/user/index.jade +0 -1
- data/server/node_modules/express/testing/views/user/list.jade +0 -1
- data/server/node_modules/node-uuid/benchmark/README.md +0 -53
- data/server/node_modules/node-uuid/benchmark/bench.gnu +0 -174
- data/server/node_modules/node-uuid/benchmark/bench.sh +0 -34
- data/server/node_modules/node-uuid/benchmark/benchmark.js +0 -84
- data/server/node_modules/node-uuid/test/benchmark-native +0 -0
- data/server/node_modules/node-uuid/test/compare_v1.js +0 -63
@@ -0,0 +1,22 @@
|
|
1
|
+
|
2
|
+
0.0.4 / 2010-11-24
|
3
|
+
==================
|
4
|
+
|
5
|
+
* Added `.ok` to assert truthfulness
|
6
|
+
* Added `.arguments`
|
7
|
+
* Fixed double required bug. [thanks dominictarr]
|
8
|
+
|
9
|
+
0.0.3 / 2010-11-19
|
10
|
+
==================
|
11
|
+
|
12
|
+
* Added `true` / `false` assertions
|
13
|
+
|
14
|
+
0.0.2 / 2010-11-19
|
15
|
+
==================
|
16
|
+
|
17
|
+
* Added chaining support
|
18
|
+
|
19
|
+
0.0.1 / 2010-11-19
|
20
|
+
==================
|
21
|
+
|
22
|
+
* Initial release
|
@@ -0,0 +1,248 @@
|
|
1
|
+
_should_ is an expressive, test framework agnostic, assertion library for [node](http://nodejs.org).
|
2
|
+
|
3
|
+
_should_ literally extends node's _assert_ module, in fact, it is node's assert module, for example `should.equal(str, 'foo')` will work, just as `assert.equal(str, 'foo')` would, and `should.AssertionError` **is** `asset.AssertionError`, meaning any test framework supporting this constructor will function properly with _should_.
|
4
|
+
|
5
|
+
## Example
|
6
|
+
|
7
|
+
var user = {
|
8
|
+
name: 'tj'
|
9
|
+
, pets: ['tobi', 'loki', 'jane', 'bandit']
|
10
|
+
};
|
11
|
+
|
12
|
+
user.should.have.property('name', 'tj');
|
13
|
+
user.should.have.property('pets').with.lengthOf(4)
|
14
|
+
|
15
|
+
## Installation
|
16
|
+
|
17
|
+
$ npm install should
|
18
|
+
|
19
|
+
## modifiers
|
20
|
+
|
21
|
+
_should_'s assertion chaining provides an expressive way to build up an assertion, along with dummy getters such as _an_, _have_, and _be_, provided are what I am simply calling **modifiers**, which have a meaning effect on the assertion. An example of this is the _not_ getter, which negates the meaning, aka `user.should.not.have.property('name')`. In the previous example note the use of _have_, as we could omit it and still construct a valid assertion.
|
22
|
+
|
23
|
+
Some modifiers such as _include_ only have an effect with specific assertion methods, for example when asserting a substring like so: `str.should.include.string('test')`, we could omit _include_, but it helps express the meaning, however _keys_ has a strict effect, unless the _include_ modifier is used.
|
24
|
+
|
25
|
+
## chaining assertions
|
26
|
+
|
27
|
+
Some assertions can be chained, for example if a property is volatile we can first assert property existence:
|
28
|
+
|
29
|
+
user.should.have.property('pets').with.lengthOf(4)
|
30
|
+
|
31
|
+
which is essentially equivalent to below, however the property may not exist:
|
32
|
+
|
33
|
+
user.pets.should.have.lengthOf(4)
|
34
|
+
|
35
|
+
our dummy getters such as _and_ also help express chaining:
|
36
|
+
|
37
|
+
user.should.be.a('object').and.have.property('name', 'tj')
|
38
|
+
|
39
|
+
## ok
|
40
|
+
|
41
|
+
Assert truthfulness:
|
42
|
+
|
43
|
+
true.should.be.ok
|
44
|
+
'yay'.should.be.ok
|
45
|
+
(1).should.be.ok
|
46
|
+
|
47
|
+
or negated:
|
48
|
+
|
49
|
+
false.should.not.be.ok
|
50
|
+
''.should.not.be.ok
|
51
|
+
(0).should.not.be.ok
|
52
|
+
|
53
|
+
## true
|
54
|
+
|
55
|
+
Assert === true:
|
56
|
+
|
57
|
+
true.should.be.true
|
58
|
+
'1'.should.not.be.true
|
59
|
+
|
60
|
+
## false
|
61
|
+
|
62
|
+
Assert === false:
|
63
|
+
|
64
|
+
false.should.be.false
|
65
|
+
(0).should.not.be.false
|
66
|
+
|
67
|
+
## arguments
|
68
|
+
|
69
|
+
Assert `Arguments`:
|
70
|
+
|
71
|
+
var args = (function(){ return arguments; })(1,2,3);
|
72
|
+
args.should.be.arguments;
|
73
|
+
[].should.not.be.arguments;
|
74
|
+
|
75
|
+
## empty
|
76
|
+
|
77
|
+
Asserts that length is 0:
|
78
|
+
|
79
|
+
[].should.be.empty
|
80
|
+
''.should.be.empty
|
81
|
+
({ length: 0 }).should.be.empty
|
82
|
+
|
83
|
+
## eql
|
84
|
+
|
85
|
+
equality:
|
86
|
+
|
87
|
+
({ foo: 'bar' }).should.eql({ foo: 'bar' })
|
88
|
+
[1,2,3].should.eql([1,2,3])
|
89
|
+
|
90
|
+
## equal
|
91
|
+
|
92
|
+
strict equality:
|
93
|
+
|
94
|
+
should.strictEqual(undefined, value)
|
95
|
+
should.strictEqual(false, value)
|
96
|
+
(4).should.equal(4)
|
97
|
+
'test'.should.equal('test')
|
98
|
+
[1,2,3].should.not.equal([1,2,3])
|
99
|
+
|
100
|
+
## within
|
101
|
+
|
102
|
+
Assert inclusive numeric range:
|
103
|
+
|
104
|
+
user.age.should.be.within(5, 50)
|
105
|
+
|
106
|
+
## a
|
107
|
+
|
108
|
+
Assert __typeof__:
|
109
|
+
|
110
|
+
user.should.be.a('object')
|
111
|
+
'test'.should.be.a('string')
|
112
|
+
|
113
|
+
## instanceof
|
114
|
+
|
115
|
+
Assert __instanceof__:
|
116
|
+
|
117
|
+
user.should.be.an.instanceof(User)
|
118
|
+
[].should.be.an.instanceof(Array)
|
119
|
+
|
120
|
+
## above
|
121
|
+
|
122
|
+
Assert numeric value above the given value:
|
123
|
+
|
124
|
+
user.age.should.be.above(5)
|
125
|
+
user.age.should.not.be.above(100)
|
126
|
+
|
127
|
+
## below
|
128
|
+
|
129
|
+
Assert numeric value below the given value:
|
130
|
+
|
131
|
+
user.age.should.be.below(100)
|
132
|
+
user.age.should.not.be.below(5)
|
133
|
+
|
134
|
+
## match
|
135
|
+
|
136
|
+
Assert regexp match:
|
137
|
+
|
138
|
+
username.should.match(/^\w+$/)
|
139
|
+
|
140
|
+
## length
|
141
|
+
|
142
|
+
Assert _length_ property exists and has a value of the given number:
|
143
|
+
|
144
|
+
user.pets.should.have.length(5)
|
145
|
+
user.pets.should.have.a.lengthOf(5)
|
146
|
+
|
147
|
+
Aliases: _lengthOf_
|
148
|
+
|
149
|
+
## string
|
150
|
+
|
151
|
+
Substring assertion:
|
152
|
+
|
153
|
+
'foobar'.should.include.string('foo')
|
154
|
+
'foobar'.should.include.string('bar')
|
155
|
+
'foobar'.should.not.include.string('baz')
|
156
|
+
|
157
|
+
## property
|
158
|
+
|
159
|
+
Assert property exists and has optional value:
|
160
|
+
|
161
|
+
user.should.have.property('name')
|
162
|
+
user.should.have.property('age', 15)
|
163
|
+
user.should.not.have.property('rawr')
|
164
|
+
user.should.not.have.property('age', 0)
|
165
|
+
|
166
|
+
## ownProperty
|
167
|
+
|
168
|
+
Assert own property (on the immediate object):
|
169
|
+
|
170
|
+
({ foo: 'bar' }).should.have.ownProperty('foo')
|
171
|
+
|
172
|
+
## contain
|
173
|
+
|
174
|
+
Assert array value:
|
175
|
+
|
176
|
+
[1,2,3].should.contain(3)
|
177
|
+
[1,2,3].should.contain(2)
|
178
|
+
[1,2,3].should.not.contain(4)
|
179
|
+
|
180
|
+
## keys
|
181
|
+
|
182
|
+
Assert own object keys, which must match _exactly_,
|
183
|
+
and will fail if you omit a key or two:
|
184
|
+
|
185
|
+
var obj = { foo: 'bar', baz: 'raz' };
|
186
|
+
obj.should.have.keys('foo', 'bar');
|
187
|
+
obj.should.have.keys(['foo', 'bar']);
|
188
|
+
|
189
|
+
using the _include_ modifier, we can check inclusion of a key,
|
190
|
+
but not fail when we omit a few:
|
191
|
+
|
192
|
+
obj.should.include.keys('foo')
|
193
|
+
obj.should.include.keys('bar')
|
194
|
+
obj.should.not.include.keys('baz')
|
195
|
+
|
196
|
+
## respondTo
|
197
|
+
|
198
|
+
Assert that the given property is a function:
|
199
|
+
|
200
|
+
user.should.respondTo('email')
|
201
|
+
|
202
|
+
## Express example
|
203
|
+
|
204
|
+
For example you can use should with the [Expresso TDD Framework](http://github.com/visionmedia/expresso) by simply including it:
|
205
|
+
|
206
|
+
var lib = require('mylib')
|
207
|
+
, should = require('should');
|
208
|
+
|
209
|
+
module.exports = {
|
210
|
+
'test .version': function(){
|
211
|
+
lib.version.should.match(/^\d+\.\d+\.\d+$/);
|
212
|
+
}
|
213
|
+
};
|
214
|
+
|
215
|
+
## Running tests
|
216
|
+
|
217
|
+
To run the tests for _should_ simple update your git submodules and run:
|
218
|
+
|
219
|
+
$ make test
|
220
|
+
|
221
|
+
## OMG IT EXTENDS OBJECT???!?!@
|
222
|
+
|
223
|
+
Yes, yes it does, with a single getter _should_, and no it wont break your code, because it does this **properly** with a non-enumerable property.
|
224
|
+
|
225
|
+
## License
|
226
|
+
|
227
|
+
(The MIT License)
|
228
|
+
|
229
|
+
Copyright (c) 2010 TJ Holowaychuk <tj@vision-media.ca>
|
230
|
+
|
231
|
+
Permission is hereby granted, free of charge, to any person obtaining
|
232
|
+
a copy of this software and associated documentation files (the
|
233
|
+
'Software'), to deal in the Software without restriction, including
|
234
|
+
without limitation the rights to use, copy, modify, merge, publish,
|
235
|
+
distribute, sublicense, and/or sell copies of the Software, and to
|
236
|
+
permit persons to whom the Software is furnished to do so, subject to
|
237
|
+
the following conditions:
|
238
|
+
|
239
|
+
The above copyright notice and this permission notice shall be
|
240
|
+
included in all copies or substantial portions of the Software.
|
241
|
+
|
242
|
+
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
|
243
|
+
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
244
|
+
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
|
245
|
+
IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
|
246
|
+
CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
|
247
|
+
TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
|
248
|
+
SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
@@ -0,0 +1,53 @@
|
|
1
|
+
|
2
|
+
/**
|
3
|
+
* Module dependencies.
|
4
|
+
*/
|
5
|
+
|
6
|
+
var should = require('../');
|
7
|
+
|
8
|
+
function test(name, fn){
|
9
|
+
try {
|
10
|
+
fn();
|
11
|
+
} catch (err) {
|
12
|
+
console.log(' \x1b[31m%s', name);
|
13
|
+
console.log(' %s\x1b[0m', err.stack);
|
14
|
+
return;
|
15
|
+
}
|
16
|
+
console.log(' √ \x1b[32m%s\x1b[0m', name);
|
17
|
+
}
|
18
|
+
|
19
|
+
function Point(x, y) {
|
20
|
+
this.x = x;
|
21
|
+
this.y = y;
|
22
|
+
this.sub = function(other){
|
23
|
+
return new Point(
|
24
|
+
this.x - other.x
|
25
|
+
, this.y - other.y);
|
26
|
+
}
|
27
|
+
}
|
28
|
+
|
29
|
+
console.log();
|
30
|
+
|
31
|
+
test('new Point(x, y)', function(){
|
32
|
+
var point = new Point(50, 100);
|
33
|
+
point.should.be.an.instanceof(Point);
|
34
|
+
point.should.have.property('x', 50);
|
35
|
+
point.should.have.property('y', 100);
|
36
|
+
});
|
37
|
+
|
38
|
+
test('Point#sub()', function(){
|
39
|
+
var a = new Point(50, 100)
|
40
|
+
, b = new Point(20, 50);
|
41
|
+
a.sub(b).should.be.an.instanceof(Point);
|
42
|
+
a.sub(b).should.not.equal(a);
|
43
|
+
a.sub(b).should.not.equal(b);
|
44
|
+
a.sub(b).should.have.property('x', 30);
|
45
|
+
a.sub(b).should.have.property('y', 50);
|
46
|
+
});
|
47
|
+
|
48
|
+
test('Point#add()', function(){
|
49
|
+
var point = new Point(50, 100);
|
50
|
+
point.should.respondTo('add');
|
51
|
+
});
|
52
|
+
|
53
|
+
console.log();
|
@@ -0,0 +1,91 @@
|
|
1
|
+
|
2
|
+
// Taken from node's assert module, because it sucks
|
3
|
+
// and exposes next to nothing useful.
|
4
|
+
|
5
|
+
module.exports = _deepEqual;
|
6
|
+
|
7
|
+
function _deepEqual(actual, expected) {
|
8
|
+
// 7.1. All identical values are equivalent, as determined by ===.
|
9
|
+
if (actual === expected) {
|
10
|
+
return true;
|
11
|
+
|
12
|
+
} else if (Buffer.isBuffer(actual) && Buffer.isBuffer(expected)) {
|
13
|
+
if (actual.length != expected.length) return false;
|
14
|
+
|
15
|
+
for (var i = 0; i < actual.length; i++) {
|
16
|
+
if (actual[i] !== expected[i]) return false;
|
17
|
+
}
|
18
|
+
|
19
|
+
return true;
|
20
|
+
|
21
|
+
// 7.2. If the expected value is a Date object, the actual value is
|
22
|
+
// equivalent if it is also a Date object that refers to the same time.
|
23
|
+
} else if (actual instanceof Date && expected instanceof Date) {
|
24
|
+
return actual.getTime() === expected.getTime();
|
25
|
+
|
26
|
+
// 7.3. Other pairs that do not both pass typeof value == "object",
|
27
|
+
// equivalence is determined by ==.
|
28
|
+
} else if (typeof actual != 'object' && typeof expected != 'object') {
|
29
|
+
return actual == expected;
|
30
|
+
|
31
|
+
// 7.4. For all other Object pairs, including Array objects, equivalence is
|
32
|
+
// determined by having the same number of owned properties (as verified
|
33
|
+
// with Object.prototype.hasOwnProperty.call), the same set of keys
|
34
|
+
// (although not necessarily the same order), equivalent values for every
|
35
|
+
// corresponding key, and an identical "prototype" property. Note: this
|
36
|
+
// accounts for both named and indexed properties on Arrays.
|
37
|
+
} else {
|
38
|
+
return objEquiv(actual, expected);
|
39
|
+
}
|
40
|
+
}
|
41
|
+
|
42
|
+
function isUndefinedOrNull (value) {
|
43
|
+
return value === null || value === undefined;
|
44
|
+
}
|
45
|
+
|
46
|
+
function isArguments (object) {
|
47
|
+
return Object.prototype.toString.call(object) == '[object Arguments]';
|
48
|
+
}
|
49
|
+
|
50
|
+
function objEquiv (a, b) {
|
51
|
+
if (isUndefinedOrNull(a) || isUndefinedOrNull(b))
|
52
|
+
return false;
|
53
|
+
// an identical "prototype" property.
|
54
|
+
if (a.prototype !== b.prototype) return false;
|
55
|
+
//~~~I've managed to break Object.keys through screwy arguments passing.
|
56
|
+
// Converting to array solves the problem.
|
57
|
+
if (isArguments(a)) {
|
58
|
+
if (!isArguments(b)) {
|
59
|
+
return false;
|
60
|
+
}
|
61
|
+
a = pSlice.call(a);
|
62
|
+
b = pSlice.call(b);
|
63
|
+
return _deepEqual(a, b);
|
64
|
+
}
|
65
|
+
try{
|
66
|
+
var ka = Object.keys(a),
|
67
|
+
kb = Object.keys(b),
|
68
|
+
key, i;
|
69
|
+
} catch (e) {//happens when one is a string literal and the other isn't
|
70
|
+
return false;
|
71
|
+
}
|
72
|
+
// having the same number of owned properties (keys incorporates hasOwnProperty)
|
73
|
+
if (ka.length != kb.length)
|
74
|
+
return false;
|
75
|
+
//the same set of keys (although not necessarily the same order),
|
76
|
+
ka.sort();
|
77
|
+
kb.sort();
|
78
|
+
//~~~cheap key test
|
79
|
+
for (i = ka.length - 1; i >= 0; i--) {
|
80
|
+
if (ka[i] != kb[i])
|
81
|
+
return false;
|
82
|
+
}
|
83
|
+
//equivalent values for every corresponding key, and
|
84
|
+
//~~~possibly expensive deep test
|
85
|
+
for (i = ka.length - 1; i >= 0; i--) {
|
86
|
+
key = ka[i];
|
87
|
+
if (!_deepEqual(a[key], b[key] ))
|
88
|
+
return false;
|
89
|
+
}
|
90
|
+
return true;
|
91
|
+
}
|
@@ -0,0 +1,548 @@
|
|
1
|
+
|
2
|
+
/*!
|
3
|
+
* Should
|
4
|
+
* Copyright(c) 2010 TJ Holowaychuk <tj@vision-media.ca>
|
5
|
+
* MIT Licensed
|
6
|
+
*/
|
7
|
+
|
8
|
+
/**
|
9
|
+
* Module dependencies.
|
10
|
+
*/
|
11
|
+
|
12
|
+
var util = require('sys')
|
13
|
+
, assert = require('assert')
|
14
|
+
, AssertionError = assert.AssertionError
|
15
|
+
, eql = require('./eql')
|
16
|
+
, i = util.inspect;
|
17
|
+
|
18
|
+
/**
|
19
|
+
* Expose assert as should.
|
20
|
+
*
|
21
|
+
* This allows you to do things like below
|
22
|
+
* without require()ing the assert module.
|
23
|
+
*
|
24
|
+
* should.equal(foo.bar, undefined);
|
25
|
+
*
|
26
|
+
*/
|
27
|
+
|
28
|
+
exports = module.exports = assert;
|
29
|
+
|
30
|
+
/**
|
31
|
+
* Library version.
|
32
|
+
*/
|
33
|
+
|
34
|
+
exports.version = '0.0.4';
|
35
|
+
|
36
|
+
/**
|
37
|
+
* Expose api via `Object#should`.
|
38
|
+
*
|
39
|
+
* @api public
|
40
|
+
*/
|
41
|
+
|
42
|
+
Object.defineProperty(Object.prototype, 'should', {
|
43
|
+
set: function(){},
|
44
|
+
get: function(){
|
45
|
+
return new Assertion(this);
|
46
|
+
}
|
47
|
+
});
|
48
|
+
|
49
|
+
/**
|
50
|
+
* Initialize a new `Assertion` with the given _obj_.
|
51
|
+
*
|
52
|
+
* @param {Mixed} obj
|
53
|
+
* @api private
|
54
|
+
*/
|
55
|
+
|
56
|
+
var Assertion = exports.Assertion = function Assertion(obj) {
|
57
|
+
this.obj = obj;
|
58
|
+
};
|
59
|
+
|
60
|
+
/**
|
61
|
+
* Prototype.
|
62
|
+
*/
|
63
|
+
|
64
|
+
Assertion.prototype = {
|
65
|
+
|
66
|
+
/**
|
67
|
+
* HACK: prevents double require() from failing.
|
68
|
+
*/
|
69
|
+
|
70
|
+
exports: exports,
|
71
|
+
|
72
|
+
/**
|
73
|
+
* Assert _expr_ with the given _msg_ and _negatedMsg_.
|
74
|
+
*
|
75
|
+
* @param {Boolean} expr
|
76
|
+
* @param {String} msg
|
77
|
+
* @param {String} negatedMsg
|
78
|
+
* @api private
|
79
|
+
*/
|
80
|
+
|
81
|
+
assert: function(expr, msg, negatedMsg){
|
82
|
+
var msg = this.negate ? negatedMsg : msg
|
83
|
+
, ok = this.negate ? !expr : expr;
|
84
|
+
if (!ok) {
|
85
|
+
throw new AssertionError({
|
86
|
+
message: msg
|
87
|
+
, stackStartFunction: this.assert
|
88
|
+
});
|
89
|
+
}
|
90
|
+
},
|
91
|
+
|
92
|
+
/**
|
93
|
+
* Dummy getter.
|
94
|
+
*
|
95
|
+
* @api public
|
96
|
+
*/
|
97
|
+
|
98
|
+
get an() {
|
99
|
+
return this;
|
100
|
+
},
|
101
|
+
|
102
|
+
/**
|
103
|
+
* Dummy getter.
|
104
|
+
*
|
105
|
+
* @api public
|
106
|
+
*/
|
107
|
+
|
108
|
+
get and() {
|
109
|
+
return this;
|
110
|
+
},
|
111
|
+
|
112
|
+
/**
|
113
|
+
* Dummy getter.
|
114
|
+
*
|
115
|
+
* @api public
|
116
|
+
*/
|
117
|
+
|
118
|
+
get be() {
|
119
|
+
return this;
|
120
|
+
},
|
121
|
+
|
122
|
+
/**
|
123
|
+
* Dummy getter.
|
124
|
+
*
|
125
|
+
* @api public
|
126
|
+
*/
|
127
|
+
|
128
|
+
get have() {
|
129
|
+
return this;
|
130
|
+
},
|
131
|
+
|
132
|
+
/**
|
133
|
+
* Dummy getter.
|
134
|
+
*
|
135
|
+
* @api public
|
136
|
+
*/
|
137
|
+
|
138
|
+
get with() {
|
139
|
+
return this;
|
140
|
+
},
|
141
|
+
|
142
|
+
/**
|
143
|
+
* Inclusion modifier.
|
144
|
+
*
|
145
|
+
* @api public
|
146
|
+
*/
|
147
|
+
|
148
|
+
get include() {
|
149
|
+
this.includes = true;
|
150
|
+
return this;
|
151
|
+
},
|
152
|
+
|
153
|
+
/**
|
154
|
+
* Negation modifier.
|
155
|
+
*
|
156
|
+
* @api public
|
157
|
+
*/
|
158
|
+
|
159
|
+
get not() {
|
160
|
+
this.negate = true;
|
161
|
+
return this;
|
162
|
+
},
|
163
|
+
|
164
|
+
/**
|
165
|
+
* Get object inspection string.
|
166
|
+
*
|
167
|
+
* @return {String}
|
168
|
+
* @api private
|
169
|
+
*/
|
170
|
+
|
171
|
+
get inspect() {
|
172
|
+
return i(this.obj);
|
173
|
+
},
|
174
|
+
|
175
|
+
/**
|
176
|
+
* Assert instanceof `Arguments`.
|
177
|
+
*
|
178
|
+
* @api public
|
179
|
+
*/
|
180
|
+
|
181
|
+
get arguments() {
|
182
|
+
this.assert(
|
183
|
+
'[object Arguments]' == Object.prototype.toString.call(this.obj)
|
184
|
+
, 'expected ' + this.inspect + ' to be arguments'
|
185
|
+
, 'expected ' + this.inspect + ' to not be arguments');
|
186
|
+
return this;
|
187
|
+
},
|
188
|
+
|
189
|
+
/**
|
190
|
+
* Assert that an object is empty aka length of 0.
|
191
|
+
*
|
192
|
+
* @api public
|
193
|
+
*/
|
194
|
+
|
195
|
+
get empty() {
|
196
|
+
this.obj.should.have.property('length');
|
197
|
+
this.assert(
|
198
|
+
0 === this.obj.length
|
199
|
+
, 'expected ' + this.inspect + ' to be empty'
|
200
|
+
, 'expected ' + this.inspect + ' not to be empty');
|
201
|
+
return this;
|
202
|
+
},
|
203
|
+
|
204
|
+
/**
|
205
|
+
* Assert ok.
|
206
|
+
*
|
207
|
+
* @api public
|
208
|
+
*/
|
209
|
+
|
210
|
+
get ok() {
|
211
|
+
this.assert(
|
212
|
+
this.obj
|
213
|
+
, 'expected ' + this.inspect + ' to be truthy'
|
214
|
+
, 'expected ' + this.inspect + ' to be falsey');
|
215
|
+
return this;
|
216
|
+
},
|
217
|
+
|
218
|
+
/**
|
219
|
+
* Assert true.
|
220
|
+
*
|
221
|
+
* @api public
|
222
|
+
*/
|
223
|
+
|
224
|
+
get true() {
|
225
|
+
this.assert(
|
226
|
+
true === this.obj
|
227
|
+
, 'expected ' + this.inspect + ' to be true'
|
228
|
+
, 'expected ' + this.inspect + ' not to be true');
|
229
|
+
return this;
|
230
|
+
},
|
231
|
+
|
232
|
+
/**
|
233
|
+
* Assert false.
|
234
|
+
*
|
235
|
+
* @api public
|
236
|
+
*/
|
237
|
+
|
238
|
+
get false() {
|
239
|
+
this.assert(
|
240
|
+
false === this.obj
|
241
|
+
, 'expected ' + this.inspect + ' to be false'
|
242
|
+
, 'expected ' + this.inspect + ' not to be false');
|
243
|
+
return this;
|
244
|
+
},
|
245
|
+
|
246
|
+
/**
|
247
|
+
* Assert equal.
|
248
|
+
*
|
249
|
+
* @param {Mixed} val
|
250
|
+
* @api public
|
251
|
+
*/
|
252
|
+
|
253
|
+
eql: function(val){
|
254
|
+
this.assert(
|
255
|
+
eql(val, this.obj)
|
256
|
+
, 'expected ' + this.inspect + ' to equal ' + i(val)
|
257
|
+
, 'expected ' + this.inspect + ' to not equal ' + i(val));
|
258
|
+
return this;
|
259
|
+
},
|
260
|
+
|
261
|
+
/**
|
262
|
+
* Assert strict equal.
|
263
|
+
*
|
264
|
+
* @param {Mixed} val
|
265
|
+
* @api public
|
266
|
+
*/
|
267
|
+
|
268
|
+
equal: function(val){
|
269
|
+
this.assert(
|
270
|
+
val === this.obj
|
271
|
+
, 'expected ' + this.inspect + ' to equal ' + i(val)
|
272
|
+
, 'expected ' + this.inspect + ' to not equal ' + i(val));
|
273
|
+
return this;
|
274
|
+
},
|
275
|
+
|
276
|
+
/**
|
277
|
+
* Assert within start to finish (inclusive).
|
278
|
+
*
|
279
|
+
* @param {Number} start
|
280
|
+
* @param {Number} finish
|
281
|
+
* @api public
|
282
|
+
*/
|
283
|
+
|
284
|
+
within: function(start, finish){
|
285
|
+
var range = start + '..' + finish;
|
286
|
+
this.assert(
|
287
|
+
this.obj >= start && this.obj <= finish
|
288
|
+
, 'expected ' + this.inspect + ' to be within ' + range
|
289
|
+
, 'expected ' + this.inspect + ' to not be within ' + range);
|
290
|
+
return this;
|
291
|
+
},
|
292
|
+
|
293
|
+
/**
|
294
|
+
* Assert typeof.
|
295
|
+
*
|
296
|
+
* @api public
|
297
|
+
*/
|
298
|
+
|
299
|
+
a: function(type){
|
300
|
+
this.assert(
|
301
|
+
type == typeof this.obj
|
302
|
+
, 'expected ' + this.inspect + ' to be a ' + type
|
303
|
+
, 'expected ' + this.inspect + ' not to be a ' + type);
|
304
|
+
return this;
|
305
|
+
},
|
306
|
+
|
307
|
+
/**
|
308
|
+
* Assert instanceof.
|
309
|
+
*
|
310
|
+
* @api public
|
311
|
+
*/
|
312
|
+
|
313
|
+
instanceof: function(constructor){
|
314
|
+
var name = constructor.name;
|
315
|
+
this.assert(
|
316
|
+
this.obj instanceof constructor
|
317
|
+
, 'expected ' + this.inspect + ' to be an instance of ' + name
|
318
|
+
, 'expected ' + this.inspect + ' not to be an instance of ' + name);
|
319
|
+
return this;
|
320
|
+
},
|
321
|
+
|
322
|
+
/**
|
323
|
+
* Assert numeric value above _n_.
|
324
|
+
*
|
325
|
+
* @param {Number} n
|
326
|
+
* @api public
|
327
|
+
*/
|
328
|
+
|
329
|
+
above: function(n){
|
330
|
+
this.assert(
|
331
|
+
this.obj > n
|
332
|
+
, 'expected ' + this.inspect + ' to be above ' + n
|
333
|
+
, 'expected ' + this.inspect + ' to be below ' + n);
|
334
|
+
return this;
|
335
|
+
},
|
336
|
+
|
337
|
+
/**
|
338
|
+
* Assert numeric value below _n_.
|
339
|
+
*
|
340
|
+
* @param {Number} n
|
341
|
+
* @api public
|
342
|
+
*/
|
343
|
+
|
344
|
+
below: function(n){
|
345
|
+
this.assert(
|
346
|
+
this.obj < n
|
347
|
+
, 'expected ' + this.inspect + ' to be below ' + n
|
348
|
+
, 'expected ' + this.inspect + ' to be above ' + n);
|
349
|
+
return this;
|
350
|
+
},
|
351
|
+
|
352
|
+
/**
|
353
|
+
* Assert string value matches _regexp_.
|
354
|
+
*
|
355
|
+
* @param {RegExp} regexp
|
356
|
+
* @api public
|
357
|
+
*/
|
358
|
+
|
359
|
+
match: function(regexp){
|
360
|
+
this.assert(
|
361
|
+
regexp.exec(this.obj)
|
362
|
+
, 'expected ' + this.inspect + ' to match ' + regexp
|
363
|
+
, 'expected ' + this.inspect + ' not to match ' + regexp);
|
364
|
+
return this;
|
365
|
+
},
|
366
|
+
|
367
|
+
/**
|
368
|
+
* Assert property "length" exists and has value of _n_.
|
369
|
+
*
|
370
|
+
* @param {Number} n
|
371
|
+
* @api public
|
372
|
+
*/
|
373
|
+
|
374
|
+
length: function(n){
|
375
|
+
this.obj.should.have.property('length');
|
376
|
+
var len = this.obj.length;
|
377
|
+
this.assert(
|
378
|
+
n == len
|
379
|
+
, 'expected ' + this.inspect + ' to have a length of ' + n + ' but got ' + len
|
380
|
+
, 'expected ' + this.inspect + ' to not have a length of ' + len);
|
381
|
+
return this;
|
382
|
+
},
|
383
|
+
|
384
|
+
/**
|
385
|
+
* Assert substring.
|
386
|
+
*
|
387
|
+
* @param {String} str
|
388
|
+
* @api public
|
389
|
+
*/
|
390
|
+
|
391
|
+
string: function(str){
|
392
|
+
this.obj.should.be.a('string');
|
393
|
+
this.assert(
|
394
|
+
~this.obj.indexOf(str)
|
395
|
+
, 'expected ' + this.inspect + ' to include ' + i(str)
|
396
|
+
, 'expected ' + this.inspect + ' to not include ' + i(str));
|
397
|
+
return this;
|
398
|
+
},
|
399
|
+
|
400
|
+
/**
|
401
|
+
* Assert property _name_ exists, with optional _val_.
|
402
|
+
*
|
403
|
+
* @param {String} name
|
404
|
+
* @param {Mixed} val
|
405
|
+
* @api public
|
406
|
+
*/
|
407
|
+
|
408
|
+
property: function(name, val){
|
409
|
+
if (this.negate && undefined !== val) {
|
410
|
+
if (undefined === this.obj[name]) {
|
411
|
+
throw new Error(this.inspect + ' has no property ' + i(name));
|
412
|
+
}
|
413
|
+
} else {
|
414
|
+
this.assert(
|
415
|
+
undefined !== this.obj[name]
|
416
|
+
, 'expected ' + this.inspect + ' to have a property ' + i(name)
|
417
|
+
, 'expected ' + this.inspect + ' to not have a property ' + i(name));
|
418
|
+
}
|
419
|
+
|
420
|
+
if (undefined !== val) {
|
421
|
+
this.assert(
|
422
|
+
val === this.obj[name]
|
423
|
+
, 'expected ' + this.inspect + ' to have a property ' + i(name)
|
424
|
+
+ ' of ' + i(val) + ', but got ' + i(this.obj[name])
|
425
|
+
, 'expected ' + this.inspect + ' to not have a property ' + i(name) + ' of ' + i(val));
|
426
|
+
}
|
427
|
+
|
428
|
+
this.obj = this.obj[name];
|
429
|
+
return this;
|
430
|
+
},
|
431
|
+
|
432
|
+
/**
|
433
|
+
* Assert own property _name_ exists.
|
434
|
+
*
|
435
|
+
* @param {String} name
|
436
|
+
* @api public
|
437
|
+
*/
|
438
|
+
|
439
|
+
ownProperty: function(name){
|
440
|
+
this.assert(
|
441
|
+
this.obj.hasOwnProperty(name)
|
442
|
+
, 'expected ' + this.inspect + ' to have own property ' + i(name)
|
443
|
+
, 'expected ' + this.inspect + ' to not have own property ' + i(name));
|
444
|
+
return this;
|
445
|
+
},
|
446
|
+
|
447
|
+
/**
|
448
|
+
* Assert that the array contains _obj_.
|
449
|
+
*
|
450
|
+
* @param {Mixed} obj
|
451
|
+
* @api public
|
452
|
+
*/
|
453
|
+
|
454
|
+
contain: function(obj){
|
455
|
+
this.obj.should.be.an.instanceof(Array);
|
456
|
+
this.assert(
|
457
|
+
~this.obj.indexOf(obj)
|
458
|
+
, 'expected ' + this.inspect + ' to contain ' + i(obj)
|
459
|
+
, 'expected ' + this.inspect + ' to not contain ' + i(obj));
|
460
|
+
return this;
|
461
|
+
},
|
462
|
+
|
463
|
+
/**
|
464
|
+
* Assert exact keys or inclusion of keys by using
|
465
|
+
* the `.include` modifier.
|
466
|
+
*
|
467
|
+
* @param {Array|String ...} keys
|
468
|
+
* @api public
|
469
|
+
*/
|
470
|
+
|
471
|
+
keys: function(keys){
|
472
|
+
var str
|
473
|
+
, ok = true;
|
474
|
+
|
475
|
+
keys = keys instanceof Array
|
476
|
+
? keys
|
477
|
+
: Array.prototype.slice.call(arguments);
|
478
|
+
|
479
|
+
if (!keys.length) throw new Error('keys required');
|
480
|
+
|
481
|
+
var actual = Object.keys(this.obj)
|
482
|
+
, len = keys.length;
|
483
|
+
|
484
|
+
// Inclusion
|
485
|
+
ok = keys.every(function(key){
|
486
|
+
return ~actual.indexOf(key);
|
487
|
+
});
|
488
|
+
|
489
|
+
// Strict
|
490
|
+
if (!this.negate && !this.includes) {
|
491
|
+
ok = ok && keys.length == actual.length;
|
492
|
+
}
|
493
|
+
|
494
|
+
// Key string
|
495
|
+
if (len > 1) {
|
496
|
+
keys = keys.map(function(key){
|
497
|
+
return i(key);
|
498
|
+
});
|
499
|
+
var last = keys.pop();
|
500
|
+
str = keys.join(', ') + ', and ' + last;
|
501
|
+
} else {
|
502
|
+
str = i(keys[0]);
|
503
|
+
}
|
504
|
+
|
505
|
+
// Form
|
506
|
+
str = (len > 1 ? 'keys ' : 'key ') + str;
|
507
|
+
|
508
|
+
// Have / include
|
509
|
+
str = (this.includes ? 'include ' : 'have ') + str;
|
510
|
+
|
511
|
+
// Assertion
|
512
|
+
this.assert(
|
513
|
+
ok
|
514
|
+
, 'expected ' + this.inspect + ' to ' + str
|
515
|
+
, 'expected ' + this.inspect + ' to not ' + str);
|
516
|
+
|
517
|
+
return this;
|
518
|
+
},
|
519
|
+
|
520
|
+
/**
|
521
|
+
* Assert that _method_ is a function.
|
522
|
+
*
|
523
|
+
* @param {String} method
|
524
|
+
* @api public
|
525
|
+
*/
|
526
|
+
|
527
|
+
respondTo: function(method){
|
528
|
+
this.assert(
|
529
|
+
'function' == typeof this.obj[method]
|
530
|
+
, 'expected ' + this.inspect + ' to respond to ' + method + '()'
|
531
|
+
, 'expected ' + this.inspect + ' to not respond to ' + method + '()');
|
532
|
+
return this;
|
533
|
+
}
|
534
|
+
};
|
535
|
+
|
536
|
+
/**
|
537
|
+
* Aliases.
|
538
|
+
*/
|
539
|
+
|
540
|
+
(function alias(name, as){
|
541
|
+
Assertion.prototype[as] = Assertion.prototype[name];
|
542
|
+
return alias;
|
543
|
+
})
|
544
|
+
('length', 'lengthOf')
|
545
|
+
('keys', 'key')
|
546
|
+
('ownProperty', 'haveOwnProperty')
|
547
|
+
('above', 'greaterThan')
|
548
|
+
('below', 'lessThan');
|