turbo_rspec 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '036718d6f9e9e1960f6e12b668a288c6562ec914aa87eaaaddacfbccb47fc2fd'
-  data.tar.gz: 6f0345d41a0803871c89fbbbaa9e7e1e30b7ca155e9d60b8c41052a1fe0c59e6
+  metadata.gz: 8356be265d63e581709f7252b6981d9f721172d68e417e23bc02581214773629
+  data.tar.gz: 3394a171db1031c16533bde8eb141eb1cd1f40bfed737b47c4f6e80b05ca23b5
 SHA512:
-  metadata.gz: e2269c5a1df90467e5487cb8b029e75591a91c07df1a5af5182af6075d0803dbbc8f8d97418bfbfb89232f63d0fc09646e894533d78cea61fd6937550707dfca
-  data.tar.gz: 0b4c4d7ed1c62e796b03eaed49edb1449e0ea265952f8b6a97f055a49f3c1708fee739a0fc47e99282e7e222d090690859bf540b3bfe3893fd8a523c00657640
+  metadata.gz: c2094508851098b590cd9539c01b60768a44f959b4af7bb20083e736a6e9b7631776f8bdde870fd543a7302d0fb1983a839932d8839b74de450274d00470c335
+  data.tar.gz: 06c44da054b038c40cb83b681da7d9897f3d76f436afe2adf484c1cd2cab243caf2f824d763ce958172d9d66f02c11e2646130fbe31c47a59df68ac800e0ab33

data/.github/FUNDING.yml

@@ -0,0 +1,15 @@
+# These are supported funding model platforms
+
+github: [eclectic-coding] # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
+patreon: # Replace with a single Patreon username
+open_collective: # Replace with a single Open Collective username
+ko_fi: # Replace with a single Ko-fi username
+tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
+community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
+liberapay: # Replace with a single Liberapay username
+issuehunt: # Replace with a single IssueHunt username
+lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
+polar: # Replace with a single Polar username
+buy_me_a_coffee: # Replace with a single Buy Me a Coffee username
+thanks_dev: # Replace with a single thanks.dev username
+custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [1.1.0] - 2026-06-01
+
+### Added
+
+- Count qualifiers on `have_turbo_stream`: `.once`, `.twice`, `.exactly(n).times`, `.at_least(n).times`, `.at_most(n).times` — mirrors the API already available on `have_broadcasted_turbo_stream_to`
+- `have_turbo_frame` (Capybara) `.with_src(url)` chain — asserts the `src` attribute of a lazy-loaded frame
+- `have_turbo_frame` (Capybara) `.lazy` chain — asserts `loading="lazy"` is set on the frame
+
 ## [1.0.0] - 2026-05-28
 
 ### Added

data/ROADMAP.md

@@ -4,10 +4,25 @@ RSpec matchers for [Turbo](https://github.com/hotwired/turbo-rails): Turbo Strea
 
 ---
 
-## Post-1.0 ideas (not scheduled)
+## 1.1 — Matcher parity
 
-- VS Code / RubyMine snippet pack for common patterns
-- Playwright/Puppeteer bridge for headless assertions outside Capybara
+- **Count qualifiers on `have_turbo_stream`** — `.once`, `.twice`, `.exactly(n).times` for request specs, matching the parity already present on `have_broadcasted_turbo_stream_to`. A single response with two `append` streams is a real case that currently requires two separate expectations.
+- **Capybara `have_turbo_frame` additions** — `.with_src(url)` (assert the `src` attribute of a lazy frame) and `.lazy` (assert `loading="lazy"` is set). These cover the lazy-loading pattern that's very common with Turbo Frames.
+
+## 1.2 — Turbo 8 / morphing
+
+- **`with_attributes(hash)` chain** — generic attribute assertion for both `have_turbo_stream` and `have_turbo_frame`. Covers non-standard attributes (e.g., `data-*` passed through custom actions) without needing new named chains per attribute.
+- **Morph-aware assertions** — `morph` is a supported action but Turbo 8's `<turbo-stream action="morph">` has distinct semantics (`[children-only]` attribute). A `.children_only` chain on `have_turbo_stream` would make morph specs readable without raw attribute checks.
+- **Custom Turbo action support** — Turbo 8 allows registering custom stream actions. A `TurboRspec.register_action(:sparkle)` API would let teams assert their own actions without them being treated as unknown values.
+
+## 1.3 — Stimulus companion
+
+- **Stimulus matchers** — `have_stimulus_controller`, `have_stimulus_action`, `have_stimulus_target` Capybara matchers. turbo-rails ships with Stimulus; teams using both already test Stimulus behavior manually. This is the natural next surface area for a complete Hotwire testing toolkit.
+
+## 1.4 — Tooling
+
+- **RuboCop cop** — flag request specs that assert `response.body` with a raw string match or `include "<turbo-stream"` instead of using the gem's matchers. Useful for migration and incremental adoption.
+- **Snapshot/fixture matcher** — `match_turbo_stream_snapshot("name")` records the stream on the first run and diffs on subsequent runs. Good for complex multi-stream responses where re-specifying every constraint in detail is noisy.
 
 ---
 

data/lib/turbo_rspec/capybara/matchers/have_turbo_frame.rb

@@ -8,6 +8,8 @@ module TurboRspec
           @id = id.to_s
           @content = nil
           @loaded = false
+          @src = nil
+          @lazy = false
         end
 
         def with_content(text)
@@ -20,10 +22,27 @@ module TurboRspec
           self
         end
 
+        # Constrains the match to frames with the given +src+ attribute.
+        # @param url [String]
+        # @return [self]
+        def with_src(url)
+          @src = url.to_s
+          self
+        end
+
+        # Constrains the match to frames with +loading="lazy"+.
+        # @return [self]
+        def lazy
+          @lazy = true
+          self
+        end
+
         def matches?(page_or_node)
           @node = find_frame(page_or_node)
           return false unless @node
           return false if @loaded && !@node[:complete]
+          return false if @lazy && @node[:loading] != "lazy"
+          return false if @src && @node[:src] != @src
           return false if @content && !@node.has_content?(@content, wait: 0)
           true
         end
@@ -37,6 +56,10 @@ module TurboRspec
             "expected page to have turbo-frame##{@id}#{constraint_description} but it was not found"
           elsif @loaded && !@node[:complete]
             "expected turbo-frame##{@id} to be loaded (missing [complete] attribute)"
+          elsif @lazy && @node[:loading] != "lazy"
+            "expected turbo-frame##{@id} to be lazy (missing loading=\"lazy\" attribute)"
+          elsif @src && @node[:src] != @src
+            "expected turbo-frame##{@id} to have src #{@src.inspect}, got #{@node[:src].inspect}"
           else
             "expected turbo-frame##{@id} to have content #{@content.inspect}"
           end
@@ -61,6 +84,8 @@ module TurboRspec
         def constraint_description
           parts = []
           parts << " loaded" if @loaded
+          parts << " lazy" if @lazy
+          parts << " with src #{@src.inspect}" if @src
           parts << " with content #{@content.inspect}" if @content
           parts.join
         end

data/lib/turbo_rspec/matchers/have_turbo_stream.rb

@@ -28,6 +28,9 @@ module TurboRspec
         @target_all = nil
         @content = nil
         @partial = nil
+        @expected_count = nil
+        @count_type = :at_least
+        @matching_count = 0
       end
 
       # Constrains the match to streams with the given action.
@@ -70,12 +73,58 @@ module TurboRspec
         self
       end
 
+      # Asserts exactly one matching stream.
+      # @return [self]
+      def once
+        exactly(1)
+      end
+
+      # Asserts exactly two matching streams.
+      # @return [self]
+      def twice
+        exactly(2)
+      end
+
+      # Asserts exactly +n+ matching streams.
+      # @param n [Integer]
+      # @return [self]
+      def exactly(n)
+        @expected_count = n
+        @count_type = :exactly
+        self
+      end
+
+      # Asserts at least +n+ matching streams.
+      # @param n [Integer]
+      # @return [self]
+      def at_least(n)
+        @expected_count = n
+        @count_type = :at_least
+        self
+      end
+
+      # Asserts at most +n+ matching streams.
+      # @param n [Integer]
+      # @return [self]
+      def at_most(n)
+        @expected_count = n
+        @count_type = :at_most
+        self
+      end
+
+      # Fluent terminator so +.exactly(2).times+ reads naturally.
+      # @return [self]
+      def times
+        self
+      end
+
       # @param response_or_body [#body, String]
       # @return [Boolean]
       def matches?(response_or_body)
         @body = extract_body(response_or_body)
         @streams = parse_streams(@body)
-        @streams.any? { |stream| stream_matches?(stream) }
+        @matching_count = @streams.count { |stream| stream_matches?(stream) }
+        count_matches?(@matching_count)
       end
 
       # @param response_or_body [#body, String]
@@ -86,17 +135,17 @@ module TurboRspec
 
       # @return [String]
       def failure_message
-        "expected response to contain a turbo stream#{constraint_description}\n#{found_streams_message}"
+        "expected response to contain a turbo stream#{constraint_description}#{count_description}\n#{found_streams_message}"
       end
 
       # @return [String]
       def failure_message_when_negated
-        "expected response not to contain a turbo stream#{constraint_description}"
+        "expected response not to contain a turbo stream#{constraint_description}#{count_description}"
       end
 
       # @return [String]
       def description
-        "have turbo stream#{constraint_description}"
+        "have turbo stream#{constraint_description}#{count_description}"
       end
 
       private
@@ -143,6 +192,20 @@ module TurboRspec
         stream.to_html.include?(@partial)
       end
 
+      def count_matches?(n)
+        if @expected_count.nil?
+          n >= 1
+        else
+          # :nocov:
+          case @count_type
+          # :nocov:
+          when :exactly then n == @expected_count
+          when :at_least then n >= @expected_count
+          when :at_most then n <= @expected_count
+          end
+        end
+      end
+
       def constraint_description
         parts = []
         parts << " with action #{@action.inspect}" if @action
@@ -153,6 +216,17 @@ module TurboRspec
         parts.join
       end
 
+      def count_description
+        return "" if @expected_count.nil?
+        # :nocov:
+        case @count_type
+        # :nocov:
+        when :exactly then " exactly #{@expected_count} time(s)"
+        when :at_least then " at least #{@expected_count} time(s)"
+        when :at_most then " at most #{@expected_count} time(s)"
+        end
+      end
+
       def found_streams_message
         return "but no turbo streams were found in the response" if @streams.empty?
 
@@ -163,10 +237,15 @@ module TurboRspec
           lines << "  #{i + 1}. action=#{s["action"].inspect} target=#{s["target"].inspect} content=#{content_preview}"
         end
 
-        closest = closest_match
-        lines << ""
-        lines << "closest match (#{count_matching_constraints(closest)}/#{constraint_count} constraint(s) matched):"
-        lines.concat(constraint_diff(closest))
+        if @expected_count
+          lines << ""
+          lines << "#{@matching_count} of #{@streams.size} stream(s) matched the constraints"
+        else
+          closest = closest_match
+          lines << ""
+          lines << "closest match (#{count_matching_constraints(closest)}/#{constraint_count} constraint(s) matched):"
+          lines.concat(constraint_diff(closest))
+        end
 
         lines.join("\n")
       end

data/lib/turbo_rspec/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_rspec
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -34,6 +34,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- ".github/FUNDING.yml"
 - ".github/workflows/ci.yml"
 - ".github/workflows/publish.yml"
 - ".rubocop.yml"