ruby_raider 2.0.0 → 3.0.0

data/spec/integration/content/page_content_spec.rb

@@ -0,0 +1,259 @@
+# frozen_string_literal: true
+
+require_relative 'content_helper'
+
+describe 'Page object content' do
+  # --- Login page ---
+
+  shared_examples 'valid login page' do |project_name|
+    subject(:login) { read_generated(project_name, 'page_objects/pages/login.rb') }
+
+    it 'has frozen_string_literal' do
+      expect(login).to have_frozen_string_literal
+    end
+
+    it 'has valid Ruby syntax' do
+      expect(login).to have_valid_ruby_syntax
+    end
+
+    it 'defines Login class inheriting from Page' do
+      expect(login).to match(/class Login < Page/)
+    end
+
+    it 'requires the abstract page' do
+      expect(login).to include("require_relative '../abstract/page'")
+    end
+
+    it 'defines a login method' do
+      expect(login).to match(/def login\(username, password\)/)
+    end
+
+    it 'defines a url method' do
+      expect(login).to match(/def url/)
+    end
+  end
+
+  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')
+    end
+
+    it 'uses send_keys for input' do
+      expect(login).to include('send_keys')
+    end
+
+    it 'has private element methods' do
+      expect(login).to include('private')
+      expect(login).to match(/def username_field/)
+      expect(login).to match(/def password_field/)
+      expect(login).to match(/def login_button/)
+    end
+
+    it 'does not include Capybara DSL' 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
+
+  shared_examples 'capybara login page' do |project_name|
+    subject(:login) { read_generated(project_name, 'page_objects/pages/login.rb') }
+
+    it 'uses fill_in for input' do
+      expect(login).to include('fill_in')
+    end
+
+    it 'uses click_button' do
+      expect(login).to include('click_button')
+    end
+
+    it 'has no private element methods' do
+      expect(login).not_to include('private')
+      expect(login).not_to match(/def username_field/)
+    end
+
+    it 'does not include Selenium methods' do
+      expect(login).not_to include('find_element')
+      expect(login).not_to include('send_keys')
+    end
+
+    it 'does not include Watir methods' do
+      expect(login).not_to include('browser.text_field')
+    end
+  end
+
+  # --- Abstract page ---
+
+  shared_examples 'valid abstract page' do |project_name|
+    subject(:page) { read_generated(project_name, 'page_objects/abstract/page.rb') }
+
+    it 'has valid Ruby syntax' do
+      expect(page).to have_valid_ruby_syntax
+    end
+
+    it 'defines Page class' do
+      expect(page).to match(/class Page/)
+    end
+
+    it 'defines to_s method' do
+      expect(page).to match(/def to_s/)
+    end
+  end
+
+  shared_examples 'selenium abstract page' do |project_name|
+    subject(:page) { read_generated(project_name, 'page_objects/abstract/page.rb') }
+
+    it 'has attr_reader :driver' do
+      expect(page).to include('attr_reader :driver')
+    end
+
+    it 'has initialize accepting driver' do
+      expect(page).to match(/def initialize\(driver\)/)
+    end
+
+    it 'has visit with driver.navigate' do
+      expect(page).to include('driver.navigate.to')
+    end
+
+    it 'does not include Capybara DSL' do
+      expect(page).not_to include('Capybara::DSL')
+    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
+
+  shared_examples 'capybara abstract page' do |project_name|
+    subject(:page) { read_generated(project_name, 'page_objects/abstract/page.rb') }
+
+    it 'includes Capybara::DSL' do
+      expect(page).to include('include Capybara::DSL')
+    end
+
+    it 'uses visit_page method' do
+      expect(page).to match(/def visit_page/)
+    end
+
+    it 'uses Capybara.visit' do
+      expect(page).to include('Capybara.visit')
+    end
+
+    it 'does not have attr_reader :driver' do
+      expect(page).not_to include('attr_reader :driver')
+    end
+
+    it 'does not have initialize with driver' do
+      expect(page).not_to match(/def initialize\(driver\)/)
+    end
+  end
+
+  # --- Contexts ---
+
+  context 'with rspec and selenium' do
+    name = "#{FrameworkIndex::RSPEC}_#{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 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 rspec and capybara' do
+    name = "#{FrameworkIndex::RSPEC}_#{AutomationIndex::CAPYBARA}"
+    include_examples 'valid login page', name
+    include_examples 'capybara login page', name
+    include_examples 'valid abstract page', name
+    include_examples 'capybara 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
+
+  context 'with cucumber and capybara' do
+    name = "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CAPYBARA}"
+    include_examples 'valid login page', name
+    include_examples 'capybara login page', name
+    include_examples 'valid abstract page', name
+    include_examples 'capybara abstract page', name
+  end
+
+  context 'with minitest and selenium' do
+    name = "#{FrameworkIndex::MINITEST}_#{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 minitest and watir' do
+    name = "#{FrameworkIndex::MINITEST}_#{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 minitest and capybara' do
+    name = "#{FrameworkIndex::MINITEST}_#{AutomationIndex::CAPYBARA}"
+    include_examples 'valid login page', name
+    include_examples 'capybara login page', name
+    include_examples 'valid abstract page', name
+    include_examples 'capybara abstract page', name
+  end
+end

data/spec/integration/content/reporter_content_spec.rb

@@ -0,0 +1,236 @@
+# frozen_string_literal: true
+
+require_relative 'content_helper'
+require 'fileutils'
+
+describe 'Reporter content validation' do
+  include InvokeGenerators
+
+  # Generate projects with different reporter configurations
+  before(:all) do # rubocop:disable RSpec/BeforeAfterAll
+    %w[allure junit both none].each do |reporter|
+      %w[rspec cucumber minitest].each do |framework|
+        name = "reporter_#{reporter}_#{framework}"
+        InvokeGenerators.generate_framework(
+          automation: 'selenium', framework:, name:, reporter:
+        )
+      end
+    end
+  end
+
+  after(:all) do # rubocop:disable RSpec/BeforeAfterAll
+    %w[allure junit both none].each do |reporter|
+      %w[rspec cucumber minitest].each do |framework|
+        FileUtils.rm_rf("reporter_#{reporter}_#{framework}")
+      end
+    end
+  end
+
+  # --- Shared examples ---
+
+  shared_examples 'project with allure' do |project_name|
+    it 'generates allure_helper.rb' do
+      expect(File).to exist("#{project_name}/helpers/allure_helper.rb")
+    end
+
+    it 'creates allure-results directory' do
+      expect(File).to exist("#{project_name}/allure-results")
+    end
+
+    it 'includes allure-results in .gitignore' do
+      gitignore = read_generated(project_name, '.gitignore')
+      expect(gitignore).to include('allure-results')
+    end
+  end
+
+  shared_examples 'project without allure' do |project_name|
+    it 'does not generate allure_helper.rb' do
+      expect(File).not_to exist("#{project_name}/helpers/allure_helper.rb")
+    end
+
+    it 'does not create allure-results directory' do
+      expect(File).not_to exist("#{project_name}/allure-results")
+    end
+
+    it 'does not include allure-results in .gitignore' do
+      gitignore = read_generated(project_name, '.gitignore')
+      expect(gitignore).not_to include('allure-results')
+    end
+  end
+
+  shared_examples 'rspec with allure reporter' do |project_name|
+    it 'includes allure gems in Gemfile' do
+      gemfile = read_generated(project_name, 'Gemfile')
+      expect(gemfile).to include("gem 'allure-rspec'")
+      expect(gemfile).to include("gem 'allure-ruby-commons'")
+    end
+
+    it 'references AllureHelper in spec_helper' do
+      helper = read_generated(project_name, 'helpers/spec_helper.rb')
+      expect(helper).to include("require_relative 'allure_helper'")
+      expect(helper).to include('AllureHelper.configure')
+      expect(helper).to include('config.formatter = AllureHelper.formatter')
+    end
+
+    it 'allure_helper has valid Ruby syntax' do
+      content = read_generated(project_name, 'helpers/allure_helper.rb')
+      expect(content).to have_valid_ruby_syntax
+    end
+  end
+
+  shared_examples 'rspec without allure reporter' do |project_name|
+    it 'does not include allure gems in Gemfile' do
+      gemfile = read_generated(project_name, 'Gemfile')
+      expect(gemfile).not_to include("gem 'allure-rspec'")
+    end
+
+    it 'does not reference AllureHelper in spec_helper' do
+      helper = read_generated(project_name, 'helpers/spec_helper.rb')
+      expect(helper).not_to include('AllureHelper')
+    end
+  end
+
+  shared_examples 'rspec with junit reporter' do |project_name|
+    it 'includes rspec_junit_formatter gem in Gemfile' do
+      gemfile = read_generated(project_name, 'Gemfile')
+      expect(gemfile).to include("gem 'rspec_junit_formatter'")
+    end
+
+    it 'configures junit formatter in spec_helper' do
+      helper = read_generated(project_name, 'helpers/spec_helper.rb')
+      expect(helper).to include("config.add_formatter('RspecJunitFormatter', 'results/junit.xml')")
+    end
+  end
+
+  shared_examples 'rspec without junit reporter' do |project_name|
+    it 'does not include rspec_junit_formatter gem in Gemfile' do
+      gemfile = read_generated(project_name, 'Gemfile')
+      expect(gemfile).not_to include("gem 'rspec_junit_formatter'")
+    end
+
+    it 'does not configure junit formatter in spec_helper' do
+      helper = read_generated(project_name, 'helpers/spec_helper.rb')
+      expect(helper).not_to include('RspecJunitFormatter')
+    end
+  end
+
+  shared_examples 'cucumber with allure reporter' do |project_name|
+    it 'includes allure-cucumber gem in Gemfile' do
+      gemfile = read_generated(project_name, 'Gemfile')
+      expect(gemfile).to include("gem 'allure-cucumber'")
+    end
+
+    it 'configures allure formatter in cucumber.yml' do
+      cucumber_yml = read_generated(project_name, 'cucumber.yml')
+      expect(cucumber_yml).to include('AllureCucumber::CucumberFormatter')
+      expect(cucumber_yml).to include('--out allure-results')
+    end
+  end
+
+  shared_examples 'cucumber without allure reporter' do |project_name|
+    it 'does not include allure-cucumber gem in Gemfile' do
+      gemfile = read_generated(project_name, 'Gemfile')
+      expect(gemfile).not_to include("gem 'allure-cucumber'")
+    end
+
+    it 'does not configure allure formatter in cucumber.yml' do
+      cucumber_yml = read_generated(project_name, 'cucumber.yml')
+      expect(cucumber_yml).not_to include('AllureCucumber')
+    end
+  end
+
+  shared_examples 'valid ruby files' do |project_name|
+    it 'generates spec_helper or test_helper with valid syntax' do
+      %w[helpers/spec_helper.rb helpers/test_helper.rb].each do |path|
+        file = File.join(project_name, path)
+        next unless File.exist?(file)
+
+        content = File.read(file)
+        expect(content).to have_valid_ruby_syntax
+        expect(content).to have_frozen_string_literal
+      end
+    end
+  end
+
+  # --- reporter: allure ---
+
+  context 'with reporter: allure' do
+    context 'and rspec' do
+      name = 'reporter_allure_rspec'
+      it_behaves_like 'project with allure', name
+      it_behaves_like 'rspec with allure reporter', name
+      it_behaves_like 'rspec without junit reporter', name
+      it_behaves_like 'valid ruby files', name
+    end
+
+    context 'and cucumber' do
+      name = 'reporter_allure_cucumber'
+      it_behaves_like 'project with allure', name
+      it_behaves_like 'cucumber with allure reporter', name
+      it_behaves_like 'valid ruby files', name
+    end
+  end
+
+  # --- reporter: junit ---
+
+  context 'with reporter: junit' do
+    context 'and rspec' do
+      name = 'reporter_junit_rspec'
+      it_behaves_like 'project without allure', name
+      it_behaves_like 'rspec without allure reporter', name
+      it_behaves_like 'rspec with junit reporter', name
+      it_behaves_like 'valid ruby files', name
+    end
+
+    context 'and cucumber' do
+      name = 'reporter_junit_cucumber'
+      it_behaves_like 'project without allure', name
+      it_behaves_like 'cucumber without allure reporter', name
+      it_behaves_like 'valid ruby files', name
+    end
+  end
+
+  # --- reporter: both ---
+
+  context 'with reporter: both' do
+    context 'and rspec' do
+      name = 'reporter_both_rspec'
+      it_behaves_like 'project with allure', name
+      it_behaves_like 'rspec with allure reporter', name
+      it_behaves_like 'rspec with junit reporter', name
+      it_behaves_like 'valid ruby files', name
+    end
+
+    context 'and cucumber' do
+      name = 'reporter_both_cucumber'
+      it_behaves_like 'project with allure', name
+      it_behaves_like 'cucumber with allure reporter', name
+      it_behaves_like 'valid ruby files', name
+    end
+  end
+
+  # --- reporter: none ---
+
+  context 'with reporter: none' do
+    context 'and rspec' do
+      name = 'reporter_none_rspec'
+      it_behaves_like 'project without allure', name
+      it_behaves_like 'rspec without allure reporter', name
+      it_behaves_like 'rspec without junit reporter', name
+      it_behaves_like 'valid ruby files', name
+    end
+
+    context 'and cucumber' do
+      name = 'reporter_none_cucumber'
+      it_behaves_like 'project without allure', name
+      it_behaves_like 'cucumber without allure reporter', name
+      it_behaves_like 'valid ruby files', name
+    end
+
+    context 'and minitest' do
+      name = 'reporter_none_minitest'
+      it_behaves_like 'project without allure', name
+      it_behaves_like 'valid ruby files', name
+    end
+  end
+end

data/spec/integration/content/skip_flags_content_spec.rb

@@ -0,0 +1,206 @@
+# frozen_string_literal: true
+
+require_relative 'content_helper'
+require 'fileutils'
+
+describe 'Skip flags content validation' do
+  include InvokeGenerators
+
+  before(:all) do # rubocop:disable RSpec/BeforeAfterAll
+    {
+      'skip_allure_content' => { skip_allure: true },
+      'skip_video_content' => { skip_video: true },
+      'skip_ci_content' => { skip_ci: true, ci_platform: 'github' },
+      'skip_all_content' => { skip_allure: true, skip_video: true, skip_ci: true, ci_platform: 'github' }
+    }.each do |name, flags|
+      InvokeGenerators.generate_framework(
+        { automation: 'selenium', framework: 'rspec', name: }.merge(flags)
+      )
+    end
+  end
+
+  after(:all) do # rubocop:disable RSpec/BeforeAfterAll
+    %w[skip_allure_content skip_video_content skip_ci_content skip_all_content].each do |name|
+      FileUtils.rm_rf(name)
+    end
+  end
+
+  # --- skip_allure content validation ---
+
+  describe '--skip-allure file content' do
+    let(:name) { 'skip_allure_content' }
+
+    it 'Gemfile excludes allure gems' do
+      gemfile = read_generated(name, 'Gemfile')
+      expect(gemfile).not_to include('allure-rspec')
+      expect(gemfile).not_to include('allure-ruby-commons')
+    end
+
+    it 'Gemfile still includes core gems' do
+      gemfile = read_generated(name, 'Gemfile')
+      expect(gemfile).to include("gem 'rake'")
+      expect(gemfile).to include("gem 'rspec'")
+      expect(gemfile).to include("gem 'selenium-webdriver'")
+      expect(gemfile).to include("gem 'rspec-retry'")
+    end
+
+    it 'spec_helper does not reference AllureHelper' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).not_to include('AllureHelper')
+      expect(helper).not_to include('allure_helper')
+    end
+
+    it 'spec_helper still has retry config' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).to include("require 'rspec/retry'")
+      expect(helper).to include('config.verbose_retry = true')
+      expect(helper).to include("config.default_retry_count = ENV.fetch('RETRY_COUNT', 0).to_i")
+    end
+
+    it 'spec_helper has valid Ruby syntax' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).to have_valid_ruby_syntax
+    end
+
+    it '.gitignore excludes allure-results' do
+      gitignore = read_generated(name, '.gitignore')
+      expect(gitignore).not_to include('allure-results')
+    end
+
+    it '.gitignore still includes spec/examples.txt' do
+      gitignore = read_generated(name, '.gitignore')
+      expect(gitignore).to include('spec/examples.txt')
+    end
+
+    it 'Rakefile still has tag tasks' do
+      rakefile = read_generated(name, 'Rakefile')
+      expect(rakefile).to include('RakeTask.new(:smoke)')
+      expect(rakefile).to include('RakeTask.new(:regression)')
+    end
+
+    it '.rspec file still exists with correct content' do
+      rspec = read_generated(name, '.rspec')
+      expect(rspec).to include('--require helpers/spec_helper')
+      expect(rspec).to include('--format documentation')
+    end
+  end
+
+  # --- skip_video content validation ---
+
+  describe '--skip-video file content' do
+    let(:name) { 'skip_video_content' }
+
+    it 'spec_helper does not reference video_helper' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).not_to include('video_helper')
+    end
+
+    it 'spec_helper still includes AllureHelper' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).to include('AllureHelper')
+    end
+
+    it 'spec_helper has valid Ruby syntax' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).to have_valid_ruby_syntax
+    end
+
+    it 'Gemfile still includes allure gems' do
+      gemfile = read_generated(name, 'Gemfile')
+      expect(gemfile).to include("gem 'allure-rspec'")
+    end
+  end
+
+  # --- skip_ci content validation ---
+
+  describe '--skip-ci file content' do
+    let(:name) { 'skip_ci_content' }
+
+    it 'does not generate GitHub Actions directory' do
+      expect(File).not_to exist("#{name}/.github")
+    end
+
+    it 'still generates Gemfile with all gems' do
+      gemfile = read_generated(name, 'Gemfile')
+      expect(gemfile).to include("gem 'rspec'")
+      expect(gemfile).to include("gem 'allure-rspec'")
+      expect(gemfile).to include("gem 'rspec-retry'")
+    end
+
+    it 'still generates all helpers' do
+      expect(File).to exist("#{name}/helpers/spec_helper.rb")
+      expect(File).to exist("#{name}/helpers/allure_helper.rb")
+      expect(File).to exist("#{name}/helpers/video_helper.rb")
+      expect(File).to exist("#{name}/helpers/driver_helper.rb")
+    end
+  end
+
+  # --- all skip flags combined ---
+
+  describe 'all skip flags combined' do
+    let(:name) { 'skip_all_content' }
+
+    it 'Gemfile has no allure gems' do
+      gemfile = read_generated(name, 'Gemfile')
+      expect(gemfile).not_to include('allure')
+    end
+
+    it 'Gemfile still has core gems' do
+      gemfile = read_generated(name, 'Gemfile')
+      expect(gemfile).to include("gem 'rspec'")
+      expect(gemfile).to include("gem 'selenium-webdriver'")
+      expect(gemfile).to include("gem 'rspec-retry'")
+    end
+
+    it 'has no allure_helper.rb' do
+      expect(File).not_to exist("#{name}/helpers/allure_helper.rb")
+    end
+
+    it 'has no video_helper.rb' do
+      expect(File).not_to exist("#{name}/helpers/video_helper.rb")
+    end
+
+    it 'has no CI files' do
+      expect(File).not_to exist("#{name}/.github")
+    end
+
+    it 'spec_helper has no allure or video references' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).not_to include('AllureHelper')
+      expect(helper).not_to include('allure_helper')
+      expect(helper).not_to include('video_helper')
+    end
+
+    it 'spec_helper has valid Ruby syntax' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).to have_valid_ruby_syntax
+    end
+
+    it 'spec_helper still has retry and persistence config' do
+      helper = read_generated(name, 'helpers/spec_helper.rb')
+      expect(helper).to include("require 'rspec/retry'")
+      expect(helper).to include("config.example_status_persistence_file_path = 'spec/examples.txt'")
+    end
+
+    it 'Rakefile still has tag tasks' do
+      rakefile = read_generated(name, 'Rakefile')
+      expect(rakefile).to include('RakeTask.new(:smoke)')
+    end
+
+    it 'all generated .rb files have valid syntax' do
+      Dir.glob("#{name}/**/*.rb").each do |file|
+        content = File.read(file)
+        expect(content).to have_valid_ruby_syntax,
+                           "#{file} has invalid Ruby syntax"
+      end
+    end
+
+    it 'all generated .rb files (except abstract) have frozen_string_literal' do
+      Dir.glob("#{name}/**/*.rb").reject { |f| f.include?('/abstract/') }.each do |file|
+        content = File.read(file)
+        expect(content).to have_frozen_string_literal,
+                           "#{file} is missing frozen_string_literal"
+      end
+    end
+  end
+end