trello_lead_time 0.0.1

data/lib/trello_lead_time/time_humanizer.rb

@@ -0,0 +1,13 @@
+module TrelloLeadTime
+  class TimeHumanizer
+    def self.humanize_seconds(seconds)
+      [[60, :seconds], [60, :minutes], [24, :hours], [1000, :days]].inject([]){ |s, (count, name)|
+        if seconds > 0
+          seconds, n = seconds.divmod(count)
+          s.unshift "#{n.to_i} #{name}"
+        end
+        s
+      }.join(' ')
+    end
+  end
+end

data/lib/trello_lead_time/timeline.rb

@@ -0,0 +1,142 @@
+module TrelloLeadTime
+  class Timeline
+    def self.for_trello_card(trello_card)
+      Timeline.new(trello_card)
+    end
+
+    def initialize(trello_card)
+      @trello_card = trello_card
+      assemble_timeline
+    end
+
+    def done?
+      !last_done_action.nil?
+    end
+
+    def closed?
+      !closed_date.nil?
+    end
+
+    def closed_date
+      action = actions.detect {|a| a.type =~ /updateCard/i && a.data["old"].has_key?("closed")}
+      action ? action.date : nil
+    end
+
+    def age_in_seconds
+      @_age ||= calculate_age_in_seconds(creation_date, done_date)
+    end
+
+    def done_date
+      last_done_action.date if !last_done_action.nil?
+    end
+
+    def seconds_in_list(list_name)
+      matched_list = @_seconds_in_list.values.detect { |list| list[:list_name] == list_name }
+      return matched_list[:seconds_in_list] if !matched_list.nil?
+      0
+    end
+
+    private
+
+    def last_done_action
+      @_last_done_action ||= actions.detect { |a| a.type =~ /updateCard/ && a.data.has_key?("listAfter") && a.data["listAfter"].has_key?("name") && a.data["listAfter"]["name"] =~ Config.list_name_matcher_for_done }
+    end
+
+    def actions
+      @_actions ||= filtered_actions
+    end
+
+    def filtered_actions
+      @trello_card.actions(filter: 'createCard,updateCard:idList,updateCard:closed').map { |action| Action.from_trello_action(action) }
+    end
+
+    def creation_date
+      return actions.last.date if actions.size > 0
+      nil
+    end
+
+    def calculate_age_in_seconds(start_time, end_time)
+      (end_time - start_time).round(0)
+    end
+
+    def assemble_timeline
+      @_seconds_in_list = {}
+      actions.reverse.each_with_index do |action, index|
+        before_list = list_before_current_index(index)
+        after_list = list_from_result_of_action(action)
+        seconds = time_since_last_action(index)
+
+        list_identifier = before_list["id"]
+        if list_identifier
+          if !@_seconds_in_list.has_key?(list_identifier)
+            @_seconds_in_list[list_identifier] = {
+              list_id: before_list["id"],
+              list_name: before_list["name"],
+              seconds_in_list: 0
+            }
+          end
+          @_seconds_in_list[list_identifier][:seconds_in_list] += seconds
+        end
+
+        if index == actions.length - 1
+          # we won't have an after_list if the card was closed after being
+          # created and left in a single list
+          if after_list
+            list_identifier = after_list["id"]
+            if !@_seconds_in_list.has_key?(list_identifier)
+              @_seconds_in_list[list_identifier] = {
+                list_id: after_list["id"],
+                list_name: after_list["name"],
+                seconds_in_list: 0
+              }
+            end
+
+            seconds = 0
+            if done?
+              seconds = calculate_age_in_seconds(action.date, done_date)
+            elsif closed?
+              seconds = calculate_age_in_seconds(action.date, closed_date)
+            else
+              seconds = calculate_age_in_seconds(action.date, Time.now)
+            end
+            @_seconds_in_list[list_identifier][:seconds_in_list] += seconds
+          end
+        end
+
+      end
+    end
+
+    def list_before_current_index(current_index)
+      if current_index == 0
+        "?"
+      else
+        list = nil
+        current_index.downto(1) do |i|
+          list = list_from_result_of_action(actions.reverse[i - 1])
+          break if list
+        end
+        list
+      end
+    end
+
+    def list_from_result_of_action(action)
+      if action.type == "createCard"
+        action.data["list"]
+      elsif action.type == "updateCard" && action.data.has_key?("old") && action.data["old"].has_key?("idList")
+        action.data["listAfter"]
+      end
+    end
+
+    def time_since_last_action(current_index)
+      if current_index == 0
+        0
+      else
+        acts = actions.reverse
+        current_date = acts[current_index].date
+        previous_date = acts[current_index - 1].date
+        (current_date - previous_date).round(0)
+      end
+    end
+
+  end
+end

data/lib/trello_lead_time/version.rb

@@ -0,0 +1,3 @@
+module TrelloLeadTime
+  VERSION = '0.0.1'
+end

data/sample.rb

@@ -0,0 +1,33 @@
+require 'trello_lead_time'
+
+developer_public_key       = 'YOUR TRELLO PUBLIC KEY'
+member_token               = 'YOUR TRELLO MEMBER TOKEN'
+organization_name          = 'fogcreek'
+board_url                  = 'https://trello.com/b/nC8QJJoZ/trello-development'
+source_lists               = ['Live (4/8)', 'Live (3/17)', 'Live (3/3)', 'Live (2/11)', 'Live (1/14)']
+queue_time_lists           = ['Next Up']
+cycle_time_lists           = ['In Progress', 'Testing']
+list_name_matcher_for_done = /^Live/
+
+TrelloLeadTime.configure do |cfg|
+  cfg.organization_name = organization_name
+  cfg.set_trello_key_and_token(developer_public_key, member_token)
+  cfg.queue_time_lists = queue_time_lists
+  cfg.cycle_time_lists = cycle_time_lists
+  cfg.list_name_matcher_for_done = list_name_matcher_for_done
+end
+
+puts "-" * 40
+puts "Calculating metrics for:"
+puts "#{board_url}"
+puts "-" * 40
+
+board = TrelloLeadTime::Board.from_url board_url
+source_lists.each do |source_list|
+  puts "Using cards in list: #{source_list}"
+  puts "Average Card Age:    #{TrelloLeadTime::TimeHumanizer.humanize_seconds(board.average_age(source_list))}"
+  puts "Average Lead Time:   #{TrelloLeadTime::TimeHumanizer.humanize_seconds(board.average_lead_time(source_list))}"
+  puts "Average Queue Time:  #{TrelloLeadTime::TimeHumanizer.humanize_seconds(board.average_queue_time(source_list))}"
+  puts "Average Cycle Time:  #{TrelloLeadTime::TimeHumanizer.humanize_seconds(board.average_cycle_time(source_list))}"
+  puts ""
+end

data/spec/fixtures/actions.1111.json

@@ -0,0 +1,146 @@
+      [
+        {
+          "id": "1234",
+          "idMemberCreator": "1234",
+          "data": {
+            "listAfter": {
+              "name": "Done for 2014-04-11",
+              "id": "3333"
+            },
+            "listBefore": {
+              "name": "Acceptance",
+              "id": "5555"
+            },
+            "board": {
+              "shortLink": "1234",
+              "name": "Transp Backend",
+              "id": "1234"
+            },
+            "card": {
+              "shortLink": "1234",
+              "idShort": 1006,
+              "name": "SEARCH 2.0: Hit HL typeahead and apply filtering/fallbacks",
+              "id": "1234",
+              "idList": "1234"
+            },
+            "old": {
+              "idList": "1234"
+            }
+          },
+          "type": "updateCard",
+          "date": "2014-04-08T20:14:08.000Z",
+          "memberCreator": {
+            "id": "1234",
+            "avatarHash": "1234",
+            "fullName": "Connor Edstrom",
+            "initials": "CE",
+            "username": "connoredstrom"
+          }
+        },
+        {
+          "id": "1234",
+          "idMemberCreator": "1234",
+          "data": {
+            "listAfter": {
+              "name": "Acceptance",
+              "id": "5555"
+            },
+            "listBefore": {
+              "name": "Development",
+              "id": "2222"
+            },
+            "board": {
+              "shortLink": "1234",
+              "name": "Transp Backend",
+              "id": "1234"
+            },
+            "card": {
+              "shortLink": "1234",
+              "idShort": 1006,
+              "name": "SEARCH 2.0: Hit HL typeahead and apply filtering/fallbacks",
+              "id": "1234",
+              "idList": "1234"
+            },
+            "old": {
+              "idList": "1234"
+            }
+          },
+          "type": "updateCard",
+          "date": "2014-04-07T20:14:08.000Z",
+          "memberCreator": {
+            "id": "1234",
+            "avatarHash": "1234",
+            "fullName": "Connor Edstrom",
+            "initials": "CE",
+            "username": "connoredstrom"
+          }
+        },
+        {
+          "id": "1234",
+          "idMemberCreator": "1234",
+          "data": {
+            "listAfter": {
+              "name": "Development",
+              "id": "2222"
+            },
+            "listBefore": {
+              "name": "Product Backlog",
+              "id": "1111"
+            },
+            "board": {
+              "shortLink": "1234",
+              "name": "Transp Backend",
+              "id": "1234"
+            },
+            "card": {
+              "shortLink": "1234",
+              "idShort": 1006,
+              "name": "SEARCH 2.0: Hit HL typeahead and apply filtering/fallbacks",
+              "id": "1234",
+              "idList": "1234"
+            },
+            "old": {
+              "idList": "1234"
+            }
+          },
+          "type": "updateCard",
+          "date": "2014-04-07T16:14:08.000Z",
+          "memberCreator": {
+            "id": "1234",
+            "avatarHash": "1234",
+            "fullName": "Connor Edstrom",
+            "initials": "CE",
+            "username": "connoredstrom"
+          }
+        },
+        {
+          "id": "1234",
+          "idMemberCreator": "1234",
+          "data": {
+            "board": {
+              "shortLink": "1234",
+              "name": "Transp Backend",
+              "id": "1234"
+            },
+            "list": {
+              "name": "Product Backlog",
+              "id": "1111"
+            },
+            "card": {
+              "shortLink": "1234",
+              "idShort": 1006,
+              "name": "SEARCH 2.0: Hit HL typeahead and apply filtering/fallbacks",
+              "id": "1234"
+            }
+          },
+          "type": "createCard",
+          "date": "2014-04-03T21:18:13.000Z",
+          "memberCreator": {
+            "id": "1234",
+            "avatarHash": "1234",
+            "fullName": "Connor Edstrom",
+            "initials": "CE",
+            "username": "connoredstrom"
+          }
+        }
+      ]

data/spec/fixtures/actions.2222.json

@@ -0,0 +1,146 @@
+      [
+        {
+          "id": "1234",
+          "idMemberCreator": "1234",
+          "data": {
+            "listAfter": {
+              "name": "Done for 2014-04-11",
+              "id": "3333"
+            },
+            "listBefore": {
+              "name": "Acceptance",
+              "id": "5555"
+            },
+            "board": {
+              "shortLink": "1234",
+              "name": "Transp Backend",
+              "id": "1234"
+            },
+            "card": {
+              "shortLink": "1234",
+              "idShort": 1006,
+              "name": "SEARCH 2.0: Hit HL typeahead and apply filtering/fallbacks",
+              "id": "1234",
+              "idList": "1234"
+            },
+            "old": {
+              "idList": "1234"
+            }
+          },
+          "type": "updateCard",
+          "date": "2014-04-08T18:50:15.000Z",
+          "memberCreator": {
+            "id": "1234",
+            "avatarHash": "1234",
+            "fullName": "Connor Edstrom",
+            "initials": "CE",
+            "username": "connoredstrom"
+          }
+        },
+        {
+          "id": "1234",
+          "idMemberCreator": "1234",
+          "data": {
+            "listAfter": {
+              "name": "Acceptance",
+              "id": "5555"
+            },
+            "listBefore": {
+              "name": "Development",
+              "id": "2222"
+            },
+            "board": {
+              "shortLink": "1234",
+              "name": "Transp Backend",
+              "id": "1234"
+            },
+            "card": {
+              "shortLink": "1234",
+              "idShort": 1006,
+              "name": "SEARCH 2.0: Hit HL typeahead and apply filtering/fallbacks",
+              "id": "1234",
+              "idList": "1234"
+            },
+            "old": {
+              "idList": "1234"
+            }
+          },
+          "type": "updateCard",
+          "date": "2014-04-08T11:45:00.000Z",
+          "memberCreator": {
+            "id": "1234",
+            "avatarHash": "1234",
+            "fullName": "Connor Edstrom",
+            "initials": "CE",
+            "username": "connoredstrom"
+          }
+        },
+        {
+          "id": "1234",
+          "idMemberCreator": "1234",
+          "data": {
+            "listAfter": {
+              "name": "Development",
+              "id": "2222"
+            },
+            "listBefore": {
+              "name": "Product Backlog",
+              "id": "1111"
+            },
+            "board": {
+              "shortLink": "1234",
+              "name": "Transp Backend",
+              "id": "1234"
+            },
+            "card": {
+              "shortLink": "1234",
+              "idShort": 1006,
+              "name": "SEARCH 2.0: Hit HL typeahead and apply filtering/fallbacks",
+              "id": "1234",
+              "idList": "1234"
+            },
+            "old": {
+              "idList": "1234"
+            }
+          },
+          "type": "updateCard",
+          "date": "2014-04-05T08:15:00.000Z",
+          "memberCreator": {
+            "id": "1234",
+            "avatarHash": "1234",
+            "fullName": "Connor Edstrom",
+            "initials": "CE",
+            "username": "connoredstrom"
+          }
+        },
+        {
+          "id": "1234",
+          "idMemberCreator": "1234",
+          "data": {
+            "board": {
+              "shortLink": "1234",
+              "name": "Transp Backend",
+              "id": "1234"
+            },
+            "list": {
+              "name": "Product Backlog",
+              "id": "1111"
+            },
+            "card": {
+              "shortLink": "1234",
+              "idShort": 1006,
+              "name": "SEARCH 2.0: Hit HL typeahead and apply filtering/fallbacks",
+              "id": "1234"
+            }
+          },
+          "type": "createCard",
+          "date": "2014-04-03T07:00:00.000Z",
+          "memberCreator": {
+            "id": "1234",
+            "avatarHash": "1234",
+            "fullName": "Connor Edstrom",
+            "initials": "CE",
+            "username": "connoredstrom"
+          }
+        }
+      ]