firebrigade_api 1.0.0

data/History.txt

@@ -0,0 +1,6 @@
+== 1.0.0 / 2007-01-30
+
+* Birthday!
+* Ruby interface to http://firebrigade.seattlerb.org
+* User-friendly cache for implementing Tinderbox
+

data/LICENSE.txt

@@ -0,0 +1,27 @@
+Copyright 2006 Eric Hodel.  All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the names of the authors nor the names of their contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE AUTHORS ``AS IS'' AND ANY EXPRESS
+OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHORS OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY,
+OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT
+OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
+BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
+WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE
+OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
+EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+

data/Manifest.txt

@@ -0,0 +1,10 @@
+History.txt
+LICENSE.txt
+Manifest.txt
+README.txt
+Rakefile
+lib/firebrigade.rb
+lib/firebrigade/api.rb
+lib/firebrigade/cache.rb
+test/test_firebrigade_api.rb
+test/test_firebrigade_cache.rb

data/README.txt

@@ -0,0 +1,33 @@
+Firebrigade API
+
+by Eric Hodel
+
+http://seattlerb.rubyforge.org/firebrigade_api
+
+== DESCRIPTION
+
+An API wrapper for http://firebrigade.seattlerb.org
+
+== FEATURES/PROBLEMS
+
+* Fully wraps Firebrigade API
+* Provides friendly cache for implementing applications like Tinderbox
+* No way to retrieve build log (easy with OpenURI)
+* No way to query for owners/projects/etc.  (Not implemented in API.)
+
+== SYNOPSYS
+
+  require 'rubygems'
+  require 'firebrigade/api'
+  
+  fa = Firebrigade::API.new 'firebrigade.seattlerb.org', 'username', 'password'
+
+== REQUIREMENTS
+
+* rc-rest
+* Connection to firebrigade.seattlerb.org
+
+== INSTALL
+
+* sudo gem install firebrigade_api
+

data/Rakefile

@@ -0,0 +1,20 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+$LOAD_PATH.unshift 'lib'
+require 'firebrigade/api'
+
+Hoe.new 'firebrigade_api', Firebrigade::API::VERSION do |p|
+  p.rubyforge_name = 'seattlerb'
+  p.author = 'Eric Hodel'
+  p.email = 'drbrain@segment7.net'
+  p.summary = 'API for Firebrigade'
+  p.description = p.paragraphs_of('README.txt', 2..5).join("\n\n")
+  p.url = p.paragraphs_of('README.txt', 0).first.split(/\n/)[1..-1]
+  p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+
+  p.extra_deps << ['rc-rest', '>= 2.1.0']
+end
+
+# vim: syntax=Ruby

data/lib/firebrigade.rb

@@ -0,0 +1,3 @@
+module Firebrigade # :nodoc:
+end
+

data/lib/firebrigade/api.rb

@@ -0,0 +1,265 @@
+require 'digest/md5'
+
+require 'rubygems'
+require 'rc_rest'
+require 'firebrigade'
+
+##
+# Firebrigade::API is an API for submitting build information to
+# http://firebrigade.seattlerb.org/
+#
+# All #get_ and #add_ methods return an instance of the Object fetched or
+# created, so get_target will return a Target object.
+#
+# All #add_ methods will return an instance of a pre-existing Object if one
+# already exists.
+
+class Firebrigade::API < RCRest
+
+  ##
+  # API error base class
+
+  class Error < RCRest::Error; end
+
+  ##
+  # Raised when you supply bad login information.
+
+  class InvalidLogin < Error; end
+
+  ##
+  # Raised when the thing you're looking for isn't there.
+
+  class NotFound < Error; end
+
+  ##
+  # Raised when your API version is incompatible with Firebrigade's
+
+  class WrongAPIVersion < Error; end
+
+  ##
+  # The version of Firebrigade::API you are using
+
+  VERSION = '1.0.0'
+
+  ##
+  # Supported Firebrigade API version.
+
+  API_VERSION = '1.0.0'
+
+  ##
+  # A Build contains information on a test run.
+
+  Build = Struct.new :id, :successful, :duration, :created_on, :version_id,
+                     :target_id
+
+  ##
+  # An Owner contains information on a Project's owner.  (A project in
+  # seattlerb's firebrigade.)
+
+  Owner = Struct.new :id, :name
+
+  ##
+  # A Project contains information about a project.  (A gem in seattlerb's
+  # firebrigade.)
+
+  Project = Struct.new :id, :name, :owner_id
+
+  ##
+  # A Target contains information about the test platform.
+
+  Target = Struct.new :id, :version, :release_date, :platform, :username
+
+  ##
+  # A Version contains the version information for a Project.
+
+  Version = Struct.new :id, :name, :project_id
+
+  ##
+  # Creates a new Firebrigade::API that will connect to +host+ with +username+
+  # and +password+.
+
+  def initialize(host, username, password)
+    @username = username
+    @password = password
+    @url = URI.parse "http://#{host}/api/REST/"
+  end
+
+  ##
+  # Adds a Build with +version_id+ and +target_id+, reporting the +successful+
+  # status, the +duration+ taken, and the +log+.
+
+  def add_build(version_id, target_id, successful, duration, log)
+    post_multipart :add_build, :version_id => version_id,
+                               :target_id => target_id,
+                               :successful => successful, :duration => duration,
+                               :log => log
+  end
+
+  ##
+  # Adds an Owner with +name+.
+
+  def add_owner(name)
+    post :add_owner, :name => name
+  end
+
+  ##
+  # Adds a Project with +name+ owned by +owner_id+.
+
+  def add_project(name, owner_id)
+    post :add_project, :name => name, :owner_id => owner_id
+  end
+
+  ##
+  # Adds a Target with a Ruby +version+, Ruby +release_date+ and Ruby
+  # +platform+.
+
+  def add_target(version, release_date, platform)
+    post :add_target, :version => version, :release_date => release_date,
+                      :platform => platform, :api_version => API_VERSION
+  end
+
+  ##
+  # Adds Version +name+ to +project_id+.
+
+  def add_version(name, project_id)
+    post :add_version, :name => name, :project_id => project_id
+  end
+
+  ##
+  # Checks for errors in +xml+ and raises an appropriate Exception.
+
+  def check_error(xml) # :nodoc:
+    error = xml.elements['/error/message']
+    return unless error
+
+    case error.text
+    when /No such \w+ exists/ then raise NotFound, error.text
+    when 'Invalid login'      then raise InvalidLogin, error.text
+    when /Your API version/   then raise WrongAPIVersion, error.text
+    else                           raise Error, error.text
+    end
+  end
+
+  ##
+  # Retrieves a Build for +version_id+ and +target_id+.
+
+  def get_build(version_id, target_id)
+    get :get_build, :version_id => version_id, :target_id => target_id
+  end
+
+  ##
+  # Retrieves an Owner matching +name+.
+
+  def get_owner(name)
+    get :get_owner, :name => name
+  end
+
+  ##
+  # Retrieves a Project matching +name+ and +owner_id+.
+
+  def get_project(name, owner_id)
+    get :get_project, :name => name, :owner_id => owner_id
+  end
+
+  ##
+  # Retrieves a Target matching +version+, +release_date+ and +platform+.
+
+  def get_target(version, release_date, platform)
+    get :get_target, :version => version, :release_date => release_date,
+                     :platform => platform, :username => @username,
+                     :api_version => API_VERSION
+  end
+
+  ##
+  # Retrieves a Version matching +name+ nad +project_id+.
+
+  def get_version(name, project_id)
+    get :get_version, :name => name, :project_id => project_id
+  end
+
+  ##
+  # Makes a multipart POST from +params+.
+
+  def make_multipart(params) # :nodoc:
+    set_hash params
+
+    super params
+  end
+
+  ##
+  # Makes a URL for +method+ and +params+.
+
+  def make_url(method, params) # :nodoc:
+    set_hash params if method.to_s =~ /^add_/
+
+    super method, params
+  end
+
+  ##
+  # Creates an Object from +xml+.
+
+  def parse_response(xml) # :nodoc:
+    ok = xml.elements['/ok']
+    raise RCRest::Error, xml.to_s if ok.nil?
+    child = ok.elements[1]
+    obj = nil
+
+    case child.name
+    when 'build' then
+      obj = Build.new
+      obj.id = child.elements['id'].text.to_i
+      obj.successful = child.elements['successful'].text == 'true'
+      obj.duration = child.elements['duration'].text.to_f
+      obj.target_id = child.elements['target_id'].text.to_i
+      obj.version_id = child.elements['version_id'].text.to_i
+      obj.created_on = Time.parse child.elements['created_on'].text
+    when 'owner' then
+      obj = Owner.new
+      obj.id = child.elements['id'].text.to_i
+      obj.name = child.elements['name'].text
+    when 'project' then
+      obj = Project.new
+      obj.id = child.elements['id'].text.to_i
+      obj.name = child.elements['name'].text
+      obj.owner_id = child.elements['owner_id'].text.to_i
+    when 'target' then
+      obj = Target.new
+      obj.id = child.elements['id'].text.to_i
+      obj.platform = child.elements['platform'].text
+      obj.release_date = child.elements['release_date'].text
+      obj.username = child.elements['username'].text
+      obj.version = child.elements['version'].text
+    when 'version' then
+      obj = Version.new
+      obj.id = child.elements['id'].text.to_i
+      obj.name = child.elements['name'].text
+      obj.project_id = child.elements['project_id'].text.to_i
+    else
+      raise "don't know how to create a #{child.name}"
+    end
+
+    obj
+  rescue NoMethodError
+    puts $!
+    puts $!.backtrace.join("\n\t")
+    puts
+    puts xml
+    raise
+  end
+
+  ##
+  # Sets the request hash value for +params+.
+
+  def set_hash(params)
+    param_values = params.sort_by { |n| n.to_s }.map do |name, value|
+      "#{name}=#{URI.escape value.to_s}"
+    end.join '&'
+
+    hash = Digest::MD5.hexdigest "#{param_values}:#{@username}:#{@password}"
+
+    params[:hash] = hash
+    params[:user] = @username
+  end
+
+end
+

data/lib/firebrigade/cache.rb

@@ -0,0 +1,89 @@
+require 'rubygems'
+require 'firebrigade/api'
+
+##
+# Firebrigade::Cache is a wrapper around Firebrigade::API that caches lookups
+# so you don't hammer the web server unnecessarily.  It handles the most
+# common operations for Tinderbox::GemTinderbox and Tinderbox::Build.
+
+class Firebrigade::Cache
+
+  ##
+  # Creates a new Firebrigade::Cache that will connect to +host+ with
+  # +username+ and +password+.
+
+  def initialize(host, username, password)
+    @fa = Firebrigade::API.new host, username, password
+
+    @owners = {} # owner => owner_id
+    @projects = {} # [project, owner_id] => project_id
+    @versions = {} # [version, project_id] => version_id
+
+    @targets = {} # [version, release_date, platform] => target_id
+    @builds = {} # [version_id, target_id] => build_id
+  end
+
+  ##
+  # Retrieves the id for a build matching +version_id+ and +target_id+.
+
+  def get_build_id(version_id, target_id)
+    build_args = [version_id, target_id]
+    return @builds[build_args] if @builds.include? build_args
+
+    begin
+      build = @fa.get_build(*build_args)
+      @builds[build_args] = build.id
+    rescue Firebrigade::API::NotFound
+      nil
+    end
+  end
+
+  ##
+  # Retrieves or creates a target matching +version+, +release_date+ and
+  # +platform+.  Returns the target's id.
+
+  def get_target_id(version = RUBY_VERSION, release_date = RUBY_RELEASE_DATE,
+                    platform = RUBY_PLATFORM)
+    target_args = [version, release_date, platform]
+    return @targets[target_args] if @targets.include? target_args
+
+    target = @fa.add_target(*target_args)
+
+    @targets[target_args] = target.id
+  end
+
+  ##
+  # Fetches or creates a version (including project and owner) for the
+  # Gem::Specification +spec+ and returns the version's id.
+
+  def get_version_id(spec)
+    owner = spec.rubyforge_project
+    project = spec.name
+    version = spec.version.to_s
+
+    owner_id = @owners[owner]
+
+    if owner_id.nil? then
+      owner_id = @fa.add_owner(owner).id
+      @owners[owner] = owner_id
+    end
+
+    project_id = @projects[[owner_id, project]]
+
+    if project_id.nil? then
+      project_id = @fa.add_project(project, owner_id).id
+      @projects[[owner_id, project]] = project_id
+    end
+
+    version_id = @versions[[project_id, version]]
+
+    if version_id.nil? then
+      version_id = @fa.add_version(version, project_id).id
+      @versions[[project_id, version]] = version_id
+    end
+
+    version_id
+  end
+
+end
+

data/test/test_firebrigade_api.rb

@@ -0,0 +1,446 @@
+require 'test/unit'
+
+require 'rubygems'
+require 'rc_rest/uri_stub'
+require 'rc_rest/net_http_stub'
+
+require 'firebrigade/api'
+
+class TestFirebrigadeAPI < Test::Unit::TestCase
+
+  def setup
+    URI::HTTP.responses = []
+    URI::HTTP.uris = []
+
+    Net::HTTP.params = []
+    Net::HTTP.paths = []
+    Net::HTTP.responses = []
+
+    @fa = Firebrigade::API.new 'firebrigade.example.com', 'username', 'password'
+  end
+
+  def test_add_build
+    now = Time.at Time.now.to_i
+
+    Net::HTTP.responses << <<-EOF.strip
+<ok>
+  <build>
+    <id>100</id>
+    <created_on>#{now}</created_on>
+    <duration>1.5</duration>
+    <successful>true</successful>
+    <target_id>100</target_id>
+    <version_id>101</version_id>
+  </build>
+</ok>
+    EOF
+
+    build = Firebrigade::API::Build.new
+    build.id = 100
+    build.successful = true
+    build.duration = 1.5
+    build.target_id = 100
+    build.created_on = now
+    build.version_id = 101
+
+    srand 0
+
+    assert_equal build, @fa.add_build(101, 100, true, 1.5, 'did the stuff')
+
+    assert_equal true, Net::HTTP.responses.empty?
+
+    assert_equal 1, Net::HTTP.paths.length
+    assert_equal '/api/REST/add_build', Net::HTTP.paths.first
+
+    assert_equal 1, Net::HTTP.params.length
+
+    expected = <<-EOF.strip
+--ac_2f_75_c0_43_fb_c3_67\r
+Content-Disposition: form-data; name="duration"\r
+\r
+1.5\r
+--ac_2f_75_c0_43_fb_c3_67\r
+Content-Disposition: form-data; name="hash"\r
+\r
+1a905df729030146910ddac44e6b0d67\r
+--ac_2f_75_c0_43_fb_c3_67\r
+Content-Disposition: form-data; name="log"\r
+\r
+did the stuff\r
+--ac_2f_75_c0_43_fb_c3_67\r
+Content-Disposition: form-data; name="successful"\r
+\r
+true\r
+--ac_2f_75_c0_43_fb_c3_67\r
+Content-Disposition: form-data; name="target_id"\r
+\r
+100\r
+--ac_2f_75_c0_43_fb_c3_67\r
+Content-Disposition: form-data; name="user"\r
+\r
+username\r
+--ac_2f_75_c0_43_fb_c3_67\r
+Content-Disposition: form-data; name="version_id"\r
+\r
+101\r
+--ac_2f_75_c0_43_fb_c3_67--
+    EOF
+
+    assert_equal expected, Net::HTTP.params.first
+  end
+
+  def test_add_owner
+    Net::HTTP.responses << <<-EOF.strip
+<ok>
+  <owner>
+    <id>100</id>
+    <name>foo</name>
+  </owner>
+</ok>
+    EOF
+
+    owner = Firebrigade::API::Owner.new
+    owner.id = 100
+    owner.name = 'foo'
+
+    assert_equal owner, @fa.add_owner('foo')
+
+    assert_equal true, Net::HTTP.responses.empty?
+
+    assert_equal 1, Net::HTTP.paths.length
+    assert_equal '/api/REST/add_owner', Net::HTTP.paths.first
+
+    assert_equal 1, Net::HTTP.params.length
+    assert_equal 'hash=9c5fbef18346fb68d632b625067a368a&name=foo&user=username',
+                 Net::HTTP.params.first
+  end
+
+  def test_add_project
+    Net::HTTP.responses << <<-EOF.strip
+<ok>
+  <project>
+    <id>100</id>
+    <name>foo</name>
+    <owner_id>101</owner_id>
+  </project>
+</ok>
+    EOF
+
+    project = Firebrigade::API::Project.new
+    project.id = 100
+    project.name = 'foo'
+    project.owner_id = 101
+
+    assert_equal project, @fa.add_project('foo', 101)
+
+    assert_equal true, Net::HTTP.responses.empty?
+
+    assert_equal 1, Net::HTTP.paths.length
+    assert_equal '/api/REST/add_project', Net::HTTP.paths.first
+
+    assert_equal 1, Net::HTTP.params.length
+    assert_equal 'hash=a623ed5872e79e8d3bede063c95a4aef&name=foo&owner_id=101&user=username',
+                 Net::HTTP.params.first
+  end
+
+  def test_add_target
+    Net::HTTP.responses << <<-EOF.strip
+<ok>
+  <target>
+    <id>100</id>
+    <platform>powerpc-darwin8.7.0</platform>
+    <release_date>2006-08-25</release_date>
+    <username>drbrain</username>
+    <version>1.8.5</version>
+  </target>
+</ok>
+    EOF
+
+    target_platform = 'powerpc-darwin8.7.0'
+    target_release_date = '2006-08-25'
+    target_version = '1.8.5'
+
+    target = Firebrigade::API::Target.new
+    target.id = 100
+    target.platform = 'powerpc-darwin8.7.0'
+    target.release_date = '2006-08-25'
+    target.version = '1.8.5'
+    target.username = 'drbrain'
+
+    assert_equal target, @fa.add_target(target_version, target_release_date,
+                                        target_platform)
+
+    assert_equal true, Net::HTTP.responses.empty?
+
+    assert_equal 1, Net::HTTP.paths.length
+    assert_equal '/api/REST/add_target', Net::HTTP.paths.first
+
+    assert_equal 1, Net::HTTP.params.length
+    assert_equal 'api_version=1.0.0&hash=c600c401ac061e996ee3cfc87493ca85&platform=powerpc-darwin8.7.0&release_date=2006-08-25&user=username&version=1.8.5',
+                 Net::HTTP.params.first
+  end
+
+  def test_add_target_bad_hash
+    Net::HTTP.responses << <<-EOF.strip
+<error>
+  <message>Invalid login</message>
+</error>
+    EOF
+
+    e = assert_raise Firebrigade::API::InvalidLogin do
+      @fa.add_target 'a', 'b', 'c'
+    end
+
+    assert_equal true, Net::HTTP.responses.empty?
+
+    assert_equal 1, Net::HTTP.paths.length
+    assert_equal '/api/REST/add_target', Net::HTTP.paths.first
+
+    assert_equal 1, Net::HTTP.params.length
+    assert_equal 'api_version=1.0.0&hash=f873667a60f58a38b82a38ba585a0a36&platform=c&release_date=b&user=username&version=a',
+                 Net::HTTP.params.first
+
+    assert_equal 'Invalid login', e.message
+  end
+
+  def test_add_target_wrong_version
+    Net::HTTP.responses << <<-EOF.strip
+<error>
+  <message>Your API version 1.0.0 is not compatible with this Firebrigade API, = 2.0.0</message>
+</error>
+    EOF
+
+    e = assert_raise Firebrigade::API::WrongAPIVersion do
+      @fa.add_target 'a', 'b', 'c'
+    end
+
+    assert_equal true, Net::HTTP.responses.empty?
+
+    assert_equal 1, Net::HTTP.paths.length
+    assert_equal '/api/REST/add_target', Net::HTTP.paths.first
+
+    assert_equal 1, Net::HTTP.params.length
+    assert_equal 'api_version=1.0.0&hash=f873667a60f58a38b82a38ba585a0a36&platform=c&release_date=b&user=username&version=a',
+                 Net::HTTP.params.first
+
+    assert_equal 'Your API version 1.0.0 is not compatible with this Firebrigade API, = 2.0.0',
+                 e.message
+  end
+
+  def test_add_version
+    Net::HTTP.responses << <<-EOF.strip
+<ok>
+  <version>
+    <id>100</id>
+    <name>1.0.0</name>
+    <project_id>101</project_id>
+  </version>
+</ok>
+    EOF
+
+    version_name = '1.0.0'
+
+    version = Firebrigade::API::Version.new
+    version.id = 100
+    version.name = version_name
+    version.project_id = 101
+
+    assert_equal version, @fa.add_version(version_name, 101)
+
+    assert_equal true, Net::HTTP.responses.empty?
+
+    assert_equal 1, Net::HTTP.paths.length
+    assert_equal '/api/REST/add_version', Net::HTTP.paths.first
+
+    assert_equal 1, Net::HTTP.params.length
+    assert_equal 'hash=db2a1eecd0492a141b186ec5f21fea61&name=1.0.0&project_id=101&user=username',
+                 Net::HTTP.params.first
+  end
+
+  def test_get_build
+    now = Time.at Time.now.to_i
+
+    URI::HTTP.responses << <<-EOF.strip
+<ok>
+  <build>
+    <id>100</id>
+    <created_on>#{now}</created_on>
+    <duration>1.5</duration>
+    <successful>true</successful>
+    <target_id>100</target_id>
+    <version_id>101</version_id>
+  </build>
+</ok>
+    EOF
+
+    build = Firebrigade::API::Build.new
+    build.id = 100
+    build.successful = true
+    build.duration = 1.5
+    build.target_id = 100
+    build.created_on = now
+    build.version_id = 101
+
+    assert_equal build, @fa.get_build(101, 100)
+
+    assert_equal true, URI::HTTP.responses.empty?
+
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://firebrigade.example.com/api/REST/get_build?target_id=100&version_id=101',
+                 URI::HTTP.uris.first
+  end
+
+  def test_get_owner
+    URI::HTTP.responses << <<-EOF.strip
+<ok>
+  <owner>
+    <id>100</id>
+    <name>foo</name>
+  </owner>
+</ok>
+    EOF
+
+    owner_name = 'foo'
+    owner_version = '0.0.2'
+
+    owner = Firebrigade::API::Owner.new
+    owner.id = 100
+    owner.name = owner_name
+
+    assert_equal owner, @fa.get_owner(owner_name)
+
+    assert_equal true, URI::HTTP.responses.empty?
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://firebrigade.example.com/api/REST/get_owner?name=foo',
+                 URI::HTTP.uris.first
+  end
+
+  def test_get_project
+    URI::HTTP.responses << <<-EOF.strip
+<ok>
+  <project>
+    <id>100</id>
+    <name>foo</name>
+    <owner_id>101</owner_id>
+  </project>
+</ok>
+    EOF
+
+    project_name = 'foo'
+    project_version = '0.0.2'
+    project_owner_id = 101
+
+    project = Firebrigade::API::Project.new
+    project.id = 100
+    project.name = project_name
+    project.owner_id = project_owner_id
+
+    assert_equal project, @fa.get_project(project_name, project_owner_id)
+
+    assert_equal true, URI::HTTP.responses.empty?
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://firebrigade.example.com/api/REST/get_project?name=foo&owner_id=101',
+                 URI::HTTP.uris.first
+  end
+
+  def test_get_target
+    URI::HTTP.responses << <<-EOF.strip
+<ok>
+  <target>
+    <id>100</id>
+    <platform>powerpc-darwin8.7.0</platform>
+    <release_date>2006-08-25</release_date>
+    <username>drbrain</username>
+    <version>1.8.5</version>
+  </target>
+</ok>
+    EOF
+
+    target_platform = 'powerpc-darwin8.7.0'
+    target_release_date = '2006-08-25'
+    target_username = 'drbrain'
+    target_version = '1.8.5'
+
+    target = Firebrigade::API::Target.new
+    target.id = 100
+    target.platform = target_platform
+    target.release_date = target_release_date
+    target.username = target_username
+    target.version = target_version
+
+    assert_equal target, @fa.get_target(target_version, target_release_date,
+                                        target_platform)
+
+    assert_equal true, URI::HTTP.responses.empty?
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://firebrigade.example.com/api/REST/get_target?api_version=1.0.0&platform=powerpc-darwin8.7.0&release_date=2006-08-25&username=username&version=1.8.5',
+                 URI::HTTP.uris.first
+  end
+
+  def test_get_target_wrong_version
+    URI::HTTP.responses << <<-EOF.strip
+<error>
+  <message>Your API version 1.0.0 is not compatible with this Firebrigade API, = 2.0.0</message>
+</error>
+    EOF
+
+    e = assert_raises Firebrigade::API::WrongAPIVersion do
+      @fa.get_target 'a', 'b', 'c'
+    end
+
+    assert_equal true, URI::HTTP.responses.empty?
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://firebrigade.example.com/api/REST/get_target?api_version=1.0.0&platform=c&release_date=b&username=username&version=a',
+                 URI::HTTP.uris.first
+
+    assert_equal 'Your API version 1.0.0 is not compatible with this Firebrigade API, = 2.0.0',
+                 e.message
+  end
+
+  def test_get_target_nonexistent
+    URI::HTTP.responses << <<-EOF.strip
+<error>
+  <message>No such target exists</message>
+</error>
+    EOF
+
+    e = assert_raises Firebrigade::API::NotFound do
+      @fa.get_target 'a', 'b', 'c'
+    end
+
+    assert_equal true, URI::HTTP.responses.empty?
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://firebrigade.example.com/api/REST/get_target?api_version=1.0.0&platform=c&release_date=b&username=username&version=a',
+                 URI::HTTP.uris.first
+
+    assert_equal 'No such target exists', e.message
+  end
+
+  def test_get_version
+    URI::HTTP.responses << <<-EOF.strip
+<ok>
+  <version>
+    <id>100</id>
+    <name>1.0.0</name>
+    <project_id>101</project_id>
+  </version>
+</ok>
+    EOF
+
+    version_name = '1.0.0'
+
+    version = Firebrigade::API::Version.new
+    version.id = 100
+    version.name = version_name
+    version.project_id = 101
+
+    assert_equal version, @fa.get_version(version_name, 101)
+
+    assert_equal true, URI::HTTP.responses.empty?
+    assert_equal 1, URI::HTTP.uris.length
+    assert_equal 'http://firebrigade.example.com/api/REST/get_version?name=1.0.0&project_id=101',
+                 URI::HTTP.uris.first
+  end
+
+end
+

data/test/test_firebrigade_cache.rb

@@ -0,0 +1,141 @@
+require 'test/unit'
+require 'rubygems'
+require 'rc_rest/net_http_stub'
+require 'rc_rest/uri_stub'
+
+require 'firebrigade/cache'
+
+class Firebrigade::Cache
+  attr_accessor :owners, :projects, :versions
+end
+
+class TestFirebrigadeCache < Test::Unit::TestCase
+
+  def setup
+    Net::HTTP.params = []
+    Net::HTTP.paths = []
+    Net::HTTP.responses = []
+
+    URI::HTTP.uris = []
+    URI::HTTP.responses = []
+
+    @spec = Gem::Specification.new
+    @spec.name = 'gem_one'
+    @spec.version = '0.0.2'
+    @spec.rubyforge_project = 'gem'
+
+    @fc = Firebrigade::Cache.new 'firebrigade.example.com', 'username',
+                                 'password'
+  end
+
+  def test_get_build_id
+    URI::HTTP.responses << <<-EOF
+<ok>
+  <build>
+    <id>5</id>
+    <created_on>#{Time.now}</created_on>
+    <duration>1.5</duration>
+    <successful>true</successful>
+    <target_id>4</target_id>
+    <version_id>3</version_id>
+  </build>
+</ok>
+    EOF
+
+    assert_equal 5, @fc.get_build_id(3, 4)
+
+    assert_equal 'http://firebrigade.example.com/api/REST/get_build?target_id=4&version_id=3',
+                 URI::HTTP.uris.shift
+
+    URI::HTTP.responses << <<-EOF
+<error>
+  <message>No such build exists</message>
+</error>
+    EOF
+
+    assert_equal nil, @fc.get_build_id(-1, 4)
+
+    assert_equal 'http://firebrigade.example.com/api/REST/get_build?target_id=4&version_id=-1',
+                 URI::HTTP.uris.shift
+  end
+
+  def test_get_target_id
+    Net::HTTP.responses << <<-EOF
+<ok>
+  <target>
+    <id>5</id>
+    <platform>fake platform</platform>
+    <release_date>fake release_date</release_date>
+    <username>fake username</username>
+    <version>fake version</version>
+  </target>
+</ok>
+    EOF
+
+    assert_equal 5, @fc.get_target_id
+  end
+
+  def test_get_version_id_cached
+    @fc.owners['gem'] = 1
+    @fc.projects[[1, 'gem_one']] = 2
+    @fc.versions[[2, '0.0.2']] = 3
+
+    version_id = @fc.get_version_id @spec
+    assert_equal 3, version_id
+  end
+
+  def test_get_version_id_no_data
+    Net::HTTP.responses << <<-EOF
+<ok>
+  <owner>
+    <id>1</id>
+    <name>gem</name>
+  </owner>
+</ok>
+    EOF
+
+    Net::HTTP.responses << <<-EOF
+<ok>
+  <project>
+    <id>2</id>
+    <name>gem_one</name>
+    <owner_id>1</owner_id>
+  </project>
+</ok>
+    EOF
+
+    Net::HTTP.responses << <<-EOF
+<ok>
+  <version>
+    <id>3</id>
+    <name>0.0.2</name>
+    <project_id>2</project_id>
+  </version>
+</ok>
+    EOF
+
+    version_id = @fc.get_version_id @spec
+    assert_equal 3, version_id
+
+    assert_equal 1, @fc.owners['gem']
+    assert_equal 2, @fc.projects[[1, 'gem_one']]
+    assert_equal 3, @fc.versions[[2, '0.0.2']]
+
+    assert_equal 3, Net::HTTP.paths.length
+
+    assert_equal '/api/REST/add_owner', Net::HTTP.paths.shift
+    assert_equal '/api/REST/add_project', Net::HTTP.paths.shift
+    assert_equal '/api/REST/add_version', Net::HTTP.paths.shift
+
+    assert_equal 3, Net::HTTP.params.length
+
+    assert_equal 'hash=6e434d0379ccd7ac7d22dbd7923b5ea6&name=gem&user=username',
+                 Net::HTTP.params.shift
+    assert_equal 'hash=749f7b36b1cf1a274bbcd805c3a42a50&name=gem_one&owner_id=1&user=username',
+                 Net::HTTP.params.shift
+    assert_equal 'hash=67467aef2fdc65b98c80778301e2eff1&name=0.0.2&project_id=2&user=username',
+                 Net::HTTP.params.shift
+  end
+
+end
+

metadata

@@ -0,0 +1,73 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.1
+specification_version: 1
+name: firebrigade_api
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+date: 2007-01-30 00:00:00 -08:00
+summary: API for Firebrigade
+require_paths: 
+- lib
+email: drbrain@segment7.net
+homepage: 
+rubyforge_project: seattlerb
+description: http://seattlerb.rubyforge.org/firebrigade_api  == DESCRIPTION  An API wrapper for http://firebrigade.seattlerb.org  == FEATURES/PROBLEMS
+autorequire: 
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Eric Hodel
+files: 
+- History.txt
+- LICENSE.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- lib/firebrigade.rb
+- lib/firebrigade/api.rb
+- lib/firebrigade/cache.rb
+- test/test_firebrigade_api.rb
+- test/test_firebrigade_cache.rb
+test_files: 
+- test/test_firebrigade_api.rb
+- test/test_firebrigade_cache.rb
+rdoc_options: []
+
+extra_rdoc_files: []
+
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rc-rest
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 2.1.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Version::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.7
+    version: