capybara_test_helpers 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f4a30d6c705cf0796a86df659b86b09f110a545e910a38185409ddaed812645
-  data.tar.gz: 6e76655a1cc49c9b5242d023bb4085cf3aed55ae9fa4bbbf9db5b8deb21b3f8c
+  metadata.gz: d725477cf4351a38ec85f06dfce971c56bb356c636f31e4e4cbc3d0801e59907
+  data.tar.gz: ac823a9d93f09d45bc99dc2cc01fcbd2ca846d0e50eef7e38825c65f64c76b4b
 SHA512:
-  metadata.gz: 3d23884f2f698a54b637786ebe9afd9ea5f723405672713ca5e26f474076a3d956aad1257e8f3303ee0ec47339f2a7feb75ff41f772d2ed3af261856243c1aa7
-  data.tar.gz: 65851bd3bf3fec126c3d91cf111eed65e1e093540e06fb9e9b1b8e2b1fb4102dbc2f4cdd157d0da97aae6cce4c1273a7096770ecff23cb8eeaea7666dc8431b5
+  metadata.gz: c0e9719e25cba88805c39c9afc974deb21956faf8ccd06e4851680fea4b8d7f4b819753672aac329b5e35127ed25bd9de512b89a5f4a0105a768cbabe0312c73
+  data.tar.gz: 1049f15f89958182898fd9779d26ea003da857ebd9c20f6e2f355f5cb9553a9138c162f4c84c972d3763780915595a60a51d2e9c36800147fe911bc103472eaf

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## Capybara Test Helpers 1.0.4 (2020-11-26) ##
+
+* Add `have_no` alias for `have_no_selector`.
+* Add `has_no?` alias for `has_no_selector?`.
+* Remove internal method `wrap_test_helper`.
+* Allow to use locator aliases in `assert_` methods as well, for consistency.
+
 ## Capybara Test Helpers 1.0.3 (2020-11-24) ##
 
 * Add `CapybaraTestHelpers::BenchmarkHelpers`

data/README.md

@@ -1,8 +1,8 @@
 [docs]: https://capybara-test-helpers.netlify.app/
+[api]: https://capybara-test-helpers.netlify.app/api/
 [design patterns]: https://capybara-test-helpers.netlify.app/guide/advanced/design-patterns
 [installation]: https://capybara-test-helpers.netlify.app/installation
 [capybara]: https://github.com/teamcapybara/capybara
-[capybara dsl]: https://github.com/teamcapybara/capybara#the-dsl
 [capybara querying]: https://github.com/teamcapybara/capybara#querying
 [cucumber]: https://github.com/cucumber/cucumber-ruby
 [rspec]: https://github.com/rspec/rspec
@@ -51,7 +51,7 @@ Write tests that everyone can understand, and leverage your Ruby skills to keep
 
 ## Documentation 📖
 
-[Visit the documentation website][docs] to check out the guides, API reference, and examples.
+[Visit the documentation website][docs] to check out the guides, [API reference][api], and examples.
 
 ## Installation 💿
 

data/lib/capybara_test_helpers/assertions.rb

@@ -5,8 +5,8 @@ require 'capybara_test_helpers/to_or_expectation_handler'
 # Internal: Wraps RSpec matchers to allow using them after calling `should` or
 # `should_not` to perform the assertion.
 module CapybaraTestHelpers::Assertions
-  # Public: Allows writing custom on-demand matchers, as well as chaining
-  # several assertions.
+  # Public: Returns a test helper with a positive assertion state.
+  # Any assertions called after it will execute as `expect(...).to ...`.
   def should(negated = false)
     negated = !!negated # Coerce to boolean.
     return self if negated == @negated
@@ -15,8 +15,8 @@ module CapybaraTestHelpers::Assertions
   end
   [:should_still, :should_now, :and, :and_instead, :and_also, :and_still].each { |should_alias| alias_method should_alias, :should }
 
-  # Public: Allows writing custom on-demand matchers, as well as chaining
-  # several assertions.
+  # Public: Returns a test helper with a negative assertion state.
+  # Any assertions called after it will execute as `expect(...).not_to ...`.
   def should_not
     @negated ? self : should(true)
   end
@@ -102,6 +102,8 @@ module CapybaraTestHelpers::Assertions
     end
   end
 
+  alias have_no have_no_selector
+
   # Public: Allows to check on any input value asynchronously.
   def have_value(expected_value, **options)
     synchronize_expectation(**options) { expect(value).to_or not_to, eq(expected_value) }

data/lib/capybara_test_helpers/matchers.rb

@@ -53,5 +53,27 @@ module CapybaraTestHelpers::Matchers
     CapybaraTestHelpers.define_helper_method(self, method_name, target: :to_capybara_node)
   end
 
+  %i[
+    assert_selector
+    assert_all_of_selectors
+    assert_none_of_selectors
+    assert_any_of_selectors
+    assert_no_selector
+  ].each do |method_name|
+    CapybaraTestHelpers.define_helper_method(self, method_name)
+  end
+
+  %i[
+    assert_matches_selector
+    assert_not_matches_selector
+    assert_ancestor
+    assert_no_ancestor
+    assert_sibling
+    assert_no_sibling
+  ].each do |method_name|
+    CapybaraTestHelpers.define_helper_method(self, method_name, target: :to_capybara_node)
+  end
+
   alias has? has_selector?
+  alias has_no? has_no_selector?
 end

data/lib/capybara_test_helpers/test_helper.rb

@@ -60,18 +60,16 @@ class CapybaraTestHelpers::TestHelper
     raise_missing_element_error
   end
 
-  # Public: Wraps a Capybara::Node::Element with a test helper object.
-  def wrap_element(capybara_node)
-    if capybara_node.is_a?(Enumerable)
-      capybara_node.map { |node| wrap_element(node) }
+  # Public: Wraps a Capybara::Node::Element or test helper with a test helper
+  # object of this class.
+  def wrap_element(element)
+    if element.is_a?(Enumerable)
+      element.map { |node| wrap_element(node) }
     else
-      self.class.new(capybara_node, test_context: test_context)
-    end
-  end
+      raise ArgumentError, "#{ element.inspect } must be a test helper or element." unless element.respond_to?(:to_capybara_node)
 
-  # Public: Wraps a CapybaraTestHelper with a different test helper object.
-  def wrap_test_helper(test_helper)
-    self.class.new(test_helper.query_context, test_context: test_context) if test_helper.query_context
+      self.class.new(element.to_capybara_node, test_context: test_context)
+    end
   end
 
   # Public: Scopes the Capybara queries in the block to be inside the specified
@@ -140,7 +138,7 @@ private
       delegate(*method_names, to: :test_context)
     end
 
-    # Public: Allows to define dependencies on other matchers.
+    # Public: Allows to make other test helpers available.
     #
     # NOTE: When you call a helper the "negated" state is preserved for assertions.
     #
@@ -153,11 +151,7 @@ private
       helper_names.each do |helper_name|
         private define_method(helper_name) { |element = nil|
           test_helper = test_context.get_test_helper(helper_name)
-          if element
-            raise ArgumentError, "#{ element.inspect } must be a test helper or element." unless element.respond_to?(:to_capybara_node)
-
-            test_helper = test_helper.wrap_element(element.to_capybara_node)
-          end
+          test_helper = test_helper.wrap_element(element) if element
           @negated.nil? ? test_helper : test_helper.should(@negated)
         }
       end

data/lib/capybara_test_helpers/version.rb

@@ -2,5 +2,5 @@
 
 # Easily write fluent Page Objects for Capybara in Ruby.
 module CapybaraTestHelpers
-  VERSION = '1.0.3'
+  VERSION = '1.0.4'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: capybara_test_helpers
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - Maximo Mussini
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2020-11-24 00:00:00.000000000 Z
+date: 2020-11-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport