turbo_rspec 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9752bc68a0676737d5e31eda8279871c6aa23e09c0cafb6eab046ae153f8a103
-  data.tar.gz: d6a13d4d95ee05e4fb6221a36aaebc807e367d0a313b9f8e00eaa307138183dc
+  metadata.gz: c9273ce0d0b091c73a80681f52986b639412d89b64fff6a8d79f40ce2b742997
+  data.tar.gz: 84d380b306f6a75ebc0af9ae8c5beed6c141c0da44ea736706eeb17392c63489
 SHA512:
-  metadata.gz: 78309d93bfac9a17816989f570dd287f10ea149bb4781be1a6e514449387862d46cf93cf30914e456bc5d0c88c7585aff998fe62831902688edd0a3081007f86
-  data.tar.gz: dc224517ae6717151a75f01c45028732949fe06fc65248b20dc17807318a363b1aa96c375c10c2dcbb7ebadab686a3cf4d859105d15b1a00b579c1dba4478f18
+  metadata.gz: 3965ea0fe3c731120ffa83a5efc331c1bd420e3271c153f1e3be37c1b62fe5b8243ae3fc20f4a8ab8723403ed0a9dd0aa7f07ad242a864b769e242dd6087a2f1
+  data.tar.gz: 82357eebbe233ed14882216b2075f29d1a97e4d0aed68c789a79747da1ac4aaf84a88ef8b8d0273204a9cd81c3f6e2dc5b04d933bca6e16b988e8749538812ff

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,15 @@
 ## [Unreleased]
 
+## [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

@@ -250,6 +250,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,22 +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.

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/version.rb

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

data/lib/turbo_rspec.rb

@@ -3,6 +3,7 @@
 require_relative "turbo_rspec/version"
 require_relative "turbo_rspec/configuration"
 require_relative "turbo_rspec/matchers"
+require_relative "turbo_rspec/assertions"
 require_relative "turbo_rspec/capybara/matchers"
 
 module TurboRspec

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_rspec
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -43,6 +43,7 @@ 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