turbo_rspec 0.5.0 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c9273ce0d0b091c73a80681f52986b639412d89b64fff6a8d79f40ce2b742997
-  data.tar.gz: 84d380b306f6a75ebc0af9ae8c5beed6c141c0da44ea736706eeb17392c63489
+  metadata.gz: 7e6568858c6d2ba4487a184d5161e3a254368447704c86437f7f5753003af0bb
+  data.tar.gz: c3b05381ef257037eb0112e3bc925d4db1973780e16d6d56a9cd842db9f4d994
 SHA512:
-  metadata.gz: 3965ea0fe3c731120ffa83a5efc331c1bd420e3271c153f1e3be37c1b62fe5b8243ae3fc20f4a8ab8723403ed0a9dd0aa7f07ad242a864b769e242dd6087a2f1
-  data.tar.gz: 82357eebbe233ed14882216b2075f29d1a97e4d0aed68c789a79747da1ac4aaf84a88ef8b8d0273204a9cd81c3f6e2dc5b04d933bca6e16b988e8749538812ff
+  metadata.gz: 710e2a679f38e346a19031c81441b2ce56e0317b5b770275a1d69d1117fb7eb48af0551e1c5c6a62cd4651cdee9cc6976c32ec038472b3dd5beea2d5d978e662
+  data.tar.gz: 557f56e9807599846b81204772ec47919daf2621ef090253971f1f9f9390bc5f22a63e438a9c4715dedbb939c44c4c517654852ac41fc87392bee88b4f8ff83d

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [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

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

data/ROADMAP.md

@@ -4,17 +4,6 @@ RSpec matchers for [Turbo](https://github.com/hotwired/turbo-rails): Turbo Strea
 
 ---
 
-## 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/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.5.0"
+  VERSION = "0.6.0"
 end

data/lib/turbo_rspec.rb

@@ -3,7 +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
@@ -25,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.5.0
+  version: 0.6.0
 platform: ruby
 authors:
 - Chuck Smith
@@ -48,11 +48,13 @@ files:
 - 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