turbo_rspec 0.7.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3049c79cdd7a1c8b6dc2447fb2034458f129b900343dcc759e5f8b1ae200189b
-  data.tar.gz: ca51420063475b7870a6d77e95d0e4b33f5d2b0e725c4f9b2419acdd4dbb4cd9
+  metadata.gz: '036718d6f9e9e1960f6e12b668a288c6562ec914aa87eaaaddacfbccb47fc2fd'
+  data.tar.gz: 6f0345d41a0803871c89fbbbaa9e7e1e30b7ca155e9d60b8c41052a1fe0c59e6
 SHA512:
-  metadata.gz: 3e096c87e0b36b9c291308e95a30f075c4c3761d25c9b2d6779647a5e6ace92ed7ff60b5e04cd31b837611dfe92098067a9cb7a4c302e8c12d26eba7bd0d6840
-  data.tar.gz: 82fcd0aaf837b61d78c079619d52ab99d79d99bc6d2eafec7cd1ce56f0a6558e3b69748928fadbc81fc0651b8910c4b0d44d45795f623c183b012ff423bf44e2
+  metadata.gz: e2269c5a1df90467e5487cb8b029e75591a91c07df1a5af5182af6075d0803dbbc8f8d97418bfbfb89232f63d0fc09646e894533d78cea61fd6937550707dfca
+  data.tar.gz: 0b4c4d7ed1c62e796b03eaed49edb1449e0ea265952f8b6a97f055a49f3c1708fee739a0fc47e99282e7e222d090690859bf540b3bfe3893fd8a523c00657640

data/.github/workflows/ci.yml

@@ -57,4 +57,9 @@ jobs:
 
       - run: bundle exec rspec
         env:
-          RAILS_VERSION: ${{ matrix.rails }}
+          RAILS_VERSION: ${{ matrix.rails }}
+
+      - name: Upload coverage to Codecov
+        uses: codecov/codecov-action@v6
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 ## [Unreleased]
 
+## [1.0.0] - 2026-05-28
+
+### Added
+
+- `rails generate turbo_rspec:install` — scaffolds `spec/support/turbo_rspec.rb` with sensible defaults
+- `bin/benchmark` — measures matcher overhead against a 100-element response body
+- Semver format enforced via spec (`TurboRspec::VERSION` must match `MAJOR.MINOR.PATCH`)
+- SimpleCov minimum coverage enforced: 100% line and branch required for CI to pass
+
 ## [0.7.0] - 2026-05-28
 
 ### Added

data/README.md

@@ -6,7 +6,15 @@
 [![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.3-ruby)](https://rubygems.org/gems/turbo_rspec)
 [![codecov](https://codecov.io/gh/eclectic-coding/turbo_rspec/branch/main/graph/badge.svg)](https://codecov.io/gh/eclectic-coding/turbo_rspec)
 
-RSpec matchers for [Turbo](https://github.com/hotwired/turbo-rails) — assert Turbo Stream responses, Turbo Frame content, and ActionCable broadcasts without hand-rolling helpers in every project.
+Drop-in test matchers for [hotwired/turbo-rails](https://github.com/hotwired/turbo-rails) — replace every hand-rolled Turbo helper in your test suite with a single gem.
+
+- **Request/controller specs** — `have_turbo_stream`, `have_turbo_frame`, `have_turbo_streams`
+- **Broadcast specs** — `have_broadcasted_turbo_stream_to` with count qualifiers
+- **System/feature specs** — Capybara matchers: `have_turbo_frame`, `have_turbo_stream_tag`, `within_turbo_frame`
+- **Minitest** — `assert_turbo_stream`, `refute_turbo_stream`, `assert_turbo_frame`, `refute_turbo_frame`
+- **Factory helpers** — `turbo_stream_html`, `turbo_frame_html`
+- **Shared examples** — `it_behaves_like "a turbo stream response"`
+- **Auto-included** — zero setup required when `turbo-rails` is in your bundle
 
 **Docs:** [API Reference](https://rubydoc.info/gems/turbo_rspec) · [Migration Guide](docs/migration_guide.md) · [Cookbook](docs/cookbook.md)
 
@@ -22,6 +30,14 @@ end
 
 ## Setup
 
+### Generator
+
+Run the install generator to scaffold a `spec/support/turbo_rspec.rb` configuration file:
+
+```bash
+rails generate turbo_rspec:install
+```
+
 ### Rails + turbo-rails (automatic)
 
 No setup needed. When `turbo-rails` is in your bundle:

data/ROADMAP.md

@@ -4,24 +4,10 @@ RSpec matchers for [Turbo](https://github.com/hotwired/turbo-rails): Turbo Strea
 
 ---
 
-## v1.0.0 — Stable API
-
-**Goal:** API freeze. Commit to semver stability. Make the gem the obvious default choice.
-
-- API stability guarantee: no breaking changes without a major version bump
-- `TurboRspec::VERSION` semantic versioning enforced via CI check
-- 100% branch coverage enforced in CI (`simplecov`)
-- Performance: benchmark matcher overhead to keep it negligible in large suites
-- `bin/release` script (mirrors solid_queue_web pattern): bump version, update CHANGELOG, tag, push; CI publishes via Trusted Publishing
-- `turbo_rspec` generator (`rails generate turbo_rspec:install`) to scaffold `spec/support/turbo.rb`
-
----
-
 ## Post-1.0 ideas (not scheduled)
 
 - VS Code / RubyMine snippet pack for common patterns
 - Playwright/Puppeteer bridge for headless assertions outside Capybara
-- Shared examples: `it_behaves_like "a turbo stream response"` for controller testing
 
 ---
 

data/lib/generators/turbo_rspec/install_generator.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+require "rails/generators"
+
+module TurboRspec
+  module Generators
+    # Rails generator that scaffolds a spec/support/turbo_rspec.rb file
+    # with sensible defaults for TurboRspec configuration.
+    #
+    # @example
+    #   rails generate turbo_rspec:install
+    class InstallGenerator < Rails::Generators::Base
+      source_root File.expand_path("templates", __dir__)
+
+      desc "Creates a spec/support/turbo_rspec.rb configuration file"
+
+      def create_support_file
+        template "turbo_rspec.rb", "spec/support/turbo_rspec.rb"
+      end
+
+      def show_readme
+        readme "README" if behavior == :invoke
+      end
+    end
+  end
+end

data/lib/generators/turbo_rspec/templates/README

@@ -0,0 +1,13 @@
+TurboRspec installed!
+
+A configuration file has been created at spec/support/turbo_rspec.rb.
+
+Make sure it is required in your spec/rails_helper.rb:
+
+  Dir[Rails.root.join("spec/support/**/*.rb")].each { |f| require f }
+
+Matchers are automatically included in request, controller, system,
+and feature specs when turbo-rails is present.
+
+See the docs for usage examples:
+  https://github.com/eclectic-coding/turbo_rspec

data/lib/generators/turbo_rspec/templates/turbo_rspec.rb

@@ -0,0 +1,13 @@
+# TurboRspec configuration
+# See: https://github.com/eclectic-coding/turbo_rspec
+
+TurboRspec.configure do |config|
+  # Set to false to disable automatic inclusion of matchers into
+  # request, controller, system, and feature example groups.
+  # config.auto_include = false
+end
+
+# Uncomment to include Minitest assertions in integration tests:
+# class ActionDispatch::IntegrationTest
+#   include TurboRspec::Assertions
+# end

data/lib/turbo_rspec/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TurboRspec
-  VERSION = "0.7.0"
+  VERSION = "1.0.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_rspec
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 1.0.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -23,9 +23,11 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '1.13'
-description: 'Drop-in RSpec matchers for hotwired/turbo-rails: assert Turbo Stream
-  responses, Turbo Frame content, and ActionCable broadcasts without hand-rolling
-  helpers in every project.'
+description: 'Drop-in test matchers for hotwired/turbo-rails: assert Turbo Stream
+  responses, Turbo Frame content, ActionCable broadcasts, and Capybara page assertions.
+  Includes RSpec matchers (have_turbo_stream, have_turbo_frame, have_broadcasted_turbo_stream_to),
+  Minitest assertions, factory helpers, shared examples, and a Rails generator — all
+  auto-included with zero setup.'
 email:
 - eclectic-coding@users.noreply.github.com
 executables: []
@@ -45,6 +47,9 @@ files:
 - codecov.yml
 - docs/cookbook.md
 - docs/migration_guide.md
+- lib/generators/turbo_rspec/install_generator.rb
+- lib/generators/turbo_rspec/templates/README
+- lib/generators/turbo_rspec/templates/turbo_rspec.rb
 - lib/turbo_rspec.rb
 - lib/turbo_rspec/assertions.rb
 - lib/turbo_rspec/capybara/matchers.rb
@@ -85,5 +90,5 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 rubygems_version: 3.6.9
 specification_version: 4
-summary: RSpec matchers for Turbo Streams, Turbo Frames, and ActionCable broadcasts.
+summary: RSpec matchers and Minitest assertions for hotwired/turbo-rails.
 test_files: []