truemail 3.1.2 → 3.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: de638476d58e55bc0aa2befde555d82c52a38dcbe8813018424ef88332bfb784
-  data.tar.gz: 303aa7f0951cd60ebdc8278a1e2d8a5a09ab3af21c5ad26166817926a71c0855
+  metadata.gz: a285b1759ed0334ca5f0b1e26bf3975bad782629236b7ef8c347d49e3540f63b
+  data.tar.gz: 20f84b22c347aaae67bfda81cadb67406bb0d4f215cee6976269cdc15cdbc9a9
 SHA512:
-  metadata.gz: b750c9066195850e05136d79bc67c7e86fb84bdafb7cf3a52ff41f07fa49af3d2006efd858b6a4c90e3b092c4c895e6188ae0f0dbeebb39a16747e4ff35b6367
-  data.tar.gz: d7277714943f8c6c9a9d370170b4adb4c3e75917837e93eba9580aa4213f837aaf6a7d6beddb7b84555de3387bb0f049a8634ff18b0747240d6dd030d47a1300
+  metadata.gz: 9c1e73140bbc0304ddcbb6cd68b84f1f3e75bf14237a87a6bd89054253f022e630877c2b478418ee23c7214702eea0fdf1505ead39d84b1b75f9350c4c19cf1c
+  data.tar.gz: 7d99710ab7c9bdc72c37172f7fae87bc6a350d7a2e1befcd31681e2d3bf14ecf150bdbff01b07249904288bd57ea9bbebc007915b7ba5652659d90b99e466c74

data/lib/truemail/configuration.rb

@@ -7,7 +7,11 @@ module Truemail
     DEFAULT_CONNECTION_ATTEMPTS = 2
     DEFAULT_VALIDATION_TYPE = :smtp
     DEFAULT_SMTP_PORT = 25
-    DEFAULT_LOGGER_OPTIONS = { tracking_event: :error, stdout: false, log_absolute_path: nil }.freeze
+    DEFAULT_LOGGER_OPTIONS = {
+      tracking_event: :error,
+      stdout: false,
+      log_absolute_path: nil
+    }.freeze
     SETTERS = %i[
       email_pattern
       smtp_error_body_pattern
@@ -76,14 +80,8 @@ module Truemail
     end
 
     def logger=(options)
-      tracking_event, stdout, log_absolute_path = logger_options(options)
-      valid_event = Truemail::Log::Event::TRACKING_EVENTS.key?(tracking_event)
-      stdout_only = stdout && log_absolute_path.nil?
-      file_only = log_absolute_path.is_a?(::String)
-      both_types = stdout && file_only
-      argument_info = valid_event ? log_absolute_path : tracking_event
-      raise_unless(argument_info, __method__, valid_event && (stdout_only || file_only || both_types))
-      @logger = Truemail::Logger.new(tracking_event, stdout, log_absolute_path)
+      raise_unless(options, __method__, options.is_a?(::Hash))
+      @logger = Truemail::Logger::Builder.call(Truemail::Configuration::DEFAULT_LOGGER_OPTIONS, **options)
     end
 
     def complete?
@@ -154,9 +152,5 @@ module Truemail
         check_validation_type(validation_type)
       end
     end
-
-    def logger_options(current_options)
-      Truemail::Configuration::DEFAULT_LOGGER_OPTIONS.merge(current_options).values
-    end
   end
 end

data/lib/truemail/logger.rb

@@ -4,12 +4,65 @@ module Truemail
   class Logger
     require 'logger'
 
-    attr_reader :event, :stdout, :file
+    BUILDER_ATTRS = %i[tracking_event stdout log_absolute_path custom_logger].freeze
 
-    def initialize(event, error_stdout, log_absolute_path)
+    Builder = ::Struct.new(*BUILDER_ATTRS, keyword_init: true) do
+      private_class_method :new
+
+      def self.call(default_settings, **logger_attributes)
+        new(default_settings, **logger_attributes).validate_attributes.build_instance
+      end
+
+      def initialize(default_settings, **args)
+        super(**default_settings.merge(**args))
+      end
+
+      def validate_attributes
+        validate_logger_event
+        return validate_logger_instance if custom_logger
+        validate_logger_output
+        self
+      end
+
+      def build_instance
+        Truemail::Logger.new(tracking_event, stdout, log_absolute_path, custom_logger)
+      end
+
+      private
+
+      def raise_unless(argument_context, argument_name, condition)
+        raise Truemail::ArgumentError.new(argument_context, argument_name) unless condition
+      end
+
+      def validate_logger_instance
+        raise_unless(custom_logger, :custom_logger=, custom_logger && custom_logger.respond_to?(:add))
+        self
+      end
+
+      def validate_logger_event
+        raise_unless(tracking_event, :tracking_event=, Truemail::Log::Event::TRACKING_EVENTS.key?(tracking_event))
+      end
+
+      def validate_logger_output
+        stdout_only = stdout && log_absolute_path.nil?
+        file_only = log_absolute_path.is_a?(::String)
+        both_types = stdout && file_only
+        raise_unless(
+          { stdout: stdout, log_absolute_path: log_absolute_path },
+          'stdout=, log_absolute_path=',
+          both_types || stdout_only || file_only
+        )
+      end
+    end
+
+    attr_reader :event, :stdout, :file, :custom_logger, :stdout_logger, :file_logger
+
+    def initialize(event, error_stdout, log_absolute_path, custom_logger)
       @event = event
       @stdout = error_stdout
       @file = log_absolute_path
+      @custom_logger = custom_logger
+      init_builtin_loggers
     end
 
     def push(validator_instance)
@@ -27,10 +80,22 @@ module Truemail
       output_file
     end
 
-    def create_logs(log_level, serialized_object)
+    def init_builtin_loggers
+      return if custom_logger
       %i[stdout file].each do |output_type|
         next unless public_send(output_type)
-        ::Logger.new(output_type.eql?(:stdout) ? $stdout : init_log_file).add(log_level) { serialized_object }
+        instance_variable_set(
+          :"@#{output_type}_logger",
+          ::Logger.new(output_type.eql?(:stdout) ? $stdout : init_log_file)
+        )
+      end
+    end
+
+    def create_logs(log_level, serialized_object)
+      %i[custom_logger stdout_logger file_logger].each do |getter|
+        logger_instance = public_send(getter)
+        next unless logger_instance
+        logger_instance.add(log_level) { serialized_object }
       end
     end
   end

data/lib/truemail/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Truemail
-  VERSION = '3.1.2'
+  VERSION = '3.3.0'
 end

data/truemail.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Vladislav Trotsenko']
   spec.email         = %w[admin@bestweb.com.ua]
 
-  spec.summary       = %(truemail)
+  spec.summary       = %(Configurable framework agnostic plain Ruby email validator. Verify email via Regex, DNS, SMTP and even more)
   spec.description   = %(Configurable framework agnostic plain Ruby email validator. Verify email via Regex, DNS, SMTP and even more.)
 
   spec.homepage      = 'https://github.com/truemail-rb/truemail'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: truemail
 version: !ruby/object:Gem::Version
-  version: 3.1.2
+  version: 3.3.0
 platform: ruby
 authors:
 - Vladislav Trotsenko
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-02-15 00:00:00.000000000 Z
+date: 2024-02-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: simpleidn
@@ -219,5 +219,6 @@ requirements: []
 rubygems_version: 3.2.15
 signing_key: 
 specification_version: 4
-summary: truemail
+summary: Configurable framework agnostic plain Ruby email validator. Verify email
+  via Regex, DNS, SMTP and even more
 test_files: []