spreewald 2.3.0 → 2.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 258d7d38cd16605b425a3d32c44a2d581ea54373
-  data.tar.gz: bfe7ff5a72464d36d15ee2faf651ef84bf0c41e0
+SHA256:
+  metadata.gz: 02a43b32f16090f64a87cea6adc814baaceb590ef8388863224620f782565e25
+  data.tar.gz: d474b73278a9b3c309c0898e83e1238715012f38cce70e3d8d13d77f9bcd8680
 SHA512:
-  metadata.gz: e8e5f4d23f4e3f3335759fd2be57b5ec8bc57d4d0310dd4bec9c74d73b8fa6caf4f343eb5d1c37f627c6a9d7c4e4177abed1566ebfbf0be4b739d30877134dbd
-  data.tar.gz: 8a07e527e8605893210adc8055620fb10c1df639720ae8665db8e21fa89b205ccef064e36961bdfe88e8ed8d66427194735282dcb396df0ec8970975d032f8c0
+  metadata.gz: c8c2ca98760710ddbda7a2aca39ec3208a1a01ab57e842a448dd14d5b3ba969834d6dc08638440e6979140f2fa22ef2ee152276ae2ae19363ef7294cad213cf5
+  data.tar.gz: 9eea3e603ab1e9cb5d3346c948f09ee3b8c4bbfdd811b76eef3a0fc778c3015c48a85f97c31d6be8833f94e22d2d4ed159ab374b1aa345f51ffeba7d0f5fa23e

data/.gitignore

@@ -11,4 +11,4 @@ InstalledFiles
 tmp
 _yardoc
 *.log
-tests/shared/db/test.sqlite3
+tests/shared/db/*.sqlite3

data/.travis.yml

@@ -6,25 +6,24 @@ language: ruby
 rvm:
   - 2.1.8
   - 2.4.5
-
-gemfile:
-  # Test projects
-  - tests/rails-3_capybara-1/Gemfile
-  - tests/rails-3_capybara-2/Gemfile
-  - tests/rails-4_capybara-3/Gemfile
-  # Used to run rspec and tests for spreewald binary:
-  - Gemfile.ruby218
-  - Gemfile.ruby245
+  - 2.6.6
 
 matrix:
-  exclude:
+  include:
+    # Test projects
     - gemfile: tests/rails-3_capybara-1/Gemfile
-      rvm: 2.4.5
+      rvm: 2.1.8
     - gemfile: tests/rails-3_capybara-2/Gemfile
-      rvm: 2.4.5
-    - gemfile: tests/rails-4_capybara-3/Gemfile
       rvm: 2.1.8
-    - gemfile: Gemfile.ruby218
+    - gemfile: tests/rails-4_capybara-3/Gemfile
       rvm: 2.4.5
-    - gemfile: Gemfile.ruby245
+    - gemfile: tests/rails-6_capybara-3/Gemfile
+      rvm: 2.6.6
+    # Used to run rspec and tests for spreewald binary:
+    - gemfile: Gemfile.ruby218
       rvm: 2.1.8
+    - gemfile: Gemfile.ruby245
+      rvm: 2.4.5
+    - gemfile: Gemfile.ruby266
+      rvm: 2.6.6
+

data/CHANGELOG.md

@@ -3,14 +3,43 @@ All notable changes to this project will be documented in this file.
 
 This project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html).
 
+## 2.7.0
+- Add a step modifier to control different Capybara sessions: `... in the browser session "..."`. (see issue [#66](https://github.com/makandra/spreewald/issues/66))
+
+## 2.6.0
+- The time steps do now work with the time helpers in ActiveSupport 4.1+ if the timecop gem is not included in the bundle. Please note that the two approaches branch. While ActiveSupport will freeze the time, Timecop will keep it running.
+- The steps in the file `spreewald/timecop.rb` file were moved to `spreewald/time.rb` and importing `spreewald/timecop` directly is deprecated now.
+
+## 2.5.0
+- Add a set of steps to control browser tabs (Selenium only):
+  * `I open ... in a new browser tab`
+  * `I close the browser tab`
+  * `I switch to the new browser tab`
+  * `I switch to the previous browser tab`
+  * `I may open a new browser tab` (required for the following step)
+  * `I should( not)? have opened a new browser tab`
+  * `there should be (\d+) browser tabs?`
+  * `there should be at least (\d+) browser tabs?`
+
+## 2.4.2
+- Fix the step `I should( not)? see a link labeled "STRING"`, it is now overridable.
+
+## 2.4.1
+
+- Adapt `I should get a download with filename "..."` step to also work if the `filename` is not the last attribute in `Content-Disposition` header.
+
+## 2.4.0
+
+- Fix "I follow the ... link in the email" step for HTML e-mails to only follow URLs from `<a href="...">` links.
+
 ## 2.3.0
 - Deprecate two steps:
-  - (Given) the file ... was attached to the ... above\
-  - (Then) debugger\
+  - (Given) the file ... was attached to the ... above
+  - (Then) debugger
 
 ## 2.2.4
 - Fix "..." field should have the error "..." test by removing old should syntax
-- Add single-line mail step to READNE
+- Add single-line mail step to README
 
 ## 2.2.3
 - Fix 'the window should be titled' step - closes: [#102](https://github.com/makandra/spreewald/issues/102)
@@ -30,7 +59,7 @@ This project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.html
 
 ## 2.2.0
 - Add a new step `I should( not)? see a link labeled "STRING"`.
-- Refer to Capybara 3's new flag `Capybara.default_normalize_ws = true` in the READNE,
+- Refer to Capybara 3's new flag `Capybara.default_normalize_ws = true` in the README,
 
 ## 2.1.3
 The `I should(not )? see /REGEXP/` step no longer refuses slashes as part of the regular expression. You can thus match full domains and more.

data/Gemfile

@@ -1,5 +1,4 @@
 source 'https://rubygems.org'
 
 gem 'rake'
-gem 'gemika'
-gem 'rspec', '>=2.14.0'
+gem 'gemika'

data/Gemfile.lock

@@ -1,22 +1,8 @@
 GEM
   remote: https://rubygems.org/
   specs:
-    diff-lcs (1.3)
-    gemika (0.3.4)
+    gemika (0.4.0)
     rake (12.3.2)
-    rspec (3.8.0)
-      rspec-core (~> 3.8.0)
-      rspec-expectations (~> 3.8.0)
-      rspec-mocks (~> 3.8.0)
-    rspec-core (3.8.0)
-      rspec-support (~> 3.8.0)
-    rspec-expectations (3.8.3)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-mocks (3.8.0)
-      diff-lcs (>= 1.2.0, < 2.0)
-      rspec-support (~> 3.8.0)
-    rspec-support (3.8.0)
 
 PLATFORMS
   ruby
@@ -24,7 +10,6 @@ PLATFORMS
 DEPENDENCIES
   gemika
   rake
-  rspec (>= 2.14.0)
 
 BUNDLED WITH
    1.17.3

data/Gemfile.ruby266

@@ -0,0 +1,9 @@
+source 'https://rubygems.org'
+
+ruby '2.6.6'
+
+gem 'rspec'
+gem 'cucumber'
+gem 'aruba'
+
+gem 'gemika'

data/Gemfile.ruby266.lock

@@ -0,0 +1,65 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    aruba (1.0.0)
+      childprocess (~> 3.0)
+      contracts (~> 0.16.0)
+      cucumber (>= 2.4, < 4.0)
+      ffi (~> 1.9)
+      rspec-expectations (~> 3.4)
+      thor (~> 1.0)
+    backports (3.17.0)
+    builder (3.2.4)
+    childprocess (3.0.0)
+    contracts (0.16.0)
+    cucumber (3.1.2)
+      builder (>= 2.1.2)
+      cucumber-core (~> 3.2.0)
+      cucumber-expressions (~> 6.0.1)
+      cucumber-wire (~> 0.0.1)
+      diff-lcs (~> 1.3)
+      gherkin (~> 5.1.0)
+      multi_json (>= 1.7.5, < 2.0)
+      multi_test (>= 0.1.2)
+    cucumber-core (3.2.1)
+      backports (>= 3.8.0)
+      cucumber-tag_expressions (~> 1.1.0)
+      gherkin (~> 5.0)
+    cucumber-expressions (6.0.1)
+    cucumber-tag_expressions (1.1.1)
+    cucumber-wire (0.0.1)
+    diff-lcs (1.3)
+    ffi (1.12.2)
+    gemika (0.4.0)
+    gherkin (5.1.0)
+    multi_json (1.14.1)
+    multi_test (0.1.2)
+    rspec (3.9.0)
+      rspec-core (~> 3.9.0)
+      rspec-expectations (~> 3.9.0)
+      rspec-mocks (~> 3.9.0)
+    rspec-core (3.9.1)
+      rspec-support (~> 3.9.1)
+    rspec-expectations (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-mocks (3.9.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.9.0)
+    rspec-support (3.9.2)
+    thor (1.0.1)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  aruba
+  cucumber
+  gemika
+  rspec
+
+RUBY VERSION
+   ruby 2.6.6p146
+
+BUNDLED WITH
+   2.1.4

data/README.md

@@ -38,6 +38,7 @@ single files like this:
     require 'spreewald/email_steps'
     require 'spreewald/web_steps'
 
+Have a look at our [recommended Capybara defaults](#recommended-capybara-defaults) as they impact the behavior of many Spreewald steps.
 
 ## Spreewald binary
 
@@ -83,7 +84,7 @@ More info [here](https://makandracards.com/makandra/12139-waiting-for-page-load-
 Thanks to [cucumber_priority](https://github.com/makandra/cucumber_priority) you can override any step definition from Spreewald with your own pattern. Cucumber will not raise `Cucumber::Ambiguous` if your custom steps collide with a Spreewald step.
 
 
-## A note on Capybara 3
+## Recommended Capybara defaults
 
 If you are upgrading from Capybara 2 to Capybara 3, you might [see failing tests](https://github.com/makandra/spreewald/issues/95) with Spreewald steps like `I should see`. This is caused by a breaking change in [Capybara's Finders](https://www.rubydoc.info/github/jnicklas/capybara/Capybara/Node/Finders) that accept a `:text` option. To activate Capybara 2 behavior globally in your project, enable this flag:
 
@@ -93,6 +94,17 @@ Capybara.default_normalize_ws = true
 
 This will affect all Spreewald steps that are using Capybara's `:text` option.
 
+Furthermore, we recommend setting [Capybara's matching strategy](https://github.com/teamcapybara/capybara/blob/master/README.md#strategy) to `:prefer_exact`. This will positively affect Spreewald steps as it prevents the `Capybara::Ambiguous` error in the edge case when two fields are matching the given name, but one of the matches includes the name only as a substring,
+
+```ruby
+Capybara.match = :prefer_exact
+````
+
+If you want Spreewald to match fields, links and buttons against the `aria-label` attribute, enable the following global configuration in Capybara 2.8+: 
+
+```ruby
+Capybara.enable_aria_label = true
+```
 
 ## Contributing
 
@@ -127,6 +139,54 @@ the step definitions.
 
 ## Steps
 
+### browser_tab_steps.rb 
+
+* **When I open ... in a new browser tab**
+
+  Opens [the page](https://github.com/makandra/spreewald/blob/master/examples/paths.rb) in a new browser tab and switches to it.
+
+
+* **When I close the browser tab**
+
+  Closes the current browser tab and switches back to the first tab.
+
+
+* **When I switch to the new(ly opened)? browser tab**
+
+  Waits for the new browser tab to appear, then switches to it.
+
+
+* **When I switch( back)? to the previous browser tab**
+
+  Changes the browser context to the second-last browser tab.
+
+
+* **When I may open a new browser tab**
+
+  Required for the check whether a new browser tab was opened or not.
+
+
+* **Then I should( not)? have opened a new browser tab**
+
+  Example (positive expectation):
+  
+      When I may open a new browser tab
+        And I click on "Open link in new browser tab"
+      Then I should have opened a new browser tab
+  
+  Example (negative expectation):
+  
+      When I may open a new browser tab
+        And I click on "Open link in current browser tab"
+      Then I should not have opened a new browser tab
+
+
+* **Then there should be (\d+) browser tabs?**
+
+
+* **Then there should be at least (\d+) browser tabs?**
+
+
 ### development_steps.rb 
 
 * **Then it should work...?**
@@ -141,14 +201,14 @@ the step definitions.
   for its job)
 
 
-* **AfterStep @slow**
+* **AfterStep @slow-motion**
 
   Waits 2 seconds after each step
 
 
-* **AfterStep @single**
+* **AfterStep @single-step**
 
-  Waits for keypress after each step
+  Waits for a keypress after each step
 
 
 ### email_steps.rb 
@@ -226,6 +286,18 @@ the step definitions.
   This step is deprecated and will be removed from spreewald. If you still want to use it, copy the code to your project's own steps.
 
 
+### session_steps.rb 
+
+* **When ... in the browser session "..."**
+
+  You can append `in the browser session "name"` to any other step to execute
+  the step in a different browser session.
+  
+  You may need to update other steps to allow multiple sessions (e.g. your
+  authentication steps have to support multiple logged in users).
+  More details [here](https://makandracards.com/makandra/474480-how-to-make-a-cucumber-test-work-with-multiple-browser-sessions).
+
+
 ### table_steps.rb 
 
 * **Then I should( not)? see a table with (exactly )?the following rows( in any order)?:?**
@@ -235,11 +307,14 @@ the step definitions.
   See [this article](https://makandracards.com/makandra/763-cucumber-step-to-match-table-rows-with-capybara) for details.
 
 
-### timecop_steps.rb 
+### time_steps.rb 
 
-Steps to travel through time using [Timecop](https://github.com/jtrupiano/timecop).
+Steps to travel through time
 
-See [this article](https://makandracards.com/makandra/1222-useful-cucumber-steps-to-travel-through-time-with-timecop) for details.
+This uses [Timecop](https://github.com/jtrupiano/timecop) or Active Support 4.1+ to stub Time.now / Time.current.
+The user is responsible for including one of the two gems.
+
+Please note that the two approaches branch. While ActiveSupport will freeze the time, Timecop will keep it running.
 
 
 * **When the (date|time) is "?(\d{4}-\d{2}-\d{2}( \d{1,2}:\d{2})?)"?**
@@ -257,7 +332,7 @@ See [this article](https://makandracards.com/makandra/1222-useful-cucumber-steps
       Given the time is 13:40
 
 
-* **When it is (\d+|a|some|a few) (seconds?|minutes?|hours?|days?|weeks?|months?|years?) (later|earlier)**
+* **When it is (\d+|an?|some|a few) (seconds?|minutes?|hours?|days?|weeks?|months?|years?) (later|earlier)**
 
   Example:
   
@@ -265,6 +340,8 @@ See [this article](https://makandracards.com/makandra/1222-useful-cucumber-steps
       When it is a few hours earlier
 
 
+
+
 ### web_steps.rb 
 
 Most of cucumber-rails' original web steps plus a few of our own.
@@ -293,7 +370,7 @@ deprecation notice. Decide for yourself whether you want to use them:
 
 * **When ... within ...**
 
-  You can append `within [selector]` to any other web step.
+  You can append `within [selector]` to any other web step, even multiple times.
   Be aware that within will only look at the first element that matches.
   If this is a problem for you following links, you might want to have a look
   at the 'When I follow "..." inside any "..."'-step.
@@ -638,9 +715,6 @@ deprecation notice. Decide for yourself whether you want to use them:
 * **When I enter "..." into the browser dialog**
 
 
-* **When I switch to the new tab**
-
-
 * **Then the "..." (field|button|checkbox) should( not)? be disabled**
 
   Tests that an input, button or checkbox with the given label is disabled.

data/Rakefile

@@ -1,5 +1,5 @@
 #!/usr/bin/env rake
-require "bundler/gem_tasks"
+require 'bundler/gem_tasks'
 
 begin
   require 'gemika/tasks'
@@ -17,7 +17,7 @@ namespace :matrix do
       directory = File.dirname(row.gemfile)
       if directory.start_with?('tests')
         # Run integration tests (uses embedded projects)
-        system("cd #{directory} && BUNDLE_GEMFILE=Gemfile geordi cucumber")
+        system(cucumber_command(directory, row.ruby))
       else
         # Run specs and tests for spreewald binary
         [
@@ -44,16 +44,31 @@ task :update_readme do
     require 'support/step_manager'
   end
 
-  readme = File.read('README.md')
-  start_of_steps_section = readme =~ /^## Steps/
-  length_of_steps_section = (readme[(start_of_steps_section+1)..-1] =~ /^##[^#]/) || readme.size - start_of_steps_section
-  readme[start_of_steps_section, length_of_steps_section] = "## Steps\n\n" + StepManager.new('lib/spreewald').to_markdown
-  File.open(readme_path, 'w') { |f| f.write(readme) }
+  readme = File.read(readme_path)
+  File.open(readme_path, 'w') do |file|
+    start_of_steps_section = readme =~ /^## Steps/
+    length_of_steps_section = readme[(start_of_steps_section+1)..-1] =~ /^##[^#]/
+    length_of_steps_section ||= readme.size - start_of_steps_section
+    step_documentation = StepManager.new('lib/spreewald').to_markdown
+    readme[start_of_steps_section, length_of_steps_section] = "## Steps\n\n#{step_documentation}"
+
+    file.write(readme)
+  end
 
   system "git diff #{readme_path}"
   puts '', '> Done (diff applied).'
 end
 
+def cucumber_command(directory, ruby_version)
+  command = "cd #{directory} && BUNDLE_GEMFILE=Gemfile geordi cucumber"
+  if Gem::Version.new(ruby_version) > Gem::Version.new('2.5')
+    # Modern cucumber sees pending tests as failures.
+    # We don't want this.
+    command << ' --no-strict-pending'
+  end
+  command
+end
+
 def warn(text)
   puts "\e[31m#{text}\e[0m" # red text
 end