anycable-rails 0.6.5 → 1.0.0.preview1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d538541df27b5712aadd225d788d43c7d6de563a15dcbb85dd9ef51ff1b13be4
-  data.tar.gz: e7e5c055860a07f2554af925cee5076a07f97cfcdfa7d540891cb187bbc32f72
+  metadata.gz: 38f23428dcd1556e40cdd060257acfd1f1987fbde5b567e8ede65d25b8adde5c
+  data.tar.gz: 0b03ddc51e2cd9f9f807fa2aea0f086d302501fbc585e6aa83079f93a4a24864
 SHA512:
-  metadata.gz: 007b964f71b796feb189e76d82f2ae3e16c679c56811b9a1b7105bc5663e5e432bcebe4f9a16a971e3819be658f2fcfb8198576d7c9d75495dcc9dcd9db7949e
-  data.tar.gz: 257f761cfdd1fc3b05d8e1446297a7b31119c667e88e73db1a72485252f5f57e672ee6ac3c39b72e32286b4994d7b62f30f888c4aa12039202c8ccc93fb8df38
+  metadata.gz: fb3ede8fe975ca5d7e20cf4f3b51eeb37e1fc0ce94a356bbf21b73c64a212cdc026684b371750280f3bf99176b219f201cf596fb54ebbaaa5eeda4476e8a8fce
+  data.tar.gz: e8bb32e3c81fdd83851cc7d0a494b645c0b2407128fc380c11178623f7aef1372971ed391ed72b79bfc0521ce8f70b7e25d97ec75cb8a66a2e614b38947b5aed

data/CHANGELOG.md

@@ -1,13 +1,23 @@
 # Change log
 
-## master
+## 🚧 1.0.0 (_coming soon_)
 
-## 0.6.5 (2020-02-05)
+- **Ruby 2.5+ is required**. ([@palkan][])
 
-- Make channel not found exception more descriptive. ([@palkan][])
+- Support `disconnect` messages. ([@palkan][])
 
-Previusly, we returned `Undefined method handle_subscribe for nil` when Action Cable
-couldn't resolve the channel class. Now we return `Channel not found: <name>`.
+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][])
 

data/README.md

@@ -20,7 +20,7 @@ You can even use Action Cable in development and not be afraid of [compatibility
 
 ## Requirements
 
-- Ruby >= 2.4; **NOTE:** for Ruby 2.6 use RC version of `google-protobuf` gem. In your Gemfile: `gem "google-protobuf", '>=3.7.0.rc.2'`
+- Ruby >= 2.5
 - Rails >= 5.0;
 - Redis (see [other options]() for broadcasting)
 
@@ -30,7 +30,6 @@ You can even use Action Cable in development and not be afraid of [compatibility
 
 ## Usage
 
-
 Add `anycable-rails` gem to your Gemfile:
 
 ```ruby
@@ -42,12 +41,25 @@ gem "redis", ">= 4.0"
 
 (and don't forget to run `bundle install`).
 
-Next, specify AnyCable subscription adapter for Action Cable:
+### 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
+```
+
+### Manual set up
+
+Specify AnyCable subscription adapter for Action Cable:
 
 ```yml
 # config/cable.yml
-production:
+development:
   adapter: any_cable # or anycable
+
+production:
+  adapter: any_cable
 ```
 
 and specify AnyCable WebSocket server URL:
@@ -66,7 +78,7 @@ config.action_cable.url = "wss://ws.example.com/cable"
 
 Then, run AnyCable RPC server:
 
-```ruby
+```sh
 $ bundle exec anycable
 
 # don't forget to provide Rails env

data/lib/action_cable/subscription_adapter/any_cable.rb

@@ -7,7 +7,8 @@ module ActionCable
     # AnyCable subscription adapter delegates broadcasts
     # to AnyCable
     class AnyCable < Base
-      def initialize(*); end
+      def initialize(*)
+      end
 
       def broadcast(channel, payload)
         ::AnyCable.broadcast(channel, payload)

data/lib/anycable/rails.rb

@@ -3,6 +3,7 @@
 require "anycable"
 require "anycable/rails/version"
 require "anycable/rails/config"
+require "anycable/rails/rack"
 
 module AnyCable
   # Rails handler for AnyCable

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

@@ -3,12 +3,13 @@
 require "action_cable/connection"
 require "anycable/rails/refinements/subscriptions"
 require "anycable/rails/actioncable/channel"
+require "anycable/rails/session_proxy"
 
 module ActionCable
   module Connection
     # rubocop: disable Metrics/ClassLength
     class Base # :nodoc:
-      # We store logger tags in identifiers to be able
+      # We store logger tags in the connection state to be able
       # to re-use them in the subsequent calls
       LOG_TAGS_IDENTIFIER = "__ltags__"
 
@@ -16,6 +17,8 @@ module ActionCable
 
       attr_reader :socket
 
+      delegate :env, :session, to: :request
+
       class << self
         def call(socket, **options)
           new(socket, options)
@@ -34,10 +37,12 @@ module ActionCable
       def initialize(socket, identifiers: "{}", subscriptions: [])
         @ids = ActiveSupport::JSON.decode(identifiers)
 
-        @ltags = ids.delete(LOG_TAGS_IDENTIFIER)
+        @ltags = socket.cstate.read(LOG_TAGS_IDENTIFIER).yield_self do |raw_tags|
+          next unless raw_tags
+          ActiveSupport::JSON.decode(raw_tags)
+        end
 
         @cached_ids = {}
-        @env = socket.env
         @coder = ActiveSupport::JSON
         @socket = socket
         @subscriptions = ActionCable::Connection::Subscriptions.new(self)
@@ -49,12 +54,17 @@ module ActionCable
       def handle_open
         logger.info started_request_message if access_logs?
 
-        verify_origin!
+        verify_origin! || return
 
         connect if respond_to?(:connect)
+
+        socket.cstate.write(LOG_TAGS_IDENTIFIER, fetch_ltags.to_json)
+
         send_welcome_message
       rescue ActionCable::Connection::Authorization::UnauthorizedError
-        reject_request
+        reject_request(
+          ActionCable::INTERNAL[:disconnect_reasons]&.[](:unauthorized) || "unauthorized"
+        )
       end
 
       def handle_close
@@ -84,7 +94,12 @@ module ActionCable
       end
       # rubocop:enable Metrics/MethodLength
 
-      def close
+      def close(reason: nil, reconnect: nil)
+        transmit(
+          type: ActionCable::INTERNAL[:message_types].fetch(:disconnect, "disconnect"),
+          reason: reason,
+          reconnect: reconnect
+        )
         socket.close
       end
 
@@ -95,9 +110,7 @@ module ActionCable
       # Generate identifiers info.
       # Converts GlobalID compatible vars to corresponding global IDs params.
       def identifiers_hash
-        obj = { LOG_TAGS_IDENTIFIER => fetch_ltags }
-
-        identifiers.each_with_object(obj) do |id, acc|
+        identifiers.each_with_object({}) do |id, acc|
           obj = instance_variable_get("@#{id}")
           next unless obj
 
@@ -123,6 +136,10 @@ module ActionCable
         @logger ||= TaggedLoggerProxy.new(AnyCable.logger, tags: ltags || [])
       end
 
+      def request
+        @request ||= build_rack_request
+      end
+
       private
 
       attr_reader :ids, :ltags
@@ -158,19 +175,33 @@ module ActionCable
       end
 
       def verify_origin!
-        return unless socket.env.key?("HTTP_ORIGIN")
+        return true unless socket.env.key?("HTTP_ORIGIN")
 
-        return if allow_request_origin?
+        return true if allow_request_origin?
 
-        raise(
-          ActionCable::Connection::Authorization::UnauthorizedError,
-          "Origin is not allowed"
+        reject_request(
+          ActionCable::INTERNAL[:disconnect_reasons]&.[](:invalid_request) || "invalid_request"
         )
+        false
       end
 
-      def reject_request
+      def reject_request(reason, reconnect = false)
         logger.info finished_request_message("Rejected") if access_logs?
-        close
+        close(
+          reason: reason,
+          reconnect: reconnect
+        )
+      end
+
+      def build_rack_request
+        environment = Rails.application.env_config.merge(socket.env)
+        AnyCable::Rails::Rack.app.call(environment)
+
+        ActionDispatch::Request.new(environment)
+      end
+
+      def request_loaded?
+        instance_variable_defined?(:@request)
       end
     end
     # rubocop:enable Metrics/ClassLength

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

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module ActionCable
+  module Connection
+    module PersistentSession
+      def handle_open
+        super.tap { commit_session! }
+      end
+
+      def handle_channel_command(*)
+        super.tap { commit_session! }
+      end
+
+      def build_rack_request
+        return super unless socket.session
+
+        super.tap do |req|
+          req.env[Rack::RACK_SESSION] =
+            AnyCable::Rails::SessionProxy.new(req.env[Rack::RACK_SESSION], socket.session)
+        end
+      end
+
+      def commit_session!
+        return unless request_loaded? && request.session.loaded?
+
+        socket.session = request.session.to_json
+      end
+    end
+  end
+end

data/lib/anycable/rails/compatibility.rb

@@ -12,7 +12,7 @@ module AnyCable
 
         if callback.present? || block_given?
           raise AnyCable::CompatibilityError,
-                "Custom stream callbacks are not supported by AnyCable"
+            "Custom stream callbacks are not supported by AnyCable"
         end
 
         super
@@ -35,8 +35,8 @@ module AnyCable
 
         unless diff.empty?
           raise AnyCable::CompatibilityError,
-                "Channel instance variables are not supported by AnyCable, " \
-                "but were set: #{diff.join(', ')}"
+            "Channel instance variables are not supported by AnyCable, " \
+            "but were set: #{diff.join(", ")}"
         end
 
         res
@@ -52,7 +52,7 @@ module AnyCable
     ActionCable::RemoteConnections::RemoteConnection.prepend(Module.new do
       def disconnect
         raise AnyCable::CompatibilityError,
-              "Disconnecting remote clients is not supported by AnyCable yet"
+          "Disconnecting remote clients is not supported by AnyCable yet"
       end
     end)
   end

data/lib/anycable/rails/compatibility/rubocop/config/default.yml

@@ -9,4 +9,3 @@ AnyCable/StreamFrom:
 AnyCable/PeriodicalTimers:
   Include:
     - "**/channels/**/*.rb"
-    

data/lib/anycable/rails/config.rb

@@ -2,7 +2,11 @@
 
 require "anycable/config"
 
-# Extend AnyCable configuration with
-# `access_logs_disabled` options (defaults to true)
-AnyCable::Config.attr_config access_logs_disabled: true
-AnyCable::Config.ignore_options :access_logs_disabled
+# Extend AnyCable configuration with:
+# - `access_logs_disabled` (defaults to true) — whether to print Started/Finished logs
+# - `persistent_session_enabled` (defaults to false) — whether to store session changes in the connection state
+AnyCable::Config.attr_config(
+  access_logs_disabled: true,
+  persistent_session_enabled: false
+)
+AnyCable::Config.ignore_options :access_logs_disabled, :persistent_session_enabled

data/lib/anycable/rails/rack.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+require "rails/configuration"
+require "action_dispatch/middleware/stack"
+
+module AnyCable
+  module Rails
+    # Rack middleware stack to modify the HTTP request object.
+    #
+    # AnyCable Websocket server does not use Rack middleware processing mechanism (which Rails uses
+    # when Action Cable is mounted into the main app).
+    #
+    # Some middlewares could enhance request env with useful information.
+    #
+    # For instance, consider the Rails session middleware: it's responsible for restoring the
+    # session data from cookies.
+    #
+    # AnyCable adds session middelware by default to its own stack.
+    #
+    # You can also use any Rack/Rails middleware you want. For example, to enable Devise/Warden
+    # you can add the following code to an initializer or any other configuration file:
+    #
+    #   AnyCable::Rails::Rack.middleware.use Warden::Manager do |config|
+    #     Devise.warden_config = config
+    #   end
+    module Rack
+      def self.app_build_lock
+        @app_build_lock
+      end
+
+      @app_build_lock = Mutex.new
+
+      def self.middleware
+        @middleware ||= ::Rails::Configuration::MiddlewareStackProxy.new
+      end
+
+      def self.default_middleware_stack
+        config = ::Rails.application.config
+
+        ActionDispatch::MiddlewareStack.new do |middleware|
+          middleware.use(config.session_store, config.session_options)
+        end
+      end
+
+      def self.app
+        @rack_app || app_build_lock.synchronize do
+          @rack_app ||= begin
+            stack = default_middleware_stack
+            @middleware = middleware.merge_into(stack)
+            middleware.build { [-1, {}, []] }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/anycable/rails/railtie.rb

@@ -16,7 +16,7 @@ module AnyCable
 
         # Broadcast server logs to STDOUT in development
         if ::Rails.env.development? &&
-           !ActiveSupport::Logger.logger_outputs_to?(::Rails.logger, STDOUT)
+            !ActiveSupport::Logger.logger_outputs_to?(::Rails.logger, STDOUT)
           AnyCable.configure_server do
             console = ActiveSupport::Logger.new(STDOUT)
             console.formatter = ::Rails.logger.formatter
@@ -46,6 +46,13 @@ module AnyCable
           if AnyCable::Rails.compatible_adapter?(adapter)
             require "anycable/rails/actioncable/connection"
 
+            if AnyCable.config.persistent_session_enabled
+              require "anycable/rails/actioncable/connection/persistent_session"
+              ::ActionCable::Connection::Base.prepend(
+                ::ActionCable::Connection::PersistentSession
+              )
+            end
+
             app.config.to_prepare do
               AnyCable.connection_factory = ActionCable.server.config.connection_class.call
             end

data/lib/anycable/rails/refinements/subscriptions.rb

@@ -7,11 +7,6 @@ module AnyCable
         # Find or add a subscription to the list
         def fetch(identifier)
           add("identifier" => identifier) unless subscriptions[identifier]
-
-          unless subscriptions[identifier]
-            raise "Channel not found: #{ActiveSupport::JSON.decode(identifier).fetch('channel')}"
-          end
-
           subscriptions[identifier]
         end
       end

data/lib/anycable/rails/session_proxy.rb

@@ -0,0 +1,62 @@
+# frozen_string_literal: true
+
+module AnyCable
+  module Rails
+    # Wrap `request.session` to lazily load values provided
+    # in the RPC call (set by the previous calls)
+    class SessionProxy
+      delegate_missing_to :@rack_session
+
+      attr_reader :rack_session, :socket_session
+
+      def initialize(rack_session, socket_session)
+        @rack_session = rack_session
+        @socket_session = JSON.parse(socket_session).with_indifferent_access
+      end
+
+      %i[has_key? [] []= fetch delete dig].each do |mid|
+        class_eval <<~CODE, __FILE__, __LINE__ + 1
+          def #{mid}(*args, **kwargs, &block)
+            restore_key! args.first
+            rack_session.#{mid}(*args, **kwargs, &block)
+          end
+        CODE
+      end
+
+      alias include? has_key?
+      alias key? has_key?
+
+      %i[update merge! to_hash].each do |mid|
+        class_eval <<~CODE, __FILE__, __LINE__ + 1
+          def #{mid}(*args, **kwargs, &block)
+            restore!
+            rack_session.#{mid}(*args, **kwargs, &block)
+          end
+        CODE
+      end
+
+      alias to_h to_hash
+
+      def keys
+        rack_session.keys + socket_session.keys
+      end
+
+      private
+
+      def restore!
+        socket_session.keys.each(&method(:restore_key!))
+      end
+
+      def restore_key!(key)
+        return unless socket_session.key?(key)
+        val = socket_session.delete(key)
+        rack_session[key] =
+          if val.is_a?(String)
+            GlobalID::Locator.locate(val) || val
+          else
+            val
+          end
+      end
+    end
+  end
+end

data/lib/anycable/rails/version.rb

@@ -2,6 +2,6 @@
 
 module AnyCable
   module Rails
-    VERSION = "0.6.5"
+    VERSION = "1.0.0.preview1"
   end
 end

data/lib/rails/generators/anycable/setup/setup_generator.rb

@@ -0,0 +1,267 @@
+# frozen_string_literal: true
+
+module AnyCableRailsGenerators
+  # Entry point for interactive installation
+  class SetupGenerator < ::Rails::Generators::Base
+    namespace "anycable:setup"
+    source_root File.expand_path("templates", __dir__)
+
+    METHODS = %w[skip local docker].freeze
+    SERVER_VERSION = "v0.6.4"
+    OS_NAMES = %w[linux darwin freebsd win].freeze
+    CPU_NAMES = %w[amd64 arm64 386 arm].freeze
+    SERVER_SOURCES = %w[skip brew binary].freeze
+    DEFAULT_BIN_PATH = "/usr/local/bin"
+
+    class_option :method,
+      type: :string,
+      desc: "Select your development environment (options: #{METHODS.join(", ")})"
+    class_option :source,
+      type: :string,
+      desc: "Choose a way of installing AnyCable-Go server (options: #{SERVER_SOURCES.join(", ")})"
+    class_option :bin_path,
+      type: :string,
+      desc: "Where to download AnyCable-Go server binary (default: #{DEFAULT_BIN_PATH})"
+    class_option :os,
+      type: :string,
+      desc: "Specify the OS for AnyCable-Go server binary (options: #{OS_NAMES.join(", ")})"
+    class_option :cpu,
+      type: :string,
+      desc: "Specify the CPU architecturefor AnyCable-Go server binary (options: #{CPU_NAMES.join(", ")})"
+    class_option :skip_heroku,
+      type: :boolean,
+      desc: "Do not copy Heroku configs"
+    class_option :skip_procfile_dev,
+      type: :boolean,
+      desc: "Do not create Procfile.dev"
+
+    def welcome
+      say "👋 Welcome to AnyCable interactive installer."
+    end
+
+    def configs
+      inside("config") do
+        template "cable.yml"
+        template "anycable.yml"
+      end
+    end
+
+    def cable_url
+      environment(nil, env: :development) do
+        <<~SNIPPET
+          # Specify AnyCable WebSocket server URL to use by JS client
+          config.action_cable.url = ENV.fetch("CABLE_URL", "ws://localhost:3334/cable").presence
+        SNIPPET
+      end
+
+      environment(nil, env: :production) do
+        <<~SNIPPET
+          # Specify AnyCable WebSocket server URL to use by JS client
+          config.action_cable.url = ENV["CABLE_URL"].presence
+        SNIPPET
+      end
+
+      say_status :info, "✅ 'config.action_cable.url' has been configured"
+      say_status :help, "⚠️ If you're using JS client make sure you have " \
+                        "`action_cable_meta_tag` included before any <script> tag in your application.html"
+    end
+
+    def development_method
+      answer = METHODS.index(options[:method]) || 99
+
+      until METHODS[answer.to_i]
+        answer = ask "Which environment do you use for development? (1) Local, (2) Docker, (0) Skip"
+      end
+
+      case env = METHODS[answer.to_i]
+      when "skip"
+        say_status :help, "⚠️ Please, read this guide on how to install AnyCable-Go server 👉 https://docs.anycable.io/#/anycable-go/getting_started", :yellow
+      else
+        send "install_for_#{env}"
+      end
+    end
+
+    def heroku
+      if options[:skip_heroku].nil?
+        return unless yes? "Do you use Heroku for deployment?"
+      elsif options[:skip_heroku]
+        return
+      end
+
+      template "Procfile"
+      inside("bin") { template "heroku-web" }
+
+      say_status :help, "️️⚠️ Please, read the required steps to configure Heroku applications 👉 https://docs.anycable.io/#/deployment/heroku", :yellow
+    end
+
+    def devise
+      in_root do
+        return unless File.file?("config/initializers/devise.rb")
+      end
+
+      inside("config/initializers") do
+        template "anycable.rb"
+      end
+
+      say_status :info, "✅ config/initializers/anycable.rb with Devise configuration has been added"
+    end
+
+    def finish
+      say_status :info, "✅ AnyCable has been configured successfully!"
+    end
+
+    private
+
+    def stimulus_reflex?
+      !gemfile_lock&.match?(/^\s+stimulus_reflex\b/).nil?
+    end
+
+    def gemfile_lock
+      @gemfile_lock ||= begin
+        res = nil
+        in_root do
+          next unless File.file?("Gemfile.lock")
+          res = File.read("Gemfile.lock")
+        end
+        res
+      end
+    end
+
+    def install_for_docker
+      say_status :help, "️️⚠️ Docker development configuration could vary", :yellow
+
+      say "Here is an example snippet for docker-compose.yml:"
+      say <<~YML
+        ─────────────────────────────────────────
+        anycable-ws:
+          image: anycable/anycable-go:v0.6.4
+          ports:
+            - '3334:3334'
+          environment:
+            PORT: 3334
+            ANYCABLE_REDIS_URL: redis://redis:6379/0
+            ANYCABLE_RPC_HOST: anycable-rpc:50051
+          depends_on:
+            - anycable-rpc
+            - redis
+
+        anycable-rpc:
+          <<: *backend
+          command: bundle exec anycable
+          environment:
+            <<: *backend_environment
+            ANYCABLE_REDIS_URL: redis://redis:6379/0
+            ANYCABLE_RPC_HOST: 0.0.0.0:50051
+          ports:
+            - '50051'
+        ─────────────────────────────────────────
+      YML
+    end
+
+    def install_for_local
+      install_server
+      template_proc_files
+    end
+
+    def install_server
+      answer = SERVER_SOURCES.index(options[:source]) || 99
+
+      until SERVER_SOURCES[answer.to_i]
+        answer = ask "How do you want to install AnyCable-Go WebSocket server? (1) Homebrew, (2) Download binary, (0) Skip"
+      end
+
+      case answer.to_i
+      when 0
+        say_status :help, "⚠️ Please, read this guide on how to install AnyCable-Go server 👉 https://docs.anycable.io/#/anycable-go/getting_started", :yellow
+        return
+      else
+        return unless send("install_from_#{SERVER_SOURCES[answer.to_i]}")
+      end
+
+      say_status :info, "✅ AnyCable-Go WebSocket server has been successfully installed"
+    end
+
+    def template_proc_files
+      file_name = "Procfile.dev"
+
+      if File.exist?(file_name)
+        append_file file_name, 'anycable: bundle exec anycable --server-command "anycable-go --port 3334"'
+      else
+        say_status :help, "💡 We recommend using Hivemind to manage multiple processes in development 👉 https://github.com/DarthSim/hivemind", :yellow
+
+        if options[:skip_procfile_dev].nil?
+          return unless yes? "Do you want to create a '#{file_name}' file?"
+        elsif options[:skip_procfile_dev]
+          return
+        end
+
+        template file_name
+      end
+    end
+
+    def install_from_brew
+      run "brew install anycable-go", abort_on_failure: true
+      run "anycable-go -v", abort_on_failure: true
+    end
+
+    def install_from_binary
+      out = options[:bin_path] if options[:bin_path]
+      out ||= "/usr/local/bin" if options[:method] # User don't want interactive mode
+      out ||= ask "Please, enter the path to download the AnyCable-Go binary to", default: DEFAULT_BIN_PATH, path: true
+
+      os_name = options[:os] ||
+        OS_NAMES.find(&Gem::Platform.local.os.method(:==)) ||
+        ask("What is your OS name?", limited_to: OS_NAMES)
+
+      cpu_name = options[:cpu] ||
+        CPU_NAMES.find(&current_cpu.method(:==)) ||
+        ask("What is your CPU architecture?", limited_to: CPU_NAMES)
+
+      download_exe(
+        "https://github.com/anycable/anycable-go/releases/download/#{SERVER_VERSION}/" \
+        "anycable-go-#{SERVER_VERSION}-#{os_name}-#{cpu_name}",
+        to: out,
+        file_name: "anycable-go"
+      )
+
+      true
+    end
+
+    def download_exe(url, to:, file_name:)
+      file_path = File.join(to, file_name)
+
+      run "#{sudo(to)}curl -L #{url} -o #{file_path}", abort_on_failure: true
+      run "#{sudo(to)}chmod +x #{file_path}", abort_on_failure: true
+      run "#{file_path} -v", abort_on_failure: true
+    end
+
+    def sudo!(path)
+      sudo = ""
+      unless File.writable?(path)
+        if yes? "Path is not writable 😕. Do you have sudo privileges?"
+          sudo = "sudo "
+        else
+          say_status :error, "❌ Failed to install AnyCable-Go WebSocket server", :red
+          raise StandardError, "Path #{path} is not writable!"
+        end
+      end
+
+      sudo
+    end
+
+    def current_cpu
+      case Gem::Platform.local.cpu
+      when "x86_64", "x64"
+        "amd64"
+      when "x86_32", "x86", "i386", "i486", "i686"
+        "i386"
+      when "aarch64", "aarch64_be", /armv8/
+        "arm64"
+      when "arm", /armv7/, /armv6/
+        "arm"
+      else
+        "unknown"
+      end
+    end
+  end
+end

data/lib/rails/generators/anycable/setup/templates/Procfile

@@ -0,0 +1,2 @@
+web: bin/heroku-web
+release: bundle exec rails db:migrate

data/lib/rails/generators/anycable/setup/templates/Procfile.dev

@@ -0,0 +1,3 @@
+server: bin/rails server
+assets: bin/webpack-dev-server
+anycable: bundle exec anycable --server-command "anycable-go --port 3334"

data/lib/rails/generators/anycable/setup/templates/bin/heroku-web

@@ -0,0 +1,7 @@
+#!/bin/bash
+
+if [ "$ANYCABLE_DEPLOYMENT" == "true" ]; then
+  bundle exec anycable --server-command="anycable-go"
+else
+  bundle exec rails server -p $PORT -b 0.0.0.0
+fi

data/lib/rails/generators/anycable/setup/templates/config/anycable.yml.tt

@@ -0,0 +1,32 @@
+# This file contains per-environment settings for AnyCable.
+#
+# Since AnyCable config is based on anyway_config (https://github.com/palkan/anyway_config), all AnyCable settings
+# can be set or overridden through the corresponding environment variables.
+# E.g., `rpc_host` is overridden by ANYCABLE_RPC_HOST, `debug` by ANYCABLE_DEBUG etc.
+#
+# Note that AnyCable recognizes REDIS_URL env variable for Redis pub/sub adapter. If you want to
+# use another Redis instance for AnyCable, provide ANYCABLE_REDIS_URL variable.
+#
+# Read more about AnyCable configuration here: https://docs.anycable.io/#/ruby/configuration
+#
+default: &default
+  # Turn on/off access logs ("Started..." and "Finished...")
+  access_logs_disabled: false
+  # Persist "dirty" session between RPC calls (might be required for StimulusReflex apps)
+  persistent_session_enabled: <%= stimulus_reflex? %>
+  # This is the host and the port to run AnyCable RPC server on.
+  # You must configure your WebSocket server to connect to it, e.g.:
+  #   $ anycable-go --rpc-host="<rpc hostname>:50051"
+  rpc_host: "127.0.0.1:50051"
+  # Whether to enable gRPC level logging or not
+  log_grpc: false
+  # Use the same channel name for WebSocket server, e.g.:
+  #   $ anycable-go --redis-channel="__anycable__"
+  redis_channel: "__anycable__"
+
+development:
+  <<: *default
+  redis_url: "redis://localhost:6379/1"
+
+production:
+  <<: *default

data/lib/rails/generators/anycable/setup/templates/config/cable.yml.tt

@@ -0,0 +1,11 @@
+# Make it possible to switch adapters by passing the CABLE_ADAPTER env variable.
+# For example, you can use it fallback to the standard Action Cable in staging/review
+# environments (by setting `CABLE_ADAPTER=redis`).
+development:
+  adapter: <%%= ENV.fetch("CABLE_ADAPTER", "any_cable") %>
+
+test:
+  adapter: test
+
+production:
+  adapter: <%%= ENV.fetch("CABLE_ADAPTER", "any_cable") %>

data/lib/rails/generators/anycable/setup/templates/config/initializers/anycable.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+# Add Warden middkeware to AnyCable stack to allow accessing
+# Devise current user via `env["warden"].user`.
+#
+# See http://docs.anycable.io/#/ruby/authentication
+AnyCable::Rails::Rack.middleware.use Warden::Manager do |config|
+  Devise.warden_config = config
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anycable-rails
 version: !ruby/object:Gem::Version
-  version: 0.6.5
+  version: 1.0.0.preview1
 platform: ruby
 authors:
 - palkan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-05 00:00:00.000000000 Z
+date: 2020-02-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anycable
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 1.0.0.preview1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.6.0
+        version: 1.0.0.preview1
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
@@ -39,33 +39,33 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '5'
 - !ruby/object:Gem::Dependency
-  name: bundler
+  name: ammeter
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '1.1'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.10'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
-  name: pry-byebug
+  name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.10'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '1.10'
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
@@ -95,19 +95,19 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '3.4'
 - !ruby/object:Gem::Dependency
-  name: rubocop
+  name: rubocop-md
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.67.0
+        version: '0.3'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.67.0
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: simplecov
   requirement: !ruby/object:Gem::Requirement
@@ -122,6 +122,34 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.3.8
+- !ruby/object:Gem::Dependency
+  name: standard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.1.7
+- !ruby/object:Gem::Dependency
+  name: warden
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: Rails adapter for AnyCable
 email:
 - dementiev.vm@gmail.com
@@ -138,6 +166,7 @@ files:
 - lib/anycable/rails.rb
 - lib/anycable/rails/actioncable/channel.rb
 - lib/anycable/rails/actioncable/connection.rb
+- lib/anycable/rails/actioncable/connection/persistent_session.rb
 - lib/anycable/rails/compatibility.rb
 - lib/anycable/rails/compatibility/rubocop.rb
 - lib/anycable/rails/compatibility/rubocop/config/default.yml
@@ -148,9 +177,18 @@ files:
 - lib/anycable/rails/config.rb
 - lib/anycable/rails/middlewares/executor.rb
 - lib/anycable/rails/middlewares/log_tagging.rb
+- lib/anycable/rails/rack.rb
 - lib/anycable/rails/railtie.rb
 - lib/anycable/rails/refinements/subscriptions.rb
+- lib/anycable/rails/session_proxy.rb
 - lib/anycable/rails/version.rb
+- lib/rails/generators/anycable/setup/setup_generator.rb
+- lib/rails/generators/anycable/setup/templates/Procfile
+- lib/rails/generators/anycable/setup/templates/Procfile.dev
+- lib/rails/generators/anycable/setup/templates/bin/heroku-web
+- lib/rails/generators/anycable/setup/templates/config/anycable.yml.tt
+- lib/rails/generators/anycable/setup/templates/config/cable.yml.tt
+- lib/rails/generators/anycable/setup/templates/config/initializers/anycable.rb
 homepage: http://github.com/anycable/anycable-rails
 licenses:
 - MIT
@@ -168,12 +206,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.4'
+      version: '2.5'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">="
+  - - ">"
     - !ruby/object:Gem::Version
-      version: '0'
+      version: 1.3.1
 requirements: []
 rubygems_version: 3.0.6
 signing_key: