thecore_backend_commons 3.2.10 → 3.2.11

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c3ab89916ec1ac0d08617605d32e5ad30b2bc8232df838a29a9b75966f0d653
-  data.tar.gz: 89ea95480895118d1641d964fae91339e3714cb126e3d0ae3343b83e9c18c289
+  metadata.gz: fe73ef2835e94090bd037724805658c43bb87820a68d2fc86eadd35747ef8e94
+  data.tar.gz: 707da7e03c6f3bad7499c95fa8616e0f43ff75feed46ebe0159ec05a0594f06f
 SHA512:
-  metadata.gz: 5e11ad2f433fd264b679cd7f77ad77363f75d0c5f4245027ab4b39e85190f45bb78af8624a5621334833a73615846084c5478375f0d7dae4622319c6225ddf9e
-  data.tar.gz: 7fa46bd7592d9d85db5778db94d2130d7c70771aea9118f089dd05822646e9602515b1d1ede8080280be79cf168939fc594a1daf60cec04ff370c501c38829f0
+  metadata.gz: 047fff2d4b57e67c7320df0e8d38874603084e91cab99d8e5802807bcf903f75c503360fa5e4845692876906db4118f720457f631c9a51cfbaf65099ed0a8a39
+  data.tar.gz: 10d926f3d871d4adb4ce2cc7a721b930d32a608ceb2505fc37e07f1408c0a96fe7f7e1d23c065a55e35d344d3433e2dc4fc1c7cb2778e5550079eeea56031ce4

data/README.md

@@ -55,12 +55,20 @@ ThecoreBackendCommons::SmtpConfig.setting(:from)
 
 ### Testare la configurazione SMTP
 
-Dall'applicazione Rails che include questo gem, eseguire:
+Il gem espone `ThecoreBackendCommons::SmtpTester` e un rake task, disponibili automaticamente in qualsiasi app che include questo gem.
+
+**Da rake task (shell):**
 
 ```bash
-bundle exec rails runner script/test_smtp.rb destinatario@example.com
+rails thecore_backend_commons:smtp:test[destinatario@example.com]
+```
+
+**Da Rails console:**
+
+```ruby
+ThecoreBackendCommons::SmtpTester.call("destinatario@example.com")
 ```
 
-Se non si passa un indirizzo, l'email viene inviata all'indirizzo configurato in `ThecoreSettings mytask.default_email`.
+Se non si passa un indirizzo, in entrambi i casi viene usato `ThecoreSettings mytask.default_email`.
 
-Lo script stampa i parametri SMTP effettivamente usati (inclusi `tls` e `enable_starttls_auto`) prima di tentare la consegna, e restituisce exit code `1` in caso di errore con il messaggio dell'eccezione.
+Lo tester stampa i parametri SMTP effettivamente usati (inclusi `tls` e `enable_starttls_auto`) prima di tentare la consegna. Restituisce `true`/`false` dal console e exit code `1` dal rake task in caso di errore.

data/lib/tasks/thecore_backend_commons_tasks.rake

@@ -1,4 +1,11 @@
-# desc "Explaining what the task does"
-# task :thecore_backend_commons do
-#   # Task goes here
-# end
+namespace :thecore_backend_commons do
+  namespace :smtp do
+    desc "Send a test email using ThecoreSettings SMTP config. " \
+         "Usage: rails thecore_backend_commons:smtp:test[recipient@example.com] " \
+         "(omit argument to use mytask.default_email)"
+    task :test, [:recipient] => :environment do |_t, args|
+      success = ThecoreBackendCommons::SmtpTester.call(args[:recipient])
+      exit 1 unless success
+    end
+  end
+end

data/lib/thecore_backend_commons/smtp_tester.rb

@@ -0,0 +1,79 @@
+# frozen_string_literal: true
+
+module ThecoreBackendCommons
+  # Sends a test email using the SMTP settings from ThecoreSettings.
+  # Usable from the Rails console or via the rake task.
+  #
+  # From rails console:
+  #   ThecoreBackendCommons::SmtpTester.call("you@example.com")
+  #
+  # From the shell:
+  #   rails thecore_backend_commons:smtp:test[you@example.com]
+  class SmtpTester
+    def self.call(recipient = nil)
+      new(recipient).call
+    end
+
+    def initialize(recipient = nil)
+      @recipient = recipient.presence ||
+                   ThecoreSettings::Setting.find_by(ns: :mytask, key: :default_email)&.raw
+    end
+
+    def call
+      validate!
+      print_settings
+      send_mail
+    end
+
+    private
+
+    def validate!
+      raise ArgumentError, "No recipient given and mytask.default_email is not configured." if @recipient.blank?
+      raise ArgumentError, "smtp.address is not configured in ThecoreSettings." if opts[:address].blank?
+    end
+
+    def print_settings
+      puts "SMTP settings:"
+      puts "  address:             #{opts[:address]}"
+      puts "  port:                #{opts[:port]}"
+      puts "  domain:              #{opts[:domain].inspect}"
+      puts "  user_name:           #{opts[:user_name].inspect}"
+      puts "  authentication:      #{opts[:authentication].inspect}"
+      puts "  tls:                 #{opts[:tls]}"
+      puts "  enable_starttls_auto:#{opts[:enable_starttls_auto]}"
+      puts "  from:                #{SmtpConfig.setting(:from).inspect}"
+      puts ""
+      puts "Sending test email to: #{@recipient}"
+    end
+
+    def send_mail
+      from_address = SmtpConfig.setting(:from).presence || "noreply@mytask.local"
+      delivery_opts = opts
+
+      mail = Mail.new do
+        from    from_address
+        to      delivery_opts[:address] # placeholder; overridden below
+        subject "[MyTask] SMTP test — #{Time.current.strftime('%Y-%m-%d %H:%M:%S %Z')}"
+        body    "This is an automated SMTP connectivity test sent from MyTask.\n\n" \
+                "If you received this message, the SMTP configuration is working correctly.\n\n" \
+                "Settings used:\n" \
+                "  address: #{delivery_opts[:address]}\n" \
+                "  port: #{delivery_opts[:port]}\n" \
+                "  tls: #{delivery_opts[:tls]}\n" \
+                "  auth: #{delivery_opts[:authentication].inspect}"
+      end
+      mail.to = @recipient
+      mail.delivery_method(:smtp, delivery_opts)
+      mail.deliver!
+      puts "OK: email delivered successfully."
+      true
+    rescue StandardError => e
+      puts "ERROR: #{e.class}: #{e.message}"
+      false
+    end
+
+    def opts
+      @opts ||= SmtpConfig.delivery_options
+    end
+  end
+end

data/lib/thecore_backend_commons/version.rb

@@ -1,3 +1,3 @@
 module ThecoreBackendCommons
-  VERSION = "3.2.10".freeze
+  VERSION = "3.2.11".freeze
 end

data/lib/thecore_backend_commons.rb

@@ -14,6 +14,7 @@ require "seed_dump"
 require "thecore_backend_commons/version"
 require "thecore_backend_commons/engine"
 require "thecore_backend_commons/smtp_config"
+require "thecore_backend_commons/smtp_tester"
 
 module ThecoreBackendCommons
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: thecore_backend_commons
 version: !ruby/object:Gem::Version
-  version: 3.2.10
+  version: 3.2.11
 platform: ruby
 authors:
 - Gabriele Tassoni
@@ -208,6 +208,7 @@ files:
 - lib/thecore_backend_commons.rb
 - lib/thecore_backend_commons/engine.rb
 - lib/thecore_backend_commons/smtp_config.rb
+- lib/thecore_backend_commons/smtp_tester.rb
 - lib/thecore_backend_commons/version.rb
 homepage: https://github.com/gabrieletassoni/thecore_backend_commons
 licenses: []