RSpec Power 🔥

group :test do
  gem "rspec_power"
end

RSpec.describe User, :with_log do
  it "creates a user with logging" do
    # All Rails logs will be captured and displayed
    user = User.create!(name: "John Doe", email: "john@example.com")
    expect(user).to be_persisted
  end
end

RSpec.describe User do
  it "creates a user with logging", :with_log do
    # All Rails logs will be captured and displayed
    user = User.create!(name: "John Doe", email: "john@example.com")
    expect(user).to be_persisted
  end
end

RSpec.describe User, :with_log_ar do
  it "shows SQL queries" do
    # Only ActiveRecord logs will be captured
    users = User.where(active: true).includes(:profile)
    expect(users).to be_any
  end
end

RSpec.describe User do
  it "manually controls logging" do
    with_logging do
      # All Rails logs captured here
      User.create!(name: "Jane")
    end
    # Logging back to normal here
  end

  it "captures only ActiveRecord logs" do
    with_ar_logging do
      # Only ActiveRecord logs captured here
      User.count
    end
  end
end

RSpec.describe CacheWarmup do
  it "does not hit the DB" do
    expect_no_sql do
      CacheWarmup.build_in_memory!
    end
  end
end

RSpec.describe MigrationChecker do
  it "touches the DB" do
    expect_sql do
      ActiveRecord::Base.connection.execute("SELECT 1")
    end
  end
end

RSpec.describe CacheWarmup, :with_no_sql_queries do
  it "builds entirely in memory" do
    CacheWarmup.build_in_memory!
  end
end

RSpec.describe MigrationChecker, :with_sql_queries do
  it "must hit the DB at least once" do
    ActiveRecord::Base.connection.execute("SELECT 1")
  end
end

Supported tags: `:with_no_sql_queries`, `:with_sql_queries`

RSpec.describe PaymentService, :with_env do
  it "uses test API key", with_env: { 'STRIPE_API_KEY' => 'test_key_123' } do
    service = PaymentService.new
    expect(service.api_key).to eq('test_key_123')
  end

  it "handles multiple env vars", with_env: {
    'RAILS_ENV' => 'test',
    'DATABASE_URL' => 'postgresql://localhost/test_db'
  } do
    expect(ENV['RAILS_ENV']).to eq('test')
    expect(ENV['DATABASE_URL']).to eq('postgresql://localhost/test_db')
  end
end

RSpec.describe ConfigService do
  it "manually overrides environment" do
    with_test_env('API_URL' => 'https://api.test.com') do
      expect(ENV['API_URL']).to eq('https://api.test.com')
    end
    # Environment restored automatically
  end
end

RSpec.describe User, :with_locale do
  it "displays name in English", with_locale: :en do
    user = User.new(name: "John")
    expect(user.greeting).to eq("Hello, John!")
  end

  it "displays name in Spanish", with_locale: :es do
    user = User.new(name: "Juan")
    expect(user.greeting).to eq("¡Hola, Juan!")
  end

  it "displays name in French", with_locale: :fr do
    user = User.new(name: "Jean")
    expect(user.greeting).to eq("Bonjour, Jean!")
  end
end

RSpec.describe LocalizationHelper do
  it "manually changes locale" do
    with_locale(:de) do
      expect(I18n.locale).to eq(:de)
      expect(t('hello')).to eq('Hallo')
    end
    # Locale restored automatically
  end
end

RSpec.describe Order, :with_time_freeze do
  it "creates order with current timestamp", with_time_freeze: "2024-01-15 10:30:00" do
    order = Order.create!(amount: 100)
    expect(order.created_at).to eq(Time.parse("2024-01-15 10:30:00"))
  end

  it "handles time-sensitive logic", with_time_freeze: Time.new(2024, 12, 25, 12, 0, 0) do
    expect(Time.current).to eq(Time.new(2024, 12, 25, 12, 0, 0))
    # Test Christmas-specific logic
  end
end

RSpec.describe ReportGenerator do
  it "builds report in US Pacific", with_time_zone: "Pacific Time (US & Canada)" do
    # The block runs with Time.zone set to Pacific
    expect(Time.zone.name).to eq("Pacific Time (US & Canada)")
  end
end

RSpec.describe Importer do
  it "is fast enough" do
    with_maximum_execution_time(50) do
      Importer.run!
    end
  end
end

RSpec.describe Importer, with_maximum_execution_time: 100 do
  it "completes quickly" do
    Importer.run!
  end
end

RSpec.describe Parser, with_benchmark: { runs: 10 } do
  it "parses quickly" do
    Parser.parse!(payload)
  end
end

RSpec.describe "Users API", type: :request do
  it "dumps everything by default", :with_request_dump do
    post "/set_state"
    expect(response).to be_successful
  end

  it "dumps only session and cookies",
     with_request_dump: { what: [:session, :cookies] } do
    post "/set_state"
    expect(response).to be_successful
  end
end

RSpec.describe Deployment, :with_ci_only do
  it "runs only on CI" do
    expect(ENV["CI"]).to be_present
  end
end

RSpec.describe HeavySpec, :with_skip_ci do
  it "skips on CI" do
    # expensive checks
  end
end

RSpec.describe User, :with_dump_db_on_fail do
  it "creates a user" do
    # ...
  end
end

RSpec.describe Report, with_dump_db_on_fail: {
  tables: ["users", "accounts"],
  except: ["accounts"],
  dir: Rails.root.join("tmp", "db_dumps").to_s
} do
  it "fails and dumps only selected tables" do
    # ...
  end
end

# In spec_helper.rb or rails_helper.rb
RSpec.configure do |config|
  # Customize logging behavior
  config.include RSpecPower::Rails::LoggingHelpers
  config.include_context "rspec_power::logging:verbose", with_log: true
  config.include_context "rspec_power::logging:verbose", with_logs: true
  config.include_context "rspec_power::logging:active_record", with_log_ar: true

  # Customize environment helpers
  config.include RSpecPower::Rails::EnvHelpers
  config.include_context "rspec_power::env:override", :with_env

  # Customize I18n helpers
  config.include RSpecPower::Rails::I18nHelpers
  config.include_context "rspec_power::i18n:dynamic", :with_locale

  # Customize time helpers
  config.include RSpecPower::Rails::TimeHelpers
  config.include_context "rspec_power::time:freeze", :with_time_freeze
  config.include_context "rspec_power::time:zone", :with_time_zone

  # CI-only guards
  config.include_context "rspec_power::ci:only", :with_ci_only
  config.include_context "rspec_power::ci:skip", :with_skip_ci

  # Request dump helpers (session/cookies/flash/headers)
  config.include RSpecPower::RequestDumpHelpers
  config.include_context "rspec_power::request_dump:after", :with_request_dump
end