ruby_raider 3.0.0 → 3.1.0

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

@@ -4,9 +4,7 @@ require_relative '../helpers/spec_helper'
 
 describe 'Accessibility' do
   before do
-    <% if capybara? -%>
-visit '/'
-    <% elsif watir? -%>
+    <% if watir? -%>
 browser.goto 'https://raider-test-site.onrender.com/'
     <% else -%>
 driver.get 'https://raider-test-site.onrender.com/'
@@ -14,9 +12,7 @@ driver.get 'https://raider-test-site.onrender.com/'
   end
 
   it 'has no accessibility violations on the page' do
-    <% if capybara? -%>
-expect(page).to be_axe_clean
-    <% elsif watir? -%>
+    <% if watir? -%>
 expect(browser.driver).to be_axe_clean
     <% else -%>
 expect(driver).to be_axe_clean

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

@@ -1,4 +1,4 @@
-<%- if selenium_based? || watir? || capybara? -%>
+<%- if selenium_based? || watir? -%>
 # frozen_string_literal: true
 
 require_relative '../helpers/spec_helper'
@@ -10,16 +10,15 @@ require_relative '../page_objects/pages/login'
 # require 'debug'    # Ruby's built-in debugger (binding.break)
 # require 'pry'      # Pry debugger (binding.pry)
 
-<%- if selenium_based? || watir? || capybara? -%>
 describe 'Login' do
   subject(:header) { account_page.header.customer_name }
 
   let(:user) { ModelFactory.for('users')['registered user'] }
-  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 -%> }
+  let(:login_page) { <% if watir? -%>Login.new(browser)<% else -%>Login.new(driver)<% end -%> }
+  let(:account_page) { <% if watir? -%>Account.new(browser)<% else -%>Account.new(driver)<% end -%> }
 
   before do
-    login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
+    login_page.visit
     login_page.login(user['username'], password)
   end
 
@@ -28,7 +27,7 @@ describe 'Login' do
 
     it 'can successfully log in' do
       # binding.break  # Uncomment to pause here and inspect state
-      account_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
+      account_page.visit
       expect(header).to eq "Welcome back #{user['name']}"
     end
   end
@@ -37,12 +36,11 @@ describe 'Login' do
     let(:password) { 'wrongPassword' }
 
     it 'cannot log in' do
-      login_page.<% if capybara? -%>visit_page<% else -%>visit<% end %>
+      login_page.visit
       expect(header).to eq 'Login or register'
     end
   end
 end
-<%- end -%>
 <%- else -%>
 <% if cross_platform? -%>
 require_relative '../helpers/appium_helper'

data/lib/generators/templates/common/gemfile.tt

@@ -1,37 +1,20 @@
 source 'https://rubygems.org'
 
-ruby '~> <%= ruby_version %>.0'
-
 gem 'activesupport'
 <% if mobile? %>
 gem 'appium_lib'
 gem 'appium_console'
 <% end %>
-<%- if allure_reporter? -%>
 <%- if cucumber? -%>
 gem 'allure-cucumber', '2.28.0'
-<%- elsif minitest? -%>
-gem 'allure-ruby-commons', '2.28.0'
 <%- else -%>
 gem 'allure-rspec', '2.28.0'
 gem 'allure-ruby-commons', '2.28.0'
 <%- end -%>
-<%- end -%>
-<%- if capybara? -%>
-gem 'capybara'
-gem 'selenium-webdriver'
-<%- end -%>
 <%- if axe_addon? -%>
-<%- if minitest? -%>
-gem 'axe-core-minitest'
-<%- else -%>
 gem 'axe-core-rspec'
-<%- end -%>
 gem 'axe-core-selenium'
 <%- end -%>
-<%- if visual_addon? -%>
-gem 'chunky_png'
-<%- end -%>
 gem 'parallel_split_test'
 gem 'parallel_tests'
 gem 'rake'
@@ -39,23 +22,14 @@ gem 'reek'
 <%- if rspec? -%>
 gem 'rspec-retry'
 <%- end -%>
-<%- if junit_reporter? && rspec? -%>
-gem 'rspec_junit_formatter'
-<%- end -%>
 gem '<%= framework %>'
 <%- if cucumber? -%>
 gem 'rspec'
 <%- end -%>
-<%- if minitest? -%>
-gem 'minitest-reporters'
-<%- end -%>
 gem 'rubocop'
 <%- if rspec? -%>
 gem 'rubocop-rspec'
 <%- end -%>
-<%- if minitest? -%>
-gem 'rubocop-minitest'
-<%- end -%>
 gem 'ruby_raider', '~> 1.1.0'
 <%- if selenium_based? %>
 gem 'selenium-webdriver'

data/lib/generators/templates/common/git_ignore.tt

@@ -1,6 +1,4 @@
-<%- if allure_reporter? -%>
 allure-results
-<%- end -%>
 <%- if rspec? -%>
 spec/examples.txt
 <%- end -%>

data/lib/generators/templates/common/partials/mobile_config.tt

@@ -1,5 +1 @@
 platform: :ios
-
-video:
-  enabled: false
-  strategy: auto # auto, appium, or screen

data/lib/generators/templates/common/partials/web_config.tt

@@ -15,10 +15,6 @@ browser_arguments:
     - acceptInsecureCerts
     - no-sandbox
 
-video:
-  enabled: false
-  strategy: auto # auto, cdp, or screen
-
 debug:
   enabled: false        # also toggled by DEBUG=true env var
   console_logs: true    # capture browser console logs on failure

data/lib/generators/templates/common/rakefile.tt

@@ -28,13 +28,4 @@ Cucumber::Rake::Task.new(:regression) do |t|
 end
 
 task default: :features
-<%- elsif minitest? -%>
-
-require 'rake/testtask'
-
-Rake::TestTask.new(:test) do |t|
-  t.test_files = FileList['test/**/test_*.rb']
-end
-
-task default: :test
 <%- end -%>

data/lib/generators/templates/common/read_me.tt

@@ -31,16 +31,11 @@ Ruby Raider is a generator and scaffolding gem to make UI test automation easier
 | RSpec and Selenium    | RSpec and Appium for iOS           |
 | Cucumber and Watir    | Cucumber and Appium for Android    |
 | RSpec and Watir       | RSpec and Appium for Android       |
-| Cucumber and Capybara | Cucumber and Appium Cross-platform |
-| RSpec and Capybara    | RSpec and Appium Cross-platform    |
-| Minitest and Selenium | Minitest and Appium for iOS        |
-| Minitest and Watir    | Minitest and Appium for Android    |
-| Minitest and Capybara | Minitest and Appium Cross-platform |
+|                       | Cucumber and Appium Cross-platform |
+|                       | RSpec and Appium Cross-platform    |
 
-**Optional add-ons for web projects:**
+**Optional add-on for web projects:**
 - **Accessibility testing (axe)**: `--accessibility` flag
-- **Visual regression testing (chunky_png)**: `--visual` flag
-- **Performance auditing (Lighthouse)**: `--performance` flag
 
 ***The web tests run against the [Raider Test Store](https://raider-test-site.onrender.com/).***
 
@@ -70,13 +65,12 @@ raider new [name_of_project] -p framework:[framework] automation:[automation_typ
 ```
 raider generate         # Scaffolding commands
 raider utility          # Utility commands
-raider plugin_manager   # Plugin management
 raider new [NAME]       # Create new project
 raider version          # Show version
 raider help [COMMAND]   # Describe commands
 ```
 
-Shortcuts: `g` (generate), `n` (new), `u` (utility), `v` (version), `pm` (plugin_manager)
+Shortcuts: `g` (generate), `n` (new), `u` (utility), `v` (version)
 
 ### Scaffolding
 

data/lib/generators/templates/helpers/allure_helper.tt

@@ -22,16 +22,6 @@ module AllureHelper
        )
      end
 
-    def add_video(name, file)
-      return unless file && File.exist?(file)
-
-      Allure.add_attachment(
-        name: "Recording: #{name}",
-        source: File.new(file),
-        type: 'video/mp4',
-        test_case: true
-      )
-    end
   <%- if rspec? -%>
 
     def formatter

data/lib/generators/templates/helpers/browser_helper.tt

@@ -20,7 +20,7 @@ module BrowserHelper
     Watir.default_timeout = config.fetch('timeout', 10)
     browser_name = config['browser'].to_s
     args = args.empty? ? config['browser_arguments'][browser_name] : args
-    args += ['--headless'] if ENV['HEADLESS'] && !args.include?('--headless')
+    args += ['--headless'] if (ENV['HEADLESS'] || config['headless']) && !args.include?('--headless')
     capitalized = browser_name == 'ie' ? browser_name.upcase : browser_name.capitalize
     browser_options = "Selenium::WebDriver::#{capitalized}::Options".constantize.new(args:)
     debug_cfg = config['debug'] || {}

data/lib/generators/templates/helpers/partials/debug_diagnostics.tt

@@ -1,6 +1,4 @@
-<% if capybara? %>
-  DebugHelper.capture_failure_diagnostics(Capybara.current_session.driver, example_name, exception: @_exception)
-<% elsif selenium_based? %>
+<% if selenium_based? %>
   DebugHelper.capture_failure_diagnostics(driver, example_name, exception: @_exception)
 <% elsif watir? %>
   DebugHelper.capture_failure_diagnostics(browser, example_name, exception: @_exception)

data/lib/generators/templates/helpers/partials/debug_start.tt

@@ -1,6 +1,4 @@
-<% if capybara? %>
-  DebugHelper.enable_network_logging(Capybara.current_session.driver)
-<% elsif selenium_based? %>
+<% if selenium_based? %>
   DebugHelper.enable_network_logging(driver)
 <% elsif watir? %>
   DebugHelper.enable_network_logging(browser)

data/lib/generators/templates/helpers/partials/quit_driver.tt

@@ -1,6 +1,4 @@
-<% if capybara? %>
-  Capybara.reset_sessions!
-<% elsif selenium_based? %>
+<% if selenium_based? %>
   driver.quit
 <% elsif watir? %>
   browser.quit

data/lib/generators/templates/helpers/partials/screenshot.tt

@@ -1,6 +1,4 @@
-<% if capybara? %>
-  screenshot = Capybara.page.save_screenshot("#{temp_folder}/#{example_name}.png")
-<% elsif selenium_based? %>
+<% if selenium_based? %>
   screenshot = driver.save_screenshot("#{temp_folder}/#{example_name}.png")
 <% elsif watir? %>
   screenshot = browser.screenshot.save("#{temp_folder}/#{example_name}.png")

data/lib/generators/templates/helpers/partials/selenium_driver.tt

@@ -8,7 +8,7 @@
 
   def browser_arguments(*opts)
     args = opts.empty? ? @config['browser_arguments'][@config['browser']] : opts
-    args += ['--headless'] if ENV['HEADLESS'] && !args.include?('--headless')
+    args += ['--headless'] if (ENV['HEADLESS'] || @config['headless']) && !args.include?('--headless')
     args
   end
 

data/lib/generators/templates/helpers/spec_helper.tt

@@ -6,16 +6,9 @@ require 'axe-rspec'
 require 'rspec'
 require 'rspec/retry'
 require 'tmpdir'
-<%- if allure_reporter? -%>
 require_relative 'allure_helper'
-<%- end -%>
-<%- unless skip_video? -%>
-require_relative 'video_helper'
-<%- end -%>
 require_relative 'debug_helper'
-<%- if capybara? -%>
-require_relative 'capybara_helper'
-<%- elsif watir? -%>
+<%- if watir? -%>
 require_relative 'browser_helper'
 <%- else -%>
 require_relative 'driver_helper'
@@ -23,27 +16,14 @@ require_relative 'driver_helper'
 
 module SpecHelper
 
-  <%- if allure_reporter? -%>
   AllureHelper.configure
-  <%- end -%>
   RSpec.configure do |config|
     config.example_status_persistence_file_path = 'spec/examples.txt'
     config.verbose_retry = true
     config.display_try_failure_messages = true
     config.default_retry_count = ENV.fetch('RETRY_COUNT', 0).to_i
-    <%- if allure_reporter? -%>
     config.formatter = AllureHelper.formatter
-    <%- end -%>
-    <%- if junit_reporter? -%>
-    config.add_formatter('RspecJunitFormatter', 'results/junit.xml')
-    <%- end -%>
-    <%- if json_reporter? -%>
-    config.add_formatter('json', 'results/results.json')
-    <%- end -%>
-    <%- if capybara? -%>
-    config.include(Capybara::DSL)
-    CapybaraHelper.configure
-    <%- elsif watir? -%>
+    <%- if watir? -%>
     config.include(BrowserHelper)
     <%- else -%>
     config.include(DriverHelper)
@@ -51,14 +31,6 @@ module SpecHelper
     <%- if mobile? -%>
     config.before(:each) do
       driver.start_driver
-    <%- elsif capybara? -%>
-    config.before(:each) do
-      viewport = YAML.load_file('config/config.yml')['viewport']
-      if viewport
-        Capybara.current_session.driver.browser.manage.window.resize_to(viewport['width'], viewport['height'])
-      else
-        Capybara.current_session.driver.browser.manage.window.maximize
-      end
     <%- elsif selenium_based? -%>
     config.before(:each) do
       viewport = YAML.load_file('config/config.yml')['viewport']
@@ -76,10 +48,6 @@ module SpecHelper
         browser.window.maximize
       end
     <%- end -%>
-      <%- unless skip_video? -%>
-      <%= partial('video_start', strip: true) %>
-      @video_recorder&.start(self.class.description)
-      <%- end -%>
       <%= partial('debug_start', strip: true) %>
       @debug_action_logger = DebugHelper.action_logger_for(self.class.description)
     end
@@ -91,14 +59,9 @@ module SpecHelper
         <%= partial('debug_diagnostics', strip: true) %>
       end
       @debug_action_logger&.close
-      <%- unless skip_video? -%>
-      <%= partial('video_stop', strip: true) %>
-      <%- end -%>
       Dir.mktmpdir do |temp_folder|
         <%= partial('screenshot', strip: true) %>
-        <%- if allure_reporter? -%>
         AllureHelper.add_screenshot(example_name, screenshot)
-        <%- end -%>
       end
       <%= partial('quit_driver', strip: true) %>
     end

data/lib/ruby_raider.rb

@@ -3,47 +3,20 @@
 require 'thor'
 
 # Lazy-load top-level command classes to reduce CLI startup time.
-autoload :AdoptCommands, File.expand_path('commands/adopt_commands', __dir__)
 autoload :ScaffoldingCommands, File.expand_path('commands/scaffolding_commands', __dir__)
 autoload :UtilityCommands, File.expand_path('commands/utility_commands', __dir__)
 
 module RubyRaider
-  # Lazy-load namespaced classes within the correct module scope.
-  autoload :Plugin, File.expand_path('plugin/plugin', __dir__)
-  autoload :PluginCommands, File.expand_path('commands/plugin_commands', __dir__)
-  autoload :LoadedCommands, File.expand_path('commands/loaded_commands', __dir__)
-
   class Raider < Thor
     no_tasks do
-      def self.plugin_commands?
-        @plugin_commands ||= File.read(
-          File.expand_path('commands/loaded_commands.rb', __dir__)
-        ).include?('subcommand')
-      end
-
       def current_version = File.read(File.expand_path('version', __dir__)).strip
     end
 
     desc 'new [PROJECT_NAME]', 'Creates a new framework based on settings picked'
     option :parameters,
            type: :hash, required: false, desc: 'Parameters to avoid using the menu', aliases: 'p'
-    option :skip_ci,
-           type: :boolean, required: false, desc: 'Skip CI/CD configuration generation'
-    option :skip_allure,
-           type: :boolean, required: false, desc: 'Skip Allure reporting setup'
-    option :skip_video,
-           type: :boolean, required: false, desc: 'Skip video recording setup'
-    option :reporter,
-           type: :string, required: false, desc: 'Reporter: allure, junit, json, both, all, none', aliases: '-r'
     option :accessibility,
            type: :boolean, required: false, desc: 'Add axe accessibility testing'
-    option :visual,
-           type: :boolean, required: false, desc: 'Add visual regression testing'
-    option :performance,
-           type: :boolean, required: false, desc: 'Add Lighthouse performance auditing'
-    option :ruby_version,
-           type: :string, required: false, desc: 'Ruby version for generated project (e.g. 3.4, 3.3)'
-
     def new(project_name)
       require_relative 'utilities/logo'
       RubyRaider::Logo.display
@@ -51,7 +24,7 @@ module RubyRaider
       if params
         params[:name] = project_name
         parsed_hash = params.transform_keys(&:to_sym)
-        merge_skip_flags(parsed_hash)
+        merge_flags(parsed_hash)
         return InvokeGenerators.generate_framework(parsed_hash)
       end
 
@@ -68,10 +41,6 @@ module RubyRaider
 
     map 'v' => 'version'
 
-    desc 'adopt', 'Adopts an existing test project into Ruby Raider conventions'
-    subcommand 'adopt', AdoptCommands
-    map 'a' => 'adopt'
-
     desc 'generate', 'Provides access to all the scaffolding commands'
     subcommand 'generate', ScaffoldingCommands
     map 'g' => 'generate'
@@ -80,26 +49,9 @@ module RubyRaider
     subcommand 'utility', UtilityCommands
     map 'u' => 'utility'
 
-    desc 'plugin_manager', 'Provides access to all the commands to manager your plugins'
-    subcommand 'plugin_manager', PluginCommands
-    map 'pm' => 'plugin_manager'
-
-    if plugin_commands?
-      desc 'plugins', 'loaded plugin commands'
-      subcommand 'plugins', LoadedCommands
-      map 'ps' => 'plugins'
-    end
-
     no_tasks do
-      def merge_skip_flags(params)
-        %i[skip_ci skip_allure skip_video].each do |flag|
-          params[flag] = true if options[flag]
-        end
-        params[:reporter] = options[:reporter] if options[:reporter]
+      def merge_flags(params)
         params[:accessibility] = true if options[:accessibility]
-        params[:visual] = true if options[:visual]
-        params[:performance] = true if options[:performance]
-        params[:ruby_version] = options[:ruby_version] if options[:ruby_version]
       end
     end
   end

data/lib/scaffolding/project_detector.rb

@@ -1,8 +1,9 @@
 # frozen_string_literal: true
 
+require 'yaml'
+
 module ScaffoldProjectDetector
   AUTOMATION_GEMS = {
-    'capybara' => 'capybara',
     'watir' => 'watir',
     'selenium-webdriver' => 'selenium',
     'appium_lib' => 'appium',
@@ -13,10 +14,13 @@ module ScaffoldProjectDetector
 
   FRAMEWORK_GEMS = {
     'rspec' => 'rspec',
-    'cucumber' => 'cucumber',
-    'minitest' => 'minitest'
+    'cucumber' => 'cucumber'
   }.freeze
 
+  CONFIG_PATH = 'config/config.yml'
+
+  class Error < StandardError; end
+
   module_function
 
   def detect
@@ -25,8 +29,7 @@ module ScaffoldProjectDetector
       automation: detect_automation(gemfile),
       framework: detect_framework(gemfile),
       has_spec: Dir.exist?('spec'),
-      has_features: Dir.exist?('features'),
-      has_test: Dir.exist?('test')
+      has_features: Dir.exist?('features')
     }
   end
 
@@ -54,19 +57,33 @@ module ScaffoldProjectDetector
     detect_automation == 'selenium'
   end
 
-  def capybara?
-    detect_automation == 'capybara'
-  end
-
   def watir?
     detect_automation == 'watir'
   end
 
+  # Validates that the current directory looks like a Ruby Raider project.
+  # Returns an array of warning messages (empty = valid project).
+  def validate_project
+    warnings = []
+    warnings << 'Gemfile not found. Are you in a Ruby Raider project directory?' unless File.exist?('Gemfile')
+    unless File.exist?(CONFIG_PATH)
+      warnings << "#{CONFIG_PATH} not found. Scaffolded pages won't include URL navigation methods."
+    end
+    warnings
+  end
+
+  # Loads and parses config/config.yml. Returns a hash.
+  # Raises ScaffoldProjectDetector::Error on malformed YAML.
   def config
-    return {} unless File.exist?('config/config.yml')
+    return {} unless File.exist?(CONFIG_PATH)
+
+    YAML.safe_load(File.read(CONFIG_PATH), permitted_classes: [Symbol]) || {}
+  rescue Psych::SyntaxError => e
+    raise Error, "#{CONFIG_PATH} has invalid YAML syntax: #{e.message}"
+  end
 
-    YAML.safe_load(File.read('config/config.yml'), permitted_classes: [Symbol]) || {}
-  rescue StandardError
-    {}
+  # Returns the custom path for a scaffold type from config, or nil.
+  def config_path(type)
+    config["#{type}_path"]
   end
 end