steak 0.3.7 → 0.3.8

data/README.rdoc

@@ -36,8 +36,6 @@ If you are not in Rails but use RSpec, then Steak is just some aliases providing
 
 == Getting started
 
-<em><b>NOTE:</b> Please note that the stable version of Steak only works with Rails 2.x and RSpec 1.x. If you want to try with Rails 3 or RSpec 2, then you can install the prerelease version of Steak (using <tt>gem install steak --pre</tt>) which is based on the experimental <tt>rails3</tt> branch.</em>
-
 === Not in Rails
 
 Just install and require the damned gem!
@@ -49,8 +47,8 @@ Then in your spec or spec helper:
   require 'steak'
   
 That's all. You don't really need to require RSpec.
-  
-=== In Rails
+
+=== In Rails 2.x (stable branch)
 
 Assuming you have already setup rspec-rails, add this to your project's <tt>config/environments/test.rb</tt>:
 
@@ -86,6 +84,51 @@ You run your acceptance specs just like your regular specs. Individually...
 
   $ rake spec:acceptance
   
+=== In Rails 3 (master branch)
+
+Add this to your project's <tt>Gemfile</tt>:
+
+  gem 'steak', '>= 0.4.0.a5'
+  
+And install it:
+  
+  $ bundle install
+  
+Run the generator:
+
+  $ rails generate steak
+  
+That will create some basic helper files and directory structure under the +spec/acceptance+ directory, already configured for +Capybara+. If you want to use +Webrat+, just pass it to the generator:
+
+  $ rails generate steak --webrat
+
+Spend one minute on getting familiar with the structure and files you've got.
+
+Now you may want to create your first acceptance spec:
+
+  $ rails generate acceptance_spec this_is_my_first_feature
+  
+You run your acceptance specs just like your regular specs. Individually...
+
+  $ spec spec/acceptance/this_is_my_first_feature_spec.rb
+  
+...or all together:
+
+  $ spec spec/acceptance
+  
+...you can also do:
+
+  $ rake spec:acceptance
+  
+== Resources
+
+- Source: http://github.com/cavalle/steak
+- Issues: http://github.com/cavalle/steak/issues
+- Group: http://groups.google.com/group/steakrb
+- IRC channel: #steakrb on freenode
+- Tutorial: http://jeffkreeftmeijer.com/2010/steak-because-cucumber-is-for-vegetarians/
+- Hashtag: #steakrb
+  
 == Credits
 
 Steak was created by Luismi Cavallé and improved thanks to the love from:
@@ -94,5 +137,8 @@ Steak was created by Luismi Cavallé and improved thanks to the love from:
 - Felipe Talavera
 - Paco Guzmán
 - Jeff Kreeftmeijer
+- Jaime Iniesta
+- Emili Parreño
+- Andreas Wolff
 
-Copyright (c) 2009, 2010 Luismi Cavallé, released under the MIT license
+Copyright (c) 2009, 2010 Luismi Cavallé, released under the MIT license

data/Rakefile

@@ -9,57 +9,8 @@ Spec::Rake::SpecTask.new do |t|
   t.libs = ["spec"]
 end
 
-
 task :default => ["spec"]
 
-# This builds the actual gem. For details of what all these options
-# mean, and other ones you can add, check the documentation here:
-#
-#   http://rubygems.org/read/chapter/20
-#
-spec = Gem::Specification.new do |s|
-
-  # Change these as appropriate
-  s.name              = "steak"
-  s.version           = "0.3.7"
-  s.summary           = "If you are not in Rails but use RSpec, then Steak is just some aliases providing you with the language of acceptance testing (feature, scenario, background). If you are in Rails, you also have a couple of generators, a rake task and full Rails integration testing (meaning Webrat support, for instance)"
-  s.description       = "Minimalist acceptance testing on top of RSpec"
-  s.author            = "Luismi Cavallé"
-  s.email             = "luismi@lmcavalle.com"
-  s.homepage          = "http://github.com/cavalle/steak"
-
-  s.has_rdoc          = true
-  s.extra_rdoc_files  = %w(README.rdoc)
-  s.rdoc_options      = %w(--main README.rdoc)
-
-  # Add any extra files to include in the gem
-  s.files             = %w(init.rb MIT-LICENSE Rakefile README.rdoc) + Dir.glob("{spec,lib/**/*,generators/**/*}")
-  s.require_paths     = ["lib"]
-
-  # If you want to depend on other gems, add them here, along with any
-  # relevant versions
-  s.add_dependency("rspec")
-end
-
-# This task actually builds the gem. We also regenerate a static
-# .gemspec file, which is useful if something (i.e. GitHub) will
-# be automatically building a gem for this project. If you're not
-# using GitHub, edit as appropriate.
-#
-# To publish your gem online, install the 'gemcutter' gem; Read more 
-# about that here: http://gemcutter.org/pages/gem_docs
-Rake::GemPackageTask.new(spec) do |pkg|
-  pkg.gem_spec = spec
-end
-
-desc "Build the gemspec file #{spec.name}.gemspec"
-task :gemspec do
-  file = File.dirname(__FILE__) + "/#{spec.name}.gemspec"
-  File.open(file, "w") {|f| f << spec.to_ruby }
-end
-
-task :package => :gemspec
-
 # Generate documentation
 Rake::RDocTask.new do |rd|
   rd.main = "README.rdoc"

data/generators/steak/templates/steak.rake

@@ -1,6 +1,6 @@
 unless ARGV.any? {|a| a =~ /^gems/} # Don't load anything when running the gems:* tasks
 
-load File.dirname(__FILE__) + '/rspec.rake'
+require 'spec/rake/spectask'
 
 namespace :spec do
   desc "Run the code examples in spec/acceptance"
@@ -8,6 +8,13 @@ namespace :spec do
     t.spec_opts = ['--options', "\"#{RAILS_ROOT}/spec/spec.opts\""]
     t.spec_files = FileList["spec/acceptance/**/*_spec.rb"]
   end
+  
+  # Setup stats to include acceptance specs
+  task :statsetup do
+    require 'code_statistics'
+    ::STATS_DIRECTORIES << %w(Acceptance\ specs spec/acceptance) if File.exist?('spec/acceptance')
+    ::CodeStatistics::TEST_TYPES << "Acceptance specs" if File.exist?('spec/acceptance')
+  end
 end
 
 end

data/spec/acceptance/acceptance_helper.rb

@@ -0,0 +1,55 @@
+require 'rubygems'
+require 'spec'
+require File.dirname(__FILE__) + "/../../lib/steak"
+require 'tempfile'
+
+module Factories
+  def create_spec(options)
+    options = {:content => options} unless options.is_a?(Hash)
+    path = (options[:path] || Dir.tmpdir) + "/#{String.random}_spec.rb"
+    File.open(path, "w") do |file|
+      file.write options[:content]
+    end
+    path
+  end
+  
+  def create_rails_app(options = {})
+    path = Dir.tmpdir + "rails_app_#{String.random}"
+    FileUtils.rm_rf path
+    `rails #{path}`
+    FileUtils.rm path + '/public/index.html'
+    File.open(path + "/config/environments/test.rb", "a") do |file|
+      file.write "\nconfig.gem 'rspec-rails', :lib => false\n"
+    end
+    FileUtils.cp_r File.dirname(__FILE__) + "/../../", path + "/vendor/plugins/steak"
+    
+    Dir.chdir path do
+      `script/generate rspec`
+    end
+    
+    unless options[:setup_steak] == false
+      Dir.chdir path do
+        `script/generate steak`
+      end
+    end
+    
+    path
+  end
+  
+end
+
+module HelperMethods
+  def run_spec(file_path)
+    `spec #{file_path} 2>&1`
+  end
+end
+
+class String
+  CHARS = ('a'..'z').to_a + ('A'..'Z').to_a
+  def self.random(size = 8)
+    (0..size).map{ CHARS[rand(CHARS.length)] }.join
+  end
+end
+
+Spec::Runner.configuration.include(Factories)
+Spec::Runner.configuration.include(HelperMethods)

data/spec/acceptance/acceptance_spec_generator_spec.rb

@@ -0,0 +1,45 @@
+require File.dirname(__FILE__) + "/acceptance_helper.rb"
+
+feature "Acceptance spec generator for rails", %q{
+  In order to quickly add a new acceptance spec
+  As a developer
+  I want to run a generator that creates it for me
+} do
+  
+  background do
+    @rails_app = create_rails_app
+  end
+  
+  scenario "Adding new acceptance spec" do
+    Dir.chdir @rails_app do
+      `script/generate acceptance_spec document_creation`
+    end
+  
+    File.exist?(@rails_app + "/spec/acceptance/document_creation_spec.rb").should be_true
+  end
+  
+  scenario "Adding new acceptance spec (plural name)" do
+    Dir.chdir @rails_app do
+      `script/generate acceptance_spec creating_documents`
+    end
+  
+    File.exist?(@rails_app + "/spec/acceptance/creating_documents_spec.rb").should be_true
+  end
+  
+  scenario "Adding new acceptance spec (pascalized name)" do
+    Dir.chdir @rails_app do
+      `script/generate acceptance_spec DocumentCreation`
+    end
+  
+    File.exist?(@rails_app + "/spec/acceptance/document_creation_spec.rb").should be_true
+  end
+  
+  scenario "Adding new acceptance spec (name ending with _spec)" do
+    Dir.chdir @rails_app do
+      `script/generate acceptance_spec document_creation_spec`
+    end
+  
+    File.exist?(@rails_app + "/spec/acceptance/document_creation_spec.rb").should be_true
+  end
+
+end

data/spec/acceptance/basic_spec.rb

@@ -0,0 +1,51 @@
+require File.dirname(__FILE__) + "/acceptance_helper.rb"
+
+feature "Acceptance spec execution", %q{
+  In order to write better software
+  As a ruby developer
+  I want to execute acceptance specs
+} do
+  
+  scenario "Minimal acceptance spec" do
+    spec_file = create_spec <<-SPEC
+      require '#{File.dirname(__FILE__) + "/../../lib/steak"}'  
+      feature "Minimal spec" do
+        scenario "First scenario" do
+          true.should be_true
+        end
+      end
+    SPEC
+    output = run_spec spec_file
+    output.should =~ /1 example, 0 failures/
+  end
+  
+  scenario "Minimal acceptance spec that fails" do
+    spec_file = create_spec <<-SPEC
+      require '#{File.dirname(__FILE__) + "/../../lib/steak"}'  
+      feature "Minimal spec" do
+        scenario "First scenario" do
+          true.should be_false
+        end
+      end
+    SPEC
+    output = run_spec spec_file
+    output.should =~ /1 example, 1 failure/
+  end
+  
+  scenario "Acceptance spec with background" do
+    spec_file = create_spec <<-SPEC
+      require '#{File.dirname(__FILE__) + "/../../lib/steak"}'  
+      feature "Minimal spec" do
+        background do
+          @value = 17
+        end
+        scenario "First scenario" do
+          @value.should == 17
+        end
+      end
+    SPEC
+    output = run_spec spec_file
+    output.should =~ /1 example, 0 failures/
+  end
+  
+end

data/spec/acceptance/rails_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + "/acceptance_helper.rb"
+
+feature "Acceptance spec execution", %q{
+  In order to write better web apps
+  As a rails developer
+  I want to execute acceptance specs
+} do
+  
+  scenario "Minimal acceptance spec" do
+    rails_app = create_rails_app
+    spec_file = create_spec :path    => rails_app + "/spec/acceptance", 
+                            :content => <<-SPEC
+      require File.dirname(__FILE__) + "/acceptance_helper.rb"
+      feature "Minimal spec" do
+        scenario "First scenario" do
+          Rails.env.should be_test
+        end
+      end
+    SPEC
+    output = run_spec spec_file
+    output.should =~ /1 example, 0 failures/
+  end
+  
+  scenario "Integration stuff" do
+    rails_app = create_rails_app
+    spec_file = create_spec :path    => rails_app + "/spec/acceptance", 
+                            :content => <<-SPEC
+      require File.dirname(__FILE__) + "/acceptance_helper.rb"
+      feature "Minimal spec" do
+        scenario "First scenario" do
+          get "/"
+          response.should have_text(/No route matches/)
+        end
+      end
+    SPEC
+    output = run_spec spec_file
+    output.should =~ /1 example, 0 failures/
+  end
+  
+end

data/spec/acceptance/steak_generator_spec.rb

@@ -0,0 +1,96 @@
+require File.dirname(__FILE__) + "/acceptance_helper.rb"
+
+feature "Steak generator for rails", %q{
+  In order to quickly start to hack my rails project with steak
+  As a developer
+  I want to run a generator that sets everything up for me
+} do
+
+  scenario "Running generator in an empty project" do
+    rails_app = create_rails_app(:setup_steak => false)
+
+    Dir.chdir rails_app do
+      `script/generate steak`
+    end
+
+    File.exist?(rails_app + "/spec/acceptance/acceptance_helper.rb").should be_true
+    File.exist?(rails_app + "/spec/acceptance/support/helpers.rb").should be_true
+    File.exist?(rails_app + "/spec/acceptance/support/paths.rb").should be_true
+    File.exist?(rails_app + "/lib/tasks/steak.rake").should be_true
+  end
+
+  scenario "Running generator with capybara by default" do
+    rails_app = create_rails_app(:setup_steak => false)
+
+    Dir.chdir rails_app do
+      `script/generate steak`
+    end
+
+    spec_file = create_spec :path    => rails_app + "/spec/acceptance",
+                            :content => <<-SPEC
+      require File.dirname(__FILE__) + "/acceptance_helper.rb"
+      feature "Capybara spec" do
+        scenario "First scenario" do
+          visit "/"
+          page.should have_content('No route matches')
+        end
+      end
+    SPEC
+    output = run_spec spec_file
+    output.should =~ /1 example, 0 failures/
+  end
+
+  scenario "Running generator with webrat" do
+    rails_app = create_rails_app(:setup_steak => false)
+
+    Dir.chdir rails_app do
+      `script/generate steak --webrat`
+    end
+
+    spec_file = create_spec :path    => rails_app + "/spec/acceptance",
+                            :content => <<-SPEC
+      require File.dirname(__FILE__) + "/acceptance_helper.rb"
+      feature "Capybara spec" do
+        scenario "First scenario" do
+          visit "/"
+          response.should contain('No route matches')
+        end
+      end
+    SPEC
+    output = run_spec spec_file
+    output.should =~ /1 example, 0 failures/
+  end
+  
+  scenario "Running rake stats" do
+    rails_app = create_rails_app
+
+    Dir.chdir rails_app do
+      `script/generate steak`
+      `rake stats`.should =~ /Acceptance specs/
+    end
+  end
+  
+  scenario "Running specs with rake" do
+    rails_app = create_rails_app(:setup_steak => true)
+
+    spec_file = create_spec :path    => rails_app + "/spec/acceptance",
+                            :content => <<-SPEC
+      require File.dirname(__FILE__) + "/acceptance_helper.rb"
+      feature "Basic spec" do
+        scenario "First scenario" do
+          true.should == true
+        end
+      end
+    SPEC
+
+    Dir.chdir rails_app do
+      `rake db:create db:migrate db:test:prepare`
+
+      output = `rake spec:acceptance`
+      output.should =~ /1 example, 0 failures/
+
+      output = `rake`
+      output.should =~ /1 example, 0 failures/
+    end
+  end
+end

metadata

@@ -1,12 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: steak
 version: !ruby/object:Gem::Version 
+  hash: 3
   prerelease: false
   segments: 
   - 0
   - 3
-  - 7
-  version: 0.3.7
+  - 8
+  version: 0.3.8
 platform: ruby
 authors: 
 - "Luismi Cavall\xC3\xA9"
@@ -14,29 +15,33 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-06 00:00:00 +02:00
+date: 2010-05-31 00:00:00 +02:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rspec
   prerelease: false
   requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
     requirements: 
     - - ">="
       - !ruby/object:Gem::Version 
+        hash: 27
         segments: 
+        - 1
+        - 3
         - 0
-        version: "0"
+        version: 1.3.0
   type: :runtime
   version_requirements: *id001
-description: Minimalist acceptance testing on top of RSpec
+description: If you are not in Rails but use Rspec, then Steak is just some aliases providing you with the language of acceptance testing (feature, scenario, background). If you are in Rails, you also have a couple of generators, a rake task and full Rails integration testing (meaning Webrat support, for instance)
 email: luismi@lmcavalle.com
 executables: []
 
 extensions: []
 
-extra_rdoc_files: 
-- README.rdoc
+extra_rdoc_files: []
+
 files: 
 - init.rb
 - MIT-LICENSE
@@ -52,36 +57,44 @@ files:
 - generators/steak/templates/paths.rb
 - generators/steak/templates/steak.rake
 - generators/steak/USAGE
+- spec/acceptance/acceptance_helper.rb
+- spec/acceptance/acceptance_spec_generator_spec.rb
+- spec/acceptance/basic_spec.rb
+- spec/acceptance/rails_spec.rb
+- spec/acceptance/steak_generator_spec.rb
 has_rdoc: true
 homepage: http://github.com/cavalle/steak
 licenses: []
 
 post_install_message: 
-rdoc_options: 
-- --main
-- README.rdoc
+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.3.6
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
-summary: If you are not in Rails but use RSpec, then Steak is just some aliases providing you with the language of acceptance testing (feature, scenario, background). If you are in Rails, you also have a couple of generators, a rake task and full Rails integration testing (meaning Webrat support, for instance)
+summary: Minimalist acceptance testing on top of Rspec
 test_files: []