RSpec × Testers.AI

Install

include Testersai::RSpec in spec_helper; the testersai method and be_testersai_clean matcher become available.

# Download testersai-ruby-rspec-0.1.0.tar.gz from the Downloads page, then:
tar -xzf testersai-ruby-rspec-0.1.0.tar.gz
cd testersai-ruby-rspec-0.1.0
(cd testersai && gem build *.gemspec && gem install *.gem)

Example

A complete, runnable Ruby + RSpec example.

require "rspec_testersai"
RSpec.configure { |c| c.include Testersai::RSpec }

RSpec.describe "home page" do
  it "is clean" do
    shot = testersai.screenshot(File.binread("home.png"))
    expect(shot).to be_testersai_clean
  end
end

How it flows

RSpec example metadata + matcher failure messages. If the AI call fails — rate limit, hang, firewall, no network — the SDK gives up fast and returns a skipped result. Your RSpec test is never blocked.

Where & when to put checks

Rule of thumb: wherever a human reviewer would pause to look during a manual run. These recommendations are tuned for RSpec — pick the ones that fit your suite.

Value: what you get for three extra lines

• ✓
  Free upgrade to your existing RSpec code.

  No rewrites, no new dashboard, no new runner — reuse every selector, fixture, and helper you already built.
• ✓
  Findings land in the RSpec report.

  RSpec example metadata + matcher failure messages.
• ✓
  Optional TMS integration.

  Set a few env vars and qualifying findings auto-log to Jira / Xray / TestRail / Cypress Cloud. Broken TMS never fails your test.
• ✓
  Never blocks the suite.

  Capped retries, hard deadline, graceful skip under load. Verified against mock hang/reset/429/403/DNS-failure.

Download

Or grab the monolith ZIP (all languages, all adapters).

Other Ruby combinations

MinitestSelenium (Ruby)