gradesfirst 0.4.0 → 0.5.0

data/gradesfirst.gemspec

@@ -1,7 +1,7 @@
 Gem::Specification.new do |s|
   s.platform = Gem::Platform::RUBY
   s.name = "gradesfirst"
-  s.version = "0.4.0"
+  s.version = "0.5.0"
   s.summary = "GradesFirst command line utility for developers."
   s.description = "This utility will help manage the various tasks developers need to do on their workstation such as database updates."
   s.license = "MIT"

data/lib/gradesfirst/cli.rb

@@ -4,6 +4,7 @@ require 'gradesfirst/cli_helper'
 require 'gradesfirst/command'
 require 'gradesfirst/branch_command'
 require 'gradesfirst/commit_message_command'
+require 'gradesfirst/pair_command'
 require 'gradesfirst/task_cli'
 
 require 'pivotal_tracker'
@@ -15,13 +16,18 @@ module GradesFirst
     desc 'branch', GradesFirst::BranchCommand.description
     def branch
       set_pivotal_tracker_api_token
-      execute(GradesFirst::BranchCommand)
+      execute GradesFirst::BranchCommand
     end
 
     desc 'commit-message', GradesFirst::CommitMessageCommand.description
     def commit_message
       set_pivotal_tracker_api_token
-      execute(GradesFirst::CommitMessageCommand)
+      execute GradesFirst::CommitMessageCommand
+    end
+
+    desc 'pair', GradesFirst::PairCommand.description
+    def pair
+      execute GradesFirst::PairCommand
     end
 
     desc 'task COMMAND', 'Manage tasks related to a PivotalTracker story.'

data/lib/gradesfirst/pair_command.rb

@@ -0,0 +1,107 @@
+require 'time'
+require 'gradesfirst/command'
+
+module GradesFirst
+  # Implementation of a Thor command for determining who your next pair is for
+  # pair programming or code review.
+  class PairCommand < GradesFirst::Command
+    # Description of the "gf pair" Thor command that will be used in the
+    # commandline help.
+    def self.description
+      'Show the current developer pairings.'
+    end
+
+    # Performs the gf pair Thor command which determines the current
+    # developer pairings.
+    def execute
+      @pairing = pairings[pairing_index]
+    end
+
+    # Generates the command line output response.  The output of the pair
+    # command will be a list of developer pairings for code review, pair
+    # programming, etc.
+    def response
+      @pairing.map{|pair| pair.compact.join(' and ')}.join("\n") + "\n"
+    end
+
+    private
+
+    # Currently returns a hard coded list but could be moved to a configuration
+    # file in the future.
+    def developers
+      return @developers unless @developers.nil?
+
+      @developers = [
+        "Anthony Crumley",
+        "Tom Miller",
+        "Andrew Sellers",
+        "Matt Turney",
+        "Zac Williams",
+        "Ben Holley"
+      ].sort
+      @developers << nil if @developers.length.odd?
+
+      @developers
+    end
+
+    # This algorythm was written by Tom Miller based on the wikipedia article on
+    # round robin tournaments.
+    #
+    # https://en.wikipedia.org/wiki/Round-robin_tournament
+    def pairings
+      top, bottom = developers.each_slice(developers.length/2).to_a
+      pivot, *top = top
+
+      result = []
+      (developers.length-1).times do
+        top.unshift(bottom.shift)
+        bottom.push(top.pop)
+        result << [pivot, *top].zip(bottom)
+      end
+
+      result
+    end
+
+    def pairing_index
+      sprint % max_pairing_index
+    end
+
+    def max_pairing_index
+      developers.length - 1
+    end
+
+    def sprint
+      week / sprint_length_in_weeks
+    end
+
+    # Currently this is hard coded but could be moved to a configuration file
+    # in the future.
+    def sprint_length_in_weeks
+      2
+    end
+
+    def week
+      (now.to_i - day_zero.to_i) / seconds_in_a_week
+    end
+
+    def seconds_in_a_week
+      days_in_a_week = 7
+      hours_in_a_day = 24
+      minutes_in_an_hour = 60
+      seconds_in_a_minute = 60
+
+      days_in_a_week * hours_in_a_day * minutes_in_an_hour * seconds_in_a_minute
+    end
+
+    def now
+      Time.now
+    end
+
+    # Currently hard coded to return the beginning of a GradesFirst sprint but
+    # could be put in a configuration file in the future.
+    def day_zero
+      Time.parse("2014-3-11 00:00:00")
+    end
+
+  end
+end

data/test/cli_test.rb

@@ -4,8 +4,16 @@ require 'gradesfirst/cli'
 describe GradesFirst::CLI do
 
   def assert_command_hooked_up(shell_command, klass)
-    assert_includes klass.instance_methods, :execute
-    assert_includes klass.instance_methods, :response
+    assert_includes(
+      klass.instance_methods,
+      :execute,
+      "#{klass.name} does not implement the #execute method"
+    )
+    assert_includes(
+      klass.instance_methods,
+      :response,
+      "#{klass.name} does not implement the #response method"
+    )
 
     execute_arity = klass.instance_method(:execute).arity
     if execute_arity < 0
@@ -38,6 +46,10 @@ describe GradesFirst::CLI do
     assert_command_hooked_up 'commit-message', GradesFirst::CommitMessageCommand
   end
 
+  specify 'pair command is hooked up' do
+    assert_command_hooked_up 'pair', GradesFirst::PairCommand
+  end
+
   # Waiting on fix for subcommands with default command.
   # https://github.com/erikhuda/thor/pull/374
   #specify 'task command is hooked up to default list subcommand' do

data/test/fixtures/pair.txt

@@ -0,0 +1,3 @@
+Mickey Mouse and Ironman
+Minnie Mouse and Wonder Woman
+Superman and Cat Woman

data/test/pair_command_test.rb

@@ -0,0 +1,29 @@
+require 'test_helper'
+require 'gradesfirst/pair_command'
+
+describe GradesFirst::PairCommand do
+  before do
+    @command = GradesFirst::PairCommand.new
+    @developers = [
+      'Mickey Mouse',
+      'Cat Woman',
+      'Wonder Woman',
+      'Superman',
+      'Minnie Mouse',
+      'Ironman'
+    ]
+  end
+
+  specify '#execute pairs developers correctly' do
+    @command.stub :developers, @developers do
+      @command.stub :now, Time.parse("2014-3-25 00:00:00") do
+        @command.execute
+      end
+    end
+    assert_equal(
+      fixture_file('pair.txt'),
+      @command.response,
+      'Programmer pairing is not correct.'
+    )
+  end
+end

metadata

@@ -1,18 +1,20 @@
 --- !ruby/object:Gem::Specification
 name: gradesfirst
 version: !ruby/object:Gem::Version
-  version: 0.4.0
+  version: 0.5.0
+  prerelease: 
 platform: ruby
 authors:
 - GradesFirst
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-03-10 00:00:00.000000000 Z
+date: 2014-03-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: thor
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -20,6 +22,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -27,6 +30,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: http_magic
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -34,6 +38,7 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -41,6 +46,7 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -48,6 +54,7 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
+    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -74,6 +81,7 @@ files:
 - lib/gradesfirst/cli_helper.rb
 - lib/gradesfirst/command.rb
 - lib/gradesfirst/commit_message_command.rb
+- lib/gradesfirst/pair_command.rb
 - lib/gradesfirst/task_add_command.rb
 - lib/gradesfirst/task_cli.rb
 - lib/gradesfirst/task_command.rb
@@ -89,6 +97,7 @@ files:
 - test/fixtures/commit_message.txt
 - test/fixtures/gf_branch.txt
 - test/fixtures/git_branch.txt
+- test/fixtures/pair.txt
 - test/fixtures/projects.json
 - test/fixtures/story_bar.json
 - test/fixtures/story_foo.json
@@ -99,6 +108,7 @@ files:
 - test/fixtures/task_toggled.txt
 - test/fixtures/tasks.json
 - test/fixtures/tasks.txt
+- test/pair_command_test.rb
 - test/support/pivotal_test_helper.rb
 - test/support/request_expectation.rb
 - test/task_add_command_test.rb
@@ -110,25 +120,26 @@ files:
 homepage: http://www.gradesfirst.com
 licenses:
 - MIT
-metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.8.7
 required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: 1.3.6
 requirements: []
 rubyforge_project: 
-rubygems_version: 2.2.2
+rubygems_version: 1.8.25
 signing_key: 
-specification_version: 4
+specification_version: 3
 summary: GradesFirst command line utility for developers.
 test_files: []

checksums.yaml

@@ -1,15 +0,0 @@
----
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    YTQ2ODU5MGIxYWQwM2QwZjc1YWVkMmRlNDE5OTY5MDk2NmI2ZmI5ZQ==
-  data.tar.gz: !binary |-
-    NjYxNmE1MmJlM2I5MmM1ZGQ3OWMyNWY3MGY1NjQ1MDRjMjZiYzdjMg==
-SHA512:
-  metadata.gz: !binary |-
-    MDJmYmQxNzM1NzAzMTUzM2I5Yzc3MjdhMTRhYjRlNTUyMTg3YjIyN2VmOTkz
-    MzExODcxMWRjOGQwMWUxN2E4NjE5MWVhY2I3YzkxODBjOGU3ZTNlZTdlOWY2
-    MjUyZWU3YzZjY2E4N2ViOTExY2VlY2JhYWFkODY0NTdlYTdhZjQ=
-  data.tar.gz: !binary |-
-    ZGEyMjY5NjM3ZmQwMzY1Nzg3NDgwMzJjZjQ5ZGJiMDdiZmM4ODY1MThlMGQw
-    MjU4ODhmMTVkNDIwODE5NDhiNTg3NTQ2NTk2NzZkNjgzZjM4ZmU3ZjcwNDdj
-    NmQ5ZTZiYjRhOGEyNjQyZDBlZTJhOTVlYzQzZTQwYTZmNmE2YWI=