anycable 1.0.0.preview2 → 1.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 61d002d899e5ef0c6c8e17b131a569dee4e93d948a9a2d401e20c764ee573ae2
-  data.tar.gz: 20743c021aa6c79177cd727d31468b1823ed492c11da1967513fa7cd5bc18f0a
+  metadata.gz: dd11b4e0403da1e162132375055bc2815c48ee57c3554a04ed72683d91fb0fde
+  data.tar.gz: '0568d54349b5e0a452f00119678b37964bb8c0102f512010e015c0b836a2ef6f'
 SHA512:
-  metadata.gz: a5d8ce6d031bfa1b65e12cbe49a1bb2813267997d090126a09fe55d30dc7e44a62c5315bf3e1f430bb6c8a67909245db2a9e03d3654ac7922cc08d6d09a7c14a
-  data.tar.gz: eb9ecd34150e474fbb8c914d3f0b95e3c23752fe141fc6acf5819fefbaface12d27103bc0a62487d42ec3d76e2228c43f0c3e9b3c34423fc71ce422ad0200131
+  metadata.gz: 22ded17aa347fe2c26d0d0aa6ceeb4958244a0d82a9d50f358f0c6c0b8433004ea71f62810bd757e9cf11c896596896c31859e6af62716b218f61f72b6d4d3fe
+  data.tar.gz: 3f52eade080b1de1ecdc39624a87b6840239392ebcf30bada85e44706cbd7c819cecc566a1eb5b7e8fa9cff5c567ab5929c3ec2189c4fb300e94357cbbb4ca42

data/CHANGELOG.md

@@ -1,288 +1,61 @@
 # Change log
 
-## 🚧 1.0.0 (_coming soon_)
+## master
 
-- **RPC schema has changed**. ([@palkan][])
-
-Using `anycable-go` v1.x is required.
-
-- **Ruby 2.5+ is required**. ([@palkan][])
-
-- Added RPC proto version check. ([@palkan][])
-
-Server must sent `protov` metadata with the supported versions (comma-separated list). If there is no matching version an exception is raised.
-
-Current RPC proto version is **v1**.
-
-- Added `request` support to channels. ([@palkan][])
-
-Now you can access `request` object in channels, too (e.g., to read headers/cookies/URL/etc).
-
-- Change default server address from `[::]:50051` to `127.0.0.1:50051`. ([@palkan][])
-
-See [#71](https://github.com/anycable/anycable/pull/71).
-
-## 0.6.5 (2020-04-01)
-
-- Relax `anyway_config` dependency. ([@palkan][])
-
-## 0.6.4 (2020-01-24)
-
-- Fix Ruby 2.7 warnings. ([@palkan][])
-
-– Add `REMOTE_ADDR` socket env variable using a synthetic header passed from a websocket
-server. ([@sponomarev][])
-
-Recreating a request object in your custom connection factory using `Rack::Request` or
-`ActionDispatch::Request` (already implemented in [anycable-rails](https://github.com/anycable/anycable-rails))
-gives you an access to `request.ip` with the properly set IP address.
-
-- Align socket env to be more compatible with Rack Spec ([@sponomarev][])
-
-Provide as much env details as possible to be able to reconstruct the full
-request object in a custom connection factory.
-
-## 0.6.3 (2019-03-26)
-
-- Relax `redis` gem version requirement. ([@palkan][])
-
-Use the same restriction as Action Cable does (`>= 3`).
-
-## 0.6.2 (2019-03-15)
-
-- Add GRPC service method name and message content to exception notifications ([@sponomarev][])
-
-`Anycable.capture_exception` allows accessing GRPC service method name and message content
-on which an exception was captured. It can be used for exceptions grouping in your tracker and
-providing additional data to investigate a root of a problem.
-
-Example:
-
-```ruby
-AnyCable.capture_exception do |ex, method, message|
-  Honeybadger.notify(ex, component: "any_cable", action: method, params: message)
-end
-```
-
-Usage of a handler proc with just a single argument is preserved for the sake of compatibility.
-
-- Add deprecation warning to default host usage ([@sponomarev][])
-
-Exposing AnyCable publicly is considered to be harmful and planned to be changed
-in future versions.
-
-- Allow running the server as a detachable daemon ([@sponomarev][])
-
-Server is fully managed by the binary itself.
-
-```sh
-# Start anycable daemon
-$ bundle exec anycabled start
-
-# Pass cli options to anycable through daemon. Separate daemon options and anycable options with `--`
-$ bundle exec anycabled start -- --rpc-host 127.0.0.1:31337
-
-# Stop anycable daemon
-$ bundle exec anycabled stop
-
-# See more anycable daemon options
-$ bundle exec anycabled
-```
-
-## 0.6.1 (2019-01-05)
-
-- [Fix #63](https://github.com/anycable/anycable-rails/issues/63) Load `anyway_config` after application boot to make sure that all frameworks dependent functionality is loaded. ([@palkan][])
-
-## 0.6.0 (2018-11-15)
-
-### Features
-
-#### Broadcast adapters
-
-AnyCable allows you to use custom broadcasting adapters (Redis is used by default):
-
-```ruby
-# Specify by name (tries to load `AnyCable::BroadcastAdapters::MyAdapter` from
-# "anycable/broadcast_adapters/my_adapter")
-AnyCable.broadcast_adapter = :my_adapter, {option: "value"}
-# or provide an instance (should respond_to #broadcast)
-AnyCable.broadcast_adapter = MyAdapter.new
-```
-
-**Breaking:** to use Redis adapter you must ensure that it is present in your Gemfile; AnyCable gem doesn't have `redis` as a dependency anymore.
-
-#### CLI
-
-AnyCable now ships with a CLI–`anycable`.
+## 1.0.2
 
-Use it to run a gRPC server:
+- Handle TLS Redis connections by using VERIFY_NONE mode. ([@palkan][])
 
-```sh
-# run anycable and load app from app.rb
-bundle exec anycable -r app.rb
-# or
-bundle exec anycable --require app.rb
-```
+## 1.0.1 (2020-07-07)
 
-All configuration options are also supported as CLI options (see `anycable -h` for more information).
+- Support providing passwords for Redis Sentinels. ([@palkan][])
 
-The only required options is the application file to load (`-r/--require`).
+Use the following format: `ANYCABLE_REDIS_SENTINELS=:password1@my.redis.sentinel.first:26380,:password2@my.redis.sentinel.second:26380`.
 
-You can omit it if you want to load an app form `./config/environment.rb` (e.g. with Rails) or `./config/anycable.rb`.
+## 1.0.0 (2020-07-01)
 
-AnyCable CLI also allows you to run a separate command (process) from within a RPC server:
+- Add `embedded` option to CLI runner. ([@palkan][])
 
-```sh
-bundle exec anycable --server-command "anycable-go -p 3334"
-```
+- Add `Env#istate` and `EnvResponse#istate` to store channel state. ([@palkan][])
 
-#### Configuration
+That would allow to mimic instance variables usage in Action Cable channels.
 
-- Default server host is changed from `localhost:50051` to `0.0.0.0:50051`
-- Expose gRPC server parameters via `rpc_*` config params:
+- Add `CommandResponse#stopped_streams` to support unsubscribing from particular broadcastings. ([@palkan])
 
-```ruby
-AnyCable.configure do |config|
-  config.rpc_pool_size = 120
-  config.rpc_max_waiting_requests = 10
-  # etc
-end
-```
+`Socket#unsubscribe` is now implemented as well.
 
-- `REDIS_URL` env is used by default if present (and no `ANYCABLE_REDIS_URL` specified)
-- Make HTTP health check url configurable
-- Add ability to pass Redis Sentinel config as array of string.
+- Add `AnyCable.broadcast_adapter#broadcast_command` method. ([@palkan][])
 
-Now it's possible to pass Sentinel configuration via env vars:
+It could be used to send commands to WS server (e.g., remote disconnect).
 
-```sh
-ANYCABLE_REDIS_SENTINELS=127.0.0.1:26380,127.0.0.1:26381 bundle exec anycable
-```
+- Add `:http` broadcasting adapter. ([@palkan][])
 
-#### Other
-
-- Added middlewares support
-
-See [docs](https://docs.anycable.io/#/./middlewares).
-
-- Added gRPC health checker.
-
-See [docs](https://docs.anycable.io/#/./health_checking).
-
-- Added hook to run code only within RPC server context.
-
-Use `AnyCable.configure_server { ... }` to run code only when RPC server is running.
-
-### API changes
-
-**NOTE**: the old API is still working but deprecated (you'll see a notice).
-
-- Use `AnyCable` instead of `Anycable`
-
-- New API for registering error handlers:
-
-```ruby
-AnyCable.capture_exception do |ex|
-  Honeybadger.notify(ex)
-end
-```
-
-- `AnyCable::Server.start` is deprecated
-
-## 0.5.2 (2018-09-06)
-
-- [#48](https://github.com/anycable/anycable/pull/48) Add HTTP health server ([@DarthSim][])
-
-## 0.5.1 (2018-06-13)
-
-Minor fixes.
-
-## 0.5.0 (2017-10-21)
-
-- [#2](https://github.com/anycable/anycable/issues/2) Add support for [Redis Sentinel](https://redis.io/topics/sentinel). ([@accessd][])
-
-- [#28](https://github.com/anycable/anycable/issues/28) Support arbitrary headers. ([@palkan][])
-
-Previously we hardcoded only "Cookie" header. Now we add all passed headers by WebSocket server to request env.
-
-- [#27](https://github.com/anycable/anycable/issues/27) Add `error_msg` to RPC responses. ([@palkan][])
-
-Now RPC responses has 3 statuses:
-
-1) `SUCCESS` – successful request, operation succeed
-2) `FAILURE` – successful request, operation failed (e.g. authentication failed)
-3) `ERROR` – request failed (exception raised).
-
-We provide `error_msg` only when request status is `ERROR`.
-
-- [#25](https://github.com/anycable/anycable/issues/25) Improve logging and exceptions handling. ([@palkan][])
-
-Default logger logs to STDOUT with `info` level by default but can be configured to log to file with
-any severity.
-
-GRPC logging is turned off by default (can be turned on through `log_grpc` configuration parameter).
-
-`ANYCABLE_DEBUG=1` acts as a shortcut to set `debug` level and turn on GRPC logging.
-
-Now it's possible to add custom exception handlers (e.g. to notify external exception tracking services).
-
-More on [Wiki](https://github.com/anycable/anycable/wiki/Logging-&-Exceptions-Handling).
-
-## 0.4.6 (2017-05-20)
-
-- Add `Anycable::Server#stop` method. ([@sadovnik][])
-
-## 0.4.5 (2017-03-17)
-
-- Fixed #11. ([@palkan][])
-
-## 0.4.4 (2017-03-06)
-
-- Handle `StandardError` gracefully in RPC calls. ([@palkan][])
-
-## 0.4.3 (2017-02-18)
-
-- Update `grpc` version dependency to support Ruby 2.4. ([@palkan][])
-
-## 0.4.2 (2017-01-28)
-
-- Change socket streaming API. ([@palkan][])
-
-Add `Socket#subscribe`, `unsubscribe` and `unsubscribe_from_all` methods.
-
-## 0.4.1 (2017-01-24)
-
-- Introduce _fake_ socket instance to handle transmissions and streams. ([@palkan][])
+- **RPC schema has changed**. ([@palkan][])
 
-- Make commands handling more abstract. ([@palkan][])
+Using `anycable-go` v1.x is required.
 
-We now do not explicitly call channels action but use the only one entrypoint for all commands:
+- **Ruby 2.5+ is required**. ([@palkan][])
 
-```ruby
-connection.handle_channel_command(identifier, command, data)
-```
+- Added RPC proto version check. ([@palkan][])
 
-This method should return `true` if command was successful and `false` otherwise.
+Server must sent `protov` metadata with the supported versions (comma-separated list). If there is no matching version an exception is raised.
 
-## 0.4.0 (2017-01-22)
+Current RPC proto version is **v1**.
 
-- Refactor RPC API. ([@palkan][])
+- Added `request` support to channels. ([@palkan][])
 
-Replace `Subscribe`, `Unsubscribe` and `Perform` methods with `Command` method.
+Now you can access `request` object in channels, too (e.g., to read headers/cookies/URL/etc).
 
-- Extract Rails functionality to separate gem. ([@palkan][])
+- Change default server address from `[::]:50051` to `127.0.0.1:50051`. ([@palkan][])
 
-All Rails specifics now live here [https://github.com/anycable/anycable-rails](https://github.com/anycable/anycable-rails).
+See [#71](https://github.com/anycable/anycable/pull/71).
 
-## 0.3.0 (2016-12-28)
+- Fix building Redis Sentinel config. ([@palkan][])
 
-- Handle `Disconnect` requests. ([@palkan][])
+---
 
-Implement `Disconnect` handler, which invokes `Connection#disconnect` (along with `Channel#unsubscribed` for each subscription).
+See [Changelog](https://github.com/anycable/anycable/blob/0-6-stable/CHANGELOG.md) for versions <1.0.0.
 
 [@palkan]: https://github.com/palkan
-[@sadovnik]: https://github.com/sadovnik
-[@accessd]: https://github.com/accessd
-[@DarthSim]: https://github.com/DarthSim
 [@sponomarev]: https://github.com/sponomarev
 [@bibendi]: https://github.com/bibendi

data/MIT-LICENSE

@@ -1,4 +1,4 @@
-Copyright 2017-2020 Vladimir Dementyev
+Copyright 2017-2021 Vladimir Dementyev
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -2,31 +2,35 @@
 [![Gem Version](https://badge.fury.io/rb/anycable.svg)](https://rubygems.org/gems/anycable)
 [![Build](https://github.com/anycable/anycable/workflows/Build/badge.svg)](https://github.com/anycable/anycable/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)
+[![Documentation](https://img.shields.io/badge/docs-link-brightgreen.svg)](https://docs.anycable.io/v1)
 
 # AnyCable
 
 <img align="right" height="150" width="129"
      title="AnyCable logo" src="https://docs.anycable.io/assets/images/logo.svg">
 
-AnyCable allows you to use any WebSocket server (written in any language) as a replacement for your Ruby server (such as Faye, ActionCable, etc).
+AnyCable allows you to use any WebSocket server (written in any language) as a replacement for your Ruby server (such as Faye, Action Cable, etc).
 
 AnyCable uses the same protocol as ActionCable, so you can use its [JavaScript client](https://www.npmjs.com/package/actioncable) without any monkey-patching.
 
+**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/tree/0-6-stable) branch.
+
 <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>
 
 ## Requirements
 
 - Ruby >= 2.5
-- Redis (for broadcasting, [discuss other options](https://github.com/anycable/anycable/issues/2) with us!)
+- Redis (for broadcasting **in production**, [discuss other options](https://github.com/anycable/anycable/issues/2) with us!)
 
 ## Usage
 
-Check out our 📑 [Documentation](https://docs.anycable.io).
+Check out our 📑 [Documentation](https://docs.anycable.io/v1).
 
 ## Links
 
+- [AnyCable 1.0: Four years of real-time web with Ruby and Go](https://evilmartians.com/chronicles/anycable-1-0-four-years-of-real-time-web-with-ruby-and-go)
+
 - [AnyCable: Action Cable on steroids!](https://evilmartians.com/chronicles/anycable-actioncable-on-steroids)
 
 - [Connecting LiteCable to Hanami](http://gabrielmalakias.com.br/ruby/hanami/iot/2017/05/26/websockets-connecting-litecable-to-hanami.html) by [@GabrielMalakias](https://github.com/GabrielMalakias)
@@ -45,12 +49,9 @@ Check out our 📑 [Documentation](https://docs.anycable.io).
 
 - RailsClub Moscow 2016 [slides](https://speakerdeck.com/palkan/railsclub-moscow-2016-anycable) and [video](https://www.youtube.com/watch?v=-k7GQKuBevY&list=PLiWUIs1hSNeOXZhotgDX7Y7qBsr24cu7o&index=4) (RU)
 
-## Compatible WebSocket servers
-
-- [AnyCable Go](https://github.com/anycable/anycable-go)
-- [ErlyCable](https://github.com/anycable/erlycable)
+## Building
 
-## Build
+### Generating gRPC files from `.proto`
 
 - Install required GRPC gems:
 

data/lib/anycable.rb

@@ -31,7 +31,7 @@ module AnyCable
     def logger
       return @logger if instance_variable_defined?(:@logger)
 
-      log_output = AnyCable.config.log_file || STDOUT
+      log_output = AnyCable.config.log_file || $stdout
       @logger = Logger.new(log_output).tap do |logger|
         logger.level = AnyCable.config.log_level
       end
@@ -67,7 +67,7 @@ module AnyCable
     end
 
     def broadcast_adapter
-      self.broadcast_adapter = :redis unless instance_variable_defined?(:@broadcast_adapter)
+      self.broadcast_adapter = AnyCable.config.broadcast_adapter.to_sym unless instance_variable_defined?(:@broadcast_adapter)
       @broadcast_adapter
     end
 

data/lib/anycable/broadcast_adapters.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "anycable/broadcast_adapters/base"
+
 module AnyCable
   module BroadcastAdapters # :nodoc:
     module_function

data/lib/anycable/broadcast_adapters/base.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module AnyCable
+  module BroadcastAdapters
+    class Base
+      def raw_broadcast(_data)
+        raise NotImplementedError
+      end
+
+      def broadcast(stream, payload)
+        raw_broadcast({stream: stream, data: payload}.to_json)
+      end
+
+      def broadcast_command(command, **payload)
+        raw_broadcast({command: command, payload: payload}.to_json)
+      end
+
+      def announce!
+        logger.info "Broadcasting via #{self.class.name}"
+      end
+
+      private
+
+      def logger
+        AnyCable.logger
+      end
+    end
+  end
+end

data/lib/anycable/broadcast_adapters/http.rb

@@ -0,0 +1,130 @@
+# frozen_string_literal: true
+
+require "json"
+require "uri"
+require "net/http"
+
+module AnyCable
+  module BroadcastAdapters
+    # HTTP adapter for broadcasting.
+    #
+    # Example:
+    #
+    #   AnyCable.broadast_adapter = :http
+    #
+    # It uses configuration from global AnyCable config
+    # by default.
+    #
+    # You can override these params:
+    #
+    #   AnyCable.broadcast_adapter = :http, url: "http://ws.example.com/_any_cable_"
+    class Http < Base
+      # Taken from: https://github.com/influxdata/influxdb-ruby/blob/886058079c66d4fd019ad74ca11342fddb0b753d/lib/influxdb/errors.rb#L18
+      RECOVERABLE_EXCEPTIONS = [
+        Errno::ECONNABORTED,
+        Errno::ECONNREFUSED,
+        Errno::ECONNRESET,
+        Errno::EHOSTUNREACH,
+        Errno::EINVAL,
+        Errno::ENETUNREACH,
+        Net::HTTPBadResponse,
+        Net::HTTPHeaderSyntaxError,
+        Net::ProtocolError,
+        SocketError,
+        (OpenSSL::SSL::SSLError if defined?(OpenSSL))
+      ].compact.freeze
+
+      OPEN_TIMEOUT = 5
+      READ_TIMEOUT = 10
+
+      MAX_ATTEMPTS = 3
+      DELAY = 2
+
+      attr_reader :url, :headers, :authorized
+      alias_method :authorized?, :authorized
+
+      def initialize(url: AnyCable.config.http_broadcast_url, secret: AnyCable.config.http_broadcast_secret)
+        @url = url
+        @headers = {}
+        if secret
+          headers["Authorization"] = "Bearer #{secret}"
+          @authorized = true
+        end
+
+        @uri = URI.parse(url)
+        @queue = Queue.new
+      end
+
+      def raw_broadcast(payload)
+        ensure_thread_is_alive
+        queue << payload
+      end
+
+      # Wait for background thread to process all the messages
+      # and stop it
+      def shutdown
+        queue << :stop
+        thread.join if thread&.alive?
+      rescue Exception => e # rubocop:disable Lint/RescueException
+        logger.error "Broadcasting thread exited with exception: #{e.message}"
+      end
+
+      def announce!
+        logger.info "Broadcasting HTTP url: #{url}#{authorized? ? " (with authorization)" : ""}"
+      end
+
+      private
+
+      attr_reader :uri, :queue, :thread
+
+      def ensure_thread_is_alive
+        return if thread&.alive?
+
+        @thread = Thread.new do
+          loop do
+            msg = queue.pop
+            break if msg == :stop
+
+            handle_response perform_request(msg)
+          end
+        end
+      end
+
+      def perform_request(payload)
+        build_http do |http|
+          req = Net::HTTP::Post.new(url, {"Content-Type" => "application/json"}.merge(headers))
+          req.body = payload
+          http.request(req)
+        end
+      end
+
+      def handle_response(response)
+        return unless response
+        return if Net::HTTPCreated === response
+
+        logger.error "Broadcast request responded with unexpected status: #{response.code}"
+      end
+
+      def build_http
+        retry_count = 0
+
+        begin
+          http = Net::HTTP.new(uri.host, uri.port)
+          http.open_timeout = OPEN_TIMEOUT
+          http.read_timeout = READ_TIMEOUT
+          http.use_ssl = url.match?(/^https/)
+          http.verify_mode = OpenSSL::SSL::VERIFY_NONE
+          yield http
+        rescue Timeout::Error, *RECOVERABLE_EXCEPTIONS => e
+          retry_count += 1
+          return logger.error("Broadcast request failed: #{e.message}") if MAX_ATTEMPTS < retry_count
+
+          sleep((DELAY**retry_count) * retry_count)
+          retry
+        ensure
+          http.finish if http.started?
+        end
+      end
+    end
+  end
+end

data/lib/anycable/broadcast_adapters/redis.rb

@@ -19,7 +19,7 @@ module AnyCable
     # You can override these params:
     #
     #   AnyCable.broadcast_adapter = :redis, url: "redis://my_redis", channel: "_any_cable_"
-    class Redis
+    class Redis < Base
       attr_reader :redis_conn, :channel
 
       def initialize(
@@ -31,11 +31,12 @@ module AnyCable
         @channel = channel
       end
 
-      def broadcast(stream, payload)
-        redis_conn.publish(
-          channel,
-          {stream: stream, data: payload}.to_json
-        )
+      def raw_broadcast(payload)
+        redis_conn.publish(channel, payload)
+      end
+
+      def announce!
+        logger.info "Broadcasting Redis channel: #{channel}"
       end
     end
   end

data/lib/anycable/cli.rb

@@ -20,17 +20,22 @@ module AnyCable
     # Wait for external process termination (s)
     WAIT_PROCESS = 2
 
-    attr_reader :server, :health_server
+    attr_reader :server, :health_server, :embedded
+    alias_method :embedded?, :embedded
+
+    def initialize(embedded: false)
+      @embedded = embedded
+    end
 
     # rubocop:disable Metrics/AbcSize, Metrics/MethodLength
-    def run(args = {})
+    def run(args = [])
       @at_stop = []
 
       extra_options = parse_cli_options!(args)
 
       # Boot app first, 'cause it might change
       # configuration, loggin settings, etc.
-      boot_app!
+      boot_app! unless embedded?
 
       parse_gem_options!(extra_options)
 
@@ -40,7 +45,7 @@ module AnyCable
 
       print_versions!
 
-      logger.info "Serving #{defined?(::Rails) ? "Rails " : ""}application from #{boot_file}"
+      logger.info "Serving #{defined?(::Rails) ? "Rails " : ""}application from #{boot_file}" unless embedded?
 
       verify_connection_factory!
 
@@ -66,6 +71,8 @@ module AnyCable
 
       run_custom_server_command! unless server_command.nil?
 
+      return if embedded?
+
       begin
         wait_till_terminated
       rescue Interrupt => e
@@ -81,7 +88,7 @@ module AnyCable
 
     def shutdown
       at_stop.each(&:call)
-      server.stop
+      server&.stop
     end
 
     private
@@ -183,7 +190,7 @@ module AnyCable
     end
 
     def start_pubsub!
-      logger.info "Broadcasting Redis channel: #{config.redis_channel}"
+      AnyCable.broadcast_adapter.announce!
     end
 
     # rubocop: disable Metrics/MethodLength, Metrics/AbcSize
@@ -313,9 +320,7 @@ module AnyCable
             -r, --require=path                Location of application file to require, default: "config/environment.rb"
             --server-command=command          Command to run WebSocket server
             --rpc-host=host                   Local address to run gRPC server on, default: "[::]:50051"
-            --redis-url=url                   Redis URL for pub/sub, default: REDIS_URL or "redis://localhost:6379/5"
-            --redis-channel=name              Redis channel for broadcasting, default: "__anycable__"
-            --redis-sentinels=<...hosts>      Redis Sentinel followers addresses (as a comma-separated list), default: nil
+            --broadcast-adapter=type          Pub/sub adapter type for broadcasts, default: redis
             --log-level=level                 Logging level, default: "info"
             --log-file=path                   Path to log file, default: <none> (log to STDOUT)
             --log-grpc                        Enable gRPC logging (disabled by default)
@@ -323,6 +328,15 @@ module AnyCable
             -v, --version                     Print version and exit
             -h, --help                        Show this help
 
+        REDIS PUB/SUB OPTIONS
+            --redis-url=url                   Redis URL for pub/sub, default: REDIS_URL or "redis://localhost:6379/5"
+            --redis-channel=name              Redis channel for broadcasting, default: "__anycable__"
+            --redis-sentinels=<...hosts>      Redis Sentinel followers addresses (as a comma-separated list), default: nil
+
+        HTTP PUB/SUB OPTIONS
+            --http-broadcast-url              HTTP pub/sub endpoint URL, default: "http://localhost:8090/_broadcast"
+            --http-broadcast-secret           HTTP pub/sub authorization secret, default: <none> (disabled)
+
         HTTP HEALTH CHECKER OPTIONS
             --http-health-port=port           Port to run HTTP health server on, default: <none> (disabled)
             --http-health-path=path           Endpoint to server health cheks, default: "/health"

data/lib/anycable/config.rb

@@ -3,6 +3,8 @@
 require "anyway_config"
 require "grpc"
 
+require "uri"
+
 module AnyCable
   # AnyCable configuration.
   class Config < Anyway::Config
@@ -19,11 +21,18 @@ module AnyCable
       # See https://github.com/grpc/grpc/blob/f526602bff029b8db50a8d57134d72da33d8a752/include/grpc/impl/codegen/grpc_types.h#L292-L315
       rpc_server_args: {},
 
+      ## PubSub
+      broadcast_adapter: :redis,
+
       ### Redis options
       redis_url: ENV.fetch("REDIS_URL", "redis://localhost:6379/5"),
       redis_sentinels: nil,
       redis_channel: "__anycable__",
 
+      ### HTTP broadcasting options
+      http_broadcast_url: "http://localhost:8090/_broadcast",
+      http_broadcast_secret: nil,
+
       ### Logging options
       log_file: nil,
       log_level: :info,
@@ -38,7 +47,7 @@ module AnyCable
       version_check_enabled: true
     )
 
-    alias version_check_enabled? version_check_enabled
+    alias_method :version_check_enabled?, :version_check_enabled
 
     ignore_options :rpc_server_args
     flag_options :log_grpc, :debug
@@ -68,7 +77,7 @@ module AnyCable
         @debug != false
       end
 
-      alias debug? debug
+      alias_method :debug?, :debug
     end
 
     def http_health_port_provided?
@@ -89,14 +98,17 @@ module AnyCable
     # Build Redis parameters
     def to_redis_params
       {url: redis_url}.tap do |params|
-        next if redis_sentinels.nil?
+        next if redis_sentinels.nil? || redis_sentinels.empty?
+
+        sentinels = Array(redis_sentinels)
 
-        raise ArgumentError, "redis_sentinels must be an array; got #{redis_sentinels}" unless
-          redis_sentinels.is_a?(Array)
+        next if sentinels.empty?
 
-        next if redis_sentinels.empty?
+        params[:sentinels] = sentinels.map(&method(:parse_sentinel))
+      end.tap do |params|
+        next unless redis_url.match?(/rediss:\/\//)
 
-        params[:sentinels] = redis_sentinels.map(&method(:parse_sentinel))
+        params[:ssl_params] = {verify_mode: OpenSSL::SSL::VERIFY_NONE}
       end
     end
 
@@ -110,16 +122,14 @@ module AnyCable
 
     private
 
-    SENTINEL_RXP = /^([\w\-_]*)\:(\d+)$/.freeze
-
     def parse_sentinel(sentinel)
-      return sentinel if sentinel.is_a?(Hash)
-
-      matches = sentinel.match(SENTINEL_RXP)
+      return sentinel.transform_keys!(&:to_sym) if sentinel.is_a?(Hash)
 
-      raise ArgumentError, "Invalid Sentinel value: #{sentinel}" if matches.nil?
+      uri = URI.parse("redis://#{sentinel}")
 
-      {"host" => matches[1], "port" => matches[2].to_i}
+      {host: uri.host, port: uri.port}.tap do |opts|
+        opts[:password] = uri.password if uri.password
+      end
     end
   end
 end

data/lib/anycable/exceptions_handling.rb

@@ -7,7 +7,7 @@ module AnyCable
         handlers << procify(block)
       end
 
-      alias << add_handler
+      alias_method :<<, :add_handler
 
       def notify(exp, method_name, message)
         handlers.each do |handler|

data/lib/anycable/health_server.rb

@@ -20,7 +20,7 @@ module AnyCable
 
     attr_reader :grpc_server, :port, :path, :server
 
-    def initialize(grpc_server, port:, path: "/health", logger: AnyCable.logger)
+    def initialize(grpc_server, port:, logger: nil, path: "/health")
       @grpc_server = grpc_server
       @port = port
       @path = path
@@ -48,7 +48,9 @@ module AnyCable
 
     private
 
-    attr_reader :logger
+    def logger
+      @logger ||= AnyCable.logger
+    end
 
     def build_server
       require "webrick"

data/lib/anycable/middleware.rb

@@ -5,7 +5,7 @@ require "grpc"
 module AnyCable
   # Middleware is a wrapper over gRPC interceptors
   # for request/response calls
-  class Middleware < GRPC::Interceptor
+  class Middleware < GRPC::ServerInterceptor
     def request_response(request: nil, call: nil, method: nil)
       # Call middlewares only for AnyCable service
       return yield unless method.receiver.is_a?(AnyCable::RPCHandler)
@@ -15,6 +15,11 @@ module AnyCable
       end
     end
 
+    def server_streamer(**kwargs)
+      p kwargs
+      yield
+    end
+
     def call(*)
       raise NotImplementedError
     end

data/lib/anycable/middlewares/check_version.rb

@@ -2,7 +2,7 @@
 
 module AnyCable
   module Middlewares
-    # Checks that RPC client version is compatibly with
+    # Checks that RPC client version is compatible with
     # the current RPC proto version
     class CheckVersion < Middleware
       attr_reader :version

data/lib/anycable/rpc.rb

@@ -35,6 +35,14 @@ module AnyCable
     def cstate=(val)
       env.cstate = val
     end
+
+    def istate
+      env.istate
+    end
+
+    def istate=(val)
+      env.istate = val
+    end
   end
 
   # Status predicates

data/lib/anycable/rpc/rpc_pb.rb

@@ -11,9 +11,11 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :url, :string, 1
       map :headers, :string, :string, 2
       map :cstate, :string, :string, 3
+      map :istate, :string, :string, 4
     end
     add_message "anycable.EnvResponse" do
       map :cstate, :string, :string, 1
+      map :istate, :string, :string, 2
     end
     add_message "anycable.ConnectionRequest" do
       optional :env, :message, 3, "anycable.Env"
@@ -40,6 +42,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :transmissions, :string, 5
       optional :error_msg, :string, 6
       optional :env, :message, 7, "anycable.EnvResponse"
+      repeated :stopped_streams, :string, 8
     end
     add_message "anycable.DisconnectRequest" do
       optional :identifiers, :string, 1

data/lib/anycable/rpc_handler.rb

@@ -86,7 +86,8 @@ module AnyCable
         status: result ? AnyCable::Status::SUCCESS : AnyCable::Status::FAILURE,
         disconnect: socket.closed?,
         stop_streams: socket.stop_streams?,
-        streams: socket.streams,
+        streams: socket.streams[:start],
+        stopped_streams: socket.streams[:stop],
         transmissions: socket.transmissions,
         env: build_env_response(socket)
       )
@@ -115,7 +116,8 @@ module AnyCable
         "REMOTE_ADDR" => request_env.headers.delete("REMOTE_ADDR"),
         "rack.url_scheme" => uri.scheme&.sub(/^ws/, "http"),
         # AnyCable specific fields
-        "anycable.raw_cstate" => request_env.cstate&.to_h
+        "anycable.raw_cstate" => request_env.cstate&.to_h,
+        "anycable.raw_istate" => request_env.istate&.to_h
       }.delete_if { |_k, v| v.nil? })
 
       env.merge!(build_headers(request_env.headers))
@@ -135,7 +137,7 @@ module AnyCable
         "SERVER_PORT" => "80",
         "rack.url_scheme" => "http",
         "rack.input" => StringIO.new("", "r").tap { |io| io.set_encoding(Encoding::ASCII_8BIT) },
-        "rack.version" => Rack::VERSION,
+        "rack.version" => ::Rack::VERSION,
         "rack.errors" => StringIO.new("").tap { |io| io.set_encoding(Encoding::ASCII_8BIT) },
         "rack.multithread" => true,
         "rack.multiprocess" => false,
@@ -158,7 +160,8 @@ module AnyCable
 
     def build_env_response(socket)
       AnyCable::EnvResponse.new(
-        cstate: socket.cstate.changed_fields
+        cstate: socket.cstate.changed_fields,
+        istate: socket.istate.changed_fields
       )
     end
 

data/lib/anycable/rspec/with_grpc_server.rb

@@ -9,6 +9,7 @@ RSpec.shared_context "anycable:rpc:server" do
     )
 
     @server.start
+    sleep 0.1
   end
 
   after(:all) { @server.stop }

data/lib/anycable/server.rb

@@ -23,7 +23,7 @@ module AnyCable
   class Server
     attr_reader :grpc_server, :host
 
-    def initialize(host:, logger: AnyCable.logger, **options)
+    def initialize(host:, logger: nil, **options)
       @logger = logger
       @host = host
       @grpc_server = build_server(options)
@@ -70,7 +70,11 @@ module AnyCable
 
     private
 
-    attr_reader :logger, :start_thread
+    attr_reader :start_thread
+
+    def logger
+      @logger ||= AnyCable.logger
+    end
 
     def build_server(options)
       GRPC::RpcServer.new(**options).tap do |server|

data/lib/anycable/socket.rb

@@ -17,6 +17,8 @@ module AnyCable
         source&.[](key)
       end
 
+      alias_method :[], :read
+
       def write(key, val)
         return if source&.[](key) == val
 
@@ -26,18 +28,21 @@ module AnyCable
         source[key] = val
       end
 
+      alias_method :[]=, :write
+
       def changed_fields
         return unless source && dirty_keys
         source.slice(*dirty_keys)
       end
     end
 
-    attr_reader :transmissions, :env, :cstate
+    attr_reader :transmissions, :env, :cstate, :istate
 
     def initialize(env: nil)
       @transmissions = []
       @env = env
       @cstate = env["anycable.cstate"] = State.new(env["anycable.raw_cstate"])
+      @istate = env["anycable.istate"] = State.new(env["anycable.raw_istate"])
     end
 
     def transmit(websocket_message)
@@ -45,11 +50,11 @@ module AnyCable
     end
 
     def subscribe(_channel, broadcasting)
-      streams << broadcasting
+      streams[:start] << broadcasting
     end
 
-    def unsubscribe(_channel, _broadcasting)
-      raise NotImplementedError
+    def unsubscribe(_channel, broadcasting)
+      streams[:stop] << broadcasting
     end
 
     def unsubscribe_from_all(_channel)
@@ -57,7 +62,7 @@ module AnyCable
     end
 
     def streams
-      @streams ||= []
+      @streams ||= {start: [], stop: []}
     end
 
     def close

data/lib/anycable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module AnyCable
-  VERSION = "1.0.0.preview2"
+  VERSION = "1.0.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: anycable
 version: !ruby/object:Gem::Version
-  version: 1.0.0.preview2
+  version: 1.0.2
 platform: ruby
 authors:
 - palkan
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-04-09 00:00:00.000000000 Z
+date: 2021-01-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: anyway_config
@@ -108,6 +108,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '3.5'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.8'
 description: AnyCable is a polyglot replacement for ActionCable-compatible servers
 email:
 - dementiev.vm@gmail.com
@@ -126,6 +140,8 @@ files:
 - bin/setup
 - lib/anycable.rb
 - lib/anycable/broadcast_adapters.rb
+- lib/anycable/broadcast_adapters/base.rb
+- lib/anycable/broadcast_adapters/http.rb
 - lib/anycable/broadcast_adapters/redis.rb
 - lib/anycable/cli.rb
 - lib/anycable/config.rb
@@ -165,9 +181,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
       version: 2.5.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ">"
+  - - ">="
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
 requirements: []
 rubygems_version: 3.0.6
 signing_key: