turbo_rspec 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8cfaf54d65cd35ab2ea68138d58d70252fecf6778511beebf78ad40cfd7e998e
-  data.tar.gz: 7bc4f9a0949b25625b59408c551d3e554ba48112b7f1c0e0f511ef5b79354878
+  metadata.gz: a7ce28ec048a3f308d82036741fa064f49ecdba1d9d66c7c84af42a3ef2b69e3
+  data.tar.gz: ef5cb3cfba998e9b7c64070eb8dbd319532c3e5584c09c7f6d5cc651ec53b71e
 SHA512:
-  metadata.gz: 1a13ab561704b49f3659e83160724cd2afdd1def359a70f0f1057a396fc9d1f6eaba99bf4b20e54b81af62c4a1aa1ffb9b530b2565977d2cf5ea711163cd5f6d
-  data.tar.gz: 8889b026ce58c96a12d0bf5b974dd2bdba7ce6d77520de5af6a31d45aa52a79899e9107c7b8148a1b1ce9f742ab5c1cf0da9f1999ebcd2e06120b9ee4c34b21c
+  metadata.gz: 6d85a8b12609e066c575f0d728ebffd0827c35fbb5b9d7572e6c7ec62493556aee058fb4dc005b1cfe9f2abe1359f5df7ef1c280bfc74b3427903aab9a8c92e5
+  data.tar.gz: 513effacfe8f0a663ae31456e9d82e7acb763ebc6eb04931fb536caab9d9c88752ad405ade01d79a296d8ef67e932ab6ce9e4edf0c6487b46873d9e3dfc4cab5

data/CHANGELOG.md

@@ -1,5 +1,16 @@
 ## [Unreleased]
 
+## [0.3.0] - 2026-05-28
+
+### Added
+
+- `have_turbo_frame(id)` Capybara matcher for system/feature specs — asserts a `<turbo-frame>` element is on the page
+  - `.with_content(text)` — asserts text content within the frame
+  - `.loaded` — asserts the frame has the `[complete]` attribute (finished loading)
+- `have_turbo_stream_tag` Capybara matcher — asserts a `<turbo-stream-source>` subscription element is present; accepts an optional signed stream name
+- `within_turbo_frame(id) { }` — scopes Capybara assertions to the frame's DOM
+- Auto-include `TurboRspec::Capybara::Matchers` into `type: :system` and `type: :feature` example groups when both `turbo-rails` and `capybara` are present
+
 ## [0.2.0] - 2026-05-28
 
 ### Added

data/README.md

@@ -22,7 +22,10 @@ end
 
 ### Rails + turbo-rails (automatic)
 
-No setup needed. When `turbo-rails` is in your bundle, `TurboRspec::Matchers` is automatically included in all `type: :request` example groups.
+No setup needed. When `turbo-rails` is in your bundle:
+
+- `TurboRspec::Matchers` is automatically included in all `type: :request` example groups
+- `TurboRspec::Capybara::Matchers` is automatically included in all `type: :system` and `type: :feature` example groups when `capybara` is also present
 
 ### Manual include
 
@@ -31,7 +34,8 @@ For non-Rails projects or custom contexts, include the matchers explicitly:
 ```ruby
 # spec/spec_helper.rb
 RSpec.configure do |config|
-  config.include TurboRspec::Matchers
+  config.include TurboRspec::Matchers                 # request specs
+  config.include TurboRspec::Capybara::Matchers       # system/feature specs
 end
 ```
 
@@ -40,7 +44,7 @@ end
 ```ruby
 # spec/support/turbo_rspec.rb
 TurboRspec.configure do |config|
-  config.auto_include = false  # disable automatic inclusion into request specs
+  config.auto_include = false  # disable automatic inclusion
 end
 ```
 
@@ -106,6 +110,76 @@ expect(response).to have_turbo_frame.with_id("post").rendering("posts/_post")
 expect(response).not_to have_turbo_frame.with_id("notifications")
 ```
 
+### `have_broadcasted_turbo_stream_to`
+
+Assert that a block broadcasts a `<turbo-stream>` over ActionCable. Requires ActionCable's test adapter.
+
+```ruby
+# Basic — any broadcast to the stream
+expect { MyJob.perform_now }.to have_broadcasted_turbo_stream_to("notifications")
+
+# With constraints (same chain as have_turbo_stream)
+expect { MyJob.perform_now }.to have_broadcasted_turbo_stream_to("notifications")
+  .with_action(:append)
+  .targeting("messages")
+  .with_content("Hello")
+
+# Count qualifiers
+expect { MyJob.perform_now }.to have_broadcasted_turbo_stream_to("notifications").once
+expect { MyJob.perform_now }.to have_broadcasted_turbo_stream_to("notifications").exactly(3).times
+expect { MyJob.perform_now }.to have_broadcasted_turbo_stream_to("notifications").at_least(2).times
+
+# Alias
+expect { MyJob.perform_now }.to broadcast_turbo_stream_to("notifications")
+
+# Negation
+expect { MyJob.perform_now }.not_to have_broadcasted_turbo_stream_to("notifications")
+```
+
+### `have_turbo_frame` (system/feature specs)
+
+Assert that a `<turbo-frame>` element is present on the page (Capybara).
+
+```ruby
+# Basic
+expect(page).to have_turbo_frame("messages")
+
+# With content
+expect(page).to have_turbo_frame("messages").with_content("Hello")
+
+# Loaded (frame finished loading)
+expect(page).to have_turbo_frame("messages").loaded
+
+# Negation
+expect(page).not_to have_turbo_frame("notifications")
+```
+
+### `within_turbo_frame`
+
+Scope Capybara assertions to a specific frame's DOM.
+
+```ruby
+within_turbo_frame("messages") do
+  expect(page).to have_content("Hello")
+  click_button "Reply"
+end
+```
+
+### `have_turbo_stream_tag`
+
+Assert that a `<turbo-stream-source>` subscription element is on the page.
+
+```ruby
+# Any stream source
+expect(page).to have_turbo_stream_tag
+
+# With signed stream name
+expect(page).to have_turbo_stream_tag("signed_stream_name")
+
+# Negation
+expect(page).not_to have_turbo_stream_tag
+```
+
 ## Example: request spec
 
 ```ruby
@@ -136,6 +210,25 @@ RSpec.describe "Messages", type: :request do
 end
 ```
 
+## Example: system spec
+
+```ruby
+RSpec.describe "Messages", type: :system do
+  it "appends a new message via Turbo Frame" do
+    visit messages_path
+    fill_in "Body", with: "Hello"
+    click_button "Send"
+
+    expect(page).to have_turbo_frame("messages").with_content("Hello")
+  end
+
+  it "shows the subscription stream tag" do
+    visit messages_path
+    expect(page).to have_turbo_stream_tag
+  end
+end
+```
+
 ## Contributing
 
 Bug reports and pull requests are welcome on [GitHub](https://github.com/eclectic-coding/turbo_rspec).

data/ROADMAP.md

@@ -5,16 +5,6 @@ RSpec matchers for [Turbo](https://github.com/hotwired/turbo-rails): Turbo Strea
 ---
 
 
-## v0.3.0 — Capybara / system spec integration
-
-**Goal:** assertions that work against a live browser in feature/system specs.
-
-- `have_turbo_frame(id)` Capybara matcher — waits for the frame to appear on the page
-  - `.with_content(...)` — delegates to Capybara's `have_content` with correct scope
-  - `.loaded` — asserts `[complete]` attribute is present (frame finished loading)
-- `within_turbo_frame(id) { ... }` — scopes Capybara assertions to the frame's DOM
-- `have_turbo_stream_tag` — asserts a `<turbo-stream-source>` subscription element exists on the page
-- Docs: system spec patterns, async update testing
 
 ---
 

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

@@ -0,0 +1,70 @@
+# frozen_string_literal: true
+
+module TurboRspec
+  module Capybara
+    module Matchers
+      class HaveTurboFrame
+        def initialize(id)
+          @id = id.to_s
+          @content = nil
+          @loaded = false
+        end
+
+        def with_content(text)
+          @content = text.to_s
+          self
+        end
+
+        def loaded
+          @loaded = 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 @content && !@node.has_content?(@content, wait: 0)
+          true
+        end
+
+        def does_not_match?(page_or_node)
+          !matches?(page_or_node)
+        end
+
+        def failure_message
+          if @node.nil?
+            "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)"
+          else
+            "expected turbo-frame##{@id} to have content #{@content.inspect}"
+          end
+        end
+
+        def failure_message_when_negated
+          "expected page not to have turbo-frame##{@id}#{constraint_description}"
+        end
+
+        def description
+          "have turbo-frame##{@id}#{constraint_description}"
+        end
+
+        private
+
+        def find_frame(page_or_node)
+          page_or_node.find("turbo-frame##{@id}", wait: 0)
+        rescue ::Capybara::ElementNotFound
+          nil
+        end
+
+        def constraint_description
+          parts = []
+          parts << " loaded" if @loaded
+          parts << " with content #{@content.inspect}" if @content
+          parts.join
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+module TurboRspec
+  module Capybara
+    module Matchers
+      class HaveTurboStreamTag
+        def initialize(signed_stream_name: nil)
+          @signed_stream_name = signed_stream_name
+        end
+
+        def matches?(page_or_node)
+          selector = build_selector
+          page_or_node.has_css?(selector, wait: 0)
+        end
+
+        def does_not_match?(page_or_node)
+          selector = build_selector
+          page_or_node.has_no_css?(selector, wait: 0)
+        end
+
+        def failure_message
+          "expected page to have a turbo-stream-source element#{stream_description}"
+        end
+
+        def failure_message_when_negated
+          "expected page not to have a turbo-stream-source element#{stream_description}"
+        end
+
+        def description
+          "have turbo-stream-source#{stream_description}"
+        end
+
+        private
+
+        def build_selector
+          if @signed_stream_name
+            "turbo-stream-source[src*=\"#{@signed_stream_name}\"]"
+          else
+            "turbo-stream-source"
+          end
+        end
+
+        def stream_description
+          @signed_stream_name ? " for #{@signed_stream_name.inspect}" : ""
+        end
+      end
+    end
+  end
+end

data/lib/turbo_rspec/capybara/matchers.rb

@@ -0,0 +1,24 @@
+# frozen_string_literal: true
+
+require_relative "matchers/have_turbo_frame"
+require_relative "matchers/have_turbo_stream_tag"
+
+module TurboRspec
+  module Capybara
+    module Matchers
+      def have_turbo_frame(id)
+        HaveTurboFrame.new(id)
+      end
+
+      def have_turbo_stream_tag(signed_stream_name = nil)
+        HaveTurboStreamTag.new(signed_stream_name: signed_stream_name)
+      end
+
+      # :nocov:
+      def within_turbo_frame(id, &block)
+        page.within("turbo-frame##{id}", &block)
+      end
+      # :nocov:
+    end
+  end
+end

data/lib/turbo_rspec/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TurboRspec
-  VERSION = "0.2.0"
+  VERSION = "0.3.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/capybara/matchers"
 
 module TurboRspec
   class Error < StandardError; end
@@ -23,6 +24,10 @@ module TurboRspec
     def install_rspec_integration(config)
       return unless configuration.auto_include && Gem.loaded_specs.key?("turbo-rails")
       config.include Matchers, type: :request
+      if Gem.loaded_specs.key?("capybara")
+        config.include Capybara::Matchers, type: :system
+        config.include Capybara::Matchers, type: :feature
+      end
     end
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: turbo_rspec
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -43,6 +43,9 @@ files:
 - Rakefile
 - codecov.yml
 - lib/turbo_rspec.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/matchers.rb
 - lib/turbo_rspec/matchers/have_broadcasted_turbo_stream_to.rb