domino 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3b2fc62eeaf1ab1a2ff6246839d6d312ef845b38
-  data.tar.gz: 395182dd48dba139cde162499d33918274019e84
+  metadata.gz: 554cc2cc550cceacec189b1fcab208a2f530c3b4
+  data.tar.gz: 65dd95a5af9bfa19e04e38e3821cb016e01c8594
 SHA512:
-  metadata.gz: 7aefa91bbd7757aec8b80dbe9466fd26b6c9fe676b82e6da9e48b20a38d43a1488246a95b3d5f5998a2d5a3a54f564efe2ac83f4db77d42effd35a19b25cf174
-  data.tar.gz: 766c1df5a282ac53e4e26fd6137fcd396c0fe1aab39be5e9dc434ed30dd2ecb848308290733e29d0b76f8b73cd933c1de9b93fd5cd2c3eda8c79280db1b75e55
+  metadata.gz: 98a53738194cc39ab9734ceeb69209735f84bb7bec6c06f672b6243556bc4d18fa272b7d5a682ac3fc6264b086eb4b2f09dbc9fd0473b46c09575f0096e0f8e0
+  data.tar.gz: a65293c01ae787bc2df87372ad30b88d7f4b50a20156993e6d501493715e8ffd588e7f366ecec01d646eabdf76ea64466008a4cf8e8c610174e173c76ee7cd6a

data/.travis.yml

@@ -2,5 +2,6 @@ language: ruby
 rvm:
   - 1.9.3
   - 2.0.0
-  - jruby-19mode
-  - rbx-19mode
+  - 2.1.2
+  - jruby
+  - ruby

data/README.md

@@ -11,6 +11,7 @@ define a selector and attributes:
       class Post < Domino
         selector '#posts .post'
         attribute :title # selector defaults to .title
+        attribute :author_name # selector defaults to .author-name
         attribute :body, '.post-body' # example of selector override
 
         # pass a block if you want to modify the value
@@ -61,6 +62,24 @@ access to the capybara node.
 
 For more information about using Capybara nodes, check [Capybara Documentation](https://github.com/jnicklas/capybara/blob/master/README.rdoc).
 
+## Dealing with Asynchronous Behavior
+
+When working with Capybara drivers that support JavaScript, it may be
+necessary to wait for elements to appear. Note that the following code
+simply collects all `Account` dominos currently on the page and
+returns the first:
+
+    Dom::Account.first # returns nil if account is displayed asynchronously
+
+When you are waiting for a unique domino to appear, you can instead
+use the `find!` method:
+
+    Dom::Account.find! # waits for matching element to appear
+
+If no matching element appears, Capybara will raise an error telling
+you about the expected selector.  Depending on the
+[`Capybara.match` option](https://github.com/jnicklas/capybara#strategy),
+this will also raise an error if the selector matches multiple nodes.
 
 ## Integration with Cucumber
 

data/domino.gemspec

@@ -1,7 +1,7 @@
 # -*- encoding: utf-8 -*-
 Gem::Specification.new do |gem|
   gem.name = "domino"
-  gem.version = "0.5.0"
+  gem.version = "0.6.0"
   gem.platform = Gem::Platform::RUBY
   gem.authors = ["Nick Gauthier"]
   gem.email = ["ngauthier@gmail.com"]

data/lib/domino.rb

@@ -59,6 +59,18 @@ class Domino
       map{|node| node}
     end
 
+    # Returns Domino for capybara node matching selector.
+    #
+    # Raises an error if no matching node is found. For drivers that
+    # support asynchronous behavior, this method waits for a matching
+    # node to appear.
+    def find!
+      if @selector.nil?
+        raise Domino::Error.new("You must define a selector")
+      end
+      new(Capybara.current_session.find(@selector))
+    end
+
     # Define the selector for this Domino
     #
     #   module Dom

data/test/domino_test.rb

@@ -143,4 +143,20 @@ class DominoTest < MiniTest::Unit::TestCase
   def test_callback
     assert_equal 23, Dom::Person.find_by_name("Alice").age
   end
+
+  def test_find_bang
+    assert_equal '#receipt-72', Dom::Receipt.find!.id
+  end
+
+  def test_find_bang_without_match
+    assert_raises Capybara::ElementNotFound do
+      Dom::Animal.find!
+    end
+  end
+
+  def test_find_bang_without_selector
+    assert_raises Domino::Error do
+      Dom::NoSelector.find!
+    end
+  end
 end

metadata

@@ -1,69 +1,69 @@
 --- !ruby/object:Gem::Specification
 name: domino
 version: !ruby/object:Gem::Version
-  version: 0.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Nick Gauthier
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-06-20 00:00:00.000000000 Z
+date: 2014-08-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: capybara
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: minitest
   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: 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: simplecov
   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: "\n    Make it easier to deal with UI elements by providing an\n    interface
@@ -75,8 +75,8 @@ extensions: []
 extra_rdoc_files:
 - README.md
 files:
-- .gitignore
-- .travis.yml
+- ".gitignore"
+- ".travis.yml"
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -94,17 +94,17 @@ 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.2
+rubygems_version: 2.4.1
 signing_key: 
 specification_version: 4
 summary: View abstraction for integration testing