domino 0.1.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2011 [name of plugin creator]
+
+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,61 @@
+# Domino
+
+View abstraction for integration testing
+
+## Usage
+
+To create a basic Domino class, inherit from Domino and
+define a selector and attributes:
+
+    module Dom
+      class Post < Domino
+        selector '#posts .post'
+        attribute :title # selector defaults to .title
+        attribute :body, '.post-body' # example of selector override
+      end
+    end
+
+Now in your integration test you can use some of Domino's methods:
+
+    assert_equal 4, Dom::Post.count
+    refute_nil Dom::Post.find_by_title('First Post')
+
+What makes it really powerful is defining scoped actions:
+
+    module Dom
+      class Post < Domino
+        def delete
+          within(id) { click_button 'Delete' }
+        end
+      end
+    end
+
+    refute_nil Dom::Post.find_by_title('First Post')
+    Dom::Post.find_by_title('First Post').delete
+    assert_nil Dom::Post.find_by_title('First Post')
+
+## Integration with Cucumber
+
+Add a features/support/dominos.rb file, in which you define your dominos.
+
+Use them in your steps.
+
+## Integration with Test::Unit
+
+Include "domino" in your Gemfile if using bundler, or simply
+
+    require 'domino'
+
+If you're not using Bundler.
+
+Now, define your Dominos anywhere you want. The easiest place to start is
+in your test\_helper.rb (doesn't have to be inside a Rails test class).
+
+## Example
+
+Check out [Domino Example](http://github.com/ngauthier/domino_example) for an 
+example of using Test::Unit and Cucumber with Domino.
+
+## Copyright
+
+Copyright (c) 2011 Nick Gauthier, released under the MIT license

data/lib/domino.rb

@@ -0,0 +1,144 @@
+require 'capybara/dsl'
+require 'nokogiri'
+# To create a basic Domino class, inherit from Domino and
+# define a selector and attributes:
+#
+#     module Dom
+#       class Post < Domino
+#         selector '#posts .post'
+#         attribute :title # selector defaults to .title
+#         attribute :body, '.post-body' # example of selector override
+#       end
+#     end
+#
+# Now in your integration test you can use some of Domino's methods:
+#
+#     assert_equal 4, Dom::Post.count
+#     refute_nil Dom::Post.find_by_title('First Post')
+#
+# What makes it really powerful is defining scoped actions:
+#
+#     module Dom
+#       class Post < Domino
+#         def delete
+#           within(id) { click_button 'Delete' }
+#         end
+#       end
+#     end
+#
+#     refute_nil Dom::Post.find_by_title('First Post')
+#     Dom::Post.find_by_title('First Post').delete
+#     assert_nil Dom::Post.find_by_title('First Post')
+class Domino
+  include Capybara
+  extend  Capybara
+
+  # Namespaced Domino::Error
+  class Error < StandardError ; end
+
+  # Direct access to the nokogiri node, in case you need
+  # anything special
+  attr_reader :node
+
+  class << self
+    include Enumerable
+
+    # Iterate over all the Dominos
+    def each
+      nodes.each do |node|
+        yield new(node)
+      end
+    end
+
+    # Get an array of all the Dominos
+    def all
+      map{|node| node}
+    end
+
+    # Define the selector for this Domino
+    #
+    #   module Dom
+    #     class Post
+    #       selector '#posts .post'
+    #     end
+    #   end
+    def selector(s)
+      @selector = s
+    end
+
+    # Define an attribute for this Domino
+    #
+    #   module Dom
+    #     class Post
+    #       attribute :title # defaults to selector '.title'
+    #       attribute :body, '.post-body' # use a custom selector
+    #     end
+    #   end
+    #
+    # This will define an attr_reader on the Domino
+    # and also a find_by_attribute method:
+    #
+    #   Dom::Post.all.first.title
+    #   Dom::Post.find_by_title("First Post")
+    #   Dom::Post.find_by_title(/^First/)
+    def attribute(attribute, selector = nil)
+      selector ||= %{.#{attribute.to_s}}
+
+      class_eval %{
+        def #{attribute}
+          attribute(%{#{selector}})
+        end
+        def self.find_by_#{attribute}(value)
+          find_by_attribute(%{#{selector}}, value)
+        end
+      }
+    end
+
+    private
+
+    # Return the html of the current page
+    def page_body
+      Capybara.current_session.body
+    end
+
+    # Return nokogiri nodes for this object
+    def nodes
+      if @selector.nil?
+        raise Domino::Error.new("You must define a selector")
+      end
+      Nokogiri::HTML(page_body).css(@selector)
+    end
+
+    # Internal method for finding nodes by a selector 
+    def find_by_attribute(selector, value)
+      case value
+      when Regexp
+        detect{|node| node.attribute(selector) =~ value }
+      else
+        detect{|node| node.attribute(selector) == value }
+      end
+    end
+  end
+
+  # Get the text of the first dom element matching a selector
+  #
+  #   Dom::Post.all.first.attribute('.title')
+  def attribute(selector)
+    if @node.css(selector).size > 0
+      @node.css(selector).first.text.strip
+    else
+      nil
+    end
+  end
+
+  # Dom id for this object.
+  def id
+    @node['id'].nil? ? nil : %{##{@node['id']}}
+  end
+
+  private
+  # Takes a Nokogiri node and sets attributes
+  def initialize(node)
+    @node = node
+  end
+end

metadata

@@ -0,0 +1,114 @@
+--- !ruby/object:Gem::Specification 
+name: domino
+version: !ruby/object:Gem::Version 
+  hash: 27
+  prerelease: 
+  segments: 
+  - 0
+  - 1
+  - 0
+  version: 0.1.0
+platform: ruby
+authors: 
+- Nick Gauthier
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-03-04 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: capybara
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 15
+        segments: 
+        - 0
+        - 4
+        - 0
+        version: 0.4.0
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: nokogiri
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 7
+        segments: 
+        - 1
+        - 4
+        - 0
+        version: 1.4.0
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: minitest
+  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: "\n    Make it easier to deal with UI elements by providing an\n    interface that decouples your tests from your views.\n  "
+email: ngauthier@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.md
+files: 
+- lib/domino.rb
+- MIT-LICENSE
+- README.md
+has_rdoc: true
+homepage: http://www.github.com/ngauthier/domino
+licenses: 
+- MIT
+post_install_message: 
+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.4.2
+signing_key: 
+specification_version: 3
+summary: View abstraction for integration testing
+test_files: []
+