lazylead 0.6.1 → 0.8.0

data/lib/lazylead/cli/app.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),
@@ -57,8 +57,8 @@ module Lazylead
       private
 
       def apply_vcs_migration(opts)
-        @db = File.expand_path(opts[:home]) + "/" + opts[:sqlite]
-        vcs = File.expand_path(opts[:home]) + "/" + opts[:vcs4sql]
+        @db = "#{File.expand_path(opts[:home])}/#{opts[:sqlite]}"
+        vcs = "#{File.expand_path(opts[:home])}/#{opts[:vcs4sql]}"
         @log.debug "Database: '#{@db.colorize(:light_blue)}', "\
                    "sql migration dir: '#{vcs.colorize(:light_blue)}'"
         Vcs4sql::Sqlite::Migration.new(@db).upgrade vcs, opts[:testdata]

data/lib/lazylead/confluence.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),
@@ -104,16 +104,23 @@ module Lazylead
     end
 
     # Detect links mentioned in ticket comments
+    # @todo #/DEV Refactor this method in order to make it more human-readable and remove the
+    #  suppresion below
+    #
+    # rubocop:disable Metrics/CyclomaticComplexity
+    # rubocop:disable Metrics/PerceivedComplexity
     def mentioned_links(ticket)
       ticket.comments
             .map { |cmnt| cmnt.attrs["body"] }
             .select { |cmnt| @confl.any? { |c| cmnt.include? c.url } }
-            .flat_map { |cmnt| cmnt.split " " }
+            .flat_map(&:split)
             .select { |cmnt| @confl.any? { |c| cmnt.start_with? c.url } }
-            .map(&method(:to_page_id))
+            .map { |url| to_page_id(url) }
             .reject(&:blank?)
             .uniq
     end
+    # rubocop:enable Metrics/CyclomaticComplexity
+    # rubocop:enable Metrics/PerceivedComplexity
 
     # Convert confluence page url to the following format:
     #  http://confluence.com/pages/viewpage.action?pageId=xxxxx

data/lib/lazylead/email.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),
@@ -25,26 +25,6 @@
 require "tilt"
 
 module Lazylead
-  # Email notifications utilities.
-  module Emailing
-    # Construct html document from template and binds.
-    def make_body(opts)
-      Email.new(
-        opts["template"],
-        opts.merge(version: Lazylead::VERSION)
-      ).render
-    end
-
-    # Split text with email addresses by ',' and trim all elements if needed.
-    def split(type, opts)
-      if opts[type].include? ","
-        opts[type].split(",").map(&:strip).reject(&:empty?)
-      else
-        [opts[type]]
-      end
-    end
-  end
-
   # An email regarding tickets based on file with markup.
   #
   # The 'tilt' gem was used as a template engine.

data/lib/lazylead/exchange.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),
@@ -39,8 +39,6 @@ module Lazylead
   # Copyright:: Copyright (c) 2019-2020 Yurii Dubinka
   # License:: MIT
   class Exchange
-    include Emailing
-
     def initialize(
       log = Log.new, salt = Salt.new("exchange_salt"), opts = ENV.to_h
     )
@@ -52,38 +50,28 @@ module Lazylead
     # Send an email.
     # :opts   :: the mail configuration like from, cc, subject, template.
     def send(opts)
-      to = opts["to"] || opts[:to]
-      to = [to] unless to.is_a? Array
-      if to.reject { |e| e.nil? || e.blank? }.empty?
-        @log.warn "Email can't be sent to '#{to}, more: '#{opts}'"
-        return
+      if opts.msg_to.empty?
+        @log.warn "ll-012: Email can't be sent to '#{opts.msg_to}," \
+                  " more: '#{opts}'"
+      else
+        msg = make_msg opts
+        cli.send_message msg
+        msg[:file_attachments].each(&:close) unless opts.msg_attachments.empty?
+        @log.debug "#{__FILE__} sent '#{opts['subject']}' to '#{opts.msg_to}'."
       end
-      msg = make_msg(to, opts)
-      msg.update(cc_recipients: opts["cc"]) if opts.key? "cc"
-      add_attachments(msg, opts)
-      cli.send_message msg
-      close_attachments msg
-      @log.debug "#{__FILE__} sent '#{opts['subject']}' to '#{to}'."
     end
 
-    def make_msg(to, opts)
-      {
+    def make_msg(opts)
+      msg = {
         subject: opts["subject"],
-        body: make_body(opts),
+        body: opts.msg_body,
         body_type: "HTML",
-        to_recipients: to
+        to_recipients: opts.msg_to
       }
-    end
-
-    def add_attachments(msg, opts)
-      return unless opts.key? "attachments"
-      files = split("attachments", opts).map { |f| File.open(f, "r") }
-      msg[:file_attachments] = files
-    end
-
-    def close_attachments(msg)
-      return if msg[:file_attachments].nil? || msg[:file_attachments].empty?
-      msg[:file_attachments].each(&:close)
+      files = opts.msg_attachments.map { |f| File.open(f, "r") }
+      msg[:file_attachments] = files unless files.empty?
+      msg[:cc_recipients] = opts["cc"] if opts.key? "cc"
+      msg
     end
 
     private

data/lib/lazylead/home.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),

data/lib/lazylead/log.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),

data/lib/lazylead/model.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),
@@ -68,9 +68,7 @@ module Lazylead
       opts.each_with_object({}) do |e, o|
         k = e[0]
         v = e[1]
-        if v.respond_to? :start_with?
-          v = ENV[v.slice(2, v.length - 3)] if v.start_with? "${"
-        end
+        v = ENV[v.slice(2, v.length - 3)] if v.respond_to?(:start_with?) && v.start_with?("${")
         o[k] = v
       end
     end
@@ -106,6 +104,7 @@ module Lazylead
         sys = system.connect
         opts = props
         opts = detect_cc(sys) if opts.key? "cc"
+        opts["system"] = second_sys if opts.numeric? "system"
         action.constantize.new.run(sys, postman, opts)
       end
 
@@ -137,12 +136,12 @@ module Lazylead
 
       def props
         @props ||= begin
-                     if team.nil?
-                       Opts.new(env(to_hash))
-                     else
-                       Opts.new(env(team.to_hash.merge(to_hash)))
-                     end
-                   end
+          if team.nil?
+            Opts.new(env(to_hash))
+          else
+            Opts.new(env(team.to_hash.merge(to_hash)))
+          end
+        end
       end
 
       def postman
@@ -153,17 +152,21 @@ module Lazylead
         end
       end
 
+      def second_sys
+        sys = System.find(props["system"])
+        raise "ll-014: No ticketing system found for #{self}" if sys.nil?
+        sys.connect
+      end
+
       private
 
       # Parse scheduling #type and #unit
       def trigger
         @trigger ||= begin
-                       trg = schedule.split(":")
-                       unless trg.size == 2
-                         raise "ll-007: illegal schedule format '#{schedule}'"
-                       end
-                       trg.map(&:strip).map(&:chomp)
-                     end
+          trg = schedule.split(":")
+          raise "ll-007: illegal schedule format '#{schedule}'" unless trg.size == 2
+          trg.map(&:strip).map(&:chomp)
+        end
       end
     end
 
@@ -179,6 +182,10 @@ module Lazylead
         @log = log
       end
 
+      # @todo #/DEV Remove the suppression during next refactoring (or enhancements)
+      #  for the method below
+      #
+      # rubocop:disable Metrics/AbcSize
       def exec
         Logging.mdc["tid"] = "task #{id}"
         @log.debug "'#{name}' is started."
@@ -189,12 +196,13 @@ module Lazylead
       rescue StandardError => e
         msg = <<~MSG
           ll-006: Task ##{id} #{e} (#{e.class}) at #{self}
-          #{Backtrace.new(e) if ARGV.include? '--trace'}"
+          #{Backtrace.new(e) if ARGV.include? '--trace'}
         MSG
         @log.error msg
       ensure
         Logging.mdc["tid"] = ""
       end
+      # rubocop:enable Metrics/AbcSize
     end
 
     # Ticketing systems to monitor.

data/lib/lazylead/opts.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),
@@ -34,7 +34,7 @@ module Lazylead
   # License:: MIT
   class Opts
     extend Forwardable
-    def_delegators :@origin, :[], :[]=, :to_s, :key?, :fetch, :merge, :except
+    def_delegators :@origin, :[], :[]=, :to_s, :key?, :fetch, :except, :each, :each_pair, :sort_by
 
     def initialize(origin = {})
       @origin = origin
@@ -43,7 +43,13 @@ module Lazylead
     # Split text value by delimiter, trim all spaces and reject blank items
     def slice(key, delim)
       return [] unless to_h.key? key
-      to_h[key].split(delim).map(&:chomp).map(&:strip).reject(&:blank?)
+      trim to_h[key].split(delim)
+    end
+
+    # Trim all spaces and reject blank items in array
+    def trim(arr)
+      return [] if arr.nil?
+      arr.map(&:chomp).map(&:strip).reject(&:blank?)
     end
 
     def blank?(key)
@@ -77,5 +83,64 @@ module Lazylead
       return Salt.new(sid).decrypt(text) if ENV.key? sid
       text
     end
+
+    def merge(args)
+      return self unless args.is_a? Hash
+      Opts.new @origin.merge(args)
+    end
+
+    # Construct html document from template and binds.
+    def msg_body(template = "template")
+      Email.new(
+        to_h[template],
+        to_h.merge(version: Lazylead::VERSION)
+      ).render
+    end
+
+    def msg_to(delim = ",")
+      sliced delim, :to, "to"
+    end
+
+    def msg_cc(delim = ",")
+      sliced delim, :cc, "cc"
+    end
+
+    def msg_from(delim = ",")
+      sliced delim, :from, "from"
+    end
+
+    def msg_attachments(delim = ",")
+      sliced(delim, :attachments, "attachments").select { |f| File.file? f }
+    end
+
+    #
+    # Find the option by key and split by delimiter
+    #   Opts.new("key" => "a,b").sliced(",", "key")     => [a, b]
+    #   Opts.new(key: "a,b").sliced(",", :key)          => [a, b]
+    #   Opts.new(key: "a,b").sliced(",", "key", :key)   => [a, b]
+    #   Opts.new(key: "").sliced ",", :key)             => []
+    #
+    def sliced(delim, *keys)
+      return [] if keys.empty?
+      key = keys.detect { |k| key? k }
+      val = to_h[key]
+      return [] if val.nil? || val.blank?
+      return val if val.is_a? Array
+      return [val] unless val.include? delim
+      slice key, delim
+    end
+
+    # Ensure that particular key from options is a positive numer
+    #   Opts.new("key" => "1").numeric? "key"   => true
+    #   Opts.new("key" => "0").numeric? "key"   => false
+    #   Opts.new("key" => ".").numeric? "key"   => false
+    #   Opts.new("key" => "nil").numeric? "key" => false
+    def numeric?(key)
+      to_h[key].to_i.positive?
+    end
+
+    def construct(field, delim: ",")
+      slice(field, delim).map(&:constantize).map(&:new)
+    end
   end
 end

data/lib/lazylead/postman.rb

@@ -2,7 +2,7 @@
 
 # The MIT License
 #
-# Copyright (c) 2019-2020 Yurii Dubinka
+# Copyright (c) 2019-2021 Yurii Dubinka
 #
 # Permission is hereby granted, free of charge, to any person obtaining a copy
 # of this software and associated documentation files (the "Software"),
@@ -44,8 +44,6 @@ module Lazylead
   # Copyright:: Copyright (c) 2019-2020 Yurii Dubinka
   # License:: MIT
   class Postman
-    include Emailing
-
     def initialize(log = Log.new)
       @log = log
     end
@@ -53,32 +51,29 @@ module Lazylead
     # Send an email.
     # :opts   :: the mail configuration like to, from, cc, subject, template.
     def send(opts)
-      mail = make_email(opts)
-      mail.deliver
-      @log.debug "#{__FILE__} sent '#{mail.subject}' to '#{mail.to}'."
+      if opts.msg_to.empty?
+        @log.warn "ll-013: Email can't be sent to '#{opts.msg_to}," \
+                  " more: '#{opts}'"
+      else
+        mail = make_email(opts)
+        mail.deliver
+        @log.debug "#{__FILE__} sent '#{mail.subject}' to '#{mail.to}'."
+      end
     end
 
     # Construct an email based on input arguments
     def make_email(opts)
       mail = Mail.new
-      mail.to opts[:to] || opts["to"]
-      mail.from opts["from"]
-      mail.cc opts["cc"] if opts.key? "cc"
+      mail.to opts.msg_to
+      mail.from opts.msg_from
+      mail.cc opts.msg_cc if opts.key? "cc"
       mail.subject opts["subject"]
-      html = make_body(opts)
       mail.html_part do
         content_type "text/html; charset=UTF-8"
-        body html
+        body opts.msg_body
       end
-      add_attachments mail, opts
+      opts.msg_attachments.each { |f| mail.add_file f }
       mail
     end
-
-    def add_attachments(mail, opts)
-      return unless opts.key?("attachments") || opts.key?(:attachments)
-      attach = opts["attachments"] || opts[:attachments]
-      return if attach.nil?
-      attach.select { |a| File.file? a }.each { |a| mail.add_file a }
-    end
   end
 end

data/lib/lazylead/requires.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+# The MIT License
+#
+# Copyright (c) 2019-2021 Yurii Dubinka
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"),
+# to deal in the Software without restriction, including without limitation
+# the rights to use, copy, modify, merge, publish, distribute, sublicense,
+# and/or sell copies of the Software, and to permit persons to whom
+# the Software is  furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
+# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
+# OR OTHER DEALINGS IN THE SOFTWARE.
+
+module Lazylead
+  #
+  # Allows to load all ruby files within particular dir.
+  #
+  class Requires
+    def initialize(dir)
+      @dir = dir
+    end
+
+    def load
+      Dir[File.join(@dir, "*.rb")].sort.each { |f| require f }
+    end
+  end
+end