antilles 0.1.3 → 0.1.4

data/README.md

@@ -2,13 +2,17 @@
 
 ## Overview
 
-Antilles sets up a stub HTTP server using mimic and exposes a simple interface
-to configure the server.  Antilles is meant to work with aruba to make it easier
-to test command line tools that communicate with Web APIs. 
+Antilles forks a stub HTTP server using
+[mimic](https://github.com/lukeredpath/mimic) and exposes a simple interface to
+configure the server.  Antilles is meant to work with
+[aruba](https://github.com/cucumber/aruba) to make it easier to
+test command line tools that communicate with Web APIs.
+
+Read this [blog post](http://blog.tddium.com/2011/09/04/antilles-testing-clis-that-use-web-services/) for our motivation.
 
 ## Installation
 
-Antilles works best with cucumber, but it can be used with any testing tool.
+Antilles works best with cucumber and aruba, but it can be used with any testing tool.
 
 ### Install the gem:
 
@@ -20,7 +24,7 @@ Antilles works best with cucumber, but it can be used with any testing tool.
         gem :antilles
       end
 
-### Set up environment:
+### Set up environment, for example with cucumber:
 
       # features/support/antilles.rb
       require 'antilles/cucumber'
@@ -31,7 +35,10 @@ Antilles works best with cucumber, but it can be used with any testing tool.
       end
 
 Requiring `antilles/cucumber` will automatically start a server before all
-Scenarios tagged `@mimic`, and tear down the server when the test exits.
+Scenarios tagged `@mimic`, clear stubs between tests, and tear down the server
+when the test exits.  Look at [cucumber.rb]
+(https://github.com/tddium/antilles/blob/master/lib/antilles/cucumber.rb) if you
+need to customize this behavior.
 
 ## Usage
 

data/lib/antilles.rb

@@ -9,7 +9,7 @@ class Antilles
   attr_accessor :log
 
   def initialize(port=nil, log=nil)
-    @port = port || 8080
+    @port = port || Antilles.find_available_port
     @pid_list = []
     @log = log
   end
@@ -116,6 +116,13 @@ class Antilles
     def install(*args)
       server.install(*args)
     end
+
+    def find_available_port
+      server = TCPServer.new('127.0.0.1', 0)
+      server.addr[1]
+    ensure
+      server.close if server
+    end
   end
 end
 

data/lib/antilles/version.rb

@@ -1,3 +1,3 @@
 module AntillesVersion
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

metadata

@@ -2,7 +2,7 @@
 name: antilles
 version: !ruby/object:Gem::Version 
   prerelease: 
-  version: 0.1.3
+  version: 0.1.4
 platform: ruby
 authors: 
 - Solano Labs
@@ -10,8 +10,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-09-03 00:00:00 -07:00
-default_executable: 
+date: 2011-09-28 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: json
@@ -115,7 +114,6 @@ files:
 - lib/antilles/version.rb
 - spec/antilles_spec.rb
 - spec/spec_helper.rb
-has_rdoc: true
 homepage: http://www.tddium.com/
 licenses: []
 
@@ -139,7 +137,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: tddium
-rubygems_version: 1.6.2
+rubygems_version: 1.8.10
 signing_key: 
 specification_version: 3
 summary: Easy API Mimicing for Cucumber