gradesfirst 0.2.0

data/.gitignore

@@ -0,0 +1,3 @@
+*.gem
+*.swp
+.rvmrc

data/Gemfile

@@ -0,0 +1,9 @@
+source "https://rubygems.org"
+
+gem 'rake'
+gem 'minitest', '~> 4.7.0'
+gem 'thor', '~> 0.14.6'
+gem 'webmock', '~> 1.16.0'
+gem 'mocha'
+gem 'pry'
+gem 'pry-debugger'

data/Gemfile.lock

@@ -0,0 +1,45 @@
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.5)
+    coderay (1.1.0)
+    columnize (0.3.6)
+    crack (0.4.1)
+      safe_yaml (~> 0.9.0)
+    debugger (1.6.3)
+      columnize (>= 0.3.1)
+      debugger-linecache (~> 1.2.0)
+      debugger-ruby_core_source (~> 1.2.4)
+    debugger-linecache (1.2.0)
+    debugger-ruby_core_source (1.2.4)
+    metaclass (0.0.1)
+    method_source (0.8.2)
+    minitest (4.7.5)
+    mocha (0.14.0)
+      metaclass (~> 0.0.1)
+    pry (0.9.12.4)
+      coderay (~> 1.0)
+      method_source (~> 0.8)
+      slop (~> 3.4)
+    pry-debugger (0.2.2)
+      debugger (~> 1.3)
+      pry (~> 0.9.10)
+    rake (10.0.2)
+    safe_yaml (0.9.7)
+    slop (3.4.7)
+    thor (0.14.6)
+    webmock (1.16.0)
+      addressable (>= 2.2.7)
+      crack (>= 0.3.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  minitest (~> 4.7.0)
+  mocha
+  pry
+  pry-debugger
+  rake
+  thor (~> 0.14.6)
+  webmock (~> 1.16.0)

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2012 GradesFirst
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1 @@
+

data/Rakefile

@@ -0,0 +1,8 @@
+require 'rake/testtask'
+
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'test'
+  test.test_files = FileList["test/**/*.rb"].exclude("test/test_helper.rb")
+  test.verbose = false
+  test.warning = false
+end

data/bin/gf

@@ -0,0 +1,12 @@
+#!/usr/bin/ruby
+
+if File.exists?(File.join(File.expand_path('../..', __FILE__), '.git'))
+  lib_path = File.expand_path('../../lib', __FILE__)
+  $LOAD_PATH.unshift(lib_path)
+end
+
+require 'rubygems'
+require 'gradesfirst'
+require 'gradesfirst/cli'
+
+GradesFirst::CLI.start

data/gradesfirst.gemspec

@@ -0,0 +1,27 @@
+Gem::Specification.new do |s|
+  s.platform = Gem::Platform::RUBY
+  s.name = "gradesfirst"
+  s.version = "0.2.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"
+
+  s.required_ruby_version = ">= 1.8.7"
+  s.required_rubygems_version = ">= 1.3.6"
+
+  s.author = "GradesFirst"
+  s.email = "tech@gradesfirst.com"
+  s.homepage = "http://www.gradesfirst.com"
+
+  s.files = `git ls-files`.split("\n")
+  s.test_files = `git ls-files -- {test}/*`.split("\n")
+
+  s.bindir = "bin"
+  s.executables = ["gf"]
+  s.default_executable = "gf"
+
+  s.require_paths = ['lib']
+
+  s.add_dependency('thor', '~> 0.14.6')
+  s.add_development_dependency('minitest', '~> 4.7.0')
+end

data/lib/gradesfirst.rb

@@ -0,0 +1,2 @@
+module GradesFirst
+end

data/lib/gradesfirst/branch_command.rb

@@ -0,0 +1,59 @@
+require 'gradesfirst/command'
+
+module GradesFirst
+
+  # Implemenation of a Thor command for enhancing git branch to include
+  # PivotalTracker information such as the story state, name and url.
+  class BranchCommand < GradesFirst::Command
+
+    # Description of the gf branch Thor command that will be used in the
+    # commandline help.
+    def self.description
+      'List git branches with related PivotalTracker story information.'
+    end
+
+    def initialize
+      @enhanced_branches = []
+    end
+
+    # Performs the gf branch Thor command.
+    def execute
+      git_response = git_branch
+      git_response.each_line do |branch|
+        @enhanced_branches << enhanced_branch(branch.rstrip)
+      end
+      nil
+    end
+
+    # Output response of the gf branch Thor command that contains the
+    # PivotalTracker enhanced branch names.
+    def response
+      @enhanced_branches.join("\n") + "\n"
+    end
+
+    private
+
+    def enhanced_branch(branch)
+      story = find_story_by_branch(branch)
+      if story
+        status = story['current_state'].capitalize
+        "#{branch} [#{status}] #{story['name']} (#{story['url']})"
+      else
+        branch
+      end
+    end
+
+    def find_story_by_branch(branch)
+      if story_id(branch)
+        PivotalTracker.stories[story_id(branch)].get
+      else
+        nil
+      end
+    end
+
+    def git_branch
+      `git branch`
+    end
+
+  end
+end

data/lib/gradesfirst/cli.rb

@@ -0,0 +1,58 @@
+require 'thor'
+
+require 'gradesfirst/command'
+require 'gradesfirst/branch_command'
+require 'gradesfirst/commit_message_command'
+require 'gradesfirst/task_command'
+
+require 'pivotal_tracker'
+
+module GradesFirst
+  class CLI < Thor
+
+    desc 'branch', GradesFirst::BranchCommand.description
+    def branch
+      set_pivotal_tracker_api_token
+      execute(GradesFirst::BranchCommand.new)
+    end
+
+    desc 'commit-message', GradesFirst::CommitMessageCommand.description
+    def commit_message
+      set_pivotal_tracker_api_token
+      execute(GradesFirst::CommitMessageCommand.new)
+    end
+
+    desc 'task', GradesFirst::TaskCommand.description
+    def task
+      set_pivotal_tracker_api_token
+      execute(GradesFirst::TaskCommand.new)
+    end
+
+    private
+
+    def execute(command)
+      command.execute
+      say command.response
+    end
+
+    def set_pivotal_tracker_api_token
+      file_name = "#{Dir.home}/.pivotal_tracker_api_key"
+      if File.exists?(file_name)
+        api_token = File.read(file_name)
+      else
+        api_token = ask('Enter your PivotalTracker API token:')
+        File.open(file_name, 'w') do |file|
+          file.write(api_token)
+        end
+      end
+
+      PivotalTracker.api_token = api_token
+    end
+
+    Signal.trap('SIGINT') do
+      print "\n"
+      exit 1
+    end
+
+  end
+end

data/lib/gradesfirst/command.rb

@@ -0,0 +1,22 @@
+module GradesFirst
+
+  # Base class for all command objects.
+  class Command
+
+    private
+
+    # Retrieves the current git branch.
+    def current_branch
+      `git rev-parse --abbrev-ref HEAD`
+    end
+
+    # Extracts a PivotalTracker story id from a branch if one is present.
+    def story_id(branch = current_branch)
+      if branch =~ /[0-9]+$/
+        branch.match(/[0-9]+$/)[0]
+      else
+        nil
+      end
+    end
+  end
+end

data/lib/gradesfirst/commit_message_command.rb

@@ -0,0 +1,37 @@
+require 'gradesfirst/command'
+
+module GradesFirst
+
+  # Implementation of a Thor command for creating a git commit message that
+  # already includes the information from the related PivotalTracker story
+  # associated with the current branch.
+  class CommitMessageCommand < GradesFirst::Command
+
+    # Description of the gf commit-message Thor command that well be usewd in
+    # the commandline help.
+    def self.description
+      'Generate a git commit message in the standard format.'
+    end
+
+    # Performs the gf commit-message Thor command.
+    def execute
+      @story = PivotalTracker.stories[story_id].get
+    end
+
+    # Output response of the gf commit-message Thor command in the standard
+    # format.
+    def response
+      if @story.nil?
+        ''
+      else
+        message = [
+          "[\##{@story['id']}]",
+          "",
+          @story['name'],
+          @story['url']
+        ]
+        message.join("\n") + "\n"
+      end
+    end
+  end
+end

data/lib/gradesfirst/task_command.rb

@@ -0,0 +1,47 @@
+require 'gradesfirst/command'
+
+module GradesFirst
+
+  # Implementation of a Thor command for managing tasks related to a story.
+  class TaskCommand < GradesFirst::Command
+
+    # Description of the gf branch Thor command that will be used in the
+    # command line help.
+    def self.description
+      'List the tasks related to a PivotalTracker story.'
+    end
+
+    # Performs the gf tasks Thor command.
+    def execute
+      @story = PivotalTracker.stories[story_id].get
+      if @story
+        project_id = @story['project_id']
+        @tasks = PivotalTracker.projects[project_id].stories[story_id].tasks.get
+      end
+    end
+
+    # Generates the comand line output response.  The output of the task command
+    # is a list of the tasks associated with the PivotalTracker story associated
+    # with the current branch.
+    def response
+      if @tasks.nil?
+        error_message
+      else
+        task_list = @tasks.map do |t|
+          "  [#{t["complete"] ? 'X' : ' '}] #{t["description"]}"
+        end
+        story_line + task_list.join("\n") + "\n"
+      end
+    end
+
+    private
+
+    def error_message
+      'Tasks cannot be retrieved for this branch.'
+    end
+
+    def story_line
+      "  #{@story['name']} (#{@story['url']})\n\n"
+    end
+  end
+end

data/lib/http_magic.rb

@@ -0,0 +1,260 @@
+require 'net/http'
+require 'json'
+
+# A magical class that interacts with HTTP resources with a minimal amount of
+# configuration.
+#
+# Assuming an api where the url http://www.example.com/foo/99 responds with
+# the following.
+#
+# Header:
+#
+#   Content-Type: application/json
+#
+# Body:
+#
+#   {
+#     "name": "Foo Bar"
+#   }
+#
+# == Example
+#
+#   class ExampleApi < HttpMagic
+#     url 'www.example.com'
+#   end
+#
+#   ExampleApi.foo[99].get['name']
+#   => "Foo Bar"
+#
+class HttpMagic < BasicObject
+  # Makes the new method private so that instances of this class and it's
+  # children can only be instantiated through the class method method_missing.
+  # This is needed to enforce the intended usage of HttpMagic where the class
+  # is configured to represent an http location. Once it is configured, the
+  # location is interacted with dynamically with chained methods that correspond
+  # with parts of URNs found at the location.
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #     headers({'X-AuthToken' => 'token'})
+  #   end
+  #
+  #   ExampleApi.new.uri
+  #   => "http://www.example.com/api/v1/new"
+  #
+  #   ExampleApi.foo[99].uri
+  #   => "http://www.example.com/api/v1/foo/99"
+  class << self
+    private :new
+  end
+
+  # Sets or returns the request headers for an HttpMagic based class. The
+  # headers will be passed along to each resource request being made.
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #     headers({'X-AuthToken' => 'token'})
+  #   end
+  def self.headers(value = :not_provided)
+    unless value == :not_provided
+      @headers = value
+    end
+    @headers
+  end
+
+  # Sets or returns the namespace for an HttpMagic based class. The namespace
+  # will be prefixed to the urn for each request made to the url.
+  #
+  # Assuming an api where each resource is namespaced with 'api/v1' and where
+  # the url http://www.example.com/api/v1/foo/99 responds with the following.
+  #
+  # Header:
+  #
+  #   Content-Type: application/json
+  #
+  # Body:
+  #
+  #   {
+  #     "name": "Foo Bar"
+  #   }
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #   end
+  #
+  #   ExampleApi.foo[99].get['name']
+  #   => "Foo Bar"
+  def self.namespace(value = :not_provided)
+    unless value == :not_provided
+      @namespace = value
+    end
+    @namespace
+  end
+
+  # Sets or returns the uniform resource locator for the HTTP resource.
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #   end
+  #
+  #   ExampleApi.url
+  #   => 'www.example.com'
+  def self.url(value = :not_provided)
+    unless value == :not_provided
+      @url = value
+    end
+    @url
+  end
+
+  # Class scoped method_missing that starts the magic of creating urns
+  # through meta programming by instantiating an instance of the class
+  # and delegating the first part of the urn to that instance. This method
+  # is an implementation of the Factory Method design pattern.
+  def self.method_missing(name, *args, &block)
+    new(@url, @namespace, @headers).__send__(name, *args)
+  end
+
+  def initialize(url, namespace, headers)
+    @url = url
+    @namespace = namespace
+    @headers = headers
+
+    @urn_parts = []
+  end
+
+  # Resource index reference intended to allow for the use of numbers in a urn
+  # such as the following 'foo/99' being referenced by ExampleApi.foo[99].  It
+  # can also be used to allow for HttpMagic methods to be specified for a urn
+  # such as 'foo/get' being referenced by ExampleApi.foo[:get]. Finally, it can
+  # be used for urn parts that are not valid Ruby methods such as 'foo/%5B%5D'
+  # being referenced by ExampleApi.foo["%5B%5D"].
+  #
+  # * part - a part of a urn such that 'foo' and 'bar' would be parts of the urn
+  #   'foo/bar'.
+  #
+  # Returns a reference to its instance so that urn parts can be chained
+  # together.
+  def [](part)
+    @urn_parts << part.to_s
+    self
+  end
+
+  # Gets a resource from the URI and returns it based on its content type. JSON
+  # content will be parsed and returned as equivalent Ruby objects. All other
+  # content types will be returned as text.
+  #
+  # Assuming an api where each resource is namespaced with 'api/v1' and where
+  # the url http://www.example.com/api/v1/foo/99 responds with the following.
+  #
+  # Header:
+  #
+  #   Content-Type: application/json
+  #
+  # Body:
+  #
+  #   {
+  #     "name": "Foo Bar"
+  #   }
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #   end
+  #
+  #   ExampleApi.foo[99].get
+  #   => { "name" => "Foo Bar" }
+  def get
+    http = ::Net::HTTP.new(url, 443)
+    http.use_ssl = true
+
+    response = http.request_get(urn, @headers || {})
+    if response && response.is_a?(::Net::HTTPSuccess)
+      if response.content_type == 'application/json'
+        ::JSON.parse(response.body)
+      else
+        response.body
+      end
+    else
+      nil
+    end
+  end
+
+  # Uniform resource identifier for a specified request.
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #   end
+  #
+  #   ExampleApi.foo[99].uri
+  #   => "www.example.com/api/v1/foo/99"
+  def uri
+    "#{url}#{urn}"
+  end
+
+  # Uniform resource locator for all the resources.
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #   end
+  #
+  #   ExampleApi.foo[99].url
+  #   => "www.example.com"
+  def url
+    @url
+  end
+
+  # Uniform resource name for a resource.
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #   end
+  #
+  #   ExampleApi.foo[99].urn
+  #   => "api/v1/foo/99"
+  def urn
+    resource_name = [@namespace, @urn_parts].flatten.compact.join('/')
+    "/#{resource_name}"
+  end
+
+  # Instance scoped method_missing that accumulates the URN parts used in
+  # forming the URI. It returns a reference to the current instance so that
+  # method and [] based parts can be chained together to from the URN. In the
+  # case of ExampleApi.foo[99] the 'foo' method is accumlated as a URN part
+  # that will form the resulting URI.
+  #
+  # == Example
+  #
+  #   class ExampleApi < HttpMagic
+  #     url 'www.example.com'
+  #     namespace 'api/v1'
+  #   end
+  #
+  #   ExampleApi.foo[99].uri
+  #   => "www.example.com/api/v1/foo/99"
+  def method_missing(part, *args, &block)
+    @urn_parts << part.to_s
+    self
+  end
+end

data/lib/pivotal_tracker.rb

@@ -0,0 +1,16 @@
+require 'http_magic'
+
+class PivotalTracker < HttpMagic
+  url 'www.pivotaltracker.com'
+  namespace 'services/v5'
+
+  # Specifies the PivotalTracker API token that is needed to authenticate a user
+  # to access the api.
+  #
+  # == Example
+  #
+  #   ExampleApi.api_token = 'token'
+  def self.api_token=(value)
+    headers({ 'X-TrackerToken' => value })
+  end
+end

data/test/branch_command_test.rb

@@ -0,0 +1,32 @@
+require 'test_helper'
+require 'gradesfirst/branch_command'
+
+describe GradesFirst::BranchCommand do
+  before do
+    stub_pivotal_request(
+      :get,
+      'stories/29384793',
+      body: fixture_file('story_bar.json')
+    )
+
+    stub_pivotal_request(
+      :get,
+      'stories/57348714',
+      body: fixture_file('story_foo.json')
+    )
+
+    PivotalTracker.api_token = 'test_token'
+    git_branch_output = fixture_file('git_branch.txt')
+    @command = GradesFirst::BranchCommand.new
+    @command.stub :git_branch, git_branch_output do
+      @command.execute
+    end
+  end
+
+  describe '#response' do
+    it 'should respond with Pivotal enhancements' do
+      assert_equal fixture_file('gf_branch.txt'), @command.response
+    end
+  end
+
+end

data/test/cli_test.rb

@@ -0,0 +1,53 @@
+require 'test_helper'
+require 'gradesfirst/cli'
+
+describe GradesFirst::CLI do
+  def command_not_found(command)
+    "Could not find task \"#{command}\".\n"
+  end
+
+  def executed_command_expectations(command)
+    command.any_instance.expects(:execute)
+    command.any_instance.expects(:response).returns('')
+  end
+
+  describe 'branch command' do
+    before do
+      executed_command_expectations(GradesFirst::BranchCommand)
+    end
+
+    it 'should exist' do
+      output = capture_io do
+        GradesFirst::CLI.start %w{ branch }
+      end
+      refute_includes output, command_not_found('branch')
+    end
+  end
+
+  describe 'commit-message command' do
+    before do
+      executed_command_expectations(GradesFirst::CommitMessageCommand)
+    end
+
+    it 'should exist' do
+      output = capture_io do
+        GradesFirst::CLI.start %w{ commit-message }
+      end
+      refute_includes output, command_not_found('commit-message')
+    end
+  end
+
+  describe 'task command' do
+    before do
+      executed_command_expectations(GradesFirst::TaskCommand)
+    end
+
+    it 'should exist' do
+      output = capture_io do
+        GradesFirst::CLI.start %w{ task }
+      end
+      refute_includes output, command_not_found('task')
+    end
+  end
+
+end

data/test/command_test.rb

@@ -0,0 +1,14 @@
+require 'test_helper'
+require 'gradesfirst/command'
+
+describe GradesFirst::Command do
+  describe '#story_id' do
+    it 'should pull the story id from the branch' do
+      assert '123', GradesFirst::Command.new.send(:story_id, 'abc/123')
+    end
+
+    it 'should return nil if not story id' do
+      assert_nil GradesFirst::Command.new.send(:story_id, 'abc')
+    end
+  end
+end

data/test/commit_message_command_test.rb

@@ -0,0 +1,24 @@
+require 'test_helper'
+require 'gradesfirst/commit_message_command'
+
+describe GradesFirst::CommitMessageCommand do
+  before do
+    stub_pivotal_request(
+      :get,
+      'stories/29384793',
+      body: fixture_file('story_bar.json')
+    )
+
+    PivotalTracker.api_token = 'test_token'
+  end
+
+  describe '#response' do
+    it 'should repond with formatted commit message' do
+      command = GradesFirst::CommitMessageCommand.new
+      command.stub :current_branch, 'test/29384793' do
+        command.execute
+        assert_equal fixture_file('commit_message.txt'), command.response
+      end
+    end
+  end
+end

data/test/fixtures/commit_message.txt

@@ -0,0 +1,4 @@
+[#29384793]
+
+Bring me the passengers
+http://www.pivotaltracker.com/story/show/29384793

data/test/fixtures/gf_branch.txt

@@ -0,0 +1,3 @@
+  29384793 [Started] Bring me the passengers (http://www.pivotaltracker.com/story/show/29384793)
+  anthonycrumley/57348714 [Started] This is not the droid (http://www.pivotaltracker.com/story/show/57348714)
+* master

data/test/fixtures/git_branch.txt

@@ -0,0 +1,3 @@
+  29384793
+  anthonycrumley/57348714
+* master

data/test/fixtures/projects.json

@@ -0,0 +1,66 @@
+[
+  {
+    "atom_enabled": false,
+    "version": 91975,
+    "name": "GradesFirst",
+    "velocity_averaged_over": 3,
+    "kind": "project",
+    "created_at": "2009-03-13T21:43:45Z",
+    "has_google_domain": false,
+    "point_scale_is_custom": false,
+    "current_iteration_number": 123,
+    "start_date": "2012-11-12",
+    "number_of_done_iterations_to_show": 4,
+    "updated_at": "2013-11-21T05:39:11Z",
+    "enable_incoming_emails": true,
+    "initial_velocity": 10,
+    "enable_following": true,
+    "account_id": 277647,
+    "start_time": "2009-03-16T05:00:00Z",
+    "enable_tasks": true,
+    "enable_planned_mode": true,
+    "week_start_day": "Monday",
+    "iteration_length": 2,
+    "time_zone": {
+      "kind": "time_zone",
+      "olson_name": "America/Chicago",
+      "offset": "-06:00"
+    },
+    "id": 10688,
+    "bugs_and_chores_are_estimatable": true,
+    "public": false,
+    "point_scale": "0,1,2,3,5,8"
+  },
+  {
+    "atom_enabled": false,
+    "version": 91975,
+    "name": "Technical",
+    "velocity_averaged_over": 3,
+    "kind": "project",
+    "created_at": "2009-03-13T21:43:45Z",
+    "has_google_domain": false,
+    "point_scale_is_custom": false,
+    "current_iteration_number": 123,
+    "start_date": "2012-11-12",
+    "number_of_done_iterations_to_show": 4,
+    "updated_at": "2013-11-21T05:39:11Z",
+    "enable_incoming_emails": true,
+    "initial_velocity": 10,
+    "enable_following": true,
+    "account_id": 277647,
+    "start_time": "2009-03-16T05:00:00Z",
+    "enable_tasks": true,
+    "enable_planned_mode": true,
+    "week_start_day": "Monday",
+    "iteration_length": 2,
+    "time_zone": {
+      "kind": "time_zone",
+      "olson_name": "America/Chicago",
+      "offset": "-06:00"
+    },
+    "id": 10687,
+    "bugs_and_chores_are_estimatable": true,
+    "public": false,
+    "point_scale": "0,1,2,3,5,8"
+  }
+]

data/test/fixtures/story_bar.json

@@ -0,0 +1,17 @@
+{
+  "name": "Bring me the passengers",
+  "kind": "story",
+  "description": "ignore the droids",
+  "created_at": "2013-11-12T12:00:00Z",
+  "id": 29384793,
+  "labels":
+    [
+    ],
+  "estimate": 2,
+  "project_id": 10687,
+  "current_state": "started",
+  "url": "http://www.pivotaltracker.com/story/show/29384793",
+  "story_type": "feature",
+  "requested_by_id": 101,
+  "updated_at": "2013-11-12T12:00:00Z"
+}

data/test/fixtures/story_foo.json

@@ -0,0 +1,17 @@
+{
+  "name": "This is not the droid",
+  "kind": "story",
+  "description": "you are looking for.",
+  "created_at": "2013-11-12T12:00:00Z",
+  "id": 57348714,
+  "labels":
+    [
+    ],
+  "estimate": 2,
+  "project_id": 99,
+  "current_state": "started",
+  "url": "http://www.pivotaltracker.com/story/show/57348714",
+  "story_type": "feature",
+  "requested_by_id": 101,
+  "updated_at": "2013-11-12T12:00:00Z"
+}

data/test/fixtures/tasks.json

@@ -0,0 +1,22 @@
+[
+   {
+       "kind": "task",
+       "description": "Port 0",
+       "created_at": "2013-12-03T12:00:00Z",
+       "position": 1,
+       "id": 5,
+       "complete": true,
+       "story_id": 558,
+       "updated_at": "2013-12-03T12:00:00Z"
+   },
+   {
+       "kind": "task",
+       "description": "Port 90",
+       "created_at": "2013-12-03T12:00:00Z",
+       "position": 2,
+       "id": 6,
+       "complete": false,
+       "story_id": 558,
+       "updated_at": "2013-12-03T12:00:00Z"
+   }
+]

data/test/fixtures/tasks.txt

@@ -0,0 +1,4 @@
+  Bring me the passengers (http://www.pivotaltracker.com/story/show/29384793)
+
+  [X] Port 0
+  [ ] Port 90

data/test/http_magic/get_test.rb

@@ -0,0 +1,68 @@
+require 'test_helper'
+require 'http_magic'
+
+class HttpMagicTest < HttpMagic
+end
+
+describe 'HttpMagic#get' do
+  before do
+    @url = HttpMagicTest.url 'www.example.com'
+    HttpMagicTest.namespace nil
+    HttpMagicTest.headers nil
+  end
+
+  it 'should return the root response' do
+    stub_request(:get, "https://#{@url}:443").
+      to_return(body: 'I am root!!')
+
+    assert_equal(
+      'I am root!!',
+      HttpMagicTest.get
+    )
+  end
+
+  it 'should return the named resource' do
+    stub_request(:get, "https://#{@url}:443/bar").
+      to_return(body: 'A bear walked into a bar...')
+
+    assert_equal(
+      'A bear walked into a bar...',
+      HttpMagicTest.bar.get
+    )
+  end
+
+  it 'should return the named resource' do
+    stub_request(:get,  "https://#{@url}:443/bar/84").
+      to_return(body: 'Where Everybody Knows Your Name')
+
+    assert_equal(
+      'Where Everybody Knows Your Name',
+      HttpMagicTest.bar[84].get
+    )
+  end
+
+  it 'should serialize JSON objects' do
+    stub_request(:get,  "https://#{@url}:443/bar/99").
+      to_return(
+        headers: { 'Content-Type' => 'application/json' },
+        body: fixture_file('projects.json')
+      )
+
+    assert_equal(
+      'GradesFirst',
+      HttpMagicTest.bar[99].get.first['name']
+    )
+  end
+
+  it 'should provide specified headers' do
+    stub_request(:get,  "https://#{@url}:443/bar/84").
+      with(headers: { 'X-AuthToken' => 'test_token' }).
+      to_return(body: 'Where Everybody Knows Your Name')
+
+    HttpMagicTest.headers({ 'X-AuthToken' => 'test_token' })
+    assert_equal(
+      'Where Everybody Knows Your Name',
+      HttpMagicTest.bar[84].get
+    )
+  end
+end

data/test/http_magic/uri_test.rb

@@ -0,0 +1,76 @@
+require 'test_helper'
+require 'http_magic'
+
+class HttpMagicTest < HttpMagic
+end
+
+describe 'HttpMagic#uri' do
+  before do
+    @url = HttpMagicTest.url 'www.example.com'
+    HttpMagicTest.namespace nil
+  end
+
+  it 'should make a good root uri' do
+    assert_equal(
+      "#{@url}/",
+      HttpMagicTest.uri
+    )
+  end
+
+  it 'should make a uri that begins with new' do
+    assert_equal(
+      "#{@url}/new",
+      HttpMagicTest.new.uri
+    )
+  end
+
+  it 'should make a good single part uri' do
+    assert_equal(
+      "#{@url}/foos",
+      HttpMagicTest.foos.uri
+    )
+  end
+
+  it 'should make a good uri with an index' do
+    assert_equal(
+      "#{@url}/foos/99",
+      HttpMagicTest.foos[99].uri
+    )
+  end
+
+  it 'should make a good nested uri' do
+    assert_equal(
+      "#{@url}/foos/99/bars",
+      HttpMagicTest.foos[99].bars.uri
+    )
+  end
+
+  it 'should make a uri including a keyword at the beginning' do
+    assert_equal(
+      "#{@url}/get",
+      HttpMagicTest[:get].uri
+    )
+  end
+
+  it 'should make a uri including a keyword in the middle' do
+    assert_equal(
+      "#{@url}/foo/get/bar",
+      HttpMagicTest.foo[:get].bar.uri
+    )
+  end
+
+  it 'should make a uri including a keyword at the end' do
+    assert_equal(
+      "#{@url}/foo/bar/get",
+      HttpMagicTest.foo.bar[:get].uri
+    )
+  end
+
+  it 'should make a namespaced uri' do
+    HttpMagicTest.namespace 'api/v5'
+    assert_equal(
+      "#{@url}/api/v5/foo/bar/get",
+      HttpMagicTest.foo.bar[:get].uri
+    )
+  end
+end

data/test/pivotal_tracker_test.rb

@@ -0,0 +1,46 @@
+require 'test_helper'
+require 'pivotal_tracker'
+
+describe 'PivotalTracker' do
+  it 'should make a good root uri' do
+    assert_equal(
+      'www.pivotaltracker.com/services/v5',
+      PivotalTracker.uri
+    )
+  end
+
+  it 'should make a good project list uri' do
+    assert_equal(
+      'www.pivotaltracker.com/services/v5/projects',
+      PivotalTracker.projects.uri
+    )
+  end
+
+  it 'should make a good project uri' do
+    assert_equal(
+      'www.pivotaltracker.com/services/v5/projects/99',
+      PivotalTracker.projects[99].uri
+    )
+  end
+
+  it 'should make a good iterations uri' do
+    assert_equal(
+      'www.pivotaltracker.com/services/v5/projects/99/iterations',
+      PivotalTracker.projects[99].iterations.uri
+    )
+  end
+
+  it 'should return a pivotal project' do
+    stub_pivotal_request(
+      :get,
+      'projects/99',
+      body: fixture_file('projects.json')
+    )
+
+    PivotalTracker.api_token = 'test_token'
+    assert_equal(
+      'GradesFirst',
+      PivotalTracker.projects[99].get.first['name']
+    )
+  end
+end

data/test/task_command_test.rb

@@ -0,0 +1,52 @@
+require 'test_helper'
+require 'gradesfirst/task_command'
+
+describe GradesFirst::TaskCommand do
+  before do
+    stub_pivotal_request(
+      :get,
+      'stories/29384799',
+      status: 404
+    )
+
+    stub_pivotal_request(
+      :get,
+      'stories/29384793',
+      body: fixture_file('story_bar.json')
+    )
+
+    stub_pivotal_request(
+      :get,
+      'projects/10687/stories/29384793/tasks',
+      body: fixture_file('tasks.json')
+    )
+
+    PivotalTracker.api_token = 'test_token'
+  end
+
+  describe '#response with a valid story' do
+    before do
+      @command = GradesFirst::TaskCommand.new
+      @command.stub :current_branch, '29384793' do
+        @command.execute
+      end
+    end
+
+    it 'should respond with a task list' do
+      assert_equal fixture_file('tasks.txt'), @command.response
+    end
+  end
+
+  describe '#response with an invalid story' do
+    before do
+      @command = GradesFirst::TaskCommand.new
+      @command.stub :current_branch, '29384799' do
+        @command.execute
+      end
+    end
+
+    it 'should respond with error message' do
+      assert_equal @command.send(:error_message), @command.response
+    end
+  end
+end

data/test/test_helper.rb

@@ -0,0 +1,29 @@
+$LOAD_PATH.unshift(File.expand_path('../../lib', __FILE__))
+
+require 'rubygems'
+gem 'minitest' if RUBY_VERSION > '1.9'
+require 'minitest/autorun'
+require 'webmock/minitest'
+require 'mocha/setup'
+require 'pry'
+
+# Retreive the contents of fixture files to be used in tests.  It is easier
+# to view, modify and visualize text used in tests when it is stored in files.
+# Also, it is much easier to reuse that text.
+def fixture_file(file_name)
+  File.open(File.dirname(__FILE__) + '/fixtures/' + file_name, 'rb').read
+end
+
+# Simplify and DRY up stubbing out of PivotalTracker requests.
+def stub_pivotal_request(method, urn, options)
+  default_options = {
+    headers: { 'Content-Type' => 'application/json' },
+    body: '',
+    status: 200
+  }
+
+  uri = "https://www.pivotaltracker.com:443/services/v5/#{urn}"
+  stub_request(method,  uri).
+    with(headers: { 'X-TrackerToken' => 'test_token' }).
+    to_return(default_options.merge(options))
+end

metadata

@@ -0,0 +1,112 @@
+--- !ruby/object:Gem::Specification
+name: gradesfirst
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+  prerelease: 
+platform: ruby
+authors:
+- GradesFirst
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-12-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.14.6
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.14.6
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.7.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 4.7.0
+description: This utility will help manage the various tasks developers need to do
+  on their workstation such as database updates.
+email: tech@gradesfirst.com
+executables:
+- gf
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- MIT-LICENSE
+- README.rdoc
+- Rakefile
+- bin/gf
+- gradesfirst.gemspec
+- lib/gradesfirst.rb
+- lib/gradesfirst/branch_command.rb
+- lib/gradesfirst/cli.rb
+- lib/gradesfirst/command.rb
+- lib/gradesfirst/commit_message_command.rb
+- lib/gradesfirst/task_command.rb
+- lib/http_magic.rb
+- lib/pivotal_tracker.rb
+- test/branch_command_test.rb
+- test/cli_test.rb
+- test/command_test.rb
+- test/commit_message_command_test.rb
+- test/fixtures/commit_message.txt
+- test/fixtures/gf_branch.txt
+- test/fixtures/git_branch.txt
+- test/fixtures/projects.json
+- test/fixtures/story_bar.json
+- test/fixtures/story_foo.json
+- test/fixtures/tasks.json
+- test/fixtures/tasks.txt
+- test/http_magic/get_test.rb
+- test/http_magic/uri_test.rb
+- test/pivotal_tracker_test.rb
+- test/task_command_test.rb
+- test/test_helper.rb
+homepage: http://www.gradesfirst.com
+licenses:
+- MIT
+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: 1.8.24
+signing_key: 
+specification_version: 3
+summary: GradesFirst command line utility for developers.
+test_files: []