regresso 0.1.0

data/lib/regresso/rspec/shared_examples.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "regresso/rspec"
+
+::RSpec.shared_examples "regresso:api_regression" do |config|
+  config[:patterns].each do |pattern|
+    context(pattern[:name] || pattern[:endpoint]) do
+      it "has no regression" do
+        old_source = Regresso::Adapters::Http.new(
+          base_url: config[:old_base_url],
+          endpoint: pattern[:endpoint],
+          params: pattern[:params] || {},
+          headers: pattern[:headers] || {}
+        )
+
+        new_source = Regresso::Adapters::Http.new(
+          base_url: config[:new_base_url],
+          endpoint: pattern[:endpoint],
+          params: pattern[:params] || {},
+          headers: pattern[:headers] || {}
+        )
+
+        expect(new_source)
+          .to have_no_regression_from(old_source)
+          .with_tolerance(config[:tolerance] || 0.0)
+          .ignoring(*(config[:ignore_paths] || []))
+      end
+    end
+  end
+end
+
+::RSpec.shared_examples "regresso:csv_regression" do |config|
+  it "CSV export has no regression" do
+    old_csv = config[:old_csv_source].call
+    new_csv = config[:new_csv_source].call
+
+    expect(new_csv)
+      .to have_no_regression_from(old_csv)
+      .with_tolerance(config[:tolerance] || 0.0)
+      .ignoring(*(config[:ignore_columns] || []))
+  end
+end

data/lib/regresso/rspec.rb

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+
+require "regresso"
+require "regresso/snapshot_manager"
+
+module Regresso
+  # RSpec integration for Regresso.
+  module RSpec
+    # Custom matchers for regression and snapshot comparisons.
+    module Matchers
+      extend ::RSpec::Matchers::DSL
+
+      matcher :have_no_regression_from do |source_a|
+        match do |source_b|
+          @config = build_config
+          @comparator = Regresso::Comparator.new(
+            source_a: normalize_source(source_a),
+            source_b: normalize_source(source_b),
+            config: @config
+          )
+          @result = @comparator.compare
+          @result.passed?
+        end
+
+        chain :with_tolerance do |tolerance|
+          @tolerance = tolerance
+        end
+
+        chain :ignoring do |*paths|
+          @ignore_paths = paths.flatten
+        end
+
+        chain :with_path_tolerance do |path, tolerance|
+          @path_tolerances ||= {}
+          @path_tolerances[path] = tolerance
+        end
+
+        chain :order_insensitive do
+          @order_insensitive = true
+        end
+
+        failure_message do
+          message = "Expected no regression, but found #{@result.meaningful_diffs.size} difference(s):\n\n"
+          @result.meaningful_diffs.first(10).each do |diff|
+            message += "  - #{diff}\n"
+          end
+          if @result.meaningful_diffs.size > 10
+            message += "  ... and #{@result.meaningful_diffs.size - 10} more\n"
+          end
+          message
+        end
+
+        failure_message_when_negated do
+          "Expected regression, but none found"
+        end
+
+        private
+
+        def build_config
+          Regresso::Configuration.new.tap do |config|
+            config.default_tolerance = @tolerance if @tolerance
+            config.ignore_paths = @ignore_paths if @ignore_paths
+            config.tolerance_overrides = @path_tolerances if @path_tolerances
+            config.array_order_sensitive = !@order_insensitive
+          end
+        end
+
+        def normalize_source(source)
+          case source
+          when Regresso::Adapters::Base
+            source
+          when Hash
+            if source[:url] || source[:base_url]
+              base_url = source[:base_url] || source[:url]
+              Regresso::Adapters::Http.new(**source.merge(base_url: base_url).reject { |k, _| k == :url })
+            elsif source[:path] && source[:path].to_s.end_with?(".csv")
+              Regresso::Adapters::Csv.new(**source)
+            elsif source[:path]
+              Regresso::Adapters::JsonFile.new(**source)
+            else
+              Regresso::Adapters::Proc.new { source }
+            end
+          when String
+            if source.end_with?(".csv")
+              Regresso::Adapters::Csv.new(path: source)
+            else
+              Regresso::Adapters::JsonFile.new(path: source)
+            end
+          when ::Proc
+            Regresso::Adapters::Proc.new(source)
+          else
+            Regresso::Adapters::Proc.new { source }
+          end
+        end
+      end
+
+      matcher :match_snapshot do |snapshot_name|
+        match do |actual|
+          @snapshot_manager = Regresso::SnapshotManager.new
+          @snapshot_path = @snapshot_manager.path_for(snapshot_name)
+
+          if ENV["UPDATE_SNAPSHOTS"] || !File.exist?(@snapshot_path)
+            @snapshot_manager.save(snapshot_name, actual)
+            true
+          else
+            @config = build_snapshot_config
+            expected = @snapshot_manager.load(snapshot_name)
+            differ = Regresso::Differ.new(@config)
+            @diffs = differ.diff(expected, actual)
+            @diffs.empty?
+          end
+        end
+
+        chain :with_tolerance do |tolerance|
+          @tolerance = tolerance
+        end
+
+        chain :ignoring do |*paths|
+          @ignore_paths = paths.flatten
+        end
+
+        failure_message do
+          "Snapshot mismatch for '#{snapshot_name}':\n" +
+            @diffs.first(10).map { |diff| "  - #{diff}" }.join("\n")
+        end
+
+        private
+
+        def build_snapshot_config
+          Regresso::Configuration.new.tap do |config|
+            config.default_tolerance = @tolerance || 0.0
+            config.ignore_paths = @ignore_paths || []
+          end
+        end
+      end
+    end
+  end
+end
+
+::RSpec.configure do |config|
+  config.include Regresso::RSpec::Matchers
+end

data/lib/regresso/snapshot_manager.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require "json"
+require "fileutils"
+
+module Regresso
+  # Manages JSON snapshots on disk.
+  class SnapshotManager
+    # Default directory for stored snapshots.
+    DEFAULT_DIR = "spec/snapshots/regresso"
+
+    # @param base_dir [String,nil]
+    def initialize(base_dir: nil)
+      @base_dir = base_dir || DEFAULT_DIR
+    end
+
+    # @param name [String]
+    # @return [String]
+    def path_for(name)
+      File.join(@base_dir, "#{name}.json")
+    end
+
+    # @param name [String]
+    # @param data [Object]
+    # @return [void]
+    def save(name, data)
+      path = path_for(name)
+      FileUtils.mkdir_p(File.dirname(path))
+      File.write(path, JSON.pretty_generate(data))
+    end
+
+    # @param name [String]
+    # @return [Object]
+    def load(name)
+      JSON.parse(File.read(path_for(name)))
+    end
+
+    # @param name [String]
+    # @return [Boolean]
+    def exists?(name)
+      File.exist?(path_for(name))
+    end
+
+    # @param name [String]
+    # @return [void]
+    def delete(name)
+      FileUtils.rm_f(path_for(name))
+    end
+
+    # @return [Array<String>]
+    def list
+      Dir.glob(File.join(@base_dir, "*.json")).map do |path|
+        File.basename(path, ".json")
+      end
+    end
+  end
+end

data/lib/regresso/tasks/ci.rake

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "regresso/parallel"
+require "regresso/ci"
+
+namespace :regresso do
+  desc "Run regression comparisons and write JUnit XML"
+  task :run, [:comparisons_file, :output] do |_task, args|
+    file = args[:comparisons_file] || ENV["REGRESSO_COMPARISONS"]
+    raise "comparisons file is required" unless file
+    raise "comparisons file not found: #{file}" unless File.exist?(file)
+
+    load file
+    comparisons = Object.const_get("REGRESSO_COMPARISONS")
+
+    runner = Regresso::Parallel::Runner.new(comparisons: comparisons)
+    result = runner.run
+    reporter = Regresso::CI::Reporter.new(result)
+
+    output = args[:output] || ENV["REGRESSO_JUNIT_XML"] || "tmp/regresso-junit.xml"
+    FileUtils.mkdir_p(File.dirname(output))
+    reporter.write_junit_xml(output)
+
+    puts "Regresso result: #{result.summary}"
+  end
+
+  desc "Post Regresso report as a GitHub PR comment"
+  task :comment_pr, [:comparisons_file] do |_task, args|
+    token = ENV["GITHUB_TOKEN"]
+    repo = ENV["GITHUB_REPOSITORY"]
+    pr_number = ENV["GITHUB_PR_NUMBER"]&.to_i
+
+    raise "GITHUB_TOKEN is required" unless token
+    raise "GITHUB_REPOSITORY is required" unless repo
+    raise "GITHUB_PR_NUMBER is required" unless pr_number
+
+    file = args[:comparisons_file] || ENV["REGRESSO_COMPARISONS"]
+    raise "comparisons file is required" unless file
+    raise "comparisons file not found: #{file}" unless File.exist?(file)
+
+    load file
+    comparisons = Object.const_get("REGRESSO_COMPARISONS")
+
+    runner = Regresso::Parallel::Runner.new(comparisons: comparisons)
+    result = runner.run
+
+    commenter = Regresso::CI::GitHubPRCommenter.new(token: token, repo: repo, pr_number: pr_number)
+    commenter.post_comment(result)
+  end
+end

data/lib/regresso/tasks/history.rake

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "fileutils"
+require "regresso/history"
+
+namespace :regresso do
+  namespace :history do
+    desc "Print history statistics"
+    task :stats, [:period] do |_task, args|
+      store = Regresso::History::Store.new
+      stats = store.statistics(period: (args[:period] || :week).to_sym)
+      puts stats
+    end
+
+    desc "Generate history trend report"
+    task :report, [:output, :period] do |_task, args|
+      store = Regresso::History::Store.new
+      reporter = Regresso::History::TrendReporter.new(store)
+      output = args[:output] || "tmp/regresso_trends.html"
+      FileUtils.mkdir_p(File.dirname(output))
+      File.write(output, reporter.generate(period: (args[:period] || :week).to_sym))
+      puts "Wrote #{output}"
+    end
+
+    desc "Cleanup history entries older than given days"
+    task :cleanup, [:days] do |_task, args|
+      days = (args[:days] || 30).to_i
+      cutoff = Time.now - (60 * 60 * 24 * days)
+
+      backend = Regresso::History::FileBackend.new
+      backend.all.each do |entry|
+        backend.delete(entry.id) if entry.timestamp < cutoff
+      end
+    end
+  end
+end

data/lib/regresso/templates/report.html.erb

@@ -0,0 +1,44 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <title>Regresso Report</title>
+    <style>
+      body { font-family: Arial, sans-serif; margin: 24px; }
+      table { border-collapse: collapse; width: 100%; margin-top: 16px; }
+      th, td { border: 1px solid #ddd; padding: 8px; text-align: left; }
+      th { background: #f4f4f4; }
+      .diff-added { color: #0a7d00; }
+      .diff-removed { color: #a40000; }
+      .diff-changed { color: #0a4aa8; }
+    </style>
+  </head>
+  <body>
+    <h1>Regresso Report</h1>
+
+    <p><strong>Passed:</strong> <%= @result.passed? %></p>
+    <p><strong>Total diffs:</strong> <%= @result.diffs.size %></p>
+    <p><strong>Meaningful diffs:</strong> <%= @result.meaningful_diffs.size %></p>
+
+    <table>
+      <thead>
+        <tr>
+          <th>Path</th>
+          <th>Old</th>
+          <th>New</th>
+          <th>Type</th>
+        </tr>
+      </thead>
+      <tbody>
+        <% @result.meaningful_diffs.each do |diff| %>
+          <tr>
+            <td><%= diff.path.to_s %></td>
+            <td><%= diff.old_value.inspect %></td>
+            <td><%= diff.new_value.inspect %></td>
+            <td class="diff-<%= diff.type %>"><%= diff.type %></td>
+          </tr>
+        <% end %>
+      </tbody>
+    </table>
+  </body>
+</html>

data/lib/regresso/version.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module Regresso
+  # Gem version string.
+  VERSION = "0.1.0"
+end

data/lib/regresso/web_ui/diff_formatter.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require "cgi"
+
+module Regresso
+  module WebUI
+    # Formats diffs for Web UI rendering.
+    class DiffFormatter
+      # @param diffs [Array<Hash>]
+      # @param mode [Symbol] :html or :plain
+      # @return [String]
+      def format(diffs, mode: :html)
+        case mode
+        when :html
+          diffs.map { |diff| format_html(diff) }.join("\n")
+        when :plain
+          diffs.map { |diff| format_plain(diff) }.join("\n")
+        else
+          raise ArgumentError, "Unknown format: #{mode}"
+        end
+      end
+
+      private
+
+      def format_html(diff)
+        type = CGI.escapeHTML(diff["type"].to_s)
+        path = CGI.escapeHTML(diff["path"].to_s)
+        old_value = CGI.escapeHTML(diff["old_value"].inspect)
+        new_value = CGI.escapeHTML(diff["new_value"].inspect)
+
+        <<~HTML.strip
+          <div class="diff-row diff-#{type}">
+            <span class="diff-path">#{path}</span>
+            <span class="diff-old">#{old_value}</span>
+            <span class="diff-new">#{new_value}</span>
+            <span class="diff-type">#{type}</span>
+          </div>
+        HTML
+      end
+
+      def format_plain(diff)
+        "#{diff['path']}: #{diff['old_value'].inspect} -> #{diff['new_value'].inspect}"
+      end
+    end
+  end
+end

data/lib/regresso/web_ui/public/css/app.css

@@ -0,0 +1,239 @@
+:root {
+  --bg: #f4f1ea;
+  --ink: #1b1b1b;
+  --muted: #6c6c6c;
+  --accent: #d74b23;
+  --accent-2: #1d4d9f;
+  --surface: #ffffff;
+  --shadow: rgba(22, 22, 22, 0.15);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+body {
+  margin: 0;
+  font-family: "Space Grotesk", "Avenir Next", "Futura", sans-serif;
+  color: var(--ink);
+  background: radial-gradient(circle at top left, #fbe7d5, transparent 55%),
+    radial-gradient(circle at 20% 80%, #d2e2ff, transparent 50%),
+    var(--bg);
+  min-height: 100vh;
+}
+
+.app-shell {
+  padding: 32px clamp(16px, 4vw, 48px) 48px;
+  animation: fadeIn 0.6s ease-out;
+}
+
+.app-header {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 24px;
+  align-items: flex-end;
+  justify-content: space-between;
+}
+
+.kicker {
+  text-transform: uppercase;
+  letter-spacing: 0.12em;
+  font-size: 12px;
+  margin: 0 0 6px;
+  color: var(--accent-2);
+}
+
+h1 {
+  margin: 0;
+  font-size: clamp(32px, 4vw, 52px);
+}
+
+.subtitle {
+  margin: 8px 0 0;
+  color: var(--muted);
+  max-width: 520px;
+}
+
+.stats {
+  display: grid;
+  grid-template-columns: repeat(3, minmax(80px, 1fr));
+  gap: 12px;
+}
+
+.stat {
+  background: rgba(255, 255, 255, 0.75);
+  border-radius: 16px;
+  padding: 12px 16px;
+  box-shadow: 0 10px 24px var(--shadow);
+  backdrop-filter: blur(6px);
+}
+
+.stat-label {
+  font-size: 12px;
+  color: var(--muted);
+}
+
+.stat-value {
+  display: block;
+  font-size: 20px;
+  font-weight: 600;
+}
+
+.app-main {
+  display: grid;
+  grid-template-columns: minmax(240px, 320px) minmax(0, 1fr);
+  gap: 24px;
+  margin-top: 32px;
+}
+
+.panel {
+  background: var(--surface);
+  border-radius: 20px;
+  padding: 20px;
+  box-shadow: 0 18px 40px var(--shadow);
+}
+
+.panel-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 12px;
+  margin-bottom: 16px;
+}
+
+.button {
+  border: none;
+  background: var(--accent);
+  color: white;
+  padding: 10px 16px;
+  border-radius: 999px;
+  font-weight: 600;
+  cursor: pointer;
+  transition: transform 0.2s ease, box-shadow 0.2s ease;
+}
+
+.button:hover {
+  transform: translateY(-2px);
+  box-shadow: 0 8px 16px rgba(215, 75, 35, 0.35);
+}
+
+.list {
+  display: grid;
+  gap: 12px;
+}
+
+.list-item {
+  border: 1px solid #e5e5e5;
+  border-radius: 16px;
+  padding: 14px;
+  cursor: pointer;
+  transition: border 0.2s ease, transform 0.2s ease, box-shadow 0.2s ease;
+  background: #fff8f1;
+}
+
+.list-item:hover {
+  border-color: var(--accent);
+  transform: translateY(-2px);
+  box-shadow: 0 10px 18px rgba(215, 75, 35, 0.2);
+}
+
+.list-item.active {
+  border-color: var(--accent-2);
+  background: #eef4ff;
+}
+
+.detail-grid {
+  display: grid;
+  gap: 16px;
+}
+
+.summary {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(120px, 1fr));
+  gap: 12px;
+}
+
+.summary-card {
+  padding: 12px 14px;
+  border-radius: 14px;
+  background: #f7f7f7;
+}
+
+.summary-card strong {
+  display: block;
+  font-size: 18px;
+}
+
+.diffs {
+  min-height: 240px;
+  border-radius: 16px;
+  background: #fdfdfd;
+  border: 1px solid #e9e9e9;
+  padding: 16px;
+  display: grid;
+  gap: 8px;
+}
+
+.diff-row {
+  display: grid;
+  grid-template-columns: 1fr 1fr 1fr auto;
+  gap: 12px;
+  padding: 8px 10px;
+  border-radius: 10px;
+  background: #ffffff;
+  border: 1px solid #f0f0f0;
+  font-size: 13px;
+}
+
+.diff-added {
+  border-left: 4px solid #2c9f45;
+}
+
+.diff-removed {
+  border-left: 4px solid #d35454;
+}
+
+.diff-changed {
+  border-left: 4px solid #3c6fd1;
+}
+
+.diff-path {
+  font-weight: 600;
+}
+
+.detail-meta {
+  color: var(--muted);
+  margin: 6px 0 0;
+}
+
+.filters {
+  display: flex;
+  gap: 10px;
+  align-items: center;
+}
+
+.input,
+.select {
+  border-radius: 999px;
+  border: 1px solid #ddd;
+  padding: 8px 14px;
+  font-size: 14px;
+  background: #fff;
+}
+
+.empty {
+  color: var(--muted);
+  text-align: center;
+  margin-top: 40px;
+}
+
+@media (max-width: 900px) {
+  .app-main {
+    grid-template-columns: 1fr;
+  }
+}
+
+@keyframes fadeIn {
+  from { opacity: 0; transform: translateY(10px); }
+  to { opacity: 1; transform: translateY(0); }
+}