ryanbriones-ZenTest 3.11.1

data/lib/autotest/snarl.rb

@@ -0,0 +1,51 @@
+# special thanks to: Patrick Hurley <phurley@gmail.com>
+# requires the ruby-snarl gem.
+
+begin require 'rubygems'; rescue LoadError; end
+require 'snarl'
+
+module Autotest::Snarl  
+  def self.icon
+    # icons from http://www.famfamfam.com/lab/icons/silk/
+    path = File.join(File.dirname(__FILE__), "/../icons")
+    {
+      :green => "#{path}/accept.png",
+      :red    => "#{path}/exclamation.png",
+      :info   => "#{path}/information.png"
+    }
+  end
+  
+  def self.snarl title, msg, ico = nil
+    Snarl.show_message(title, msg, icon[ico])
+  end
+
+  Autotest.add_hook :run do  |at|
+    snarl "Run", "Run" unless $TESTING
+  end
+
+  Autotest.add_hook :red do |at|
+    failed_tests = at.files_to_test.inject(0){ |s,a| k,v = a;  s + v.size}
+    snarl "Tests Failed", "#{failed_tests} tests failed", :red
+  end
+
+  Autotest.add_hook :green do |at|
+    snarl "Tests Passed", "All tests passed", :green #if at.tainted 
+  end
+
+  Autotest.add_hook :run do |at|
+    snarl "autotest", "autotest was started", :info unless $TESTING
+  end
+
+  Autotest.add_hook :interrupt do |at|
+    snarl "autotest", "autotest was reset", :info unless $TESTING
+  end
+
+  Autotest.add_hook :quit do |at|
+    snarl "autotest", "autotest is exiting", :info unless $TESTING
+  end
+
+  Autotest.add_hook :all do |at|_hook
+    snarl "autotest", "Tests have fully passed", :green unless $TESTING
+  end
+
+end

data/lib/autotest/timestamp.rb

@@ -0,0 +1,9 @@
+# -*- ruby -*-
+
+module Autotest::Timestamp
+  Autotest.add_hook :waiting do
+    puts
+    puts "# Waiting since #{Time.now.strftime "%Y-%m-%d %H:%M:%S"}"
+    puts
+  end
+end

data/lib/functional_test_matrix.rb

@@ -0,0 +1,92 @@
+
+########################################################################
+# The Idea:
+#
+# This is supposed to get us thinking about the various dimensions our
+# testing should address. If there are states orthogonal to each other
+# (eg. readable vs unreadable, logged in vs not logged in) each of
+# those states should comprise a dimension in the matrix. By
+# addressing it this way, we should be able to minimize the amount of
+# setup/teardown code and get full coverage across our actions for all
+# these edge cases and as a result have extremely clear tests.
+#
+########################################################################
+# Example Test Matrix Specification:
+#
+# matrix :example, :edge1, :edge2, :edge3, ...
+# action :action1, :OK,    :e_NF,  :mod,   ...
+# action :action2, :OK,    :e_RO,  :na,    ...
+# action ...
+#
+########################################################################
+# Matrix:
+#
+# I envision the setups being a code that combines the different
+# dimensions of edge case state.
+#
+# Something for a CMS might look like: `[df]_[ugo]_[rRwW]` where:
+#
+# + `[df]` for dir/file.
+# + and the rest is in the style of symbolic args to chmod:
+#   + u/g/o = user, group, or other
+#   + lowercase `X` == `X`able, uppercase `X` == un`X`able, where `X`
+#     is read/write.
+#
+########################################################################
+# Action:
+#
+# :new/:err/:del are just examples, they should have semantic info
+# attached to them.
+#
+# Use :na to specify an inapplicable edge case for that action.
+#
+# Use :OK to specify the standard positive state. It is equivalent to
+# a result with the same name as the action. (eg
+# matrix_test_index). This cleans up the matrix a lot and allows for
+# narrower and more readable columns.
+#
+# Edge cases specific to an action that fall outside the matrix are
+# regular tests.
+#
+########################################################################
+# Matrix Methods (the legos):
+#
+# Everything else basically equates to lego pieces:
+#
+# + There is one "init" method per matrix: matrix_init_#{descr}(setup_args)
+# + There is one "setup" method per action: matrix_setup_#{action}(setup, expect)
+# + There is one "test" method per result: matrix_test_#{result}(setup)
+#
+# Thus, for the matrix "example" above, the top left-most test will
+# end up calling:
+#
+#     matrix_init_example(:edge1)
+#     matrix_setup_action1(:edge1, :new)
+#     matrix_test_new(:edge1)
+#
+# Read the action method for exact details.
+########################################################################
+
+module FunctionalTestMatrix
+  def matrix(name, *setups)
+    @@matrix, @@setups = name, setups
+  end
+
+  def action(action, *results)
+    testcases = @@setups.zip(results).reject { |a,b| b == :na }
+    testcases = Hash[*testcases.flatten]
+    matrix = @@matrix # bind to local scope for define_method closure
+
+    testcases.each do |setup, expected|
+      expected_action = expected == :OK ? action : expected
+      define_method "test_#{matrix}_#{action}_#{setup}" do
+        @action = action
+        send "matrix_init_#{matrix}", *setup.to_s.split(/_/).map {|c| c.intern }
+        send "matrix_setup_#{action}", setup, expected
+        send "matrix_test_#{expected_action}", setup
+      end
+    end
+  end
+
+  module_function :matrix, :action
+end

data/lib/multiruby.rb

@@ -0,0 +1,401 @@
+require 'fileutils'
+require 'open-uri'
+
+##
+# multiruby_setup is a script to help you manage multiruby.
+#
+# usage: multiruby_setup [-h|cmd|spec...]
+#
+#   cmds:
+#
+#     h, help         - show this help.
+#     list            - print installed versions.
+#     update          - update svn builds.
+#     update:rubygems - update rubygems and nuke install dirs.
+#     rubygems:merge  - symlink all rubygem dirs to one dir.
+#     rm:$version     - remove a particular version.
+#     clean           - clean scm build dirs and remove non-scm build dirs.
+#
+#   specs:
+#
+#     mri:svn:current        - alias for mri:svn:releases and mri:svn:branches.
+#     mri:svn:releases       - alias for supported releases of mri ruby.
+#     mri:svn:branches       - alias for active branches of mri ruby.
+#     mri:svn:branch:$branch - install a specific $branch of mri from svn.
+#     mri:svn:tag:$tag       - install a specific $tag of mri from svn.
+#     mri:tar:$version       - install a specific $version of mri from tarball.
+#     rbx:ln:$dir            - symlink your rbx $dir
+#     rbx:git:current        - install rbx from git
+#
+# NOTES:
+#
+# * you can add a symlink to your rubinius build into ~/.multiruby/install
+# * I'll get to adding support for other implementations soon.
+#
+module Multiruby
+  MRI_SVN  = "http://svn.ruby-lang.org/repos/ruby"
+  RBX_GIT  = "git://git.rubini.us"
+
+  TAGS     = %w(    1_8_6 1_8_7 1_9  )
+  BRANCHES = %w(1_8 1_8_6 1_8_7 trunk)
+
+  HELP = []
+
+  File.readlines(__FILE__).each do |line|
+    next unless line =~ /^#( |$)/
+    HELP << line.sub(/^# ?/, '')
+  end
+
+  def self.build_and_install
+    root_dir = self.root_dir
+    versions = []
+
+    Dir.chdir root_dir do
+      self.setup_dirs
+
+      rubygems = Dir["versions/rubygems*.tgz"]
+      abort "You should delete all but one rubygem tarball" if rubygems.size > 1
+      rubygem_tarball = File.expand_path rubygems.last rescue nil
+
+      Dir.chdir "build" do
+        Dir["../versions/*"].each do |tarball|
+          next if tarball =~ /rubygems/
+
+          build_dir = File.basename tarball, ".tar.gz"
+          version = build_dir.sub(/^ruby-?/, '')
+          versions << version
+          inst_dir = "#{root_dir}/install/#{version}"
+
+          unless test ?d, inst_dir then
+            unless test ?d, build_dir then
+              if test ?d, tarball then
+                dir = File.basename tarball
+                FileUtils.ln_sf "../versions/#{dir}", "../build/#{dir}"
+              else
+                puts "creating #{inst_dir}"
+                Dir.mkdir inst_dir
+                run "tar zxf #{tarball}"
+              end
+            end
+            Dir.chdir build_dir do
+              puts "building and installing #{version}"
+              if test ?f, "configure.in" then
+                gnu_utils_build inst_dir
+              elsif test ?f, "Rakefile" then
+                rake_build inst_dir
+              else
+                raise "dunno how to build"
+              end
+
+              if rubygem_tarball and version !~ /1[._-]9|mri_trunk|rubinius/ then
+                rubygems = File.basename rubygem_tarball, ".tgz"
+                run "tar zxf #{rubygem_tarball}" unless test ?d, rubygems
+
+                Dir.chdir rubygems do
+                  run "../ruby ./setup.rb --no-rdoc --no-ri &> ../log.rubygems"
+                end
+              end
+            end
+          end
+        end
+      end
+    end
+
+    versions
+  end
+
+  def self.clean
+    self.each_scm_build_dir do |style|
+      case style
+      when :svn, :git then
+        if File.exist? "Rakefile" then
+          run "rake clean"
+        elsif File.exist? "Makefile" then
+          run "make clean"
+        end
+      else
+        FileUtils.rm_rf Dir.pwd
+      end
+    end
+  end
+
+  def self.each_scm_build_dir
+    Multiruby.in_build_dir do
+      Dir["*"].each do |dir|
+        next unless File.directory? dir
+        Dir.chdir dir do
+          if File.exist?(".svn") || File.exist?(".git") then
+            scm = File.exist?(".svn") ? :svn : :git
+            yield scm
+          else
+            yield :none
+          end
+        end
+      end
+    end
+  end
+
+  def self.extract_latest_version url, matching=nil
+    file = URI.parse(url).read
+    versions = file.scan(/href="(ruby.*tar.gz)"/).flatten.reject { |s|
+      s =~ /preview/
+    }.sort_by { |s|
+      s.split(/\D+/).map { |i| i.to_i }
+    }.flatten
+    versions = versions.grep(/#{Regexp.escape(matching)}/) if matching
+    versions.last
+  end
+
+  def self.fetch_tar v
+    require 'open-uri'
+    base_url = "http://ftp.ruby-lang.org/pub/ruby"
+
+    in_versions_dir do
+      warn "    Determining latest version for #{v}"
+      ver = v[/\d+\.\d+/]
+      base = extract_latest_version("#{base_url}/#{ver}/", v)
+      abort "Could not determine release for #{v}" unless base
+      url = File.join base_url, ver, base
+      warn "    Fetching #{base} via HTTP... this might take a while."
+      open(url) do |f|
+        File.open base, 'w' do |out|
+          out.write f.read
+        end
+      end
+    end
+  end
+
+  def self.git_clone url, dir
+    Multiruby.in_versions_dir do
+      Multiruby.run "git clone #{url} #{dir}" unless File.directory? dir
+      FileUtils.ln_sf "../versions/#{dir}", "../build/#{dir}"
+    end
+  end
+
+  def self.gnu_utils_build inst_dir
+    run "autoconf" unless test ?f, "configure"
+    run "./configure --prefix #{inst_dir} &> log.configure" unless test ?f, "Makefile"
+    run "nice make -j4 &> log.build"
+    run "make install &> log.install"
+  end
+
+  def self.rake_build inst_dir
+    run "rake &> log.build"
+    FileUtils.ln_sf "../build/#{File.basename Dir.pwd}", inst_dir
+  end
+
+  def self.help
+    puts HELP.join
+  end
+
+  def self.in_build_dir
+    Dir.chdir File.join(self.root_dir, "build") do
+      yield
+    end
+  end
+
+  def self.in_install_dir
+    Dir.chdir File.join(self.root_dir, "install") do
+      yield
+    end
+  end
+
+  def self.in_root_dir
+    Dir.chdir self.root_dir do
+      yield
+    end
+  end
+
+  def self.in_tmp_dir
+    Dir.chdir File.join(self.root_dir, "tmp") do
+      yield
+    end
+  end
+
+  def self.in_versions_dir
+    Dir.chdir File.join(self.root_dir, "versions") do
+      yield
+    end
+  end
+
+  def self.list
+    puts "Known versions:"
+    in_install_dir do
+      Dir["*"].sort.each do |d|
+        puts "  #{d}"
+      end
+    end
+  end
+
+  def self.merge_rubygems
+    in_install_dir do
+      gems = Dir["*/lib/ruby/gems"]
+
+      unless test ?d, "../gems" then
+        FileUtils.mv gems.first, ".."
+      end
+
+      gems.each do |d|
+        FileUtils.rm_rf d
+        FileUtils.ln_sf "../../../../gems", d
+      end
+    end
+  end
+
+  def self.mri_latest_tag v
+    Multiruby.tags.grep(/#{v}/).last
+  end
+
+  def self.rbx_ln dir
+    dir = File.expand_path dir
+    Multiruby.in_versions_dir do
+      FileUtils.ln_sf dir, "rubinius"
+      FileUtils.ln_sf "../versions/rubinius", "../install/rubinius"
+    end
+  end
+
+  def self.rm name
+    Multiruby.in_root_dir do
+      FileUtils.rm_rf Dir["*/#{name}"]
+      f = "versions/ruby-#{name}.tar.gz"
+      File.unlink f if test ?f, f
+    end
+  end
+
+  def self.root_dir
+    root_dir = File.expand_path(ENV['MULTIRUBY'] ||
+                                File.join(ENV['HOME'], ".multiruby"))
+
+    unless test ?d, root_dir then
+      puts "creating #{root_dir}"
+      Dir.mkdir root_dir, 0700
+    end
+
+    root_dir
+  end
+
+  def self.run(cmd)
+    puts "Running command: #{cmd}"
+    raise "ERROR: Command failed with exit code #{$?}" unless system cmd
+  end
+
+  def self.setup_dirs(download = true)
+    %w(build install versions tmp).each do |dir|
+      unless test ?d, dir then
+        puts "creating #{dir}"
+        Dir.mkdir dir
+        if dir == "versions" && download then
+          warn "  Downloading initial ruby tarballs to ~/.multiruby/versions:"
+          %w(1.8 1.9).each do |v|
+            self.fetch_tar v
+          end
+          warn "  ...done"
+          warn "  Put other ruby tarballs in ~/.multiruby/versions to use them."
+        end
+      end
+    end
+  end
+
+  def self.svn_co url, dir
+    Multiruby.in_versions_dir do
+      Multiruby.run "svn co #{url} #{dir}" unless File.directory? dir
+      FileUtils.ln_sf "../versions/#{dir}", "../build/#{dir}"
+    end
+  end
+
+  def self.tags
+    tags = nil
+    Multiruby.in_tmp_dir do
+      cache = "svn.tag.cache"
+      File.unlink cache if Time.now - File.mtime(cache) > 3600 rescue nil
+
+      File.open cache, "w" do |f|
+        f.write `svn ls #{MRI_SVN}/tags/`
+      end unless File.exist? cache
+
+      tags = File.read(cache).split(/\n/).grep(/^v/).reject {|s| s =~ /preview/}
+    end
+
+    tags = tags.sort_by { |s| s.scan(/\d+/).map { |s| s.to_i } }
+  end
+
+  def self.update
+    # TODO:
+    # update will look at the dir name and act accordingly rel_.* will
+    # figure out latest tag on that name and svn sw to it trunk and
+    # others will just svn update
+
+    clean = []
+
+    self.each_scm_build_dir do |style|
+      dir = File.basename(Dir.pwd)
+      warn dir
+
+      case style
+      when :svn then
+        case dir
+        when /mri_\d/ then
+          system "svn cleanup" # just in case
+          svn_up = `svn up`
+          in_build_dir do
+            if svn_up =~ /^[ADUCG] / then
+              clean << dir
+            else
+              warn "  no update"
+            end
+            FileUtils.ln_sf "../build/#{dir}", "../versions/#{dir}"
+          end
+        when /mri_rel_(.+)/ then
+          ver = $1
+          url = `svn info`[/^URL: (.*)/, 1]
+          latest = self.mri_latest_tag(ver).chomp('/')
+          new_url = File.join(File.dirname(url), latest)
+          if new_url != url then
+            run "svn sw #{new_url}"
+            clean << dir
+          else
+            warn "  no update"
+          end
+        else
+          warn "  update in this svn dir not supported yet: #{dir}"
+        end
+      when :git then
+        case dir
+        when /rubinius/ then
+          run "rake git:update build" # minor cheat by building here
+        else
+          warn "  update in this git dir not supported yet: #{dir}"
+        end
+      else
+        warn "  update in non-svn dir not supported yet: #{dir}"
+      end
+    end
+
+    in_install_dir do
+      clean.each do |dir|
+        warn "removing install/#{dir}"
+        FileUtils.rm_rf dir
+      end
+    end
+  end
+
+  def self.update_rubygems
+    url = "http://files.rubyforge.rubyuser.de/rubygems/"
+    html = URI.parse(url).read
+
+    versions = html.scan(/href="rubygems-update-(\d+(?:\.\d+)+).gem/).flatten
+    latest = versions.sort_by { |s| s.scan(/\d+/).map { |s| s.to_i } }.last
+
+    Multiruby.in_versions_dir do
+      File.unlink(*Dir["rubygems*"])
+      file = "rubygems-#{latest}.tgz"
+      File.open file, 'w' do |f|
+        f.write URI.parse(url+file).read
+      end
+    end
+
+    Multiruby.in_install_dir do
+      FileUtils.rm_rf Dir["*"]
+    end
+  end
+end