Installation

Add this line to your application's Gemfile:

gem 'timetrello'

And then execute:

bundle

Or install it yourself as:

gem install timetrello

Usage

You use the module directly.

Trello

All time tracking annotations must follow the specification below in order to be understood and consolidated by TimeTrello.

PREFIX DURATION [START_DATE] "COMMENT"

See some valid examples:

The default prefix which identifies the proper comment is :clock12: (:clock12:) emoticon. If no start date is provided through the comment, the comment timestamp is used.

Ruby

require 'time_trello'

TimeTrello.initialize('your trello public key here', 'your trello token here', ':clock12:')
tasks = TimeTrello.find_all(Time.new(2012, 1, 1), Time.new(2016, 4, 1), 'Board ID you want to evaluate')

tasks.each do |task|
  # ...
end

Methods

initialize

Initializes the TimeTrello subsystem, providing information necessary for its proper workings.

Parameters

TimeTrello.initialize(public_key, token, prefix=':clock12:')
Parameter Type Description
public_key String Your Trello developer key
token String The connection token provided by Trello due to its authorization process
prefix String Prefix to use for comment detection. Defaults to :clock12:

find_all

Queries Trello, parsing comments which have the required format for consolidation.

Parameters

TimeTrello.find_all (start_date, end_date, board_id, &filter)
Parameter Type Description
start_date Time Start date to use for limiting the result set
end_date Time End date to use for limiting the result set
board_id String Trello's board identification to query for
filter Proc Block to use for extra data filtering

The filter block receives as parameter an instance of TimeTrello::ActivityRecord. It must return a boolean:

See the example.rb file for a usage example.