Test adapter

docs/adapters.md

@@ -4,9 +4,10 @@ Adapters are the interface to the service you want your hubot to run on.
 
 ## Official Adapters
 
-Hubot includes two official adapters:
+Hubot includes three official adapters:
 
 * [Shell](adapters/shell.md), i.e. for use with development
+* [Test](adapters/test.md), i.e. for use with testing
 * [Campfire](adapters/campfire.md)
 
 ## Third-party Adapters

docs/adapters/test.md

@@ -0,0 +1,35 @@
+# Adapters: Test
+
+The test adapter provides a simple way to test what hubot would've responded to in your own scripts.
+It can be useful for testing scripts that you distribute via npm.
+
+## Getting Started
+
+```coffeescript
+Path  = require("path")
+Robot = require("hubot").Robot
+
+pkg = require Path.join __dirname, "..", 'package.json'
+testAdapter = Path.join(__dirname, "adapters")
+
+Version = pkg.version
+
+describe "The Hubot Script", () ->
+  robot = null
+  beforeEach () ->
+    robot = new Robot testAdapter, "test", false, "hubot"
+    robot.loadFile  Path.join(__dirname, "..", "src"), "script.coffee"
+    robot.run()
+
+  afterEach () ->
+    robot.shutdown()
+
+  it "displays the version", () ->
+    robot.adapter.receiveText("hubot deploy:version")
+    expected = "hubot-deploy v#{Version}/hubot v2.7.5/node v0.10.21"
+    assert.equal expected, robot.adapter.history
+```
+
+## Configuring
+
+This adapter doesn't require any configuration.

src/adapters/test.coffee

@@ -0,0 +1,25 @@
+Robot         = require '../robot'
+Adapter       = require '../adapter'
+{TextMessage} = require '../message'
+
+class Test extends Adapter
+  send: (envelope, strings...) ->
+    for str in strings
+      @history.push str
+
+  reply: (envelope, strings...) ->
+    strings = strings.map (s) -> "#{envelope.user.name}: #{s}"
+    @send envelope, strings...
+
+  receiveText: (input) ->
+    user = @robot.brain.userForId '1', name: 'test', room: 'Test'
+    textMessage = new TextMessage user, input, 'messageId'
+    @receive textMessage
+
+  run: ->
+    self = @
+    @history = [ ]
+    self.emit 'connected'
+
+exports.use = (robot) ->
+  new Test robot

src/robot.coffee

@@ -13,6 +13,7 @@ Response = require './response'
 HUBOT_DEFAULT_ADAPTERS = [
   'campfire'
   'shell'
+  'test'
 ]
 
 HUBOT_DOCUMENTATION_SECTIONS = [