rails_benchmark_suite 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 67247c6ec0477941501c1ab15dcbfabd044faa44e790a55e3cf522013bdced08
+  data.tar.gz: bbeab62787dc1a0a2d09dd0069ba3fd963a76de3a15fcdd950c49e0d36a8e388
+SHA512:
+  metadata.gz: c66eaaedc346d2f66f36412d3032de8ef516cca05a2b36c603e3b449ec3ace814370e5347df5ce59acf0126fb3b10c16e5c91950b6a7e3d3a8f5e326d6b92452
+  data.tar.gz: f0cccded74018456e96b160301e59f0beb4bf787146b4f3939d63e999e48a040c256c8bb17bac3e9b7e41c68895b21dd96827cc2cb4ed54408a402b6a6927b53

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle/
+vendor/bundle/
+Gemfile.lock
+.ruby-lsp/

data/.ruby-version

@@ -0,0 +1 @@
+3.4.1

data/CHANGELOG.md

@@ -0,0 +1,25 @@
+# Changelog
+
+## [0.2.0] - 2025-12-31
+
+### Added
+- **Suite Expansion**: Added 4 new "Omakase" benchmark suites:
+  - `ViewHeft`: ActionView ERB rendering performance.
+  - `ImageHeft`: ActiveStorage/Libvips image resizing.
+  - `CacheHeft`: In-memory key/value throughput (SolidCache simulation).
+  - `SearchHeft`: ActiveRecord text search queries.
+- **Reporting**: Added `--json` flag for CI/CD compatible output.
+- **Scoring**: Re-calibrated scoring weights:
+  - Active Record: 40%
+  - Job Processing: 20%
+  - View Rendering: 20%
+  - Image Processing: 10%
+  - Cache Operations: 10%
+
+### Changed
+- **Dependencies**: Added `actionview`, `activestorage`, `image_processing` as runtime dependencies.
+- **Calibration**: Adjusted weights to better reflect "Heft" on modern applications.
+
+## [0.1.0] - 2025-12-29
+- Initial Release ("Rails Awareness" update).
+- CLI auto-detects Rails environment.

data/Gemfile

@@ -0,0 +1,5 @@
+source "https://rubygems.org"
+
+gemspec
+
+ruby "3.4.1"

data/Gemfile.lock

@@ -0,0 +1,175 @@
+PATH
+  remote: .
+  specs:
+    rails_benchmark_suite (0.2.0)
+      actionview
+      activerecord
+      activestorage
+      benchmark-ips
+      concurrent-ruby
+      get_process_mem
+      image_processing
+      sqlite3
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    actionpack (8.1.1)
+      actionview (= 8.1.1)
+      activesupport (= 8.1.1)
+      nokogiri (>= 1.8.5)
+      rack (>= 2.2.4)
+      rack-session (>= 1.0.1)
+      rack-test (>= 0.6.3)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+      useragent (~> 0.16)
+    actionview (8.1.1)
+      activesupport (= 8.1.1)
+      builder (~> 3.1)
+      erubi (~> 1.11)
+      rails-dom-testing (~> 2.2)
+      rails-html-sanitizer (~> 1.6)
+    activejob (8.1.1)
+      activesupport (= 8.1.1)
+      globalid (>= 0.3.6)
+    activemodel (8.1.1)
+      activesupport (= 8.1.1)
+    activerecord (8.1.1)
+      activemodel (= 8.1.1)
+      activesupport (= 8.1.1)
+      timeout (>= 0.4.0)
+    activestorage (8.1.1)
+      actionpack (= 8.1.1)
+      activejob (= 8.1.1)
+      activerecord (= 8.1.1)
+      activesupport (= 8.1.1)
+      marcel (~> 1.0)
+    activesupport (8.1.1)
+      base64
+      bigdecimal
+      concurrent-ruby (~> 1.0, >= 1.3.1)
+      connection_pool (>= 2.2.5)
+      drb
+      i18n (>= 1.6, < 2)
+      json
+      logger (>= 1.4.2)
+      minitest (>= 5.1)
+      securerandom (>= 0.3)
+      tzinfo (~> 2.0, >= 2.0.5)
+      uri (>= 0.13.1)
+    base64 (0.3.0)
+    benchmark-ips (2.14.0)
+    bigdecimal (4.0.1)
+    builder (3.3.0)
+    concurrent-ruby (1.3.6)
+    connection_pool (3.0.2)
+    crass (1.0.6)
+    drb (2.2.3)
+    erubi (1.13.1)
+    ffi (1.17.3-aarch64-linux-gnu)
+    ffi (1.17.3-aarch64-linux-musl)
+    ffi (1.17.3-arm-linux-gnu)
+    ffi (1.17.3-arm-linux-musl)
+    ffi (1.17.3-arm64-darwin)
+    ffi (1.17.3-x86-linux-gnu)
+    ffi (1.17.3-x86-linux-musl)
+    ffi (1.17.3-x86_64-darwin)
+    ffi (1.17.3-x86_64-linux-gnu)
+    ffi (1.17.3-x86_64-linux-musl)
+    get_process_mem (1.0.0)
+      bigdecimal (>= 2.0)
+      ffi (~> 1.0)
+    globalid (1.3.0)
+      activesupport (>= 6.1)
+    i18n (1.14.8)
+      concurrent-ruby (~> 1.0)
+    image_processing (1.14.0)
+      mini_magick (>= 4.9.5, < 6)
+      ruby-vips (>= 2.0.17, < 3)
+    json (2.18.0)
+    logger (1.7.0)
+    loofah (2.25.0)
+      crass (~> 1.0.2)
+      nokogiri (>= 1.12.0)
+    marcel (1.1.0)
+    mini_magick (5.3.1)
+      logger
+    mini_portile2 (2.8.9)
+    minitest (6.0.1)
+      prism (~> 1.5)
+    nokogiri (1.19.0)
+      mini_portile2 (~> 2.8.2)
+      racc (~> 1.4)
+    nokogiri (1.19.0-aarch64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.19.0-aarch64-linux-musl)
+      racc (~> 1.4)
+    nokogiri (1.19.0-arm-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.19.0-arm-linux-musl)
+      racc (~> 1.4)
+    nokogiri (1.19.0-arm64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.19.0-x86_64-darwin)
+      racc (~> 1.4)
+    nokogiri (1.19.0-x86_64-linux-gnu)
+      racc (~> 1.4)
+    nokogiri (1.19.0-x86_64-linux-musl)
+      racc (~> 1.4)
+    prism (1.7.0)
+    racc (1.8.1)
+    rack (3.2.4)
+    rack-session (2.1.1)
+      base64 (>= 0.1.0)
+      rack (>= 3.0.0)
+    rack-test (2.2.0)
+      rack (>= 1.3)
+    rails-dom-testing (2.3.0)
+      activesupport (>= 5.0.0)
+      minitest
+      nokogiri (>= 1.6)
+    rails-html-sanitizer (1.6.2)
+      loofah (~> 2.21)
+      nokogiri (>= 1.15.7, != 1.16.7, != 1.16.6, != 1.16.5, != 1.16.4, != 1.16.3, != 1.16.2, != 1.16.1, != 1.16.0.rc1, != 1.16.0)
+    rake (13.3.1)
+    ruby-vips (2.3.0)
+      ffi (~> 1.12)
+      logger
+    securerandom (0.4.1)
+    sqlite3 (2.9.0-aarch64-linux-gnu)
+    sqlite3 (2.9.0-aarch64-linux-musl)
+    sqlite3 (2.9.0-arm-linux-gnu)
+    sqlite3 (2.9.0-arm-linux-musl)
+    sqlite3 (2.9.0-arm64-darwin)
+    sqlite3 (2.9.0-x86-linux-gnu)
+    sqlite3 (2.9.0-x86-linux-musl)
+    sqlite3 (2.9.0-x86_64-darwin)
+    sqlite3 (2.9.0-x86_64-linux-gnu)
+    sqlite3 (2.9.0-x86_64-linux-musl)
+    timeout (0.6.0)
+    tzinfo (2.0.6)
+      concurrent-ruby (~> 1.0)
+    uri (1.1.1)
+    useragent (0.16.11)
+
+PLATFORMS
+  aarch64-linux-gnu
+  aarch64-linux-musl
+  arm-linux-gnu
+  arm-linux-musl
+  arm64-darwin
+  x86-linux-gnu
+  x86-linux-musl
+  x86_64-darwin
+  x86_64-linux-gnu
+  x86_64-linux-musl
+
+DEPENDENCIES
+  bundler
+  minitest
+  rails_benchmark_suite!
+  rake
+
+BUNDLED WITH
+   2.5.9

data/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 overnet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,77 @@
+# Rails Benchmark Suite
+
+A standardized performance suite designed to measure the "Heft" of a machine using realistic, high-throughput Rails 8+ workloads.
+
+Unlike synthetic CPU benchmarks, **Rails Benchmark Suite** simulates Active Record object allocation, SQL query complexity, ActionView rendering, and background job throughput.
+
+## 📊 The "Heft" Score
+
+The Heft Score is a weighted metric representing a machine's ability to handle Rails tasks. 
+- **Baseline:** A score of **100** is calibrated to represent an **AWS c6g.large** (ARM) instance.
+- **Objective:** To provide a simple, comparable number for evaluating different computing platforms (Cloud VMs, bare-metal, or local dev rigs).
+
+### Baseline Comparisons
+| Score | Classification | Comparable Hardware |
+| :--- | :--- | :--- |
+| < 40 | 🐢 Sluggish | Older Intel Macs, Entry-level VPS |
+| 60 | 🚙 Capable | Standard Cloud VM (c5.large/standard) |
+| **100** | **🏎️ Baseline** | **AWS c6g.large (2 vCPU ARM)** |
+| 150+ | 🚀 High Performance | Apple M-series Pro/Max, Ryzen 5000+ |
+| 300+ | ⚡ Blazing | Server-grade Metal, M3 Ultra |
+
+## 🛠 Technical Philosophy
+
+Rails Benchmark Suite prioritizes **Benchmarking** (via `benchmark-ips`) over **Profiling**.
+
+* **Benchmarking:** Focuses on macro-throughput—"How many iterations can the hardware handle?" This provides the final Heft Score.
+* **Why no Profiling?** Profiling tools (like `StackProf` or `Vernier`) introduce instrumentation overhead that skews hardware metrics. We aim for "Conceptual Compression"—one clear number to inform infrastructure decisions.
+
+## 🚀 Installation & Usage
+
+### Prerequisites
+* **Ruby:** 3.4.1+ (Recommended for latest YJIT/Prism performance)
+* **Database:** SQLite3
+
+### Standalone Usage
+If you want to test hardware performance without an existing application:
+
+```bash
+git clone https://github.com/overnet/rails_benchmark_suite.git
+cd rails_benchmark_suite
+bundle install
+bin/rails_benchmark_suite
+```
+
+### Use within a Rails Application
+Rails Benchmark Suite is "Rails-aware." Adding it to your app allows you to benchmark your specific configuration and custom suites.
+
+Add to your Gemfile:
+
+```ruby
+gem "rails_benchmark_suite", group: :development
+```
+
+Run via bundle:
+
+```bash
+bundle exec rails_benchmark_suite
+```
+
+> **Note:** Use `--skip-rails` to ignore the host application and run in isolated mode.
+
+## 🏗 Architecture
+* **Engine:** Built on `benchmark-ips`.
+* **Database:** Uses In-Memory SQLite with `cache=shared` for multi-threaded accuracy.
+* **Isolation:** Uses transactional rollbacks (`ActiveRecord::Rollback`) to ensure test isolation without the overhead of row deletion.
+* **Threading:** Supports 1-thread and 4-thread scaling tests to measure vertical efficiency.
+* **Modern Stack:** Optimized for Rails 8+ defaults, including Solid Queue simulation and YJIT detection.
+
+## 📜 Credits
+This project is a functional implementation of the performance benchmark vision discussed in the Rails community.
+
+* **Vision:** Inspired by @dhh in [rails/rails#50451](https://github.com/rails/rails/issues/50451).
+* **Initial Roadmap:** Based on suggestions by @JoeDupuis.
+* **Implementation:** The Rails Community.
+
+## 📄 License
+The gem is available as open source under the terms of the MIT License.

data/Rakefile

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rake/testtask"
+
+Rake::TestTask.new do |t|
+  t.libs << "test"
+  t.libs << "lib"
+  t.test_files = FileList["test/**/*_test.rb"]
+end
+
+task default: :test

data/bin/rails_benchmark_suite

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "optparse"
+$LOAD_PATH.unshift File.expand_path("../lib", __dir__)
+require "rails_benchmark_suite"
+require "rails_benchmark_suite/version"
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Usage: rails_benchmark_suite [options]"
+
+  opts.on("-v", "--version", "Print version") do
+    puts "RailsBenchmarkSuite v#{RailsBenchmarkSuite::VERSION}"
+    exit 0
+  end
+
+  opts.on("--skip-rails", "Skip Rails environment loading") do
+    options[:skip_rails] = true
+  end
+
+  opts.on("-j", "--json", "Output results as JSON") do
+    options[:json] = true
+  end
+
+  opts.on("-h", "--help", "Prints this help") do
+    puts opts
+    exit 0
+  end
+end.parse!
+
+puts "RailsBenchmarkSuite v#{RailsBenchmarkSuite::VERSION}"
+
+# Rails Detection
+rails_env_path = File.join(Dir.pwd, "config", "environment.rb")
+
+if !options[:skip_rails] && File.exist?(rails_env_path)
+  puts "Rails environment detected at #{rails_env_path}. Loading..."
+  require rails_env_path
+  puts "Rails loaded successfully."
+else
+  if options[:skip_rails]
+    puts "Skipping Rails loading (requested via --skip-rails)."
+  else
+    puts "No Rails environment detected (config/environment.rb not found)."
+  end
+end
+
+RailsBenchmarkSuite.run(json: options[:json])

data/lib/rails_benchmark_suite/db_setup.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+require "active_record"
+require "sqlite3"
+
+# Silence ActiveRecord logs during benchmarks to avoid IO bottlenecks
+ActiveRecord::Base.logger = nil
+
+# Setup In-Memory SQLite globally for all suites
+# storage_config = ActiveRecord::DatabaseConfigurations::HashConfig.new("test", "sqlite3", { adapter: "sqlite3", database: ":memory:" })
+# Use shared cache to allow threads to see the same in-memory database
+# Skip internal database setup if running within a Rails application
+unless defined?(Rails)
+  ActiveRecord::Base.establish_connection(
+    adapter: "sqlite3", 
+    database: "file:rails_benchmark_suite_mem?mode=memory&cache=shared", 
+    pool: 20,
+    timeout: 10000
+  )
+end

data/lib/rails_benchmark_suite/models/post.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module RailsBenchmarkSuite
+  module Models
+    class Post < ActiveRecord::Base
+      belongs_to :user, class_name: "RailsBenchmarkSuite::Models::User"
+    end
+  end
+end

data/lib/rails_benchmark_suite/models/simulated_job.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module RailsBenchmarkSuite
+  module Models
+    class SimulatedJob < ActiveRecord::Base
+    end
+  end
+end

data/lib/rails_benchmark_suite/models/user.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module RailsBenchmarkSuite
+  module Models
+    class User < ActiveRecord::Base
+      has_many :posts, class_name: "RailsBenchmarkSuite::Models::Post", dependent: :destroy
+    end
+  end
+end

data/lib/rails_benchmark_suite/reporter.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module RailsBenchmarkSuite
+  module Reporter
+    module_function
+
+    def system_info
+      {
+        ruby_version: RUBY_VERSION,
+        platform: RUBY_PLATFORM,
+        processors: Concurrent.processor_count,
+        libvips: libvips?,
+        yjit: yjit_enabled?
+      }
+    end
+
+    def yjit_enabled?
+      defined?(RubyVM::YJIT) && RubyVM::YJIT.enabled?
+    end
+
+    def libvips?
+      # Naive check for libvips presence
+      system("vips --version", out: File::NULL, err: File::NULL)
+    end
+  end
+end

data/lib/rails_benchmark_suite/runner.rb

@@ -0,0 +1,168 @@
+# frozen_string_literal: true
+
+require "benchmark/ips"
+require "get_process_mem"
+
+module RailsBenchmarkSuite
+  class Runner
+    def initialize(suites, json: false)
+      @suites = suites
+      @json_output = json
+    end
+
+    def register(name, &block)
+      @suites << { name: name, block: block }
+    end
+
+    def run
+      puts "Running RailsBenchmarkSuite Benchmarks..." unless @json_output
+      puts system_report unless @json_output
+      puts "\n" unless @json_output
+
+      results = {}
+
+      @suites.each do |suite|
+        puts "== Running Suite: #{suite[:name]} ==" unless @json_output
+        
+        # Capture memory before
+        mem_before = GetProcessMem.new.mb
+
+        # Run benchmark
+        report = Benchmark.ips do |x|
+          x.config(:time => 5, :warmup => 2)
+          
+          # Single Threaded
+          x.report("#{suite[:name]} (1 thread)") do
+            suite[:block].call
+          end
+
+          # Multi Threaded (4 threads)
+          x.report("#{suite[:name]} (4 threads)") do
+            threads = 4.times.map do
+              Thread.new do
+                # Ensure each thread gets a dedicated connection
+                ActiveRecord::Base.connection_pool.with_connection do
+                  suite[:block].call
+                end
+              end
+            end
+            threads.each(&:join)
+          end
+
+          x.compare!
+        end
+
+        # Capture memory after
+        mem_after = GetProcessMem.new.mb
+        
+        results[suite[:name]] = {
+          report: report,
+          memory_delta_mb: mem_after - mem_before,
+          weight: suite[:weight]
+        }
+        
+        puts "Memory Footprint: #{mem_after.round(2)} MB (+#{(mem_after - mem_before).round(2)} MB)" unless @json_output
+        puts "\n" unless @json_output
+      end
+      
+      print_summary(results)
+      results
+    end
+
+    private
+
+    def system_report
+      info = RailsBenchmarkSuite::Reporter.system_info
+      "System: Ruby #{info[:ruby_version]} (#{info[:platform]}), #{info[:processors]} Cores. YJIT: #{info[:yjit] ? 'Enabled' : 'Disabled'}. Libvips: #{info[:libvips]}"
+    end
+
+    def print_summary(results)
+      if @json_output
+        print_json(results)
+        return
+      end
+
+      puts "\n"
+      puts "=========================================================================================="
+      puts "| %-25s | %-25s | %-12s | %-15s |" % ["Suite", "IPS (1t / 4t)", "Scaling", "Mem Delta"]
+      puts "=========================================================================================="
+      
+      total_score = 0
+      
+      results.each do |name, data|
+        report = data[:report]
+        entries = report.entries
+        
+        entry_1t = entries.find { |e| e.label.include?("(1 thread)") }
+        entry_4t = entries.find { |e| e.label.include?("(4 threads)") }
+        
+        ips_1t = entry_1t ? entry_1t.ips : 0
+        ips_4t = entry_4t ? entry_4t.ips : 0
+        
+        scaling = ips_1t > 0 ? (ips_4t / ips_1t) : 0
+        mem = data[:memory_delta_mb]
+        
+        # Heft Score: Weighted Sum of 4t IPS
+        weight = data[:weight] || 1.0
+        weighted_score = ips_4t * weight
+        total_score += weighted_score
+        
+        puts "| %-25s | %-25s | x%-11.2f | +%-14.2fMB |" % [
+          name + " (w: #{weight})", 
+          "#{humanize(ips_1t)} / #{humanize(ips_4t)}",
+          scaling, 
+          mem
+        ]
+      end
+      puts "=========================================================================================="
+      puts "\n"
+      puts "  >>> FINAL HEFT SCORE: #{total_score.round(0)} <<<"
+      puts "\n"
+    end
+
+    def print_json(results)
+      require "json"
+      
+      out = {
+        system: RailsBenchmarkSuite::Reporter.system_info,
+        total_score: 0,
+        suites: []
+      }
+      
+      total_score = 0
+      
+      results.each do |name, data|
+        weight = data[:weight] || 1.0
+        
+        # Parse reports
+        ips_1t = data[:report].entries.find { |e| e.label.include?("(1 thread)") }&.ips || 0
+        ips_4t = data[:report].entries.find { |e| e.label.include?("(4 threads)") }&.ips || 0
+        
+        weighted_score = ips_4t * weight
+        total_score += weighted_score
+        
+        out[:suites] << {
+          name: name,
+          weight: weight,
+          ips_1t: ips_1t,
+          ips_4t: ips_4t,
+          scaling: ips_1t > 0 ? (ips_4t / ips_1t) : 0,
+          memory_delta_mb: data[:memory_delta_mb],
+          score: weighted_score
+        }
+      end
+      
+      out[:total_score] = total_score.round(0)
+      puts out.to_json
+    end
+
+    def humanize(ips)
+      return "0" if ips.nil?
+      if ips > 1000
+        "%.1fk" % (ips / 1000.0)
+      else
+        "%.1f" % ips
+      end
+    end
+  end
+end

data/lib/rails_benchmark_suite/schema.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+module RailsBenchmarkSuite
+  module Schema
+    def self.load
+      ActiveRecord::Schema.define do
+        # Users
+        create_table :users, force: true do |t|
+          t.string :name
+          t.string :email
+          t.timestamps
+        end
+
+        # Posts
+        create_table :posts, force: true do |t|
+          t.references :user
+          t.string :title
+          t.text :body
+          t.integer :views, default: 0
+          t.timestamps
+        end
+
+        # Simulated Jobs (for Job Heft)
+        create_table :simulated_jobs, force: true do |t|
+          t.string :queue_name
+          t.text :arguments
+          t.datetime :scheduled_at
+          t.timestamps
+        end
+        add_index :simulated_jobs, [:queue_name, :scheduled_at]
+      end
+    end
+  end
+end

data/lib/rails_benchmark_suite/suites/active_record_suite.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+require "active_record"
+
+# Benchmark Suite
+RailsBenchmarkSuite.register_suite("Active Record Heft", weight: 0.4) do
+  # Workload: Create User with Posts, Join Query, Update
+  # Use transaction rollback to keep the DB clean and avoid costly destroy callbacks
+  ActiveRecord::Base.transaction do
+    # 1. Create
+    user = RailsBenchmarkSuite::Models::User.create!(name: "Speedy Gonzales", email: "speedy@example.com")
+    
+    # 2. Create associated records (simulate some weight)
+    10.times do |i|
+      user.posts.create!(title: "Post #{i}", body: "Content " * 50)
+    end
+    
+    # 3. Complex Query (Join + Order)
+    # Unloading the relation to force execution
+    RailsBenchmarkSuite::Models::User.joins(:posts)
+                .where(users: { id: user.id })
+                .where("posts.views >= ?", 0)
+                .order("posts.created_at DESC")
+                .to_a
+    
+    # 4. Update
+    user.update!(name: "Slowpoke Rodriguez")
+    
+    # Rollback everything to leave the DB clean for next iteration
+    raise ActiveRecord::Rollback
+  end
+end

data/lib/rails_benchmark_suite/suites/cache_heft_suite.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+require "active_support/cache"
+require "securerandom"
+
+# Benchmark Suite
+RailsBenchmarkSuite.register_suite("Cache Heft", weight: 0.1) do
+  # Simulate SolidCache using MemoryStore
+  @cache ||= ActiveSupport::Cache::MemoryStore.new
+  
+  # Workload: Measure serialization and storage throughput
+  key_prefix = "cache_test_#{SecureRandom.hex(4)}"
+  
+  # 1. Bulk Write
+  1000.times do |i|
+    @cache.write("#{key_prefix}/#{i}", { data: "Precious Data " * 20, index: i })
+  end
+  
+  # 2. Bulk Read
+  1000.times do |i|
+    val = @cache.read("#{key_prefix}/#{i}")
+    next if val.nil?
+  end
+  
+  # 3. Clean up
+  @cache.clear
+end

data/lib/rails_benchmark_suite/suites/image_heft_suite.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+begin
+  require "image_processing/vips"
+  require "fileutils"
+
+  # Ensure asset directory exists
+  ASSET_DIR = File.expand_path("../../assets", __dir__)
+  FileUtils.mkdir_p(ASSET_DIR)
+  SAMPLE_IMAGE = File.join(ASSET_DIR, "sample.jpg")
+
+  RailsBenchmarkSuite.register_suite("Image Heft", weight: 0.1) do
+    # Gracefully handle missing dependencies
+    if File.exist?(SAMPLE_IMAGE)
+      ImageProcessing::Vips
+        .source(SAMPLE_IMAGE)
+        .resize_to_limit(800, 800)
+        .call
+    else
+      # Maintain benchmark stability if asset is missing
+      true
+    end
+  end
+
+rescue LoadError, StandardError => e
+  # Register a skipped suite if Libvips is unavailable
+  RailsBenchmarkSuite.register_suite("Image Heft (Skipped)", weight: 0.0) do
+    @warned ||= begin
+      warn "⚠️  [RailsBenchmarkSuite] ImageHeft skipped: #{e.message}. Install libvips to enable."
+      true
+    end
+  end
+end
+

data/lib/rails_benchmark_suite/suites/job_heft_suite.rb

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require "active_record"
+require "json"
+
+
+RailsBenchmarkSuite.register_suite("Solid Queue Heft", weight: 0.2) do
+  # Simulation: Enqueue 100 jobs, then work them off
+  
+  # 1. Enqueue Loop
+  100.times do |i|
+    RailsBenchmarkSuite::Models::SimulatedJob.create!(
+      queue_name: "default", 
+      arguments: { job_id: i, payload: "x" * 100 }.to_json,
+      scheduled_at: Time.now
+    )
+  end
+
+  # 2. Worker Loop (Drain the queue)
+  loop do
+    processed = false
+    
+    # Transactional polling
+    ActiveRecord::Base.transaction do
+      # Fetch batch
+      jobs = RailsBenchmarkSuite::Models::SimulatedJob.where("scheduled_at <= ?", Time.now).order(:created_at).limit(10)
+      
+      if jobs.any?
+        # Simulate processing time and delete
+        ids = jobs.map(&:id)
+        RailsBenchmarkSuite::Models::SimulatedJob.where(id: ids).delete_all
+        processed = true
+      end
+    end
+    
+    break unless processed
+    
+    # Simulate worker internal latency
+    sleep(0.001)
+  end
+end

data/lib/rails_benchmark_suite/suites/view_heft_suite.rb

@@ -0,0 +1,44 @@
+# frozen_string_literal: true
+
+require "action_view"
+require "ostruct"
+
+# Benchmark Suite
+
+
+# Helper for the suite
+module RailsBenchmarkSuiteNumberHelper
+  def self.number_with_delimiter(number)
+    number.to_s.gsub(/(\d)(?=(\d\d\d)+(?!\d))/, "\\1,")
+  end
+end
+
+  RailsBenchmarkSuite.register_suite("View Heft", weight: 0.2) do
+    # Setup context once
+    @view_renderer ||= begin
+      lookup_context = ActionView::LookupContext.new([File.expand_path(__dir__)])
+      ActionView::Base.with_empty_template_cache.new(lookup_context, {}, nil)
+    end
+  
+    # Workload: Render a complex ERB template
+    template = <<~ERB
+    <h1>Dashboard for <%= user.name %></h1>
+    <ul>
+      <% posts.each do |post| %>
+        <li>
+          <strong><%= post.title %></strong>
+          <p><%= post.body.truncate(50) %></p>
+          <small>Views: <%= RailsBenchmarkSuiteNumberHelper.number_with_delimiter(post.views) %></small>
+        </li>
+      <% end %>
+    </ul>
+    <footer>Generated at <%= Time.now.to_s %></footer>
+  ERB
+  
+  # Dummy Objects
+  user = OpenStruct.new(name: "Speedy")
+  posts = 100.times.map { |i| OpenStruct.new(title: "Post #{i}", body: "Content " * 10, views: i * 1000) }
+
+  # Execution
+  @view_renderer.render(inline: template, locals: { user: user, posts: posts })
+end

data/lib/rails_benchmark_suite/version.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+module RailsBenchmarkSuite
+  VERSION = "0.2.0"
+end

data/lib/rails_benchmark_suite.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "concurrent"
+require "rails_benchmark_suite/version"
+require "rails_benchmark_suite/reporter"
+require "rails_benchmark_suite/runner"
+require "rails_benchmark_suite/db_setup"
+require "rails_benchmark_suite/schema"
+require "rails_benchmark_suite/models/user"
+require "rails_benchmark_suite/models/post"
+require "rails_benchmark_suite/models/simulated_job"
+
+module RailsBenchmarkSuite
+  @suites = []
+
+  def self.register_suite(name, weight: 1.0, &block)
+    @suites << { name: name, weight: weight, block: block }
+  end
+
+  def self.run(json: false)
+    # Load Schema
+    RailsBenchmarkSuite::Schema.load
+    
+    # Load suites
+    Dir[File.join(__dir__, "rails_benchmark_suite", "suites", "*.rb")].each { |f| require f }
+    
+    runner = Runner.new(@suites, json: json)
+    runner.run
+  end
+end

data/rails_benchmark_suite.gemspec

@@ -0,0 +1,41 @@
+# frozen_string_literal: true
+
+require_relative "lib/rails_benchmark_suite/version"
+
+Gem::Specification.new do |spec|
+  spec.name          = "rails_benchmark_suite"
+  spec.version       = RailsBenchmarkSuite::VERSION
+  spec.authors       = ["RailsBenchmarkSuite Contributors"]
+  spec.email         = ["team@rails.org"]
+
+  spec.summary       = "Rails-style functionality & performance benchmark tool"
+  spec.description   = "Measures the 'Heft' (processing power) of a machine using realistic Rails workloads."
+  spec.homepage      = "https://github.com/overnet/rails_benchmark_suite"
+  spec.license       = "MIT"
+
+  spec.metadata["source_code_uri"] = "https://github.com/overnet/rails_benchmark_suite"
+  spec.metadata["bug_tracker_uri"] = "https://github.com/overnet/rails_benchmark_suite/issues"
+  spec.metadata["changelog_uri"] = "https://github.com/overnet/rails_benchmark_suite/blob/main/CHANGELOG.md"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  end
+  spec.bindir        = "bin"
+  spec.executables   = ["rails_benchmark_suite"]
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "benchmark-ips", "~> 2.14"
+  spec.add_dependency "activerecord", "~> 8.1"
+  spec.add_dependency "actionview", "~> 8.1"
+  spec.add_dependency "activestorage", "~> 8.1"
+  spec.add_dependency "image_processing", "~> 1.14"
+  spec.add_dependency "sqlite3", "~> 2.8"
+  spec.add_dependency "concurrent-ruby", "~> 1.3"
+  spec.add_dependency "get_process_mem", "~> 1.0"
+
+  spec.add_development_dependency "bundler", "~> 2.5"
+  spec.add_development_dependency "rake", "~> 13.0"
+  spec.add_development_dependency "minitest", "~> 5.0"
+
+  spec.required_ruby_version = ">= 3.4.0"
+end

metadata

@@ -0,0 +1,223 @@
+--- !ruby/object:Gem::Specification
+name: rails_benchmark_suite
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- RailsBenchmarkSuite Contributors
+bindir: bin
+cert_chain: []
+date: 2026-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: benchmark-ips
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.14'
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: actionview
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: activestorage
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '8.1'
+- !ruby/object:Gem::Dependency
+  name: image_processing
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.14'
+- !ruby/object:Gem::Dependency
+  name: sqlite3
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.8'
+- !ruby/object:Gem::Dependency
+  name: concurrent-ruby
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: get_process_mem
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.5'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+description: Measures the 'Heft' (processing power) of a machine using realistic Rails
+  workloads.
+email:
+- team@rails.org
+executables:
+- rails_benchmark_suite
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".ruby-version"
+- CHANGELOG.md
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.md
+- Rakefile
+- bin/rails_benchmark_suite
+- lib/rails_benchmark_suite.rb
+- lib/rails_benchmark_suite/db_setup.rb
+- lib/rails_benchmark_suite/models/post.rb
+- lib/rails_benchmark_suite/models/simulated_job.rb
+- lib/rails_benchmark_suite/models/user.rb
+- lib/rails_benchmark_suite/reporter.rb
+- lib/rails_benchmark_suite/runner.rb
+- lib/rails_benchmark_suite/schema.rb
+- lib/rails_benchmark_suite/suites/active_record_suite.rb
+- lib/rails_benchmark_suite/suites/cache_heft_suite.rb
+- lib/rails_benchmark_suite/suites/image_heft_suite.rb
+- lib/rails_benchmark_suite/suites/job_heft_suite.rb
+- lib/rails_benchmark_suite/suites/view_heft_suite.rb
+- lib/rails_benchmark_suite/version.rb
+- rails_benchmark_suite.gemspec
+homepage: https://github.com/overnet/rails_benchmark_suite
+licenses:
+- MIT
+metadata:
+  source_code_uri: https://github.com/overnet/rails_benchmark_suite
+  bug_tracker_uri: https://github.com/overnet/rails_benchmark_suite/issues
+  changelog_uri: https://github.com/overnet/rails_benchmark_suite/blob/main/CHANGELOG.md
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.4.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.2
+specification_version: 4
+summary: Rails-style functionality & performance benchmark tool
+test_files: []