lazylead 0.1.1 → 0.4.0

data/lib/lazylead/task/echo.rb

@@ -30,6 +30,10 @@ module Lazylead
     # Copyright:: Copyright (c) 2019-2020 Yurii Dubinka
     # License:: MIT
     class Echo
+      def initialize(log = Log.new)
+        @log = log
+      end
+
       def run(_, _, _)
         self.class.to_s
       end

data/lib/lazylead/task/fix_version.rb

@@ -23,24 +23,28 @@
 # OR OTHER DEALINGS IN THE SOFTWARE.
 
 require "date"
-require_relative "../system/jira"
 require_relative "../log"
+require_relative "../opts"
+require_relative "../system/jira"
 
 module Lazylead
   module Task
     # @todo #/DEV Each task should verify input arguments.
     #  The common API should be provided for each task.
     class FixVersion
-      def initialize(log = Log::NOTHING)
+      def initialize(log = Log.new)
         @log = log
       end
 
       def run(sys, postman, opts)
-        allowed = opts["allowed"].split(",").map(&:strip).reject(&:blank?)
+        allowed = opts.slice("allowed", ",")
+        issues = sys.issues(
+          opts["jql"], opts.jira_defaults.merge(expand: "changelog")
+        )
+        return if issues.empty?
         postman.send opts.merge(
-          versions: sys.issues(opts["jql"], expand: "changelog")
-                       .map { |i| Version.new(i, allowed) }
-                       .select(&:changed?)
+          versions: issues.map { |i| Version.new(i, allowed) }
+                          .select(&:changed?)
         )
       end
     end
@@ -70,7 +74,7 @@ module Lazylead
                      .reverse
                      .find do |h|
           h["items"].any? do |i|
-            i["field"] == "Fix Version" && !i["to"].nil?
+            i["field"] == "Fix Version"
           end
         end
       end

data/lib/lazylead/task/missing_comment.rb

@@ -23,6 +23,7 @@
 # OR OTHER DEALINGS IN THE SOFTWARE.
 
 require_relative "../log"
+require_relative "../opts"
 require_relative "../postman"
 
 module Lazylead
@@ -36,16 +37,17 @@ module Lazylead
     #  nobody mentioned in comment the ftp location for recorded session.
     # Such cases needs to be reported.
     class MissingComment
-      def initialize(log = Log::NOTHING)
+      def initialize(log = Log.new)
         @log = log
       end
 
       def run(sys, postman, opts)
-        opts["details"] = "text '#{opts['text']}'" if opts["details"].blank?
+        opts["details"] = "text '#{opts['text']}'" if opts.blank? "details"
+        issues = sys.issues(opts["jql"], opts.jira_defaults)
+        return if issues.empty?
         postman.send opts.merge(
-          comments: sys.issues(opts["jql"])
-                       .map { |i| Comments.new(i, sys) }
-                       .reject { |c| c.body? opts["text"] }
+          comments: issues.map { |i| Comments.new(i, sys) }
+                          .reject { |c| c.body? opts["text"] }
         )
       end
     end

data/lib/lazylead/task/propagate_down.rb

@@ -0,0 +1,126 @@
+# frozen_string_literal: true
+
+# The MIT License
+#
+# Copyright (c) 2019-2020 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.
+
+require_relative "../log"
+require_relative "../opts"
+require_relative "../version"
+require_relative "../system/jira"
+
+module Lazylead
+  module Task
+    #
+    # Propagate particular JIRA fields from parent ticket to sub-tasks.
+    #
+    # The task algorithm:
+    #  - fetch parent issues from remote ticketing system by JQL
+    #  - reject issues without sub-tasks
+    #  - fetch sub-tasks details
+    #  - make a diff for pre-defined fields provided by the user
+    #  - apply diff to sub-tasks
+    #  - make a comment to sub-task with clarification.
+    class PropagateDown
+      def initialize(log = Log.new)
+        @log = log
+      end
+
+      # @todo #/DEV Define a new module Lazylead::Task with basic methods like
+      #  split, groupBy(assignee, reporter, etc), blank?
+      def run(sys, _, opts)
+        fields = opts.slice("propagate", ",")
+        sys.issues(
+          opts["jql"],
+          {
+            expand: "changelog",
+            max_results: opts.fetch("max_results", 50),
+            fields: ["subtasks"] + opts.jira_fields
+          }
+        )
+           .map { |i| Parent.new(i, sys, fields) }
+           .select(&:subtasks?)
+           .each(&:fetch)
+           .each(&:propagate)
+      end
+    end
+
+    # The parent ticket as a source for propagation to children.
+    class Parent
+      def initialize(issue, sys, fields)
+        @issue = issue
+        @sys = sys
+        @fields = fields
+      end
+
+      # Ensure that parent ticket has sub-tasks.
+      def subtasks?
+        !@issue.fields["subtasks"].empty?
+      end
+
+      # Take sub-tasks with their fields from external JIRA system.
+      def fetch
+        @subtasks = @issue.fields["subtasks"]
+                          .map do |sub|
+          @sys.raw { |j| j.Issue.find(sub["id"]) }
+        end
+      end
+
+      # Fill pre-defined fields for sub-tasks from parent ticket
+      #  and post comment to ticket with clarification.
+      def propagate
+        expected = Hash[@fields.collect { |f| [f, @issue.fields[f]] }]
+        @subtasks.each do |subtask|
+          actual = Hash[@fields.collect { |f| [f, subtask.fields[f]] }]
+          diff = diff(expected, actual)
+          next if diff.empty?
+          subtask.save(fields: diff)
+          subtask.comments.build.save!(body: comment(diff))
+        end
+      end
+
+      # Detect difference between fields in parent ticket and sub-task.
+      # The sub-tasks expected be updated by this diff.
+      def diff(expected, actual)
+        diff = {}
+        actual.each_with_object(diff) do |a, d|
+          k = a.first
+          v = a.last
+          d[k] = expected[k] if v.nil? || v.blank?
+          next if v.nil?
+          d[k] = v + "," + expected[k] unless v.to_s.include? expected[k]
+        end
+      end
+
+      # Build a jira comment in markdown(*.md) format with diff table.
+      def comment(diff)
+        markdown = [
+          "The following fields were propagated from #{@issue.key}:",
+          "||Field||Value||"
+        ]
+        diff.each { |k, v| markdown << "|#{k}|#{v}|" }
+        markdown << "Posted by [lazylead v#{Lazylead::VERSION}|" \
+                    "https://bit.ly/2NjdndS]"
+        markdown.join("\r\n")
+      end
+    end
+  end
+end

data/lib/lazylead/task/savepoint.rb

@@ -0,0 +1,58 @@
+# frozen_string_literal: true
+
+# The MIT License
+#
+# Copyright (c) 2019-2020 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.
+
+require_relative "../log"
+require_relative "../home"
+require_relative "../email"
+require_relative "../version"
+require_relative "../postman"
+
+module Lazylead
+  module Task
+    #
+    # Send current configuration to admin user.
+    #
+    class Savepoint
+      def initialize(log = Log.new)
+        @log = log
+      end
+
+      def run(_, postman, opts)
+        opts["max_size"] = "25" unless opts.key? "max_size"
+        path = File.join(
+          Lazylead::Home.new.dir,
+          ARGV[ARGV.find_index("--sqlite") + 1]
+        )
+        return unless File.file?(path) && less_mb(path, opts["max_size"])
+        postman.send opts.merge("attachments" => [path])
+      end
+
+      private
+
+      def less_mb(path, megabytes)
+        (File.size(path).to_f / 2**20).round(2) < megabytes.to_i
+      end
+    end
+  end
+end

data/lib/lazylead/task/touch.rb

@@ -0,0 +1,102 @@
+# frozen_string_literal: true
+
+# The MIT License
+#
+# Copyright (c) 2019-2020 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.
+
+require "nokogiri"
+require "active_support/core_ext/hash/conversions"
+require_relative "../salt"
+require_relative "../opts"
+
+module Lazylead
+  module Task
+    #
+    # Send notification about modification of critical files in svn repo.
+    #
+    class SvnTouch
+      def initialize(log = Log.new)
+        @log = log
+      end
+
+      def run(_, postman, opts)
+        files = opts.slice("files", ",")
+        commits = touch(files, opts)
+        postman.send(opts.merge(entries: commits)) unless commits.empty?
+      end
+
+      # Return all svn commits for a particular date range, which are touching
+      #  somehow the critical files within the svn repo.
+      def touch(files, opts)
+        xpath = files.map { |f| "contains(text(),\"#{f}\")" }.join(" or ")
+        svn_log(opts).xpath("//logentry[paths/path[#{xpath}]]")
+                     .map(&method(:to_entry))
+                     .each do |e|
+          if e.paths.path.respond_to? :delete_if
+            e.paths.path.delete_if { |p| files.none? { |f| p.include? f } }
+          end
+        end
+      end
+
+      # Return all svn commits for particular date range in repo
+      def svn_log(opts)
+        url = opts["svn_url"]
+        usr = decrypt(opts["svn_user"])
+        psw = decrypt(opts["svn_password"])
+        now = if opts.key? "now"
+                DateTime.parse(opts["now"])
+              else
+                DateTime.now
+              end
+        start = (now.to_time - opts["period"].to_i).to_datetime
+        raw = `svn log --no-auth-cache --username #{usr} --password #{psw}
+                --xml -v -r {#{start}}:{#{now}} #{url}`
+        Nokogiri.XML(raw, nil, "UTF-8")
+      end
+
+      # Decrypt text using cryptography salt
+      def decrypt(text, sid = "svn_salt")
+        return Salt.new(sid).decrypt(text) if ENV.key? sid
+        text
+      end
+
+      # Convert single revision(XML text) to entry object.
+      # Entry object is a simple ruby struct object.
+      def to_entry(xml)
+        e = to_struct(Hash.from_xml(xml.to_s.strip)).logentry
+        if e.paths.path.respond_to? :each
+          e.paths.path.each(&:strip!)
+        else
+          e.paths.path.strip!
+        end
+        e
+      end
+
+      # Make a simple ruby struct object from hash hierarchically,
+      #  considering nested hash(es) (if applicable)
+      def to_struct(hsh)
+        OpenStruct.new(
+          hsh.transform_values { |v| v.is_a?(Hash) ? to_struct(v) : v }
+        )
+      end
+    end
+  end
+end

data/lib/lazylead/version.rb

@@ -23,5 +23,5 @@
 # OR OTHER DEALINGS IN THE SOFTWARE.
 
 module Lazylead
-  VERSION = "0.1.1"
+  VERSION = "0.4.0"
 end

data/lib/messages/accuracy.erb

@@ -0,0 +1,118 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <style> /* CSS styles taken from https://github.com/yegor256/tacit */
+  th {
+    font-weight: 600
+  }
+
+  table tr {
+    border-bottom-width: 2.16px
+  }
+
+  table tr th {
+    border-bottom-width: 2.16px
+  }
+
+  table tr td, table tr th {
+    overflow: hidden;
+    padding: 5.4px 3.6px;
+    line-height: 14px;
+  }
+
+  #summary {
+    text-align: left;
+  }
+
+  .auto {
+    min-width: auto;
+    white-space: nowrap;
+  }
+
+  a {
+    color: #275a90;
+    text-decoration: none
+  }
+
+  a:hover {
+    text-decoration: underline
+  }
+
+  * {
+    border: 0;
+    border-collapse: separate;
+    border-spacing: 0;
+    box-sizing: border-box;
+    margin: 0;
+    max-width: 100%;
+    padding: 0;
+    vertical-align: baseline;
+    font-family: system-ui, "Helvetica Neue", Helvetica, Arial, sans-serif;
+    font-size: 13px;
+    font-stretch: normal;
+    font-style: normal;
+    font-weight: 400;
+    line-height: 29.7px
+  }
+
+  html, body {
+    width: 100%
+  }
+
+  html {
+    height: 100%
+  }
+
+  body {
+    background: #fff;
+    color: #1a1919;
+    padding: 36px
+  }
+  </style>
+  <title>Accuracy</title>
+</head>
+<body>
+<p>Hi,</p>
+<p>The triage score and accuracy posted to the following tickets::</p>
+<table summary="table with tickets triage score">
+  <tr>
+    <th id="key">Key</th>
+    <th id="duedate">Due date</th>
+    <th id="priority">Priority</th>
+    <th id="score">Score</th>
+    <th id="accuracy">Accuracy</th>
+    <th id="reporter">Reporter</th>
+    <th id="summary">Summary</th>
+  </tr>
+  <% tickets.sort_by { |s| s.issue.fields["priority"]["id"].to_i }
+            .each do |score| %>
+    <tr>
+      <td>
+        <div class="auto">
+          <a href="<%= score.issue.url %>"><%= score.issue.key %></a>
+        </div>
+      </td>
+      <td>
+        <div class="auto"><%= score.issue.duedate %></div>
+      </td>
+      <td><%= score.issue.priority %></td>
+      <td>
+        <span style="color: <%= score.color %>"><%= score.score %></span>
+      </td>
+      <td>
+        <span style="color: <%= score.color %>"><%= score.accuracy %>%</span>
+      </td>
+      <td>
+        <div class="auto">
+          <%= score.issue.reporter.name %>
+        </div>
+      </td>
+      <td><%= score.issue.summary %></td>
+    </tr>
+  <% end %>
+</table>
+<p>Posted by
+  <a href="https://github.com/dgroup/lazylead">lazylead v<%= version %></a>.
+</p>
+</body>
+</html>