ruby_raider 3.13.0 → 4.0.0

data/spec/integration/content/page_content_spec.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'yaml'
 require_relative 'content_helper'
 
 describe 'Page object content' do
@@ -36,16 +37,15 @@ describe 'Page object content' do
   shared_examples 'selenium login page' do |project_name|
     subject(:login) { read_generated(project_name, 'page_objects/pages/login.rb') }
 
-    it 'returns locator hashes from the element methods' do
-      expect(login).to include("{ id: 'loginFrm_loginname' }", "{ id: 'loginFrm_password' }",
-                               %q({ xpath: "//button[@title='Login']" }))
-      expect(login).not_to include('driver.find_element')
+    it 'returns Selenium elements from the element methods' do
+      expect(login).to include("driver.find_element(id: 'loginFrm_loginname')", "driver.find_element(id: 'loginFrm_password')",
+                               "driver.find_element(by_role('button', name: 'Login'))")
+      expect(login).not_to include('browser.')
     end
 
-    it 'logs in through the wait helper' do
-      expect(login).to include('send_keys(username_field, username)', 'send_keys(password_field, password)',
-                               'click(login_button)')
-      expect(login).not_to include('.send_keys', '.click')
+    it 'logs in by acting on the elements' do
+      expect(login).to include('username_field.send_keys(username)', 'password_field.send_keys(password)', 'login_button.click')
+      expect(login).to include('alias log_as login')
     end
 
     it 'has private element methods' do
@@ -59,28 +59,6 @@ describe 'Page object content' do
       expect(login).not_to include('Capybara::DSL')
       expect(login).not_to include('fill_in')
     end
-
-    it 'does not include Watir methods' do
-      expect(login).not_to include('browser.text_field')
-    end
-  end
-
-  shared_examples 'watir login page' do |project_name|
-    subject(:login) { read_generated(project_name, 'page_objects/pages/login.rb') }
-
-    it 'uses browser methods for elements' do
-      expect(login).to include('browser.text_field')
-      expect(login).to include('browser.button')
-    end
-
-    it 'uses set for input' do
-      expect(login).to include('.set ')
-    end
-
-    it 'does not include Selenium methods' do
-      expect(login).not_to include('find_element')
-      expect(login).not_to include('send_keys')
-    end
   end
 
   # --- Abstract page ---
@@ -99,6 +77,39 @@ describe 'Page object content' do
     it 'defines to_s method' do
       expect(page).to match(/def to_s/)
     end
+
+    describe 'full_url' do
+      # The generated full_url and base_url, loaded without the helpers the abstract page requires.
+      let(:page_class) do
+        methods = page[/^  def full_url.*?^  end\n\n(?:  #.*\n)*  def base_url.*?^  end\n/m]
+        expect(methods).not_to be_nil
+        Class.new { def url(_page) = 'index.php?rt=account/login' }.tap { |klass| klass.class_eval(methods) }
+      end
+
+      def full_url_with(base_url, path = nil)
+        allow(YAML).to receive(:load_file).with('config/config.yml').and_return('url' => base_url)
+        klass = page_class
+        klass.define_method(:url) { |_page| path } if path
+        klass.new.full_url(nil)
+      end
+
+      it 'adds the missing slash between a base url with a path and the page path' do
+        expect(full_url_with('https://example.org/login')).to eq('https://example.org/login/index.php?rt=account/login')
+      end
+
+      it 'keeps a single slash when the base url already ends with one' do
+        expect(full_url_with('https://example.org/login/')).to eq('https://example.org/login/index.php?rt=account/login')
+      end
+
+      it 'does not double the slash when the page path starts with one' do
+        expect(full_url_with('https://example.org', '/index.php')).to eq('https://example.org/index.php')
+      end
+
+      it 'returns the page path alone when the config has no url' do
+        expect(full_url_with(nil, 'https://other.example/index.php')).to eq('https://other.example/index.php')
+        expect(full_url_with(nil, '/index.php')).to eq('/index.php')
+      end
+    end
   end
 
   shared_examples 'selenium abstract page' do |project_name|
@@ -121,22 +132,6 @@ describe 'Page object content' do
     end
   end
 
-  shared_examples 'watir abstract page' do |project_name|
-    subject(:page) { read_generated(project_name, 'page_objects/abstract/page.rb') }
-
-    it 'has attr_reader :browser' do
-      expect(page).to include('attr_reader :browser')
-    end
-
-    it 'has initialize accepting browser' do
-      expect(page).to match(/def initialize\(browser\)/)
-    end
-
-    it 'has visit with browser.goto' do
-      expect(page).to include('browser.goto')
-    end
-  end
-
   # --- Contexts ---
 
   context 'with rspec and selenium' do
@@ -146,49 +141,29 @@ describe 'Page object content' do
     include_examples 'valid abstract page', name
     include_examples 'selenium abstract page', name
   end
-
-  context 'with rspec and watir' do
-    name = "#{FrameworkIndex::RSPEC}_#{AutomationIndex::WATIR}"
-    include_examples 'valid login page', name
-    include_examples 'watir login page', name
-    include_examples 'valid abstract page', name
-    include_examples 'watir abstract page', name
-  end
-
-  context 'with cucumber and selenium' do
-    name = "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
-    include_examples 'valid login page', name
-    include_examples 'selenium login page', name
-    include_examples 'valid abstract page', name
-    include_examples 'selenium abstract page', name
-  end
-
-  context 'with cucumber and watir' do
-    name = "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}"
-    include_examples 'valid login page', name
-    include_examples 'watir login page', name
-    include_examples 'valid abstract page', name
-    include_examples 'watir abstract page', name
-  end
 end
 
-describe 'Page WaitHelper wiring' do
-  %w[rspec cucumber].each do |framework|
-    %w[selenium ios android cross_platform].each do |automation|
-      it "includes WaitHelper in #{framework} #{automation}" do
+describe 'Page helper wiring' do
+  FRAMEWORKS.each do |framework|
+    it "includes NetworkHelper only in #{framework} selenium" do
+      %w[selenium ios android cross_platform].each do |automation|
         page = read_generated("#{framework}_#{automation}", 'page_objects/abstract/page.rb')
-        expect(page).to include("require_relative '../../helpers/wait_helper'", 'include WaitHelper')
+        expect(page.include?('include NetworkHelper')).to eq(automation == 'selenium')
       end
     end
 
-    it "does not include WaitHelper in #{framework} watir" do
-      expect(read_generated("#{framework}_watir", 'page_objects/abstract/page.rb')).not_to include('WaitHelper')
+    it "includes ScreenshotHelper only in #{framework} selenium" do
+      %w[selenium ios android cross_platform].each do |automation|
+        page = read_generated("#{framework}_#{automation}", 'page_objects/abstract/page.rb')
+        expect(page.include?('include ScreenshotHelper')).to eq(automation == 'selenium')
+        expect(page.include?("require_relative '../../helpers/screenshot_helper'")).to eq(automation == 'selenium')
+      end
     end
   end
 end
 
 describe 'Abstract page layout' do
-  %w[rspec cucumber].each do |framework|
+  FRAMEWORKS.each do |framework|
     %w[selenium ios android cross_platform].each do |automation|
       [true, false].each do |examples|
         it "has no blank line before the class end in #{framework} #{automation}#{' (skeleton)' unless examples}" do
@@ -200,12 +175,12 @@ describe 'Abstract page layout' do
   end
 end
 
-describe 'Example pages on the wait helper' do
-  %w[rspec cucumber].each do |framework|
-    it "finds the header through the wait helper in #{framework} selenium" do
+describe 'Example pages' do
+  FRAMEWORKS.each do |framework|
+    it "defines welcome_message on the abstract page in #{framework} selenium" do
       page = read_generated("#{framework}_selenium", 'page_objects/abstract/page.rb')
-      expect(page).to include("Header.new(find_element(css: '.welcome-msg'))")
-      expect(page).not_to include('driver.find_element')
+      expect(page).to include("def welcome_message\n    driver.find_element(css: '.welcome-msg')")
+      expect(page).not_to include('Header', 'components/header')
     end
 
     %w[ios android cross_platform].each do |automation|
@@ -213,10 +188,12 @@ describe 'Example pages on the wait helper' do
         let(:home) { read_generated("#{framework}_#{automation}", 'page_objects/pages/home.rb') }
         let(:pdp) { read_generated("#{framework}_#{automation}", 'page_objects/pages/pdp.rb') }
 
-        it 'taps the first product and reads the add to cart text through the wait helper' do
-          expect(home).to include('tap(first_product)')
-          expect(pdp).to include('text(add_to_cart_button)')
-          expect(home + pdp).not_to include('driver.wait', 'driver.find_element')
+        it 'clicks the first product and exposes the add to cart button as plain Appium' do
+          finder = automation == 'cross_platform' ? 'element(' : 'driver.find_element('
+          expect(home).to include('first_product.click', "  private\n", "def first_product\n    #{finder}")
+          expect(pdp).to include('def add_to_cart_button')
+          expect(pdp).not_to include('add_to_cart_text', 'private')
+          expect(home + pdp).not_to include('tap(', 'text(', 'driver.wait')
         end
 
         it 'returns locator hashes from the element methods' do
@@ -238,3 +215,24 @@ describe 'Example pages on the wait helper' do
     end
   end
 end
+
+describe 'Page runtime wiring' do
+  it 'requires the appium helper that the cross platform page includes' do
+    page = read_generated("#{FrameworkIndex::RSPEC}_cross_platform", 'page_objects/abstract/page.rb')
+    expect(page).to include("require_relative '../../helpers/appium_helper'", 'include AppiumHelper')
+  end
+
+  it 'leaves the appium helper out of the other pages' do
+    %w[selenium ios android].each do |automation|
+      page = read_generated("#{FrameworkIndex::RSPEC}_#{automation}", 'page_objects/abstract/page.rb')
+      expect(page).not_to include('appium_helper')
+    end
+  end
+
+  AUTOMATION_TYPES.each do |automation|
+    it "requires the runtime and includes Raider::Helpers in #{automation}" do
+      page = read_generated("#{FrameworkIndex::RSPEC}_#{automation}", 'page_objects/abstract/page.rb')
+      expect(page).to include("require 'ruby_raider/runtime'", 'include Raider::Helpers')
+    end
+  end
+end

data/spec/integration/content/readme_content_spec.rb

@@ -8,7 +8,7 @@ describe 'Generated Readme content' do
       subject(:section) { readme[/^### Video replay\n.*?(?=^##)/m]&.gsub(/\s+/, ' ') }
 
       let(:readme) { read_generated("#{framework}_#{automation}", 'Readme.md') }
-      let(:web) { %w[selenium watir].include?(automation) }
+      let(:web) { automation == 'selenium' }
 
       it 'exists and covers the defaults, VIDEO=off, the install commands and the cache' do
         expect(section).not_to be_nil
@@ -86,59 +86,84 @@ describe 'Generated Readme content' do
           expect(section).to include('Failure messages can contain typed text too, because an assertion message is kept as it is')
         end
 
-        it 'says how to remove the trace helper and notes the wait helper link' do
-          expect(readme).to include('Removing the trace helper', 'require_relative',
-                                    'without WaitHelper a trace records only navigation and the failure')
+        it 'says how to remove the trace helper' do
+          expect(readme).to include('Removing the trace helper', 'require_relative')
           expect(readme).not_to match(/allure/i)
           expect(readme).not_to include('—')
         end
+
+        it 'says which element actions the trace records' do
+          expect(section).to include('records `click`, `send_keys`, `clear` and `submit` with their locators',
+                                     '`by_role` as `button, name: Save`', 'not steps')
+        end
       else
         it 'does not mention trace replay' do
           expect(readme).not_to include('Trace replay', 'TRACE=', 'trace_helper')
         end
       end
     end
-  end
 
-  AUTOMATION_TYPES.each do |automation|
-    context "with rspec and #{automation}" do
-      subject(:readme) { read_generated("#{FrameworkIndex::RSPEC}_#{automation}", 'Readme.md') }
+    context "with #{framework} and #{automation}, the network mocking section" do
+      subject(:readme) { read_generated("#{framework}_#{automation}", 'Readme.md') }
 
-      it 'has a Reporting section' do
-        expect(readme).to include('## Reporting')
-      end
+      if automation == 'selenium'
+        it 'documents the API, the examples, BIDI=off and how to remove the helper' do
+          expect(readme).to include('## Mocking network requests', "mock_request('**/api/users', json: { users: [] })",
+                                    'BIDI=off', '### Removing the network helper', 'status: 500',
+                                    "block_request('**/*.png')", 'NetworkHelper::MockError')
+          expect(readme).to include('expect { users.called? }.to be(true)',
+                                    "expect { users.calls.first&.method }.to eq('GET')")
+        end
 
-      it 'documents local results, upload settings and the raider_reporter README' do
-        expect(readme).to include('raider-results/', 'RAIDER_TOKEN', 'RAIDER_ENDPOINT',
-                                  'https://github.com/RaiderHQ/raider_reporter')
-      end
+        it 'names the files to edit for this framework' do
+          section = readme[/^### Removing the network helper\n.*?(?=^##)/m]
+          expect(section).to include('helpers/network_helper.rb', 'NetworkHelper.finish', 'raise mock_error')
+          expect(section).to include(framework == 'rspec' ? 'config.include(NetworkHelper)' : 'World(NetworkHelper)')
+        end
 
-      it 'explains quarantine in CI' do
-        expect(readme).to include('### Quarantine', 'RAIDER_QUARANTINE', 'raider-reporter exec')
+        it 'says that TRACE=off keeps BiDi on' do
+          expect(readme).to include('BiDi stays on')
+        end
+      else
+        it 'does not mention network mocking' do
+          expect(readme).not_to include('Mocking network requests', 'NetworkHelper')
+        end
       end
+    end
 
-      it 'explains the quality gate' do
-        expect(readme).to include('### Quality gate', 'RAIDER_GATE=1', 'Gate page', 'raider/gate',
-                                  'raider-reporter gate', 'raider-gate', 'exits 1 when the gate fails',
-                                  '2 when it gets no verdict', 'RAIDER_GATE_TIMEOUT', 'RAIDER_SHARD_TOTAL',
-                                  'RAIDER_SHARD_INDEX')
-      end
+    context "with #{framework} and #{automation}, the screenshot comparison section" do
+      subject(:readme) { read_generated("#{framework}_#{automation}", 'Readme.md') }
 
-      it 'points to the local HTML report' do
-        expect(readme).to include('raider-results/index.html')
-        expect(readme).not_to match(/allure/i)
+      if automation == 'selenium'
+        it 'documents the call, SCREENSHOTS=update, tolerances, CI baselines and removal' do
+          expect(readme).to include('## Screenshot comparison', "match_screenshot('home')", 'SCREENSHOTS=update',
+                                    'screenshots/baselines/', 'max_diff_pixels', 'Retina', 'Generate baselines where CI runs',
+                                    '### Removing screenshot comparison')
+        end
+
+        it 'names the files to edit for this framework' do
+          section = readme[/^### Removing screenshot comparison\n.*?(?=^##)/m]
+          expect(section).to include('helpers/screenshot_helper.rb', 'ScreenshotHelper.reset', "gem 'chunky_png'")
+          expect(section).to include(framework == 'rspec' ? 'config.include(ScreenshotHelper)' : 'World(ScreenshotHelper)')
+        end
+      else
+        it 'does not mention screenshot comparison' do
+          expect(readme).not_to include('Screenshot comparison', 'ScreenshotHelper', 'match_screenshot')
+        end
       end
     end
+  end
 
-    context "with cucumber and #{automation}" do
-      subject(:readme) { read_generated("#{FrameworkIndex::CUCUMBER}_#{automation}", 'Readme.md') }
+  AUTOMATION_TYPES.each do |automation|
+    context "with rspec and #{automation}" do
+      subject(:readme) { read_generated("#{FrameworkIndex::RSPEC}_#{automation}", 'Readme.md') }
 
       it 'has a Reporting section' do
         expect(readme).to include('## Reporting')
       end
 
-      it 'documents local results, upload settings, plugin mode and the raider_reporter README' do
-        expect(readme).to include('raider-results/', 'RAIDER_TOKEN', 'RAIDER_ENDPOINT', 'features/support/env.rb',
+      it 'documents local results, upload settings and the raider_reporter README' do
+        expect(readme).to include('raider-results/', 'RAIDER_TOKEN', 'RAIDER_ENDPOINT',
                                   'https://github.com/RaiderHQ/raider_reporter')
       end
 
@@ -153,7 +178,8 @@ describe 'Generated Readme content' do
                                   'RAIDER_SHARD_INDEX')
       end
 
-      it 'does not mention Allure' do
+      it 'points to the local HTML report' do
+        expect(readme).to include('raider-results/index.html')
         expect(readme).not_to match(/allure/i)
       end
     end
@@ -163,11 +189,11 @@ describe 'Generated Readme content' do
     context "with #{framework} and #{automation}, the login reuse section" do
       subject(:readme) { read_generated("#{framework}_#{automation}", 'Readme.md') }
 
-      if %w[selenium watir].include?(automation)
+      if automation == 'selenium'
         it 'documents the tags, other roles, max_age, the env switch and the secrets warning' do
           section = readme[/^## Reusing the login\n.*?(?=^##)/m].gsub(/\s+/, ' ')
-          expect(section).to include('`:logged_in`', '`@logged_in`', "SessionState.new(driver, name: 'admin')",
-                                     'browser.driver', 'login_state', 'max_age', 'RAIDER_LOGIN_STATE=off',
+          expect(section).to include('`:logged_in`', "SessionState.new(driver, name: 'admin')",
+                                     'login_state', 'max_age', 'RAIDER_LOGIN_STATE=off',
                                      'RAIDER_LOGIN_STATE=refresh', '.raider/auth/', 'git-ignored',
                                      'live session tokens', 'must not be committed, cached or uploaded')
         end
@@ -204,36 +230,55 @@ describe 'Generated Readme: How the framework works' do
         expect(readme.index("\n## Reusing the login\n")).to be > works
       end
 
-      it 'covers the web wait helper, chaining, .native, absence checks and how to remove it' do
+      it 'covers the folders, the settings, running the tests and the helpers without a wait helper' do
         section = section_of(readme)
-        expect(section).to include('### Removing the wait helper', '.native',
-                                   "find_element(css: '.form').find_element(id: 'email')",
-                                   'select_by', 'hover', 'drag_and_drop', 'eventually', 'timeout: 0',
-                                   'find_elements', 'config/config.yml', '[Reporting](#reporting)',
-                                   '[Reusing the login](#reusing-the-login)', 'parallel_tests', 'HEADLESS',
+        expect(section).to include('config/config.yml', '[Reporting](#reporting)', '[Reusing the login](#reusing-the-login)',
+                                   'parallel_tests', 'HEADLESS', 'requires the Raider runtime',
                                    framework == 'rspec' ? 'RETRY_COUNT' : '--retry 2')
-        expect(section).not_to include('scroll_to', 'swipe')
+        expect(section).to include('`timeout`', '`strict`', '`actionability`')
+        expect(section).not_to include('scroll_to', 'swipe', 'gesture_helper')
+      end
+
+      it 'has no wait helper, RaiderElement, eventually or implicit wait advice' do
+        expect(readme).not_to match(/WaitHelper|RaiderElement|wait_helper|raider_element|eventually|wait helper/i)
+        expect(readme).not_to include('Removing the wait helper', 'implicit_wait = ')
+      end
+
+      it 'documents the locators, with by_role, the exact form, strictness and find_elements' do
+        locators = section_of(readme)[/^### Locators\n.*?(?=^### )/m].gsub(/\s+/, ' ')
+        expect(locators).to include('id:', 'css:', 'xpath:', 'name:', 'class:', 'link_text:', 'label:', 'placeholder:',
+                                    'alt:', 'title:', 'text:', 'test_id:', 'data-testid', 'RAIDER_TEST_ID_ATTRIBUTE',
+                                    "by_role('button', name: 'Login')", 'exact:', 'include_hidden:', 'level:',
+                                    "label: ['Email', { exact: true }]", 'matches more than one element',
+                                    'AmbiguousMatch', 'find_elements')
       end
 
-      it 'explains that the waits inside eventually stretch to its time and are retried' do
-        eventually = section_of(readme)[/^### eventually\n.*?(?=^### )/m]
-        expect(eventually).to include('a wait inside it that timed out', 'whatever is left of the block',
-                                      '`timeout: 2` gets 2 seconds per try', '(still failing after 10s)')
+      it 'documents the waiting finds, the per-action checks, force and the settings' do
+        waiting = section_of(readme)[/^### Waiting and actionability\n.*?(?=^### )/m].gsub(/\s+/, ' ')
+        expect(waiting).to include('`find_element` and `find_elements` wait for a match', '`find_elements` returns `[]`',
+                                   '| `click` | visible, enabled, not inert, stable, receives events |',
+                                   '| `send_keys` | visible, enabled, editable, not inert |',
+                                   '| `clear` | visible, enabled, editable, not inert |',
+                                   '| `submit` | visible, enabled, not inert |',
+                                   'force: true', 'Raider.actionability = false', 'RAIDER_STRICT', 'RAIDER_ACTIONABILITY',
+                                   'RAIDER_TIMEOUT', 'RAIDER_QUIET', 'raider u strict', 'raider u actionability',
+                                   'no such element: { id: "x" } (waited 10s)', 'NotActionable', 'select_by',
+                                   'implicit wait')
+        expect(waiting).not_to include('driver.manage.timeouts.implicit_wait')
       end
 
-      it 'replaces eventually with a true/false Wait block and points at the generators that check' do
-        removal = section_of(readme)[/^### Removing the wait helper\n.*/m]
-        expect(removal).to include('a plain `expect`, or `Selenium::WebDriver::Wait.new(timeout: 10).until { condition }`',
-                                   'a block that returns true or false', '`raider g page` and `raider g component`')
-        expect(removal).not_to include('raider g spec')
+      it 'documents the matchers, wait:, the block form and its limits' do
+        assertions = section_of(readme)[/^### Assertions\n.*?(?=^### )/m].gsub(/\s+/, ' ')
+        expect(assertions).to include('have_text', 'have_value', 'have_attribute', 'be_visible', 'be_hidden', 'be_enabled',
+                                      'be_disabled', 'be_checked', 'have_count', 'have_title', 'have_url', 'have_element',
+                                      'have_css', 'have_xpath', 'wait: 5', 'expect { account_page.welcome_message }',
+                                      'expect { value }.to eq(', 'raise_error', 'does not retry',
+                                      'once per poll', 'aggregate_failures')
       end
 
-      it 'lists the five steps to remove the wait helper' do
-        removal = section_of(readme)[/^### Removing the wait helper\n.*/m]
-        expect(removal).to include('helpers/wait_helper.rb', 'helpers/raider_element.rb', 'include WaitHelper',
-                                   'driver.find_element(**', 'Selenium::WebDriver::Wait.new', 'implicit_wait',
-                                   'raider g')
-        expect(removal.scan(/^\d\. /).size).to eq(5)
+      it 'lists the web helpers and the page base class without a wait helper' do
+        section = section_of(readme)
+        expect(section).to include('`driver_helper.rb` starts the browser', '`video_helper.rb`', '`session_state.rb`')
       end
     end
 
@@ -248,15 +293,40 @@ describe 'Generated Readme: How the framework works' do
           expect(readme.index("\n## Reporting\n")).to be > works
         end
 
-        it 'covers the mobile method set, per-OS locators, Appium setup and how to remove the wait helper' do
+        it 'covers the folders, per-OS locators, Appium setup and the gesture helper' do
           section = section_of(readme)
-          expect(section).to include('swipe', 'scroll_to', 'tap', 'capabilities.yml', 'raider u start_appium',
-                                     '### Removing the wait helper', '.native', '[Reporting](#reporting)',
-                                     'timeout: 15', 'http://127.0.0.1:4723')
-          expect(section).not_to include('select_by', 'hover', 'drag_and_drop', 'Reusing the login', '/wd/hub')
+          expect(section).to include('capabilities.yml', 'raider u start_appium', '[Reporting](#reporting)',
+                                     'timeout: 15', 'http://127.0.0.1:4723', '`gesture_helper.rb`',
+                                     '`swipe`', '`scroll_to`', 'requires the Raider runtime')
+          expect(section).not_to include('select_by', 'hover', 'drag_and_drop', 'Reusing the login', '/wd/hub',
+                                         'by_role', 'wait_helper', 'raider_element')
           expect(section).to include('ios: {') if automation == 'cross_platform'
         end
 
+        it 'has no wait helper, RaiderElement or eventually' do
+          expect(readme).not_to match(/WaitHelper|RaiderElement|wait_helper|raider_element|eventually|wait helper/i)
+        end
+
+        it 'documents the Appium locators and the waiting finds and actions' do
+          section = section_of(readme)
+          locators = section[/^### Locators\n.*?(?=^### )/m].gsub(/\s+/, ' ')
+          expect(locators).to include('accessibility_id:', 'xpath:', 'id:', 'class_name:', 'find_elements')
+          expect(section).to include('element(ios: { … }, android: { … })') if automation == 'cross_platform'
+          waiting = section[/^### Waiting\n.*?(?=^### )/m].gsub(/\s+/, ' ')
+          expect(waiting).to include('`find_element` and `find_elements` wait for a match',
+                                     '`click`, `send_keys` and `clear` wait until the element is displayed and enabled',
+                                     '`submit` is not checked', 'strict is off', 'force: true', 'Raider.actionability = false',
+                                     'NotActionable', 'XCUITest', 'RAIDER_TIMEOUT', 'RAIDER_STRICT', 'RAIDER_ACTIONABILITY')
+          expect(section[/^### Settings\n.*?(?=^### )/m]).to include('no `config/config.yml`') unless automation == 'cross_platform'
+        end
+
+        it 'documents the gestures and the assertions' do
+          section = section_of(readme)
+          gestures = section[/^### Gestures\n.*?(?=^### )/m].gsub(/\s+/, ' ')
+          expect(gestures).to include("swipe('left', element)", "scroll('down')", 'scroll_to({ accessibility_id: ')
+          expect(section[/^### Assertions\n.*?(?=^### )/m]).to include('have_text', 'expect { pdp_page.add_to_cart_button }')
+        end
+
         it 'says the device capabilities sit under appium:options' do
           settings = section_of(readme)[/^### Settings\n.*?(?=^### )/m]
           expect(settings).to include('under `appium:options`')
@@ -264,26 +334,15 @@ describe 'Generated Readme: How the framework works' do
         end
       end
     end
-
-    it "marks the #{framework} watir Readme as deprecated and not the selenium one" do
-      watir = read_generated("#{framework}_watir", 'Readme.md')
-      expect(watir).to include('> **Deprecated:** Watir is deprecated', 'only available through `-p automation:watir`',
-                               'https://github.com/RaiderHQ/ruby_raider#migrating-from-watir')
-      expect(read_generated("#{framework}_selenium", 'Readme.md')).not_to include('**Deprecated:**')
-    end
-
-    it "has no such section for #{framework} and watir" do
-      expect(read_generated("#{framework}_watir", 'Readme.md')).not_to include('How the framework works')
-    end
   end
 
   describe 'without example tests' do
-    %w[rspec cucumber].product(%w[selenium ios cross_platform]).each do |framework, automation|
+    FRAMEWORKS.product(%w[selenium ios cross_platform]).each do |framework, automation|
       context "with #{framework} and #{automation}" do
         subject(:readme) { read_generated(ensure_project(framework:, automation:, examples: false), 'Readme.md') }
 
         it 'still explains how the framework works' do
-          expect(readme).to include('## How the framework works', '### The wait helper and RaiderElement')
+          expect(readme).to include('## How the framework works', '### Locators', '### Assertions')
         end
 
         it 'points at no example file' do
@@ -298,7 +357,7 @@ describe 'Generated Readme: How the framework works' do
       end
     end
 
-    %w[rspec cucumber].each do |framework|
+    FRAMEWORKS.each do |framework|
       it "shows how to add the login hook for the project's own login page in #{framework}" do
         readme = read_generated(ensure_project(framework:, automation: 'selenium', examples: false), 'Readme.md')
         section = readme[/^## Reusing the login\n.*?(?=^## )/m]

data/spec/integration/content/rspec_reporter_content_spec.rb

@@ -18,8 +18,8 @@ describe 'RSpec projects without Allure' do
         expect(File).not_to exist(File.join(project_name, 'allure-results'))
       end
 
-      it 'pins raider_reporter 0.12' do
-        expect(read_generated(project_name, 'Gemfile')).to include("gem 'raider_reporter', '~> 0.12'")
+      it 'pins raider_reporter 1.0' do
+        expect(read_generated(project_name, 'Gemfile')).to include("gem 'raider_reporter', '~> 1.0'")
       end
     end
   end

data/spec/integration/content/rubocop_content_spec.rb

@@ -6,7 +6,7 @@ require 'stringio'
 require 'tmpdir'
 require_relative 'content_helper'
 
-RUBOCOP_WEB_AUTOMATIONS = %w[selenium watir].freeze
+RUBOCOP_WEB_AUTOMATIONS = %w[selenium].freeze
 
 # Every generated project must pass the RuboCop it ships: its own .rubocop.yml, run in-process with
 # this gem's bundle. The project is linted from a copy outside this repo, so RuboCop resolves the

data/spec/integration/content/syntax_validation_spec.rb

@@ -38,8 +38,8 @@ describe 'Ruby syntax validation' do
     end
 
     SYNTAX_MOBILE_AUTOMATIONS.each do |automation|
-      it "#{framework}_#{automation} wait_helper has the mobile gestures and no web-only methods" do
-        content = File.read(File.join(ensure_project(framework:, automation:), 'helpers/wait_helper.rb'))
+      it "#{framework}_#{automation} gesture_helper has the mobile gestures and no web-only methods" do
+        content = File.read(File.join(ensure_project(framework:, automation:), 'helpers/gesture_helper.rb'))
         expect(content).to include("'mobile: swipeGesture'").and include('def scroll_to(')
         expect(content).not_to include('def drag_and_drop(')
       end