commit 2657cfceb07fb709a0ab25d92a6e24cde7dafeca
parent 1fef2b4c611f33642522c38449ae192dee79ec14
Author: Ryan Wolf <rwolf@borderstylo.com>
Date: Thu, 6 Jan 2011 05:49:10 -0800
gifts to the markdown gods
Diffstat:
1 file changed, 11 insertions(+), 6 deletions(-)
diff --git a/README.md b/README.md
@@ -7,14 +7,16 @@ Ways in which Antimony kicks Selenium's ass:
* *Async.* The browser runs Javascript and Javascript is async, so why aren't your tests?
* *Knows it's an extension.* Firefox extensions run with all kinds of permissions and access, so why tie one hand behind your back and pretend you don't have the keys to the Mustang? Feel free to run tests from the context of the page most of the time, but when you want to really tear it up, Antimony has you covered.
-= Setup
+Setup
+===
* clone the repo @git clone git@repo.borderstylo.com:antimony.git@
* start the server @nodes server.js@
* build the extension @make@
* open antimony.xpi in firefox
-= Testing with Curl
+Testing with Curl
+===
You can interact with antimony by POSTing to http://localhost:1235/client
@@ -29,7 +31,8 @@ You can interact with antimony by POSTing to http://localhost:1235/client
* url: which page to run the script on (required when type: "page", ignored otherwise)
* script: string function to run. function should take a callback argument and call it (return values are ignored).
-= Testing with the Client Library
+Testing with the Client Library
+===
In addition to raw POSTs, there is a nice library in node.js for running tests.
@@ -56,10 +59,12 @@ runOnPage takes three arguments:
* a function to run on the page. two things to keep in mind with these functions is that they don't have a closure and should take a callback argument
* a callback to pass the results to
-= Extras
+Extras
+===
-In addition to the usual goodies you'll expect to be in scope (like window and document for the page and Components for the browser), Antimony provides a require a la CommonJS and a $ a la jQuery. See https://github.com/borderstylo/commonjs-ffext and https://github.com/borderstylo/windex for details.
+In addition to the usual goodies you'll expect to be in scope (like window and document for the page and Components for the browser), Antimony provides a require a la CommonJS and a $ a la jQuery. See [commonjs-ffext](https://github.com/borderstylo/commonjs-ffext) and [windex](https://github.com/borderstylo/windex) for details.
-= TODO
+TODO
+===
* ANY. ERROR. HANDLING. Antimony should return a 5** status code and a description of the Javascript error. This is a big pain at the moment, because it means you need to keep an eye on the console in the browser when running tests.
