schubert-ci_reporter 1.6.1

data/History.txt

@@ -0,0 +1,110 @@
+== 1.5.3
+
+- Compatibility with latest RSpec (1.2.4); (Paul Boone)
+
+== 1.5.2
+
+- Compatibility with latest RSpec (1.1.11 or so); use example
+  description method if available
+- Remove dependency on rubygems when requiring builder (rescue
+  LoadError) (Jari Bakken)
+- Source repository moved to github/git.caldersphere.net
+
+== 1.5.1
+
+- Fix silly load-path error that some had been seeing
+
+== 1.5
+
+- Support for RSpec 1.1.1 example groups (which broke ci_reporter 1.4)
+- Change internal model to delegation instead of inheritance, allowing
+  ci_reporter to wrap different output formatters
+- Add 'ci:setup:rspecdoc' task to output specdoc format instead of
+  progress
+- Add support for pending examples; they will be listed in the report
+  XML as successful, but the name will have a '(PENDING)' tag appended
+- Support for RSpec < 0.9 removed as promised; use 1.4 if you still
+  need to use an older version of RSpec
+
+== 1.4
+
+- Test::Unit tests that fail in multiple places (setup, test method,
+  and teardown) are now tracked (marcog)
+- Explicit dependency requirement on Builder (>= 2.1.2)
+- Use of RSpec < 0.9 is now deprecated; support will probably
+  disappear in the next version
+
+== 1.3.5
+
+- Change way we append to environment variables to appease windows
+  (Tracker #13998, Adam Anderson)
+
+== 1.3.4
+
+- Call #to_s on the object passed in as the test suite name;
+  compatibility fix for RSpec trunk which passes a
+  Spec::DSL::Description instead of a string
+- Fix broken spec due to pending feature introduced in recent RSpec
+- Fix compatibility for JRuby
+- Add stub.rake file as another way to wrap existing Rakefile, with
+  note in README
+
+== 1.3.3
+
+- Use SPEC_OPTS instead of RSPECOPTS (Aslak Hellesøy)
+- Add assertions attribute to individual test cases (Tracker #11563,
+  Andy Sipe)
+
+== 1.3.2
+
+- Fix bug trying to modify frozen environment strings
+- Upgrade all specs to RSpec 1.0 style
+- Add specs for rake tasks
+
+== 1.3.1
+
+- Fixed to be compatible with RSpec 1.0.x (added fourth parameter to
+  Formatter#dump_summary)
+
+== 1.3
+
+- Fixed to be compatible with RSpec 0.9
+- Failure location text now contains both the exception message and
+  class name (in case the type and message attributes were truncated)
+
+== 1.2.4
+
+- Allow to report on RSpec specs when working with non-gem RSpec
+- Note: CI::Reporter is only compatible with RSpec up to 0.8.2
+
+== 1.2.3
+
+- Append to TESTOPTS and RSPECOPTS environment variables (Bret
+  Pettichord) so that other apps can put values in them as well
+
+== 1.2.2
+
+- Responds to environment variable CI_CAPTURE: if set to "off",
+  stdout/stderr capture will be disabled.
+
+== 1.2.1
+
+- Add license and copyright information (finally)
+
+== 1.2
+
+- Capture standard output and standard error during each individual
+  test suite and include in the XML file in system-out and system-err
+  elements, respectively
+  (Tracker#9054[http://rubyforge.org/tracker/index.php?func=detail&aid=9054&group_id=2857&atid=11007])
+
+== 1.1
+
+- Add +assertions+ attribute to the +testsuite+ element that will
+  contain per-suite assertion counts when used with Test::Unit. Not
+  useful with applications that read Ant/JUnit XML, but custom
+  applications may wish to access it.
+
+== 1.0
+
+- Initial Release.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+# (c) Copyright 2006-2007 Nick Sieger <nicksieger@gmail.com>
+# 
+# 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,24 @@
+History.txt
+Manifest.txt
+README.txt
+LICENSE.txt
+Rakefile
+stub.rake
+lib/ci/reporter/core.rb
+lib/ci/reporter/rake/rspec.rb
+lib/ci/reporter/rake/rspec_loader.rb
+lib/ci/reporter/rake/test_unit.rb
+lib/ci/reporter/rake/test_unit_loader.rb
+lib/ci/reporter/report_manager.rb
+lib/ci/reporter/rspec.rb
+lib/ci/reporter/test_suite.rb
+lib/ci/reporter/test_unit.rb
+lib/ci/reporter/version.rb
+spec/ci/reporter/output_capture_spec.rb
+spec/ci/reporter/rake/rake_tasks_spec.rb
+spec/ci/reporter/report_manager_spec.rb
+spec/ci/reporter/rspec_spec.rb
+spec/ci/reporter/test_suite_spec.rb
+spec/ci/reporter/test_unit_spec.rb
+spec/spec_helper.rb
+tasks/ci_reporter.rake

data/README.txt

@@ -0,0 +1,68 @@
+(NOTE: This is a fork of the original, follow the link on github for the original)
+
+CI::Reporter is an add-on to Test::Unit and RSpec that allows you to generate XML reports of your test and/or spec runs. The resulting files can be read by a continuous integration system that understands Ant's JUnit report XML format, thus allowing your CI system to track test/spec successes and failures.
+
+== Dependencies
+
+CI::Reporter has one required dependency on Builder, but since many will have a viable version of Builder via Rails' ActiveSupport gem, Builder is not a direct dependency of the project at the moment.  Instead, ensure that you have either the +builder+ or +activesupport+ gem installed before continuing.  CI::Reporter will raise an exception at runtime if it cannot locate Builder.
+
+== Installation
+
+CI::Reporter is available as a gem. To install the gem, use the usual gem command:
+
+    gem install ci_reporter
+
+To use CI::Reporter as a Rails plugin, first install the gem, and then install the plugin as follows:
+
+    script/plugin install http://svn.caldersphere.net/svn/main/plugins/ci_reporter
+
+== Usage
+
+CI::Reporter works best with projects that use a +Rakefile+ along with the standard <code>Rake::TestTask</code> or <code>Spec::Rake::SpecTask</code> tasks for running tests or examples, respectively. In this fashion, it hooks into <code>Test::Unit</code> or +RSpec+ using environment variables recognized by these custom tasks to inject the CI::Reporter code into the test or spec runs.  If you're using the Rails plugin, step 1 is unnecessary; skip to step 2.
+
+1. To use CI::Reporter, simply add the following lines to your Rakefile:
+
+    require 'rubygems'
+    gem 'ci_reporter'
+    require 'ci/reporter/rake/rspec' # use this if you're using RSpec
+    require 'ci/reporter/rake/test_unit' # use this if you're using Test::Unit
+
+2. Next, either modify your Rakefile to make the <code>ci:setup:rspec</code> or <code>ci:setup:testunit</code> task a dependency of your test tasks, or include them on the Rake command-line before the name of the task that runs the tests or specs.
+
+    rake ci:setup:testunit test
+
+Report files are written, by default, to the <code>test/reports</code> or <code>spec/reports</code> subdirectory of your project.  If you wish to customize the location, simply set the environment variable CI_REPORTS (either in the environment, on the Rake command line, or in your Rakefile) to the location where they should go.
+
+== Advanced Usage
+
+If you don't have control over the Rakefile or don't want to modify it, CI::Reporter has a substitute rake file that you can specify on the command-line.  It assumes that the main project rake file is called +Rakefile+ and lives in the current directory.  Run like so:
+
+    rake -f GEM_PATH/stub.rake ci:setup:testunit test
+    rake -f GEM_PATH/stub.rake ci:setup:rspec spec
+
+If for some reason you can't use the above technique to inject CI::Reporter (e.g., you're not using Rake), you'll have to do one of these:
+
+1. If you're using <code>Test::Unit</code>, ensure the <code>ci/reporter/rake/test_unit_loader.rb</code> file is loaded or required at some point before the tests are run.
+2. If you're using +RSpec+, you'll need to pass the following arguments to the +spec+ command:
+    --require GEM_PATH/lib/ci/reporter/rake/rspec_loader
+    --format CI::Reporter::RSpec
+
+There's a bit of a chicken and egg problem because rubygems needs to be loaded before you can require any CI::Reporter files.  If you cringe hard-coding a full path to a specific version of the gem, you can also copy the +rspec_loader+ file into your project and require it directly -- the contents are version-agnostic and are not likely to change in future releases.
+
+== Environment Variables
+
+* +CI_REPORTS+: if set, points to a directory where report files will be written.
+* +CI_CAPTURE+: if set to value "off", stdout/stderr capture will be disabled.
+
+== Source
+
+You can get the CI::Reporter source using Git, in any of the following ways:
+
+    git clone http://git.caldersphere.net/ci_reporter.git
+    git clone git://github.com/nicksieger/ci_reporter.git
+
+You can also download a tarball of the latest CI::Reporter source at http://github.com/nicksieger/ci_reporter/tree/master.
+
+== License
+
+This software is released under an MIT license.  For details, see the LICENSE.txt file included with the distribution.  The software is copyright (c) 2006-2007 Nick Sieger <nicksieger@gmail.com>.

data/Rakefile

@@ -0,0 +1,76 @@
+require 'spec/rake/spectask'
+require 'spec/rake/verify_rcov'
+
+MANIFEST = FileList["History.txt", "Manifest.txt", "README.txt", "LICENSE.txt", "Rakefile",
+  "*.rake", "lib/**/*.rb", "spec/**/*.rb", "tasks/**/*.rake"]
+
+begin
+  File.open("Manifest.txt", "w") {|f| MANIFEST.each {|n| f << "#{n}\n"} }
+  require 'hoe'
+  require File.dirname(__FILE__) + '/lib/ci/reporter/version'
+  hoe = Hoe.new("schubert-ci_reporter", CI::Reporter::VERSION) do |p|
+    p.url = "http://github.com/schubert/ci_reporter"
+    p.author = "Michael Schubert"
+    p.email = "michael@schubert.cx"
+    p.summary = "CI::Reporter allows you to generate reams of XML for use with continuous integration systems."
+    p.changes = p.paragraphs_of('History.txt', 0..1).join("\n\n")
+    p.description = p.paragraphs_of('README.txt', 0...1).join("\n\n")
+    p.extra_deps.reject!{|d| d.first == "hoe"}
+    p.test_globs = ["spec/**/*_spec.rb"]
+    p.extra_deps << ['builder', ">= 2.1.2"]
+  end
+  hoe.spec.files = MANIFEST
+  hoe.spec.dependencies.delete_if { |dep| dep.name == "hoe" }
+rescue LoadError
+  puts "You really need Hoe installed to be able to package this gem"
+end
+
+# Hoe insists on setting task :default => :test
+# !@#$ no easy way to empty the default list of prerequisites
+Rake::Task['default'].send :instance_variable_set, "@prerequisites", FileList[]
+
+# No RCov on JRuby at the moment
+if RUBY_PLATFORM =~ /java/
+  task :default => :spec
+else
+  task :default => :rcov
+end
+
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ["--diff", "unified"]
+end
+
+Spec::Rake::SpecTask.new("spec:rcov") do |t|
+  t.rcov_opts << '--exclude gems/*'
+  t.rcov = true
+end
+# so we don't confuse autotest
+RCov::VerifyTask.new(:rcov) do |t|
+  # Can't get threshold up to 100 unless RSpec backwards compatibility
+  # code is dropped
+  t.threshold = 98
+  t.require_exact_threshold = false
+end
+task "spec:rcov" do
+  rm_f "Manifest.txt"
+end
+task :rcov => "spec:rcov"
+
+task :generate_output do
+  rm_f "acceptance/reports/*.xml"
+  ENV['CI_REPORTS'] = "acceptance/reports"
+  begin
+    `ruby -Ilib acceptance/test_unit_example_test.rb` rescue nil
+    `ruby -Ilib -S spec --require ci/reporter/rake/rspec_loader --format CI::Reporter::RSpec acceptance/rspec_example_spec.rb` rescue nil
+  ensure
+    ENV.delete 'CI_REPORTS'
+  end
+end
+task :acceptance => :generate_output
+
+Spec::Rake::SpecTask.new(:acceptance_spec) do |t|
+  t.spec_files = FileList['acceptance/verification_spec.rb']
+end
+task :acceptance => :acceptance_spec
+
+task :default => :acceptance

data/lib/ci/reporter/core.rb

@@ -0,0 +1,6 @@
+# (c) Copyright 2006-2007 Nick Sieger <nicksieger@gmail.com>
+# See the file LICENSE.txt included with the distribution for
+# software license details.
+
+require 'ci/reporter/test_suite'
+require 'ci/reporter/report_manager'

data/lib/ci/reporter/rake/rspec.rb

@@ -0,0 +1,23 @@
+# (c) Copyright 2006-2007 Nick Sieger <nicksieger@gmail.com>
+# See the file LICENSE.txt included with the distribution for
+# software license details.
+
+namespace :ci do
+  namespace :setup do
+    task :spec_report_cleanup do
+      rm_rf ENV["CI_REPORTS"] || "spec/reports"
+    end
+
+    task :rspec => :spec_report_cleanup do
+      spec_opts = ["--require", "#{File.dirname(__FILE__)}/rspec_loader.rb",
+        "--format", "CI::Reporter::RSpec"].join(" ")
+      ENV["SPEC_OPTS"] = "#{ENV['SPEC_OPTS']} #{spec_opts}"
+    end
+
+    task :rspecdoc => :spec_report_cleanup do
+      spec_opts = ["--require", "#{File.dirname(__FILE__)}/rspec_loader.rb",
+        "--format", "CI::Reporter::RSpecDoc"].join(" ")
+      ENV["SPEC_OPTS"] = "#{ENV['SPEC_OPTS']} #{spec_opts}"
+    end
+  end
+end

data/lib/ci/reporter/rake/rspec_loader.rb

@@ -0,0 +1,6 @@
+# (c) Copyright 2006-2007 Nick Sieger <nicksieger@gmail.com>
+# See the file LICENSE.txt included with the distribution for
+# software license details.
+
+$: << File.dirname(__FILE__) + "/../../.."
+require 'ci/reporter/rspec'

data/lib/ci/reporter/rake/test_unit.rb

@@ -0,0 +1,12 @@
+# (c) Copyright 2006-2007 Nick Sieger <nicksieger@gmail.com>
+# See the file LICENSE.txt included with the distribution for
+# software license details.
+
+namespace :ci do
+  namespace :setup do
+    task :testunit do
+      rm_rf ENV["CI_REPORTS"] || "test/reports"
+      ENV["TESTOPTS"] = "#{ENV["TESTOPTS"]} #{File.dirname(__FILE__)}/test_unit_loader.rb"
+    end
+  end
+end

data/lib/ci/reporter/rake/test_unit_loader.rb

@@ -0,0 +1,21 @@
+# (c) Copyright 2006-2007 Nick Sieger <nicksieger@gmail.com>
+# See the file LICENSE.txt included with the distribution for
+# software license details.
+
+$: << File.dirname(__FILE__) + "/../../.."
+require 'ci/reporter/test_unit'
+
+module Test #:nodoc:all
+  module Unit
+    module UI
+      module Console
+        class TestRunner
+          def create_mediator(suite)
+            # swap in our custom mediator
+            return CI::Reporter::TestUnit.new(suite)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/ci/reporter/report_manager.rb

@@ -0,0 +1,23 @@
+# (c) Copyright 2006-2007 Nick Sieger <nicksieger@gmail.com>
+# See the file LICENSE.txt included with the distribution for
+# software license details.
+
+require 'fileutils'
+
+module CI #:nodoc:
+  module Reporter #:nodoc:
+    class ReportManager
+      def initialize(prefix)
+        @basedir = ENV['CI_REPORTS'] || File.expand_path("#{Dir.getwd}/#{prefix.downcase}/reports")
+        @basename = "#{@basedir}/#{prefix.upcase}"
+        FileUtils.mkdir_p(@basedir)
+      end
+      
+      def write_report(suite)
+        File.open("#{@basename}-#{suite.name.gsub(/[^a-zA-Z0-9]+/, '-')}.xml", "w") do |f|
+          f << suite.to_xml
+        end
+      end
+    end
+  end
+end

data/lib/ci/reporter/rspec.rb

@@ -0,0 +1,143 @@
+# (c) Copyright 2006-2009 Nick Sieger <nicksieger@gmail.com>
+# See the file LICENSE.txt included with the distribution for
+# software license details.
+
+require 'ci/reporter/core'
+tried_gem = false
+begin
+  require 'spec'
+  require 'spec/runner/formatter/progress_bar_formatter'
+  require 'spec/runner/formatter/specdoc_formatter'
+rescue LoadError
+  unless tried_gem
+    tried_gem = true
+    require 'rubygems'
+    gem 'rspec'
+    retry
+  end
+end
+
+module CI
+  module Reporter
+    # Wrapper around a <code>RSpec</code> error or failure to be used by the test suite to interpret results.
+    class RSpecFailure
+      def initialize(failure)
+        @failure = failure
+      end
+
+      def failure?
+        @failure.expectation_not_met?
+      end
+
+      def error?
+        !@failure.expectation_not_met?
+      end
+
+      def name() @failure.exception.class.name end
+      def message() @failure.exception.message end
+      def location() @failure.exception.backtrace.join("\n") end
+    end
+
+    # Custom +RSpec+ formatter used to hook into the spec runs and capture results.
+    class RSpec < Spec::Runner::Formatter::BaseFormatter
+      attr_accessor :report_manager
+      attr_accessor :formatter
+      def initialize(*args)
+        super
+        @formatter ||= Spec::Runner::Formatter::ProgressBarFormatter.new(*args)
+        @report_manager = ReportManager.new("spec")
+        @suite = nil
+      end
+
+      def start(spec_count)
+        @formatter.start(spec_count)
+      end
+
+      # rspec 0.9
+      def add_behaviour(name)
+        @formatter.add_behaviour(name)
+        new_suite(name)
+      end
+
+      # Compatibility with rspec < 1.2.4
+      def add_example_group(example_group)
+        @formatter.add_example_group(example_group)
+        new_suite(example_group.description)
+      end
+
+      # rspec >= 1.2.4
+      def example_group_started(example_group)
+        @formatter.example_group_started(example_group)
+        new_suite(example_group.description)
+      end
+
+      def example_started(name)
+        @formatter.example_started(name)
+        name = name.description if name.respond_to?(:description)
+        spec = TestCase.new name
+        @suite.testcases << spec
+        spec.start
+      end
+
+      def example_failed(name, counter, failure)
+        @formatter.example_failed(name, counter, failure)
+        spec = @suite.testcases.last
+        spec.finish
+        spec.failures << RSpecFailure.new(failure)
+      end
+
+      def example_passed(name)
+        @formatter.example_passed(name)
+        spec = @suite.testcases.last
+        spec.finish
+      end
+
+      def example_pending(*args)
+        @formatter.example_pending(*args)
+        spec = @suite.testcases.last
+        spec.finish
+        spec.name = "#{spec.name} (PENDING)"
+      end
+
+      def start_dump
+        @formatter.start_dump
+      end
+
+      def dump_failure(*args)
+        @formatter.dump_failure(*args)
+      end
+
+      def dump_summary(*args)
+        @formatter.dump_summary(*args)
+        write_report
+      end
+
+      def dump_pending
+        @formatter.dump_pending
+      end
+
+      def close
+        @formatter.close
+      end
+
+      private
+      def write_report
+        @suite.finish
+        @report_manager.write_report(@suite)
+      end
+
+      def new_suite(name)
+        write_report if @suite
+        @suite = TestSuite.new name
+        @suite.start
+      end
+    end
+
+    class RSpecDoc < RSpec
+      def initialize(*args)
+        @formatter = Spec::Runner::Formatter::SpecdocFormatter.new(*args)
+        super
+      end
+    end
+  end
+end