ruby_raider 3.10.0 → 3.12.0

data/spec/integration/content/common_content_spec.rb

@@ -139,6 +139,21 @@ describe 'Common file content' do
     end
   end
 
+  shared_examples 'web gitignore for saved logins' do |project_name|
+    subject(:lines) { read_generated(project_name, '.gitignore').lines.map(&:strip) }
+
+    it 'ignores .raider/auth/ but not the whole .raider/' do
+      expect(lines).to include('.raider/auth/')
+      expect(lines).not_to include('.raider/', '.raider')
+    end
+  end
+
+  shared_examples 'mobile gitignore without saved logins' do |project_name|
+    it 'has no .raider line' do
+      expect(read_generated(project_name, '.gitignore')).not_to include('.raider')
+    end
+  end
+
   # --- Spec helper retry config (C4) ---
 
   shared_examples 'spec helper with retry config' do |project_name|
@@ -207,6 +222,7 @@ describe 'Common file content' do
     it_behaves_like 'rspec gitignore', name
     it_behaves_like 'spec helper with retry config', name
     it_behaves_like 'gemfile with rspec-retry', name
+    it_behaves_like 'web gitignore for saved logins', name
   end
 
   context 'with rspec and watir' do
@@ -217,6 +233,7 @@ describe 'Common file content' do
     it_behaves_like 'rspec gitignore', name
     it_behaves_like 'spec helper with retry config', name
     it_behaves_like 'gemfile with rspec-retry', name
+    it_behaves_like 'web gitignore for saved logins', name
   end
 
   # --- Cucumber contexts ---
@@ -229,6 +246,7 @@ describe 'Common file content' do
     it_behaves_like 'non-rspec gitignore', name
     it_behaves_like 'gemfile without rspec-retry', name
     it_behaves_like 'cucumber config with retry', name
+    it_behaves_like 'web gitignore for saved logins', name
   end
 
   context 'with cucumber and watir' do
@@ -239,5 +257,14 @@ describe 'Common file content' do
     it_behaves_like 'non-rspec gitignore', name
     it_behaves_like 'gemfile without rspec-retry', name
     it_behaves_like 'cucumber config with retry', name
+    it_behaves_like 'web gitignore for saved logins', name
+  end
+
+  %w[android ios cross_platform].each do |automation|
+    %w[rspec cucumber].each do |framework|
+      context "with #{framework} and #{automation}" do
+        it_behaves_like 'mobile gitignore without saved logins', "#{framework}_#{automation}"
+      end
+    end
   end
 end

data/spec/integration/content/config_content_spec.rb

@@ -59,6 +59,13 @@ describe 'Config file content' do
     end
   end
 
+  shared_examples 'login state config' do |project_name|
+    it 'has a login_state max_age of an hour' do
+      config = YAML.safe_load(read_generated(project_name, 'config/config.yml'), permitted_classes: [Symbol])
+      expect(config['login_state']).to eq('max_age' => 3600)
+    end
+  end
+
   # --- Web config per automation ---
 
   context 'with rspec and selenium' do
@@ -66,18 +73,21 @@ describe 'Config file content' do
     include_examples 'valid web config', name
     include_examples 'selenium config with timeout', name
     include_examples 'video config', name
+    include_examples 'login state config', name
   end
 
   context 'with rspec and watir' do
     name = "#{FrameworkIndex::RSPEC}_#{AutomationIndex::WATIR}"
     include_examples 'valid web config', name
     include_examples 'config without driver_options', name
+    include_examples 'login state config', name
   end
 
   context 'with cucumber and selenium' do
     name = "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
     include_examples 'valid web config', name
     include_examples 'selenium config with timeout', name
+    include_examples 'login state config', name
   end
 
   # --- Mobile config ---
@@ -100,4 +110,56 @@ describe 'Config file content' do
       expect(caps).to match(/platformName/i)
     end
   end
+
+  # appium_lib connects to http://127.0.0.1:4723 and ignores a url capability, so none is generated.
+  %w[rspec cucumber].product(%w[android ios cross_platform]).each do |framework, automation|
+    it "has no unused url capability or /wd/hub path in #{framework} #{automation} capabilities" do
+      caps = read_generated("#{framework}_#{automation}", 'config/capabilities.yml')
+      local = caps.split(/^browserstack:/).first
+      expect(local).not_to match(/^\s*url:/)
+      expect(local).not_to include('/wd/hub')
+    end
+
+    it "parses as YAML, BrowserStack block included, in #{framework} #{automation} capabilities" do
+      caps = YAML.safe_load(read_generated("#{framework}_#{automation}", 'config/capabilities.yml'))
+      browserstack = caps.fetch('browserstack')
+      expect(browserstack).to have_key('app')
+      expect(browserstack['app'].to_s).not_to start_with('app:')
+    end
+  end
+
+  %w[android ios cross_platform].each do |automation|
+    it "has no login_state in the #{automation} config" do
+      Dir.glob(File.join("#{FrameworkIndex::RSPEC}_#{automation}", 'config', '*.yml')).each do |file|
+        expect(File.read(file)).not_to include('login_state')
+      end
+    end
+  end
+end
+
+describe 'Config timeout wiring' do
+  %w[rspec cucumber].each do |framework|
+    # Single-platform Appium projects have no config.yml; WaitHelper falls back to its default of 10.
+    %w[selenium cross_platform].each do |automation|
+      it "sets timeout 10 in #{framework} #{automation}" do
+        config = YAML.safe_load(read_generated("#{framework}_#{automation}", 'config/config.yml'), permitted_classes: [Symbol])
+        expect(config['timeout']).to eq(10)
+      end
+    end
+  end
+
+  it 'describes the selenium timeout as an action and eventually wait' do
+    expect(read_generated('rspec_selenium', 'config/config.yml'))
+      .to include('# seconds that actions and eventually wait before failing')
+  end
+
+  it 'describes the mobile timeout as an action and eventually wait' do
+    expect(read_generated('rspec_cross_platform', 'config/config.yml'))
+      .to include('timeout: 10 # seconds that actions and eventually wait before failing')
+  end
+
+  it 'leaves the watir timeout comment unchanged' do
+    expect(read_generated('rspec_watir', 'config/config.yml'))
+      .to include('timeout: 10 # seconds — used for implicit waits and max wait time')
+  end
 end

data/spec/integration/content/cucumber_reporter_content_spec.rb

@@ -83,3 +83,28 @@ describe 'Cucumber raider_reporter wiring' do
     end
   end
 end
+
+describe 'Cucumber login reuse wiring' do
+  { 'selenium' => 'driver', 'watir' => 'browser.driver' }.each do |automation, target|
+    context "with cucumber and #{automation}" do
+      let(:env) { read_generated("#{FrameworkIndex::CUCUMBER}_#{automation}", 'features/support/env.rb') }
+
+      it 'requires session_state' do
+        expect(env).to include("require_relative '../../helpers/session_state'")
+      end
+
+      it "reuses the saved login in Before('@logged_in'), defined after the plain Before" do
+        expect(env).to include("Before('@logged_in') do", "SessionState.new(#{target}).reuse(",
+                               "UserFactory.for('registered user')")
+        expect(env.index("Before('@logged_in')")).to be > env.index(/^Before do/)
+      end
+    end
+  end
+
+  %w[android ios cross_platform].each do |automation|
+    it "does not mention session_state with cucumber and #{automation}" do
+      env = read_generated("#{FrameworkIndex::CUCUMBER}_#{automation}", 'features/support/env.rb')
+      expect(env).not_to include('session_state')
+    end
+  end
+end

data/spec/integration/content/helper_content_spec.rb

@@ -365,4 +365,115 @@ describe 'Helper file content' do
       end
     end
   end
+
+  # --- Opt-in login reuse ---
+
+  { 'selenium' => 'driver', 'watir' => 'browser.driver' }.each do |automation, target|
+    context "with rspec and #{automation} login reuse" do
+      subject(:helper) { read_generated("#{FrameworkIndex::RSPEC}_#{automation}", 'helpers/spec_helper.rb') }
+
+      it 'requires session_state and opts in through the :logged_in tag' do
+        expect(helper).to include("require_relative 'session_state'", 'config.before(:each, :logged_in)')
+      end
+
+      it 'reuses the saved login for the driver, falling back to the real login' do
+        expect(helper).to include("SessionState.new(#{target}).reuse(")
+        expect(helper).to include("user = ModelFactory.for('users')['registered user']", ".login(user['username'], user['password'])")
+        expect(helper).to include("header.customer_name == \"Welcome back \#{user['name']}\"")
+      end
+
+      it 'requires the models and pages the login needs' do
+        expect(helper).to include("require_relative '../models/model_factory'",
+                                  "require_relative '../page_objects/pages/login'",
+                                  "require_relative '../page_objects/pages/account'")
+      end
+    end
+  end
+
+  %w[android ios cross_platform].each do |automation|
+    context "with rspec and #{automation} without login reuse" do
+      it 'does not mention session_state' do
+        expect(read_generated("#{FrameworkIndex::RSPEC}_#{automation}", 'helpers/spec_helper.rb')).not_to include('session_state')
+      end
+    end
+  end
+end
+
+describe 'Auto-waiting helper wiring' do
+  %w[selenium ios android cross_platform].each do |automation|
+    context "with rspec and #{automation}" do
+      it 'includes WaitHelper in the spec helper' do
+        helper = read_generated("#{FrameworkIndex::RSPEC}_#{automation}", 'helpers/spec_helper.rb')
+        expect(helper).to include("require_relative 'wait_helper'", 'config.include(WaitHelper)')
+      end
+    end
+  end
+
+  %w[ios android cross_platform].each do |automation|
+    %w[rspec cucumber].each do |framework|
+      it "does not pass a wait to appium_lib in #{framework} #{automation}" do
+        driver = read_generated("#{framework}_#{automation}", 'helpers/driver_helper.rb')
+        expect(driver).not_to match(/\bwait:/)
+      end
+    end
+  end
+
+  %w[rspec cucumber].each do |framework|
+    it "returns the new driver without a redundant assignment in #{framework} selenium" do
+      driver = read_generated("#{framework}_selenium", 'helpers/driver_helper.rb')
+      expect(driver).to include("    Selenium::WebDriver.for(browser.to_sym, **arguments)\n  end")
+      expect(driver).not_to include('driver = Selenium::WebDriver.for')
+    end
+
+    it "leaves no implicit wait in #{framework} selenium" do
+      driver = read_generated("#{framework}_selenium", 'helpers/driver_helper.rb')
+      expect(driver).not_to include('implicit_wait')
+    end
+
+    it "keeps Watir untouched in #{framework} watir" do
+      project = "#{framework}_watir"
+      expect(File.exist?(File.join(project, 'helpers/wait_helper.rb'))).to be(false)
+      expect(read_generated(project, 'helpers/browser_helper.rb')).to include('Watir.default_timeout')
+      files = Dir.glob(File.join(project, '**/*.rb')).map { |f| File.read(f) }
+      expect(files.grep(/WaitHelper/)).to be_empty
+    end
+  end
+
+  describe 'without example tests' do
+    %w[selenium ios cross_platform].each do |automation|
+      context "with rspec and #{automation}" do
+        subject(:helper) { read_generated(ensure_project(framework: 'rspec', automation:, examples: false), 'helpers/spec_helper.rb') }
+
+        it 'names no example class or hook' do
+          expect(helper).not_to match(/Login|Account|logged_in|model_factory/)
+        end
+
+        it 'has valid Ruby syntax' do
+          expect(helper).to have_valid_ruby_syntax
+        end
+      end
+
+      context "with cucumber and #{automation}" do
+        let(:name) { ensure_project(framework: 'cucumber', automation:, examples: false) }
+
+        it 'names no example class or hook in the env and the World' do
+          %w[env.rb world.rb].each do |file|
+            expect(read_generated(name, "features/support/#{file}")).not_to match(/Login|Account|logged_in|factory/)
+          end
+        end
+
+        it 'has a valid env and World' do
+          %w[env.rb world.rb].each do |file|
+            expect(read_generated(name, "features/support/#{file}")).to have_valid_ruby_syntax
+          end
+        end
+      end
+    end
+
+    it 'keeps the session state require in the selenium rspec spec helper' do
+      helper = read_generated(ensure_project(framework: 'rspec', automation: 'selenium', examples: false),
+                              'helpers/spec_helper.rb')
+      expect(helper).to include("require_relative 'session_state'")
+    end
+  end
 end

data/spec/integration/content/page_content_spec.rb

@@ -36,12 +36,16 @@ 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 'uses find_element for elements' do
-      expect(login).to include('driver.find_element')
+    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')
     end
 
-    it 'uses send_keys for input' do
-      expect(login).to include('send_keys')
+    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')
     end
 
     it 'has private element methods' do
@@ -167,3 +171,70 @@ describe 'Page object content' do
     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
+        page = read_generated("#{framework}_#{automation}", 'page_objects/abstract/page.rb')
+        expect(page).to include("require_relative '../../helpers/wait_helper'", 'include WaitHelper')
+      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')
+    end
+  end
+end
+
+describe 'Abstract page layout' do
+  %w[rspec cucumber].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
+          page = read_generated(ensure_project(framework:, automation:, examples:), 'page_objects/abstract/page.rb')
+          expect(page).not_to match(/\n\n\s*end\s*\z/)
+        end
+      end
+    end
+  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
+      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')
+    end
+
+    %w[ios android cross_platform].each do |automation|
+      context "with #{framework} and #{automation}" 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')
+        end
+
+        it 'returns locator hashes from the element methods' do
+          if automation == 'cross_platform'
+            expect(home).to include("{ ios: { accessibility_id: 'product-item-1' },")
+            expect(pdp).to include("{ ios: { accessibility_id: 'add-to-cart-button' },")
+            expect(home + pdp).not_to include('element(ios:')
+          else
+            expect(home).to include("{ accessibility_id: 'product-item-1' }")
+            expect(pdp).to include("{ accessibility_id: 'add-to-cart-button' }")
+          end
+        end
+
+        it 'has valid Ruby syntax' do
+          expect(home).to have_valid_ruby_syntax
+          expect(pdp).to have_valid_ruby_syntax
+        end
+      end
+    end
+  end
+end

data/spec/integration/content/readme_content_spec.rb

@@ -112,4 +112,153 @@ describe 'Generated Readme content' do
       end
     end
   end
+
+  FRAMEWORKS.product(AUTOMATION_TYPES).each do |framework, automation|
+    context "with #{framework} and #{automation}, the login reuse section" do
+      subject(:readme) { read_generated("#{framework}_#{automation}", 'Readme.md') }
+
+      if %w[selenium watir].include?(automation)
+        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',
+                                     'RAIDER_LOGIN_STATE=refresh', '.raider/auth/', 'git-ignored',
+                                     'live session tokens', 'must not be committed, cached or uploaded')
+        end
+
+        it 'is its own ## section, straight before Reporting, so Sponsors does not nest under it' do
+          heading = readme.index("\n## Reusing the login\n")
+          expect(heading).not_to be_nil
+          expect(readme[(heading + 1)..][/\n## .*/]).to eq("\n## Reporting")
+          sponsors = readme.index("\n### Sponsors") || readme.size
+          expect(readme[0...sponsors].scan(/\n## .*/).last).not_to eq("\n## Reusing the login")
+        end
+      else
+        it 'does not mention login reuse' do
+          expect(readme).not_to include('Reusing the login', 'RAIDER_LOGIN_STATE', '.raider/auth/')
+        end
+      end
+    end
+  end
+end
+
+describe 'Generated Readme: How the framework works' do
+  def section_of(readme)
+    readme[/^## How the framework works\n.*?(?=^## )/m]
+  end
+
+  FRAMEWORKS.each do |framework|
+    context "with #{framework} and selenium" do
+      subject(:readme) { read_generated("#{framework}_selenium", 'Readme.md') }
+
+      it 'sits between Getting Started and Reusing the login' do
+        works = readme.index("\n## How the framework works\n")
+        expect(works).not_to be_nil
+        expect(readme.index("\n## Getting Started\n")).to be < works
+        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
+        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',
+                                   framework == 'rspec' ? 'RETRY_COUNT' : '--retry 2')
+        expect(section).not_to include('scroll_to', 'swipe')
+      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)')
+      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')
+      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)
+      end
+    end
+
+    %w[ios android cross_platform].each do |automation|
+      context "with #{framework} and #{automation}" do
+        subject(:readme) { read_generated("#{framework}_#{automation}", 'Readme.md') }
+
+        it 'sits between Getting Started and Reporting' do
+          works = readme.index("\n## How the framework works\n")
+          expect(works).not_to be_nil
+          expect(readme.index("\n## Getting Started\n")).to be < works
+          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
+          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('ios: {') if automation == 'cross_platform'
+        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`')
+          expect(settings).to include('under the `ios:` and `android:` parts') if automation == 'cross_platform'
+        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|
+      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')
+        end
+
+        it 'points at no example file' do
+          expect(readme).not_to match(/login\.rb|account\.rb|header\.rb|home\.rb|pdp\.rb|users\.yml|model_factory|
+                                       user_factory|login_page_spec|pdp_page_spec|login\.feature|home\.feature|
+                                       login_steps|home_steps|account\ example|files\ in\ this\ project/x)
+        end
+
+        it 'says it has no example tests and how it grows with scaffolding' do
+          expect(readme).to include('generated without example tests', 'raider g scaffold checkout')
+        end
+      end
+    end
+
+    %w[rspec cucumber].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]
+        hook = framework == 'rspec' ? 'config.before(:each, :logged_in) do' : "Before('@logged_in') do"
+        expect(section).to include(hook, 'SessionState.new(driver).reuse(')
+      end
+    end
+  end
 end

data/spec/integration/content/syntax_validation_spec.rb

@@ -24,6 +24,44 @@ describe 'Ruby syntax validation' do
             expect(content).to have_frozen_string_literal
           end
         end
+
+        login_reuse_files = %w[helpers/session_state.rb]
+        login_reuse_files += if framework == 'rspec'
+                               %w[helpers/spec_helper.rb]
+                             else
+                               %w[features/support/env.rb features/step_definitions/login_steps.rb]
+                             end
+        # The glob above runs at load time, before the projects exist, so new helpers are listed here.
+        login_reuse_files += %w[helpers/wait_helper.rb helpers/raider_element.rb] if automation == 'selenium'
+
+        login_reuse_files.each do |relative|
+          it "#{relative} is generated as valid Ruby with frozen_string_literal" do
+            content = File.read(File.join(project_name, relative))
+            expect(content).to have_valid_ruby_syntax
+            expect(content).to have_frozen_string_literal
+          end
+        end
+      end
+    end
+
+    # Mobile projects get the mobile branch of the wait helper templates.
+    %w[android ios cross_platform].each do |automation|
+      context "with #{framework} and #{automation}" do
+        project_name = "#{framework}_#{automation}"
+
+        %w[helpers/wait_helper.rb helpers/raider_element.rb].each do |relative|
+          it "#{relative} is generated as valid Ruby with frozen_string_literal" do
+            content = File.read(File.join(project_name, relative))
+            expect(content).to have_valid_ruby_syntax
+            expect(content).to have_frozen_string_literal
+          end
+        end
+
+        it 'helpers/wait_helper.rb has the mobile gestures and no web-only methods' do
+          content = File.read(File.join(project_name, 'helpers/wait_helper.rb'))
+          expect(content).to include("'mobile: swipeGesture'").and include('def scroll_to(')
+          expect(content).not_to include('def drag_and_drop(')
+        end
       end
     end
   end