Browse files

Updated Readme

  • Loading branch information...
lukebayes committed Feb 16, 2011
1 parent 78543eb commit adb98a57e2251e81a903df3a30f27bbd41ec896c
Showing with 38 additions and 0 deletions.
  1. +38 −0 README.textile
@@ -0,0 +1,38 @@
+h1. Node Should
+'Node Should' is a(nother) implementation of "Shoulda": in JavaScript and
+specifically in the "NodeJS": runtime environment.
+This testing framework was developed test-first based on the examples
+found in the "NodeJs library": itself.
+There are most definitely bugs and problems in this code, but it is
+working well enough for me at the moment. If you encounter an issue,
+please let me know by "messaging me on github": . Forks and pull requests
+are definitely welcome.
+The main problem that I set out to solve with this library, is one
+of composite test environments. I really appreciate how Shoulda
+enables shared, general setup code and more specific leaves that
+can take advantage of it.
+Another major reason for building this framework was inherently
+supporting asynchronous tests.
+The ad-hoc assertion testing found in the NodeJs library code is
+obviously good-enough to get by, but suffers from problems with
+error localization, especially when something asynchronous fails.
+To use this framework, take a look at the project in the example/
+You'll probably want to copy the runner.js file found there into
+your project, and add the files found in src/ to a folder in your
+lib/ like, lib/node-should, and get that into your load path.
+Once you have taken these two steps, you should be able to run
+your test harness with:
+ node runner.js

0 comments on commit adb98a5

Please sign in to comment.