letter_thief 0.4.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7bff6011c6899c346bc0de0779fa7b95549d51ee83b78567b77ebecbdc290c4a
-  data.tar.gz: 8804964cea6bf766ec28472dc5fd9f6b41f2f2a32d89b37b7981870b173c7f49
+  metadata.gz: 6de7e8358d331ad26b618b894144be9744bde140e2ff669af34cb508e442087d
+  data.tar.gz: 16db7cdb1815bdf9a0ee5bcfc675a3c8e543193ebdfeb73f194c5cf579a258cb
 SHA512:
-  metadata.gz: bae87c979366a349a3965c636ea86eb9592c22a9a68241902abe4e27572bd285192ba05121d601bac86b2b6d1623632a17b72957ac06d585911ec9cf0a6b63e9
-  data.tar.gz: 7473e046f6c52bb33df9bcb2fed97efdda306150cf5c74096dd0ffbc647fd9c008bfcfc3647a038e530973e1edd324ef410407ad7a2c8688dd306642cb419cb2
+  metadata.gz: 1d86fcae20c7ce2f05b3755e90e6bddcd84cfeb1b130c1f37c46db0458d0ba58328b78469e60bd1e945106a15a505c115bcf8ac2dfa4c2752481302824096b28
+  data.tar.gz: 83ef8fe689e0436f7609543e599a874e5c76e87d6df868d365211993778a053d4fc94244623c72fa34fe1adb54d4a90f3aa6e7a2df7d5b16622889d74880a955

data/README.md

@@ -26,6 +26,7 @@ If you used `letter_opener` in the past you know how nice it is to have
 the sent emails opened automatically in your Browser when working locally.
 LetterThief supports this as well with the very same mechanism, but `launchy` is not a direct dependency.
 If you add Launchy on your Gemfile, emails will be opened right away once sent.
+This can be disabled with `LetterThief.open_sent_emails = false`.
 
 Since emails are persisted on the Database it means you can use this also on Heroku, deplo.io, or other PaaS where you
 don't have a disk. No need for an external service like Mailtrap (amazing service!) anymore.
@@ -57,6 +58,24 @@ authenticate :user, ->(user) { user&.administrator? } do
 end
 ```
 
+### Authentication
+
+Alternatively, you can provide your own authentication mechanism by specifying a different controller as the base class
+for LetterThief's controllers. By default, LetterThief's controllers extend `::ApplicationController`, but you can change
+this easily:
+
+```ruby
+# config/initializers/letter_thief.rb
+Rails.application.configure do
+  LetterThief.base_controller_class = "AdminController"
+end
+```
+
+This is useful if you have a custom controller (like `AdminController`) that already handles authentication via
+`before_action` callbacks.
+
+### Delivery Method
+
 If you want to stop sending emails, you can use it also as delivery method:
 
 ```ruby
@@ -74,12 +93,25 @@ end
 
 and LetterThief will open emails directly in your Browser like Letter Opener.
 
+If `launchy` is in your Gemfile for other reasons and you don't want emails to be opened automatically, you can disable
+it:
+
+```ruby
+# config/initializers/letter_thief.rb
+LetterThief.open_sent_emails = false
+```
+
 ### Separate database
 
-If you'd like to store your emails on a separate database, you can configure it via:
+If you'd like to store your emails on a separate database, you can configure it in an initializer:
 
-`config.letter_thief.connects_to = {database: {writing: :letter_thief}}` and of course you'll need a separate database
-configuration. Here is an example:
+```ruby
+# config/initializers/letter_thief.rb
+LetterThief.connects_to = {database: {writing: :letter_thief}}
+```
+
+The value is passed as is to Rails' `connects_to`, so you can also configure shards or a separate reading database.
+Of course you'll need a separate database configuration. Here is an example:
 
 ```yml
 development:
@@ -92,6 +124,20 @@ development:
     migrations_paths: db/letter_thief_migrate
 ```
 
+Move the migration generated by `rails generate letter_thief:install` to `db/letter_thief_migrate` so that the
+`letter_thief_email_messages` table is created on the separate database. Attachments still use ActiveStorage on your
+primary database.
+
+### Enable/Disable Observer
+
+By default, LetterThief observes all emails sent by your application and logs them to the database. You can disable this behavior by setting:
+
+```ruby
+LetterThief.observer_enabled = false
+```
+
+This is useful when you want to disable email logging in production or only enable it when debugging specific issues. You can configure this per environment in `config/environments/production.rb` or toggle it dynamically in the Rails console.
+
 ## Varia
 
 > [!NOTE]
@@ -123,7 +169,6 @@ TARGET_DB=mysql bin/test #mysql
 
 You can also sping up a dummy app with `bin/rails server` and work there.
 
-
 ## Contributing
 
 Bug reports and pull requests are welcome on GitHub at https://github.com/coorasse/letter_thief.

data/app/controllers/letter_thief/application_controller.rb

@@ -1,4 +1,4 @@
 module LetterThief
-  class ApplicationController < ActionController::Base
+  class ApplicationController < LetterThief.base_controller_class.constantize
   end
 end

data/app/models/letter_thief/application_record.rb

@@ -1,5 +1,7 @@
 module LetterThief
   class ApplicationRecord < ActiveRecord::Base
     self.abstract_class = true
+
+    connects_to(**LetterThief.connects_to) if LetterThief.connects_to
   end
 end

data/app/models/letter_thief/email_message.rb

@@ -2,14 +2,12 @@ module LetterThief
   class EmailMessage < ApplicationRecord
     self.table_name = "letter_thief_email_messages"
 
-    connects_to(**LetterThief.connects_to) if LetterThief.connects_to
-
     if LetterThief.activestorage_available?
       has_many_attached :attachments
       has_one_attached :raw_email
     end
 
-    unless ActiveRecord::Base.connection.adapter_name.downcase.include?("postgresql")
+    unless connection.adapter_name.downcase.include?("postgresql")
       serialize :to, coder: JSON, type: Array
       serialize :from, coder: JSON, type: Array
       serialize :sender, coder: JSON, type: Array

data/app/models/letter_thief/email_search.rb

@@ -16,7 +16,7 @@ module LetterThief
       scope = EmailMessage.order(intercepted_at: :desc)
 
       if query.present?
-        adapter = ActiveRecord::Base.connection.adapter_name.downcase
+        adapter = EmailMessage.connection.adapter_name.downcase
         scope = if adapter.include?("postgresql")
           scope.where(<<~SQL.squish, q: "%#{query}%")
             subject ILIKE :q

data/lib/letter_thief/delivery_method.rb

@@ -6,8 +6,15 @@ module LetterThief
     end
 
     def deliver!(mail)
+      delivered_mail = Observer.delivered_email(mail)
+      open_in_browser(delivered_mail) if LetterThief.open_sent_emails
+    end
+
+    private
+
+    def open_in_browser(delivered_mail)
       require "launchy"
-      ::Launchy.open(LetterThief::Engine.routes.url_helpers.email_message_url(Observer.delivered_email(mail), Rails.configuration.action_mailer.default_url_options))
+      ::Launchy.open(LetterThief::Engine.routes.url_helpers.email_message_url(delivered_mail, Rails.configuration.action_mailer.default_url_options))
     rescue LoadError
       puts "WARNING: LetterThief requires the 'launchy' gem to open the email in a web browser. Add it to your Gemfile."
     end

data/lib/letter_thief/engine.rb

@@ -6,7 +6,7 @@ module LetterThief
     isolate_namespace LetterThief
 
     initializer "letter_thief.add_observer" do
-      unless Rails.application.config.action_mailer.delivery_method == :letter_thief
+      if LetterThief.observer_enabled && Rails.application.config.action_mailer.delivery_method != :letter_thief
         ActiveSupport.on_load(:action_mailer) do
           ActionMailer::Base.register_observer(LetterThief::Observer)
         end

data/lib/letter_thief/version.rb

@@ -1,3 +1,3 @@
 module LetterThief
-  VERSION = "0.4.0"
+  VERSION = "0.5.0"
 end

data/lib/letter_thief.rb

@@ -3,6 +3,9 @@ require "letter_thief/engine"
 
 module LetterThief
   mattr_accessor :connects_to
+  mattr_accessor :base_controller_class, default: "::ApplicationController"
+  mattr_accessor :observer_enabled, default: true
+  mattr_accessor :open_sent_emails, default: true
 
   def self.used_activestorage_space
     ActiveStorage::Blob

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: letter_thief
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
 platform: ruby
 authors:
 - Alessandro Rodi
-autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-01-08 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -60,7 +59,6 @@ metadata:
   homepage_uri: https://github.com/coorasse/letter_thief
   source_code_uri: https://github.com/coorasse/letter_thief
   changelog_uri: https://github.com/coorasse/letter_thief/blob/main/CHANGELOG.md
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -75,8 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Log emails in Rails and visualize them.
 test_files: []