solid_cable 1.1.0 → 2.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfd23a7cb7209b15a906bea58757f19cc7eb94b6581e1b067af8a47a7f8038bb
-  data.tar.gz: f3d94b8299931398c09178f136ef09c01ce221deac97c8456f5a93150714dfe6
+  metadata.gz: 7a7ca96eb444763611b76694a5a950ea8f131cd2d5a0141b3897af849daf5492
+  data.tar.gz: a25ebf8ac69c71fab4f270e9602a5f25c12f3d6fbc29be5c5e84e27c91abf507
 SHA512:
-  metadata.gz: 06b9e7127dd9ffb5d57760a5da89bed82c68d0da1cbe54a8460eab5c7663dd49ebc9b7693a3237f7a481884b450f59c6a3d0cad82216153cd36bd9abbd3d7ed0
-  data.tar.gz: b57dc804ae3e1e347ee99a649e48ead6e9d48aa4fb8bf5dbd4553e15d2b82af5d4440a6f73ae37f3e576be970a192524e5ca37bcd73c7ffd492cfd6fffdc143c
+  metadata.gz: 7ba93aa71e565208f9201740583bb9cf77854ff9880dbad396b54e67d95f4cc8650765c910a4bb9c9e743c53abf1f7a20cdf77e596edf49cfc55da4d684e5ad2
+  data.tar.gz: a1b7c4824a957d14984cbf5c39936b6769241d5ae026da6abd2c17a94fc42326bedeedb32038682bf0e5491385e33364414b1dcc30c40d891abd8846f4e818b7

data/README.md

@@ -1,34 +1,18 @@
-# SolidCable
+# Solid Cable
 
-Solid Cable is a DB-based backend for Action Cable.
+Solid Cable is a database-backed Action Cable adapter that keeps messages in a table and continously polls for updates. This makes it possible to drop the common dependency on Redis, if it isn't needed for any other purpose. Despite polling, the performance of Solid Cable is comparable to Redis in most situations. And in all circumstances, it makes it easier to deploy Rails when Redis is no longer a required dependency for Action Cable functionality.
 
 
 ## Installation
-Add this line to your application's Gemfile:
 
-```ruby
-gem "solid_cable"
-```
-
-And then execute:
-```bash
-$ bundle
-```
-
-Or install it yourself as:
-```bash
-$ gem install solid_cable
-```
-
-Now, you need to run the installer:
+Solid Cable is configured by default in new Rails 8 applications. But if you're running an earlier version, you can add it manually following these steps:
 
-```bash
-$ bin/rails solid_cable:install
-```
+1. `bundle add solid_cable`
+2. `bin/rails solid_cable:install`
 
-This will create the `db/cable_schema.rb` file.
+This will configure Solid Cable as the production cable adapter by overwritting `config/cable.yml` and create `db/cable_schema.rb`.
 
-You will then have to add the configuration for the database in `config/database.yml`. If you're using SQLite, it'll look something like this:
+You will then have to add the configuration for the cable database in `config/database.yml`. If you're using SQLite, it'll look like this:
 
 ```yaml
 production:
@@ -61,16 +45,9 @@ production:
 
 Then run `db:prepare` in production to ensure the database is created and the schema is loaded.
 
-## Usage
-
-By default messages are kept around forever. SolidCable ships with a job to
-prune messages. You can run `SolidCable::PruneJob.perform_later` which removes
-Messages that are older than what is specified in `keep_messages_around_for`
-setting.
-
 ## Configuration
 
-All configuration is managed via the `config/cable.yml`file. To use Solid Cable, the `adapter` value *must be* `solid_cable`. When using Solid Cable, the other values you can set are: `connects_to`, `polling_interval`, `silence_polling`, and `keep_messages_around_for`. For example:
+All configuration is managed via the `config/cable.yml` file. By default, it'll be configured like this:
 
 ```yaml
 production:
@@ -79,8 +56,25 @@ production:
     database:
       writing: cable
   polling_interval: 0.1.seconds
-  keep_messages_around_for: 1.day
+  message_retention: 1.day
 ```
 
+The options are:
+
+- `connects_to` - set the Active Record database configuration for the Solid Cable models. All options available in Active Record can be used here.
+- `polling_interval` - sets the frequency of the polling interval. (Defaults to
+  0.1.seconds)
+- `message_retention` - sets the retention time for messages kept in the database. Used as the cut-off when trimming is performed. (Defaults to 1.day)
+- `autotrim` - sets wether you want Solid Cable to handle autotrimming messages. (Defaults to true)
+- `silence_polling` - whether to silence Active Record logs emitted when polling (Defaults to true)
+
+## Trimming
+
+Messages are autotrimmed based upon the `message_retention` setting to determine how long messages are to be kept around. If no `message_retention` is given or parsing fails, it defaults to `1.day`. Messages are trimmed when a subscriber unsubscribes.
+
+Autotrimming can negatively impact performance depending on your workload because it is doing a delete on ubsubscribe. If
+you would prefer, you can disable autotrimming by setting `autotrim: false` and you can manually enqueue the job later, `SolidCable::TrimJob.perform_later`, or run it on a recurring interval out of band.
+
 ## License
+
 The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

data/app/jobs/solid_cable/{prune_job.rb → trim_job.rb}

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 module SolidCable
-  class PruneJob < ActiveJob::Base
+  class TrimJob < ActiveJob::Base
     def perform
-      ::SolidCable::Message.prunable.delete_all
+      ::SolidCable::Message.trimmable.delete_all
     end
   end
 end

data/app/models/solid_cable/message.rb

@@ -2,8 +2,8 @@
 
 module SolidCable
   class Message < SolidCable::Record
-    scope :prunable, lambda {
-      where(created_at: ..::SolidCable.keep_messages_around_for.ago)
+    scope :trimmable, lambda {
+      where(created_at: ..::SolidCable.message_retention.ago)
     }
     scope :broadcastable, lambda { |channels, last_id|
       where(channel: channels).where(id: (last_id + 1)..).order(:id)

data/lib/action_cable/subscription_adapter/solid_cable.rb

@@ -1,8 +1,10 @@
 # frozen_string_literal: true
 
+require "action_cable/subscription_adapter/base"
+
 module ActionCable
   module SubscriptionAdapter
-    class SolidCable < Base
+    class SolidCable < ::ActionCable::SubscriptionAdapter::Base
       prepend ChannelPrefix
 
       def initialize(*)
@@ -64,6 +66,8 @@ module ActionCable
 
         def remove_channel(channel)
           channels.delete(channel)
+
+          ::SolidCable::TrimJob.perform_now if ::SolidCable.autotrim?
         end
 
         def invoke_callback(*)

data/lib/generators/solid_cable/install/templates/config/cable.yml

@@ -10,4 +10,4 @@ production:
     database:
       writing: cable
   polling_interval: 0.1.seconds
-  keep_messages_around_for: 1.day
+  message_retention: 1.day

data/lib/solid_cable/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SolidCable
-  VERSION = "1.1.0"
+  VERSION = "2.0.0"
 end

data/lib/solid_cable.rb

@@ -18,8 +18,12 @@ module SolidCable
       parse_duration(cable_config.polling_interval, default: 0.1.seconds)
     end
 
-    def keep_messages_around_for
-      parse_duration(cable_config.keep_messages_around_for, default: 1.day)
+    def message_retention
+      parse_duration(cable_config.message_retention, default: 1.day)
+    end
+
+    def autotrim?
+      cable_config.autotrim != false
     end
 
     private

data/lib/tasks/solid_cable_tasks.rake

@@ -1,6 +1,6 @@
 # frozen_string_literal: true
 
-desc "Copy over the schema and set cache for Solid Cable"
+desc "Copy over the schema and set cable adapter for Solid Cable"
 namespace :solid_cable do
   task :install do
     Rails::Command.invoke :generate, ["solid_cable:install"]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: solid_cable
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 2.0.0
 platform: ruby
 authors:
 - Nick Pezza
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-11 00:00:00.000000000 Z
+date: 2024-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -34,7 +34,7 @@ files:
 - MIT-LICENSE
 - README.md
 - Rakefile
-- app/jobs/solid_cable/prune_job.rb
+- app/jobs/solid_cable/trim_job.rb
 - app/models/solid_cable/message.rb
 - app/models/solid_cable/record.rb
 - lib/action_cable/subscription_adapter/solid_cable.rb