ruby_raider 1.1.4 → 2.0.0

data/lib/generators/infrastructure/templates/github_appium.tt

@@ -0,0 +1,108 @@
+name: Appium Tests
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+<%- if ios? || cross_platform? -%>
+  ios-tests:
+    runs-on: macos-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.4.0
+          bundler-cache: true
+
+      - name: Download iOS app
+        uses: dawidd6/action-download-artifact@v6
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          repo: RaiderHQ/raider_test_app
+          workflow: build-ios.yml
+          name: raider-test-app-ios
+          path: apps/
+
+      - name: Unzip iOS app
+        run: |
+          cd apps
+          unzip RaiderTestApp.app.zip
+
+      - name: Start iOS Simulator
+        uses: futureware-tech/simulator-action@v3
+        with:
+          model: 'iPhone 15'
+          os_version: '17'
+
+      - name: Install and start Appium
+        run: |
+          npm install -g appium
+          appium driver install xcuitest
+          appium &
+          sleep 5
+
+      - name: Run tests
+<%- if cucumber? -%>
+        run: bundle exec cucumber features/ --format pretty
+<%- elsif minitest? -%>
+        run: bundle exec ruby -Itest test/test_pdp_page.rb
+<%- else -%>
+        run: bundle exec rspec spec/ --format documentation
+<%- end -%>
+        env:
+          APP_PATH: ${{ github.workspace }}/apps/RaiderTestApp.app
+<%- end -%>
+
+<%- if android? || cross_platform? -%>
+  android-tests:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.4.0
+          bundler-cache: true
+
+      - name: Download Android app
+        uses: dawidd6/action-download-artifact@v6
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          repo: RaiderHQ/raider_test_app
+          workflow: build-android.yml
+          name: raider-test-app-android
+          path: apps/
+
+      - name: Set up JDK 17
+        uses: actions/setup-java@v4
+        with:
+          java-version: '17'
+          distribution: 'temurin'
+
+      - name: Install and start Appium
+        run: |
+          npm install -g appium
+          appium driver install uiautomator2
+          appium &
+          sleep 5
+
+      - name: Run Android Emulator and Tests
+        uses: reactivecircus/android-emulator-runner@v2
+        with:
+          api-level: 34
+          target: google_apis
+          arch: x86_64
+          profile: pixel_8
+          script: |
+<%- if cucumber? -%>
+            bundle exec cucumber features/ --format pretty
+<%- elsif minitest? -%>
+            bundle exec ruby -Itest test/test_pdp_page.rb
+<%- else -%>
+            bundle exec rspec spec/ --format documentation
+<%- end -%>
+        env:
+          APP_PATH: ${{ github.workspace }}/apps/app-release.apk
+<%- end -%>

data/lib/generators/infrastructure/templates/gitlab.tt

@@ -5,6 +5,7 @@ stages:
 
 variables:
   RUBY_VERSION: "3.4.0"
+  HEADLESS: "true"
 
 setup_ruby:
   stage: setup
@@ -18,9 +19,11 @@ setup_ruby:
 run_tests:
   stage: test
   image: ruby:${RUBY_VERSION}
-  script:
+  before_script:
+    - apt-get update -qq && apt-get install -y -qq chromium chromium-driver
     - mkdir -p allure-results
-    - <%- if framework == 'cucumber' -%> cucumber features --format pretty <%- else -%> bundle exec rspec spec --format documentation <%- end%>
+  script:
+    - <%- if framework == 'cucumber' -%>bundle exec cucumber features --format pretty<%- elsif minitest? -%>bundle exec ruby -Itest test/test_login_page.rb<%- else -%>bundle exec rspec spec --format documentation<%- end %>
   artifacts:
     paths:
       - allure-results/

data/lib/generators/invoke_generators.rb

@@ -4,6 +4,7 @@ require_relative 'automation/automation_generator'
 require_relative 'common_generator'
 require_relative 'cucumber/cucumber_generator'
 require_relative 'helper_generator'
+require_relative 'minitest/minitest_generator'
 require_relative 'rspec/rspec_generator'
 
 # :reek:FeatureEnvy { enabled: false }

data/lib/generators/menu_generator.rb

@@ -53,6 +53,7 @@ class MenuGenerator
     prompt.select('Please select your test framework') do |menu|
       menu.choice :Cucumber, -> { select_ci_platform('Cucumber', automation) }
       menu.choice :Rspec, -> { select_ci_platform('Rspec', automation) }
+      menu.choice :Minitest, -> { select_ci_platform('Minitest', automation) }
       menu.choice :Quit, -> { exit }
     end
   end
@@ -92,6 +93,7 @@ class MenuGenerator
 
   def automation_options(menu)
     menu.choice :Selenium, -> { choose_test_framework('selenium') }
+    menu.choice :Capybara, -> { choose_test_framework('capybara') }
     menu.choice :Appium, -> { choose_test_framework('appium') }
     menu.choice :Watir, -> { choose_test_framework('watir') }
     menu.choice :Applitools, -> { choose_test_framework('applitools') }

data/lib/generators/minitest/minitest_generator.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+require_relative '../generator'
+
+class MinitestGenerator < Generator
+  def generate_login_test
+    return unless web? && !visual?
+
+    template('test.tt', "#{name}/test/test_login_page.rb")
+  end
+
+  def generate_pdp_test
+    return unless mobile?
+
+    template('test.tt', "#{name}/test/test_pdp_page.rb")
+  end
+
+  def generate_account_test
+    return unless visual?
+
+    template('test.tt', "#{name}/test/test_account_page.rb")
+  end
+end

data/lib/generators/minitest/templates/test.tt

@@ -0,0 +1,93 @@
+<%- if selenium_based? || watir? || capybara? -%>
+# frozen_string_literal: true
+
+require_relative '../helpers/test_helper'
+require_relative '../models/model_factory'
+require_relative '../page_objects/pages/account'
+require_relative '../page_objects/pages/login'
+
+<%- if axe? %>
+class TestLogin < Minitest::Test
+  def setup
+    @login = Login.new(driver)
+    @account = Account.new(driver)
+    @user = ModelFactory.for('users')['registered user']
+    @login.visit
+    @login.log_as(@user['username'], @user['password'])
+  end
+
+  def teardown
+    driver.quit
+  end
+
+  def test_no_accessibility_errors_on_page
+    assert_axe_clean @account.page
+  end
+
+  def test_no_accessibility_errors_on_transaction_history
+    assert_axe_clean @account.page, within: '.account-card'
+  end
+
+  def test_no_accessibility_errors_on_heading
+    assert_axe_clean @account.page, within: '.page-title'
+  end
+end
+<%- elsif selenium_based? || watir? || capybara? -%>
+class TestLogin < Minitest::Test
+  def setup
+    @user = ModelFactory.for('users')['registered user']
+    @login_page = <% if capybara? -%>Login.new<% elsif watir? -%>Login.new(browser)<% else -%>Login.new(driver)<% end %>
+    @account_page = <% if capybara? -%>Account.new<% elsif watir? -%>Account.new(browser)<% else -%>Account.new(driver)<% end %>
+  end
+
+  def teardown
+    <%= partial('quit_driver', strip: true) %>
+  end
+
+  def test_login_with_right_credentials
+    @login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
+    @login_page.login(@user['username'], @user['password'])
+  <%- if visual? -%>
+    check_page @account_page
+  <%- else -%>
+    @account_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
+    assert_equal "Welcome back #{@user['name']}", @account_page.header.customer_name
+  <%- end -%>
+  end
+
+  def test_login_with_wrong_credentials
+    @login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
+    @login_page.login(@user['username'], 'wrongPassword')
+  <%- if visual? -%>
+    check_page @login_page
+  <%- else -%>
+    @login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
+    assert_equal 'Login or register', @account_page.header.customer_name
+  <%- end -%>
+  end
+end
+<%- end -%>
+<%- else -%>
+<% if cross_platform? -%>
+require_relative '../helpers/appium_helper'
+<%- end -%>
+require_relative '../helpers/test_helper'
+require_relative '../page_objects/pages/home'
+require_relative '../page_objects/pages/pdp'
+
+class TestPdp < Minitest::Test
+  def setup
+    @home_page = Home.new(driver)
+    @pdp_page = Pdp.new(driver)
+  end
+
+  def teardown
+    driver.quit_driver
+  end
+
+  def test_shows_add_to_cart_button
+    @home_page.go_to_product_detail
+    assert_equal 'Add to Cart', @pdp_page.add_to_cart_text
+  end
+end
+<%- end -%>

data/lib/generators/rspec/templates/spec.tt

@@ -1,4 +1,4 @@
-<%- if selenium_based? || watir? -%>
+<%- if selenium_based? || watir? || capybara? -%>
 # frozen_string_literal: true
 
 require_relative '../helpers/spec_helper'
@@ -23,26 +23,26 @@ describe 'Login' do
     end
 
     it 'no accessibility errors are present on the transaction history' do
-      transaction_history = '.dash-tile.dash-tile-balloon.clearfix'
-      expect(account.page).to be_axe_clean.within transaction_history
+      account_details = '.account-card'
+      expect(account.page).to be_axe_clean.within account_details
     end
 
     it 'no accessibility errors are present on the heading' do
-      heading = '.maintext'
+      heading = '.page-title'
       expect(account.page).to be_axe_clean.within heading
     end
   end
 end
-<%- elsif selenium_based? || watir? -%>
+<%- elsif selenium_based? || watir? || capybara? -%>
 describe 'Login' do
   subject(:header) { account_page.header.customer_name }
 
   let(:user) { ModelFactory.for('users')['registered user'] }
-  let(:login_page) { Login.new(<% if watir? -%>browser<% else -%>driver<% end -%>) }
-  let(:account_page) { Account.new(<% if watir? -%>browser<% else -%>driver<% end -%>) }
+  let(:login_page) { <% if capybara? -%>Login.new<% elsif watir? -%>Login.new(browser)<% else -%>Login.new(driver)<% end -%> }
+  let(:account_page) { <% if capybara? -%>Account.new<% elsif watir? -%>Account.new(browser)<% else -%>Account.new(driver)<% end -%> }
 
   before do
-    login_page.visit
+    login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
     login_page.login(user['username'], password)
   end
 
@@ -53,6 +53,7 @@ describe 'Login' do
     <%- if visual? -%>
       check_page account_page
     <%- else -%>
+      account_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
       expect(header).to eq "Welcome back #{user['name']}"
     <%- end -%>
     end
@@ -65,6 +66,7 @@ describe 'Login' do
     <%- if visual? -%>
       check_page login_page
     <%- else -%>
+      login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
       expect(header).to eq 'Login or register'
     <%- end -%>
     end
@@ -86,8 +88,8 @@ class PdpSpec
     let(:pdp_page) { Pdp.new(driver) }
 
     it 'shows add to cart button' do
-      home_page.go_to_backpack_pdp
-      expect(pdp_page.add_to_cart_text).to eq 'Add To Cart'
+      home_page.go_to_product_detail
+      expect(pdp_page.add_to_cart_text).to eq 'Add to Cart'
     end
   end
 end

data/lib/generators/template_renderer/partial_cache.rb

@@ -0,0 +1,116 @@
+# frozen_string_literal: true
+
+require 'erb'
+require_relative 'partial_resolver'
+require_relative 'template_error'
+
+module TemplateRenderer
+  # Caches compiled ERB template objects with mtime-based invalidation
+  #
+  # Cache structure:
+  #   cache_key => { erb: ERB_object, mtime: Time, path: String }
+  #
+  # Cache keys include trim_mode to support different whitespace handling:
+  #   "screenshot:-" => ERB object with trim_mode: '-'
+  #   "screenshot:" => ERB object with no trim_mode
+  #
+  # Performance: ~10x speedup on cached renders (135ms → ~13.5ms)
+  class PartialCache
+    def initialize(generator_class)
+      @cache = {}
+      @resolver = PartialResolver.new(generator_class)
+    end
+
+    # Render a partial with caching
+    #
+    # @param name [String] Partial name (without .tt extension)
+    # @param binding [Binding] Binding context for ERB evaluation
+    # @param options [Hash] Rendering options
+    # @option options [String, nil] :trim_mode ERB trim mode ('-', '<>', etc.)
+    # @return [String] Rendered template content
+    # @raise [TemplateNotFoundError] If partial not found
+    # @raise [TemplateRenderError] If rendering fails
+    def render_partial(name, binding, options = {})
+      trim_mode = options[:trim_mode]
+      cache_key = build_cache_key(name, trim_mode)
+
+      # Resolve the partial path
+      path = @resolver.resolve(name, binding)
+
+      # Get from cache or compile
+      erb = get_or_compile(cache_key, path, trim_mode)
+
+      # Render with provided binding
+      erb.result(binding)
+    rescue Errno::ENOENT => e
+      raise TemplateNotFoundError.new(
+        "Partial '#{name}' not found",
+        partial_name: name,
+        searched_paths: @resolver.search_paths(name, binding),
+        original_error: e
+      )
+    rescue TemplateError
+      raise
+    rescue StandardError => e
+      # Catch ERB syntax errors or other rendering issues
+      raise TemplateRenderError.new(
+        e.message,
+        partial_name: name,
+        original_error: e
+      )
+    end
+
+    # Clear the entire cache (useful for testing)
+    def clear
+      @cache.clear
+    end
+
+    # Get cache statistics (useful for debugging/monitoring)
+    def stats
+      {
+        size: @cache.size,
+        entries: @cache.keys,
+        memory_estimate: estimate_cache_size
+      }
+    end
+
+    private
+
+    # Build cache key that includes trim_mode
+    def build_cache_key(name, trim_mode)
+      "#{name}:#{trim_mode}"
+    end
+
+    # Get cached ERB or compile and cache it
+    def get_or_compile(cache_key, path, trim_mode)
+      cached = @cache[cache_key]
+      current_mtime = File.mtime(path)
+
+      # Cache miss or stale cache (file modified)
+      if cached.nil? || cached[:mtime] < current_mtime
+        erb = compile_template(path, trim_mode)
+        @cache[cache_key] = {
+          erb:,
+          mtime: current_mtime,
+          path:
+        }
+        return erb
+      end
+
+      # Cache hit
+      cached[:erb]
+    end
+
+    # Compile an ERB template
+    def compile_template(path, trim_mode)
+      content = File.read(path)
+      ERB.new(content, trim_mode:)
+    end
+
+    # Rough estimate of cache memory usage
+    # Each entry: ~2-10 KB (ERB object + metadata)
+    def estimate_cache_size
+      @cache.size * 5 * 1024 # Rough estimate: 5 KB per entry
+    end
+  end
+end

data/lib/generators/template_renderer/partial_resolver.rb

@@ -0,0 +1,103 @@
+# frozen_string_literal: true
+
+require_relative 'template_error'
+
+module TemplateRenderer
+  # Resolves partial template paths with context-aware searching
+  #
+  # Resolution strategy:
+  # 1. Try relative to calling template: ./partials/{name}.tt
+  # 2. Fall back to all Generator.source_paths searching for partials/{name}.tt
+  class PartialResolver
+    PARTIAL_EXTENSION = '.tt'
+    PARTIALS_DIR = 'partials'
+
+    def initialize(generator_class)
+      @generator_class = generator_class
+    end
+
+    # Resolve a partial name to its absolute file path
+    #
+    # @param name [String] The partial name (without .tt extension)
+    # @param binding [Binding] The binding context from the caller
+    # @return [String] Absolute path to the partial file
+    # @raise [TemplateNotFoundError] If partial cannot be found
+    def resolve(name, binding)
+      caller_file = caller_file_from_binding(binding)
+      partial_filename = "#{name}#{PARTIAL_EXTENSION}"
+
+      # Try relative to caller first
+      if caller_file
+        relative_path = File.join(File.dirname(caller_file), PARTIALS_DIR, partial_filename)
+        return File.expand_path(relative_path) if File.exist?(relative_path)
+      end
+
+      # Fall back to searching all source paths
+      searched = search_source_paths(partial_filename)
+      return searched[:found] if searched[:found]
+
+      # Not found - raise with helpful error
+      raise TemplateNotFoundError.new(
+        "Partial '#{name}' not found",
+        partial_name: name,
+        searched_paths: search_paths(name, binding)
+      )
+    end
+
+    # Get all paths that were searched (for error messages)
+    def search_paths(name, binding)
+      paths = []
+      partial_filename = "#{name}#{PARTIAL_EXTENSION}"
+
+      # Add relative path if available
+      caller_file = caller_file_from_binding(binding)
+      if caller_file
+        relative_path = File.join(File.dirname(caller_file), PARTIALS_DIR, partial_filename)
+        paths << relative_path
+      end
+
+      # Add all source path possibilities (including subdirectories)
+      source_paths.each do |source_path|
+        paths << File.join(source_path, PARTIALS_DIR, partial_filename)
+
+        # Also include subdirectories (e.g., templates/common/partials/, templates/helpers/partials/)
+        Dir.glob(File.join(source_path, '*', PARTIALS_DIR)).each do |subdir|
+          paths << File.join(subdir, partial_filename)
+        end
+      end
+
+      paths
+    end
+
+    private
+
+    # Extract the calling template file from binding context
+    def caller_file_from_binding(binding)
+      binding.eval('__FILE__')
+    rescue StandardError
+      nil
+    end
+
+    # Search all Generator.source_paths for the partial
+    # Checks both source_path/partials/ and source_path/*/partials/
+    def search_source_paths(partial_filename)
+      source_paths.each do |source_path|
+        # First try direct partials directory
+        full_path = File.join(source_path, PARTIALS_DIR, partial_filename)
+        return { found: File.expand_path(full_path), searched: [full_path] } if File.exist?(full_path)
+
+        # Then try subdirectories (e.g., templates/common/partials/, templates/helpers/partials/)
+        Dir.glob(File.join(source_path, '*', PARTIALS_DIR, partial_filename)).each do |path|
+          return { found: File.expand_path(path), searched: [path] } if File.exist?(path)
+        end
+      end
+
+      { found: nil, searched: [] }
+    end
+
+    # Get all configured source paths from the generator class
+    def source_paths
+      @source_paths ||= @generator_class.source_paths || []
+    end
+  end
+end

data/lib/generators/template_renderer/template_error.rb

@@ -0,0 +1,50 @@
+# frozen_string_literal: true
+
+module TemplateRenderer
+  # Base error class for all template-related errors
+  class TemplateError < StandardError
+    attr_reader :partial_name, :searched_paths, :original_error
+
+    def initialize(message, partial_name: nil, searched_paths: nil, original_error: nil)
+      @partial_name = partial_name
+      @searched_paths = searched_paths || []
+      @original_error = original_error
+      super(message)
+    end
+  end
+
+  # Raised when a partial template cannot be found
+  class TemplateNotFoundError < TemplateError
+    def to_s
+      message_parts = ["Partial '#{@partial_name}' not found."]
+
+      if @searched_paths.any?
+        message_parts << "\nSearched in:"
+        message_parts.concat(@searched_paths.map { |path| "  - #{path}" })
+      end
+
+      message_parts.join("\n")
+    end
+  end
+
+  # Raised when a template has syntax errors or rendering fails
+  class TemplateRenderError < TemplateError
+    def initialize(message, partial_name:, original_error: nil)
+      super(message, partial_name:, original_error:)
+    end
+
+    def to_s
+      message_parts = ["Error rendering partial '#{@partial_name}': #{super()}"]
+
+      if @original_error
+        message_parts << "\nOriginal error: #{@original_error.class}: #{@original_error.message}"
+        if @original_error.backtrace
+          message_parts << "\nBacktrace:"
+          message_parts.concat(@original_error.backtrace.first(5).map { |line| "  #{line}" })
+        end
+      end
+
+      message_parts.join("\n")
+    end
+  end
+end