resque-pool 0.3.0.beta.2 → 0.3.0

data/vendor/bundle/ruby/1.8/gems/rspec-core-2.9.0/features/example_groups/shared_examples.feature

@@ -0,0 +1,204 @@
+Feature: shared examples
+
+  Shared examples let you describe behaviour of types or modules. When
+  declared, a shared group's content is stored. It is only realized in the
+  context of another example group, which provides any context the shared group
+  needs to run.
+
+  A shared group is included in another group using any of:
+  
+      include_examples "name"      # include the examples in the current context
+      it_behaves_like "name"       # include the examples in a nested context
+      it_should_behave_like "name" # include the examples in a nested context
+
+  WARNING: Files containing shared groups must be loaded before the files that
+  use them.  While there are conventions to handle this, RSpec does _not_ do
+  anything special (like autoload). Doing so would require a strict naming
+  convention for files that would break existing suites.
+
+  CONVENTIONS:
+
+  1.  The simplest approach is to require files with shared examples explicitly
+      from the files that use them. Keep in mind that RSpec adds the `spec`
+      directory to the `LOAD_PATH`, so you can say `require
+      'shared_examples_for_widgets'` to require a file at
+      `#{PROJECT_ROOT}/spec/shared_examples_for_widgets.rb`.
+
+  2.  Put files containing shared examples in `spec/support/` and require files
+      in that directory from `spec/spec_helper.rb`:
+
+          Dir["./spec/support/**/*.rb"].each {|f| require f}
+
+      This is included in the generated `spec/spec_helper.rb` file in
+      `rspec-rails`
+
+  3. When all of the groups that include the shared group, just declare
+     the shared group in the same file.
+
+  Scenario: shared examples group included in two groups in one file
+    Given a file named "collection_spec.rb" with:
+      """
+      require "set"
+
+      shared_examples "a collection" do
+        let(:collection) { described_class.new([7, 2, 4]) }
+
+        context "initialized with 3 items" do
+          it "says it has three items" do
+            collection.size.should eq(3)
+          end
+        end
+
+        describe "#include?" do
+          context "with an an item that is in the collection" do
+            it "returns true" do
+              collection.include?(7).should be_true
+            end
+          end
+
+          context "with an an item that is not in the collection" do
+            it "returns false" do
+              collection.include?(9).should be_false
+            end
+          end
+        end
+      end
+
+      describe Array do
+        it_behaves_like "a collection"
+      end
+
+      describe Set do
+        it_behaves_like "a collection"
+      end
+      """
+    When I run `rspec collection_spec.rb --format documentation`
+    Then the examples should all pass
+    And the output should contain:
+      """
+      Array
+        behaves like a collection
+          initialized with 3 items
+            says it has three items
+          #include?
+            with an an item that is in the collection
+              returns true
+            with an an item that is not in the collection
+              returns false
+
+      Set
+        behaves like a collection
+          initialized with 3 items
+            says it has three items
+          #include?
+            with an an item that is in the collection
+              returns true
+            with an an item that is not in the collection
+              returns false
+      """
+
+  Scenario: Providing context to a shared group using a block
+    Given a file named "shared_example_group_spec.rb" with:
+    """
+    require "set"
+
+    shared_examples "a collection object" do
+      describe "<<" do
+        it "adds objects to the end of the collection" do
+          collection << 1
+          collection << 2
+          collection.to_a.should eq([1,2])
+        end
+      end
+    end
+
+    describe Array do
+      it_behaves_like "a collection object" do
+        let(:collection) { Array.new }
+      end
+    end
+
+    describe Set do
+      it_behaves_like "a collection object" do
+        let(:collection) { Set.new }
+      end
+    end
+    """
+    When I run `rspec shared_example_group_spec.rb --format documentation`
+    Then the examples should all pass
+    And the output should contain:
+      """
+      Array
+        behaves like a collection object
+          <<
+            adds objects to the end of the collection
+
+      Set
+        behaves like a collection object
+          <<
+            adds objects to the end of the collection
+      """
+
+  Scenario: Passing parameters to a shared example group
+    Given a file named "shared_example_group_params_spec.rb" with:
+    """
+    shared_examples "a measurable object" do |measurement, measurement_methods|
+      measurement_methods.each do |measurement_method|
+        it "should return #{measurement} from ##{measurement_method}" do
+          subject.send(measurement_method).should == measurement
+        end
+      end
+    end
+
+    describe Array, "with 3 items" do
+      subject { [1, 2, 3] }
+      it_should_behave_like "a measurable object", 3, [:size, :length]
+    end
+
+    describe String, "of 6 characters" do
+      subject { "FooBar" }
+      it_should_behave_like "a measurable object", 6, [:size, :length]
+    end
+    """
+    When I run `rspec shared_example_group_params_spec.rb --format documentation`
+    Then the examples should all pass
+    And the output should contain:
+      """
+      Array with 3 items
+        it should behave like a measurable object
+          should return 3 from #size
+          should return 3 from #length
+
+      String of 6 characters
+        it should behave like a measurable object
+          should return 6 from #size
+          should return 6 from #length
+      """
+
+  Scenario: Aliasing "it_should_behave_like" to "it_has_behavior"
+    Given a file named "shared_example_group_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.alias_it_should_behave_like_to :it_has_behavior, 'has behavior:'
+      end
+
+      shared_examples 'sortability' do
+        it 'responds to <=>' do
+          sortable.should respond_to(:<=>)
+        end
+      end
+
+      describe String do
+        it_has_behavior 'sortability' do
+          let(:sortable) { 'sample string' }
+        end
+      end
+      """
+    When I run `rspec shared_example_group_spec.rb --format documentation`
+    Then the examples should all pass
+    And the output should contain:
+      """
+      String
+        has behavior: sortability
+          responds to <=>
+      """

data/vendor/bundle/ruby/1.8/gems/rspec-core-2.9.0/features/expectation_framework_integration/configure_expectation_framework.feature

@@ -0,0 +1,73 @@
+Feature: configure expectation framework
+
+  By default, RSpec is configured to include rspec-expectations for expressing
+  desired outcomes. You can also configure RSpec to use:
+
+  * rspec/expectations (explicitly)
+  * stdlib assertions
+    * test/unit assertions in ruby 1.8
+    * minitest assertions in ruby 1.9
+  * rspec/expecations _and_ stlib assertions
+
+  Note that when you do not use rspec-expectations, you must explicitly
+  provide a description to every example.  You cannot rely on the generated
+  descriptions provided by rspec-expectations.
+
+  Scenario: configure rspec-expectations (explicitly)
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.expect_with :rspec
+      end
+
+      describe 5 do
+        it "is greater than 4" do
+          5.should be > 4
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass
+
+  Scenario: configure test/unit assertions
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.expect_with :stdlib
+      end
+
+      describe 5 do
+        it "is greater than 4" do
+          assert 5 > 4, "expected 5 to be greater than 4"
+        end
+
+        specify { assert 5 < 6 }
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the output should contain "2 examples, 1 failure"
+     And the output should contain:
+       """
+            NotImplementedError:
+              Generated descriptions are only supported when you use rspec-expectations.
+       """
+
+  Scenario: configure rspec/expecations AND test/unit assertions
+    Given a file named "example_spec.rb" with:
+      """
+      RSpec.configure do |config|
+        config.expect_with :rspec, :stdlib
+      end
+
+      describe 5 do
+        it "is greater than 4" do
+          assert 5 > 4, "expected 5 to be greater than 4"
+        end
+
+        it "is less than 6" do
+          5.should be < 6
+        end
+      end
+      """
+    When I run `rspec example_spec.rb`
+    Then the examples should all pass

data/vendor/bundle/ruby/1.8/gems/rspec-core-2.9.0/features/filtering/exclusion_filters.feature

@@ -0,0 +1,139 @@
+Feature: exclusion filters
+
+  You can exclude examples from a run by declaring an exclusion filter and
+  then tagging examples, or entire groups, with that filter.
+
+  If you set the `treat_symbols_as_metadata_keys_with_true_values` config option
+  to `true`, you can specify metadata using only symbols.
+  
+  Scenario: exclude an example
+    Given a file named "spec/sample_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        # declare an exclusion filter
+        c.filter_run_excluding :broken => true
+      end
+
+      describe "something" do
+        it "does one thing" do
+        end
+
+        # tag example for exclusion by adding metadata
+        it "does another thing", :broken => true do
+        end
+      end
+      """
+    When I run `rspec ./spec/sample_spec.rb --format doc`
+    Then the output should contain "does one thing"
+    And the output should not contain "does another thing"
+
+  Scenario: exclude a group
+    Given a file named "spec/sample_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.filter_run_excluding :broken => true
+      end
+  
+      describe "group 1", :broken => true do
+        it "group 1 example 1" do
+        end
+  
+        it "group 1 example 2" do
+        end
+      end
+  
+      describe "group 2" do
+        it "group 2 example 1" do
+        end
+      end
+      """
+    When I run `rspec ./spec/sample_spec.rb --format doc`
+    Then the output should contain "group 2 example 1"
+    And  the output should not contain "group 1 example 1"
+    And  the output should not contain "group 1 example 2"
+  
+  Scenario: exclude multiple groups
+    Given a file named "spec/sample_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.filter_run_excluding :broken => true
+      end
+  
+      describe "group 1", :broken => true do
+        before(:all) do
+          raise "you should not see me"
+        end
+        
+        it "group 1 example 1" do
+        end
+  
+        it "group 1 example 2" do
+        end
+      end
+  
+      describe "group 2", :broken => true do
+        before(:each) do
+          raise "you should not see me"
+        end
+        
+        it "group 2 example 1" do
+        end
+      end
+      """
+    When I run `rspec ./spec/sample_spec.rb --format doc`
+    Then the output should match /All examples were filtered out/
+    And  the examples should all pass
+    And  the output should not contain "group 1"
+    And  the output should not contain "group 2"
+
+  Scenario: before/after(:all) hooks in excluded example group are not run
+    Given a file named "spec/before_after_all_exclusion_filter_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.filter_run_excluding :broken => true
+      end
+
+      describe "group 1" do
+        before(:all) { puts "before all in included group" }
+        after(:all)  { puts "after all in included group"  }
+
+        it "group 1 example" do
+        end
+      end
+
+      describe "group 2", :broken => true do
+        before(:all) { puts "before all in excluded group" }
+        after(:all)  { puts "after all in excluded group"  }
+
+        context "context 1" do
+          it "group 2 context 1 example 1" do
+          end
+        end
+      end
+      """
+    When I run `rspec ./spec/before_after_all_exclusion_filter_spec.rb`
+    Then the output should contain "before all in included group"
+     And the output should contain "after all in included group"
+     And the output should not contain "before all in excluded group"
+     And the output should not contain "after all in excluded group"
+
+  Scenario: Use symbols as metadata
+    Given a file named "symbols_as_metadata_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.treat_symbols_as_metadata_keys_with_true_values = true
+        c.filter_run_excluding :broken
+      end
+
+      describe "something" do
+        it "does one thing" do
+        end
+
+        # tag example for exclusion by adding metadata
+        it "does another thing", :broken do
+        end
+      end
+      """
+    When I run `rspec symbols_as_metadata_spec.rb --format doc`
+    Then the output should contain "does one thing"
+    And the output should not contain "does another thing"

data/vendor/bundle/ruby/1.8/gems/rspec-core-2.9.0/features/filtering/if_and_unless.feature

@@ -0,0 +1,168 @@
+Feature: :if and :unless
+
+  The `:if` and `:unless` metadata keys can be used to filter examples without
+  needing to configure an exclusion filter.
+
+  Scenario: implicit :if filter
+    Given a file named "implicit_if_filter_spec.rb" with:
+      """
+      describe ":if => true group", :if => true do
+        it(":if => true group :if => true example", :if => true) { }
+        it(":if => true group :if => false example", :if => false) { }
+        it(":if => true group no :if example") { }
+      end
+
+      describe ":if => false group", :if => false do
+        it(":if => false group :if => true example", :if => true) { }
+        it(":if => false group :if => false example", :if => false) { }
+        it(":if => false group no :if example") { }
+      end
+
+      describe "no :if group" do
+        it("no :if group :if => true example", :if => true) { }
+        it("no :if group :if => false example", :if => false) { }
+        it("no :if group no :if example") { }
+      end
+      """
+    When I run `rspec implicit_if_filter_spec.rb --format doc`
+    Then the output should contain all of these:
+      | :if => true group :if => true example  |
+      | :if => true group no :if example       |
+      | :if => false group :if => true example |
+      | no :if group :if => true example       |
+      | no :if group no :if example            |
+    And the output should not contain any of these:
+      | :if => true group :if => false example  |
+      | :if => false group :if => false example |
+      | :if => false group no :if example       |
+      | no :if group :if => false example       |
+
+  Scenario: implicit :unless filter
+    Given a file named "implicit_unless_filter_spec.rb" with:
+      """
+      describe ":unless => true group", :unless => true do
+        it(":unless => true group :unless => true example", :unless => true) { }
+        it(":unless => true group :unless => false example", :unless => false) { }
+        it(":unless => true group no :unless example") { }
+      end
+
+      describe ":unless => false group", :unless => false do
+        it(":unless => false group :unless => true example", :unless => true) { }
+        it(":unless => false group :unless => false example", :unless => false) { }
+        it(":unless => false group no :unless example") { }
+      end
+
+      describe "no :unless group" do
+        it("no :unless group :unless => true example", :unless => true) { }
+        it("no :unless group :unless => false example", :unless => false) { }
+        it("no :unless group no :unless example") { }
+      end
+      """
+    When I run `rspec implicit_unless_filter_spec.rb --format doc`
+    Then the output should contain all of these:
+      | :unless => true group :unless => false example  |
+      | :unless => false group :unless => false example |
+      | :unless => false group no :unless example       |
+      | no :unless group :unless => false example       |
+      | no :unless group no :unless example             |
+    And the output should not contain any of these:
+      | :unless => true group :unless => true example  |
+      | :unless => true group no :unless example       |
+      | :unless => false group :unless => true example |
+      | no :unless group :unless => true example       |
+
+  Scenario: combining implicit filter with explicit inclusion filter
+    Given a file named "explicit_inclusion_filter_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.filter_run :focus => true
+      end
+
+      describe "group with :focus", :focus => true do
+        it("focused example") { }
+        it("focused :if => true example", :if => true) { }
+        it("focused :if => false example", :if => false) { }
+        it("focused :unless => true example", :unless => true) { }
+        it("focused :unless => false example", :unless => false) { }
+      end
+
+      describe "group without :focus" do
+        it("unfocused example") { }
+        it("unfocused :if => true example", :if => true) { }
+        it("unfocused :if => false example", :if => false) { }
+        it("unfocused :unless => true example", :unless => true) { }
+        it("unfocused :unless => false example", :unless => false) { }
+      end
+      """
+    When I run `rspec explicit_inclusion_filter_spec.rb --format doc`
+    Then the output should contain all of these:
+      | focused example                  |
+      | focused :if => true example      |
+      | focused :unless => false example |
+    And the output should not contain any of these:
+      | focused :if => false example     |
+      | focused :unless => true example  |
+      | unfocused                        |
+
+  Scenario: combining implicit filter with explicit exclusion filter
+    Given a file named "explicit_exclusion_filter_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.filter_run_excluding :broken => true
+      end
+
+      describe "unbroken group" do
+        it("included example") { }
+        it("included :if => true example", :if => true) { }
+        it("included :if => false example", :if => false) { }
+        it("included :unless => true example", :unless => true) { }
+        it("included :unless => false example", :unless => false) { }
+      end
+
+      describe "broken group", :broken => true do
+        it("excluded example") { }
+        it("excluded :if => true example", :if => true) { }
+        it("excluded :if => false example", :if => false) { }
+        it("excluded :unless => true example", :unless => true) { }
+        it("excluded :unless => false example", :unless => false) { }
+      end
+      """
+    When I run `rspec explicit_exclusion_filter_spec.rb --format doc`
+    Then the output should contain all of these:
+      | included example                  |
+      | included :if => true example      |
+      | included :unless => false example |
+    And the output should not contain any of these:
+      | included :if => false example     |
+      | included :unless => true example  |
+      | excluded                          |
+
+  Scenario: override implicit :if and :unless exclusion filters
+    Given a file named "override_implicit_filters_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.filter_run_excluding :if => :exclude_me, :unless => :exclude_me_for_unless
+      end
+
+      describe ":if filtering" do
+        it(":if => true example", :if => true) { }
+        it(":if => false example", :if => false) { }
+        it(":if => :exclude_me example", :if => :exclude_me) { }
+      end
+
+      describe ":unless filtering" do
+        it(":unless => true example", :unless => true) { }
+        it(":unless => false example", :unless => false) { }
+        it(":unless => :exclude_me_for_unless example", :unless => :exclude_me_for_unless) { }
+      end
+      """
+    When I run `rspec override_implicit_filters_spec.rb --format doc`
+    Then the output should contain all of these:
+      | :if => true example      |
+      | :if => false example     |
+      | :unless => true example  |
+      | :unless => false example |
+    And the output should not contain any of these:
+      | :if => :exclude_me example                |
+      | :unless => :exclude_me_for_unless example |
+

data/vendor/bundle/ruby/1.8/gems/rspec-core-2.9.0/features/filtering/inclusion_filters.feature

@@ -0,0 +1,105 @@
+Feature: inclusion filters
+
+  You can constrain which examples are run by declaring an inclusion filter. The
+  most common use case is to focus on a subset of examples as you're focused on
+  a particular problem.
+
+  You can specify metadata using only symbols if you set the
+  `treat_symbols_as_metadata_keys_with_true_values` config option to `true`.
+
+  Background:
+    Given a file named "spec/spec_helper.rb" with:
+      """
+      RSpec.configure do |c|
+        c.filter_run_including :focus => true
+      end
+      """
+
+  Scenario: focus on an example
+    Given a file named "spec/sample_spec.rb" with:
+      """
+      require "spec_helper"
+
+      describe "something" do
+        it "does one thing" do
+        end
+
+        it "does another thing", :focus => true do
+        end
+      end
+      """
+    When I run `rspec spec/sample_spec.rb --format doc`
+    Then the output should contain "does another thing"
+    And the output should not contain "does one thing"
+
+  Scenario: focus on a group
+    Given a file named "spec/sample_spec.rb" with:
+      """
+      require "spec_helper"
+
+      describe "group 1", :focus => true do
+        it "group 1 example 1" do
+        end
+
+        it "group 1 example 2" do
+        end
+      end
+
+      describe "group 2" do
+        it "group 2 example 1" do
+        end
+      end
+      """
+    When I run `rspec spec/sample_spec.rb --format doc`
+    Then the output should contain "group 1 example 1"
+    And  the output should contain "group 1 example 2"
+    And  the output should not contain "group 2 example 1"
+
+  Scenario: before/after(:all) hooks in unmatched example group are not run
+    Given a file named "spec/before_after_all_inclusion_filter_spec.rb" with:
+      """
+      require "spec_helper"
+
+      describe "group 1", :focus => true do
+        before(:all) { puts "before all in focused group" }
+        after(:all)  { puts "after all in focused group"  }
+
+        it "group 1 example" do
+        end
+      end
+
+      describe "group 2" do
+        before(:all) { puts "before all in unfocused group" }
+        after(:all)  { puts "after all in unfocused group"  }
+
+        context "context 1" do
+          it "group 2 context 1 example 1" do
+          end
+        end
+      end
+      """
+    When I run `rspec ./spec/before_after_all_inclusion_filter_spec.rb`
+    Then the output should contain "before all in focused group"
+     And the output should contain "after all in focused group"
+     And the output should not contain "before all in unfocused group"
+     And the output should not contain "after all in unfocused group"
+
+  Scenario: Use symbols as metadata
+    Given a file named "symbols_as_metadata_spec.rb" with:
+      """
+      RSpec.configure do |c|
+        c.treat_symbols_as_metadata_keys_with_true_values = true
+        c.filter_run :current_example
+      end
+
+      describe "something" do
+        it "does one thing" do
+        end
+
+        it "does another thing", :current_example do
+        end
+      end
+      """
+    When I run `rspec symbols_as_metadata_spec.rb --format doc`
+    Then the output should contain "does another thing"
+    And the output should not contain "does one thing"