vulcan 0.2.5 → 0.3.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (211) hide show
  1. data/README.md +1 -80
  2. data/lib/vulcan/cli.rb +12 -33
  3. data/lib/vulcan/version.rb +1 -1
  4. data/server/bin/make +3 -1
  5. data/server/lib/spawner.js +4 -9
  6. data/server/node_modules/connect-form/node_modules/formidable/Readme.md +2 -13
  7. data/server/node_modules/connect-form/node_modules/formidable/lib/incoming_form.js +7 -19
  8. data/server/node_modules/connect-form/node_modules/formidable/lib/multipart_parser.js +1 -12
  9. data/server/node_modules/connect-form/node_modules/formidable/package.json +1 -1
  10. data/server/node_modules/connect-form/node_modules/formidable/test/fixture/http/special-chars-in-filename/osx-chrome-13.http +10 -0
  11. data/server/node_modules/connect-form/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-chrome-12.http +9 -0
  12. data/server/node_modules/connect-form/node_modules/formidable/test/legacy/simple/test-multipart-parser.js +1 -1
  13. data/server/node_modules/cradle/lib/cradle.js +1 -0
  14. data/server/node_modules/cradle/node_modules/vows/LICENSE +20 -0
  15. data/server/node_modules/cradle/node_modules/vows/Makefile +7 -0
  16. data/server/node_modules/cradle/node_modules/vows/README.md +39 -0
  17. data/server/node_modules/cradle/node_modules/vows/bin/vows +515 -0
  18. data/server/node_modules/cradle/node_modules/vows/lib/assert/error.js +27 -0
  19. data/server/node_modules/cradle/node_modules/vows/lib/assert/macros.js +215 -0
  20. data/server/node_modules/cradle/node_modules/vows/lib/assert/utils.js +77 -0
  21. data/server/node_modules/cradle/node_modules/vows/lib/vows.js +193 -0
  22. data/server/node_modules/cradle/node_modules/vows/lib/vows/console.js +131 -0
  23. data/server/node_modules/cradle/node_modules/vows/lib/vows/context.js +55 -0
  24. data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/file.js +29 -0
  25. data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/fragments/coverage-foot.html +2 -0
  26. data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/fragments/coverage-head.html +61 -0
  27. data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/report-html.js +54 -0
  28. data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/report-json.js +54 -0
  29. data/server/node_modules/cradle/node_modules/vows/lib/vows/coverage/report-plain.js +38 -0
  30. data/server/node_modules/cradle/node_modules/vows/lib/vows/extras.js +28 -0
  31. data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/dot-matrix.js +67 -0
  32. data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/json.js +16 -0
  33. data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/silent.js +8 -0
  34. data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/spec.js +44 -0
  35. data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/watch.js +39 -0
  36. data/server/node_modules/cradle/node_modules/vows/lib/vows/reporters/xunit.js +90 -0
  37. data/server/node_modules/cradle/node_modules/vows/lib/vows/suite.js +319 -0
  38. data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/LICENSE +20 -0
  39. data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/Makefile +4 -0
  40. data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/README.md +72 -0
  41. data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/lib/eyes.js +233 -0
  42. data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/package.json +14 -0
  43. data/server/node_modules/cradle/node_modules/vows/node_modules/eyes/test/eyes-test.js +55 -0
  44. data/server/node_modules/cradle/node_modules/vows/package.json +14 -0
  45. data/server/node_modules/cradle/node_modules/vows/test/assert-test.js +135 -0
  46. data/server/node_modules/cradle/node_modules/vows/test/fixtures/isolate/failing.js +18 -0
  47. data/server/node_modules/cradle/node_modules/vows/test/fixtures/isolate/log.js +18 -0
  48. data/server/node_modules/cradle/node_modules/vows/test/fixtures/isolate/passing.js +17 -0
  49. data/server/node_modules/cradle/node_modules/vows/test/fixtures/isolate/stderr.js +18 -0
  50. data/server/node_modules/cradle/node_modules/vows/test/isolate-test.js +140 -0
  51. data/server/node_modules/cradle/node_modules/vows/test/testInherit.js +133 -0
  52. data/server/node_modules/cradle/node_modules/vows/test/vows-error-test.js +51 -0
  53. data/server/node_modules/cradle/node_modules/vows/test/vows-test.js +374 -0
  54. data/server/node_modules/cradle/package.json +3 -3
  55. data/server/node_modules/cradle/test/cache-test.js +7 -6
  56. data/server/node_modules/cradle/test/cradle-test.js +5 -4
  57. data/server/node_modules/cradle/test/response-test.js +6 -5
  58. data/server/node_modules/express/History.md +1 -53
  59. data/server/node_modules/express/Makefile +9 -3
  60. data/server/node_modules/express/Readme.md +1 -3
  61. data/server/node_modules/express/bin/express +66 -65
  62. data/server/node_modules/express/lib/express.js +1 -1
  63. data/server/node_modules/express/lib/request.js +9 -23
  64. data/server/node_modules/express/lib/response.js +2 -3
  65. data/server/node_modules/express/lib/utils.js +0 -13
  66. data/server/node_modules/express/lib/view.js +16 -19
  67. data/server/node_modules/express/lib/view/view.js +1 -2
  68. data/server/node_modules/express/node_modules/connect/lib/connect.js +1 -1
  69. data/server/node_modules/express/node_modules/connect/lib/http.js +0 -2
  70. data/server/node_modules/express/node_modules/connect/lib/middleware/bodyParser.js +31 -135
  71. data/server/node_modules/express/node_modules/connect/lib/middleware/limit.js +1 -5
  72. data/server/node_modules/express/node_modules/connect/lib/middleware/session.js +2 -2
  73. data/server/node_modules/express/node_modules/connect/lib/middleware/static.js +21 -26
  74. data/server/node_modules/express/node_modules/connect/lib/middleware/staticCache.js +38 -91
  75. data/server/node_modules/express/node_modules/connect/lib/middleware/vhost.js +1 -1
  76. data/server/node_modules/express/node_modules/connect/lib/utils.js +4 -11
  77. data/server/node_modules/express/node_modules/connect/package.json +6 -7
  78. data/server/node_modules/express/node_modules/connect/test.js +31 -44
  79. data/server/node_modules/express/node_modules/mime/index.js +1 -0
  80. data/server/node_modules/express/node_modules/mime/mime.js +3 -3
  81. data/server/node_modules/express/node_modules/mime/{types/mime.types → mime.types} +0 -0
  82. data/server/node_modules/express/node_modules/mime/{types/node.types → node.types} +0 -17
  83. data/server/node_modules/express/node_modules/mime/package.json +10 -21
  84. data/server/node_modules/express/node_modules/mime/test.js +3 -2
  85. data/server/node_modules/express/node_modules/qs/History.md +0 -11
  86. data/server/node_modules/express/node_modules/qs/Makefile +3 -1
  87. data/server/node_modules/express/node_modules/qs/Readme.md +4 -2
  88. data/server/node_modules/express/node_modules/qs/lib/querystring.js +74 -100
  89. data/server/node_modules/express/node_modules/qs/package.json +2 -9
  90. data/server/node_modules/express/node_modules/qs/support/expresso/History.md +128 -0
  91. data/server/node_modules/express/node_modules/qs/support/expresso/Makefile +53 -0
  92. data/server/node_modules/express/node_modules/qs/support/expresso/Readme.md +61 -0
  93. data/server/node_modules/express/node_modules/qs/support/expresso/bin/expresso +856 -0
  94. data/server/node_modules/express/node_modules/qs/support/expresso/docs/api.html +1080 -0
  95. data/server/node_modules/express/node_modules/qs/support/expresso/docs/index.html +377 -0
  96. data/server/node_modules/express/node_modules/qs/support/expresso/docs/index.md +290 -0
  97. data/server/node_modules/express/node_modules/qs/support/expresso/docs/layout/foot.html +3 -0
  98. data/server/node_modules/express/node_modules/qs/support/expresso/docs/layout/head.html +42 -0
  99. data/server/node_modules/express/node_modules/qs/support/expresso/lib/bar.js +4 -0
  100. data/server/node_modules/express/node_modules/qs/support/expresso/lib/foo.js +16 -0
  101. data/server/node_modules/express/node_modules/qs/support/expresso/package.json +12 -0
  102. data/server/node_modules/express/node_modules/qs/support/expresso/test/assert.test.js +91 -0
  103. data/server/node_modules/express/node_modules/qs/support/expresso/test/async.test.js +12 -0
  104. data/server/node_modules/express/node_modules/qs/support/expresso/test/bar.test.js +13 -0
  105. data/server/node_modules/express/node_modules/qs/support/expresso/test/foo.test.js +14 -0
  106. data/server/node_modules/express/node_modules/qs/support/expresso/test/http.test.js +146 -0
  107. data/server/node_modules/express/node_modules/qs/support/expresso/test/serial/async.test.js +39 -0
  108. data/server/node_modules/express/node_modules/qs/support/expresso/test/serial/http.test.js +48 -0
  109. data/server/node_modules/express/node_modules/qs/support/should/History.md +22 -0
  110. data/server/node_modules/express/node_modules/qs/support/should/Makefile +6 -0
  111. data/server/node_modules/express/node_modules/qs/support/should/Readme.md +248 -0
  112. data/server/node_modules/express/node_modules/qs/support/should/examples/runner.js +53 -0
  113. data/server/node_modules/express/node_modules/qs/support/should/index.js +2 -0
  114. data/server/node_modules/express/node_modules/qs/support/should/lib/eql.js +91 -0
  115. data/server/node_modules/express/node_modules/qs/support/should/lib/should.js +548 -0
  116. data/server/node_modules/express/node_modules/qs/support/should/package.json +8 -0
  117. data/server/node_modules/express/node_modules/qs/support/should/test/should.test.js +358 -0
  118. data/server/node_modules/express/node_modules/qs/test/{parse.js → parse.test.js} +2 -1
  119. data/server/node_modules/express/node_modules/qs/test/{stringify.js → stringify.test.js} +0 -0
  120. data/server/node_modules/express/package.json +8 -9
  121. data/server/node_modules/node-uuid/README.md +67 -166
  122. data/server/node_modules/node-uuid/package.json +3 -5
  123. data/server/node_modules/node-uuid/{benchmark → test}/benchmark-native.c +0 -0
  124. data/server/node_modules/node-uuid/test/benchmark.js +27 -0
  125. data/server/node_modules/node-uuid/test/test.html +0 -3
  126. data/server/node_modules/node-uuid/test/test.js +57 -214
  127. data/server/node_modules/node-uuid/uuid.js +56 -225
  128. data/server/node_modules/restler/README.md +7 -20
  129. data/server/node_modules/restler/bin/restler +1 -1
  130. data/server/node_modules/restler/lib/multipartform.js +8 -9
  131. data/server/node_modules/restler/lib/restler.js +22 -64
  132. data/server/node_modules/restler/package.json +2 -2
  133. data/server/node_modules/restler/test/restler.js +2 -22
  134. data/server/node_modules/restler/test/test_helper.js +1 -20
  135. data/server/package.json +10 -10
  136. data/server/web.js +7 -30
  137. metadata +96 -89
  138. data/server/node_modules/connect-form/node_modules/formidable/test/fixture/file/plain.txt +0 -1
  139. data/server/node_modules/connect-form/node_modules/formidable/test/fixture/http/no-filename/generic.http +0 -13
  140. data/server/node_modules/connect-form/node_modules/formidable/test/fixture/js/no-filename.js +0 -3
  141. data/server/node_modules/express/node_modules/connect/node_modules/formidable/Makefile +0 -14
  142. data/server/node_modules/express/node_modules/connect/node_modules/formidable/Readme.md +0 -286
  143. data/server/node_modules/express/node_modules/connect/node_modules/formidable/TODO +0 -3
  144. data/server/node_modules/express/node_modules/connect/node_modules/formidable/benchmark/bench-multipart-parser.js +0 -70
  145. data/server/node_modules/express/node_modules/connect/node_modules/formidable/example/post.js +0 -43
  146. data/server/node_modules/express/node_modules/connect/node_modules/formidable/example/upload.js +0 -48
  147. data/server/node_modules/express/node_modules/connect/node_modules/formidable/index.js +0 -1
  148. data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/file.js +0 -61
  149. data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/incoming_form.js +0 -377
  150. data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/index.js +0 -3
  151. data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/multipart_parser.js +0 -312
  152. data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/querystring_parser.js +0 -25
  153. data/server/node_modules/express/node_modules/connect/node_modules/formidable/lib/util.js +0 -6
  154. data/server/node_modules/express/node_modules/connect/node_modules/formidable/package.json +0 -22
  155. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/common.js +0 -19
  156. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/file/funkyfilename.txt +0 -1
  157. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/file/plain.txt +0 -1
  158. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/no-filename/generic.http +0 -13
  159. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/info.md +0 -3
  160. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/osx-chrome-13.http +0 -26
  161. 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
  162. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/osx-safari-5.http +0 -23
  163. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-chrome-12.http +0 -24
  164. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-ie-7.http +0 -22
  165. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-ie-8.http +0 -22
  166. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/http/special-chars-in-filename/xp-safari-5.http +0 -22
  167. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/js/no-filename.js +0 -3
  168. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/js/special-chars-in-filename.js +0 -21
  169. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/multi_video.upload +0 -0
  170. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/fixture/multipart.js +0 -72
  171. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/integration/test-fixtures.js +0 -89
  172. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/common.js +0 -24
  173. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/integration/test-multipart-parser.js +0 -80
  174. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/simple/test-file.js +0 -104
  175. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/simple/test-incoming-form.js +0 -715
  176. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/simple/test-multipart-parser.js +0 -50
  177. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/simple/test-querystring-parser.js +0 -45
  178. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/legacy/system/test-multi-video-upload.js +0 -72
  179. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/run.js +0 -2
  180. data/server/node_modules/express/node_modules/connect/node_modules/formidable/test/unit/test-incoming-form.js +0 -63
  181. data/server/node_modules/express/node_modules/connect/node_modules/formidable/tool/record.js +0 -47
  182. data/server/node_modules/express/node_modules/mkdirp/LICENSE +0 -21
  183. data/server/node_modules/express/node_modules/mkdirp/README.markdown +0 -21
  184. data/server/node_modules/express/node_modules/mkdirp/examples/pow.js +0 -6
  185. data/server/node_modules/express/node_modules/mkdirp/examples/pow.js.orig +0 -6
  186. data/server/node_modules/express/node_modules/mkdirp/examples/pow.js.rej +0 -19
  187. data/server/node_modules/express/node_modules/mkdirp/index.js +0 -20
  188. data/server/node_modules/express/node_modules/mkdirp/package.json +0 -23
  189. data/server/node_modules/express/node_modules/mkdirp/test/mkdirp.js +0 -28
  190. data/server/node_modules/express/node_modules/mkdirp/test/race.js +0 -41
  191. data/server/node_modules/express/node_modules/mkdirp/test/rel.js +0 -32
  192. data/server/node_modules/express/node_modules/qs/test/mocha.opts +0 -2
  193. data/server/node_modules/express/testing/foo/app.js +0 -35
  194. data/server/node_modules/express/testing/foo/package.json +0 -9
  195. data/server/node_modules/express/testing/foo/public/stylesheets/style.css +0 -8
  196. data/server/node_modules/express/testing/foo/routes/index.js +0 -10
  197. data/server/node_modules/express/testing/foo/views/index.jade +0 -2
  198. data/server/node_modules/express/testing/foo/views/layout.jade +0 -6
  199. data/server/node_modules/express/testing/index.js +0 -43
  200. data/server/node_modules/express/testing/public/test.txt +0 -2971
  201. data/server/node_modules/express/testing/views/page.html +0 -1
  202. data/server/node_modules/express/testing/views/page.jade +0 -3
  203. data/server/node_modules/express/testing/views/test.md +0 -1
  204. data/server/node_modules/express/testing/views/user/index.jade +0 -1
  205. data/server/node_modules/express/testing/views/user/list.jade +0 -1
  206. data/server/node_modules/node-uuid/benchmark/README.md +0 -53
  207. data/server/node_modules/node-uuid/benchmark/bench.gnu +0 -174
  208. data/server/node_modules/node-uuid/benchmark/bench.sh +0 -34
  209. data/server/node_modules/node-uuid/benchmark/benchmark.js +0 -84
  210. data/server/node_modules/node-uuid/test/benchmark-native +0 -0
  211. 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,6 @@
1
+
2
+ test:
3
+ @./support/expresso/bin/expresso \
4
+ -I lib
5
+
6
+ .PHONY: test
@@ -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,2 @@
1
+
2
+ module.exports = require('./lib/should');
@@ -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');