newjs 1.0.0

data/History.txt

@@ -0,0 +1,4 @@
+== 0.0.1 2008-02-14
+
+* 1 major enhancement:
+  * Initial release

data/License.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Dr Nic Williams
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Manifest.txt

@@ -0,0 +1,68 @@
+History.txt
+License.txt
+Manifest.txt
+README.txt
+Rakefile
+app_generators/newjs/USAGE
+app_generators/newjs/newjs_generator.rb
+app_generators/newjs/templates/History.txt.erb
+app_generators/newjs/templates/License.txt.erb
+app_generators/newjs/templates/README.txt
+app_generators/newjs/templates/Rakefile.erb
+app_generators/newjs/templates/config/javascript_test_autotest.yml.sample
+app_generators/newjs/templates/lib/jstest.rb
+app_generators/newjs/templates/lib/protodoc.rb
+app_generators/newjs/templates/script/js_autotest
+app_generators/newjs/templates/script/rstakeout
+app_generators/newjs/templates/src/HEADER.erb
+app_generators/newjs/templates/src/library.js.erb
+app_generators/newjs/templates/tasks/environment.rake
+app_generators/newjs/templates/tasks/javascript_test_autotest_tasks.rake
+app_generators/newjs/templates/test/assets/prototype.js
+app_generators/newjs/templates/test/assets/unittest.css
+app_generators/newjs/templates/test/assets/unittest.js
+bin/newjs
+config/hoe.rb
+config/requirements.rb
+javascript_test_generators/javascript_test/USAGE
+javascript_test_generators/javascript_test/javascript_test_generator.rb
+javascript_test_generators/javascript_test/templates/test/test.html.erb
+lib/newjs.rb
+lib/newjs/autotest.rb
+lib/newjs/autotest/javascript_test_autotest.rb
+lib/newjs/autotest/javascript_test_autotest/config.rb
+lib/newjs/autotest/javascript_test_ext.rb
+lib/newjs/jstest.rb
+lib/newjs/version.rb
+log/debug.log
+newjs_generators/install_website/USAGE
+newjs_generators/install_website/install_website_generator.rb
+newjs_generators/install_website/templates/script/txt2html
+newjs_generators/install_website/templates/script/win_script.cmd
+newjs_generators/install_website/templates/tasks/website.rake
+newjs_generators/install_website/templates/website/index.html
+newjs_generators/install_website/templates/website/index.txt
+newjs_theme_generators/plain_theme/USAGE
+newjs_theme_generators/plain_theme/plain_theme_generator.rb
+newjs_theme_generators/plain_theme/templates/website/javascripts/rounded_corners_lite.inc.js
+newjs_theme_generators/plain_theme/templates/website/stylesheets/screen.css
+newjs_theme_generators/plain_theme/templates/website/template.html.erb
+script/destroy
+script/generate
+script/txt2html
+setup.rb
+tasks/deployment.rake
+tasks/environment.rake
+tasks/website.rake
+test/test_generator_helper.rb
+test/test_helper.rb
+test/test_install_website_generator.rb
+test/test_javascript_test_generator.rb
+test/test_newjs_generator.rb
+test/test_plain_theme_generator.rb
+website/images/example-unittest-log.jpg
+website/index.html
+website/index.txt
+website/javascripts/rounded_corners_lite.inc.js
+website/stylesheets/screen.css
+website/template.html.erb

data/README.txt

@@ -0,0 +1,9 @@
+Description:
+    The +newjs+ command creates a new JavaScript project/application
+    with a default directory structure and configuration at the path you specify.
+
+Example:
+    +newjs path/to/my-app-name+
+
+    This generates a skeletal JavaScript project/application
+    installation in path/to/my-app-name

data/Rakefile

@@ -0,0 +1,4 @@
+require 'config/requirements'
+require 'config/hoe' # setup Hoe + all gem configuration
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/app_generators/newjs/USAGE

@@ -0,0 +1,9 @@
+Description:
+    The 'newjs' command creates a new JavaScript project/application
+    with a default directory structure and configuration at the path you specify.
+
+Example:
+    newjs path/to/my-app-name
+
+    This generates a skeletal JavaScript project/application
+    installation in path/to/my-app-name

data/app_generators/newjs/newjs_generator.rb

@@ -0,0 +1,113 @@
+class NewjsGenerator < RubiGen::Base
+  DEFAULT_SHEBANG = File.join(Config::CONFIG['bindir'],
+                              Config::CONFIG['ruby_install_name'])
+  
+  default_options :shebang => DEFAULT_SHEBANG,
+                  :author => nil,
+                  :email       => nil,
+                  :version     => '0.0.1'
+  
+  
+  attr_reader :name, :module_name
+  attr_reader :version, :version_str, :author, :email
+  attr_reader :title, :url
+  
+  
+  def initialize(runtime_args, runtime_options = {})
+    super
+    usage if args.empty?
+    @destination_root = File.expand_path(args.shift)
+    @name = base_name
+    @module_name = name.camelize
+    extract_options
+    @title ||= @name.titleize
+    @url   ||= "http://NOTE-ENTER-URL.com"
+  end
+
+  def manifest
+    script_options = { :chmod => 0755, :shebang => options[:shebang] == DEFAULT_SHEBANG ? nil : options[:shebang] }
+    windows        = (RUBY_PLATFORM =~ /dos|win32|cygwin/i) || (RUBY_PLATFORM =~ /(:?mswin|mingw)/)
+    
+    record do |m|
+      # Ensure appropriate folder(s) exists
+      m.directory ''
+      BASEDIRS.each { |path| m.directory path }
+
+      # Create stubs
+      # m.template "template.rb",  "some_file_after_erb.rb"
+      # m.file     "file",         "some_file_copied"
+      m.file_copy_each %w[unittest.css unittest.js prototype.js], "test/assets"
+      m.file_copy_each %w[javascript_test_autotest_tasks.rake environment.rake], "tasks"
+      m.file_copy_each %w[javascript_test_autotest.yml.sample], "config"
+      m.file_copy_each %w[protodoc.rb jstest.rb], "lib"
+      m.file_copy_each %w[README.txt]
+      m.template_copy_each %w[Rakefile.erb History.txt.erb License.txt.erb]
+      m.template_copy_each %w[HEADER.erb], "src"
+      m.template "src/library.js.erb", "src/#{name}.js"
+      
+      %w[rstakeout js_autotest].each do |file|
+        m.template "script/#{file}",        "script/#{file}", script_options
+        m.template "script/win_script.cmd", "script/#{file}.cmd", 
+          :assigns => { :filename => file } if windows
+      end
+      
+      m.dependency "install_rubigen_scripts", 
+        [destination_root, 'javascript', 'javascript_test', 'newjs', 'newjs_theme'], 
+        :shebang => options[:shebang], :collision => :force
+    end
+  end
+
+  protected
+    def banner
+      <<-EOS
+Creates a JavaScript project.
+
+USAGE: #{spec.name} name"
+EOS
+    end
+
+    def add_options!(opts)
+      opts.separator ''
+      opts.separator 'Options:'
+      # For each option below, place the default
+      # at the top of the file next to "default_options"
+      opts.on("-a", "--author=\"Your Name\"", String,
+              "Default: none") { |x| options[:author] = x }
+      opts.on("-e", "--email=\"your@email.com\"", String,
+              "Your email to be inserted into generated files.",
+              "Default: ~/.rubyforge/user-config.yml[email]") { |x| options[:email] = x }
+      opts.on("-t", "--title=\"Project Title\"", String,
+              "Human-readable/marketing name for project.",
+              "Default: Project Name") { |x| options[:title] = x }
+      opts.on("-u", "--url=\"http://url-to-project.com\"", String,
+              "Default: http://NOTE-ENTER-URL.com") { |x| options[:url] = x }
+      opts.on("-v", "--version", "Show the #{File.basename($0)} version number and quit.")
+      opts.on("-V", "--set-version=X.Y.Z", String,
+              "Initial version of the project you are creating.",
+              "Default: 0.0.1") { |x| options[:version] = x }
+    end
+    
+    def extract_options
+      @version           = options[:version].to_s.split(/\./)
+      @version_str       = @version.join('.')
+      @author            = options[:author]
+      @email             = options[:email]
+      unless @author && @email
+        require 'newgem/rubyforge'
+        rubyforge_config = Newgem::Rubyforge.new
+        @author ||= rubyforge_config.full_name
+        @email  ||= rubyforge_config.email
+      end
+    end
+
+    # Installation skeleton.  Intermediate directories are automatically
+    # created so don't sweat their absence here.
+    BASEDIRS = %w(
+      config
+      lib
+      src
+      script
+      tasks
+      test/assets
+    )
+end

data/app_generators/newjs/templates/History.txt.erb

@@ -0,0 +1,4 @@
+== <%= version_str %> <%= Date.today %>
+
+* 1 major enhancement:
+  * Initial release

data/app_generators/newjs/templates/License.txt.erb

@@ -0,0 +1,20 @@
+Copyright (c) <%= Time.now.year %> <%= author %>
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/app_generators/newjs/templates/README.txt

@@ -0,0 +1 @@
+README

data/app_generators/newjs/templates/Rakefile.erb

@@ -0,0 +1,82 @@
+require 'rubygems'
+begin
+  require 'rake'
+rescue LoadError
+  puts 'This script should only be accessed via the "rake" command.'
+  puts 'Installation: gem install rake -y'
+  exit
+end
+require 'rake'
+require 'rake/clean'
+require 'rake/packagetask'
+
+$:.unshift File.dirname(__FILE__) + "/lib"
+
+APP_ROOT     = File.expand_path(File.dirname(__FILE__))
+APP_SRC_DIR  = File.join(APP_ROOT, 'src')
+APP_DIST_DIR = File.join(APP_ROOT, 'dist')
+APP_PKG_DIR  = File.join(APP_ROOT, 'pkg')
+APP_VERSION  = '<%= version_str %>'
+
+task :default => [:dist, :package, :clean_package_source]
+
+desc "Builds the distribution"
+task :dist do
+  $:.unshift File.join(APP_ROOT, 'lib')
+  require 'protodoc'
+  require 'fileutils'
+  FileUtils.mkdir_p APP_DIST_DIR
+  
+  Dir.chdir(APP_SRC_DIR) do
+    File.open(File.join(APP_DIST_DIR, '<%= name %>.js'), 'w+') do |dist|
+      dist << Protodoc::Preprocessor.new('<%= name %>.js')
+    end
+  end
+end
+
+Rake::PackageTask.new('<%= name %>', APP_VERSION) do |package|
+  package.need_tar_gz = true
+  package.package_dir = APP_PKG_DIR
+  package.package_files.include(
+    '[A-Z]*',
+    'config/*.sample',
+    'dist/<%= name %>.js',
+    'lib/**',
+    'src/**',
+    'script/**',
+    'tasks/**',
+    'test/**',
+    'website/**'
+  )
+end
+
+desc "Builds the distribution, runs the JavaScript unit tests and collects their results."
+task :test => [:dist, :test_units]
+
+require 'jstest'
+desc "Runs all the JavaScript unit tests and collects the results"
+JavaScriptTestTask.new(:test_units) do |t|
+  testcases        = ENV['TESTCASES']
+  tests_to_run     = ENV['TESTS']    && ENV['TESTS'].split(',')
+  browsers_to_test = ENV['BROWSERS'] && ENV['BROWSERS'].split(',')
+  
+  t.mount("/dist")
+  t.mount("/src")
+  t.mount("/test")
+  
+  Dir["test/*_test.html"].sort.each do |test_file|
+    tests = testcases ? { :url => "/#{test_file}", :testcases => testcases } : "/#{test_file}"
+    test_filename = test_file[/.*\/(.+?)\.html/, 1]
+    t.run(tests) unless tests_to_run && !tests_to_run.include?(test_filename)
+  end
+  
+  %w( safari firefox ie konqueror opera ).each do |browser|
+    t.browser(browser.to_sym) unless browsers_to_test && !browsers_to_test.include?(browser)
+  end
+end
+
+task :clean_package_source do
+  rm_rf File.join(APP_PKG_DIR, "'<%= name %>'-#{APP_VERSION}")
+end
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }

data/app_generators/newjs/templates/config/javascript_test_autotest.yml.sample

@@ -0,0 +1,15 @@
+# This file has been copied here by the javascript_test_autotest plugin.
+# Comment/uncomment the browsers you wish to autotest with.
+# Same schema as per selenium-on-rails plugin, which is nice.
+browsers:
+  # Windows
+  # firefox: 'c:\Program Files\Mozilla Firefox\firefox.exe'
+  # ie: 'c:\Program Files\Internet Explorer\iexplore.exe'
+
+  # Mac OS X
+  # firefox: '/Applications/Firefox.app/Contents/MacOS/firefox-bin'
+  safari: '/Applications/Safari.app/Contents/MacOS/Safari'
+
+  # Unix
+  # ?
+  # ?

data/app_generators/newjs/templates/lib/jstest.rb

@@ -0,0 +1,382 @@
+require 'rake/tasklib'
+require 'thread'
+require 'webrick'
+require 'fileutils'
+include FileUtils
+
+class Browser
+  def supported?; true; end
+  def setup ; end
+  def open(url) ; end
+  def teardown ; end
+
+  def host
+    require 'rbconfig'
+    Config::CONFIG['host']
+  end
+  
+  def macos?
+    host.include?('darwin')
+  end
+  
+  def windows?
+    host.include?('mswin')
+  end
+  
+  def linux?
+    host.include?('linux')
+  end
+  
+  def applescript(script)
+    raise "Can't run AppleScript on #{host}" unless macos?
+    system "osascript -e '#{script}' 2>&1 >/dev/null"
+  end
+end
+
+class FirefoxBrowser < Browser
+  def initialize(path=File.join(ENV['ProgramFiles'] || 'c:\Program Files', '\Mozilla Firefox\firefox.exe'))
+    @path = path
+  end
+
+  def visit(url)
+    system("open -a Firefox '#{url}'") if macos?
+    system("#{@path} #{url}") if windows? 
+    system("firefox #{url}") if linux?
+  end
+
+  def to_s
+    "Firefox"
+  end
+end
+
+class SafariBrowser < Browser
+  def supported?
+    macos?
+  end
+  
+  def setup
+    applescript('tell application "Safari" to make new document')
+  end
+  
+  def visit(url)
+    applescript('tell application "Safari" to set URL of front document to "' + url + '"')
+  end
+
+  def teardown
+    #applescript('tell application "Safari" to close front document')
+  end
+
+  def to_s
+    "Safari"
+  end
+end
+
+class IEBrowser < Browser
+  def setup
+    require 'win32ole' if windows?
+  end
+
+  def supported?
+    windows?
+  end
+  
+  def visit(url)
+    if windows?
+      ie = WIN32OLE.new('InternetExplorer.Application')
+      ie.visible = true
+      ie.Navigate(url)
+      while ie.ReadyState != 4 do
+        sleep(1)
+      end
+    end
+  end
+
+  def to_s
+    "Internet Explorer"
+  end
+end
+
+class KonquerorBrowser < Browser
+  @@configDir = File.join((ENV['HOME'] || ''), '.kde', 'share', 'config')
+  @@globalConfig = File.join(@@configDir, 'kdeglobals')
+  @@konquerorConfig = File.join(@@configDir, 'konquerorrc')
+
+  def supported?
+    linux?
+  end
+
+  # Forces KDE's default browser to be Konqueror during the tests, and forces
+  # Konqueror to open external URL requests in new tabs instead of a new
+  # window.
+  def setup
+    cd @@configDir, :verbose => false do
+      copy @@globalConfig, "#{@@globalConfig}.bak", :preserve => true, :verbose => false
+      copy @@konquerorConfig, "#{@@konquerorConfig}.bak", :preserve => true, :verbose => false
+      # Too lazy to write it in Ruby...  Is sed dependency so bad?
+      system "sed -ri /^BrowserApplication=/d  '#{@@globalConfig}'"
+      system "sed -ri /^KonquerorTabforExternalURL=/s:false:true: '#{@@konquerorConfig}'"
+    end
+  end
+
+  def teardown
+    cd @@configDir, :verbose => false do
+      copy "#{@@globalConfig}.bak", @@globalConfig, :preserve => true, :verbose => false
+      copy "#{@@konquerorConfig}.bak", @@konquerorConfig, :preserve => true, :verbose => false
+    end
+  end
+  
+  def visit(url)
+    system("kfmclient openURL #{url}")
+  end
+  
+  def to_s
+    "Konqueror"
+  end
+end
+
+class OperaBrowser < Browser
+  def initialize(path='c:\Program Files\Opera\Opera.exe')
+    @path = path
+  end
+  
+  def setup
+    if windows?
+      puts %{
+        MAJOR ANNOYANCE on Windows.
+        You have to shut down Opera manually after each test
+        for the script to proceed.
+        Any suggestions on fixing this is GREATLY appreciated!
+        Thank you for your understanding.
+      }
+    end
+  end
+  
+  def visit(url)
+    applescript('tell application "Opera" to GetURL "' + url + '"') if macos? 
+    system("#{@path} #{url}") if windows? 
+    system("opera #{url}")  if linux?
+  end
+
+  def to_s
+    "Opera"
+  end
+end
+
+# shut up, webrick :-)
+class ::WEBrick::HTTPServer
+  def access_log(config, req, res)
+    # nop
+  end
+end
+
+class ::WEBrick::BasicLog
+  def log(level, data)
+    # nop
+  end
+end
+
+class WEBrick::HTTPResponse
+  alias send send_response
+  def send_response(socket)
+    send(socket) unless fail_silently?
+  end
+  
+  def fail_silently?
+    @fail_silently
+  end
+  
+  def fail_silently
+    @fail_silently = true
+  end
+end
+
+class WEBrick::HTTPRequest
+  def to_json
+    headers = []
+    each { |k, v| headers.push "#{k.inspect}: #{v.inspect}" }
+    headers = "{" << headers.join(', ') << "}"
+    %({ "headers": #{headers}, "body": #{body.inspect}, "method": #{request_method.inspect} })
+  end
+end
+
+class WEBrick::HTTPServlet::AbstractServlet
+  def prevent_caching(res)
+    res['ETag'] = nil
+    res['Last-Modified'] = Time.now + 100**4
+    res['Cache-Control'] = 'no-store, no-cache, must-revalidate, post-check=0, pre-check=0'
+    res['Pragma'] = 'no-cache'
+    res['Expires'] = Time.now - 100**4
+  end
+end
+
+class BasicServlet < WEBrick::HTTPServlet::AbstractServlet
+  def do_GET(req, res)
+    prevent_caching(res)
+    res['Content-Type'] = "text/plain"
+    
+    req.query.each do |k, v|
+      res[k] = v unless k == 'responseBody'
+    end
+    res.body = req.query["responseBody"]
+    
+    raise WEBrick::HTTPStatus::OK
+  end
+  
+  def do_POST(req, res)
+    do_GET(req, res)
+  end
+end
+
+class SlowServlet < BasicServlet
+  def do_GET(req, res)
+    sleep(2)
+    super
+  end
+end
+
+class DownServlet < BasicServlet
+  def do_GET(req, res)
+    res.fail_silently
+  end
+end
+
+class InspectionServlet < BasicServlet
+  def do_GET(req, res)
+    prevent_caching(res)
+    res['Content-Type'] = "application/json"
+    res.body = req.to_json
+    raise WEBrick::HTTPStatus::OK
+  end
+end
+
+class NonCachingFileHandler < WEBrick::HTTPServlet::FileHandler
+  def do_GET(req, res)
+    super
+    set_default_content_type(res, req.path)
+    prevent_caching(res)
+  end
+  
+  def set_default_content_type(res, path)
+    res['Content-Type'] = case path
+      when /\.js$/   then 'text/javascript'
+      when /\.html$/ then 'text/html'
+      when /\.css$/  then 'text/css'
+      else 'text/plain'
+    end
+  end
+end
+
+class JavaScriptTestTask < ::Rake::TaskLib
+
+  def initialize(name=:test)
+    @name = name
+    @tests = []
+    @browsers = []
+
+    @queue = Queue.new
+
+    @server = WEBrick::HTTPServer.new(:Port => 4711) # TODO: make port configurable
+    @server.mount_proc("/results") do |req, res|
+      @queue.push({
+        :tests => req.query['tests'].to_i,
+        :assertions => req.query['assertions'].to_i,
+        :failures => req.query['failures'].to_i,
+        :errors => req.query['errors'].to_i
+      })
+      res.body = "OK"
+    end
+    @server.mount("/response", BasicServlet)
+    @server.mount("/slow", SlowServlet)
+    @server.mount("/down", DownServlet)
+    @server.mount("/inspect", InspectionServlet)
+    yield self if block_given?
+    define
+  end
+
+  def define
+    task @name do
+      trap("INT") { @server.shutdown }
+      t = Thread.new { @server.start }
+      
+      # run all combinations of browsers and tests
+      @browsers.each do |browser|
+        if browser.supported?
+          t0 = Time.now
+          results = {:tests => 0, :assertions => 0, :failures => 0, :errors => 0}
+          errors = []
+          failures = []
+          browser.setup
+          puts "\nStarted tests in #{browser}"
+          @tests.each do |test|
+            params = "resultsURL=http://localhost:4711/results&t=" + ("%.6f" % Time.now.to_f)
+            if test.is_a?(Hash)
+              params << "&tests=#{test[:testcases]}" if test[:testcases]
+              test = test[:url]
+            end
+            browser.visit("http://localhost:4711#{test}?#{params}")
+ 
+            result = @queue.pop
+            result.each { |k, v| results[k] += v }
+            value = "."
+            
+            if result[:failures] > 0
+              value = "F"
+              failures.push(test)
+            end
+            
+            if result[:errors] > 0
+              value = "E"
+              errors.push(test)
+            end
+            
+            print value
+          end
+          
+          puts "\nFinished in #{(Time.now - t0).round.to_s} seconds."
+          puts "  Failures: #{failures.join(', ')}" unless failures.empty?
+          puts "  Errors:   #{errors.join(', ')}" unless errors.empty?
+          puts "#{results[:tests]} tests, #{results[:assertions]} assertions, #{results[:failures]} failures, #{results[:errors]} errors"
+          browser.teardown
+        else
+          puts "\nSkipping #{browser}, not supported on this OS"
+        end
+      end
+
+      @server.shutdown
+      t.join
+    end
+  end
+
+  def mount(path, dir=nil)
+    dir = Dir.pwd + path unless dir
+
+    # don't cache anything in our tests
+    @server.mount(path, NonCachingFileHandler, dir)
+  end
+
+  # test should be specified as a url or as a hash of the form
+  # {:url => "url", :testcases => "testFoo,testBar"}
+  def run(test)
+    @tests<<test
+  end
+
+  def browser(browser)
+    browser =
+      case(browser)
+        when :firefox
+          FirefoxBrowser.new
+        when :safari
+          SafariBrowser.new
+        when :ie
+          IEBrowser.new
+        when :konqueror
+          KonquerorBrowser.new
+        when :opera
+          OperaBrowser.new
+        else
+          browser
+      end
+
+    @browsers<<browser
+  end
+end