rails-quality-assurance 1.1.2 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4079fda37b426ec6f29246881c51ff3b6d96559b010f96b54f67ff16192a35a6
-  data.tar.gz: 4c26a32dca327a58a24e49f4c9363fc9f6672cad630978118c0fe93809abf525
+  metadata.gz: fbfaa2ba084f177367b0e73824321a2367d320af6063f7cd566ada9667955b6a
+  data.tar.gz: d6e96d0197b9ed90e59fce7ca6aeb816e8fdc6591651d96d3cb6888e572a3c48
 SHA512:
-  metadata.gz: c572283e10db70342ed3bd5b09188f5ab9bca00ae6dfc246cd99aaabf68ffa46497639d90f4f96fd4cdbadaafbce2b83776b22e83c70509b9f0266c49b155704
-  data.tar.gz: 1553402a693b9befa6c02a03011a2abbcd8163eae1a7ec4c8105f9ce5bdb1c83af42983592cb9da666a0b40a00702c790f8833d8d77787ca822843f7b9d704d6
+  metadata.gz: d4ea679306eded2575e31dd73f5e92e57094c909b9936ff6408a2425c8b0cae1a28429ec21770dfe1edd17324cb2878311d3a3b164b88839575414fb9f62b70c
+  data.tar.gz: 5f7a613b6185e7ce0873b06a3f7d87d18a88db874679831908754c6f403489734224589c998347030298a2b647aa7e89c84fb864f6c17c6524b5f912bda336b8

data/CHANGELOG.md

@@ -5,6 +5,27 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.2.0] - 2026-09-14
+
+### Added
+
+- `rails_quality_assurance/rails_helper`: one require applying the shared Rails
+  test configuration (schema check, transactional fixtures, spec-type inference,
+  Rails backtrace filtering, FactoryBot, time helpers, WebMock lockdown with a
+  loopback/Playwright allowlist, I18n locale, Faker reset, CSRF toggle).
+
+### Changed
+
+- SimpleCov upgraded to 1.3 with explicit `finalize_merge` so parallel workers
+  enforce thresholds exactly once.
+- QA rake tasks live under `qa:` and no longer boot the Rails environment, so a
+  lint-only CI job passes without native image libraries.
+
+### Fixed
+
+- Packaged Biome/Stylelint configs renamed to avoid colliding with an app's root
+  configuration when the gem sits under `vendor/bundle`.
+
 ## [1.0.0] - 2026-09-14
 
 ### Added

data/README.md

@@ -80,7 +80,29 @@ That single require sets up:
 
 *(If you prefer to load them individually, `require 'rails_quality_assurance/simplecov'` and `require 'rails_quality_assurance/playwright'` remain available.)*
 
-### 3. Continuous Integration: `bin/ci`
+### 3. Rails Test Setup (spec/rails_helper.rb)
+
+After the Rails environment boots, one require applies the shared Rails test configuration:
+
+```ruby
+require 'spec_helper'
+require_relative '../config/environment'
+require 'rails_quality_assurance/rails_helper'
+```
+
+That sets up, without any boilerplate in the app:
+
+- `ActiveRecord::Migration.maintain_test_schema!` (aborts on pending migrations)
+- `use_transactional_fixtures`, fixture paths, and `infer_spec_type_from_file_location!`
+- `filter_rails_from_backtrace!`
+- FactoryBot syntax methods and ActiveSupport time helpers
+- WebMock network lockdown with a loopback + Playwright allowlist
+- `I18n.locale = :en` before each example; `Faker::UniqueGenerator` reset after each
+- CSRF forgery protection toggled on around system specs
+
+Application-specific setup (auth helpers, custom matchers, gateway stubs) stays in the app's own `rails_helper.rb`.
+
+### 4. Continuous Integration: `bin/ci`
 
 Run the generator to install `bin/ci` and `config/ci.rb`:
 
@@ -100,7 +122,7 @@ Or in Docker-based setups:
 bin/run bin/ci
 ```
 
-### 4. Rake Tasks (Optional)
+### 5. Rake Tasks (Optional)
 
 The gem also provides tasks if you prefer `rake`:
 

data/lib/rails_quality_assurance/rails/helper.rb

@@ -0,0 +1,100 @@
+# frozen_string_literal: true
+
+require 'uri'
+
+module RailsQualityAssurance
+  # Applies the Rails-specific RSpec configuration shared by every Develoz app.
+  #
+  # Loaded from spec/rails_helper.rb, after the Rails environment boots:
+  #
+  #   # spec/rails_helper.rb
+  #   require 'spec_helper'
+  #   require_relative '../config/environment'
+  #   require 'rails_quality_assurance/rails_helper'
+  module RailsHelper
+    def self.configure!
+      return unless defined?(RSpec)
+
+      verify_schema!
+      RSpec.configure do |config|
+        configure_fixtures(config)
+        configure_includes(config)
+        configure_network(config)
+        configure_locale(config)
+        configure_forgery_protection(config)
+      end
+    end
+
+    def self.verify_schema!
+      return unless defined?(ActiveRecord::Migration)
+
+      ActiveRecord::Migration.maintain_test_schema!
+    rescue ActiveRecord::PendingMigrationError => e
+      Kernel.abort(e.to_s.strip)
+    end
+
+    def self.configure_fixtures(config)
+      return unless rspec_rails?
+
+      config.fixture_paths = [fixtures_path].compact if fixtures_path
+      config.use_transactional_fixtures = true
+      config.infer_spec_type_from_file_location!
+      config.filter_rails_from_backtrace!
+    end
+
+    def self.fixtures_path
+      return nil unless defined?(Rails)
+
+      Rails.root.join('spec/fixtures')
+    rescue NoMethodError
+      nil
+    end
+
+    def self.rspec_rails?
+      defined?(RSpec::Rails)
+    end
+
+    def self.configure_includes(config)
+      config.include FactoryBot::Syntax::Methods if defined?(FactoryBot)
+      config.include ActiveSupport::Testing::TimeHelpers if defined?(ActiveSupport::Testing::TimeHelpers)
+    end
+
+    def self.configure_network(config)
+      return unless defined?(WebMock)
+
+      allowed = localhost_hosts
+      config.before { WebMock.disable_net_connect!(allow: allowed) }
+    end
+
+    # Hosts the suite may reach without stubbing: the Playwright server when
+    # system specs run remotely, plus loopback.
+    def self.localhost_hosts
+      [playwright_host, 'localhost', '0.0.0.0', '127.0.0.1'].compact.uniq.freeze
+    end
+
+    def self.playwright_host
+      url = ENV.fetch('PLAYWRIGHT_URL', nil)
+      return nil if url.blank?
+
+      URI.parse(url).host
+    rescue URI::InvalidURIError
+      nil
+    end
+
+    def self.configure_locale(config)
+      config.before { I18n.locale = :en } if defined?(I18n)
+      config.after { Faker::UniqueGenerator.clear } if defined?(Faker)
+    end
+
+    def self.configure_forgery_protection(config)
+      return unless defined?(ActionController::Base)
+
+      config.around(:each, type: :system) do |example|
+        ActionController::Base.allow_forgery_protection = true
+        example.run
+      ensure
+        ActionController::Base.allow_forgery_protection = false
+      end
+    end
+  end
+end

data/lib/rails_quality_assurance/rails_helper.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/rails/helper'
+RailsQualityAssurance::RailsHelper.configure!

data/lib/rails_quality_assurance/rails_test_helper.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require 'rails_quality_assurance/all'
+require 'rails_quality_assurance/rails_helper'

data/lib/rails_quality_assurance/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module RailsQualityAssurance
-  VERSION = '1.1.2'
+  VERSION = '1.2.0'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rails-quality-assurance
 version: !ruby/object:Gem::Version
-  version: 1.1.2
+  version: 1.2.0
 platform: ruby
 authors:
 - Mauricio Zaffari
@@ -355,6 +355,9 @@ files:
 - lib/rails_quality_assurance/ci_runner.rb
 - lib/rails_quality_assurance/playwright.rb
 - lib/rails_quality_assurance/playwright/helper.rb
+- lib/rails_quality_assurance/rails/helper.rb
+- lib/rails_quality_assurance/rails_helper.rb
+- lib/rails_quality_assurance/rails_test_helper.rb
 - lib/rails_quality_assurance/railtie.rb
 - lib/rails_quality_assurance/rspec.rb
 - lib/rails_quality_assurance/rspec/helper.rb