rubytest 0.7.0 → 0.8.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 74e1fac06f06bdac2b565ff5e50d26ed55939031
+  data.tar.gz: 6f69652075d71103e5905d28ecdbdd1cea8ef1ec
+SHA512:
+  metadata.gz: 7931495754a8ae4c102274dafdbda4cbd0f5e2f9c63b3bb6bac5acbe35c9fb860e7915f576637cff072c17da1ecd7871222a0251d02a20aec8561e8e9ae83e14
+  data.tar.gz: 8af87ee70f52ca63287b5f338523384bd9d622978202214cb6f14a8959f0df424e71469f78518f0d3c12a1870e984f65383c6ddc4ac440bee3b0a4f153b4e86f

data/.index

@@ -2,28 +2,20 @@
 revision: 2013
 type: ruby
 sources:
-- var
+- Indexfile
+- Gemfile
 authors:
 - name: trans
   email: transfire@gmail.com
 organizations: []
 requirements:
-- name: ansi
-- groups:
-  - build
-  development: true
-  name: fire
-- groups:
-  - build
-  development: true
-  name: detroit
 - groups:
   - test
-  development: true
+  version: '>= 0'
   name: qed
 - groups:
   - test
-  development: true
+  version: '>= 0'
   name: ae
 conflicts: []
 alternatives: []
@@ -50,12 +42,13 @@ customs: []
 paths:
   lib:
   - lib
-created: '2011-07-23'
-summary: Ruby Universal Test Harness
-title: Ruby Test
-version: 0.7.0
 name: rubytest
-description: ! "Ruby Test is a universal test harness for Ruby. It can handle any
-  compliant \ntest framework, even running tests from multiple frameworks in a single
-  pass."
-date: '2013-02-17'
+title: Rubytest
+version: 0.8.0
+summary: Ruby Universal Test Harness
+description: Rubytest is a universal test harness for Ruby. It can handle any compliant
+  test framework, even running tests from multiple frameworks in a single pass. This
+  is the core component of the system, and is the only part strictly necessary to
+  run tests.
+created: '2011-07-23'
+date: '2014-07-18'

data/HISTORY.md

@@ -1,5 +1,17 @@
 # RELEASE HISTORY
 
+## 0.8.0 / 2014-07-18
+
+We have whittled Rubytest down to it core functionaltiy and spun the rest
+off as separate plugin gems. The rubytest-suite gem is a metapackage
+loading this gem and a set of common plugins for convenience.
+
+Changes:
+
+* Spin-off report formats as separate gems.
+* Create rubytest-suite gem for convenience.
+
+
 ## 0.7.0 / 2013-02-18
 
 Version 0.7 is a significant release. The library has been simplified

data/LICENSE.txt

@@ -1,33 +1,23 @@
-# COPYRIGHT NOTICES
-
-## Ruby Test
-
-**Project**   | Ruby Test
---------------|------------------------------------------
-**Website**   | http://rubyworks.github.com/ruby-test
-**License**   | BSD-2-Clause
-**Copyright** | (c) 2011 Rubyworks
-
-    Copyright 2011 Rubyworks. 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.
-
-    THIS SOFTWARE IS PROVIDED ``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
-    COPYRIGHT HOLDERS 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.
+(BSD-2-Clause License)
+
+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.
+
+THIS SOFTWARE IS PROVIDED ``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
+COPYRIGHT HOLDERS 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/README.md

@@ -1,4 +1,4 @@
-# Ruby Test
+# Rubytest
 
 [Homepage](http://rubyworks.github.com/rubytest) /
 [User Guide](http://wiki.github.com/rubyworks/rubytest) /
@@ -11,25 +11,27 @@
 
 ## Description
 
-Ruby Test is a universal test harness for Ruby developers. It can be used
-by any Ruby test framework. You can think of Ruby Test as a *meta test framework*. 
-Ruby Test defines a straight-forward specification that any test framework
-can utilize as it back-end. This makes it almost trivial to implement new
-test frameworks. Ruby Test further allows tests from various frameworks
-to all run through a single uniform user interface in a single pass.
+Rubytest is a universal test harness for Ruby development. Think
+of Rubytest as a *testing meta-framework*. It defines a straight-forward
+specification that anyone can use to create their own testing DSLs 
+quickily and easily. This can be used for testing end applcations or it
+can be used by test framework as a backend.
+In addition, since all Rubytest controls the backend, multiple frameworks
+can be used in a single test suite all of which can run through a single
+uniform interface in a process.
 
 
 ## Specification
 
 The universal access point for testing is the `$TEST_SUITE` global array. A test
 framework need only add compliant test objects to `$TEST_SUITE`. 
-Ruby Test will iterate through these objects. If a test object responds to
+Rubytest will iterate through these objects. If a test object responds to
 `#call`, it is run as a test procedure. If it responds to `#each` it is iterated
 over as a test case with each entry handled in the same manner. All test 
 objects must respond to `#to_s` so their description can be used in test
 reports.
 
-Ruby Test handles assertions with [BRASS](http://rubyworks.github.com/brass)
+Rubytest handles assertions with [BRASS](http://rubyworks.github.com/brass)
 compliance. Any raised exception that responds to `#assertion?` in the
 affirmative is taken to be a failed assertion rather than simply an error. 
 A test framework may raise a `NotImplementedError` to have a test recorded
@@ -40,18 +42,18 @@ to indicate the urgency of the pending test. Priorities of -1 or lower
 will generally not be brought to the attention of testers unless explicitly 
 configured to do so.
 
-That is the crux of Ruby Test specification. Ruby Test supports some
+That is the crux of Rubytest specification. Rubytest supports some
 additional features that can makes its usage even more convenient.
 See the [Wiki](http://github.com/rubyworks/test/wiki) for further details.
 
 
 ## Installation
 
-Ruby Test is available as a Gem package.
+Rubytest is available as a Gem package.
 
     $ gem install rubytest
 
-Ruby Test is compliant with Setup.rb layout standard, so it can
+Rubytest is compliant with Setup.rb layout standard, so it can
 also be installed in an FHS compliant fashion if necessary.
 
 
@@ -59,30 +61,11 @@ also be installed in an FHS compliant fashion if necessary.
 
 There are a few ways to run tests. 
 
-### Via Runner Scripts
-
-Out of the box Ruby Test doesn't provide any special means for doing so,
-you simply write you own runner script using the Ruby Test API.
-Here is the basic example:
-
-    require 'rubytest'
-
-    Test.run! do |r|
-      r.loadpath 'lib'
-      r.test_files 'test/test_*.rb'
-    end
-
-Put that in a `test/runner.rb` script and run it with `ruby` or
-add `#!/usr/bin/env ruby` at the top and put it in `bin/test`
-setting `chmod u+x bin/test`. Either way, you now have your test
-runner.
-
 ### Via Command-line Tool
 
-Probably the easiest way to run tests is via the command line tool available
-via the `rubytest-cli` plug-in. You can read more about it on its
-[webpage](http://rubyworks.github.com/rubytest-cli), but we will quickly go
-over it here. 
+The easiest way to run tests is via the command line tool. You can read more about
+it on its [manpage](http://rubyworks.github.com/rubytest/man/rubytest.1.html),
+but we will quickly go over it here. 
 
 The basic usage example is:
 
@@ -116,10 +99,28 @@ A basic example in its case, add to ones Rakefile:
 
 See the Wiki for more detailed information on the different ways to run tests.
 
+### Via Runner Scripts
+
+Out of the box Rubytest doesn't provide any special means for doing so,
+you simply write you own runner script using the Rubytest API.
+Here is the basic example:
+
+    require 'rubytest'
+
+    Test.run! do |r|
+      r.loadpath 'lib'
+      r.test_files 'test/test_*.rb'
+    end
+
+Put that in a `test/runner.rb` script and run it with `ruby` or
+add `#!/usr/bin/env ruby` at the top and put it in `bin/test`
+setting `chmod u+x bin/test`. Either way, you now have your test
+runner.
+
 
 ## Requirements
 
-Ruby Test uses the [ANSI](http://rubyworks.github.com/ansi) gem for color output.
+Rubytest uses the [ANSI](http://rubyworks.github.com/ansi) gem for color output.
 
 Because of the "foundational" nature of this library we will look at removing
 this dependency for future versions, but for early development the 
@@ -128,9 +129,9 @@ requirements does the job and does it well.
 
 ## Development
 
-Ruby Test is still a bit of a "nuby" gem. Please feel OBLIGATED to help improve it ;-)
+Rubytest is still a bit of a "nuby" gem. Please feel OBLIGATED to help improve it ;-)
 
-Ruby Test is a [Rubyworks](http://rubyworks.github.com) project. If you can't
+Rubytest is a [Rubyworks](http://rubyworks.github.com) project. If you can't
 contribute code, you can still help out by contributing to our development fund.
 
 

data/lib/rubytest.rb

@@ -30,9 +30,8 @@ if RUBY_VERSION < '1.9'
   require 'rubytest/recorder'
   require 'rubytest/advice'
   require 'rubytest/runner'
-  require 'rubytest/cli'
-  require 'rubytest/reporters/abstract'
-  require 'rubytest/reporters/abstract_hash'
+  require 'rubytest/format/abstract'
+  require 'rubytest/format/abstract_hash'
 else
   require_relative 'rubytest/core_ext'
   require_relative 'rubytest/code_snippet'
@@ -40,8 +39,7 @@ else
   require_relative 'rubytest/recorder'
   require_relative 'rubytest/advice'
   require_relative 'rubytest/runner'
-  require_relative 'rubytest/cli'
-  require_relative 'rubytest/reporters/abstract'
-  require_relative 'rubytest/reporters/abstract_hash'
+  require_relative 'rubytest/format/abstract'
+  require_relative 'rubytest/format/abstract_hash'
 end
 

data/lib/rubytest.yml

@@ -2,28 +2,20 @@
 revision: 2013
 type: ruby
 sources:
-- var
+- Indexfile
+- Gemfile
 authors:
 - name: trans
   email: transfire@gmail.com
 organizations: []
 requirements:
-- name: ansi
-- groups:
-  - build
-  development: true
-  name: fire
-- groups:
-  - build
-  development: true
-  name: detroit
 - groups:
   - test
-  development: true
+  version: '>= 0'
   name: qed
 - groups:
   - test
-  development: true
+  version: '>= 0'
   name: ae
 conflicts: []
 alternatives: []
@@ -50,12 +42,13 @@ customs: []
 paths:
   lib:
   - lib
-created: '2011-07-23'
-summary: Ruby Universal Test Harness
-title: Ruby Test
-version: 0.7.0
 name: rubytest
-description: ! "Ruby Test is a universal test harness for Ruby. It can handle any
-  compliant \ntest framework, even running tests from multiple frameworks in a single
-  pass."
-date: '2013-02-17'
+title: Rubytest
+version: 0.8.0
+summary: Ruby Universal Test Harness
+description: Rubytest is a universal test harness for Ruby. It can handle any compliant
+  test framework, even running tests from multiple frameworks in a single pass. This
+  is the core component of the system, and is the only part strictly necessary to
+  run tests.
+created: '2011-07-23'
+date: '2014-07-18'

data/lib/rubytest/autorun.rb

@@ -1,7 +1,7 @@
 require 'rubytest'
 
 at_exit {
-  success = Test.run
+  success = Test.run!(ENV['profile'] || ENV['p'])
   exit -1 unless success
 }
 

data/lib/rubytest/config.rb

@@ -116,7 +116,15 @@ module Test
 
       #apply_environment
 
-      apply(settings, &block)
+      apply(settings)
+
+      # save for lazy execution
+      @block = block
+    end
+
+    # Apply lazy block.
+    def apply!
+      @block.call(self) if @block
     end
 
     # Evaluate configuration block.
@@ -129,6 +137,16 @@ module Test
       block.call(self) if block
     end
 
+    #
+    def name
+      @name
+    end
+
+    #
+    def name=(name)
+      @name = name.to_s if name
+    end
+
     # Default test suite ($TEST_SUITE).
     #
     # @return [Array]
@@ -351,6 +369,8 @@ module Test
     # Convert configuration to shell options, compatible with the
     # rubytest command line.
     #
+    # DEPRECATE: Shell command is considered bad approach.
+    #
     # @return [Array<String>]
     def to_shellwords
       argv = []

data/lib/rubytest/runner.rb

@@ -55,7 +55,9 @@ module Test
         else Test.configuration(config)
       end
 
-      yeild(@config) if block_given?
+      @config.apply!  # apply lazy config block
+
+      yield(@config) if block_given?
 
       @advice = Advice.new
     end
@@ -281,29 +283,36 @@ module Test
     def reporter_load(format)
       format = DEFAULT_REPORT_FORMAT unless format
       format = format.to_s.downcase
-      name   = reporter_list.find{ |r| /^#{format}/ =~ r }
-
-      raise "unsupported report format" unless format
+      name   = reporter_list.find{ |r| /^#{format}/ =~ r } || format
 
-      if RUBY_VERSION < '1.9'
-        require "rubytest/reporters/#{name}"
-      else
-        require_relative "reporters/#{name}"
+      begin
+        require "rubytest/format/#{name}"
+      rescue LoadError
+        raise "mistyped or uninstalled report format" unless format
       end
 
       reporter = Test::Reporters.const_get(name.capitalize)
       reporter.new(self)
     end
 
+    # List of known report formats.
+    #
+    # TODO: Could use finder gem to look these up, but that's yet another dependency.
+    #
+    KNOWN_FORMATS = %w{
+      dotprogress html progress outline summary tap tapy tapj test
+    }
+
     # Returns a list of available report types.
     #
     # @return [Array<String>]
     #   The names of available reporters.
     def reporter_list
-      list = Dir[File.dirname(__FILE__) + '/reporters/*.rb']
-      list = list.map{ |r| File.basename(r).chomp('.rb') }
-      list = list.reject{ |r| /^abstract/ =~ r }
-      list.sort
+      return KNOWN_FORMATS.sort
+      #list = Dir[File.dirname(__FILE__) + '/reporters/*.rb']
+      #list = list.map{ |r| File.basename(r).chomp('.rb') }
+      #list = list.reject{ |r| /^abstract/ =~ r }
+      #list.sort
     end
 
     # Files can be globs and directories which need to be