action-cable-testing 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: ee444fe922657c8eb469653a92b1e6283d11e5c6
-  data.tar.gz: 0bb6858c4b1d695ec8d7be341a25eb79c14b71e9
+  metadata.gz: 1937dec963674b1c524cc2e89fa7e3019861ddc8
+  data.tar.gz: 35c43aacde8ee6c44ce0a0921f4aa8a795e519e9
 SHA512:
-  metadata.gz: c1b6af262b55dc1104808a7d81e1d18ce3d3823824c48559f0ec1294099d8d20c92651b2f6ed5a0391638d04529a143b774d910630433304fcafb35584f8f4cd
-  data.tar.gz: 0a18ff1b692011d9f5880b9934f1c228f2c9aabd4fc6d58d3cd2137eb4de215d953212f3afe1492d10ba785ebf8989ae8a56c8270d5209ef882937829d9514be
+  metadata.gz: 65a6dbcf9d077659e1da92cc5237b01fa7194f5c929a31790f0ae14aad2d66a02a859c4ec16fbaf099ffbb85362f5b4bef62fdff319ddb1ce06845a3d6b0d4e9
+  data.tar.gz: f74589aff6ea7a682c26107687601c0b4efa3555a783e2e01f20edcfefc6cd9d6cadad8506a1481110e4d53e4557461c41a5fa16b32be67678aafd9507a053ca

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Change log
 
+## 0.1.2 (2017-11-14) ([@palkan][])
+
+- Add RSpec shared contexts to switch between adapters.
+
+See https://github.com/palkan/action-cable-testing/issues/4.
+
 ## 0.1.1
 
 - Support Rails 5.0.0.1. ([@palkan][])

data/README.md

@@ -180,6 +180,47 @@ RSpec.describe ChatChannel, type: :channel do
 end
 ```
 
+#### Shared contexts to switch between adapters
+
+Sometimes you may want to use _real_ Action Cable adapter instead of the test one (for example, in Capybara-like tests).
+
+We provide shared contexts to do that:
+
+```ruby
+# Use async adapter for this example group only
+RSpec.describe "cable case", action_cable: :async do
+ # ...
+
+  context "inline cable", action_cable: :inline do
+    # ...
+  end
+
+  # or test adapter
+  context "test cable", action_cable: :test do
+    # ...
+  end
+
+  # you can also include contexts by names
+  context "by name" do
+    include "action_cable:async"
+    # ...
+  end
+end
+```
+
+We also provide an integration for _feature_ specs (having `type: :feature`). Just add `require "action_cable/testing/rspec/features"`:
+
+```ruby
+# rails_helper.rb
+require "action_cable/testing/rspec"
+require "action_cable/testing/rspec/features"
+
+# spec/features/my_feature_spec.rb
+feature "Cables!" do
+  # here we have "action_cable:async" context included automatically!
+end
+```
+
 For more RSpec documentation see https://relishapp.com/palkan/action-cable-testing/docs.
 
 ### Generators

data/lib/action_cable/testing/rspec.rb

@@ -4,6 +4,7 @@ require "action-cable-testing"
 require "rspec/rails"
 require "rspec/rails/example/channel_example_group"
 require "rspec/rails/matchers/action_cable"
+require "rspec/rails/shared_contexts/action_cable"
 
 module RSpec # :nodoc:
   module Rails

data/lib/action_cable/testing/rspec/features.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+# Use async adapter for features specs by deafault
+RSpec.configure do |config|
+  config.include_context "action_cable:async", type: :feature
+end

data/lib/action_cable/testing/version.rb

@@ -2,6 +2,6 @@
 
 module ActionCable
   module Testing
-    VERSION = "0.1.1"
+    VERSION = "0.1.2"
   end
 end

data/lib/rspec/rails/shared_contexts/action_cable.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+# Generate contexts to use specific Action Cable adapter:
+# - "action_cable:async" (action_cable: :async)
+# - "action_cable:inline" (action_cable: :inline)
+# - "action_cable:test" (action_cabke: :test)
+%w[async inline test].each do |adapter|
+  RSpec.shared_context "action_cable:#{adapter}" do
+    require "action_cable/subscription_adapter/#{adapter}"
+
+    adapter_class = ActionCable::SubscriptionAdapter.const_get(adapter.capitalize)
+
+    before do
+      next if ActionCable.server.pubsub.is_a?(adapter_class)
+
+      @__was_pubsub_adapter__ = ActionCable.server.pubsub
+
+      adapter = adapter_class.new(ActionCable.server)
+      ActionCable.server.instance_variable_set(:@pubsub, adapter)
+    end
+
+    after do
+      next unless instance_variable_defined?(:@__was_pubsub_adapter__)
+      ActionCable.server.instance_variable_set(:@pubsub, @__was_pubsub_adapter__)
+    end
+  end
+
+  RSpec.configure do |config|
+    config.include_context "action_cable:#{adapter}", action_cable: adapter.to_sym
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: action-cable-testing
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Vladimir Dementyev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2017-11-06 00:00:00.000000000 Z
+date: 2017-11-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: actioncable
@@ -153,6 +153,7 @@ files:
 - lib/action_cable/test_helper.rb
 - lib/action_cable/testing.rb
 - lib/action_cable/testing/rspec.rb
+- lib/action_cable/testing/rspec/features.rb
 - lib/action_cable/testing/version.rb
 - lib/generators/rspec/channel/channel_generator.rb
 - lib/generators/rspec/channel/templates/channel_spec.rb.erb
@@ -160,6 +161,7 @@ files:
 - lib/generators/test_unit/channel/templates/unit_test.rb.erb
 - lib/rspec/rails/example/channel_example_group.rb
 - lib/rspec/rails/matchers/action_cable.rb
+- lib/rspec/rails/shared_contexts/action_cable.rb
 homepage: http://github.com/palkan/action-cable-testing
 licenses:
 - MIT