bbq-core 0.3.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 4a48e0d7e2b08e20b007adafe0ead84e77bb54cc68bd4c8cdf7e5d68a1ae1fde
+  data.tar.gz: d8a944e766fb21bc119d771d28fcdee6e27a393e78ae4fded7bd403b420e613f
+SHA512:
+  metadata.gz: 69a88b57acf34e2ec33f347a86d82f8c45f275f2ed25852e4a313fa4196ba9f6fc2fab33758f9059b67fa7b318a18ba2efd87ef4cc88bbb7114df4a84a47f6a6
+  data.tar.gz: f90be21ff429c510175e37d08fa438734053b97260b9979bb04b53e2caf3bc8edcd17d4b2458cd4cb7e50be74ff7efcccba963e28b1553dc526c1d9afa29261c

data/.gitignore

@@ -0,0 +1,14 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+bin/*
+tmp/*
+test/dummy/db/*.sqlite3
+test/dummy/log/*.log
+test/dummy/tmp/
+test/dummy/test/acceptance/*
+test/dummy/spec/acceptance/*
+test/dope/test/acceptance/*
+test/dope/spec/acceptance/*
+nbproject/

data/.travis.yml

@@ -0,0 +1,4 @@
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - 2.1.0

data/CHANGELOG

@@ -0,0 +1,47 @@
+0.2.1 / 2013-08-22
+==================
+
+	* bugfix: Bbq::TestClient propagates NoMethodErrors from the controller of
+	tested app instead of rising unsupported method errors.
+
+0.2.0 / 2013-01-06
+==================
+
+	* Dropped support for Ruby 1.8.7
+	* Capybara 2.0 support
+
+0.1.0 / 2013-01-06
+==================
+
+  * Extracted Rails' URL helpers inclusion to separate module
+  * Include only Capybara::Session::DSL_METHODS in TestUser, not the whole Capybara::DSL
+  * Added Capybara sessions pool
+  * Moved Test::User default options to separate method
+  * Added Test::Client for testing REST APIs
+  * Renamed bbq/test.rb to bbq/test_unit.rb. You may want to fix your test_helper.
+  * Moved require bbq/test_user to generated test_user.rb. You may want to update your existing test_user.rb.
+	* Fixed Capybara 'within' scope for RSpec flavour
+
+0.0.4 / 2011-10-19
+==================
+
+  * Make Bbq work with Capybara 1.0 and 1.1
+  * Rails is development dependency
+
+0.0.3 / 2011-07-14
+==================
+
+  * Added support and tests for Sinatra
+  * Added Bbq.app and Bbq.app=
+
+0.0.2 / 2011-07-01
+==================
+
+  * Extracted Bbq::TestUser::Eyes module
+  * Added :within option to TestUser methods
+  * Fix tests for ree and ruby187
+
+0.0.1 / 2011-04-20
+==================
+
+  * Bbq introduced to the wild world!

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gemspec
+
+gem "jruby-openssl", :platforms => :jruby

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2011 DRUG, Dolnośląska Grupa Użytkowników Ruby
+
+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.md

@@ -0,0 +1,318 @@
+# BBQ
+
+[![Build Status](https://secure.travis-ci.org/drugpl/bbq-core.png)](http://travis-ci.org/drugpl/bbq-core) [![Dependency Status](https://gemnasium.com/drugpl/bbq-core.png)](https://gemnasium.com/drugpl/bbq-core) [![Code Climate](https://codeclimate.com/github/drugpl/bbq-core.png)](https://codeclimate.com/github/drugpl/bbq-core) [![Gem Version](https://badge.fury.io/rb/bbq-core.png)](http://badge.fury.io/rb/bbq-core)
+
+Object oriented acceptance testing using personas.
+
+* Ruby (no Gherkin)
+* Objects and methods instead of steps
+* Test framework independent (RSpec and Test::Unit support)
+* Thins based on Capybara.
+* DCI (Data Context Interaction) for roles/personas
+* Opinionated
+
+## Setup
+
+First, add BBQ to your apps `Gemfile`:
+
+```ruby
+gem "bbq", "0.2.1"
+```
+
+Run install generator:
+
+```
+bundle exec rails generate bbq:install
+```
+
+Require BBQ in test/test_helper.rb (in case of Test::Unit):
+
+```ruby
+require "bbq/test_unit"
+```
+
+Require BBQ in spec/spec_helper.rb (in case of RSpec):
+
+```ruby
+require "bbq/rspec"
+```
+
+## Feature generator
+
+```
+bundle exec rails g bbq:test MyFeatureName
+```
+
+## Running features
+
+For Test::Unit flavour:
+
+```
+bundle exec rake test:acceptance
+```
+
+For RSpec flavour:
+
+```
+bundle exec rake spec:acceptance
+```
+
+## Examples
+
+### Roles and Devise integration
+
+```ruby
+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
+
+  def open_application
+    visit '/'
+  end
+
+  module TicketReporter
+    def open_tickets_listing
+      open_application
+      click_link 'Tickets'
+    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
+
+    def show_ticket(summary)
+      open_tickets_listing
+      click_on summary
+    end
+  end
+
+  module TicketManager
+    def open_administration
+      visit '/admin'
+    end
+
+    def open_tickets_listing
+      open_administration
+      click_link 'Tickets'
+    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
+```
+
+```ruby
+class AdminTicketsTest < Bbq::TestCase
+  background do
+    admin = Factory(:admin)
+    @email, @password = admin.email, admin.password
+  end
+
+  scenario "admin can browse all user tickets" do
+    summaries    = ["Forgot my password", "Page is not displayed correctly"]
+    descriptions = ["I lost my yellow note with password under the table!",
+                    "My IE renders crap instead of crispy fonts!"]
+
+    alice = TestUser.new
+    alice.roles(:ticket_reporter)
+    alice.register_and_login
+    alice.open_ticket(summaries.first, descriptions.first)
+
+    bob = TestUser.new
+    bob.roles(:ticket_reporter)
+    bob.register_and_login
+    bob.open_ticket(summaries.second, descriptions.second)
+
+    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
+    charlie.see!(*summaries)
+
+    charlie.click_on(summaries.second)
+    charlie.see!(summaries.second, descriptions.second)
+    charlie.not_see!(summaries.first, descriptions.first)
+  end
+end
+```
+
+### 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
+against responses.
+
+```ruby
+class ApiTest < Bbq::TestCase
+  background do
+    headers = {'HTTP_ACCEPT' => 'application/json'}
+    @client = TestClient.new(:headers => headers)
+  end
+
+  scenario "admin can browse all user tickets" do
+    @client.get "/unicorn" do |response|
+      assert_equal 200, response.status
+      assert_equal "pink", response.body["unicorn"]["color"]
+    end
+    @client.post "/ponies", { :name => "Miracle" } do |response|
+      assert_equal 200, response.status
+    end
+  end
+end
+```
+
+## 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
+
+```ruby
+  visit '/'
+```
+
+in your integration test. Use links and buttons in order to get to other pages in your app.
+
+If you really need url helpers in your test user, just include them in your TestUser class:
+
+```ruby
+require 'bbq/rails/routes'
+
+class TestUser < Bbq::TestUser
+  include Bbq::Rails::Routes
+end
+```
+or just
+
+```ruby
+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
+```
+
+## Devise support
+
+```ruby
+require "bbq/test_user"
+require "bbq/devise"
+
+class TestUser < Bbq::TestUser
+  include Bbq::Devise
+end
+```
+
+After that TestUser have *login*, *logout*, *register*, *register_and_login* methods.
+
+```ruby
+test "user register with devise" do
+  user = TestUser.new # or TestUser.new(:email => "email@example.com", :password => "secret")
+  user.register_and_login
+  user.see!("Stuff after auth")
+end
+```
+
+## Caveats
+
+### 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.
+We have experienced some problems with Webrick that lead to `Timeout::Error` exception
+when user/browser that was inactive for some time (due to other users/browsers
+activities) was requested to execute an action.
+
+Capybara will use Thin instead of Webrick when it's available, so you only need to add Thin to you Gemfile:
+
+```ruby
+# 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
+```
+
+## 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)
+

data/Rakefile

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

data/bbq-core.gemspec

@@ -0,0 +1,28 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "bbq/core/version"
+
+Gem::Specification.new do |s|
+  s.name        = "bbq-core"
+  s.version     = Bbq::Core::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["DRUG - Dolnośląska Grupa Użytkowników Ruby"]
+  s.email       = ["bbq@drug.org.pl"]
+  s.homepage    = ""
+  s.description = %q{Objected oriented acceptance testing for Rails, using personas.}
+  s.summary     = %q{Objected oriented acceptance testing for Rails, using personas.}
+
+  s.rubyforge_project = "bbq-core"
+
+  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_dependency "capybara",      ">= 2.0"
+  s.add_dependency "activesupport", ">= 2.0"
+
+  s.add_development_dependency "rake"
+  s.add_development_dependency "rdoc",     "~> 3.7"
+  s.add_development_dependency "minitest", "~> 5.0"
+end

data/lib/bbq/core.rb

@@ -0,0 +1,7 @@
+module Bbq
+  module Core
+    class << self
+      attr_accessor :app
+    end
+  end
+end

data/lib/bbq/core/roles.rb

@@ -0,0 +1,14 @@
+require 'bbq/core/util'
+
+module Bbq
+  module Core
+    module Roles
+      def roles(*names)
+        names.each do |name|
+          module_obj = Bbq::Core::Util.find_module(name, self)
+          self.extend(module_obj)
+        end
+      end
+    end
+  end
+end

data/lib/bbq/core/session.rb

@@ -0,0 +1,64 @@
+require 'bbq/core'
+
+module Bbq
+  module Core
+    module Session
+      extend self
+
+      def next(options = {})
+        driver = options.delete(:driver)
+        pool   = options.delete(:pool)
+
+        if pool
+          pool.next(driver)
+        else
+          create(driver)
+        end
+      end
+
+      def create(driver)
+        Capybara::Session.new(driver, Bbq::Core.app)
+      end
+
+      def pool
+        @pool ||= Pool.new
+      end
+
+      class Pool
+        attr_accessor :idle, :taken
+
+        def initialize
+          @idle   = []
+          @taken  = []
+        end
+
+        def next(driver)
+          take_idle(driver) || create(driver)
+        end
+
+        def release
+          taken.each(&:reset!)
+          idle.concat(taken)
+          taken.clear
+        end
+
+        private
+
+        def take_idle(driver)
+          idle.find { |s| s.mode == driver }.tap do |session|
+            if session
+              idle.delete(session)
+              taken.push(session)
+            end
+          end
+        end
+
+        def create(driver)
+          Bbq::Core::Session.create(driver).tap do |session|
+            taken.push(session)
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bbq/core/test_client.rb

@@ -0,0 +1,97 @@
+require 'bbq/core/roles'
+
+module Bbq
+  module Core
+    class TestClient
+      class UnsupportedMethodError < StandardError; end
+
+      include Bbq::Core::Roles
+
+      def initialize(options = {})
+        @options = options
+      end
+
+      HTTP_METHODS = %w(get post put delete head options patch)
+
+      HTTP_METHODS.each do |method|
+        class_eval <<-RUBY
+          def #{method}(path, params = {}, headers = {})
+            unless driver.respond_to? :#{method}
+              raise UnsupportedMethodError, "Your driver does not support #{method.upcase} method"
+            end
+
+            response = driver.#{method}(path, params, default_headers.merge(headers))
+            parsed_response = parse_response(response)
+            yield parsed_response if block_given?
+            parsed_response
+          end
+        RUBY
+      end
+
+      protected
+      def app
+        @options[:app] || Bbq::Core.app
+      end
+
+      def default_headers
+        @options[:headers] || {}
+      end
+
+      def driver
+        @driver ||= RackTest.new(app)
+      end
+
+      def parse_response(response)
+        case response.headers["Content-Type"]
+        when /^application\/(.*\+)?json/
+          response.extend(JsonBody)
+        when /^application\/(.*\+)?x-yaml/
+          response.extend(YamlBody)
+        else
+          response
+        end
+      end
+
+      class RackTest
+        attr_accessor :app
+
+        def initialize(app)
+          self.app = app
+        end
+
+        module ConvertHeaders
+          HTTP_METHODS.each do |method|
+            class_eval <<-RUBY
+              def #{method}(path, params = {}, headers = {})
+                super(path, params, to_env_headers(headers))
+              end
+            RUBY
+          end
+
+          def to_env_headers(http_headers)
+            http_headers.map do |k, v|
+              k = k.upcase.gsub("-", "_")
+              k = "HTTP_#{k}" unless ["CONTENT_TYPE", "CONTENT_LENGTH"].include?(k)
+              { k => v }
+            end.inject({}, :merge)
+          end
+        end
+
+        include Rack::Test::Methods
+        include ConvertHeaders
+      end
+
+      module JsonBody
+        def body
+          @parsed_body ||= super.empty?? super : JSON.parse(super)
+        end
+      end
+
+      module YamlBody
+        def body
+          @parsed_body ||= YAML.load(super)
+        end
+      end
+    end
+  end
+end

data/lib/bbq/core/test_user.rb

@@ -0,0 +1,33 @@
+require 'bbq/core/session'
+require 'bbq/core/roles'
+require 'bbq/core/test_user/capybara_dsl'
+require 'bbq/core/test_user/eyes'
+require 'bbq/core/test_user/within'
+
+module Bbq
+  module Core
+    class TestUser
+      include Bbq::Core::TestUser::CapybaraDsl
+      include Bbq::Core::TestUser::Eyes
+      include Bbq::Core::TestUser::Within
+      include Bbq::Core::Roles
+
+      attr_reader :options
+
+      def initialize(options = {})
+        @options = default_options.merge(options)
+      end
+
+      def default_options
+        {
+          :pool   => Bbq::Core::Session.pool,
+          :driver => ::Capybara.default_driver
+        }
+      end
+
+      def page
+        @page ||= options[:session] || Bbq::Core::Session.next(:driver => options[:driver], :pool => options[:pool])
+      end
+    end
+  end
+end

data/lib/bbq/core/test_user/capybara_dsl.rb

@@ -0,0 +1,17 @@
+require 'capybara/dsl'
+
+module Bbq
+  module Core
+    class TestUser
+      module CapybaraDsl
+        ::Capybara::Session::DSL_METHODS.each do |method|
+          class_eval <<-RUBY, __FILE__, __LINE__+1
+            def #{method}(*args, &block)
+              page.#{method}(*args, &block)
+            end
+          RUBY
+        end
+      end
+    end
+  end
+end

data/lib/bbq/core/test_user/eyes.rb

@@ -0,0 +1,15 @@
+module Bbq
+  module Core
+    class TestUser
+      module Eyes
+        def see?(*args)
+          args.all? { |arg| has_content?(arg) }
+        end
+
+        def not_see?(*args)
+          args.all? { |arg| has_no_content?(arg) }
+        end
+      end
+    end
+  end
+end

data/lib/bbq/core/test_user/within.rb

@@ -0,0 +1,35 @@
+require 'active_support/core_ext/array/extract_options'
+
+module Bbq
+  module Core
+    class TestUser
+      module Within
+        METHODS_USING_WITHIN = [
+          :see?, :not_see?,
+          :attach_file, :check, :choose, :click_link_or_button, :click_button,
+          :click_link, :click_on, :fill_in, :select, :uncheck, :unselect
+        ]
+
+        METHODS_USING_WITHIN.each do |method_name|
+          class_eval <<-RUBY
+            def #{method_name}(*args)
+              using_within(args) { super }
+            end
+          RUBY
+        end
+
+        def using_within(args)
+          options = args.extract_options!
+          locator = options.delete(:within)
+          args.push(options) unless options.empty?
+
+          if locator
+            within(locator) { yield }
+          else
+            yield
+          end
+        end
+      end
+    end
+  end
+end

data/lib/bbq/core/util.rb

@@ -0,0 +1,21 @@
+require 'active_support/core_ext/string/inflections'
+
+module Bbq
+  module Core
+    class Util
+      def self.find_module(name, scope = nil)
+        namespace = case scope
+        when String, Symbol
+          "::#{scope.to_s.camelize}"
+        when Class
+          "::#{scope.name}"
+        when NilClass
+          nil
+        else
+          "::#{scope.class.name}"
+        end
+        "#{namespace}::#{name.to_s.camelize}".constantize
+      end
+    end
+  end
+end

data/lib/bbq/core/version.rb

@@ -0,0 +1,5 @@
+module Bbq
+  module Core
+    VERSION = '0.3.0'
+  end
+end

data/lib/tasks/bbq.rake

@@ -0,0 +1,15 @@
+require 'rake/testtask'
+
+Rake::TestTask.new("test:acceptance") do |t|
+  t.libs << 'test'
+  t.pattern = 'test/acceptance/**/*_test.rb'
+  t.verbose = false
+end if File.exists?('test/acceptance')
+
+begin
+  require 'rspec/core/rake_task'
+  RSpec::Core::RakeTask.new('spec:acceptance') do |spec|
+    spec.pattern = FileList['spec/acceptance/**/*_spec.rb']
+  end if File.exists?('spec/acceptance')
+rescue LoadError
+end

data/test/session_pool_test.rb

@@ -0,0 +1,44 @@
+require 'test_helper'
+require 'bbq/core/test_user'
+
+class SessionPoolTest < Minitest::Test
+
+  def setup
+    Bbq::Core::Session.instance_variable_set(:@pool, nil)
+  end
+
+  def test_reuses_sessions
+    pool  = Bbq::Core::Session::Pool.new
+    user1 = Bbq::Core::TestUser.new(:pool => pool).tap { |u| u.page }
+    pool.release
+    user2 = Bbq::Core::TestUser.new(:pool => pool).tap { |u| u.page }
+
+    assert_same user1.page, user2.page
+  end
+
+  def test_has_default_pool
+    user1 = Bbq::Core::TestUser.new.tap { |u| u.page }
+    Bbq::Core::Session::pool.release
+    user2 = Bbq::Core::TestUser.new.tap { |u| u.page }
+
+    assert_same user1.page, user2.page
+  end
+
+  def test_without_pool
+    user1 = Bbq::Core::TestUser.new(:pool => false).tap { |u| u.page }
+    Bbq::Core::Session::pool.release
+    user2 = Bbq::Core::TestUser.new(:pool => false).tap { |u| u.page }
+
+    refute_same user1.page, user2.page
+  end
+
+  def test_pool_returns_correct_driver
+    pool = Bbq::Core::Session::Pool.new
+    pool.next(:rack_test)
+    pool.next(:rack_test_the_other)
+    pool.release
+
+    assert_equal :rack_test, pool.next(:rack_test).mode
+  end
+
+end

data/test/test_client_test.rb

@@ -0,0 +1,30 @@
+require 'test_helper'
+require 'bbq/core/test_client'
+
+class TestClientTest < Minitest::Test
+
+  def test_rack_test_to_env_headers_for_empty_hash
+    test_client = Bbq::Core::TestClient::RackTest.new(:app)
+    assert_equal({}, test_client.to_env_headers({}))
+  end
+
+  def test_rack_test_to_env_headers_for_content_type_or_content_length
+    test_client = Bbq::Core::TestClient::RackTest.new(:app)
+    result = test_client.to_env_headers({
+      "content-type"   => "text/plain",
+      "content-length" => "40"
+    })
+    assert_includes(result.keys, "CONTENT_TYPE")
+    assert_includes(result.keys, "CONTENT_LENGTH")
+  end
+
+  def test_rack_test_to_env_headers_for_other_headers
+    test_client = Bbq::Core::TestClient::RackTest.new(:app)
+    result = test_client.to_env_headers({
+      "silly-header" => "silly-value"
+    })
+    assert_includes(result.keys, "HTTP_SILLY_HEADER")
+  end
+
+end
+

data/test/test_helper.rb

@@ -0,0 +1,8 @@
+require 'minitest/autorun'
+require 'capybara'
+
+Capybara.register_driver :rack_test_the_other do |app|
+  Capybara::RackTest::Driver.new(app)
+end
+
+

data/test/test_user_test.rb

@@ -0,0 +1,112 @@
+require 'test_helper'
+require 'bbq/core/test_user'
+
+
+def text(output)
+end
+
+def html(output)
+  ->{ ['200', {'Content-Type' => 'text/html'}, [output]] }
+end
+
+TestApp = Rack::Builder.new do
+  map '/' do
+    run ->(env) { ['200', {'Content-Type' => 'text/plain'}, ['BBQ']] }
+  end
+
+  map '/miracle' do
+    run ->(env) { ['200', {'Content-Type' => 'text/plain'}, ['MIRACLE']] }
+  end
+
+  map '/ponycorns' do
+    run ->(env) { ['200', {'Content-Type' => 'text/html'}, [<<HTML
+<ul id="unicorns">
+  <li>Pink</li>
+</ul>
+<ul id="ponies">
+  <li>Violet</li>
+</ul>
+<div id="new_pony">
+  <input type="text" name="color" value="" />
+</div>
+<a href="#">More ponycorns</a>
+HTML
+    ]] }
+  end
+end
+
+
+class TestUser < Bbq::Core::TestUser
+  module Commenter
+    def comment
+    end
+  end
+
+  module VideoUploader
+    def upload
+    end
+  end
+
+  module CommentModerator
+    def moderate
+    end
+  end
+end
+
+class TestUserTest < Minitest::Test
+
+  def setup
+    Bbq::Core.app = TestApp
+  end
+
+  def teardown
+    Bbq::Core.app = nil
+  end
+
+  def test_capybara_dsl_methods
+    user = TestUser.new
+    Capybara::Session::DSL_METHODS.each do |m|
+      assert user.respond_to?(m)
+    end
+  end
+
+  def test_driver_option
+    user = TestUser.new(:driver => :rack_test_the_other)
+    assert_equal :rack_test_the_other, user.page.mode
+  end
+
+  def test_roles
+    user = TestUser.new
+    %w(comment upload moderate).each { |m| assert !user.respond_to?(m) }
+
+    user.roles(:commenter, "comment_moderator")
+    %w(comment moderate).each { |m| assert user.respond_to?(m) }
+    assert !user.respond_to?(:upload)
+
+    user.roles(:video_uploader)
+    %w(comment upload moderate).each { |m| assert user.respond_to?(m) }
+  end
+
+  def test_explicit_user_eyes
+    @user = TestUser.new
+    @user.visit "/miracle"
+    assert @user.not_see?("BBQ")
+    assert @user.see?("MIRACLE")
+  end
+
+  def test_user_eyes_within_scope
+    @user = TestUser.new
+    @user.visit "/ponycorns"
+    assert @user.see?("Pink", :within => "#unicorns")
+    assert ! @user.see?("Violet", :within => "#unicorns")
+    assert @user.not_see?("Violet", :within => "#unicorns")
+    assert ! @user.not_see?("Pink", :within => "#unicorns")
+
+    @user.fill_in "color", :with => "red", :within => "#new_pony"
+    assert_raises Capybara::ElementNotFound do
+      @user.fill_in "color", :with => "red", :within => "#new_unicorn"
+    end
+    @user.click_link "More ponycorns"
+  end
+
+end

data/test/util_test.rb

@@ -0,0 +1,36 @@
+require 'test_helper'
+require 'bbq/core/util'
+
+class User
+  module Commenter
+  end
+end
+
+module Commenter
+end
+
+class UtilTest < Minitest::Test
+
+  def test_find_module_in_object_namespace
+    assert_commenter(User.new, User::Commenter)
+  end
+
+  def test_find_module_in_class_namespace
+    assert_commenter(User, User::Commenter)
+  end
+
+  def test_find_module_in_string_namespace
+    assert_commenter("User", User::Commenter)
+  end
+
+  def test_find_global_module
+    assert_commenter(nil, ::Commenter)
+  end
+
+  def assert_commenter(namespace, result)
+    [:commenter, "commenter"].each do |name|
+      assert_equal Bbq::Core::Util.find_module(name, namespace), result
+    end
+  end
+
+end

metadata

@@ -0,0 +1,141 @@
+--- !ruby/object:Gem::Specification
+name: bbq-core
+version: !ruby/object:Gem::Version
+  version: 0.3.0
+platform: ruby
+authors:
+- DRUG - Dolnośląska Grupa Użytkowników Ruby
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2020-03-09 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: capybara
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: activesupport
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.7'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Objected oriented acceptance testing for Rails, using personas.
+email:
+- bbq@drug.org.pl
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".travis.yml"
+- CHANGELOG
+- Gemfile
+- MIT-LICENSE
+- README.md
+- Rakefile
+- bbq-core.gemspec
+- lib/bbq/core.rb
+- lib/bbq/core/roles.rb
+- lib/bbq/core/session.rb
+- lib/bbq/core/test_client.rb
+- lib/bbq/core/test_user.rb
+- lib/bbq/core/test_user/capybara_dsl.rb
+- lib/bbq/core/test_user/eyes.rb
+- lib/bbq/core/test_user/within.rb
+- lib/bbq/core/util.rb
+- lib/bbq/core/version.rb
+- lib/tasks/bbq.rake
+- test/session_pool_test.rb
+- test/test_client_test.rb
+- test/test_helper.rb
+- test/test_user_test.rb
+- test/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'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.0.3
+signing_key: 
+specification_version: 4
+summary: Objected oriented acceptance testing for Rails, using personas.
+test_files:
+- test/session_pool_test.rb
+- test/test_client_test.rb
+- test/test_helper.rb
+- test/test_user_test.rb
+- test/util_test.rb