anycable-rails 1.0.0.preview2 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 93c88ec3ccf3eb9d145474e43aa8a851e32768de9b7c8ce1e6eb44cc0b24b0e9
-  data.tar.gz: b12bc69aa43afc035038ee85c80bce57b9beabe36d9d0b93f261125f3af32876
+  metadata.gz: 49d905b11d3ffb0c71c238ece809817adbbf336f489e1a317a692e9c50db0a5f
+  data.tar.gz: e632e101cb3e710548703da397843ef4c6f7df00f4afb2ba09a2a54a680ebd5c
 SHA512:
-  metadata.gz: 387d765e0d5f15c38d211e206eccc04982c4d20c4855539de49caefa58caffd0dd7a949f73817d576fc19b97a1e6359d0dd194520a3e9538b18aee987a5aa99e
-  data.tar.gz: c75876c69f2655296cefd54b3ac9cba5fdefcdabbea206c526d9ddb502fcb61095e2855582d5ca17884fdadf70e6e4406a43b5e21470b7ade8b6027064903c1e
+  metadata.gz: 1b6763e1152e6a2ce712053f6d6bc798c40af7f6fa01fc38f52e8105c924ac451c916ac7775e30dc83445f30b6956da4ddac1d83cda5360032b3c585f68bd0a5
+  data.tar.gz: d656c094dd40d392f2f1aaf093577e887d264dc75778b5a84da1563d24ce33c272ab34fdd526ec8d5ba22b5c5d570f0f86ba26b61821edbb21e2356446dd208b

data/CHANGELOG.md

@@ -1,152 +1,58 @@
 # Change log
 
-## 🚧 1.0.0 (_coming soon_)
+## master
 
-- **Ruby 2.5+ is required**. ([@palkan][])
-
-- Support `disconnect` messages. ([@palkan][])
-
-Added in Rails 6 (see [PR#34194](https://github.com/rails/rails/pull/34194)).
-
-- Add ability to persist _dirty_ `request.session` between RPC calls. ([@palkan][])
-
-This feature emulates the Action Cable behaviour where it's possible to use `request.session` as a shared Hash-like store.
-This could be used by some applications (e.g., [StimulusReflex](https://github.com/hopsoft/stimulus_reflex)-based).
-
-You must turn this feature on by setting `persistent_session_enabled: true` in the AnyCable configuration.
-
-- Add ability to use Rack middlewares when build a request for a connection. ([@bibendi][])
-
-- Add set up generator to configure a Rails application by running `bin/rails g anycable:setup`. ([@bibendi][])
-
-- Require a minimum version of Ruby when installing the gem. ([@bibendi][])
-
-- Add ability to develop the gem with Docker. ([@bibendi][])
-
-## 0.6.4 (2019-06-26) 👶
-
-- Fix Compatibility bug when using with AnyCable. ([@palkan][])
-
-  Compatibility patching (with `prepend` + `super`) conflicted with
-  the `ActionCable::Channel::Base` patching in the core functionality (which uses `alias`).
-
-  See [#95](https://github.com/anycable/anycable-rails/issues/95).
-
-## 0.6.3 (2019-03-26)
-
-- Fix connection factory reloading for development sake. ([@sponomarev][])
-
-- Add `:anycable` subscription adapter alias. ([@sponomarev][])
-
-- Don't set AnyCable connection factory for incompatible adapter ([@sponomarev][])
-
-  `anycable` server won't start with unpatched vanilla `ApplicationCable::Connection`.
-
-  Motivation in [#74](https://github.com/anycable/anycable-rails/issues/74).
-
-- Fix instance detection inside complex cases in compatibility cops ([@sponomarev][])
-
-## 0.6.2 (2019-01-10)
-
-- Fixed `anycable` 0.6.1 compatibility. ([@palkan][])
-
-- Broadcast logs to STDOUT in development only when server is running. ([@palkan][])
+## 1.0.0 (2020-07-01)
 
-  Fixes #59.
+- Support `rescue_from` in connections (Rails 6.1). ([@palkan][])
 
-## 0.6.1 (2018-11-15)
+- Make AnyCable patches compatible with Action Cable testing. ([@palkan][])
 
-- Fix regression introduced in [e64a366e](https://github.com/anycable/anycable-rails/commit/e64a366ea21293925e0c5c0b8e6595d65d5d0981#diff-fd0e56a6e825002eac978507c3581af7R14) ([@palkan][])
+- Do not add localhost `redis_url` to `anycable.yml` when Docker development method is chosen in `anycable:setup`. ([@palkan][])
 
-`Connection` patch could be loaded after `identify_by` is called, thus breaking
-identifiers.
+- Fix connection identifiers deserialization regression. ([@palkan][])
 
-## 0.6.0 (2018-11-15)
+Using non-strings or non-GlobalId-encoded objects was broken.
 
-**NOTE**: this version has been yanked from RubyGems due to the regression bug. Use 0.6.1.
+- Improve `anycable:setup` generator. ([@palkan][])
 
-- [PR #56](https://github.com/anycable/anycable-rails/pull/56) Request verification based on ActionCable config. ([@DmitryTsepelev][])
+Update Docker snippet, do not enable persistent sessions automatically,
+fix setting `config.action_cable.url` in environment configuration.
 
-- Add WS server session ID to log tags if present. ([@palkan][])
+- Add `state_attr_accessor` for channels. ([@palkan][])
 
-- Support tagged logging. ([@palkan][])
+Just like `attr_accessor` but "persists" the state between RPC calls.
 
-- Action Cable monkey-patches are only loaded in the context of AnyCable CLI. ([@palkan][])
+- Add `Channel#stop_stream_from` support. ([@palkan][])
 
-  No need to think about `requie` and `group` for `anycable-rails`, just add it to Gemfile.
+- Add `RemoteConnections` support. ([@palkan][])
 
-- Add `:any_cable` subscription adapter for Action Cable. ([@palkan][])
+- Add `AnyCable::Rails.enabled?` method which returns true if Action Cable uses AnyCable adapter. ([@palkan][])
 
-  Use `:any_cable` adapter for Action Cable to broadcast data to AnyCable.
+- Add `anycable:download` generator to download `anycable-go` binary. ([@palkan][])
 
-  No more `pubsub` monkey-patches 🎉.
-
-- Added Rails executor/reloader support. ([@palkan][])
-
-- **[Breaking]** No more generators. ([@palkan][])
-
-  No need to generate AnyCable runner script since `anycable` gem ships with
-  the CLI.
-
-- Add dynamic (`AnyCable::CompatibilityError`) compatibility checks. ([@DmitryTsepelev][])
-
-- Added static (RuboCop) compatibility checks. ([@DmitryTsepelev][])
-
-  See https://github.com/anycable/anycable-rails/issues/52
-
-## 0.5.4 (2018-06-13)
-
-- Fix duplicate logs in development. ([@palkan][])
-
-  Fixes https://github.com/anycable/anycable_demo/issues/5.
-
-## 0.5.3
-
-- Fix return value of `Connection#handle_close`. ([@palkan][])
-
-  Should always be `true`, we do not expect a failure here.
-
-## 0.5.2
-
-- Add config/anycable.yml to Rails generator. ([@alekseyl][])
-
-## 0.5.1
-
-- Improve Rails integration. ([@palkan][])
-
-Log to STDOUT in development.
-Make order of initializers more deterministic.
-Show warning if AnyCable is loaded after application initialization.
-
-## 0.5.0
-
-- [#17](https://github.com/anycable/anycable-rails/issues/17) Refactor logging. ([@palkan][])
-
-Use Rails logger everywhere.
-
-Add access logs ([anycable/anycable#20](https://github.com/anycable/anycable/issues/20)).
-
-## 0.4.7
+- **Ruby 2.5+ is required**. ([@palkan][])
 
-- Minor fixes. ([@palkan][])
+- Support `disconnect` messages. ([@palkan][])
 
-## 0.4.6
+Added in Rails 6 (see [PR#34194](https://github.com/rails/rails/pull/34194)).
 
-- Disable mounting default Action Cable server when AnyCable is loaded. ([@palkan][])
+- Add ability to persist _dirty_ `request.session` between RPC calls. ([@palkan][])
 
-## 0.4.5
+This feature emulates the Action Cable behaviour where it's possible to use `request.session` as a shared Hash-like store.
+This could be used by some applications (e.g., [StimulusReflex](https://github.com/hopsoft/stimulus_reflex)-based).
 
-- Handle tagged logger. ([@palkan][])
+You must turn this feature on by setting `persistent_session_enabled: true` in the AnyCable configuration.
 
-Ignore tagged logger features ('cause we do not have _persistent_ logger).
+- Add ability to use Rack middlewares when build a request for a connection. ([@bibendi][])
 
-## 0.4.4
+- Add set up generator to configure a Rails application by running `bin/rails g anycable:setup`. ([@bibendi][])
 
-- Fix bug with ActiveRecord connections (https://github.com/anycable/anycable/issues/9). ([@palkan][])
+- Require a minimum version of Ruby when installing the gem. ([@bibendi][])
 
-## 0.4.0
+- Add ability to develop the gem with Docker. ([@bibendi][])
 
-- Initial version. ([@palkan][])
+See [Changelog](https://github.com/anycable/anycable-rails/blob/0-6-stable/CHANGELOG.md) for versions <1.0.0.
 
 [@palkan]: https://github.com/palkan
 [@alekseyl]: https://github.com/alekseyl

data/README.md

@@ -1,6 +1,8 @@
-[![GitPitch](https://gitpitch.com/assets/badge.svg)](https://gitpitch.com/anycable/anycable/master?grs=github) [![Gem Version](https://badge.fury.io/rb/anycable-rails.svg)](https://rubygems.org/gems/anycable-rails) [![Build Status](https://travis-ci.org/anycable/anycable-rails.svg?branch=master)](https://travis-ci.org/anycable/anycable-rails)
+[![GitPitch](https://gitpitch.com/assets/badge.svg)](https://gitpitch.com/anycable/anycable/master?grs=github)
+[![Gem Version](https://badge.fury.io/rb/anycable-rails.svg)](https://rubygems.org/gems/anycable-rails)
+[![Build](https://github.com/anycable/anycable-rails/workflows/Build/badge.svg)](https://github.com/anycable/anycable-rails/actions)
 [![Gitter](https://img.shields.io/badge/gitter-join%20chat%20%E2%86%92-brightgreen.svg)](https://gitter.im/anycable/Lobby)
-[![Documentation](https://img.shields.io/badge/docs-link-brightgreen.svg)](https://docs.anycable.io/#/ruby/rails)
+[![Documentation](https://img.shields.io/badge/docs-link-brightgreen.svg)](https://docs.anycable.io/v1/#/ruby/rails)
 
 # AnyCable Rails
 
@@ -10,10 +12,11 @@ With AnyCable you can use channels, client-side JS, broadcasting - (almost) all
 
 You can even use Action Cable in development and not be afraid of [compatibility issues](#compatibility).
 
-💾 [Example Application](https://github.com/anycable/anycable_demo)
+**Important** This is a readme for the upcoming v1.0 release. For v0.6.x see the readme from the [0-6-stable](https://github.com/anycable/anycable-rails/tree/0-6-stable) branch.
 
-📑 [Documentation](https://docs.anycable.io).
+<!-- 💾 [Example Application](https://github.com/anycable/anycable_demo) -->
 
+📑 [Documentation](https://docs.anycable.io/v1/#/ruby/rails).
 
 <a href="https://evilmartians.com/">
 <img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54"></a>
@@ -21,12 +24,8 @@ You can even use Action Cable in development and not be afraid of [compatibility
 ## Requirements
 
 - Ruby >= 2.5
-- Rails >= 5.0;
-- Redis (see [other options]() for broadcasting)
-
-## How It Works?
-
-<img src="https://trello-attachments.s3.amazonaws.com/5781e0ed48e4679e302833d3/820x987/5b6a305417b04e20e75f49c5816e027c/Anycable_vs_ActionCable_copy.jpg" width="400" />
+- Rails >= 5.2
+- Redis (see [other options](https://github.com/anycable/anycable/issues/2) for broadcasting)
 
 ## Usage
 
@@ -39,14 +38,12 @@ gem "anycable-rails"
 gem "redis", ">= 4.0"
 ```
 
-(and don't forget to run `bundle install`).
-
 ### Interactive set up
 
 After the gem was installed, you can run an interactive wizard to configure your Rails application for using with AnyCable by running a generator:
 
 ```sh
-bin/rails g anycable:setup
+bundle exec rails g anycable:setup
 ```
 
 ### Manual set up
@@ -86,38 +83,21 @@ $ bundle exec anycable
 $ RAILS_ENV=production bundle exec anycable
 ```
 
-And, finally, run AnyCable WebSocket server, e.g. [anycable-go](https://docs.anycable.io/#/anycable-go/getting_started):
+And, finally, run AnyCable WebSocket server, e.g. [anycable-go](https://docs.anycable.io/v1/#/anycable-go/getting_started):
 
 ```sh
 anycable-go --host=localhost --port=3334
 ```
 
-See [documentation](https://docs.anycable.io/#/ruby/rails) for more information on AnyCable + Rails usage.
+See [documentation](https://docs.anycable.io/v1/#/ruby/rails) for more information on AnyCable + Rails usage.
 
 ## Action Cable Compatibility
 
-See [documentation](https://docs.anycable.io/#/ruby/compatibility).
-
-## Links
-
-- [AnyCable: Action Cable on steroids!](https://evilmartians.com/chronicles/anycable-actioncable-on-steroids)
-
-- [From Action to Any](https://medium.com/@leshchuk/from-action-to-any-1e8d863dd4cf) by [@alekseyl](https://github.com/alekseyl)
-
-## Talks
-
-- One cable to rule them all, RubyKaigi 2018, [slides](https://speakerdeck.com/palkan/rubykaigi-2018-anycable-one-cable-to-rule-them-all) and [video](https://www.youtube.com/watch?v=jXCPuNICT8s) (EN)
-
-- Wroc_Love.rb 2018 [slides](https://speakerdeck.com/palkan/wroc-love-dot-rb-2018-cables-cables-cables) and [video](https://www.youtube.com/watch?v=AUxFFOehiy0) (EN)
-
-## Compatible WebSocket servers
-
-- [AnyCable Go](https://github.com/anycable/anycable-go)
-- [ErlyCable](https://github.com/anycable/erlycable)
+See [documentation](https://docs.anycable.io/v1/#/ruby/compatibility).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://github.com/anycable/anycable-rails.
+Bug reports and pull requests are welcome on GitHub at [https://github.com/anycable/anycable-rails](https://github.com/anycable/anycable-rails).
 
 ## Development
 

data/lib/anycable/rails.rb

@@ -5,6 +5,8 @@ require "anycable/rails/version"
 require "anycable/rails/config"
 require "anycable/rails/rack"
 
+require "globalid"
+
 module AnyCable
   # Rails handler for AnyCable
   module Rails
@@ -12,8 +14,40 @@ module AnyCable
 
     ADAPTER_ALIASES = %w[any_cable anycable].freeze
 
-    def self.compatible_adapter?(adapter)
-      ADAPTER_ALIASES.include?(adapter)
+    class << self
+      def enabled?
+        adapter = ::ActionCable.server.config.cable&.fetch("adapter", nil)
+        compatible_adapter?(adapter)
+      end
+
+      def compatible_adapter?(adapter)
+        ADAPTER_ALIASES.include?(adapter)
+      end
+
+      # Serialize connection/channel state variable to string
+      # using GlobalID where possible or JSON (if json: true)
+      def serialize(obj, json: false)
+        obj.try(:to_gid_param) || (json ? obj.to_json : obj)
+      end
+
+      # Deserialize previously serialized value from string to
+      # Ruby object.
+      # If the resulting object is a Hash, make it indifferent
+      def deserialize(str, json: false)
+        str.yield_self do |val|
+          next val unless val.is_a?(String)
+
+          gval = GlobalID::Locator.locate(val)
+          return gval if gval
+
+          next val unless json
+
+          JSON.parse(val)
+        end.yield_self do |val|
+          next val.with_indifferent_access if val.is_a?(Hash)
+          val
+        end
+      end
     end
   end
 end

data/lib/anycable/rails/actioncable/channel.rb

@@ -28,6 +28,10 @@ module ActionCable
         connection.socket.subscribe identifier, broadcasting
       end
 
+      def stop_stream_from(broadcasting)
+        connection.socket.unsubscribe identifier, broadcasting
+      end
+
       def stop_all_streams
         connection.socket.unsubscribe_from_all identifier
       end

data/lib/anycable/rails/actioncable/connection.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
 require "action_cable/connection"
+require "anycable/rails/actioncable/connection/serializable_identification"
 require "anycable/rails/refinements/subscriptions"
 require "anycable/rails/actioncable/channel"
+require "anycable/rails/actioncable/remote_connections"
 require "anycable/rails/session_proxy"
 
 module ActionCable
@@ -15,26 +17,28 @@ module ActionCable
 
       using AnyCable::Refinements::Subscriptions
 
+      include SerializableIdentification
+
       attr_reader :socket
 
+      alias anycable_socket socket
+
       delegate :env, :session, to: :request
 
       class << self
         def call(socket, **options)
-          new(socket, options)
+          new(socket, nil, options)
         end
+      end
 
-        def identified_by(*identifiers)
-          super
-          Array(identifiers).each do |identifier|
-            define_method(identifier) do
-              instance_variable_get(:"@#{identifier}") || fetch_identifier(identifier)
-            end
-          end
+      def initialize(socket, env, identifiers: "{}", subscriptions: [])
+        if env
+          # If env is set, then somehow we're in the context of Action Cable
+          # Return and print a warning in #process
+          @request = ActionDispatch::Request.new(env)
+          return
         end
-      end
 
-      def initialize(socket, identifiers: "{}", subscriptions: [])
         @ids = ActiveSupport::JSON.decode(identifiers)
 
         @ltags = socket.cstate.read(LOG_TAGS_IDENTIFIER).yield_self do |raw_tags|
@@ -51,6 +55,18 @@ module ActionCable
         subscriptions.each { |id| @subscriptions.fetch(id) }
       end
 
+      def process
+        # Use Rails logger here to print to stdout in development
+        logger.error invalid_request_message
+        logger.info finished_request_message
+        [404, {"Content-Type" => "text/plain"}, ["Page not found"]]
+      end
+
+      def invalid_request_message
+        "You're trying to connect to Action Cable server while using AnyCable. " \
+        "See https://docs.anycable.io/v1/#/troubleshooting?id=server-raises-an-argumenterror-exception-when-client-tries-to-connect"
+      end
+
       def handle_open
         logger.info started_request_message if access_logs?
 
@@ -107,31 +123,6 @@ module ActionCable
         socket.transmit encode(cable_message)
       end
 
-      # Generate identifiers info.
-      # Converts GlobalID compatible vars to corresponding global IDs params.
-      def identifiers_hash
-        identifiers.each_with_object({}) do |id, acc|
-          obj = instance_variable_get("@#{id}")
-          next unless obj
-
-          acc[id] = obj.try(:to_gid_param) || obj
-        end.compact
-      end
-
-      def identifiers_json
-        identifiers_hash.to_json
-      end
-
-      # Fetch identifier and deserialize if neccessary
-      def fetch_identifier(name)
-        @cached_ids[name] ||= @cached_ids.fetch(name) do
-          val = ids[name.to_s]
-          next val unless val.is_a?(String)
-
-          GlobalID::Locator.locate(val) || val
-        end
-      end
-
       def logger
         @logger ||= TaggedLoggerProxy.new(AnyCable.logger, tags: ltags || [])
       end
@@ -207,3 +198,16 @@ module ActionCable
     # rubocop:enable Metrics/ClassLength
   end
 end
+
+# Support rescue_from
+# https://github.com/rails/rails/commit/d2571e560c62116f60429c933d0c41a0e249b58b
+if ActionCable::Connection::Base.respond_to?(:rescue_from)
+  ActionCable::Connection::Base.prepend(Module.new do
+    def handle_channel_command(*)
+      super
+    rescue Exception => e # rubocop:disable Lint/RescueException
+      rescue_with_handler(e) || raise
+      false
+    end
+  end)
+end