minitest-context 0.1.0

data/.gitignore

@@ -0,0 +1 @@
+doc/

data/.travis.yml

@@ -0,0 +1,8 @@
+rvm:
+  - 1.8.7 
+  - 1.9.2
+  - 1.9.3
+  - rbx-2.0
+  - jruby
+  - ruby-head
+  - ree

data/.yardopts

@@ -0,0 +1,9 @@
+--no-private
+-M redcarpet
+-m markdown
+--hide-void-return
+--main README.txt
+- 
+README.txt
+LICENSE.txt
+

data/Gemfile

@@ -0,0 +1,2 @@
+source :rubygems
+gemspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (C) 2011 by Robert Gleeson
+
+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/README.txt

@@ -0,0 +1,50 @@
+= minitest/context
+  
+  * Author    : Rob Gleeson <rob@flowof.info>
+  * Home      : https://github.com/robgleeson/minitest-context
+  * API       : http://rubydoc.info/github/robgleeson/minitest-context/master/frames
+  * CI status : http://travis-ci.org/#!/robgleeson/minitest-context
+
+== Description
+  
+  minitest/context can define contexts for code reuse in MiniTest specs that share common expectations.
+  The idea orginated from the shared_context() and include_context() methods distributed with RSpec.
+
+  MiniTest supports code re-use in MiniTest specs already, via a subclass of MiniTest::Spec.
+  You might want to look at that option, if you didn't know about it already.
+
+== Examples
+
+  MiniTest::Context.define(:operand) do
+    before do
+      @operand = 40
+    end
+  end
+
+  describe "Addition operator" do
+    inherit_context :operand
+  
+    it "should perform addition on the operand." do
+      @operand = @operand + 10
+      @operand.must_equal(50)
+    end
+  end
+
+  describe "Subtraction operator" do
+    inherit_context :operand
+
+    it "should perform subtraction on the operand." do
+      @operand = @operand - 10
+      @operand.must_equal(30)
+    end
+  end
+
+== Install
+
+  gem install minitest-context
+
+== License
+  
+  See LICENSE.txt
+
+

data/Rakefile

@@ -0,0 +1,7 @@
+desc "Run tests."
+task :test do
+  $LOAD_PATH.unshift *%w(./lib ./spec)
+  Dir["./spec/*_spec.rb"].each { |f| require(f) }
+end
+
+task :default => :test

data/lib/minitest/context.rb

@@ -0,0 +1,41 @@
+require 'minitest/ext/spec'
+
+module MiniTest::Context 
+
+  autoload :VERSION, "minitest/context/version"
+
+  class << self
+    
+    # @private
+    attr_reader :list
+
+    # Define a context for re-use in a subclass of MiniTest::Spec.
+    #
+    # @example
+    #   
+    #   MiniTest::Context.define(:example) do
+    #     before do
+    #       puts "Hello, world!"
+    #     end
+    #   end
+    #
+    # @param [Symbol] name  
+    #   The name of the context to define.
+    #
+    # @param [Proc]   block 
+    #   A Proc object that is evaluated in a subclass of MiniTest::Spec 
+    #   through {MiniTest::Spec.inherit_context inherit_context}.
+    #
+    # @raise [ArgumentError] 
+    #   Raises an ArgumentError if _block_ is not supplied as an argument.
+    #
+    # @return [void]
+    def define name, &block
+      raise ArgumentError, "Block expected." unless block_given?
+      @list ||= Hash.new { |h,k| h[k] = [] }
+      @list[name] << block
+    end
+
+  end
+
+end

data/lib/minitest/context/version.rb

@@ -0,0 +1,5 @@
+module MiniTest
+  module Context
+    VERSION = "0.1.0"
+  end
+end

data/lib/minitest/ext/spec.rb

@@ -0,0 +1,32 @@
+class MiniTest::Spec
+  
+  class << self 
+
+    # Evaluates a context by _name_ in the scope of a MiniTest::Spec subclass.
+    #
+    # @example
+    #   
+    #   describe ExampleClass do
+    #     inherit_context :example
+    #   end
+    #
+    # @param [Symbol] name
+    #   The name of a context which has been defined by {MiniTest::Context.define define}.
+    #
+    # @raise [ArgumentError]
+    #   Raises an ArgumentError if a context by _name_ does not exist.
+    #
+    # @return [void] 
+    def inherit_context name
+      if MiniTest::Context.list.has_key?(name) 
+        MiniTest::Context.list[name].each do |context| 
+          class_eval &context
+        end
+      else
+        raise ArgumentError, "No context with #{name} found."
+      end
+    end
+
+  end
+
+end

data/minitest-context.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "minitest/context/version"
+
+Gem::Specification.new do |s|
+  s.name        = "minitest-context"
+  s.version     = MiniTest::Context::VERSION
+  s.authors     = ["robgleeson"]
+  s.email       = ["rob@flowof.info"]
+  s.homepage    = "https://github.com/robgleeson/minitest-context"
+
+  s.summary     = "Defines contexts for code reuse in MiniTest specs that share common expectations."
+  s.description = s.summary
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_runtime_dependency     "minitest", "~> 2.5"
+  s.add_development_dependency "rake"    , "~> 0.9.2"
+end

data/spec/contexts/before_block_context.rb

@@ -0,0 +1,5 @@
+MiniTest::Context.define(:before_block) do
+  before do
+    @example = [1,2,3]
+  end
+end

data/spec/contexts/stacked_context.rb

@@ -0,0 +1,11 @@
+MiniTest::Context.define(:stacked_context) do
+  before do
+    @number ||= 1
+  end
+end
+
+MiniTest::Context.define(:stacked_context) do
+  before do
+    @number += 1
+  end
+end

data/spec/minitest_context_spec.rb

@@ -0,0 +1,47 @@
+require 'spec_helper'
+
+describe "Contexts" do
+  describe "an inherited context." do
+    inherit_context :before_block
+
+    it "should execute a before block and assign an Array to @example." do
+      @example.must_be_instance_of(Array)
+    end
+  end
+
+  describe "two suites who inherit the same context." do
+    inherit_context :before_block
+    
+    describe "Suite 1" do
+      it "should inherit context from the parent suite." do
+        @example.must_be_instance_of(Array)
+      end
+    end
+
+    describe "Suite 2" do
+      it "should inherit context from the parent suite." do
+        @example.must_be_instance_of(Array)
+      end
+    end
+  end
+
+  describe "A stacked context." do
+    inherit_context :stacked_context
+
+    it "should execute all stacked contexts." do
+      @number.must_equal(2)
+    end
+  end
+end
+
+describe "MiniTest::Context.define" do
+  it "should raise an ArgumentError when no block is recieved." do
+    proc { MiniTest::Context.define(:fail) }.must_raise(ArgumentError)
+  end
+end
+
+describe "MiniTest::Spec.inherit_context" do
+  it "should raise an ArgumentError when no context by given name can be found." do
+    proc { MiniTest::Spec.inherit_context(:fail) }.must_raise(ArgumentError) 
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,6 @@
+require 'bundler/setup'
+require 'minitest/spec'
+require 'minitest/context'
+require 'minitest/autorun'
+
+Dir["./spec/contexts/*.rb"].each { |f| require(f) }

metadata

@@ -0,0 +1,115 @@
+--- !ruby/object:Gem::Specification 
+name: minitest-context
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- robgleeson
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-15 00:00:00 +01:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 9
+        segments: 
+        - 2
+        - 5
+        version: "2.5"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        hash: 63
+        segments: 
+        - 0
+        - 9
+        - 2
+        version: 0.9.2
+  type: :development
+  version_requirements: *id002
+description: Defines contexts for code reuse in MiniTest specs that share common expectations.
+email: 
+- rob@flowof.info
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .travis.yml
+- .yardopts
+- Gemfile
+- LICENSE.txt
+- README.txt
+- Rakefile
+- lib/minitest/context.rb
+- lib/minitest/context/version.rb
+- lib/minitest/ext/spec.rb
+- minitest-context.gemspec
+- spec/contexts/before_block_context.rb
+- spec/contexts/stacked_context.rb
+- spec/minitest_context_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/robgleeson/minitest-context
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Defines contexts for code reuse in MiniTest specs that share common expectations.
+test_files: 
+- spec/contexts/before_block_context.rb
+- spec/contexts/stacked_context.rb
+- spec/minitest_context_spec.rb
+- spec/spec_helper.rb