minispec-given 3.0.0.beta.2

data/examples/integration/given_spec.rb

@@ -0,0 +1,73 @@
+require 'example_helper'
+
+describe "Running Givens before Whens" do
+  Given(:info) { [] }
+  Given { info << "outer1" }
+  Given { info << "outer2" }
+
+  context "using a when without result" do
+    When { info << "when" }
+
+    context "inner with When" do
+      Given { info << "inner1" }
+      Given { info << "inner2" }
+      Then { given_assert_equal ["outer1", "outer2", "inner1", "inner2", "when"], info }
+
+      context "using a nested When" do
+        When { info << "when2" }
+        Then { given_assert_equal ["outer1", "outer2", "inner1", "inner2", "when", "when2"], info}
+      end
+
+      context "using two nested When" do
+        When { info << "when2a" }
+        When { info << "when2b" }
+        Then {
+          given_assert_equal ["outer1", "outer2", "inner1", "inner2", "when", "when2a", "when2b"], info
+        }
+      end
+    end
+  end
+
+  context "using a when with a result" do
+    When(:result) { info << "when" }
+
+    context "inner with when" do
+      Given { info << "inner1" }
+      Given { info << "inner2" }
+      Then { given_assert_equal ["outer1", "outer2", "inner1", "inner2", "when"], info }
+    end
+  end
+
+  context "using no whens" do
+    Given { info << "inner1" }
+    Given { info << "inner2" }
+    Then { given_assert_equal ["outer1", "outer2", "inner1", "inner2"], info }
+  end
+end
+
+describe "Lazy Givens" do
+  Given(:bomb) { fail StandardError, "SHOULD NEVER BE CALLED" }
+
+  context "when called" do
+    Then {
+      given_assert_raises(StandardError, /NEVER/) { bomb }
+    }
+  end
+
+  context "when not called" do
+    Given(:value) { :ok }
+    Then { given_assert_equal :ok, value }
+  end
+end
+
+describe "Non-Lazy Givens" do
+  Given(:info) { [] }
+
+  When { info << :when }
+
+  context "inner" do
+    Given!(:a) { info << :given; "A VALUE" }
+    Then { given_assert_equal [:given, :when], info }
+  end
+
+end

data/examples/integration/invariant_spec.rb

@@ -0,0 +1,31 @@
+require 'example_helper'
+
+describe "Invariants" do
+  Given(:info) { [] }
+
+  Invariant { info << "I1" }
+
+  Then { given_assert_equal ["I1"], info }
+
+  context "with nested invariants" do
+    Invariant { info << "I2" }
+
+    Then { given_assert_equal ["I1", "I2"], info }
+  end
+
+  context "with multiple invariants" do
+    Invariant { info << "I2a" }
+    Invariant { info << "I2b" }
+
+    Then { given_assert_equal ["I1", "I2a", "I2b"], info }
+  end
+
+  context "with a when" do
+    Invariant { info << "I2" }
+
+    When(:when_info) { info.dup }
+
+    Then { given_assert_equal ["I1", "I2"], info }
+    Then { given_assert_equal [], when_info }
+  end
+end

data/examples/integration/then_spec.rb

@@ -0,0 +1,8 @@
+require 'example_helper'
+
+describe "Then" do
+  context "empty thens with natural assertions" do
+    use_natural_assertions_if_supported
+    Then { }
+  end
+end

data/examples/loader.rb

@@ -0,0 +1,4 @@
+ARGV.each do |fn|
+  puts "Loading #{fn} ..."
+  load fn
+end

data/examples/minitest_helper.rb

@@ -0,0 +1,38 @@
+
+module GivenAssertions
+  def given_assert(cond)
+    assert cond
+  end
+
+  def given_assert_equal(expected, actual)
+    actual.must_equal(expected)
+  end
+
+  def given_assert_match(pattern, actual)
+    actual.must_match(pattern)
+  end
+
+  def given_assert_not_match(pattern, actual)
+    actual.wont_match(pattern)
+  end
+
+  def given_assert_raises(error, pattern=//, &block)
+    ex = assert_raises(error, &block)
+    ex.message.must_match(pattern)
+  end
+end
+
+module NaturalAssertionControl
+  def use_natural_assertions_if_supported(enabled=true)
+    if enabled && ! Given::NATURAL_ASSERTIONS_SUPPORTED
+      Given {
+        skip "Natural assertions are not supported in JRuby"
+      }
+    else
+      use_natural_assertions(enabled)
+    end
+  end
+end
+
+Minitest::Spec.send(:include, GivenAssertions)
+include NaturalAssertionControl

data/examples/other/line_example.rb

@@ -0,0 +1,9 @@
+require 'example_helper'
+
+describe "Line Spec" do
+
+  Then { puts "FIRST" }
+
+  Then { puts "SECOND" }
+
+end

data/examples/stack/stack.rb

@@ -0,0 +1,29 @@
+class Stack
+  class StackError < StandardError; end
+  class UnderflowError < StackError; end
+
+  def initialize
+    @items = []
+  end
+
+  def depth
+    @items.size
+  end
+
+  def empty?
+    @items.empty?
+  end
+
+  def top
+    @items.last
+  end
+
+  def push(item)
+    @items << item
+  end
+
+  def pop
+    fail UnderflowError, "Cannot pop an empty stack" if empty?
+    @items.pop
+  end
+end

data/examples/stack/stack_spec.rb

@@ -0,0 +1,60 @@
+require 'example_helper'
+require 'stack'
+
+Given.use_natural_assertions
+
+describe Stack do
+  Given(:stack) { Stack.new }
+  Given(:initial_contents) { [] }
+  Given { initial_contents.each do |item| stack.push(item) end }
+
+  Invariant { stack.empty? == (stack.depth == 0) }
+
+  context "with an empty stack" do
+    Given(:initial_contents) { [] }
+    Then { stack.depth == 0 }
+
+    context "when pushing" do
+      When { stack.push(:an_item) }
+
+      Then { stack.depth == 1 }
+      Then { stack.top == :an_item }
+    end
+
+    context "when popping" do
+      When(:result) { stack.pop }
+      Then { result == Failure(Stack::UnderflowError, /empty/) }
+    end
+  end
+
+  context "with one item" do
+    Given(:initial_contents) { [:an_item] }
+
+    context "when popping" do
+      When(:pop_result) { stack.pop }
+
+      Then { pop_result == :an_item }
+      Then { stack.depth == 0 }
+    end
+  end
+
+  context "with several items" do
+    Given(:initial_contents) { [:second_item, :top_item] }
+    Given!(:original_depth) { stack.depth }
+
+    context "when pushing" do
+      When { stack.push(:new_item) }
+
+      Then { stack.top == :new_item }
+      Then { stack.depth == original_depth + 1 }
+    end
+
+    context "when popping" do
+      When(:pop_result) { stack.pop }
+
+      Then { pop_result == :top_item }
+      Then { stack.top == :second_item }
+      Then { stack.depth == original_depth - 1 }
+    end
+  end
+end

data/examples/stack/stack_spec1.rb

@@ -0,0 +1,3 @@
+
+$:.unshift File.dirname(__FILE__) + "/.."
+require 'stack/stack_spec'

data/lib/given.rb

@@ -0,0 +1,2 @@
+
+require 'given/core'

data/lib/minispec-given.rb

@@ -0,0 +1,9 @@
+# This file file is to make bundler happy when auto-requiring files
+# based on gem name.  If you are manually requiring rspec/given,
+# please use the canonical require file, ie.
+#
+#     require 'minispec/given'
+#
+# Thanks.
+
+require 'given/minispec/all'

data/lib/minispec/given.rb

@@ -0,0 +1 @@
+require 'given/minispec/all'

data/lib/minitest/given.rb

@@ -0,0 +1 @@
+require 'given/minispec/all'

data/rakelib/bundler_fix.rb

@@ -0,0 +1,17 @@
+module Rake
+  module DSL
+
+    # Define run so that it will run in a bundle clean environment.
+
+    if defined?(Bundler)
+      def nobundle
+        Bundler.with_clean_env { yield }
+      end
+    else
+      def nobundle
+        yield
+      end
+    end
+
+  end
+end

data/rakelib/gemspec.rake

@@ -0,0 +1,161 @@
+require 'rubygems/package_task'
+require './lib/given/version'
+
+if ! defined?(Gem)
+  puts "Package Target requires RubyGEMs"
+else
+  PKG_FILES = FileList[
+    '[A-Z]*',
+    'lib/*.rb',
+    'lib/**/*.rb',
+    'rakelib/**/*',
+    'test/**/*.rb',
+    'spec/**/*.rb',
+    'examples/**/*',
+    'doc/**/*',
+  ]
+  PKG_FILES.exclude('TAGS')
+  GIVEN_CORE_FILES = FileList[*PKG_FILES].
+    exclude("lib/*-given.rb").
+    exclude("lib/rspec/**/*").
+    exclude("lib/mini*/**/*").
+    exclude("spec/**/*").
+    exclude("examples/**/*")
+  RSPEC_GIVEN_FILES = FileList[*PKG_FILES].
+    exclude("lib/mini*/**/*").
+    exclude("lib/mini*-given.rb").
+    exclude("lib/given/**/*")
+  MINISPEC_GIVEN_FILES = FileList[*PKG_FILES].
+    exclude("spec/**/*").
+    exclude("lib/rspec-given.rb").
+    exclude("lib/rspec*/**/*").
+    exclude("lib/given/**/*")
+
+  RSPEC_GIVEN_SPEC = Gem::Specification.new do |s|
+    s.name = 'rspec-given'
+    s.version = Given::VERSION
+    s.summary = "Given/When/Then Specification Extensions for RSpec."
+    s.description = <<EOF
+Given is an RSpec extension that allows the use of Given/When/Then
+terminology when defining specifications.
+EOF
+    s.files = RSPEC_GIVEN_FILES.to_a
+    s.require_path = 'lib'                         # Use these for libraries.
+    s.rdoc_options = [
+      '--line-numbers', '--inline-source',
+      '--main' , 'doc/main.rdoc',
+      '--title', 'RSpec Given Extensions'
+    ]
+
+    s.add_dependency("given_core", "= #{Given::VERSION}")
+    s.add_dependency("rspec", ">= 2.12")
+
+    s.required_ruby_version = '>= 1.9.2'
+    s.license = "MIT"
+
+    s.author = "Jim Weirich"
+    s.email = "jim.weirich@gmail.com"
+    s.homepage = "http://github.com/jimweirich/rspec-given"
+    s.rubyforge_project = "given"
+  end
+
+  MINISPEC_GIVEN_SPEC = Gem::Specification.new do |s|
+    s.name = 'minispec-given'
+    s.version = Given::VERSION
+    s.summary = "Given/When/Then Specification Extensions for Minispec::Spec."
+    s.description = <<EOF
+Given is a Minitest::Spec extension that allows the use of Given/When/Then
+terminology when defining specifications.
+EOF
+    s.files = MINISPEC_GIVEN_FILES.to_a
+    s.require_path = 'lib'                         # Use these for libraries.
+    s.rdoc_options = [
+      '--line-numbers', '--inline-source',
+      '--main' , 'doc/main.rdoc',
+      '--title', 'Minitest::Spec Given Extensions'
+    ]
+
+    s.add_dependency("given_core", "= #{Given::VERSION}")
+    s.add_dependency("minitest", "> 4.3")
+
+    s.required_ruby_version = '>= 1.9.2'
+    s.license = "MIT"
+
+    s.author = "Jim Weirich"
+    s.email = "jim.weirich@gmail.com"
+    s.homepage = "http://github.com/jimweirich/rspec-given"
+    s.rubyforge_project = "given"
+  end
+
+  GIVEN_CORE_SPEC = Gem::Specification.new do |s|
+    s.name = 'given_core'
+    s.version = Given::VERSION
+    s.summary = "Core engine for RSpec::Given and Minitest::Given."
+    s.description = <<EOF
+Given_core is the basic functionality behind rspec-given and minispec-given,
+extensions that allow the use of Given/When/Then terminology when defining
+specifications.
+EOF
+    s.files = GIVEN_CORE_FILES.to_a
+    s.require_path = 'lib'                         # Use these for libraries.
+    s.rdoc_options = [
+      '--line-numbers', '--inline-source',
+      '--main' , 'doc/main.rdoc',
+      '--title', 'RSpec Given Extensions'
+    ]
+
+    s.add_dependency("sorcerer", ">= 0.3.7")
+
+    s.required_ruby_version = '>= 1.9.2'
+    s.license = "MIT"
+
+    s.author = "Jim Weirich"
+    s.email = "jim.weirich@gmail.com"
+    s.homepage = "http://github.com/jimweirich/rspec-given"
+    s.rubyforge_project = "given"
+  end
+
+  Gem::PackageTask.new(MINISPEC_GIVEN_SPEC) do |pkg|
+    pkg.need_zip = false
+    pkg.need_tar = false
+  end
+
+  Gem::PackageTask.new(RSPEC_GIVEN_SPEC) do |pkg|
+    pkg.need_zip = false
+    pkg.need_tar = false
+  end
+
+  Gem::PackageTask.new(GIVEN_CORE_SPEC) do |pkg|
+    pkg.need_zip = false
+    pkg.need_tar = false
+  end
+
+  file "rspec-given.gemspec" => ["rakelib/gemspec.rake"] do |t|
+    require 'yaml'
+    open(t.name, "w") { |f| f.puts RSPEC_GIVEN_SPEC.to_yaml }
+  end
+
+  file "minispec-given.gemspec" => ["rakelib/gemspec.rake"] do |t|
+    require 'yaml'
+    open(t.name, "w") { |f| f.puts MINISPEC_GIVEN_SPEC.to_yaml }
+  end
+
+  file "given_core.gemspec" => ["rakelib/gemspec.rake"] do |t|
+    require 'yaml'
+    open(t.name, "w") { |f| f.puts GIVEN_CORE_SPEC.to_yaml }
+  end
+
+  desc "Create a stand-alone gemspec"
+  task :gemspec => ["rspec-given.gemspec", "minispec-given.gemspec", "given_core.gemspec"]
+
+  desc "Check Filelists"
+  task :filelists do
+    puts "==============="
+    puts "GIVEN_CORE_FILES=#{GIVEN_CORE_FILES.inspect}"
+    puts "==============="
+    puts "RSPEC_GIVEN_FILES=#{RSPEC_GIVEN_FILES.inspect}"
+    puts "==============="
+    puts "MINISPEC_GIVEN_FILES=#{MINISPEC_GIVEN_FILES.inspect}"
+    puts "==============="
+  end
+end