bbq 0.1.0 → 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: f512a9b51c233f36e2200fcd837bbe0a543de1f0
+  data.tar.gz: b7eddf0a7415cc1a7658f5352180be479f81c60a
+SHA512:
+  metadata.gz: 8762aceda8bc14c5d3fc843c3b396195f1f1eaac889d8a4ca54221f192fb78c939fe8ba1f0bbde301ceb29ada7c9f814fb96f4e2b215fb9a7635873c2ea6e678
+  data.tar.gz: b4b6afca79551d918f5fca92909e0ac054f544450c57d781ecc6716345baf0fd6d8042af0b2c624047e5bc4acf9b776d866d176d3af75a95a5aa3a306936c603

data/.travis.yml

@@ -1,7 +1,8 @@
-script: bundle exec rake test
 rvm:
   - 1.9.3
   - 1.9.2
-  - 1.8.7
-  - ree
+  - 2.0.0
   - rbx-19mode
+
+matrix:
+  allow_failures:

data/CHANGELOG

@@ -1,3 +1,9 @@
+0.2.0
+==================
+
+	* Dropped support for Ruby 1.8.7
+	* Capybara 2.0 support
+
 0.1.0 / 2013-01-06
 ==================
 
@@ -13,8 +19,8 @@
 0.0.4 / 2011-10-19
 ==================
 
-  * Make bbq work with capybara 1.0 and 1.1
-  * rails is development dependency
+  * Make Bbq work with Capybara 1.0 and 1.1
+  * Rails is development dependency
 
 0.0.3 / 2011-07-14
 ==================
@@ -32,4 +38,4 @@
 0.0.1 / 2011-04-20
 ==================
 
-  * BBQ introduced to the wild world!
+  * Bbq introduced to the wild world!

data/README.md

@@ -1,54 +1,28 @@
-Warning & disclaimer
-====================
+# BBQ
 
-This gem is currently under development. We're targeting most popular use cases - Rails & Rack applications (ex. Sinatra). However the philosophy behind it is not limited to Rails nor web applications in general. There is even example usage with EventMachine. Feel free to modify it for your own needs.
-
-[![Build Status](https://secure.travis-ci.org/drugpl/bbq.png)](http://travis-ci.org/drugpl/bbq) [![Dependency Status](https://gemnasium.com/drugpl/bbq.png)](https://gemnasium.com/drugpl/bbq)
-
-BBQ
-===
+[![Build Status](https://secure.travis-ci.org/drugpl/bbq.png)](http://travis-ci.org/drugpl/bbq) [![Dependency Status](https://gemnasium.com/drugpl/bbq.png)](https://gemnasium.com/drugpl/bbq) [![Code Climate](https://codeclimate.com/github/drugpl/bbq.png)](https://codeclimate.com/github/drugpl/bbq) [![Gem Version](https://badge.fury.io/rb/bbq.png)](http://badge.fury.io/rb/bbq) 
 
 Object oriented acceptance testing using personas.
 
-* Ruby
-* OOP
-* DCI (Data Context Interaction) - for roles/personas
-* Test framework independent, based on Capybara
-* Opinionated
-
-Difference from Cucumber
-========================
-
-* No Gherkin
+* Ruby (no Gherkin)
 * Objects and methods instead of steps
-* Easier code reuse
-* No factories/fixtures
-
-Example applications
-====================
-
-* https://github.com/pawelpacana/roundtrip
-
-Related examples
-================
-
-* https://github.com/pawelpacana/eventmachine-bbq-example
-* https://github.com/drugpl/drug-site
+* Test framework independent (RSpec and Test::Unit support)
+* Thins based on Capybara.
+* DCI (Data Context Interaction) for roles/personas
+* Opinionated
 
-Installation
-============
+## Setup
 
-First, add BBQ to your apps Gemfile:
+First, add BBQ to your apps `Gemfile`:
 
 ```ruby
-# Gemfile
-gem "bbq", :git => "git://github.com/drugpl/bbq"
+gem "bbq", "0.2.0"
 ```
 
 Run install generator:
 
 ```
-rails generate bbq:install
+bundle exec rails generate bbq:install
 ```
 
 Require BBQ in test/test_helper.rb (in case of Test::Unit):
@@ -63,87 +37,84 @@ Require BBQ in spec/spec_helper.rb (in case of RSpec):
 require "bbq/rspec"
 ```
 
-Feature generator
-=================
+## Feature generator
 
 ```
-rails g bbq:test MyFeatureName
+bundle exec rails g bbq:test MyFeatureName
 ```
 
-Running features
-================
+## Running features
 
 For Test::Unit flavour:
 
 ```
-rake test:acceptance
+bundle exec rake test:acceptance
 ```
 
 For RSpec flavour:
 
 ```
-spec:acceptance
+bundle exec rake spec:acceptance
 ```
 
-Examples
-========
+## Examples
+
+### Roles and Devise integration
 
 ```ruby
-module Roundtrip
-  class TestUser < Bbq::TestUser
-    include Bbq::Devise
-
-    def update_ticket(summary, comment)
-      show_ticket(summary)
-      fill_in  "Comment", :with => comment
-      click_on "Add update"
-    end
+class TestUser < Bbq::TestUser
+  include Bbq::Devise
 
-    def open_application
-      visit '/'
-    end
+  def update_ticket(summary, comment)
+    show_ticket(summary)
+    fill_in  "Comment", :with => comment
+    click_on "Add update"
+  end
 
-    module TicketReporter
-      def open_tickets_listing
-        open_application
-        click_link 'Tickets'
-      end
+  def open_application
+    visit '/'
+  end
 
-      def open_ticket(summary, description)
-        open_tickets_listing
-        click_on "Open a new ticket"
-        fill_in  "Summary", :with => summary
-        fill_in  "Description", :with => description
-        click_on "Open ticket"
-      end
+  module TicketReporter
+    def open_tickets_listing
+      open_application
+      click_link 'Tickets'
+    end
 
-      def show_ticket(summary)
-        open_tickets_listing
-        click_on summary
-      end
+    def open_ticket(summary, description)
+      open_tickets_listing
+      click_on "Open a new ticket"
+      fill_in  "Summary", :with => summary
+      fill_in  "Description", :with => description
+      click_on "Open ticket"
     end
 
-    module TicketManager
-      def open_administration
-        visit '/admin'
-      end
+    def show_ticket(summary)
+      open_tickets_listing
+      click_on summary
+    end
+  end
 
-      def open_tickets_listing
-        open_administration
-        click_link 'Tickets'
-      end
+  module TicketManager
+    def open_administration
+      visit '/admin'
+    end
 
-      def close_ticket(summary, comment = nil)
-        open_tickets_listing
-        click_on summary
-        fill_in  "Comment", :with => comment if comment
-        click_on "Close ticket"
-      end
+    def open_tickets_listing
+      open_administration
+      click_link 'Tickets'
+    end
 
-      def show_ticket(summary)
-        open_tickets_listing
-        click_on summary
-      end
+    def close_ticket(summary, comment = nil)
+      open_tickets_listing
+      click_on summary
+      fill_in  "Comment", :with => comment if comment
+      click_on "Close ticket"
+    end
+
+    def show_ticket(summary)
+      open_tickets_listing
+      click_on summary
     end
   end
 end
@@ -161,17 +132,17 @@ class AdminTicketsTest < Bbq::TestCase
     descriptions = ["I lost my yellow note with password under the table!",
                     "My IE renders crap instead of crispy fonts!"]
 
-    alice = Roundtrip::TestUser.new
+    alice = TestUser.new
     alice.roles(:ticket_reporter)
     alice.register_and_login
     alice.open_ticket(summaries.first, descriptions.first)
 
-    bob = Roundtrip::TestUser.new
+    bob = TestUser.new
     bob.roles(:ticket_reporter)
     bob.register_and_login
     bob.open_ticket(summaries.second, descriptions.second)
 
-    charlie = Roundtrip::TestUser.new(:email => @email, :password => @password)
+    charlie = TestUser.new(:email => @email, :password => @password)
     charlie.login # charlie was already "registered" in factory as admin
     charlie.roles(:ticket_manager)
     charlie.open_tickets_listing
@@ -184,8 +155,67 @@ class AdminTicketsTest < Bbq::TestCase
 end
 ```
 
-Testing REST APIs
-================
+### RSpec integration
+
+```ruby
+class TestUser < Bbq::TestUser
+  def email
+    @options[:email] || "buyer@example.com"
+  end
+
+  module Buyer
+    def ask_question(question)
+      fill_in "question", :with => question
+      fill_in "email", :with => email
+      click_on("Ask")
+    end
+
+    def go_to_page_and_open_widget(page_url, &block)
+      go_to_page(page_url)
+      open_widget &block
+    end
+
+    def go_to_page(page_url)
+      visit page_url
+      wait_until { page.find("iframe") }
+    end
+
+    def open_widget
+      within_widget do
+        page.find("#widget h3").click
+        yield if block_given?
+      end
+    end
+
+    ef within_widget(&block)
+      within_frame(widget_frame, &block)
+    end
+
+    def widget_frame
+      page.evaluate_script("document.getElementsByTagName('iframe')[0].id")
+    end
+  end
+end
+```
+
+```ruby
+feature "ask question widget" do
+  let(:user) {
+    user = TestUser.new(:driver => :webkit)
+    user.roles('buyer')
+    user
+  }
+
+  scenario "as a guest user, I should be able to ask a question" do
+    user.go_to_page_and_open_widget("/widget") do
+      user.ask_question "my question"
+      user.see!("Thanks!")
+    end
+  end
+end
+```
+
+## Testing REST APIs
 
 Bbq provides `Bbq::TestClient`, similar to `Bbq::TestUser`, but intended for testing APIs.
 It's a thin wrapper around `Rack::Test` which allows you to send requests and run assertions
@@ -210,8 +240,7 @@ class ApiTest < Bbq::TestCase
 end
 ```
 
-Rails' URL Helpers
-================
+## Rails URL Helpers
 
 Using url helpers from Rails in integration tests is not recommended.
 Testing routes is part of integration test, so you should actually use only
@@ -227,26 +256,21 @@ If you really need url helpers in your test user, just include them in your Test
 ```ruby
 require 'bbq/rails/routes'
 
-module Roundtrip
-  class TestUser < Bbq::TestUser
-    include Bbq::Rails::Routes
-  end
+class TestUser < Bbq::TestUser
+  include Bbq::Rails::Routes
 end
 ```
 or just
 
 ```ruby
-module Roundtrip
-  class TestUser < Bbq::TestUser
-    include ::ActionDispatch::Routing::UrlFor
-    include ::Rails.application.routes.url_helpers
-    include ::ActionDispatch::Routing::RouteSet::MountedHelpers unless ::Rails.version < "3.1"
-  end
+class TestUser < Bbq::TestUser
+  include ::ActionDispatch::Routing::UrlFor
+  include ::Rails.application.routes.url_helpers
+  include ::ActionDispatch::Routing::RouteSet::MountedHelpers unless ::Rails.version < "3.1"
 end
 ```
 
-Deal with Devise
-================
+## Devise support
 
 ```ruby
 require "bbq/test_user"
@@ -267,10 +291,9 @@ test "user register with devise" do
 end
 ```
 
-Caveats
-=======
+## Caveats
 
-<h2>Timeout::Error</h2>
+### Timeout::Error
 
 If you simulate multiple users in your tests and spawn multiple browsers with selenium it might
 be a good idea to use Thin instead of Webrick to create application server.
@@ -284,45 +307,12 @@ Capybara will use Thin instead of Webrick when it's available, so you only need
 # In test group if you want it to
 # be used only in tests and not in your development mode
 # ex. when running 'rails s'
-gem 'thin', :require => false
-```
-
-Development environment
-=======================
 
+gem 'thin', :require => false
 ```
-bundle install
-bundle exec rake test
-```
-
-Additional information
-======================
-
-* 2 problems with Cucumber http://andrzejonsoftware.blogspot.com/2011/03/2-problems-with-cucumber.html
-* Object oriented acceptance testing http://andrzejonsoftware.blogspot.com/2011/04/object-oriented-acceptance-testing.html
-* Events in acceptance tests http://andrzejonsoftware.blogspot.com/2011/04/events-in-acceptance-tests.html
-
-Maintainers
-===========
-
-* Paweł Pacana (http://github.com/pawelpacana)
-* Andrzej Krzywda (http://andrzejkrzywda.com)
-* Michał Łomnicki (http://mlomnicki.com)
-* Robert Pankowecki (http://robert.pankowecki.pl)
-
-Contributors
-============
-
-* Piotr Niełacny (http://ruby-blog.pl)
-* Peter Suschlik (http://peter.suschlik.de)
-* Jan Dudek (http://jandudek.com)
-
-Future plans
-============
 
-* Events (http://andrzejonsoftware.blogspot.com/2011/04/events-in-acceptance-tests.html)
+## Additional information
 
-License
-=======
+* [2 problems with Cucumber](http://andrzejonsoftware.blogspot.com/2011/03/2-problems-with-cucumber.html)
+* [Object oriented acceptance testing](http://andrzejonsoftware.blogspot.com/2011/04/object-oriented-acceptance-testing.html)
 
-MIT License

data/bbq.gemspec

@@ -19,14 +19,14 @@ Gem::Specification.new do |s|
   s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
   s.require_paths = ["lib"]
 
-  s.add_dependency "capybara",  "~> 1.0"
+  s.add_dependency "capybara",  "~> 2.0"
   s.add_dependency "activesupport",  ">= 2.0"
 
+  s.add_development_dependency "rake"
   s.add_development_dependency "sqlite3",     "~> 1.3.3"
-  s.add_development_dependency "rake",        "~> 0.8.7"
   s.add_development_dependency "rdoc",        "~> 3.7"
-  s.add_development_dependency "devise",      "~> 1.4.0"
-  s.add_development_dependency "sinatra",     "~> 1.2.6"
-  s.add_development_dependency "rspec-rails", "~> 2.6.0"
+  s.add_development_dependency "devise",      ">= 1.4.0"
+  s.add_development_dependency "sinatra",     ">= 1.2.6"
+  s.add_development_dependency "rspec-rails", "~> 2.6"
   s.add_development_dependency "rails",       ">= 3.0.0"
 end

data/lib/bbq/version.rb

@@ -1,3 +1,3 @@
 module Bbq
-  VERSION = "0.1.0"
+  VERSION = "0.2.0"
 end

data/test/dummy/config/initializers/devise.rb

@@ -80,7 +80,7 @@ Devise.setup do |config|
 
   # If true, uses the password salt as remember token. This should be turned
   # to false if you are not using database authenticatable.
-  config.use_salt_as_remember_token = true
+  # config.use_salt_as_remember_token = true
 
   # Options to be passed to the created cookie. For instance, you can set
   # :secure => true in order to force SSL only cookies.

data/test/support/driver_factory.rb

@@ -41,6 +41,9 @@ class DriverFactory
       @clean
     end
 
+    def needs_server?
+      false
+    end
   end
 
 end

data/test/unit/bbq_test_unit_test.rb

@@ -14,8 +14,6 @@ class BbqTestUnitTest < Test::Unit::TestCase
       require 'bbq/test_user'
 
       class DopeAppRootTest < Bbq::TestCase
-        FAILED_ASSERTION = RUBY_VERSION < "1.9" ? Test::Unit::AssertionFailedError : MiniTest::Assertion
-
         background do
           Bbq.app = ::Dope::App
         end
@@ -26,8 +24,8 @@ class BbqTestUnitTest < Test::Unit::TestCase
           user.see!("BBQ supports sinatra")
           assert user.see?("BBQ supports sinatra")
 
-          assert_raises(FAILED_ASSERTION) { user.see!("blah") }
-          assert_raises(FAILED_ASSERTION) { user.not_see!("BBQ supports sinatra") }
+          assert_raises(MiniTest::Assertion) { user.see!("blah") }
+          assert_raises(MiniTest::Assertion) { user.not_see!("BBQ supports sinatra") }
         end
       end
     TESTCASE
@@ -68,8 +66,6 @@ class BbqTestUnitTest < Test::Unit::TestCase
       require 'bbq/test_unit'
       require 'bbq/test_user'
 
-      FAILED_ASSERTION = RUBY_VERSION < "1.9" ? Test::Unit::AssertionFailedError : MiniTest::Assertion
-
       class ImplicitUserEyesTest < Bbq::TestCase
         scenario 'should see welcome text' do
           user = Bbq::TestUser.new
@@ -77,8 +73,8 @@ class BbqTestUnitTest < Test::Unit::TestCase
           user.see!("MIRACLE")
           user.not_see!("BBQ")
 
-          assert_raises(FAILED_ASSERTION) { user.see!("BBQ") }
-          assert_raises(FAILED_ASSERTION) { user.not_see!("MIRACLE") }
+          assert_raises(MiniTest::Assertion) { user.see!("BBQ") }
+          assert_raises(MiniTest::Assertion) { user.not_see!("MIRACLE") }
         end
       end
     TESTUNIT

metadata

@@ -1,160 +1,141 @@
 --- !ruby/object:Gem::Specification
 name: bbq
 version: !ruby/object:Gem::Version
-  prerelease: 
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - DRUG - Dolnośląska Grupa Użytkowników Ruby
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-01-05 00:00:00.000000000 Z
+date: 2013-03-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: '1.0'
-    none: false
-  prerelease: false
   name: capybara
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '1.0'
-    none: false
+        version: '2.0'
   type: :runtime
-- !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
         version: '2.0'
-    none: false
-  prerelease: false
+- !ruby/object:Gem::Dependency
   name: activesupport
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: '2.0'
-    none: false
   type: :runtime
-- !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 1.3.3
-    none: false
-  prerelease: false
-  name: sqlite3
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 1.3.3
-    none: false
+        version: '0'
   type: :development
-- !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 0.8.7
-    none: false
-  prerelease: false
-  name: rake
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.8.7
-    none: false
+        version: 1.3.3
   type: :development
-- !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: '3.7'
-    none: false
-  prerelease: false
+        version: 1.3.3
+- !ruby/object:Gem::Dependency
   name: rdoc
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: '3.7'
-    none: false
   type: :development
-- !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 1.4.0
-    none: false
-  prerelease: false
+        version: '3.7'
+- !ruby/object:Gem::Dependency
   name: devise
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.4.0
-    none: false
   type: :development
-- !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 1.2.6
-    none: false
-  prerelease: false
+        version: 1.4.0
+- !ruby/object:Gem::Dependency
   name: sinatra
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
         version: 1.2.6
-    none: false
   type: :development
-- !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - '>='
       - !ruby/object:Gem::Version
-        version: 2.6.0
-    none: false
-  prerelease: false
+        version: 1.2.6
+- !ruby/object:Gem::Dependency
   name: rspec-rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 2.6.0
-    none: false
+        version: '2.6'
   type: :development
-- !ruby/object:Gem::Dependency
+  prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ~>
       - !ruby/object:Gem::Version
-        version: 3.0.0
-    none: false
-  prerelease: false
+        version: '2.6'
+- !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - '>='
       - !ruby/object:Gem::Version
         version: 3.0.0
-    none: false
   type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: 3.0.0
 description: Objected oriented acceptance testing for Rails, using personas.
 email:
 - bbq@drug.org.pl
@@ -245,33 +226,26 @@ files:
 - test/unit/bbq_util_test.rb
 homepage: ''
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -3767528183073540906
-  none: false
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - '>='
     - !ruby/object:Gem::Version
       version: '0'
-      segments:
-      - 0
-      hash: -3767528183073540906
-  none: false
 requirements: []
 rubyforge_project: bbq
-rubygems_version: 1.8.24
+rubygems_version: 2.0.0
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Objected oriented acceptance testing for Rails, using personas.
 test_files:
 - test/dope/app.rb