ruby_raider 3.3.0 → 3.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f5fc3418c82e5a121ebecbc862acd716ded56f9d7dc49be670e9f0361917deb
-  data.tar.gz: b7464935c9d32155bd30d80750c914e6fd3ba95b3db3d6ed8eb95d5461f86fcb
+  metadata.gz: 11203a49dfd79c493cfa08d13576ecd10933eea755664e75f569c4860d74294b
+  data.tar.gz: 7338d98246ce0e765cb805fbfdb64b1feff88d215aeaecc5cb91184901ea0906
 SHA512:
-  metadata.gz: 827db06d8dab522391496aeedbff5e199119ac287e548241e1ce23bb9ff65616043c1626cb35226ce1230a8c154953c9eb0bc3f65d5a7abaa9ee323dfd76522d
-  data.tar.gz: e37a2899b4e8f78c941dd0f570f2a5c2833a61cc74cb30e392cc7e53565f1df78374853b0fd73b38aeabb7d8849fd22210cf534e153f3c8d9664128bd1566b5a
+  metadata.gz: 6e4c33e6293efb67fbe0207e62b434a422337df81d8936ff579a776d23ed89cf3d47bb3d22637a6d4ab28082003db155cb2e75c553aa8dba8966cf494ab0e90f
+  data.tar.gz: 3eff51512305847c73c9dfd8c83582772fe03fdf232047073428583edd25be07f644e8c133862ae633027e6efae9353255d803b430b0ed44fb9f1384df45dd76

data/.rubocop.yml

@@ -2,7 +2,7 @@ require:
   - rubocop-rspec
 
 AllCops:
-  TargetRubyVersion: 3.1.0
+  TargetRubyVersion: 3.2.0
 
 # Layout
 Layout/CaseIndentation:

data/README.md

@@ -59,8 +59,8 @@ Every generated project comes with:
 
 - **Page Object Model** — Base page and component classes with example pages
 - **Test examples** — Working login tests against the [Raider Test Store](https://raider-test-site.onrender.com/)
-- **Allure reporting** — Pre-configured with screenshot capture on failure
-- **Raider reporting** — RSpec projects include [raider_reporter](https://github.com/RaiderHQ/raider_reporter), which writes results to `raider-results/` and uploads runs when `RAIDER_TOKEN` and `RAIDER_ENDPOINT` are set
+- **Allure reporting** (RSpec) — Pre-configured with screenshot capture on failure
+- **Raider reporting** — RSpec and Cucumber projects include [raider_reporter](https://github.com/RaiderHQ/raider_reporter), which writes results to `raider-results/` and uploads runs when `RAIDER_TOKEN` and `RAIDER_ENDPOINT` are set
 - **GitHub Actions CI** — Ready-to-use test pipeline
 - **Rake tasks** — Default, smoke, and regression tasks with tag-based filtering
 - **Retry support** — RSpec retry with configurable retry count via `RETRY_COUNT` env var

data/RELEASE.md

@@ -2,6 +2,21 @@
 
 ## Release Notes
 
+### 3.5.0
+
+- Generated Cucumber projects now report through `raider_reporter` `~> 0.4` instead of Allure: results are written to `raider-results/` and uploaded when `RAIDER_TOKEN` and `RAIDER_ENDPOINT` are set. The reporter is activated by `require 'raider_reporter/cucumber'` in `features/support/env.rb`.
+- Cucumber projects no longer include `allure-cucumber` or `helpers/allure_helper.rb`; failure screenshots are attached to Raider only, and `.gitignore` lists `raider-results` instead of `allure-results`.
+- Generated Cucumber GitHub CI now passes the Raider settings to the test run, uploads `raider-results/` as an artifact and includes the `raider-comment` job, matching RSpec projects. The Allure report and gh-pages steps are removed for Cucumber. RSpec pipelines are unchanged.
+- The generated Readme has a "Reporting" section for Cucumber projects too.
+- Generated Gemfiles now require `raider_reporter` `~> 0.4`.
+
+### 3.4.0
+
+- Generated RSpec projects with GitHub CI now include a `raider-comment` job that comments Raider test results on pull requests via `raider-reporter comment`. It runs after every test job, only on pull requests, and needs the `RAIDER_TOKEN` secret and `RAIDER_ENDPOINT` variable. Cucumber projects are unchanged.
+- The job needs `contents: read`, `pull-requests: write` and `statuses: write` permissions; it reports a `raider/tests` status, and pull requests from forks are skipped.
+- Generated Gemfiles now require `raider_reporter` `~> 0.3`.
+- Ruby Raider now requires Ruby 3.2.0 or newer.
+
 ### 3.3.0
 
 - Generated RSpec projects now include `raider_reporter`: results are written to `raider-results/` and uploaded when `RAIDER_TOKEN` and `RAIDER_ENDPOINT` are set. Allure is still produced. Cucumber projects are unchanged.

data/lib/generators/common_generator.rb

@@ -40,6 +40,8 @@ class CommonGenerator < Generator
   end
 
   def create_allure_folder
+    return if cucumber?
+
     empty_directory "#{name}/allure-results"
   end
 end

data/lib/generators/cucumber/templates/cucumber.tt

@@ -1 +1 @@
-default: --format AllureCucumber::CucumberFormatter --out allure-results --publish-quiet --retry 0
+default: --format pretty --publish-quiet --retry 0

data/lib/generators/cucumber/templates/partials/appium_env.tt

@@ -1,15 +1,20 @@
+# frozen_string_literal: true
+
+require 'raider_reporter/cucumber'
 require 'tmpdir'
-require_relative '../../helpers/allure_helper'
 
 Before do
-  AllureHelper.configure
   driver.start_driver
 end
 
 After do |scenario|
-  Dir.mktmpdir do |temp_folder|
-    screenshot = driver.screenshot("#{temp_folder}/#{scenario.name}.png")
-    AllureHelper.add_screenshot(scenario.name, screenshot)
+  if scenario.failed?
+    Dir.mktmpdir do |temp_folder|
+      screenshot_path = File.join(temp_folder, 'screenshot.png')
+      driver.screenshot(screenshot_path)
+      RaiderReporter.attach('screenshot', screenshot_path, type: :png)
+    end
   end
+ensure
   driver.quit_driver
 end

data/lib/generators/cucumber/templates/partials/selenium_env.tt

@@ -4,9 +4,9 @@
 require 'axe-rspec'
 <%- end -%>
 require 'rspec'
+require 'raider_reporter/cucumber'
 require 'tmpdir'
 require 'yaml'
-require_relative '../../helpers/allure_helper'
 
 Before do
   viewport = YAML.load_file('config/config.yml')['viewport']
@@ -18,9 +18,13 @@ Before do
 end
 
 After do |scenario|
-  Dir.mktmpdir do |temp_folder|
-    screenshot = driver.save_screenshot("#{temp_folder}/#{scenario.name}.png")
-    AllureHelper.add_screenshot(scenario.name, screenshot)
+  if scenario.failed?
+    Dir.mktmpdir do |temp_folder|
+      screenshot_path = File.join(temp_folder, 'screenshot.png')
+      driver.save_screenshot(screenshot_path)
+      RaiderReporter.attach('screenshot', screenshot_path, type: :png)
+    end
   end
+ensure
   driver.quit
-end
+end

data/lib/generators/cucumber/templates/partials/watir_env.tt

@@ -1,8 +1,8 @@
 # frozen_string_literal: true
 
+require 'raider_reporter/cucumber'
 require 'tmpdir'
 require 'yaml'
-require_relative '../../helpers/allure_helper'
 
 Before do
   viewport = YAML.load_file('config/config.yml')['viewport']
@@ -14,9 +14,13 @@ Before do
 end
 
 After do |scenario|
-  Dir.mktmpdir do |temp_folder|
-    screenshot = browser.screenshot.save("#{temp_folder}/#{scenario.name}.png")
-    AllureHelper.add_screenshot(scenario.name, screenshot)
+  if scenario.failed?
+    Dir.mktmpdir do |temp_folder|
+      screenshot_path = File.join(temp_folder, 'screenshot.png')
+      browser.screenshot.save(screenshot_path)
+      RaiderReporter.attach('screenshot', screenshot_path, type: :png)
+    end
   end
+ensure
   browser.quit
-end
+end

data/lib/generators/helper_generator.rb

@@ -14,6 +14,8 @@ class HelpersGenerator < Generator
   private
 
   def generate_allure_helper
+    return if cucumber?
+
     template('helpers/allure_helper.tt', "#{name}/helpers/allure_helper.rb")
   end
 

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

@@ -33,19 +33,18 @@ jobs:
         with:
           chrome-version: stable
 
+<%- unless framework == 'cucumber' -%>
       - name: Create allure-results folder
         run: mkdir -p allure-results
 
+<%- end -%>
       - name: Run tests
         run: <%- if framework == 'cucumber' -%>bundle exec cucumber features --format pretty<%- else -%>bundle exec rspec spec --format documentation<%- end %>
         env:
           HEADLESS: true
-<%- unless framework == 'cucumber' -%>
           RAIDER_TOKEN: ${{ secrets.RAIDER_TOKEN }}
           RAIDER_ENDPOINT: ${{ vars.RAIDER_ENDPOINT }}
-<%- end -%>
 
-<%- unless framework == 'cucumber' -%>
       - name: Upload Raider results
         uses: actions/upload-artifact@v4
         if: always()
@@ -54,8 +53,7 @@ jobs:
           path: raider-results/
           if-no-files-found: ignore
 
-<%- end -%>
-
+<%- unless framework == 'cucumber' -%>
       - name: Get Allure history
         uses: actions/checkout@v2
         if: always()
@@ -81,3 +79,23 @@ jobs:
           PERSONAL_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           PUBLISH_BRANCH: gh-pages
           PUBLISH_DIR: allure-history
+
+<%- end -%>
+  raider-comment:
+    needs: [build]
+    if: always() && github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      statuses: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with: { ruby-version: 3.4.0, bundler-cache: true }
+      - name: Comment Raider results on the pull request
+        run: bundle exec raider-reporter comment
+        env:
+          RAIDER_TOKEN: ${{ secrets.RAIDER_TOKEN }}
+          RAIDER_ENDPOINT: ${{ vars.RAIDER_ENDPOINT }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

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

@@ -52,7 +52,6 @@ jobs:
 <%- end -%>
         env:
           APP_PATH: ${{ github.workspace }}/apps/RaiderTestApp.app
-<%- unless cucumber? -%>
           RAIDER_TOKEN: ${{ secrets.RAIDER_TOKEN }}
           RAIDER_ENDPOINT: ${{ vars.RAIDER_ENDPOINT }}
 
@@ -64,7 +63,6 @@ jobs:
           path: raider-results/
           if-no-files-found: ignore
 <%- end -%>
-<%- end -%>
 
 <%- if android? || cross_platform? -%>
   android-tests:
@@ -113,7 +111,6 @@ jobs:
 <%- end -%>
         env:
           APP_PATH: ${{ github.workspace }}/apps/app-release.apk
-<%- unless cucumber? -%>
           RAIDER_TOKEN: ${{ secrets.RAIDER_TOKEN }}
           RAIDER_ENDPOINT: ${{ vars.RAIDER_ENDPOINT }}
 
@@ -125,4 +122,22 @@ jobs:
           path: raider-results/
           if-no-files-found: ignore
 <%- end -%>
-<%- end -%>
+
+  raider-comment:
+    needs: [<%= [('ios-tests' if ios? || cross_platform?), ('android-tests' if android? || cross_platform?)].compact.join(', ') %>]
+    if: always() && github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      pull-requests: write
+      statuses: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: ruby/setup-ruby@v1
+        with: { ruby-version: 3.4.0, bundler-cache: true }
+      - name: Comment Raider results on the pull request
+        run: bundle exec raider-reporter comment
+        env:
+          RAIDER_TOKEN: ${{ secrets.RAIDER_TOKEN }}
+          RAIDER_ENDPOINT: ${{ vars.RAIDER_ENDPOINT }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

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

@@ -5,9 +5,7 @@ gem 'activesupport'
 gem 'appium_lib'
 gem 'appium_console'
 <% end %>
-<%- if cucumber? -%>
-gem 'allure-cucumber', '2.28.0'
-<%- else -%>
+<%- if rspec? -%>
 gem 'allure-rspec', '2.28.0'
 gem 'allure-ruby-commons', '2.28.0'
 <%- end -%>
@@ -19,8 +17,8 @@ gem 'parallel_split_test'
 gem 'parallel_tests'
 gem 'rake'
 gem 'reek'
+gem 'raider_reporter', '~> 0.4'
 <%- if rspec? -%>
-gem 'raider_reporter', '~> 0.2'
 gem 'rspec-retry'
 <%- end -%>
 gem '<%= framework %>'

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

@@ -1,5 +1,7 @@
-allure-results
 <%- if rspec? -%>
+allure-results
+<%- end -%>
 raider-results
+<%- if rspec? -%>
 spec/examples.txt
 <%- end -%>

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

@@ -82,11 +82,15 @@ raider g steps [NAME]     # Create step definitions
 raider g scaffold [NAME]  # Create page + test + steps
 ```
 
-<%- if rspec? -%>
 ## Reporting
 
+<%- if rspec? -%>
 Every run writes machine-readable results to `raider-results/` (including `run.json`), next to the usual Allure results.
 Allure reports are still produced.
+<%- else -%>
+Every run writes machine-readable results to `raider-results/` (including `run.json`). The reporter runs in plugin mode:
+`features/support/env.rb` requires `raider_reporter/cucumber`, so no extra Cucumber formatter flag is needed.
+<%- end -%>
 
 To upload runs to Raider, set these environment variables before running the suite:
 
@@ -95,10 +99,14 @@ export RAIDER_TOKEN=your-token
 export RAIDER_ENDPOINT=https://your-raider-endpoint
 ```
 
+<%- if rspec? -%>
 Without `RAIDER_TOKEN`, nothing is uploaded and the suite output is unchanged. Failure screenshots are attached to both
 Allure and Raider. See the [raider_reporter README](https://github.com/RaiderHQ/raider_reporter) for details.
-
+<%- else -%>
+Without `RAIDER_TOKEN`, nothing is uploaded and the suite output is unchanged. Failure screenshots are attached to
+Raider. See the [raider_reporter README](https://github.com/RaiderHQ/raider_reporter) for details.
 <%- end -%>
+
 ### Sponsors
 
 This project is tested with BrowserStack.

data/lib/version

@@ -1 +1 @@
-3.3.0
+3.5.0

data/ruby_raider.gemspec

@@ -9,7 +9,7 @@ Gem::Specification.new do |s|
   s.email       = 'agustin.pe94@gmail.com'
   s.homepage = 'https://github.com/RubyRaider/ruby_raider'
   s.license = 'MIT'
-  s.required_ruby_version = '>= 3.1.0'
+  s.required_ruby_version = '>= 3.2.0'
   s.files  = `git ls-files -z`.split("\x0")
   s.bindir = 'bin'
   s.executables << 'raider'

data/spec/integration/content/ci_content_spec.rb

@@ -62,13 +62,13 @@ describe 'CI pipeline content' do
     end
   end
 
-  shared_examples 'github raider wiring' do |project_name, file|
+  shared_examples 'github raider wiring' do |project_name, file, runner = 'rspec'|
     subject(:pipeline) { read_generated(project_name, ".github/workflows/#{file}") }
 
     let(:steps) { YAML.safe_load(pipeline)['jobs'].values.flat_map { |job| job['steps'] } }
 
     let(:test_steps) do
-      steps.select { |step| step['run'].to_s.include?('rspec') || step['with'].to_h['script'].to_s.include?('rspec') }
+      steps.select { |step| step['run'].to_s.include?(runner) || step['with'].to_h['script'].to_s.include?(runner) }
     end
 
     it 'passes Raider settings to every test step' do
@@ -81,7 +81,7 @@ describe 'CI pipeline content' do
 
     it 'uploads raider-results as an artifact even on failure in every job' do
       uploads = steps.select { |step| step['uses'] == 'actions/upload-artifact@v4' }
-      expect(uploads.size).to eq(YAML.safe_load(pipeline)['jobs'].size)
+      expect(uploads.size).to eq(YAML.safe_load(pipeline)['jobs'].except('raider-comment').size)
       uploads.each do |upload|
         expect(upload['with']['path']).to eq('raider-results/')
         expect(upload['if']).to eq('always()')
@@ -89,12 +89,42 @@ describe 'CI pipeline content' do
     end
   end
 
-  shared_examples 'github without raider wiring' do |project_name, file|
+  shared_examples 'github raider-comment job' do |project_name, file, test_jobs|
     subject(:pipeline) { read_generated(project_name, ".github/workflows/#{file}") }
 
-    it 'has no Raider settings or artifact' do
-      expect(pipeline).not_to include('RAIDER_')
-      expect(pipeline).not_to include('raider-results')
+    let(:jobs) { YAML.safe_load(pipeline)['jobs'] }
+    let(:job) { jobs['raider-comment'] }
+
+    it 'is a valid workflow with exactly the expected jobs' do
+      expect(jobs.keys).to match_array(test_jobs + ['raider-comment'])
+    end
+
+    it 'needs every test job' do
+      expect(job['needs']).to match_array(test_jobs)
+    end
+
+    it 'runs always, on pull requests only' do
+      expect(job['if']).to eq("always() && github.event_name == 'pull_request'")
+      expect(job['runs-on']).to eq('ubuntu-latest')
+    end
+
+    it 'has the least permissions required' do
+      expect(job['permissions']).to eq('contents' => 'read', 'pull-requests' => 'write', 'statuses' => 'write')
+    end
+
+    it 'checks out, sets up the same Ruby as the test jobs and comments' do
+      steps = job['steps']
+      expect(steps[0]).to eq('uses' => 'actions/checkout@v4')
+      expect(steps[1]['uses']).to eq('ruby/setup-ruby@v1')
+      test_ruby = jobs.values_at(*test_jobs).flat_map { |j| j['steps'] }
+                      .find { |step| step['uses'] == 'ruby/setup-ruby@v1' }['with']['ruby-version']
+      expect(steps[1]['with']).to eq('ruby-version' => test_ruby, 'bundler-cache' => true)
+      expect(steps[2]).to eq('name' => 'Comment Raider results on the pull request',
+                             'run' => 'bundle exec raider-reporter comment',
+                             'env' => { 'RAIDER_TOKEN' => '${{ secrets.RAIDER_TOKEN }}',
+                                        'RAIDER_ENDPOINT' => '${{ vars.RAIDER_ENDPOINT }}',
+                                        'GITHUB_TOKEN' => '${{ secrets.GITHUB_TOKEN }}' })
+      expect(steps.size).to eq(3)
     end
   end
 
@@ -106,12 +136,21 @@ describe 'CI pipeline content' do
     end
   end
 
+  shared_examples 'github without allure steps' do |project_name|
+    subject(:pipeline) { read_generated(project_name, '.github/workflows/test_pipeline.yml') }
+
+    it 'has no Allure report or gh-pages steps' do
+      expect(pipeline).not_to match(/allure|gh-pages/i)
+    end
+  end
+
   context 'with rspec and selenium' do
     name = "#{FrameworkIndex::RSPEC}_#{AutomationIndex::SELENIUM}"
     include_examples 'valid github pipeline', name
     include_examples 'github rspec pipeline', name
     include_examples 'github triggers', name, 'test_pipeline.yml'
     include_examples 'github raider wiring', name, 'test_pipeline.yml'
+    include_examples 'github raider-comment job', name, 'test_pipeline.yml', %w[build]
     include_examples 'github allure steps', name
   end
 
@@ -120,8 +159,9 @@ describe 'CI pipeline content' do
     include_examples 'valid github pipeline', name
     include_examples 'github cucumber pipeline', name
     include_examples 'github triggers', name, 'test_pipeline.yml'
-    include_examples 'github without raider wiring', name, 'test_pipeline.yml'
-    include_examples 'github allure steps', name
+    include_examples 'github raider wiring', name, 'test_pipeline.yml', 'cucumber'
+    include_examples 'github raider-comment job', name, 'test_pipeline.yml', %w[build]
+    include_examples 'github without allure steps', name
   end
 
   context 'with rspec and watir' do
@@ -130,12 +170,27 @@ describe 'CI pipeline content' do
     include_examples 'github rspec pipeline', name
     include_examples 'github triggers', name, 'test_pipeline.yml'
     include_examples 'github raider wiring', name, 'test_pipeline.yml'
+    include_examples 'github raider-comment job', name, 'test_pipeline.yml', %w[build]
     include_examples 'github allure steps', name
   end
 
-  %w[android ios cross_platform].each do |automation|
+  context 'with cucumber and watir' do
+    name = "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}"
+    include_examples 'valid github pipeline', name
+    include_examples 'github cucumber pipeline', name
+    include_examples 'github triggers', name, 'test_pipeline.yml'
+    include_examples 'github raider wiring', name, 'test_pipeline.yml', 'cucumber'
+    include_examples 'github raider-comment job', name, 'test_pipeline.yml', %w[build]
+    include_examples 'github without allure steps', name
+  end
+
+  appium_jobs = { 'android' => %w[android-tests], 'ios' => %w[ios-tests],
+                  'cross_platform' => %w[ios-tests android-tests] }
+
+  appium_jobs.each do |automation, test_jobs|
     context "with rspec and #{automation}" do
       name = "#{FrameworkIndex::RSPEC}_#{automation}"
+      include_examples 'github raider-comment job', name, 'appium_pipeline.yml', test_jobs
       include_examples 'github triggers', name, 'appium_pipeline.yml'
       include_examples 'github raider wiring', name, 'appium_pipeline.yml'
     end
@@ -143,7 +198,8 @@ describe 'CI pipeline content' do
     context "with cucumber and #{automation}" do
       name = "#{FrameworkIndex::CUCUMBER}_#{automation}"
       include_examples 'github triggers', name, 'appium_pipeline.yml'
-      include_examples 'github without raider wiring', name, 'appium_pipeline.yml'
+      include_examples 'github raider wiring', name, 'appium_pipeline.yml', 'cucumber'
+      include_examples 'github raider-comment job', name, 'appium_pipeline.yml', test_jobs
     end
   end
 end

data/spec/integration/content/common_content_spec.rb

@@ -122,16 +122,16 @@ describe 'Common file content' do
   shared_examples 'non-rspec gitignore' do |project_name|
     subject(:gitignore) { read_generated(project_name, '.gitignore') }
 
-    it 'includes allure-results' do
-      expect(gitignore).to include('allure-results')
+    it 'does not include allure-results' do
+      expect(gitignore).not_to include('allure-results')
     end
 
     it 'does not include spec/examples.txt' do
       expect(gitignore).not_to include('spec/examples.txt')
     end
 
-    it 'does not include raider-results' do
-      expect(gitignore).not_to include('raider-results')
+    it 'includes raider-results' do
+      expect(gitignore).to include('raider-results')
     end
   end
 

data/spec/integration/content/cucumber_reporter_content_spec.rb

@@ -0,0 +1,64 @@
+# frozen_string_literal: true
+
+require_relative 'content_helper'
+
+describe 'Cucumber raider_reporter wiring' do
+  screenshot_calls = {
+    'selenium' => 'driver.save_screenshot(screenshot_path)',
+    'watir' => 'browser.screenshot.save(screenshot_path)'
+  }
+
+  AUTOMATION_TYPES.each do |automation|
+    context "with cucumber and #{automation}" do
+      let(:project_name) { "#{FrameworkIndex::CUCUMBER}_#{automation}" }
+      let(:env) { read_generated(project_name, 'features/support/env.rb') }
+      let(:screenshot_call) { screenshot_calls.fetch(automation, 'driver.screenshot(screenshot_path)') }
+      let(:hook) { env[/^\s*After do.*\z/m] }
+      let(:quit_call) { automation == 'watir' ? 'browser.quit' : 'driver.quit' }
+
+      it 'activates the reporter by requiring raider_reporter/cucumber' do
+        expect(env).to include("require 'raider_reporter/cucumber'")
+      end
+
+      it 'does not reference the allure helper' do
+        expect(env).not_to match(/AllureHelper|allure_helper/)
+      end
+
+      it 'takes the screenshot only for failed scenarios, inside the guard block' do
+        guarded = /if scenario\.failed\?\n\s+Dir\.mktmpdir do \|temp_folder\|\n(?<body>.*?)\n\s+end\n\s+end\nensure/m
+        expect(hook.match(guarded)[:body]).to include(screenshot_call)
+      end
+
+      it 'uses a fixed file name in the tmpdir, never the scenario name' do
+        expect(env).to include("screenshot_path = File.join(temp_folder, 'screenshot.png')")
+        expect(hook).not_to include('scenario.name')
+      end
+
+      it 'quits the driver in an ensure of the After block, without a redundant begin' do
+        quit = %w[android ios cross_platform].include?(automation) ? 'driver.quit_driver' : quit_call
+        expect(hook).to match(/^\s*After do \|scenario\|\n.*\n^ensure\n\s+#{Regexp.escape(quit)}\nend/m)
+        expect(hook).not_to match(/^\s+begin$/)
+      end
+
+      it 'attaches the screenshot path before quitting the driver' do
+        attach = "RaiderReporter.attach('screenshot', screenshot_path, type: :png)"
+        expect(env).to include(attach)
+        expect(env.index(screenshot_call)).to be < env.index(attach)
+        expect(env.index(attach)).to be < env.index(/driver\.quit|browser\.quit/, env.index(attach))
+      end
+
+      it 'does not generate the allure helper' do
+        expect(File).not_to exist(File.join(project_name, 'helpers/allure_helper.rb'))
+      end
+
+      it 'does not mention Allure in any generated file' do
+        files = Dir.glob("#{project_name}/**/*", File::FNM_DOTMATCH).select { |f| File.file?(f) }
+        expect(files.select { |f| File.read(f).match?(/allure/i) }).to be_empty
+      end
+
+      it 'does not create an allure-results folder' do
+        expect(File).not_to exist(File.join(project_name, 'allure-results'))
+      end
+    end
+  end
+end

data/spec/integration/content/gemfile_content_spec.rb

@@ -58,8 +58,8 @@ describe 'Gemfile content' do
       expect(gemfile).to include("gem 'cucumber'")
     end
 
-    it 'includes allure-cucumber' do
-      expect(gemfile).to include("gem 'allure-cucumber'")
+    it 'does not include allure-cucumber' do
+      expect(gemfile).not_to include('allure')
     end
 
     it 'includes rspec as cucumber dependency' do
@@ -127,7 +127,7 @@ describe 'Gemfile content' do
         let(:gemfile) { read_generated("#{FrameworkIndex::RSPEC}_#{automation}", 'Gemfile') }
 
         it 'includes raider_reporter' do
-          expect(gemfile).to include("gem 'raider_reporter', '~> 0.2'")
+          expect(gemfile).to include("gem 'raider_reporter', '~> 0.4'")
         end
 
         it 'keeps allure gems' do
@@ -142,12 +142,12 @@ describe 'Gemfile content' do
       context "with cucumber and #{automation}" do
         let(:gemfile) { read_generated("#{FrameworkIndex::CUCUMBER}_#{automation}", 'Gemfile') }
 
-        it 'does not include raider_reporter' do
-          expect(gemfile).not_to include('raider_reporter')
+        it 'includes raider_reporter' do
+          expect(gemfile).to include("gem 'raider_reporter', '~> 0.4'")
         end
 
-        it 'keeps allure-cucumber' do
-          expect(gemfile).to include("gem 'allure-cucumber', '2.28.0'")
+        it 'drops allure-cucumber' do
+          expect(gemfile).not_to include('allure')
         end
 
         it 'pins ruby_raider to the generator major.minor' do

data/spec/integration/content/helper_content_spec.rb

@@ -221,13 +221,11 @@ describe 'Helper file content' do
     name = "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::SELENIUM}"
     it_behaves_like 'valid driver helper', name
     it_behaves_like 'selenium driver helper', name
-    it_behaves_like 'valid allure helper', name
   end
 
   context 'with cucumber and watir' do
     name = "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::WATIR}"
     it_behaves_like 'valid browser helper', name
-    it_behaves_like 'valid allure helper', name
   end
 
   # --- Mobile contexts (with AppiumRecorder) ---
@@ -255,10 +253,8 @@ describe 'Helper file content' do
     end
 
     context "with cucumber and #{automation}" do
-      it 'has no raider reporter wiring' do
-        project = "#{FrameworkIndex::CUCUMBER}_#{automation}"
-        files = Dir.glob("#{project}/**/*", File::FNM_DOTMATCH).select { |f| File.file?(f) }
-        expect(files.select { |f| File.read(f).match?(/raider_reporter|RaiderReporter/) }).to be_empty
+      it 'does not generate the allure helper' do
+        expect(File).not_to exist("#{FrameworkIndex::CUCUMBER}_#{automation}/helpers/allure_helper.rb")
       end
     end
   end

data/spec/integration/content/readme_content_spec.rb

@@ -22,9 +22,19 @@ describe 'Generated Readme content' do
     end
 
     context "with cucumber and #{automation}" do
-      it 'has no Reporting section' do
-        readme = read_generated("#{FrameworkIndex::CUCUMBER}_#{automation}", 'Readme.md')
-        expect(readme).not_to include('RAIDER_TOKEN')
+      subject(:readme) { read_generated("#{FrameworkIndex::CUCUMBER}_#{automation}", 'Readme.md') }
+
+      it 'has a Reporting section' do
+        expect(readme).to include('## Reporting')
+      end
+
+      it 'documents local results, upload settings, plugin mode and the raider_reporter README' do
+        expect(readme).to include('raider-results/', 'RAIDER_TOKEN', 'RAIDER_ENDPOINT', 'features/support/env.rb',
+                                  'https://github.com/RaiderHQ/raider_reporter')
+      end
+
+      it 'does not mention Allure' do
+        expect(readme).not_to match(/allure/i)
       end
     end
   end

data/spec/integration/content/test_content_spec.rb

@@ -110,6 +110,10 @@ describe 'Test file content' do
     it 'has default profile' do
       expect(config).to include('default:')
     end
+
+    it 'uses the pretty formatter, with the reporter activated from env.rb' do
+      expect(config.strip).to eq('default: --format pretty --publish-quiet --retry 0')
+    end
   end
 
   # --- RSpec contexts ---

data/spec/integration/end_to_end_spec.rb

@@ -84,7 +84,7 @@ describe 'End-to-End Project Generation and Execution' do
   # Helper to run Cucumber tests
   def run_cucumber(project_name)
     puts "\n🥒 Running Cucumber tests in #{project_name}..."
-    result = run_in_project(project_name, 'bundle exec cucumber features/ --format pretty', timeout: 120)
+    result = run_in_project(project_name, 'HEADLESS=true bundle exec cucumber features/ --format pretty', timeout: 120)
 
     puts result[:stdout] if result[:stdout].length.positive?
 
@@ -104,6 +104,15 @@ describe 'End-to-End Project Generation and Execution' do
       expect(bundle_install(project)).to be true
     end
 
+    it 'resolves raider_reporter 0.4 from RubyGems and ships the raider-reporter executable', :aggregate_failures do
+      skip 'Bundle install failed' unless bundle_install(project)
+
+      expect(File.read(File.join(project, 'Gemfile.lock'))).to match(/^    raider_reporter \(0\.4\.\d+\)$/)
+      result = run_in_project(project, 'bundle exec raider-reporter --help', timeout: 60)
+      expect(result[:exit_code]).to eq(0), "STDOUT: #{result[:stdout]}\nSTDERR: #{result[:stderr]}"
+      expect(result[:stdout] + result[:stderr]).to include('raider-reporter comment')
+    end
+
     it 'runs generated RSpec tests successfully', :slow do
       skip 'Bundle install failed' unless bundle_install(project)
 
@@ -153,6 +162,85 @@ describe 'End-to-End Project Generation and Execution' do
                                   "STDOUT: #{result[:stdout]}\n" \
                                   "STDERR: #{result[:stderr]}"
     end
+
+    it 'resolves raider_reporter 0.4 from RubyGems and requires its Cucumber plugin', :aggregate_failures do
+      skip 'Bundle install failed' unless bundle_install(project)
+
+      lockfile = File.read(File.join(project, 'Gemfile.lock'))
+      expect(lockfile).to match(/^    raider_reporter \(0\.4\.\d+\)$/)
+      expect(File.read(File.join(project, 'features/support/env.rb'))).to include("require 'raider_reporter/cucumber'")
+    end
+
+    it 'prints pretty output and keeps the exit status of a failing Cucumber run', :aggregate_failures, :slow do
+      skip 'Bundle install failed' unless bundle_install(project)
+
+      result = run_cucumber_with_failure(project)
+
+      expect(result[:stdout]).to include('Feature: Reporter failure')
+      expect(result[:stdout]).to include('Scenario: A deliberately failing scenario')
+      expect(result[:stdout]).to match(/\d+ scenarios? \(\d+ failed/)
+      expect(result[:exit_code]).to eq(1)
+    end
+
+    it 'writes raider-results/run.json listing every scenario with a failing scenario screenshot',
+       :aggregate_failures, :slow do
+      skip 'Bundle install failed' unless bundle_install(project)
+
+      result = run_cucumber_with_failure(project)
+      summary = result[:stdout].match(/(\d+) scenarios? \((?:(\d+) failed)?/)
+      expect(summary).not_to be_nil, "No Cucumber summary line.\nSTDOUT: #{result[:stdout]}\nSTDERR: #{result[:stderr]}"
+
+      run = JSON.parse(File.read(File.join(project, 'raider-results', 'run.json')))
+      expect(run['schema_version']).to eq(1)
+      expect(run['results'].size).to eq(summary[1].to_i)
+      expect(run['results'].count { |r| r['status'] == 'failed' }).to eq(summary[2].to_i)
+
+      failing = run['results'].find { |r| r['full_name'] == 'Reporter failure: A deliberately failing scenario' }
+      expect(failing).not_to be_nil, "Scenario missing from run.json: #{run['results'].map { |r| r['full_name'] }}"
+      expect(failing['status']).to eq('failed')
+      expect(failing['file_path']).to eq('features/reporter_failure.feature')
+      expect(failing['failure']['message']).to start_with(
+        'Then the reporter records this failure (features/reporter_failure.feature:5)'
+      )
+      screenshot = failing['attachments'].find { |a| a['name'] == 'screenshot' }
+      expect(screenshot).not_to be_nil, "No screenshot attachment: #{failing['attachments']}"
+      expect(screenshot['content_type']).to eq('image/png')
+    end
+  end
+
+  # Runs the project's features plus a deliberately failing scenario, then removes that scenario again
+  def run_cucumber_with_failure(project)
+    add_failing_cucumber_scenario(project)
+    FileUtils.rm_rf(File.join(project, 'raider-results'))
+    run_cucumber(project)
+  ensure
+    remove_failing_cucumber_scenario(project)
+  end
+
+  # Adds a scenario that always fails at its last step, after the browser has been started
+  def add_failing_cucumber_scenario(project)
+    File.write(File.join(project, 'features/reporter_failure.feature'), <<~FEATURE)
+      Feature: Reporter failure
+
+      Scenario: A deliberately failing scenario
+          Given the reporter has a started scenario
+          Then the reporter records this failure
+    FEATURE
+    File.write(File.join(project, 'features/step_definitions/reporter_failure_steps.rb'), <<~STEPS)
+      # frozen_string_literal: true
+
+      Given('the reporter has a started scenario') {}
+
+      Then('the reporter records this failure') do
+        raise 'deliberate failure for raider_reporter'
+      end
+    STEPS
+  end
+
+  # Keeps the deliberate failure from leaking into the other examples that share the project
+  def remove_failing_cucumber_scenario(project)
+    FileUtils.rm_f(File.join(project, 'features/reporter_failure.feature'))
+    FileUtils.rm_f(File.join(project, 'features/step_definitions/reporter_failure_steps.rb'))
   end
 
   # Test Web Frameworks (these can run without external services)

data/spec/integration/generators/helpers_generator_spec.rb

@@ -5,8 +5,12 @@ require_relative '../spec_helper'
 
 describe HelpersGenerator do
   shared_examples 'creates common helpers' do |name|
-    it 'creates an allure helper file' do
-      expect(File).to exist("#{name}/helpers/allure_helper.rb")
+    it 'creates an allure helper file only for rspec projects' do
+      if name.start_with?(FrameworkIndex::CUCUMBER)
+        expect(File).not_to exist("#{name}/helpers/allure_helper.rb")
+      else
+        expect(File).to exist("#{name}/helpers/allure_helper.rb")
+      end
     end
   end
 
@@ -101,5 +105,4 @@ describe HelpersGenerator do
     include_examples 'creates cucumber helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
     include_examples 'creates cross platform helpers', "#{FrameworkIndex::CUCUMBER}_#{AutomationIndex::CROSS_PLATFORM}"
   end
-
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: ruby_raider
 version: !ruby/object:Gem::Version
-  version: 3.3.0
+  version: 3.5.0
 platform: ruby
 authors:
 - Agustin Pequeno
 bindir: bin
 cert_chain: []
-date: 2026-10-11 00:00:00.000000000 Z
+date: 2026-10-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -306,6 +306,7 @@ files:
 - spec/integration/content/common_content_spec.rb
 - spec/integration/content/config_content_spec.rb
 - spec/integration/content/content_helper.rb
+- spec/integration/content/cucumber_reporter_content_spec.rb
 - spec/integration/content/gemfile_content_spec.rb
 - spec/integration/content/helper_content_spec.rb
 - spec/integration/content/page_content_spec.rb
@@ -346,7 +347,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.1.0
+      version: 3.2.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="