turbo_rspec 0.4.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9752bc68a0676737d5e31eda8279871c6aa23e09c0cafb6eab046ae153f8a103
-  data.tar.gz: d6a13d4d95ee05e4fb6221a36aaebc807e367d0a313b9f8e00eaa307138183dc
+  metadata.gz: 7e6568858c6d2ba4487a184d5161e3a254368447704c86437f7f5753003af0bb
+  data.tar.gz: c3b05381ef257037eb0112e3bc925d4db1973780e16d6d56a9cd842db9f4d994
 SHA512:
-  metadata.gz: 78309d93bfac9a17816989f570dd287f10ea149bb4781be1a6e514449387862d46cf93cf30914e456bc5d0c88c7585aff998fe62831902688edd0a3081007f86
-  data.tar.gz: dc224517ae6717151a75f01c45028732949fe06fc65248b20dc17807318a363b1aa96c375c10c2dcbb7ebadab686a3cf4d859105d15b1a00b579c1dba4478f18
+  metadata.gz: 710e2a679f38e346a19031c81441b2ce56e0317b5b770275a1d69d1117fb7eb48af0551e1c5c6a62cd4651cdee9cc6976c32ec038472b3dd5beea2d5d978e662
+  data.tar.gz: 557f56e9807599846b81204772ec47919daf2621ef090253971f1f9f9390bc5f22a63e438a9c4715dedbb939c44c4c517654852ac41fc87392bee88b4f8ff83d

data/.github/workflows/ci.yml

@@ -39,12 +39,13 @@ jobs:
       - run: bundle exec bundle-audit check
 
   test:
-    name: Ruby ${{ matrix.ruby }}
+    name: Ruby ${{ matrix.ruby }} / Rails ${{ matrix.rails }}
     runs-on: ubuntu-latest
     strategy:
       fail-fast: false
       matrix:
         ruby: ["3.3", "3.4", "4.0"]
+        rails: ["7.2", "8.0", "8.1"]
 
     steps:
       - uses: actions/checkout@v6
@@ -54,4 +55,6 @@ jobs:
           ruby-version: ${{ matrix.ruby }}
           bundler-cache: true
 
-      - run: bundle exec rspec
+      - run: bundle exec rspec
+        env:
+          RAILS_VERSION: ${{ matrix.rails }}

data/CHANGELOG.md

@@ -1,5 +1,23 @@
 ## [Unreleased]
 
+## [0.6.0] - 2026-05-28
+
+### Added
+
+- `TurboRspec::Helpers` module with `turbo_stream_html` and `turbo_frame_html` factory helpers for building test HTML inline
+- Shared examples: `it_behaves_like "a turbo stream response"` and `it_behaves_like "a turbo frame response"` for common assertions
+- `have_turbo_stream`, `have_turbo_frame`, and `TurboRspec::Helpers` auto-included into `type: :controller` example groups alongside `type: :request`
+
+## [0.5.0] - 2026-05-28
+
+### Added
+
+- `TurboRspec::Assertions` — opt-in minitest companion module with `assert_turbo_stream`, `refute_turbo_stream`, `assert_turbo_frame`, `refute_turbo_frame`; no RSpec dependency required
+- `refresh` and `morph` action support confirmed working via compatibility specs
+- Multi-stream response body parsing confirmed — a single response body with multiple `<turbo-stream>` tags works with all matchers
+- Graceful no-op when `turbo-rails` is not in the Gemfile — no `LoadError`
+- CI Rails matrix: Ruby 3.3/3.4/4.0 × Rails 7.2/8.0/8.1
+
 ## [0.4.0] - 2026-05-28
 
 ### Added

data/README.md

@@ -201,6 +201,38 @@ expect(page).to have_turbo_stream_tag("signed_stream_name")
 expect(page).not_to have_turbo_stream_tag
 ```
 
+## Test helpers
+
+`TurboRspec::Helpers` provides factory methods for building Turbo HTML inline in tests. Auto-included in `type: :request` and `type: :controller` example groups.
+
+```ruby
+# Build a <turbo-stream> element
+turbo_stream_html(action: :append, target: "messages", content: "Hello")
+turbo_stream_html(action: :remove, targets: ".item")
+
+# Build a <turbo-frame> element
+turbo_frame_html(id: "messages", content: "Hello")
+```
+
+## Shared examples
+
+```ruby
+RSpec.describe "Messages", type: :request do
+  describe "POST /messages" do
+    before { post messages_path, params: { body: "Hello" }, as: :turbo_stream }
+
+    # Assert any turbo stream is present
+    it_behaves_like "a turbo stream response"
+
+    # Assert a specific stream
+    it_behaves_like "a turbo stream response", action: :append, target: "messages", content: "Hello"
+
+    # Assert a turbo frame
+    it_behaves_like "a turbo frame response", id: "messages"
+  end
+end
+```
+
 ## Example: request spec
 
 ```ruby
@@ -250,6 +282,35 @@ RSpec.describe "Messages", type: :system do
 end
 ```
 
+## Minitest support
+
+`TurboRspec::Assertions` is an opt-in companion module with no RSpec dependency. Include it in any Minitest test class:
+
+```ruby
+class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
+  include TurboRspec::Assertions
+end
+```
+
+### Available assertions
+
+```ruby
+# Stream assertions
+assert_turbo_stream(response, action: :append, target: "messages")
+assert_turbo_stream(response, action: :append, target: "messages", content: "Hello")
+assert_turbo_stream(response, targets: ".items")
+assert_turbo_stream(response, partial: "messages/_message")
+refute_turbo_stream(response, action: :replace)
+
+# Frame assertions
+assert_turbo_frame(response, id: "messages")
+assert_turbo_frame(response, id: "messages", content: "Hello")
+refute_turbo_frame(response, id: "notifications")
+
+# Custom failure message
+assert_turbo_stream(response, action: :append, message: "expected append stream")
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on [GitHub](https://github.com/eclectic-coding/turbo_rspec).

data/ROADMAP.md

@@ -4,33 +4,6 @@ RSpec matchers for [Turbo](https://github.com/hotwired/turbo-rails): Turbo Strea
 
 ---
 
-
----
-
-## v0.5.0 — Compatibility and edge cases
-
-**Goal:** harden the gem against real-world app variations.
-
-- Rails 7.2/8.0/8.1 and Turbo 1.x/2.x compatibility matrix in CI (7.1 is EOL)
-- Multi-stream response body parsing (a single response can contain multiple `<turbo-stream>` tags)
-- `refresh` action support (Turbo 8 page refresh streams)
-- `morph` action support (Turbo Morphing)
-- Graceful no-op when `turbo-rails` is not in the Gemfile (no `LoadError`)
-- Minitest module (`TurboRspec::Assertions`) as opt-in companion (no RSpec dependency for that module)
-
----
-
-## v0.6.0 — Testing utilities
-
-**Goal:** reduce boilerplate in real test suites and close the controller spec gap.
-
-- `turbo_stream_html(action:, target:, content: nil)` — factory helper for building `<turbo-stream>` HTML inline in tests
-- Shared examples: `it_behaves_like "a turbo stream response"` and `"a turbo frame response"` for common assertions
-- Controller spec support — `have_turbo_stream` and `have_turbo_frame` working against `response` in `type: :controller`
-- Auto-include `TurboRspec::Matchers` into `type: :controller` when `turbo-rails` is present
-
----
-
 ## v0.7.0 — Documentation
 
 **Goal:** full docs before freezing the API.

data/lib/turbo_rspec/assertions.rb

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+require_relative "matchers/have_turbo_frame"
+require_relative "matchers/have_turbo_stream"
+
+module TurboRspec
+  # Minitest-compatible assertions. Include in your test class:
+  #
+  #   class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
+  #     include TurboRspec::Assertions
+  #   end
+  #
+  # No RSpec dependency required.
+  module Assertions
+    def assert_turbo_stream(response_or_body, action: nil, target: nil, targets: nil, content: nil, partial: nil, message: nil)
+      matcher = build_stream_matcher(action: action, target: target, targets: targets, content: content, partial: partial)
+      assert matcher.matches?(response_or_body), message || matcher.failure_message
+    end
+
+    def refute_turbo_stream(response_or_body, action: nil, target: nil, targets: nil, content: nil, partial: nil, message: nil)
+      matcher = build_stream_matcher(action: action, target: target, targets: targets, content: content, partial: partial)
+      assert matcher.does_not_match?(response_or_body), message || matcher.failure_message_when_negated
+    end
+
+    def assert_turbo_frame(response_or_body, id: nil, content: nil, partial: nil, message: nil)
+      matcher = build_frame_matcher(id: id, content: content, partial: partial)
+      assert matcher.matches?(response_or_body), message || matcher.failure_message
+    end
+
+    def refute_turbo_frame(response_or_body, id: nil, content: nil, partial: nil, message: nil)
+      matcher = build_frame_matcher(id: id, content: content, partial: partial)
+      assert matcher.does_not_match?(response_or_body), message || matcher.failure_message_when_negated
+    end
+
+    private
+
+    def build_stream_matcher(action:, target:, targets:, content:, partial:)
+      matcher = Matchers::HaveTurboStream.new
+      matcher.with_action(action) if action
+      matcher.targeting(target) if target
+      matcher.targeting_all(targets) if targets
+      matcher.with_content(content) if content
+      matcher.rendering(partial) if partial
+      matcher
+    end
+
+    def build_frame_matcher(id:, content:, partial:)
+      matcher = Matchers::HaveTurboFrame.new
+      matcher.with_id(id) if id
+      matcher.with_content(content) if content
+      matcher.rendering(partial) if partial
+      matcher
+    end
+  end
+end

data/lib/turbo_rspec/helpers.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module TurboRspec
+  module Helpers
+    def turbo_stream_html(action:, target: nil, targets: nil, content: nil)
+      attrs = "action=\"#{action}\""
+      attrs += " target=\"#{target}\"" if target
+      attrs += " targets=\"#{targets}\"" if targets
+      inner = content ? "<template>#{content}</template>" : "<template></template>"
+      "<turbo-stream #{attrs}>#{inner}</turbo-stream>"
+    end
+
+    def turbo_frame_html(id:, content: nil)
+      "<turbo-frame id=\"#{id}\">#{content}</turbo-frame>"
+    end
+  end
+end

data/lib/turbo_rspec/shared_examples.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+# :nocov:
+if defined?(RSpec)
+  # :nocov:
+  RSpec.shared_examples "a turbo stream response" do |action: nil, target: nil, targets: nil, content: nil, partial: nil|
+    it "responds with a turbo stream" do
+      matcher = have_turbo_stream
+      matcher.with_action(action) if action
+      matcher.targeting(target) if target
+      matcher.targeting_all(targets) if targets
+      matcher.with_content(content) if content
+      matcher.rendering(partial) if partial
+      expect(response).to matcher
+    end
+  end
+
+  RSpec.shared_examples "a turbo frame response" do |id: nil, content: nil, partial: nil|
+    it "responds with a turbo frame" do
+      matcher = have_turbo_frame
+      matcher.with_id(id) if id
+      matcher.with_content(content) if content
+      matcher.rendering(partial) if partial
+      expect(response).to matcher
+    end
+  end
+end

data/lib/turbo_rspec/version.rb

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

data/lib/turbo_rspec.rb

@@ -3,6 +3,9 @@
 require_relative "turbo_rspec/version"
 require_relative "turbo_rspec/configuration"
 require_relative "turbo_rspec/matchers"
+require_relative "turbo_rspec/helpers"
+require_relative "turbo_rspec/assertions"
+require_relative "turbo_rspec/shared_examples"
 require_relative "turbo_rspec/capybara/matchers"
 
 module TurboRspec
@@ -24,6 +27,9 @@ module TurboRspec
     def install_rspec_integration(config)
       return unless configuration.auto_include && Gem.loaded_specs.key?("turbo-rails")
       config.include Matchers, type: :request
+      config.include Matchers, type: :controller
+      config.include Helpers, type: :request
+      config.include Helpers, type: :controller
       if Gem.loaded_specs.key?("capybara")
         config.include Capybara::Matchers, type: :system
         config.include Capybara::Matchers, type: :feature

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_rspec
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -43,15 +43,18 @@ files:
 - Rakefile
 - codecov.yml
 - lib/turbo_rspec.rb
+- lib/turbo_rspec/assertions.rb
 - lib/turbo_rspec/capybara/matchers.rb
 - lib/turbo_rspec/capybara/matchers/have_turbo_frame.rb
 - lib/turbo_rspec/capybara/matchers/have_turbo_stream_tag.rb
 - lib/turbo_rspec/configuration.rb
+- lib/turbo_rspec/helpers.rb
 - lib/turbo_rspec/matchers.rb
 - lib/turbo_rspec/matchers/have_broadcasted_turbo_stream_to.rb
 - lib/turbo_rspec/matchers/have_turbo_frame.rb
 - lib/turbo_rspec/matchers/have_turbo_stream.rb
 - lib/turbo_rspec/matchers/have_turbo_streams.rb
+- lib/turbo_rspec/shared_examples.rb
 - lib/turbo_rspec/version.rb
 - sig/turbo_rspec.rbs
 homepage: https://github.com/eclectic-coding/turbo_rspec