firespring_dev_commands 2.1.6.pre.alpha.1 → 2.1.7.pre.alpha.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 451ceb21b24126c1eb8ebd4635902c06daabd16ca85612f9ee0145ccefa49abf
-  data.tar.gz: bf53af68e42f2cc71404eca2f2f94171b3769526d113acce4178359e64ccd61e
+  metadata.gz: b5efd3f846669710ea2f7f839df890d6489555a18bfe62ef77d644bf884c121e
+  data.tar.gz: 490a60e2c04726bbbb7d0950160395c3c3fb8c70313be14794fc6181296e7e0b
 SHA512:
-  metadata.gz: c6935ea8724be8a8951c87df3f95bce474b89c8c1b196983f8b7f065245c393dd3a09328a36b8daabc7bcd28f8c670d245e539087fa1df4b3b739c965f60b4c7
-  data.tar.gz: da345d11a73d39e46beedffbf7522f9770b15310a7cf9be4911d2576ab78d951d915912a20e377b5467f66bbae83ddf5c7a34cdd1556cce443aca9264e39a8c7
+  metadata.gz: 11e1f6e01faea39bc49278011efcce6c4f9b30a6dd283efea6e96f13938596e21ed840f961646e3b4d487db50eb4e3a0604a00e14e304eb351f09e2165e7b5b1
+  data.tar.gz: 48d04949c727bade11d7f405701d705fd25eb9a67cd25516a83c799159f32738bd4133028f3271fcf2cddb17a728c422bbed8781bc21f58bfc7d5689543ba555

data/lib/firespring_dev_commands/git.rb

@@ -378,7 +378,7 @@ module Dev
     # Clones the repo_name into the dir
     # Optionally specify a repo_org
     # Optionally specify a branch to check out (defaults to the repository default branch)
-    def clone_repo(dir:, repo_name:, repo_org: 'firespring', branch: nil, depth: nil)
+    def clone_repo(dir:, repo_name:, repo_org: 'firespring', branch: nil)
       if Dir.exist?("#{dir}/.git")
         puts "#{dir} already cloned".light_green
         return
@@ -390,7 +390,6 @@ module Dev
 
       opts = {}
       opts[:branch] = branch unless branch.to_s.strip.empty?
-      opts[:depth] = depth unless depth.to_s.strip.empty?
       g = ::Git.clone(ssh_repo_url(repo_name, repo_org), dir, opts)
       g.fetch('origin', prune: true)
     end

data/lib/firespring_dev_commands/jira/histories.rb

@@ -0,0 +1,11 @@
+module Dev
+  class Jira
+    class Histories
+      def self.populate(data)
+        return nil unless data.attrs.key?('changelog')
+
+        data.changelog['histories'].map { |it| Jira::History.new(it) }
+      end
+    end
+  end
+end

data/lib/firespring_dev_commands/jira/history.rb

@@ -0,0 +1,17 @@
+require 'date'
+
+module Dev
+  class Jira
+    class History
+      attr_accessor :date, :id, :author, :created, :items
+
+      def initialize(data)
+        @data = data
+        @id = data['id']
+        @author = data['author']
+        @items = data['items']
+        @created = Time.parse(data['created'])
+      end
+    end
+  end
+end

data/lib/firespring_dev_commands/jira/issue.rb

@@ -3,9 +3,9 @@ module Dev
     # Contains information and methods representing a Jira issue
     class Issue
       # Issue subtypes which do not map to a story type
-      NON_STORY_TYPES = ['review', 'sub-task', 'code review sub-task', 'pre-deploy sub-task', 'deploy sub-task', 'devops sub-task'].freeze
+      NON_STORY_TYPES = ['epic', 'review', 'sub-task', 'code review sub-task', 'pre-deploy sub-task', 'deploy sub-task', 'devops sub-task'].freeze
 
-      attr_accessor :data, :project, :id, :title, :points, :assignee, :resolved_date
+      attr_accessor :data, :project, :id, :title, :points, :assignee, :resolved_date, :histories, :last_in_progress_history, :first_in_review_history, :last_closed_history
 
       def initialize(data)
         @data = data
@@ -15,10 +15,71 @@ module Dev
         @points = calculate_points(data)
         @assignee = Jira::User.lookup(data.assignee&.accountId)
         @resolved_date = data.resolutiondate
+        @histories = Jira::Histories.populate(data)
+        @last_in_progress_history = nil
+        @first_in_review_history = nil
+        @last_closed_history = nil
+      end
+
+      def cycle_time
+        # Calculate the difference and convert to days
+        ((last_closed_history.created - last_in_progress_history.created) / 60 / 60 / 24).round(2)
+      end
+
+      def in_progress_cycle_time
+        # Calculate the difference and convert to days
+        ((first_in_review_history.created - last_in_progress_history.created) / 60 / 60 / 24).round(2)
+      end
+
+      def in_review_cycle_time
+        # Calculate the difference and convert to days
+        ((last_closed_history.created - first_in_review_history.created) / 60 / 60 / 24).round(2)
+      end
+
+      private def last_in_progress_history
+        raise 'you must expand the changelog field to calculate cycle time' if histories.nil?
+
+        # Find the first instance in the histoy where the status moved to "In Progress"
+        @last_in_progress_history ||= histories.select do |history|
+          history.items.find do |item|
+            item['fieldId'] == 'status' && item['fromString'] == 'Open' && item['toString'] == 'In Progress'
+          end
+        end.max_by(&:created)
+        raise 'unable to find "In Progress" history entry needed to calculate cycle time' unless @last_in_progress_history
+
+        @last_in_progress_history
+      end
+
+      private def first_in_review_history
+        raise 'you must expand the changelog field to calculate cycle time' if histories.nil?
+
+        # Find the first instance in the histoy where the status moved to "In Review"
+        @first_in_review_history ||= histories.select do |history|
+          history.items.find do |item|
+            item['fieldId'] == 'status' && item['toString'] == 'In Review'
+          end
+        end.min_by(&:created)
+        raise 'unable to find "In Review" history entry needed to calculate cycle time' unless @first_in_review_history
+
+        @first_in_review_history
+      end
+
+      private def last_closed_history
+        raise 'you must expand the changelog field to calculate cycle time' if histories.nil?
+
+        # Find the last instance in the histoy where the status moved to "Closed"
+        @last_closed_history ||= histories.select do |history|
+          history.items.find do |item|
+            item['fieldId'] == 'status' && item['toString'] == 'Closed'
+          end
+        end.max_by(&:created)
+        raise 'unable to find "Closed" history entry needed to calculate cycle time' unless @last_closed_history
+
+        @last_closed_history
       end
 
       # Returns the value of the jira points field or 0 if the field is not found
-      def calculate_points(data)
+      private def calculate_points(data)
         return data.send(Dev::Jira.config.points_field_name).to_i if Dev::Jira.config.points_field_name && data.respond_to?(Dev::Jira.config.points_field_name)
 
         0

data/lib/firespring_dev_commands/jira/user.rb

@@ -22,8 +22,10 @@ module Dev
       # Returns the Jira user object which maps to the give user id
       # If none is found, it returns a Jira user object with only the id set
       def self.lookup(id)
+        id = id.to_s.strip
+        id = 'notfound' if id.empty?
         user = Dev::Jira.config.user_lookup_list&.find { |it| it.id == id }
-        user ||= new(name: '', email: '', id:)
+        user ||= new(name: 'Not Found', email: 'notfound@notfound.com', id:)
         user
       end
     end

data/lib/firespring_dev_commands/jira.rb

@@ -9,12 +9,13 @@ module Dev
     # "user_lookup_list" should be an array of Jira::User objects representing the usernames, ids, etc for all jira users
     #    This is a bit clumsy but currently the jira api only returns the user id with issues
     #    and there is no way to query this information from Jira directly.
-    Config = Struct.new(:username, :token, :url, :points_field_name, :user_lookup_list, :read_timeout, :http_debug) do
+    Config = Struct.new(:username, :token, :url, :points_field_name, :expand, :user_lookup_list, :read_timeout, :http_debug) do
       def initialize
         self.username = nil
         self.token = nil
         self.url = nil
         self.points_field_name = nil
+        self.expand = []
         self.user_lookup_list = []
         self.read_timeout = 120
         self.http_debug = false
@@ -62,15 +63,16 @@ module Dev
     def issues(jql, &)
       start_at = 0
       max_results = 100
+      expand = self.class.config.expand
 
       # Query Jira and yield all issues it returns
-      issues = @client.Issue.jql(jql, start_at:, max_results:)
+      issues = @client.Issue.jql(jql, start_at:, max_results:, expand:)
       issues.map { |data| Issue.new(data) }.each(&)
 
       # If we returned the max_results then there may be more - add the max results to where we start at and query again
       while issues.length >= max_results
         start_at += max_results
-        issues = @client.Issue.jql(jql, start_at:, max_results:)
+        issues = @client.Issue.jql(jql, start_at:, max_results:, expand:)
         issues.map { |data| Issue.new(data) }.each(&)
       end
     end

data/lib/firespring_dev_commands/version.rb

@@ -6,6 +6,6 @@ module Dev
     # Use 'v.v.v.pre.alpha.v' for pre-release vesions
     # Use 'v.v.v.beta.v for beta versions
     # Use semantic versioning for any releases (https://semver.org/)
-    VERSION = '2.1.6.pre.alpha.1'.freeze
+    VERSION = '2.1.7.pre.alpha.1'.freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: firespring_dev_commands
 version: !ruby/object:Gem::Version
-  version: 2.1.6.pre.alpha.1
+  version: 2.1.7.pre.alpha.1
 platform: ruby
 authors:
 - Firespring
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2023-09-01 00:00:00.000000000 Z
+date: 2023-09-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -284,6 +284,8 @@ files:
 - lib/firespring_dev_commands/git.rb
 - lib/firespring_dev_commands/git/info.rb
 - lib/firespring_dev_commands/jira.rb
+- lib/firespring_dev_commands/jira/histories.rb
+- lib/firespring_dev_commands/jira/history.rb
 - lib/firespring_dev_commands/jira/issue.rb
 - lib/firespring_dev_commands/jira/project.rb
 - lib/firespring_dev_commands/jira/user.rb