westarete-tracker-tools 0.3.0

data/spec/helper.rb

@@ -0,0 +1,17 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'westarete-tracker-tools'
+
+include WestAreteTrackerTools
+
+require 'vcr_helper'

data/spec/project_spec.rb

@@ -0,0 +1,132 @@
+require 'helper'
+
+describe Project do
+  use_vcr_cassette :record => :new_episodes, :match_requests_on => [:uri, :method]
+  before do
+    @project = Project.find_by_name('westarete-tracker-tools-test')
+  end
+  describe '.all' do
+    before do
+      @projects = Project.all
+    end
+    it 'returns all active projects' do
+      @projects.length.should == 15
+      @projects.first.should respond_to(:name)
+      @projects.collect(&:name).should == [
+        'altoonabustest.com', 
+        'Background Questionnaires', 
+        'BellefonteDentistry.com', 
+        'Captcha', 
+        'centralinsgrp.com', 
+        'coolblue.com', 
+        'famfound.net', 
+        'ionmodern.com', 
+        'LifeViz', 
+        'oneononefit.com', 
+        'PAIG', 
+        'pasubway.com', 
+        'ReDi Index', 
+        'trailspace.com',
+        'westarete-tracker-tools-test'
+      ]
+    end
+  end
+  describe '.find_by_name' do
+    context 'if the name exists' do
+      it 'returns the project' do
+        @project.name.should == 'westarete-tracker-tools-test'
+      end
+    end
+    context 'if the name does not exist' do
+      before do
+        @project = Project.find_by_name('not there')
+      end
+      it 'returns nil' do
+        @project.should be_nil
+      end
+    end
+  end
+  describe "#backlog" do
+    before do
+      @stories = @project.backlog
+    end
+    it 'returns all of the stories in the backlog, including the current iteration' do
+      @stories.length.should == 17
+      @stories.each { |s| s.should be_kind_of(Story) }
+      @stories.first.name.should == 'Newly accepted feature'
+      @stories.last.name.should  == 'Release'
+    end
+  end
+  describe '#current' do
+    before do
+      @stories = @project.current
+    end
+    it 'returns all of the stories in the current iteration' do
+      @stories.collect(&:name).should == [
+        'Newly accepted feature',
+        'Rejected feature',
+        'Delivered feature',
+        'Finished feature',
+        'Started feature',
+      ]
+    end
+  end
+  describe '#done' do
+    context 'when given no arguments' do
+      before do
+        @stories = @project.done
+      end
+      it 'returns all stories that have been completed in any iteration' do
+        @stories.collect(&:name).should == [
+          'Old accepted feature',
+          'Accepted feature',
+          'Newly accepted feature',
+        ]
+      end
+    end
+    context 'when given a -2' do
+      before do
+        @stories = @project.done(-2)
+      end
+      it 'returns all stories that were completed two iterations ago' do
+        @stories.collect(&:name).should == ['Old accepted feature']
+      end
+    end
+    context 'when given a -1' do
+      before do
+        @stories = @project.done(-1)
+      end
+      it 'returns all stories that were completed in last iteration' do
+        @stories.collect(&:name).should == ['Accepted feature']
+      end
+    end
+    context 'when given a 0' do
+      before do
+        @stories = @project.done(0)
+      end
+      it 'returns all stories that have been completed during the current iteration' do
+        @stories.collect(&:name).should == ['Newly accepted feature']
+      end
+    end
+    context 'when given a 1' do
+      it 'raises an ArgumentError' do
+        lambda { @project.done(1) }.should raise_error(ArgumentError)
+      end
+    end
+  end
+  describe '#name' do
+    it "returns the project's name" do
+      @project.name.should == 'westarete-tracker-tools-test'
+    end
+  end
+  describe '#tracker_id' do
+    it "returns Pivotal Tracker's id for the project" do
+      @project.tracker_id.should == 213679
+    end
+  end
+  describe '#url' do
+    it "returns Pivotal Tracker's url for the project" do
+      @project.url.should == 'http://www.pivotaltracker.com/projects/213679'
+    end
+  end
+end

data/spec/story_spec.rb

@@ -0,0 +1,408 @@
+require 'helper'
+
+describe Story do
+  use_vcr_cassette :record => :new_episodes, :match_requests_on => [:uri, :method]
+  before do
+    @project = Project.find_by_name('westarete-tracker-tools-test')
+    @backlog = @project.backlog
+    @story = @backlog.detect { |s| s.name == 'Valid story' }
+  end
+  describe 'validations' do
+    context 'a bug' do
+      subject { @backlog.detect { |s| s.name == 'Bug' } }
+      it { should be_valid }
+    end
+    context 'a chore' do
+      subject { @backlog.detect { |s| s.name == 'Chore' } }
+      it { should be_valid }
+    end
+    context 'a feature' do
+      context 'that is valid' do
+        subject { @story }
+        it { should be_valid }
+      end
+      context 'that has no risk' do
+        before do
+          @story = @backlog.detect { |s| s.name == 'Story with no risk' }
+        end
+        it 'complains about the missing risk' do
+          @story.should_not be_valid
+          @story.errors[:risk].should include("can't be blank")
+        end
+      end
+      context 'that has no price' do
+        before do
+          @story = @backlog.detect { |s| s.name == 'Story with comments, but no price' }
+        end
+        it 'complains about the missing price' do
+          @story.should_not be_valid
+          @story.errors[:price].should include("can't be blank")
+        end
+      end
+      context 'that has no point estimate' do
+        before do
+          @story = @backlog.detect { |s| s.name == 'Story with no point estimate' }
+        end
+        it 'complains about the missing point estimate' do
+          @story.should_not be_valid
+          @story.errors[:points].should include("can't be blank")
+        end
+      end
+      context 'that has no description' do
+        before do
+          @story = @backlog.detect { |s| s.name == 'Story with no description' }
+        end
+        it 'complains about the missing description' do
+          @story.should_not be_valid
+          @story.errors[:description].should include("can't be blank")
+        end
+      end
+      context "that has a description that's too short" do
+        before do
+          @story = @backlog.detect { |s| s.name == 'Story with a description that is too short' }
+        end
+        it 'complains about the BS description' do
+          @story.should_not be_valid
+          @story.errors[:description].should include("is too short (minimum is 70 characters)")
+        end
+      end
+    end
+  end
+  context 'that is a feature' do
+    describe '#feature?' do
+      subject { @story.feature? }
+      it { should be_true }
+    end
+    describe '#bug?' do
+      subject { @story.bug? }
+      it { should be_false }
+    end
+    describe '#chore?' do
+      subject { @story.chore? }
+      it { should be_false }
+    end
+    describe '#release?' do
+      subject { @story.release? }
+      it { should be_false }
+    end
+  end
+  context 'that is a bug' do
+    before do
+      @story = @backlog.detect { |s| s.name == 'Bug' }
+    end
+    describe '#feature?' do
+      subject { @story.feature? }
+      it { should be_false }
+    end
+    describe '#bug?' do
+      subject { @story.bug? }
+      it { should be_true }
+    end
+    describe '#chore?' do
+      subject { @story.chore? }
+      it { should be_false }
+    end
+    describe '#release?' do
+      subject { @story.release? }
+      it { should be_false }
+    end
+    describe '#points' do
+      subject { @story.points }
+      it { should be_nil }
+    end
+    describe '#price' do
+      subject { @story.price }
+      it { should be_nil }
+    end
+    describe '#risk' do
+      subject { @story.risk }
+      it { should be_nil }
+    end
+  end
+  context 'that is a chore' do
+    before do
+      @story = @backlog.detect { |s| s.name == 'Chore' }
+    end
+    describe '#feature?' do
+      subject { @story.feature? }
+      it { should be_false }
+    end
+    describe '#bug?' do
+      subject { @story.bug? }
+      it { should be_false }
+    end
+    describe '#chore?' do
+      subject { @story.chore? }
+      it { should be_true }
+    end
+    describe '#release?' do
+      subject { @story.release? }
+      it { should be_false }
+    end
+    describe '#points' do
+      subject { @story.points }
+      it { should be_nil }
+    end
+    describe '#price' do
+      subject { @story.price }
+      it { should be_nil }
+    end
+    describe '#risk' do
+      subject { @story.risk }
+      it { should be_nil }
+    end
+  end
+  context 'that is a release' do
+    before do
+      @story = @backlog.detect { |s| s.name == 'Release' }
+    end
+    describe '#feature?' do
+      subject { @story.feature? }
+      it { should be_false }
+    end
+    describe '#bug?' do
+      subject { @story.bug? }
+      it { should be_false }
+    end
+    describe '#chore?' do
+      subject { @story.chore? }
+      it { should be_false }
+    end
+    describe '#release?' do
+      subject { @story.release? }
+      it { should be_true }
+    end
+    describe '#points' do
+      subject { @story.points }
+      it { should be_nil }
+    end
+    describe '#price' do
+      subject { @story.price }
+      it { should be_nil }
+    end
+    describe '#risk' do
+      subject { @story.risk }
+      it { should be_nil }
+    end
+  end
+  describe '#accepted_at' do
+    context 'for a story that is not started' do
+      subject { @story.accepted_at }
+      it { should be_nil }
+    end
+    context 'for a story that is in progress' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Started feature' }.accepted_at
+      end
+      it { should be_nil }
+    end
+    context 'for a story that is complete' do
+      before do
+        @story = @project.done.detect { |story| story.name == 'Accepted feature' }
+      end
+      it 'returns a date and time' do
+        @story.accepted_at.should be_kind_of(DateTime)
+      end
+    end
+  end
+  describe '#comments' do
+    context 'when there are comments' do
+      before do
+        @story = @project.backlog.detect { |s| s.name == 'Story with comments and two prices' }
+      end
+      it 'returns an array of note objects in chronological order' do
+        @story.comments.length.should == 2
+        @story.comments[0].noted_at.should < @story.comments[1].noted_at
+      end
+    end
+    context 'when there are no comments' do
+      before do
+        @story = @project.backlog.detect { |s| s.name == 'Story with no comments' }
+      end
+      it 'returns an empty array' do
+        @story.comments.should be_empty
+      end
+    end
+  end
+  describe '#complete?' do
+    context 'for a story that is not started' do
+      subject { @story.complete? }
+      it { should be_false }
+    end
+    context 'for a story that is in progress' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Started feature' }.complete?
+      end
+      it { should be_false }
+    end
+    context 'for a story that is complete' do
+      subject do
+        @project.done.detect { |story| story.name == 'Accepted feature' }.complete?
+      end
+      it { should be_true }
+    end
+  end
+  describe '#current_state' do
+    it 'returns a string that describes the current state' do
+      @story.current_state.should == 'unstarted'
+    end
+  end
+  describe '#description' do
+    it 'returns the description body' do
+      @story.description.should =~ /^As a /
+    end
+  end
+  describe '#finished?' do
+    context 'for a story that is not yet started' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Not yet started feature' }.finished?
+      end
+      it { should be_false }
+    end
+    context 'for a story that is started' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Started feature' }.finished?
+      end
+      it { should be_false }
+    end
+    context 'for a story that is finished' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Finished feature' }.finished?
+      end
+      it { should be_true }
+    end
+    context 'for a story that is delivered' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Delivered feature' }.finished?
+      end
+      it { should be_true }
+    end
+    context 'for a story that is rejected' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Rejected feature' }.finished?
+      end
+      it { should be_true }
+    end
+    context 'for a story that is accepted' do
+      subject do
+        @project.done.detect { |story| story.name == 'Accepted feature' }.finished?
+      end
+      it { should be_false }
+    end
+  end
+  describe '#incomplete?' do
+    context 'for a story that is not started' do
+      subject { @story.incomplete? }
+      it { should be_true }
+    end
+    context 'for a story that is in progress' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Started feature' }.incomplete?
+      end
+      it { should be_true }
+    end
+    context 'for a story that is complete' do
+      subject do
+        @project.done.detect { |story| story.name == 'Accepted feature' }.incomplete?
+      end
+      it { should be_false }
+    end
+  end
+  describe "#name" do
+    it "returns the story's name, without the risk rating" do
+      @story.name.should == 'Valid story'
+    end
+  end
+  describe '#owner' do
+    context 'when there is an owner' do
+      before do
+        @story = @project.backlog.detect { |story| story.name == 'Started feature' }
+      end
+      it "should return the owner's full name" do
+        @story.owner.should == 'Scott Woods'
+      end
+    end
+    context 'when there is no owner' do
+      subject do
+        @project.backlog.detect { |story| story.name == 'Not yet started feature' }.owner
+      end
+      it { should be_nil }
+    end
+  end
+  describe '#points' do
+    context 'if the story has been estimated' do
+      it 'returns the point estimate for the story' do
+        @story.points.should == 2
+      end
+    end
+    context 'if the story has not been estimated' do
+      before do
+        @story = @backlog.detect { |s| s.name == 'Story with no point estimate' }
+      end
+      it 'returns nil' do
+        @story.points.should be_nil
+      end
+    end
+  end
+  describe '#price' do
+    context 'when there are no comments' do
+      before do
+        @story = @backlog.detect { |s| s.name == 'Story with no comments' }
+      end
+      it 'returns nil' do
+        @story.price.should be_nil
+      end
+    end
+    context 'when there are comments, but none mention cost or price' do
+      before do
+        @story = @backlog.detect { |s| s.name == 'Story with comments, but no price' }
+      end
+      it 'returns nil' do
+        @story.price.should be_nil
+      end
+    end
+    context 'when there are multiple comments that mention price' do
+      before do
+        @story = @backlog.detect { |s| s.name == 'Story with comments and two prices' }
+      end
+      it 'uses the most recent comment by Scott Woods' do
+        @story.price.should == 100
+      end
+    end
+  end
+  describe "#requester" do
+    it "returns the requester's name" do
+      @story.requester.should == 'Scott Woods'
+    end
+  end
+  describe '#risk' do
+    context 'if a risk is present' do
+      it 'returns the risk rating for the story' do
+        @story.risk.should == 'R'
+      end
+    end
+    context 'if no risk is present' do
+      before do
+        @story = @backlog.detect { |s| s.name == 'Story with no risk' }
+      end
+      it 'returns nil' do
+        @story.risk.should be_nil
+      end
+    end
+  end
+  describe '#story_type' do
+    it 'returns a string of the story type' do
+      @story.story_type.should == 'feature'
+    end
+  end
+  describe '#tracker_id' do
+    it "returns Pivotal Tracker's id for the story" do
+      @story.tracker_id.should == 9072189
+    end
+  end
+  describe '#url' do
+    it 'returns the URL for the story' do
+      @story.url.should == 'http://www.pivotaltracker.com/story/show/9072189'
+    end
+  end
+end