Merge branch 'configuration'

Author: fractaledmind

CHANGELOG.md

@@ -1,5 +1,13 @@
 ## [Unreleased]
 
+## [0.11.2] - 2024-09-06
+
+- Simplify the getters to not use memoization
+
+## [0.11.1] - 2024-09-06
+
+- Ensure the litestream initializer handles `nil`s
+
 ## [0.11.0] - 2024-06-21
 
 - Add a default username for the Litestream engine ([@fractaledmind](https://github.com/fractaledmind/litestream-ruby/commit/91c4de8b85be01f8cfd0cc2bf0027a6c0d9f3aaf))

Gemfile.lock

@@ -1,9 +1,13 @@
 PATH
   remote: .
   specs:
-    litestream (0.11.0)
-      activejob
+    litestream (0.11.2)
+      actionpack (>= 7.0)
+      actionview (>= 7.0)
+      activejob (>= 7.0)
+      activesupport (>= 7.0)
       logfmt (>= 0.0.10)
+      railties (>= 7.0)
       sqlite3
 
 GEM

app/controllers/litestream/application_controller.rb

@@ -3,7 +3,12 @@ class ApplicationController < ActionController::Base
     protect_from_forgery with: :exception
     around_action :force_english_locale!
 
-    http_basic_authenticate_with name: Litestream.username, password: Litestream.password if Litestream.password
+    if Litestream.password
+      http_basic_authenticate_with(
+        name: Litestream.username,
+        password: Litestream.password
+      )
+    end
 
     private
 

bin/console

@@ -2,6 +2,7 @@
 # frozen_string_literal: true
 
 require "bundler/setup"
+require "rails"
 require "litestream"
 
 # You can add fixtures and/or initialization code here to make experimenting

lib/litestream.rb

@@ -3,11 +3,25 @@
 require "sqlite3"
 
 module Litestream
+  VerificationFailure = Class.new(StandardError)
+
   class << self
-    attr_accessor :configuration
+    attr_writer :configuration
+
+    def configuration
+      @configuration ||= Configuration.new
+    end
+
+    def deprecator
+      @deprecator ||= ActiveSupport::Deprecation.new("0.12.0", "Litestream")
+    end
   end
 
   def self.configure
+    deprecator.warn(
+      "Configuring Litestream via Litestream.configure is deprecated. Use Rails.application.configure { config.litestream.* = ... } instead.",
+      caller
+    )
     self.configuration ||= Configuration.new
     yield(configuration)
   end
@@ -19,11 +33,7 @@ def initialize
     end
   end
 
-  VerificationFailure = Class.new(StandardError)
-
-  mattr_writer :username
-  mattr_writer :password
-  mattr_writer :queue
+  mattr_writer :username, :password, :queue, :replica_bucket, :replica_key_id, :replica_access_key
 
   class << self
     def verify!(database_path)
@@ -52,17 +62,27 @@ def verify!(database_path)
     # use method instead of attr_accessor to ensure
     # this works if variable set after Litestream is loaded
     def username
-      @username ||= ENV["LITESTREAM_USERNAME"] || @@username || "litestream"
+      ENV["LITESTREAM_USERNAME"] || @@username || "litestream"
     end
 
-    # use method instead of attr_accessor to ensure
-    # this works if variable set after Litestream is loaded
     def password
-      @password ||= ENV["LITESTREAM_PASSWORD"] || @@password
+      ENV["LITESTREAM_PASSWORD"] || @@password
     end
 
     def queue
-      @queue ||= ENV["LITESTREAM_QUEUE"] || @@queue || "default"
+      ENV["LITESTREAM_QUEUE"] || @@queue || "default"
+    end
+
+    def replica_bucket
+      @@replica_bucket || configuration.replica_bucket
+    end
+
+    def replica_key_id
+      @@replica_key_id || configuration.replica_key_id
+    end
+
+    def replica_access_key
+      @@replica_access_key || configuration.replica_access_key
     end
 
     def replicate_process

lib/litestream/commands.rb

@@ -118,11 +118,9 @@ def execute(command, argv = {}, database = nil, async: false, tabled_output: fal
       end
 
       def prepare(command, argv = {}, database = nil)
-        if Litestream.configuration
-          ENV["LITESTREAM_REPLICA_BUCKET"] ||= Litestream.configuration.replica_bucket
-          ENV["LITESTREAM_ACCESS_KEY_ID"] ||= Litestream.configuration.replica_key_id
-          ENV["LITESTREAM_SECRET_ACCESS_KEY"] ||= Litestream.configuration.replica_access_key
-        end
+        ENV["LITESTREAM_REPLICA_BUCKET"] ||= Litestream.replica_bucket
+        ENV["LITESTREAM_ACCESS_KEY_ID"] ||= Litestream.replica_key_id
+        ENV["LITESTREAM_SECRET_ACCESS_KEY"] ||= Litestream.replica_access_key
 
         args = {
           "--config" => Rails.root.join("config", "litestream.yml").to_s

lib/litestream/engine.rb

@@ -18,5 +18,9 @@ class Engine < ::Rails::Engine
         Litestream.public_send(:"#{name}=", value)
       end
     end
+
+    initializer "deprecator" do |app|
+      app.deprecators[:litestream] = Litestream.deprecator
+    end
   end
 end

lib/litestream/generators/litestream/templates/initializer.rb

@@ -4,7 +4,7 @@
 # This allows you to configure Litestream using Rails encrypted credentials,
 # or some other mechanism where the values are only avaialble at runtime.
 
-Litestream.configure do |config|
+Rails.application.configure do
   # An example of using Rails encrypted credentials to configure Litestream.
   # litestream_credentials = Rails.application.credentials.litestream
 
@@ -19,15 +19,15 @@
   # any SFTP server.
   # In this example, we are using Rails encrypted credentials to store the URL to
   # our storage provider bucket.
-  # config.replica_bucket = litestream_credentials.replica_bucket
+  # config.litestream.replica_bucket = litestream_credentials&.replica_bucket
 
   # Replica-specific authentication key.
   # Litestream needs authentication credentials to access your storage provider bucket.
   # In this example, we are using Rails encrypted credentials to store the access key ID.
-  # config.replica_key_id = litestream_credentials.replica_key_id
+  # config.litestream.replica_key_id = litestream_credentials&.replica_key_id
 
   # Replica-specific secret key.
   # Litestream needs authentication credentials to access your storage provider bucket.
   # In this example, we are using Rails encrypted credentials to store the secret access key.
-  # config.replica_access_key = litestream_credentials.replica_access_key
+  # config.litestream.replica_access_key = litestream_credentials&.replica_access_key
 end

lib/litestream/version.rb

@@ -1,3 +1,3 @@
 module Litestream
-  VERSION = "0.11.0"
+  VERSION = "0.11.2"
 end

lib/tasks/litestream_tasks.rake

@@ -1,14 +1,9 @@
 namespace :litestream do
   desc "Print the ENV variables needed for the Litestream config file"
   task env: :environment do
-    if Litestream.configuration.nil?
-      warn "You have not configured the Litestream gem with any values to generate ENV variables"
-      next
-    end
-
-    puts "LITESTREAM_REPLICA_BUCKET=#{Litestream.configuration.replica_bucket}"
-    puts "LITESTREAM_ACCESS_KEY_ID=#{Litestream.configuration.replica_key_id}"
-    puts "LITESTREAM_SECRET_ACCESS_KEY=#{Litestream.configuration.replica_access_key}"
+    puts "LITESTREAM_REPLICA_BUCKET=#{Litestream.replica_bucket}"
+    puts "LITESTREAM_ACCESS_KEY_ID=#{Litestream.replica_key_id}"
+    puts "LITESTREAM_SECRET_ACCESS_KEY=#{Litestream.replica_access_key}"
 
     true
   end