diff --git a/lib/rspec/rails/matchers/action_cable.rb b/lib/rspec/rails/matchers/action_cable.rb index 12b811d7b..d33de16bf 100644 --- a/lib/rspec/rails/matchers/action_cable.rb +++ b/lib/rspec/rails/matchers/action_cable.rb @@ -3,6 +3,8 @@ module RSpec module Rails module Matchers + extend RSpec::Matchers::DSL + # Namespace for various implementations of ActionCable features # # @api private @@ -50,7 +52,10 @@ def have_broadcasted_to(target = nil) ActionCable::HaveBroadcastedTo.new(target, channel: described_class) end - alias_method :broadcast_to, :have_broadcasted_to + + alias_matcher :broadcast_to, :have_broadcasted_to do |desc| + desc.gsub("have broadcasted", "broadcast") + end private diff --git a/lib/rspec/rails/matchers/action_cable/have_broadcasted_to.rb b/lib/rspec/rails/matchers/action_cable/have_broadcasted_to.rb index 297d7cfcf..090065c2a 100644 --- a/lib/rspec/rails/matchers/action_cable/have_broadcasted_to.rb +++ b/lib/rspec/rails/matchers/action_cable/have_broadcasted_to.rb @@ -51,6 +51,10 @@ def thrice exactly(:thrice) end + def description + "have broadcasted #{base_description}" + end + def failure_message "expected to broadcast #{base_message}".tap do |msg| if @unmatching_msgs.any? @@ -140,18 +144,21 @@ def set_expected_number(relativity, count) end end - def base_message + def base_description "#{message_expectation_modifier} #{@expected_number} messages to #{stream}".tap do |msg| msg << " with #{data_description(@data)}" unless @data.nil? - msg << ", but broadcast #{@matching_msgs_count}" end end + def base_message + "#{base_description}, but broadcast #{@matching_msgs_count}" + end + def data_description(data) if data.is_a?(RSpec::Matchers::Composable) data.description else - data + data.inspect end end diff --git a/spec/rspec/rails/matchers/action_cable/have_broadcasted_to_spec.rb b/spec/rspec/rails/matchers/action_cable/have_broadcasted_to_spec.rb index 815a9225a..7e9470b3f 100644 --- a/spec/rspec/rails/matchers/action_cable/have_broadcasted_to_spec.rb +++ b/spec/rspec/rails/matchers/action_cable/have_broadcasted_to_spec.rb @@ -226,5 +226,33 @@ def broadcast(stream, msg) end end end + + it "has an appropriate description" do + expect(have_broadcasted_to("my_stream").description).to eq("have broadcasted exactly 1 messages to my_stream") + end + + it "has an appropriate description when aliased" do + expect(broadcast_to("my_stream").description).to eq("broadcast exactly 1 messages to my_stream") + end + + it "has an appropriate description when stream name is passed as an array" do + expect(have_broadcasted_to(%w[my_stream stream_2]).from_channel(channel).description).to eq("have broadcasted exactly 1 messages to broadcast:my_stream:stream_2") + end + + it "has an appropriate description not mentioning the channel when qualified with `#from_channel`" do + expect(have_broadcasted_to("my_stream").from_channel(channel).description).to eq("have broadcasted exactly 1 messages to my_stream") + end + + it "has an appropriate description including the expected contents when qualified with `#with`" do + expect(have_broadcasted_to("my_stream").from_channel(channel).with("hello world").description).to eq("have broadcasted exactly 1 messages to my_stream with \"hello world\"") + end + it "has an appropriate description including the matcher's description when qualified with `#with` and a composable matcher" do + expect( + have_broadcasted_to("my_stream") + .from_channel(channel) + .with(a_hash_including(a: :b)) + .description + ).to eq("have broadcasted exactly 1 messages to my_stream with a hash including {:a => :b}") + end end end