filet 0.2.0 → 0.2.1

data/.travis.yml

@@ -0,0 +1,5 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - rbx
+  - jruby

data/Gemfile

@@ -3,9 +3,8 @@ source "http://rubygems.org"
 # Specify your gem's dependencies in filet.gemspec
 gemspec
 
-gem 'rake'
-
 unless ENV["TRAVIS"]
   gem 'ruby-debug19', :platforms => :ruby_19
   gem 'ruby-debug', :platforms => :mri_18
 end
+

data/Rakefile

@@ -5,7 +5,7 @@ require 'rake/testtask'
 task :default => :test
 
 Rake::TestTask.new do |t|
-  t.libs << '.'
+  t.libs << 'test'
   t.test_files = FileList['test/**/*_test.rb']
   t.verbose = true
 end

data/Readme.md

@@ -2,6 +2,12 @@
 
 Filet is a dsl for acceptance testing on top of Test::Unit.
 
+## Why filet?
+
+Filet is framework agnostic, it can be used with plain Ruby or it can integrate with Rails or any framework of your choice, you can use it with Capybara, Webrat or any other tools you like.
+Filet has no dependencies.
+Filet is Test:Unit but pretty!
+
 ## Installation
 
     gem install filet
@@ -15,30 +21,6 @@ require 'filet'
 include Filet
 ```
 
-## Hooks
-
-We provide several hooks for options processing.
-
-1. Filet.feature_hook
-
-This allows to process the options you pass for the feature
-
-```ruby
-Filet.feature_hook do |base, options|
-  base.send(:include, Capybara)
-end
-```
-
-2. Filet.context_hook
-
-This allows to process the options you pass for the context
-
-```ruby
-Filet.context_hook do |base, options|
-  base.send(:include, SomeModule) if options[:js]
-end
-```
-
 ## Example
 
 ```ruby
@@ -48,11 +30,20 @@ feature 'Creating a post', %{
   In order to show it to people
 } do
 
+  background do
+    # setup data
+  end
+
   scenario 'Everything goes fine after a submit' do
     # test code
   end
 
   context 'Something goes wrong', :js => true do
+
+    background do
+      # setup more data
+    end
+
     scenario 'my keyboard stopped working' do
       # test code
     end
@@ -60,9 +51,58 @@ feature 'Creating a post', %{
     scenario 'I forgot to fill up the form' do
       # test code
     end
+
+    teardown do
+      # clean up
+    end
   end
 end
 ```
+
+## Hooks
+
+We provide several hooks for options processing.
+
+1.  Filet.feature_hook
+
+    This allows to process the options you pass for the feature
+
+    ```ruby
+    Filet.feature_hook do |base, options|
+      base.send(:include, Capybara)
+    end
+    ```
+
+2.  Filet.context_hook
+
+    This allows to process the options you pass for the context
+
+    ```ruby
+    Filet.context_hook do |base, options|
+      base.send(:include, SomeModule) if options[:js]
+    end
+    ```
+
+3.  Filet.base_klass
+
+    This allows you to define the base_klass of your tests. It tries to make a guess based on your environment and integrates with Rails 3 and Rails 2. The default is Test::Unit::TestCase.
+
+    ```ruby
+    Filet.base_klass = ActiveSupport::TestCase
+    ```
+
+    *NOTE*: This hook must be initialized before you include the Filet module
+
+## Compatibility
+
+Filet supports and is tested against ruby 1.8.7, 1.9.2, jruby-1.6.2 and rubinius-1.2.4
+
+[![Build Status](http://travis-ci.org/xing/filet.png)](http://travis-ci.org/xing/filet)
+
+### Rails Integration
+
+It tries to make a guess based on your environment and integrates with Rails 3 and Rails 2. We recommend that you place your tests inside the test/integration folder.
+
 ## Acknowledgements
 
 We'd like to thank our employer XING AG for letting us work on this project as part of our innovation time and releasing it as open source.

data/filet.gemspec

@@ -11,6 +11,10 @@ Gem::Specification.new do |s|
   s.summary     = %q{Acceptance Testing framework for Test::Unit}
   s.description = %q{Extension for Test::Unit to have a Steak-like DSL for acceptance testing}
 
+  s.add_development_dependency "rake"
+  s.add_development_dependency "activesupport"
+  s.add_development_dependency "i18n"
+
   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) }

data/lib/filet.rb

@@ -1,10 +1,10 @@
+require "filet/version"
+require "filet/hooks"
+require "filet/integration"
+
 module Filet
-  def rails?
-    defined?(ActionController)
+  def self.included(base)
+    require "filet/test_case"
   end
-
-  extend self
 end
 
-require "filet/version"
-require "filet/test_case"

data/lib/filet/hooks.rb

@@ -1,33 +1,37 @@
-module Filet::Hooks
-  def self.extended(base)
-    base.class_eval do
-      @@context_hook = nil
-      @@feature_hook = nil
+module Filet
+  module Hooks
+    def self.extended(base)
+      base.class_eval do
+        @@context_hook = nil
+        @@feature_hook = nil
+      end
+    end
+
+    # TODO: Abstract the hook creation if we need another one
+    def feature_hook(&block)
+      if block
+        @@feature_hook = block
+      else
+        @@feature_hook
+      end
     end
-  end
 
-  # TODO: Abstract the hook creation if we need another one
-  def feature_hook(&block)
-    if block
+    def feature_hook=(block)
       @@feature_hook = block
-    else
-      @@feature_hook
     end
-  end
 
-  def feature_hook=(block)
-    @@feature_hook = block
-  end
+    def context_hook(&block)
+      if block
+        @@context_hook = block
+      else
+        @@context_hook
+      end
+    end
 
-  def context_hook(&block)
-    if block
+    def context_hook=(block)
       @@context_hook = block
-    else
-      @@context_hook
     end
   end
 
-  def context_hook=(block)
-    @@context_hook = block
-  end
+  extend Hooks
 end

data/lib/filet/integration.rb

@@ -0,0 +1,27 @@
+module Filet
+  module Integration
+    def base_klass
+      @@filet_base_klass ||=
+        # rails 3
+        if defined?(ActionDispatch)
+          require 'action_dispatch/testing/integration'
+          ActionDispatch::IntegrationTest
+        # rails 2
+        elsif defined?(ActionController)
+          ActionController::IntegrationTest
+        elsif defined?(ActiveSupport)
+          require 'active_support/test_case'
+          ActiveSupport::TestCase
+        else
+          require 'test/unit/testcase'
+          Test::Unit::TestCase
+        end
+    end
+
+    def base_klass=(klass)
+      @@filet_base_klass = klass
+    end
+  end
+
+  extend Integration
+end

data/lib/filet/test_case.rb

@@ -1,15 +1,9 @@
-require 'test/unit'
 require 'filet'
 require 'filet/backport'
-require 'filet/hooks'
 
 module Filet
-  base_klass = Filet.rails? ? ActionController::IntegrationTest : Test::Unit::TestCase
-
-  class TestCase < base_klass
-
-    extend Filet::Hooks
-    extend Filet::Backport::Declarative unless Filet.rails?
+  class TestCase < Filet.base_klass
+    extend Filet::Backport::Declarative unless respond_to?(:test)
 
     class << self
       attr_accessor :description
@@ -19,17 +13,23 @@ module Filet
       def context(name, options = {}, &block)
         klass = create_class(name, self, &block)
 
-        context_hook.call(klass, options) if context_hook
+        Filet.context_hook.call(klass, options) if Filet.context_hook
 
         klass
       end
 
       def background(&block)
-        define_method(:setup, &block)
+        define_method(:setup) do
+          super()
+          instance_eval(&block)
+        end
       end
 
       def teardown(&block)
-        define_method(:teardown, &block)
+        define_method(:teardown) do
+          instance_eval(&block)
+          super()
+        end
       end
 
     end
@@ -37,17 +37,18 @@ module Filet
     # Placeholder so test/unit ignores test cases without any tests.
     def default_test
     end
-
   end
 
   def feature(name, description, options = {}, &block)
     klass = create_class(name, Filet::TestCase, &block)
     klass.description = description
 
-    Filet::TestCase.feature_hook.call(klass, options) if Filet::TestCase.feature_hook
+    Filet.feature_hook.call(klass, options) if Filet.feature_hook
     klass
   end
 
+  private
+
   def create_class(name, superclass, &block)
     klass = Class.new(superclass)
     name = name.gsub(/(^\d*|\W)/, ' ').lstrip

data/lib/filet/version.rb

@@ -1,3 +1,3 @@
 module Filet
-  VERSION = "0.2.0"
+  VERSION = "0.2.1"
 end

data/test/filet/active_support_integration_test.rb

@@ -0,0 +1,12 @@
+require 'test_helper'
+require 'active_support/test_case'
+
+class ActiveSupportIntegrationTest < Test::Unit::TestCase
+  def setup
+    Filet.base_klass = nil
+  end
+
+  def test_base_klass
+    assert_equal ActiveSupport::TestCase, Filet.base_klass
+  end
+end

data/test/filet/test_case_test.rb

@@ -1,7 +1,4 @@
-require 'test/unit'
-require 'filet/test_case'
-
-include Filet
+require 'test_helper'
 
 module Filet
   class TestCaseTest < Test::Unit::TestCase
@@ -23,7 +20,7 @@ module Filet
     end
 
     def test_provides_a_hook_to_process_feature_options
-      Filet::TestCase.feature_hook do |base, options|
+      Filet.feature_hook do |base, options|
         base.instance_variable_set("@feature_hook_on", true)
       end
 
@@ -31,11 +28,11 @@ module Filet
 
       assert klass.instance_variable_get("@feature_hook_on"), "hook is not used"
 
-      Filet::TestCase.feature_hook = nil
+      Filet.feature_hook = nil
     end
 
     def test_provides_a_hook_to_process_context_options
-      Filet::TestCase.context_hook do |base, options|
+      Filet.context_hook do |base, options|
         if options[:js]
           base.instance_variable_set("@js_option", true)
         end
@@ -49,25 +46,23 @@ module Filet
 
       assert klass.instance_variable_get("@js_option"), "hook is not used"
 
-      Filet::TestCase.context_hook = nil
+      Filet.context_hook = nil
     end
 
-    def test_class_nesting
-      context_klass = context_klass =
-        context_klass2 = context_klass2 = nil
+    def test_class_nesting_names
+      context_klass = context_klass2 = nil
 
       feature("feature name", "description") do
-        context_klass = context("some context") do
+        context("some context") do
           context_klass = context("the criteria")
         end
 
-        context_klass2 = context("other context") do
+        context("other context") do
           context_klass2 = context("the criteria")
         end
       end
 
       assert_not_equal context_klass.name, context_klass2.name
-      assert_not_equal context_klass.name, context_klass2.name
     end
 
     def test_background_method
@@ -81,6 +76,25 @@ module Filet
       assert klass.instance_variable_get('@setup_created')
     end
 
+    def test_nested_backgrounds
+      feature("feature name", "description") do
+        background do
+          instance_variable_set("@feature_background", true)
+        end
+        context "nested" do
+          background do
+            instance_variable_set("@nested_background", true)
+          end
+        end
+      end
+
+      test = Filet::TestCase::FeatureName::Nested.new('default_test')
+      test.setup
+
+      assert test.instance_variable_get("@feature_background")
+      assert test.instance_variable_get("@nested_background")
+    end
+
     def test_teardown_method
       klass = feature("feature name", "description") do
         teardown do

data/test/test_helper.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'bundler/setup'
+require 'test/unit'
+require 'filet'
+
+include Filet
+

metadata

@@ -1,27 +1,79 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: filet
-version: !ruby/object:Gem::Version
-  version: 0.2.0
-  prerelease: 
+version: !ruby/object:Gem::Version 
+  hash: 21
+  prerelease: false
+  segments: 
+  - 0
+  - 2
+  - 1
+  version: 0.2.1
 platform: ruby
-authors:
+authors: 
 - Jorge Dias
 - Jakub Godawa
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-08-01 00:00:00.000000000 +02:00
+
+date: 2011-08-24 00:00:00 +02:00
 default_executable: 
-dependencies: []
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: activesupport
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: i18n
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id003
 description: Extension for Test::Unit to have a Steak-like DSL for acceptance testing
-email:
+email: 
 - jorge@mrdias.com
 - jakub.godawa@gmail.com
 executables: []
+
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - .gitignore
+- .travis.yml
 - Gemfile
 - LICENSE
 - Rakefile
@@ -30,33 +82,47 @@ files:
 - lib/filet.rb
 - lib/filet/backport.rb
 - lib/filet/hooks.rb
+- lib/filet/integration.rb
 - lib/filet/test_case.rb
 - lib/filet/version.rb
+- test/filet/active_support_integration_test.rb
 - test/filet/test_case_test.rb
+- test/test_helper.rb
 has_rdoc: true
-homepage: ''
+homepage: ""
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  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
-      version: '0'
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      hash: 3
+      segments: 
+      - 0
+      version: "0"
 requirements: []
+
 rubyforge_project: 
-rubygems_version: 1.6.2
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: Acceptance Testing framework for Test::Unit
-test_files:
+test_files: 
+- test/filet/active_support_integration_test.rb
 - test/filet/test_case_test.rb
+- test/test_helper.rb