rspec 1.0.0 → 1.3.1

data/EXAMPLES.rd

@@ -1,108 +0,0 @@
-# Examples with no descriptions
-# * should equal 5
-# * should be < 5
-# * should include "a"
-# * should respond to #size
-# State created in before(:all)
-# * should be accessible from example
-# * should not have sideffects
-# BehaveAsExample::BluesGuitarist
-# * should behave as guitarist
-# BehaveAsExample::RockGuitarist
-# * should behave as guitarist
-# BehaveAsExample::ClassicGuitarist
-# * should not behave as guitarist
-# Animals::Mouse
-# * should eat cheese
-# * should not eat cat
-# Some integers
-# * The root of 1 square should be 1
-# * The root of 2 square should be 2
-# * The root of 3 square should be 3
-# * The root of 4 square should be 4
-# * The root of 5 square should be 5
-# * The root of 6 square should be 6
-# * The root of 7 square should be 7
-# * The root of 8 square should be 8
-# * The root of 9 square should be 9
-# * The root of 10 square should be 10
-# A FileAccessor
-# * should open a file and pass it to the processor's process method
-# Greeter
-# * should say Hi to person
-# * should say Hi to nobody
-# a context with helper a method
-# * should make that method available to specs
-# An IoProcessor
-# * should raise nothing when the file is exactly 32 bytes
-# * should raise an exception when the file length is less than 32 bytes
-# A legacy spec
-# * should work fine
-# A consumer of a mock
-# * should be able to send messages to the mock
-# a mock
-# * should be able to mock the same message twice w/ different args
-# * should be able to mock the same message twice w/ different args in reverse order
-# Stack (not implemented features)
-# * should transform to xml using #to_xml [NOT IMPLEMENTED]
-# * should convert from xml using #from_xml [NOT IMPLEMENTED]
-# A partial mock
-# * should work at the class level
-# * should revert to the original after each spec
-# * can be mocked w/ ordering
-# BDD framework
-# * should be adopted quickly
-# * should be intuitive
-# SharedBehaviourExample::OneThing
-# * should do what things do
-# * should have access to helper methods defined in the shared behaviour
-# SharedBehaviourExample::AnotherThing
-# * should do what things do
-# Stack (empty)
-# * should be empty
-# * should not be full
-# * should add to the top when sent #push
-# * should complain when sent #peek
-# * should complain when sent #pop
-# Stack (with one item)
-# * should not be empty
-# * should return the top item when sent #peek
-# * should NOT remove the top item when sent #peek
-# * should return the top item when sent #pop
-# * should remove the top item when sent #pop
-# * should not be full
-# * should add to the top when sent #push
-# Stack (with one item less than capacity)
-# * should not be empty
-# * should return the top item when sent #peek
-# * should NOT remove the top item when sent #peek
-# * should return the top item when sent #pop
-# * should remove the top item when sent #pop
-# * should not be full
-# * should add to the top when sent #push
-# Stack (full)
-# * should be full
-# * should not be empty
-# * should return the top item when sent #peek
-# * should NOT remove the top item when sent #peek
-# * should return the top item when sent #pop
-# * should remove the top item when sent #pop
-# * should complain on #push
-# A consumer of a stub
-# * should be able to stub methods on any Object
-# A stubbed method on a class
-# * should return the stubbed value
-# * should revert to the original method after each spec
-# * can stub! and mock the same message
-# A mock
-# * can stub!
-# * can stub! and mock
-# * can stub! and mock the same message
-# RSpec should integrate with Test::Unit::TestCase
-# * TestCase#setup should be called.
-# * RSpec should be able to access TestCase methods
-# * RSpec should be able to accept included modules
-
-Finished in 0.025956 seconds
-
-77 examples, 0 failures, 2 not implemented

data/README

@@ -1,70 +0,0 @@
-== RSpec
-
-RSpec is a Behaviour Definition Framework intended for use in Behaviour
-Driven Development. RSpec plays the same role that a unit testing framework
-would play in a Test Driven Development environment, but does so using
-words and structures that better support BDD.
-
-RSpec ships with four modules:
-
-Spec::Matchers provides Expression Matchers for use with Spec::Expectations
-and Spec::Mocks.
-
-Spec::Expectations supports setting expectations on your objects so you
-can do things like:
-
-  result.should equal(expected_result)
-  
-Spec::Mocks supports creating Mock Objects, Stubs, and adding Mock/Stub
-behaviour to your existing objects.
-
-Spec::Runner provides a very small but powerful DSL for writing executable
-examples of how your code should work.
-
-== Installation
-
-The simplest approach is to install the gem:
-
-  gem install -r rspec #mac users must sudo
-
-== Building the RSpec gem
-If you prefer to build the gem locally, check out source from svn://rubyforge.org/var/svn/rspec/trunk. Then
-do the following:
-
-  rake gem
-  gem install pkg/rspec-0.x.x.gem (you may have to sudo)
-
-== Running RSpec's specs
-In order to run RSpec's full suite of specs (rake pre_commit) you must install the following gems:
-
-* rake          # Runs the build script
-* rcov          # Verifies that the code is 100% covered by specs
-* webgen        # Generates the static HTML website
-* RedCloth      # Required by webgen
-* syntax        # Required by our own custom webgen extension to highlight ruby code
-* diff-lcs      # Required if you use the --diff switch
-* win32console  # Required by the --colour switch if you're on Windows
-* meta_project  # Required in order to make releases at RubyForge
-* heckle        # Required if you use the --heckle switch
-
-Once those are all installed, you should be able to run the suite with the following steps:
-
-* svn co svn://rubyforge.org/var/svn/rspec/trunk rspec
-* cd rspec
-* rake install_dependencies
-* cd example_rails_app
-* export RSPEC_RAILS_VERSION=1.2.3
-* rake rspec:generate_mysql_config
-* mysql -u root < db/mysql_setup.sql
-* cd ..
-* rake pre_commit
-
-
-Note that RSpec itself - once built - doesn't have any dependencies outside the Ruby core 
-and stdlib - with a few exceptions:
-
-* The spec command line uses diff-lcs when --diff is specified.
-* The spec command line uses heckle when --heckle is specified.
-* The Spec::Rake::SpecTask needs RCov if RCov is enabled in the task.
-
-See http://rspec.rubyforge.org for further documentation.

data/UPGRADE

@@ -1,31 +0,0 @@
-= Upgrading existing code to RSpec-0.9
-
-== General (see below for Spec::Rails specifics)
-
-=== New Syntax for should and should_not
-
-* Use translator (should get 90% of your code)
-* Manually fix "parenthesis" warnings
-
-=== Change before_context_eval to before_eval
-
-before_context_eval is an un-published hook used by
-Spec::Rails to create specialized behaviour contexts.
-Most of you don't need to change this, but for those
-who have exploited it, you'll need to change it to
-before_eval.
-
-== Spec::Rails
-
-=== spec_helper.rb
-
-We've added a new way to configure Spec::Runner to do
-things like use_transactional_fixtures and use_instantiated_fixtures.
-You'll need to update spec/spec_helper.rb accordingly. You can either
-just re-generate it:
-
-  script/generate rspec
-  
-Or modify spec_helper.rb based on the template, which can be found at:
-
-  vendor/plugins/rspec_on_rails/generators/rspec/templates/spec_helper.rb

data/bin/spec_translator

@@ -1,8 +0,0 @@
-#!/usr/bin/env ruby
-raise "\n\nUsage: spec_translator from_dir to_dir\n\n" if ARGV.size != 2
-$LOAD_PATH.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib"))
-require 'spec/translator'
-t = ::Spec::Translator.new
-from = ARGV[0]
-to = ARGV[1]
-t.translate(from, to)

data/examples/auto_spec_description_example.rb

@@ -1,19 +0,0 @@
-require File.dirname(__FILE__) + '/spec_helper'
-
-# Run spec w/ -fs to see the output of this file
-
-describe "Examples with no descriptions" do
-  
-  # description is auto-generated as "should equal(5)" based on the last #should
-  it do
-    3.should equal(3)
-    5.should equal(5)
-  end
-  
-  it { 3.should be < 5 }
-  
-  it { ["a"].should include("a") }
-  
-  it { [1,2,3].should respond_to(:size) }
-  
-end

data/examples/before_and_after_example.rb

@@ -1,39 +0,0 @@
-$global = 0
-
-describe "State created in before(:all)" do
-  before :all do
-    @sideeffect = 1
-    $global +=1
-  end
-
-  before :each do
-    @isolated = 1
-  end
-  
-  it "should be accessible from example" do
-    @sideeffect.should == 1
-    $global.should == 1
-    @isolated.should == 1
-
-    @sideeffect += 1
-    @isolated += 1
-  end
-
-  it "should not have sideffects" do
-    @sideeffect.should == 1
-    $global.should == 2
-    @isolated.should == 1
-
-    @sideeffect += 1
-    @isolated += 1
-  end
-
-  after :each do
-    $global += 1
-  end
-  
-  after :all do
-    $global.should == 3
-    $global = 0
-  end
-end

data/examples/behave_as_example.rb

@@ -1,45 +0,0 @@
-require File.dirname(__FILE__) + '/spec_helper'
-
-def behave_as_electric_musician
-  respond_to(:read_notes, :turn_down_amp)
-end
-
-def behave_as_musician
-  respond_to(:read_notes)
-end
-
-module BehaveAsExample
-  
-  class BluesGuitarist
-    def read_notes; end
-    def turn_down_amp; end
-  end
-  
-  class RockGuitarist
-    def read_notes; end
-    def turn_down_amp; end
-  end
-  
-  class ClassicGuitarist
-    def read_notes; end
-  end
-  
-  describe BluesGuitarist do
-    it "should behave as guitarist" do
-      BluesGuitarist.new.should behave_as_electric_musician
-    end
-  end
-
-  describe RockGuitarist do
-    it "should behave as guitarist" do
-      RockGuitarist.new.should behave_as_electric_musician
-    end
-  end
-
-  describe ClassicGuitarist do
-    it "should not behave as guitarist" do
-      ClassicGuitarist.new.should behave_as_musician
-    end
-  end
-  
-end

data/examples/dynamic_spec.rb

@@ -1,9 +0,0 @@
-require File.dirname(__FILE__) + '/spec_helper'
-
-describe "Some integers" do
-  (1..10).each do |n|
-    it "The root of #{n} square should be #{n}" do
-      Math.sqrt(n*n).should == n
-    end
-  end
-end

data/examples/helper_method_example.rb

@@ -1,11 +0,0 @@
-require File.dirname(__FILE__) + '/spec_helper'
-
-describe "a context with helper a method" do
-  def helper_method
-    "received call"
-  end
-  
-  it "should make that method available to specs" do
-    helper_method.should == "received call"
-  end
-end

data/examples/legacy_spec.rb

@@ -1,10 +0,0 @@
-context "A legacy spec" do
-  setup do
-  end
-  
-  specify "should work fine" do
-  end
-  
-  teardown do
-  end
-end

data/examples/not_yet_implemented_spec.rb

@@ -1,12 +0,0 @@
-require File.dirname(__FILE__) + '/spec_helper'
-require File.dirname(__FILE__) + "/stack"
-
-describe Stack, ' (not implemented features)'  do
-  before(:each) do
-    @stack = Stack.new
-  end
-
-  it "should transform to xml using #to_xml"
-  
-  it "should convert from xml using #from_xml"
-end

data/examples/priority.txt

@@ -1 +0,0 @@
-examples/custom_expectation_matchers.rb

data/examples/spec_helper.rb

@@ -1 +0,0 @@
-require File.dirname(__FILE__) + '/../lib/spec'

data/examples/test_case_adapter_example.rb

@@ -1,26 +0,0 @@
-#This is an example of using RSpec's expectations in test/unit.
-$LOAD_PATH.unshift File.join(File.dirname(__FILE__), "..", "lib")
-
-require 'test/unit'
-require 'spec/test_case_adapter'
-
-class IntegratingRSpecExpectationsIntoTestCaseTest < Test::Unit::TestCase
-
-  def test_should_support_rspecs_equality_expectations
-    5.should == 5
-  end
-
-  def test_should_support_rspecs_comparison_expectations
-    5.should be > 4
-  end
-  
-  class Band
-    def players
-      ["John", "Paul", "George", "Ringo"]
-    end
-  end
-
-  def test_should_support_rspecs_collection_expectations
-    Band.new.should have(4).players
-  end
-end

data/examples/test_case_spec.rb

@@ -1,65 +0,0 @@
-require File.dirname(__FILE__) + '/spec_helper'
-require 'test/unit'
-
-class RSpecIntegrationTest < Test::Unit::TestCase
-  def self.fixtures(*args)
-    @@fixtures = true
-  end
-  
-  def self.verify_class_method
-    @@fixtures.should == true
-  end
-  
-  def setup
-    @test_case_setup_called = true
-  end
-
-  def teardown
-    @test_case_teardown_called = true
-  end
-
-  def run(result)
-  end
-
-  def helper_method
-    @helper_method_called = true
-  end
-end
-
-module RandomHelperModule
-  def random_task
-    @random_task_called = true
-  end
-end
-
-describe "RSpec should integrate with Test::Unit::TestCase" do
-  inherit RSpecIntegrationTest
-  include RandomHelperModule
-  
-  fixtures :some_table
-
-  prepend_before(:each) {setup}
-
-  before(:each) do
-    @rspec_setup_called = true
-  end
-
-  it "TestCase#setup should be called." do
-    @test_case_setup_called.should be_true
-    @rspec_setup_called.should be_true
-  end
-
-  it "RSpec should be able to access TestCase methods" do
-    helper_method
-    @helper_method_called.should be_true
-  end
-
-  it "RSpec should be able to accept included modules" do
-    random_task
-    @random_task_called.should be_true
-  end
-  
-  after(:each) do
-    RSpecIntegrationTest.verify_class_method
-  end
-end

data/lib/spec/dsl/behaviour.rb

@@ -1,204 +0,0 @@
-module Spec
-  module DSL
-    class EvalModule < Module; end
-    class Behaviour
-      extend BehaviourCallbacks
-
-      class << self
-        def add_shared_behaviour(behaviour)
-          return if behaviour.equal?(found_behaviour = find_shared_behaviour(behaviour.description))
-          raise ArgumentError.new("Shared Behaviour '#{behaviour.description}' already exists") if found_behaviour
-          shared_behaviours << behaviour
-        end
-
-        def find_shared_behaviour(behaviour_description)
-          shared_behaviours.find { |b| b.description == behaviour_description }
-        end
-
-        def shared_behaviours
-          # TODO - this needs to be global, or at least accessible from
-          # from subclasses of Behaviour in a centralized place. I'm not loving
-          # this as a solution, but it works for now.
-          $shared_behaviours ||= []
-        end
-      end
-
-      def initialize(*args, &behaviour_block)
-        init_description(*args)
-        init_eval_module
-        before_eval
-        eval_behaviour(&behaviour_block)
-      end
-      
-    private
-
-      def init_description(*args)
-        @description = Description.new(*args)
-      end
-      
-      def init_eval_module
-        @eval_module = EvalModule.new
-        @eval_module.extend BehaviourEval::ModuleMethods
-        @eval_module.include BehaviourEval::InstanceMethods
-        @eval_module.behaviour = self
-        @eval_module.description = @description
-      end
-
-      def eval_behaviour(&behaviour_block)
-        @eval_module.class_eval(&behaviour_block)
-      end
-      
-    protected
-    
-      def before_eval
-      end
-      
-    public
-
-      def run(reporter, dry_run=false, reverse=false, timeout=nil)
-        raise "shared behaviours should never run" if shared?
-        reporter.add_behaviour(description)
-        prepare_execution_context_class
-        errors = run_before_all(reporter, dry_run)
-
-        specs = reverse ? examples.reverse : examples
-        example_execution_context = nil
-         
-        if errors.empty?
-          specs.each do |example|
-            example_execution_context = execution_context(example)
-            example_execution_context.copy_instance_variables_from(@before_and_after_all_context_instance) unless before_all_proc(behaviour_type).nil?
-            example.run(reporter, before_each_proc(behaviour_type), after_each_proc(behaviour_type), dry_run, example_execution_context, timeout)
-          end
-        end
-        
-        @before_and_after_all_context_instance.copy_instance_variables_from(example_execution_context) unless after_all_proc(behaviour_type).nil?
-        run_after_all(reporter, dry_run)
-      end
-
-      def number_of_examples
-        examples.length
-      end
-
-      def matches?(specified_examples)
-        matcher ||= ExampleMatcher.new(description)
-
-        examples.each do |example|
-          return true if example.matches?(matcher, specified_examples)
-        end
-        return false
-      end
-
-      def shared?
-        @description[:shared]
-      end
-
-      def retain_examples_matching!(specified_examples)
-        return if specified_examples.index(description)
-        matcher = ExampleMatcher.new(description)
-        examples.reject! do |example|
-          !example.matches?(matcher, specified_examples)
-        end
-      end
-
-      def methods
-        my_methods = super
-        my_methods |= @eval_module.methods
-        my_methods
-      end
-
-      # Includes modules in the Behaviour (the <tt>describe</tt> block).
-      def include(*args)
-        args << {} unless Hash === args.last
-        modules, options = args_and_options(*args)
-        required_behaviour_type = options[:behaviour_type]
-        if required_behaviour_type.nil? || required_behaviour_type.to_sym == behaviour_type.to_sym
-          @eval_module.include(*modules)
-        end
-      end
-
-    protected
-
-      def behaviour_type #:nodoc:
-        @description[:behaviour_type]
-      end
-
-      # Messages that this class does not understand
-      # are passed directly to the @eval_module.
-      def method_missing(sym, *args, &block)
-        @eval_module.send(sym, *args, &block)
-      end
-
-      def prepare_execution_context_class
-        plugin_mock_framework
-        weave_in_included_modules
-        define_predicate_matchers #this is in behaviour_eval
-        execution_context_class
-      end
-
-      def weave_in_included_modules
-        mods = included_modules
-        eval_module = @eval_module
-        execution_context_class.class_eval do
-          include eval_module
-          Spec::Runner.configuration.included_modules.each do |mod|
-            include mod
-          end
-          mods.each do |mod|
-            include mod
-          end
-        end
-      end
-
-      def execution_context(example)
-        execution_context_class.new(example)
-      end
-
-      def run_before_all(reporter, dry_run)
-        errors = []
-        unless dry_run
-          begin
-            @before_and_after_all_context_instance = execution_context(nil)
-            @before_and_after_all_context_instance.instance_eval(&before_all_proc(behaviour_type))
-          rescue => e
-            errors << e
-            location = "before(:all)"
-            reporter.example_finished(location, e, location) if reporter
-          end
-        end
-        errors
-      end
-      
-      def run_after_all(reporter, dry_run)
-        unless dry_run
-          begin 
-            @before_and_after_all_context_instance ||= execution_context(nil) 
-            @before_and_after_all_context_instance.instance_eval(&after_all_proc(behaviour_type)) 
-          rescue => e
-            location = "after(:all)"
-            reporter.example_finished(location, e, location) if reporter
-          end
-        end
-      end
-      
-      def plugin_mock_framework
-        case mock_framework = Spec::Runner.configuration.mock_framework
-        when Module
-          include mock_framework
-        else
-          require Spec::Runner.configuration.mock_framework
-          include Spec::Plugins::MockFramework
-        end
-      end
-      
-      def description
-        @description.to_s
-      end
-      
-      def described_type
-        @description.described_type
-      end
-
-    end
-  end
-end