kookaburra 1.3.1 → 2.0.0

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kookaburra
 version: !ruby/object:Gem::Version
-  version: 1.3.1
+  version: 2.0.0
 platform: ruby
 authors:
 - John Wilger
@@ -10,188 +10,188 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-26 00:00:00.000000000 Z
+date: 2014-08-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rest-client
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '1.3'
 - !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: rspec
   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: capybara
   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: capybara-webkit
   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: reek
   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: yard
   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: kramdown
   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: sinatra
   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: uuid
   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: find_a_port
   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: json
   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'
 description: Cucumber + Capybara = Kookaburra? It made sense at the time.
@@ -201,11 +201,11 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .document
-- .gitignore
-- .rspec
-- .travis.yml
-- .yardopts
+- ".document"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- ".yardopts"
 - Gemfile
 - Gemfile.lock
 - LICENSE.txt
@@ -215,14 +215,13 @@ files:
 - lib/core_ext/object/to_param.rb
 - lib/core_ext/object/to_query.rb
 - lib/kookaburra.rb
+- lib/kookaburra/api_client.rb
 - lib/kookaburra/api_driver.rb
 - lib/kookaburra/assertion.rb
 - lib/kookaburra/configuration.rb
 - lib/kookaburra/dependency_accessor.rb
 - lib/kookaburra/exceptions.rb
-- lib/kookaburra/given_driver.rb
 - lib/kookaburra/mental_model.rb
-- lib/kookaburra/mental_model_matcher.rb
 - lib/kookaburra/rack_app_server.rb
 - lib/kookaburra/test_helpers.rb
 - lib/kookaburra/ui_driver.rb
@@ -232,9 +231,8 @@ files:
 - lib/kookaburra/ui_driver/ui_component/address_bar.rb
 - lib/kookaburra/version.rb
 - spec/integration/test_a_rack_application_spec.rb
-- spec/kookaburra/api_driver_spec.rb
+- spec/kookaburra/api_client_spec.rb
 - spec/kookaburra/configuration_spec.rb
-- spec/kookaburra/mental_model_matcher_spec.rb
 - spec/kookaburra/mental_model_spec.rb
 - spec/kookaburra/test_helpers_spec.rb
 - spec/kookaburra/ui_driver/scoped_browser_spec.rb
@@ -242,6 +240,7 @@ files:
 - spec/kookaburra/ui_driver/ui_component_spec.rb
 - spec/kookaburra/ui_driver_spec.rb
 - spec/kookaburra_spec.rb
+- spec/support/json_api_app_and_kookaburra_drivers.rb
 - spec/support/shared_examples/it_can_have_ui_components.rb
 - spec/support/shared_examples/it_can_make_assertions.rb
 - spec/support/shared_examples/it_has_a_dependency_accessor.rb
@@ -255,25 +254,24 @@ 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: []
 rubyforge_project: 
-rubygems_version: 2.0.14
+rubygems_version: 2.2.2
 signing_key: 
 specification_version: 4
 summary: Window Driver pattern for acceptance tests
 test_files:
 - spec/integration/test_a_rack_application_spec.rb
-- spec/kookaburra/api_driver_spec.rb
+- spec/kookaburra/api_client_spec.rb
 - spec/kookaburra/configuration_spec.rb
-- spec/kookaburra/mental_model_matcher_spec.rb
 - spec/kookaburra/mental_model_spec.rb
 - spec/kookaburra/test_helpers_spec.rb
 - spec/kookaburra/ui_driver/scoped_browser_spec.rb
@@ -281,6 +279,7 @@ test_files:
 - spec/kookaburra/ui_driver/ui_component_spec.rb
 - spec/kookaburra/ui_driver_spec.rb
 - spec/kookaburra_spec.rb
+- spec/support/json_api_app_and_kookaburra_drivers.rb
 - spec/support/shared_examples/it_can_have_ui_components.rb
 - spec/support/shared_examples/it_can_make_assertions.rb
 - spec/support/shared_examples/it_has_a_dependency_accessor.rb

data/lib/kookaburra/given_driver.rb

@@ -1,65 +0,0 @@
-require 'forwardable'
-
-class Kookaburra
-  # Your GivenDriver subclass is used to define your testing DSL for setting up
-  # test preconditions. Unlike {Kookaburra::APIDriver}, which is meant to be a
-  # simple mapping to your application's API, a method in the GivenDriver may be
-  # comprised of several distinct API calls as well as access to Kookaburra's
-  # test data store via {#mental_model}.
-  #
-  # @abstract Subclass and implement your Given DSL.
-  #
-  # @example GivenDriver subclass
-  #   module MyApp
-  #     module Kookaburra
-  #       class GivenDriver < ::Kookaburra::GivenDriver
-  #         def api
-  #           @api ||= APIDriver.new(configuration)
-  #         end
-  #
-  #         def a_widget(name, attributes = {})
-  #           # Set up the data that will be passed to the API by merging any
-  #           # passed attributes into the default data.
-  #           data = {:name => 'Foo', :description => 'Bar baz'}.merge(attributes)
-  #
-  #           # Call the API method and get the resulting response as Ruby data.
-  #           result = api.create_widget(data)
-  #
-  #           # Store the resulting widget data in the MentalModel object, so that
-  #           # it can be referenced in other operations.
-  #           mental_model.widgets[name] = result
-  #         end
-  #       end
-  #     end
-  #   end
-  class GivenDriver
-    extend Forwardable
-
-    # It is unlikely that you would call #initialize yourself; your GivenDriver
-    # object is instantiated for you by {Kookaburra#given}.
-    #
-    # @param [Kookaburra::Configuration] configuration
-    def initialize(configuration)
-      @configuration = configuration
-    end
-
-    protected
-
-    attr_reader :configuration
-
-    # Access to the shared {Kookaburra::MentalModel} instance
-    #
-    # @attribute [rw] mental_model
-    def_delegator :configuration, :mental_model
-
-    # Used to access your APIDriver in your own GivenDriver implementation
-    #
-    # @abstract
-    # @return [Kookaburra::APIDriver]
-    # @raise [Kookaburra::ConfigurationError] raised if you do not provide an
-    #   implementation.
-    def api
-      raise ConfigurationError, "You must implement #api in your subclass."
-    end
-  end
-end

data/lib/kookaburra/mental_model_matcher.rb

@@ -1,138 +0,0 @@
-require 'kookaburra/mental_model'
-
-class Kookaburra
-  class MentalModel
-    # This is a custom matcher that matches the RSpec matcher API.
-    #
-    # @see Kookaburra::TestHelpers#match_mental_model_of
-    # @see Kookaburra::TestHelpers#assert_mental_model_of
-    class Matcher
-      def initialize(mental_model, collection_key)
-        @collection_key = collection_key
-
-        mental_model.send(collection_key).tap do |collection|
-          @expected   = collection
-          @unexpected = collection.deleted
-        end
-      end
-
-      # Specifies that result should be limited to the given keys from the
-      # mental model.
-      #
-      # Useful if you are looking at a filtered result. That is, your mental
-      # model contains elements { A, B, C }, but you only expect to see element
-      # A.
-      #
-      # @param [Array] collection_keys The keys used in your mental model to
-      #   reference the data
-      # @return [self]
-      def only(*collection_keys)
-        keepers = @expected.slice(*collection_keys)
-        tossers = @expected.except(*collection_keys)
-
-        @expected = keepers
-        @unexpected.merge! tossers
-
-        self
-      end
-
-      # Reads better than {#only} with no args
-      #
-      # @return [self]
-      def expecting_nothing
-        only
-      end
-
-      # The result contains everything that was expected to be found and nothing
-      # that was unexpected.
-      #
-      # (Part of the RSpec protocol for custom matchers.)
-      #
-      # @param [Array] actual This is the data observed that you are attempting
-      #   to match against the mental model.
-      # @return Boolean
-      def matches?(actual)
-        @actual = actual
-        expected_items_found? && !unexpected_items_found?
-      end
-
-      # Message to be printed when observed reality does not conform to
-      # mental model.
-      #
-      # (Part of the RSpec protocol for custom matchers.)
-      #
-      # @return String
-      def failure_message_for_should
-        message = "expected #{@collection_key} to match the user's mental model, but:\n"
-        unless expected_items_found?
-          message += "expected to be present:         #{pp_array(expected_items)}\n"
-          message += "the missing elements were:      #{pp_array(expected_items_that_were_not_found)}\n"
-        end
-        if unexpected_items_found?
-          message += "expected to not be present:     #{pp_array(unexpected_items)}\n"
-          message += "the unexpected extra elements:  #{pp_array(unexpected_items_that_were_found)}\n"
-        end
-        message
-      end
-
-      # Message to be printed when observed reality does conform to mental
-      # model, but you did not expect it to.  (To be honest, we can't think of
-      # why you would want this, but it is included for the sake of RSpec
-      # compatibility.)
-      #
-      # (Part of the RSpec protocol for custom matchers.)
-      #
-      # @return String
-      def failure_message_for_should_not
-        "expected #{@collection_key} not to match the user's mental model"
-      end
-
-      # (Part of the RSpec protocol for custom matchers.)
-      #
-      # @return String
-      def description
-        "match the user's mental model of #{@collection_key}"
-      end
-
-      private
-
-      def expected_items;   @expected.values;   end
-      def unexpected_items; @unexpected.values; end
-
-      def expected_items_that_were_not_found
-        difference_between_arrays(expected_items, @actual)
-      end
-
-      def unexpected_items_that_were_found
-        unexpected_items_not_found = difference_between_arrays(unexpected_items, @actual)
-        difference_between_arrays(unexpected_items, unexpected_items_not_found)
-      end
-
-      def expected_items_found?
-        expected_items_that_were_not_found.empty?
-      end
-
-      def unexpected_items_found?
-        !unexpected_items_that_were_found.empty?
-      end
-
-      # (Swiped from RSpec's array matcher)
-      # Returns the difference of arrays, accounting for duplicates.
-      # e.g., difference_between_arrays([1, 2, 3, 3], [1, 2, 3]) # => [3]
-      def difference_between_arrays(array_1, array_2)
-        difference = array_1.dup
-        array_2.each do |element|
-          if index = difference.index(element)
-            difference.delete_at(index)
-          end
-        end
-        difference
-      end
-
-      def pp_array(array)
-        array = array.sort if array.all? { |e| e.respond_to?(:<=>) }
-        array.inspect
-      end
-    end
-  end
-end