trello_effort_tracker 0.0.5 → 0.0.6

data/.gitignore

@@ -15,6 +15,7 @@ tmp
 .tmtags
 .tags
 .tags_sorted_by_file
+trello_effort_tracker.sublime-workspace
 
 # YARD artifacts
 .yardoc
@@ -23,4 +24,4 @@ doc/
 
 config.yml
 mongoid.yml
-.rvmrc
+.rvmrc

data/CHANGELOG

@@ -1,3 +1,8 @@
+0.0.6
+  - Added TrackedCard#status to track card status: :todo if no effort has been spent, :done if the card is in a DONE column, :in_progress otherwise
+  - Added a Members#effort_spent and #effort_spent_since to extract the overall effort tracked by a member since a given date
+  - Re-merged in the trello_effort_app branch to bring on the Rails app
+
 0.0.5
   - Improved docs
   - Improved use of this tool as a gem

data/Gemfile

@@ -2,24 +2,8 @@ source :rubygems
 
 gemspec
 
-gem 'ruby-trello', :require => 'trello'
 # gem 'ruby-trello', :require => 'trello', :path => '../ruby-trello' # to hack on the ruby-trello gem itself
 
-gem 'rainbow'
-gem 'chronic'
-
-gem 'mongoid'
-gem 'bson_ext'
-
-gem 'google_drive'
-gem 'highline'
-
-group :test, :development, :spec do
-  gem 'rake'
-  gem 'rspec'
+group :test do
   gem 'simplecov', :require => false, :platforms => [:mri, :mri_19]
-  gem 'rspec-mocks'
-  gem 'mongoid-rspec'
-  gem 'database_cleaner'
-  gem 'debugger'
 end

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    trello_effort_tracker (0.0.4)
+    trello_effort_tracker (0.0.6)
       bson_ext
       chronic
       google_drive
@@ -13,10 +13,10 @@ PATH
 GEM
   remote: http://rubygems.org/
   specs:
-    activemodel (3.2.11)
-      activesupport (= 3.2.11)
+    activemodel (3.2.12)
+      activesupport (= 3.2.12)
       builder (~> 3.0.0)
-    activesupport (3.2.11)
+    activesupport (3.2.12)
       i18n (~> 0.6)
       multi_json (~> 1.0)
     addressable (2.3.2)
@@ -27,15 +27,15 @@ GEM
     chronic (0.9.0)
     columnize (0.3.6)
     database_cleaner (0.9.1)
-    debugger (1.3.0)
+    debugger (1.3.1)
       columnize (>= 0.3.1)
       debugger-linecache (~> 1.1.1)
-      debugger-ruby_core_source (~> 1.1.7)
+      debugger-ruby_core_source (~> 1.1.8)
     debugger-linecache (1.1.2)
       debugger-ruby_core_source (>= 1.1.1)
-    debugger-ruby_core_source (1.1.7)
+    debugger-ruby_core_source (1.1.8)
     diff-lcs (1.1.3)
-    faraday (0.8.4)
+    faraday (0.8.5)
       multipart-post (~> 1.1)
     google_drive (0.3.3)
       nokogiri (>= 1.4.4, != 1.5.2, != 1.5.1)
@@ -44,11 +44,11 @@ GEM
     highline (1.6.15)
     httpauth (0.2.0)
     i18n (0.6.1)
-    json (1.7.6)
+    json (1.7.7)
     jwt (0.1.5)
       multi_json (>= 1.0)
-    mime-types (1.20.1)
-    mongoid (3.0.20)
+    mime-types (1.21)
+    mongoid (3.0.21)
       activemodel (~> 3.1)
       moped (~> 1.2)
       origin (~> 1.0)
@@ -57,19 +57,21 @@ GEM
       mongoid (>= 3.0.1)
       rake
       rspec (>= 2.9)
-    moped (1.3.2)
-    multi_json (1.5.0)
+    moped (1.4.2)
+    multi_json (1.5.1)
+    multi_xml (0.5.3)
     multipart-post (1.1.5)
     nokogiri (1.5.6)
     oauth (0.4.7)
-    oauth2 (0.8.0)
+    oauth2 (0.9.0)
       faraday (~> 0.8)
       httpauth (~> 0.1)
       jwt (~> 0.1.4)
       multi_json (~> 1.0)
+      multi_xml (~> 0.5)
       rack (~> 1.2)
     origin (1.0.11)
-    rack (1.5.1)
+    rack (1.5.2)
     rainbow (1.1.4)
     rake (10.0.3)
     rest-client (1.6.7)
@@ -98,18 +100,11 @@ PLATFORMS
   ruby
 
 DEPENDENCIES
-  bson_ext
-  chronic
   database_cleaner
   debugger
-  google_drive
-  highline
-  mongoid
   mongoid-rspec
-  rainbow
   rake
   rspec
   rspec-mocks
-  ruby-trello
   simplecov
   trello_effort_tracker!

data/Rakefile

@@ -1,75 +1,12 @@
+# encoding: utf-8
+require 'bundler'
 require 'trello_effort_tracker'
 require 'rspec/core/rake_task'
 
+Bundler::GemHelper.install_tasks
 RSpec::Core::RakeTask.new(:spec)
 
 task :default => :spec
 task :specs   => :spec
 
-desc "Open an irb session preloaded with this library, e.g. rake 'console[production]' will open a irb session with the production db env"
-task :console, [:db_env] do |t, args|
-  args.with_defaults(db_env: "development")
-  sh "export MONGOID_ENV=#{args.db_env}; irb -rubygems -I lib -r trello_effort_tracker.rb -r startup_trello.rb"
-end
-
-task :c, [:db_env] do |t, args|
-  Rake::Task[:console].invoke(args.db_env)
-end
-
-namespace :spec do
-  desc "Run fast specs"
-  RSpec::Core::RakeTask.new(:fast) do |t|
-    t.rspec_opts = '--tag ~needs_valid_configuration'
-  end
-
-  desc "Run slow specs"
-  RSpec::Core::RakeTask.new(:slow) do |t|
-    t.rspec_opts = '--tag needs_valid_configuration'
-  end
-end
-
-namespace :run do
-  include TrelloConfiguration
-
-  desc "Run on the cards tracked starting from a given day, e.g. rake 'run:from_day[2012-11-1]'"
-  task :from_day, [:starting_date, :db_env] => [:ensure_environment] do |t, args|
-    args.with_defaults(starting_date: Date.today.to_s, db_env: "development")
-    TrelloConfiguration::Database.load_env(args.db_env)
-
-    tracker = TrelloTracker.new
-    tracker.track(Date.parse(args.starting_date))
-  end
-
-  desc "Run on the cards tracked today, #{Date.today}"
-  task :today, [:db_env] => [:ensure_environment] do |t, args|
-    args.with_defaults(db_env: "development")
-    Rake.application.invoke_task("run:from_day[#{Date.today.to_s}, #{args.db_env}]")
-  end
-end
-
-namespace :export do
-  desc "Export all cards to a google docs spreadsheet, e.g. rake \"export:google_docs[my_sheet,tracking,production]\""
-  task :google_docs, [:spreadsheet, :worksheet, :db_env] => [:ensure_environment] do |t, args|
-    args.with_defaults(db_env: "development")
-    TrelloConfiguration::Database.load_env(args.db_env)
-
-    exporter = GoogleDocsExporter.new(args.spreadsheet, args.worksheet)
-    spreadsheet_url = exporter.export
-
-    puts "[DONE]".color(:green)
-    puts "Go to #{spreadsheet_url}"
-  end
-end
-
-task :ensure_environment do
-  %w{developer_public_key access_token_key}.each do |each_name|
-    unless ENV[each_name] || authorization_params_from_config_file[each_name]
-      puts "ERROR: Missing <#{each_name}> environment variable."
-      exit 1
-    end
-  end
-  unless tracker_username
-    puts "ERROR: Missing <tracker_username> environment variable."
-    exit 1
-  end
-end
+import 'lib/tasks/tasks.rake'

data/lib/patches/trello/card.rb

@@ -1,7 +1,7 @@
 module Trello
 
   class Card
-    # Reopening the Trello::Card class to add a  method detecting a card moved in a DONE column
+    # Reopening the Trello::Card class to add a method detecting a card moved in a DONE column
     def in_done_column?
       list_name = ""
       begin

data/lib/tasks/tasks.rake

@@ -0,0 +1,67 @@
+desc "Open an irb session preloaded with this library, e.g. rake 'console[production]' will open a irb session with the production db env"
+task :console, [:db_env] do |t, args|
+  args.with_defaults(db_env: "development")
+  sh "export MONGOID_ENV=#{args.db_env}; irb -rubygems -I lib -r trello_effort_tracker.rb -r startup_trello.rb"
+end
+
+task :c, [:db_env] do |t, args|
+  Rake::Task[:console].invoke(args.db_env)
+end
+
+namespace :spec do
+  desc "Run fast specs"
+  RSpec::Core::RakeTask.new(:fast) do |t|
+    t.rspec_opts = '--tag ~needs_valid_configuration'
+  end
+
+  desc "Run slow specs"
+  RSpec::Core::RakeTask.new(:slow) do |t|
+    t.rspec_opts = '--tag needs_valid_configuration'
+  end
+end
+
+namespace :run do
+  include TrelloConfiguration
+
+  desc "Run on the cards tracked starting from a given day, e.g. rake 'run:from_day[2012-11-1]'"
+  task :from_day, [:starting_date, :db_env] => [:ensure_environment] do |t, args|
+    args.with_defaults(starting_date: Date.today.to_s, db_env: "development")
+    TrelloConfiguration::Database.load_env(args.db_env)
+
+    tracker = TrelloTracker.new
+    tracker.track(Date.parse(args.starting_date))
+  end
+
+  desc "Run on the cards tracked today, #{Date.today}"
+  task :today, [:db_env] => [:ensure_environment] do |t, args|
+    args.with_defaults(db_env: "development")
+    Rake.application.invoke_task("run:from_day[#{Date.today.to_s}, #{args.db_env}]")
+  end
+end
+
+namespace :export do
+  desc "Export all cards to a google docs spreadsheet, e.g. rake \"export:google_docs[my_sheet,tracking,production]\""
+  task :google_docs, [:spreadsheet, :worksheet, :db_env] => [:ensure_environment] do |t, args|
+    args.with_defaults(db_env: "development")
+    TrelloConfiguration::Database.load_env(args.db_env)
+
+    exporter = GoogleDocsExporter.new(args.spreadsheet, args.worksheet)
+    spreadsheet_url = exporter.export
+
+    puts "[DONE]".color(:green)
+    puts "Go to #{spreadsheet_url}"
+  end
+end
+
+task :ensure_environment do
+  %w{developer_public_key access_token_key}.each do |each_name|
+    unless ENV[each_name] || authorization_params_from_config_file[each_name]
+      puts "ERROR: Missing <#{each_name}> environment variable."
+      exit 1
+    end
+  end
+  unless tracker_username
+    puts "ERROR: Missing <tracker_username> environment variable."
+    exit 1
+  end
+end

data/lib/trello_effort_tracker/effort.rb

@@ -13,6 +13,14 @@ class Effort
 
   validates_presence_of :amount, :date, :members
 
+  def amount_per_member
+    amount / members.size
+  end
+
+  def include?(member)
+    members.include?(member)
+  end
+
   def ==(other)
     return true if other.equal?(self)
     return false unless other.kind_of?(self.class)
@@ -24,4 +32,4 @@ class Effort
     "[#{date}] spent #{amount} hours by #{members.map(&:at_username).join(", ")}"
   end
 
-end
+end

data/lib/trello_effort_tracker/member.rb

@@ -24,9 +24,17 @@ class Member
   end
 
   def avatar_url
-    "https://trello-avatars.s3.amazonaws.com/#{avatar_id}/30.png"
+    trello_member.avatar_url(size: :small)
   end
 
+  def effort_spent(from_date=nil)
+    cards = TrackedCard.where("efforts.members.username" => username)
+    efforts = cards.map(&:efforts).compact.flatten
+    efforts = efforts.select {|e| e.date >= from_date} if from_date
+    efforts.select { |effort| effort.include?(self) }.inject(0) { |total, effort| total + effort.amount_per_member }
+  end
+  alias_method :effort_spent_since, :effort_spent
+
   def ==(other)
     return true if other.equal?(self)
     return false unless other.kind_of?(self.class)
@@ -43,4 +51,11 @@ class Member
     username.hash
   end
 
+  private
+
+  def trello_member
+    @trello_member ||= Trello::Member.new("id" => trello_id, "fullName" => full_name, "username" => username,
+                                           "avatarHash" => avatar_id, "bio" => bio, "url" => url)
+  end
+
 end

data/lib/trello_effort_tracker/tracked_card.rb

@@ -33,6 +33,16 @@ class TrackedCard
     return tracked_card if updated_successfully
   end
 
+  def status
+    if done?
+      :done
+    elsif efforts.empty?
+      :todo
+    else
+      :in_progress
+    end
+  end
+
   def self.build_from(trello_card)
     trello_card_id = trello_card.id
     trello_card.attributes.delete(:id)

data/lib/trello_effort_tracker/version.rb

@@ -1,3 +1,3 @@
 class TrelloEffortTracker
-  VERSION = '0.0.5'
+  VERSION = '0.0.6'
 end

data/spec/effort_spec.rb

@@ -13,11 +13,18 @@ describe Effort do
     it { should validate_presence_of(:members) }
   end
 
-  describe "equality" do
-    %w{piero tommaso tom ugo}.each do |username|
-      let(username.to_sym) { Member.new(username: username) }
+  %w{piero tommaso tom ugo}.each do |username|
+    let(username.to_sym) { Member.new(username: username) }
+  end
+
+  describe "#amount_per_member" do
+    it "counts the amount spent per single member" do
+      effort = Effort.new(amount: 6, members: [piero, tommaso], date: Date.parse("2012-11-09"), )
+      effort.amount_per_member.should == 3
     end
+  end
 
+  describe "equality" do
     it "is equal to another effort with same amount, date and members" do
       effort          = Effort.new(amount: 3, date: Date.parse("2012-11-09"), members: [piero, tommaso])
       same_effort     = Effort.new(amount: 3, date: Date.parse("2012-11-09"), members: [piero, tommaso])

data/spec/member_spec.rb

@@ -36,6 +36,42 @@ describe Member do
     end
   end
 
+  describe "#effort_spent" do
+    %w{piero tommaso}.each do |username|
+      let(username.to_sym) { Member.new(username: username) }
+    end
+
+    let(:card)         { TrackedCard.create(name: "any", short_id: 1234, trello_id: "123123") }
+    let(:another_card) { TrackedCard.create(name: "any_other", short_id: 1235, trello_id: "123125") }
+
+    it "is zero when the member did not spent effort at all" do
+      piero.effort_spent.should == 0
+    end
+
+    it "counts the effort spent on a card" do
+      card.efforts << Effort.new(amount: 4, date: Date.today, members: [piero, tommaso])
+      card.efforts << Effort.new(amount: 5, date: Date.today, members: [tommaso])
+
+      piero.effort_spent.should == 4 / 2
+    end
+
+    it "counts the effort spent on several cards" do
+      card.efforts << Effort.new(amount: 4, date: Date.today, members: [piero, tommaso])
+      another_card.efforts << Effort.new(amount: 5, date: Date.today, members: [piero])
+
+      piero.effort_spent.should == 2 + 5
+    end
+
+    it "counts the effort spent on a card from a given date" do
+      card.efforts << Effort.new(amount: 4, date: Date.yesterday, members: [piero])
+      card.efforts << Effort.new(amount: 5, date: Date.today, members: [piero])
+
+      piero.effort_spent(Date.today).should == 5
+      piero.effort_spent_since(Date.today).should == 5
+    end
+
+  end
+
   describe "#avatar_url" do
     it "points to the avatar thumbnail image" do
       member = Member.new(avatar_id: "123xyz")

data/spec/tracked_card_spec.rb

@@ -308,11 +308,29 @@ describe TrackedCard do
     it "describes the card as a string" do
       card = TrackedCard.new(name: "A Story Name")
       card.estimates << Estimate.new(amount: 5, date: Date.today)
-      card.efforts << Effort.new(amount: 3, date: Date.today, members: [Member.new(username: "piero"),   Member.new(username: "tommaso")])
-      card.efforts << Effort.new(amount: 6, date: Date.today, members: [Member.new(username: "piero"),   Member.new(username: "tommaso")])
+      card.efforts << Effort.new(amount: 3, date: Date.today, members: [Member.new(username: "piero"), Member.new(username: "tommaso")])
+      card.efforts << Effort.new(amount: 6, date: Date.today, members: [Member.new(username: "piero"), Member.new(username: "tommaso")])
 
       card.to_s.should == %Q{[A Story Name]. Total effort: 9.0h. Estimates ["[2012-11-05] estimated 5.0 hours"]. Efforts: ["[2012-11-05] spent 3.0 hours by @piero, @tommaso", "[2012-11-05] spent 6.0 hours by @piero, @tommaso"]}
     end
   end
 
+  describe "#status" do
+    it "is done when is done" do
+      done_card = TrackedCard.new(done:true)
+      done_card.status.should == :done
+
+      done_card.efforts << Effort.new(amount: 3, date: Date.today, members: [Member.new(username: "any")])
+      done_card.status.should == :done
+    end
+
+    it "is todo when no effort has been spent on the card" do
+      card = TrackedCard.new
+      card.status.should == :todo
+
+      card.efforts << Effort.new(amount: 3, date: Date.today, members: [Member.new(username: "any")])
+      card.status.should == :in_progress
+    end
+  end
+
 end

data/trello_effort_tracker.gemspec

@@ -7,7 +7,11 @@ Gem::Specification.new do |gem|
   gem.platform          = Gem::Platform::RUBY
 
   gem.description       = "A tool to extract estimates and efforts from Trello"
-  gem.summary           = "You notify all the estimates and efforts of your Trello cards. This tool will extract and store these estimates and actual efforts to let you extract useful key metrics (e.g. estimate errors)"
+  gem.summary           = <<-DESC
+    You notify all the estimates and efforts of your Trello cards.
+    This tool will extract and store these estimates and actual efforts
+    to let you extract useful key metrics (e.g. estimate errors)
+  DESC
   gem.authors           = ['Pietro Di Bello']
   gem.email             = 'pierodibello@gmail.com'
   gem.homepage          = 'http://xplayer.wordpress.com'
@@ -18,14 +22,20 @@ Gem::Specification.new do |gem|
   gem.test_files        = `git ls-files -- {spec}/*`.split("\n")
   gem.extra_rdoc_files  = ["README.md"]
 
-  gem.rubygems_version  = %q{1.8.24}
   gem.required_rubygems_version = ">= 1.3.6"
 
-  gem.add_dependency 'ruby-trello'
-  gem.add_dependency 'mongoid'
-  gem.add_dependency 'bson_ext'
-  gem.add_dependency 'google_drive'
-  gem.add_dependency 'rainbow'
-  gem.add_dependency 'chronic'
-  gem.add_dependency 'highline'
+  gem.add_runtime_dependency 'ruby-trello'
+  gem.add_runtime_dependency 'mongoid'
+  gem.add_runtime_dependency 'bson_ext'
+  gem.add_runtime_dependency 'google_drive'
+  gem.add_runtime_dependency 'rainbow'
+  gem.add_runtime_dependency 'chronic'
+  gem.add_runtime_dependency 'highline'
+
+  gem.add_development_dependency 'rake'
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'rspec-mocks'
+  gem.add_development_dependency 'mongoid-rspec'
+  gem.add_development_dependency 'database_cleaner'
+  gem.add_development_dependency 'debugger'
 end

data/trello_effort_tracker.sublime-project

@@ -0,0 +1,10 @@
+{
+ "folders":
+ [
+   {
+     "path": ".",
+     "folder_exclude_patterns": ["tmp", "log", "coverage"],
+     "file_exclude_patterns": ["trello_effort_tracker.sublime-workspace"]
+   }
+ ]
+}

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: trello_effort_tracker
 version: !ruby/object:Gem::Version
-  version: 0.0.5
+  version: 0.0.6
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-02-08 00:00:00.000000000 Z
+date: 2013-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: ruby-trello
@@ -123,6 +123,102 @@ dependencies:
     - - ! '>='
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec-mocks
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: mongoid-rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: database_cleaner
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: debugger
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
 description: A tool to extract estimates and efforts from Trello
 email: pierodibello@gmail.com
 executables: []
@@ -146,6 +242,7 @@ files:
 - lib/patches/trello/card.rb
 - lib/patches/trello/member.rb
 - lib/startup_trello.rb
+- lib/tasks/tasks.rake
 - lib/trello_effort_tracker.rb
 - lib/trello_effort_tracker/effort.rb
 - lib/trello_effort_tracker/estimate.rb
@@ -184,6 +281,7 @@ files:
 - spec/trello_configuration_spec.rb
 - spec/trello_tracker_spec.rb
 - trello_effort_tracker.gemspec
+- trello_effort_tracker.sublime-project
 homepage: http://xplayer.wordpress.com
 licenses: []
 post_install_message: