ruby_raider 3.0.0 → 3.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7d6b5fccbc2b3752d7f63391226d903a61a1368a404831ef10b1d0d230774fa5
-  data.tar.gz: 7d4be1564e22cb7bf47e0d08ced4ae00868140bbd0c65833e733a904e634ecf4
+  metadata.gz: ce03b1ba3081d2259a481dc00f40b5bf95e7012784a593b187f3031fd9d0b33b
+  data.tar.gz: d42284c333748033d19c05231fb2da690896793745e93495382cafe1c6ccc4d0
 SHA512:
-  metadata.gz: d9c67f3a57b7bfe7c3426ea0a5220af9b2623d9ce7003c1ebf2052bb19e23125a2f88ee277e89349dece675d13e07833818a93b25dbdbaf2a712dc8661fd0fa3
-  data.tar.gz: 840873be251968d311b86e15586219fe402f433a7cf81f5eccd46e1b8227dfa52c95274099818d4eabf764b015e28cce116bcaac2334ba7e840be6a379a4d6d0
+  metadata.gz: 525f632e44410a8adff2addb4e7d60b2e9e9c8a48294672e2b6689898a0c7d88047ce5c0a908db4197595d2f85dabc2c589b93b75497b3e8df9d4001a7d179d5
+  data.tar.gz: 34862b92a99c1e1a743dbc3c6b4a48a3d0d8ebca5253b7c666078cb5acf957f5c4e7935167aa4556a4a119c03b928264014edda5dd58e357f4665b73f098c056

data/.github/workflows/e2e_tests.yml

@@ -20,23 +20,6 @@ jobs:
       - name: Run content validation tests
         run: bundle exec rspec spec/integration/content/ --format documentation
 
-  e2e-adopt:
-    name: Adopt E2E tests
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.3'
-          bundler-cache: true
-
-      - name: Run adopt system tests
-        run: bundle exec rspec spec/system/adopt_spec.rb --format documentation
-
   command-and-menu-tests:
     name: Command routing and menu tests
     runs-on: ubuntu-latest

data/.github/workflows/system_tests.yml

@@ -59,25 +59,3 @@ jobs:
 
       - name: Run Watir system tests
         run: bundle exec rspec spec/system/watir_spec.rb --format documentation
-
-  capybara:
-    name: Capybara frameworks
-    needs: setup
-    runs-on: ubuntu-latest
-    steps:
-      - name: Checkout repository
-        uses: actions/checkout@v4
-
-      - name: Set up Ruby
-        uses: ruby/setup-ruby@v1
-        with:
-          ruby-version: '3.4'
-          bundler-cache: true
-
-      - name: Set up Chrome
-        uses: browser-actions/setup-chrome@v1
-        with:
-          chrome-version: stable
-
-      - name: Run Capybara system tests
-        run: bundle exec rspec spec/system/capybara_spec.rb --format documentation

data/README.md

@@ -33,11 +33,10 @@ Ruby Raider is a CLI gem and API backend for scaffolding and generating UI test
 
 ### Web Testing
 
-| Test Framework | Selenium | Watir | Capybara |
-|----------------|----------|-------|----------|
-| RSpec          | ✅       | ✅    | ✅       |
-| Cucumber       | ✅       | ✅    | ✅       |
-| Minitest       | ✅       | ✅    | ✅       |
+| Test Framework | Selenium | Watir |
+|----------------|----------|-------|
+| RSpec          | ✅       | ✅    |
+| Cucumber       | ✅       | ✅    |
 
 ### Mobile Testing (Appium)
 
@@ -45,23 +44,14 @@ Ruby Raider is a CLI gem and API backend for scaffolding and generating UI test
 |----------------|-----|---------|----------------|
 | RSpec          | ✅  | ✅      | ✅             |
 | Cucumber       | ✅  | ✅      | ✅             |
-| Minitest       | ✅  | ✅      | ✅             |
 
-### Optional Add-ons (Web Only)
+### Optional Add-on (Web Only)
 
 | Add-on | Flag | Description |
 |--------|------|-------------|
 | Accessibility | `--accessibility` | Adds axe gem + example accessibility tests |
-| Visual Regression | `--visual` | Adds chunky_png + visual comparison helpers |
-| Performance | `--performance` | Adds Lighthouse auditing (requires `npm install -g lighthouse`) |
 
-### CI/CD Platforms
-
-Projects can be generated with built-in CI/CD pipelines for **GitHub Actions** or **GitLab CI/CD**.
-
-### Test Reporters
-
-Choose a reporter with `--reporter`: `allure`, `junit`, `json`, `both`, `all`, or `none`.
+All generated projects include a **GitHub Actions** CI pipeline out of the box.
 
 ***The web tests run against the [Raider Test Store](https://raider-test-site.onrender.com/).***
 
@@ -96,13 +86,7 @@ raider new [project_name] -p framework:rspec automation:selenium
 Add optional features:
 
 ```bash
-raider new my_project -p framework:rspec automation:selenium --accessibility --visual --performance
-```
-
-Skip flags for leaner projects:
-
-```bash
-raider new my_project -p framework:cucumber automation:watir --skip_ci --skip_video --reporter none
+raider new my_project -p framework:rspec automation:selenium --accessibility
 ```
 
 ## Commands
@@ -113,15 +97,13 @@ raider new my_project -p framework:cucumber automation:watir --skip_ci --skip_vi
 
 ```
 raider new [PROJECT_NAME]       # Create a new framework project
-raider adopt                    # Import an existing test project
 raider generate                 # Access scaffolding commands
 raider utility                  # Access utility commands
-raider plugin_manager           # Manage plugins
 raider version                  # Show current version
 raider help [COMMAND]           # Describe available commands
 ```
 
-Shortcuts: `n` (new), `a` (adopt), `g` (generate), `u` (utility), `pm` (plugin_manager), `v` (version)
+Shortcuts: `n` (new), `g` (generate), `u` (utility), `v` (version)
 
 ### Scaffolding Commands
 
@@ -133,18 +115,12 @@ raider g steps [NAME]           # Create step definitions
 raider g helper [NAME]          # Create a helper class
 raider g component [NAME]       # Create a component class
 raider g scaffold [NAME(S)]     # Create page + test + steps
-raider g destroy [NAME(S)]      # Delete scaffolded files
-raider g from_url [URL]         # Generate page & spec from a live URL
 ```
 
 Options:
 
-* `--from [FILE]` — Generate spec from an existing page object
-* `--ai` — Use LLM for intelligent test scenario generation
-* `--dry_run` — Preview files without creating them
 * `--uses [PAGES]` — Specify page dependencies
 * `--path [PATH]` — Custom output path
-* `--crud` — Generate full CRUD scaffold (list, create, detail, edit + tests)
 
 ### Utility Commands
 
@@ -160,38 +136,8 @@ raider u platform [PLATFORM]    # Set platform for cross-platform tests
 raider u debug [on/off]         # Toggle debug mode
 raider u start_appium           # Start Appium server
 raider u desktop                # Download Raider Desktop
-raider u llm [PROVIDER]         # Configure LLM provider (openai, anthropic, ollama)
-```
-
-### Plugin Commands
-
-```
-raider pm add [NAME]            # Add a plugin to your project
-raider pm delete [NAME]         # Remove a plugin
-raider pm list                  # List available plugins
-raider pm local                 # List installed plugins
 ```
 
-### Adopt Command
-
-Import an existing test project into Ruby Raider conventions:
-
-```bash
-raider adopt project [SOURCE_PATH]
-```
-
-## LLM Integration
-
-Ruby Raider supports optional LLM-powered features for intelligent test generation. Configure a provider:
-
-```bash
-raider u llm openai      # Configure OpenAI
-raider u llm anthropic   # Configure Anthropic
-raider u llm ollama      # Configure Ollama (local, no API key needed)
-```
-
-Then use the `--ai` flag with scaffolding commands for smarter code generation.
-
 ## Development
 
 ```bash

data/lib/commands/scaffolding_commands.rb

@@ -2,174 +2,97 @@
 
 require 'thor'
 require 'fileutils'
+require 'pathname'
 require_relative '../generators/menu_generator'
 require_relative '../scaffolding/scaffolding'
 require_relative '../scaffolding/name_normalizer'
-require_relative '../scaffolding/dry_run_presenter'
 require_relative '../scaffolding/project_detector'
 require_relative '../commands/utility_commands'
 
 class ScaffoldingCommands < Thor
-  class_option :dry_run, type: :boolean, default: false,
-                         desc: 'Preview files without creating them', banner: ''
-
   desc 'page [PAGE_NAME]', 'Creates a new page object'
   option :path, type: :string, required: false,
                 desc: 'The path where your page will be created', aliases: '-p'
-  option :delete, type: :boolean, required: false,
-                  desc: 'This will delete the selected page', aliases: '-d'
   option :uses, type: :array, required: false,
                 desc: 'Dependent pages to require', aliases: '-u'
 
   def page(name)
-    return delete_scaffolding(name, 'page') if options[:delete]
-    return dry_run_preview(name, 'page') if options[:dry_run]
-
     generate_scaffolding(name, 'page', options[:path], uses: options[:uses])
   end
 
   desc 'feature [NAME]', 'Creates a new feature'
   option :path, type: :string, required: false,
                 desc: 'The path where your feature will be created', aliases: '-p'
-  option :delete, type: :boolean, required: false,
-                  desc: 'This will delete the selected feature', aliases: '-d'
 
   def feature(name)
-    return delete_scaffolding(name, 'feature') if options[:delete]
-    return dry_run_preview(name, 'feature') if options[:dry_run]
-
     generate_scaffolding(name, 'feature', options[:path])
   end
 
   desc 'spec [SPEC_NAME]', 'Creates a new spec'
   option :path, type: :string, required: false,
                 desc: 'The path where your spec will be created', aliases: '-p'
-  option :delete, type: :boolean, required: false,
-                  desc: 'This will delete the selected spec', aliases: '-d'
-  option :from, type: :string, required: false,
-                desc: 'Generate spec stubs from an existing page object file', aliases: '-f'
   option :uses, type: :array, required: false,
                 desc: 'Dependent pages to require', aliases: '-u'
-  option :ai, type: :boolean, default: false,
-              desc: 'Use LLM to generate meaningful test scenarios'
 
   def spec(name)
-    return delete_scaffolding(name, 'spec') if options[:delete]
-    return dry_run_preview(name, 'spec') if options[:dry_run]
-    return generate_spec_from_page(name, options[:from], ai: options[:ai]) if options[:from]
-
     generate_scaffolding(name, 'spec', options[:path], uses: options[:uses])
   end
 
   desc 'helper [HELPER_NAME]', 'Creates a new helper'
   option :path, type: :string, required: false,
                 desc: 'The path where your helper will be created', aliases: '-p'
-  option :delete, type: :boolean, required: false,
-                  desc: 'This will delete the selected helper', aliases: '-d'
 
   def helper(name)
-    return delete_scaffolding(name, 'helper') if options[:delete]
-    return dry_run_preview(name, 'helper') if options[:dry_run]
-
     generate_scaffolding(name, 'helper', options[:path])
   end
 
   desc 'steps [STEPS_NAME]', 'Creates a new steps definition'
   option :path, type: :string, required: false,
                 desc: 'The path where your steps will be created', aliases: '-p'
-  option :delete, type: :boolean, required: false,
-                  desc: 'This will delete the selected steps', aliases: '-d'
 
   def steps(name)
-    return delete_scaffolding(name, 'steps') if options[:delete]
-    return dry_run_preview(name, 'steps') if options[:dry_run]
-
     generate_scaffolding(name, 'steps', options[:path])
   end
 
   desc 'component [NAME]', 'Creates a component inheriting from Component'
   option :path, type: :string, required: false,
                 desc: 'The path where your component will be created', aliases: '-p'
-  option :delete, type: :boolean, required: false,
-                  desc: 'This will delete the selected component', aliases: '-d'
 
   def component(name)
-    return delete_scaffolding(name, 'component') if options[:delete]
-    return dry_run_preview(name, 'component') if options[:dry_run]
-
     generate_scaffolding(name, 'component', options[:path])
   end
 
   desc 'scaffold [NAMES...]', 'Generates pages, specs/features, and helpers for one or more names'
-  option :with, type: :array, required: false,
-                desc: 'Components to generate (page,spec,feature,steps,helper,component,model)', aliases: '-w'
-  option :crud, type: :boolean, required: false,
-                desc: 'Generate CRUD pages (list, create, detail, edit) + tests + model'
   option :uses, type: :array, required: false,
                 desc: 'Dependent pages to require', aliases: '-u'
 
   def scaffold(*names)
-    return interactive_scaffold if names.empty?
-
-    names.each do |name|
-      if options[:crud]
-        generate_crud(name)
-      elsif options[:with]
-        generate_selected_components(name, options[:with])
-      else
-        generate_default_scaffold(name)
-      end
-    end
-  end
-
-  desc 'destroy [NAMES...]', 'Removes all scaffolded files for the given names (page, spec/feature, steps)'
-  option :with, type: :array, required: false,
-                desc: 'Components to destroy (page,spec,feature,steps,helper,component)', aliases: '-w'
-
-  def destroy(*names)
-    if names.empty?
-      say 'Please provide at least one name to destroy', :red
-      return
-    end
-
-    names.each { |name| destroy_scaffold(name, options[:with]) }
-  end
-
-  map 'd' => 'destroy'
-
-  desc 'from_url [URL]', 'Generates page object and spec from a live URL'
-  option :name, type: :string, required: false,
-                desc: 'Override the page object name', aliases: '-n'
-  option :ai, type: :boolean, default: false,
-              desc: 'Use LLM for intelligent page analysis'
-
-  def from_url(url)
-    require_relative '../scaffolding/url_analyzer'
-    analyzer = UrlAnalyzer.new(url, name_override: options[:name], ai: options[:ai])
-    analysis = analyzer.analyze.to_h
-
-    page_name = analysis[:page_name]
-
-    if options[:dry_run]
-      DryRunPresenter.preview([
-                                "page_objects/pages/#{page_name}.rb",
-                                "spec/#{page_name}_spec.rb"
-                              ])
-      return
-    end
-
-    Scaffolding.new([page_name]).generate_page_from_url(analysis)
-    Scaffolding.new([page_name]).generate_spec_from_url(analysis)
-    say "Generated page object and spec for #{url}"
+    names.each { |name| generate_default_scaffold(name) }
   end
 
   no_commands do
     def load_config_path(type)
-      YAML.load_file('config/config.yml')["#{type}_path"] if Pathname.new('config/config.yml').exist?
+      ScaffoldProjectDetector.config_path(type)
     end
 
-    def delete_scaffolding(name, type)
-      Scaffolding.new([name]).send("delete_#{type}")
+    def validate_project!
+      warnings = ScaffoldProjectDetector.validate_project
+      warnings.each { |w| say "Warning: #{w}", :yellow }
+      show_detection_defaults
+    end
+
+    def show_detection_defaults
+      gemfile = ScaffoldProjectDetector.read_gemfile
+      if gemfile.empty?
+        say 'Warning: No Gemfile found, defaulting to selenium + rspec templates.', :yellow
+      else
+        automation = ScaffoldProjectDetector.detect_automation(gemfile)
+        framework = ScaffoldProjectDetector.detect_framework(gemfile)
+        if automation.nil?
+          say 'Warning: Could not detect automation library from Gemfile, defaulting to selenium.', :yellow
+        end
+        say 'Warning: Could not detect test framework from Gemfile, defaulting to rspec.', :yellow if framework.nil?
+      end
     end
 
     def generate_scaffolding(name, type, path, uses: nil)
@@ -179,13 +102,8 @@ class ScaffoldingCommands < Thor
       scaffolding.send("generate_#{type}")
     end
 
-    def dry_run_preview(name, type)
-      path = options[:path] || load_config_path(type)
-      file = Scaffolding.planned_path(name, type, path)
-      DryRunPresenter.preview([file])
-    end
-
     def generate_default_scaffold(name)
+      validate_project!
       uses = options[:uses]
       if Pathname.new('spec').exist? && !Pathname.new('features').exist?
         generate_scaffolding(name, 'spec', load_config_path('spec'), uses:)
@@ -195,89 +113,5 @@ class ScaffoldingCommands < Thor
       end
       generate_scaffolding(name, 'page', load_config_path('page'), uses:)
     end
-
-    def generate_selected_components(name, components)
-      uses = options[:uses]
-      components.each do |comp|
-        comp = comp.downcase.strip
-        case comp
-        when 'model'
-          generate_model_data(name)
-        else
-          generate_scaffolding(name, comp, load_config_path(comp), uses:)
-        end
-      end
-    end
-
-    def generate_crud(name)
-      require_relative '../scaffolding/crud_generator'
-      if options[:dry_run]
-        crud = CrudGenerator.new(name, Scaffolding, method(:load_config_path))
-        DryRunPresenter.preview(crud.planned_files)
-        return
-      end
-      crud = CrudGenerator.new(name, Scaffolding, method(:load_config_path))
-      generated = crud.generate
-      say "Generated CRUD scaffold for: #{generated.join(', ')}"
-    end
-
-    def generate_spec_from_page(name, source_file, ai: false) # rubocop:disable Naming/MethodParameterName
-      Scaffolding.new([name]).generate_spec_from_page(source_file, ai:)
-    end
-
-    def generate_model_data(name)
-      normalized = NameNormalizer.normalize(name)
-      path = "models/data/#{normalized}.yml"
-      return if File.exist?(path)
-
-      FileUtils.mkdir_p(File.dirname(path))
-      File.write(path, model_template(normalized))
-    end
-
-    def model_template(name)
-      <<~YAML
-        # Data model for #{name}
-        default:
-          name: 'Test #{name.capitalize}'
-          email: 'test@example.com'
-
-        valid:
-          name: 'Valid #{name.capitalize}'
-          email: 'valid@example.com'
-
-        invalid:
-          name: ''
-          email: 'invalid'
-      YAML
-    end
-
-    def destroy_scaffold(name, components = nil)
-      types = components ? components.map { |c| c.downcase.strip } : detect_scaffold_types
-      types.each { |type| delete_scaffolding(name, type) }
-    end
-
-    def detect_scaffold_types
-      if Pathname.new('spec').exist? && !Pathname.new('features').exist?
-        %w[page spec]
-      else
-        %w[page feature steps]
-      end
-    end
-
-    def interactive_scaffold
-      require_relative '../scaffolding/scaffold_menu'
-      result = ScaffoldMenu.new.run
-      return unless result
-
-      result[:names].each do |name|
-        result[:components].each do |comp|
-          if comp == :model
-            generate_model_data(name)
-          else
-            generate_scaffolding(name, comp.to_s, load_config_path(comp.to_s), uses: result[:uses])
-          end
-        end
-      end
-    end
   end
 end

data/lib/commands/utility_commands.rb

@@ -35,7 +35,7 @@ class UtilityCommands < Thor
     browser_options(selected_options) if selected_options || options[:delete]
   end
 
-  desc 'browser_options [OPTIONS]', 'Sets the browser options for the project'
+  desc 'browser_options [OPTIONS]', 'Sets the browser arguments for the current browser (e.g. no-sandbox, headless)'
   option :delete,
          type: :boolean, required: false, desc: 'This will delete your browser options', aliases: '-d'
 
@@ -44,6 +44,15 @@ class UtilityCommands < Thor
     Utilities.delete_browser_options if options[:delete]
   end
 
+  desc 'headless [on/off]', 'Toggles headless mode for browser tests'
+
+  def headless(toggle)
+    enabled = %w[on true 1 yes].include?(toggle.downcase)
+    Utilities.headless = enabled
+    state = enabled ? 'enabled' : 'disabled'
+    say "Headless mode #{state}", :green
+  end
+
   desc 'raid', 'It runs all the tests in a project'
   option :parallel,
          type: :boolean, required: false, desc: 'It runs the tests in parallel', aliases: '-p'
@@ -114,47 +123,4 @@ class UtilityCommands < Thor
     say 'Raider Desktop downloaded successfully!', :green
   end
 
-  desc 'llm [PROVIDER]', 'Configures the LLM provider (openai, anthropic, ollama)'
-  option :key, type: :string, required: false, desc: 'API key for the provider', aliases: '-k'
-  option :model, type: :string, required: false, desc: 'Model name to use', aliases: '-m'
-  option :url, type: :string, required: false, desc: 'API URL (for ollama)', aliases: '-u'
-  option :status, type: :boolean, required: false, desc: 'Show current LLM configuration', aliases: '-s'
-
-  def llm(provider = nil)
-    if options[:status] || provider.nil?
-      show_llm_status
-      return
-    end
-    configure_llm(provider)
-  end
-
-  no_commands do
-    def configure_llm(provider)
-      unless %w[openai anthropic ollama].include?(provider)
-        say "Unknown provider '#{provider}'. Choose: openai, anthropic, ollama", :red
-        return
-      end
-
-      Utilities.llm_provider = provider
-      Utilities.llm_api_key = options[:key] if options[:key]
-      Utilities.llm_model = options[:model] if options[:model]
-      Utilities.llm_url = options[:url] if options[:url]
-      say "LLM configured: #{provider}", :green
-    end
-
-    def show_llm_status
-      require_relative '../llm/client'
-      status = Llm::Client.status
-      if status[:configured]
-        say "Provider: #{status[:provider]}"
-        say "Model: #{status[:model] || 'default'}"
-        say "Available: #{status[:available] ? 'yes' : 'no'}"
-      else
-        say 'No LLM configured. Use: raider u llm <provider>', :yellow
-        say '  Providers: openai, anthropic, ollama'
-        say '  Example:   raider u llm ollama'
-        say '  Example:   raider u llm openai -k sk-...'
-      end
-    end
-  end
 end

data/lib/generators/automation/templates/login.tt

@@ -9,13 +9,7 @@ class Login < Page
 
   # Actions
 
-<%- if capybara? -%>
-  def login(username, password)
-    fill_in 'loginFrm_loginname', with: username
-    fill_in 'loginFrm_password', with: password
-    click_button 'Login'
-  end
-<%- elsif selenium_based? -%>
+<%- if selenium_based? -%>
   def login(username, password)
     username_field.send_keys username
     password_field.send_keys password
@@ -29,7 +23,6 @@ class Login < Page
     login_button.click
   end
 <%- end -%>
-<%- unless capybara? -%>
 
   private
 
@@ -58,5 +51,4 @@ class Login < Page
     browser.button(xpath: "//button[@title='Login']")
 <%- end -%>
   end
-<%- end -%>
 end

data/lib/generators/automation/templates/page.tt

@@ -14,13 +14,7 @@ class Page
     self.class.to_s.sub('Page', ' Page')
   end
 
-  <%- if capybara? -%>
-  # Components
-
-  def header
-    Header.new(find('.welcome-msg'))
-  end
-  <%- elsif selenium_based? -%>
+  <%- if selenium_based? -%>
   # Components
 
   def header

data/lib/generators/automation/templates/partials/initialize_selector.tt

@@ -1,6 +1,4 @@
-<% if capybara? %>
-  include Capybara::DSL
-<% elsif watir? %>
+<% if watir? %>
   attr_reader :browser
 
   def initialize(browser)

data/lib/generators/automation/templates/partials/visit_method.tt

@@ -1,9 +1,5 @@
 <% if web? %>
-<% if capybara? %>
-  def visit_page(*page)
-    Capybara.visit full_url(page.first)
-  end
-<% elsif selenium_based? %>
+<% if selenium_based? %>
   def visit(*page)
     @driver.navigate.to full_url(page.first)
   end
@@ -12,4 +8,4 @@
     @browser.goto full_url(page.first)
   end
 <% end %>
-<% end %>
+<% end %>

data/lib/generators/common_generator.rb

@@ -17,10 +17,6 @@ class CommonGenerator < Generator
     template('common/rakefile.tt', "#{name}/Rakefile")
   end
 
-  def generate_ruby_version_file
-    template('common/ruby_version.tt', "#{name}/.ruby-version")
-  end
-
   def generate_gemfile
     template('common/gemfile.tt', "#{name}/Gemfile")
   end
@@ -44,8 +40,6 @@ class CommonGenerator < Generator
   end
 
   def create_allure_folder
-    return unless allure_reporter?
-
     empty_directory "#{name}/allure-results"
   end
 end