lrd-pivotal-tracker 0.5.14

data/spec/pivotal-tracker/activity_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+
+describe PivotalTracker::Activity do
+
+  before do
+    PivotalTracker::Client.token = TOKEN
+  end
+  
+  context "without a specified project" do
+    it "should return an array of activities" do
+      PivotalTracker::Activity.all.should be_a(Array)
+      PivotalTracker::Activity.all.first.should be_a(PivotalTracker::Activity)
+    end
+  end
+
+  context "with a specified project" do
+    before do
+      @project = PivotalTracker::Project.find(PROJECT_ID)
+    end
+
+    it "should return an array of activities" do
+      @project.activities.all.should be_a(Array)
+      @project.activities.all.first.should be_a(PivotalTracker::Activity)
+    end
+
+  end
+
+  context "with a project and autopage" do
+    before do
+      PivotalTracker::Client.api_version = 4
+      @page_project = PivotalTracker::Project.find(PAGE_PROJECT_ID)
+    end
+
+    it "should be able to page through activities" do
+      @page_project.activities.all(:auto_page => true).size.should > 100
+    end
+
+    after do
+      PivotalTracker::Client.api_version = 3
+    end
+
+  end
+
+  context "with a specified occurred since date filter" do
+    it "should correctly url encode the occurred since date filter in the API call" do
+      PivotalTracker::Client.stub!(:connection).and_return connection = double("Client Connection")
+      url = "/activities?limit=100&occurred_since_date=2010/07/29%2019:13:00%20+00:00"
+      connection.should_receive(:[]).with(url).and_return double("Connection", :get => '<blah></blah>')
+      PivotalTracker::Activity.all nil, :limit => 100, :occurred_since_date => DateTime.parse("2010/7/29 19:13:00 UTC")
+    end
+  end
+
+end

data/spec/pivotal-tracker/attachment_spec.rb

@@ -0,0 +1,63 @@
+require 'spec_helper'
+require 'time'
+
+describe PivotalTracker::Attachment do
+
+  before do
+    PivotalTracker::Client.token = TOKEN
+    @project = PivotalTracker::Project.find(PROJECT_ID)
+    @story = @project.stories.find(ATTACHMENT_STORY)
+  end
+
+  context "always" do
+    it "should return an integer id" do
+      @story.attachments.first.id.should be_a(Integer)
+    end
+
+    it "should return a string for url" do
+      @story.attachments.first.url.should be_a(String)
+    end
+
+    it "should return a string for filename" do
+      @story.attachments.first.filename.should be_a(String)
+    end
+
+    it "should return a string for uploaded_by" do
+      @story.attachments.first.uploaded_by.should be_a(String)
+    end
+
+    it "should return a datetime for uploaded_at" do
+      @story.attachments.first.uploaded_at.should be_a(DateTime)
+    end
+  end
+
+  context "without description" do
+    it "should have a blank string for the description" do
+      @story.attachments.first.description.should be_a(String)
+      @story.attachments.first.description.should be_empty
+    end
+  end
+
+  context "with description" do
+    it "should have a non-blank string for the description" do
+      @story.attachments.first.description.should be_a(String)
+      @story.attachments.last.description.should_not be_empty
+    end
+  end
+
+  context "uploading" do
+
+    before do
+      @target_story = @project.stories.find(UPLOAD_STORY)
+      @orig_net_lock = FakeWeb.allow_net_connect?
+    end
+
+    it "should return an attachment object with a pending status" do
+      FakeWeb.allow_net_connect = true
+      resource = @target_story.upload_attachment(File.dirname(__FILE__) + '/../../LICENSE')
+      FakeWeb.allow_net_connect = @orig_net_lock
+      resource.should be_a(PivotalTracker::Attachment)
+      resource.status.should == 'Pending'
+    end
+  end
+end

data/spec/pivotal-tracker/client_spec.rb

@@ -0,0 +1,156 @@
+require "spec_helper"
+
+describe PivotalTracker::Client do
+
+  describe ".connection" do
+
+    context "with no existing token" do
+
+      before do
+        PivotalTracker::Client.token = nil
+      end
+
+      it "raises a NoToken exception" do
+        lambda { PivotalTracker::Client.connection }.should raise_error(PivotalTracker::Client::NoToken)
+      end
+
+      describe "after setting a new token" do
+
+        before do
+          PivotalTracker::Client.token = "anewtoken"
+        end
+
+        it "called to RestClient::Resource using the new token" do
+          RestClient::Resource.should_receive(:new).
+              with(PivotalTracker::Client.api_url, :headers => { 'X-TrackerToken' => "anewtoken", 'Content-Type' => 'application/xml' })
+
+          PivotalTracker::Client.connection
+        end
+
+        it "returned the connection for the new token" do
+          @resource = Object.new
+
+          RestClient::Resource.should_receive(:new).
+              with(PivotalTracker::Client.api_url, :headers => { 'X-TrackerToken' => "anewtoken", 'Content-Type' => 'application/xml' }).
+              and_return(@resource)
+
+          PivotalTracker::Client.connection.should == @resource
+
+          # We need to clear the connections or it causes later spec failures
+          PivotalTracker::Client.clear_connections
+        end
+
+      end
+
+    end
+
+    context "with an existing token" do
+
+      before do
+        PivotalTracker::Client.token = "abc123"
+      end
+
+      it "returned a RestClient::Resource using the token" do
+        @resource = Object.new
+
+        RestClient::Resource.should_receive(:new).
+            with(PivotalTracker::Client.api_url, :headers => { 'X-TrackerToken' => "abc123", 'Content-Type' => 'application/xml' }).
+            and_return(@resource)
+
+        PivotalTracker::Client.connection.should == @resource
+      end
+
+      describe "after setting a new token" do
+
+        before do
+          PivotalTracker::Client.token = "anewtoken"
+        end
+
+        it "called to RestClient::Resource using the new token" do
+          RestClient::Resource.should_receive(:new).
+              with(PivotalTracker::Client.api_url, :headers => { 'X-TrackerToken' => "anewtoken", 'Content-Type' => 'application/xml' })
+
+          PivotalTracker::Client.connection
+        end
+
+        it "returned the connection for the new token" do
+          @resource = Object.new
+
+          RestClient::Resource.should_receive(:new).
+              with(PivotalTracker::Client.api_url, :headers => { 'X-TrackerToken' => "anewtoken", 'Content-Type' => 'application/xml' }).
+              and_return(@resource)
+
+          PivotalTracker::Client.connection.should == @resource
+        end
+
+      end
+
+    end
+  end
+
+  describe ".tracker_host" do
+    it "returns www.pivotaltracker.com by default" do
+      PivotalTracker::Client.tracker_host.should == 'www.pivotaltracker.com'
+    end
+  end
+
+  describe ".tracker_host=" do
+    it "sets the tracker_host" do
+      tracker_host_url = 'http://some_other_tracker_tracker_host_url'
+      PivotalTracker::Client.tracker_host = tracker_host_url
+      PivotalTracker::Client.tracker_host.should == tracker_host_url
+      PivotalTracker::Client.tracker_host = nil
+    end
+  end
+
+  describe "#api_ssl_url" do
+    context "when not passed a username and password" do
+      before do
+        PivotalTracker::Client.tracker_host = nil
+        PivotalTracker::Client.use_ssl      = true
+      end
+      it "returns https://www.pivotaltracker.com/services/v3" do
+        PivotalTracker::Client.api_ssl_url.should == 'https://www.pivotaltracker.com/services/v3'
+      end
+    end
+    context "when passed a username and password" do
+      before do
+        PivotalTracker::Client.tracker_host = nil
+        PivotalTracker::Client.use_ssl      = false
+      end
+      it "returns https://USER:PASSWORD@www.pivotaltracker.com/services/v3" do
+        PivotalTracker::Client.api_ssl_url('USER', 'PASSWORD').should == 'https://USER:PASSWORD@www.pivotaltracker.com/services/v3'
+      end
+    end
+  end
+
+  describe "#api_url" do
+    context "when not passed a username and password" do
+      before do
+        PivotalTracker::Client.tracker_host = nil
+        PivotalTracker::Client.use_ssl      = true
+      end
+      it "returns https://www.pivotaltracker.com/services/v3" do
+        PivotalTracker::Client.api_ssl_url.should == 'https://www.pivotaltracker.com/services/v3'
+      end
+    end
+    context "when passed a username and password" do
+      before do
+        PivotalTracker::Client.tracker_host = nil
+        PivotalTracker::Client.use_ssl      = false
+      end
+      it "returns https://www.pivotaltracker.com/services/v3" do
+        PivotalTracker::Client.api_ssl_url('user', 'password').should == 'https://user:password@www.pivotaltracker.com/services/v3'
+      end
+    end
+  end
+
+  describe "#api_version" do
+    it "sets the api_version" do
+      PivotalTracker::Client.api_version = 4
+      PivotalTracker::Client.api_version.should == 4
+      PivotalTracker::Client.api_version = 3
+    end
+  end
+
+end

data/spec/pivotal-tracker/iteration_spec.rb

@@ -0,0 +1,76 @@
+require 'spec_helper'
+
+describe PivotalTracker::Iteration do
+  before do
+    PivotalTracker::Client.token = TOKEN
+    @project = PivotalTracker::Project.find(PAGE_PROJECT_ID)
+  end
+
+  describe ".all" do
+    before do
+      @iterations = PivotalTracker::Iteration.all(@project)
+    end
+
+    it "should return an array of Iterations for the given Project" do
+      @iterations.should be_a(Array)
+      @iterations.first.should be_a(PivotalTracker::Iteration)
+    end
+  end
+
+  describe ".current" do
+    before do
+      @iteration = PivotalTracker::Iteration.current(@project)
+    end
+
+    it "should return a single Iteration" do
+      @iteration.should be_a(PivotalTracker::Iteration)
+    end
+  end
+
+  describe ".backlog" do
+    before do
+      @iterations = PivotalTracker::Iteration.backlog(@project)
+    end
+
+    it "should return an array of Iterations for the given Project" do
+      @iterations.should be_a(Array)
+      @iterations.first.should be_a(PivotalTracker::Iteration)
+    end
+  end
+
+  describe ".done" do
+    before do
+      @iterations = PivotalTracker::Iteration.done(@project)
+    end
+
+    it "should return an array of Iterations for the given Project" do
+      @iterations.should be_a(Array)
+      @iterations.first.should be_a(PivotalTracker::Iteration)
+    end
+  end
+  
+  describe ".current_backlog" do
+    before do
+      @iterations = PivotalTracker::Iteration.current_backlog(@project)
+    end
+
+    it "should return an array of Iterations for the given Project" do
+      @iterations.should be_a(Array)
+      @iterations.first.should be_a(PivotalTracker::Iteration)
+    end
+  end
+  
+  describe ".team_strength" do
+    before do
+      @iteration = PivotalTracker::Iteration.current(@project)
+    end
+    
+    it "should return a Float" do
+      @iteration.should respond_to(:team_strength)
+      @iteration.team_strength.should be_a(Float)
+    end
+  end
+    
+
+end
+

data/spec/pivotal-tracker/membership_spec.rb

@@ -0,0 +1,21 @@
+require 'spec_helper'
+
+describe PivotalTracker::Project do
+  before do
+    PivotalTracker::Client.token = TOKEN
+    @project = PivotalTracker::Project.find(PROJECT_ID)
+  end
+
+  context ".all" do
+    it "should return an array of memberships" do
+      @project.memberships.all.should be_a(Array)
+      @project.memberships.all.first.should be_a(PivotalTracker::Membership)
+    end
+  end
+
+  context ".find" do
+    it "should return the given membership" do
+      @project.memberships.find(MEMBER).should be_a(PivotalTracker::Membership)
+    end
+  end
+end

data/spec/pivotal-tracker/note_spec.rb

@@ -0,0 +1,62 @@
+require 'spec_helper'
+
+describe PivotalTracker::Note do
+  before do
+    PivotalTracker::Client.token = TOKEN
+    @project = PivotalTracker::Project.find(PROJECT_ID)
+    @story = @project.stories.find(ATTACHMENT_STORY)
+  end
+
+  context ".all" do
+    it "should return an array of notes" do
+      @story.notes.all.should be_a(Array)
+      @story.notes.all.first.should be_a(PivotalTracker::Note)
+    end
+  end
+
+  #context ".find" do
+  #  it "should return a given task" do
+  #    @story.tasks.find(179025).should be_a(PivotalTracker::Task)
+  #  end
+  #end
+
+  context ".create" do
+    it "should return the created note" do
+      @story.notes.create(:text => 'Test note')
+    end
+  end
+
+  context ".new" do
+
+    def note_for(attrs)
+      note = @story.notes.new(attrs)
+      @note = Crack::XML.parse(note.send(:to_xml))['note']
+    end
+
+    describe "attributes that are not sent to the tracker" do
+
+      it "should include id" do
+        note_for(:id => 10)["id"].should be_nil
+      end
+
+      it "should include author" do
+        note_for(:author => "somebody")["author"].should be_nil
+      end
+
+    end
+
+    describe "attributes that are sent to the tracker" do
+
+      it "should include text" do
+        note_for(:text => "A comment...")["text"].should == "A comment..."
+      end
+
+      it "should include noted_at" do
+        note_for(:noted_at => "timestamp")["noted_at"].should == "timestamp"
+      end
+
+    end
+
+  end
+
+end

data/spec/pivotal-tracker/project_spec.rb

@@ -0,0 +1,105 @@
+require 'spec_helper'
+
+describe PivotalTracker::Project do
+  
+  before do
+    PivotalTracker::Client.token = TOKEN
+  end
+  
+  context ".all" do
+    before do
+      @projects = PivotalTracker::Project.all
+    end
+
+    it "should return an array of available projects" do
+      @projects.should be_a(Array)
+    end
+
+    it "should be a project instance" do
+      @projects.first.should be_a(PivotalTracker::Project)
+    end        
+  end
+
+  context ".find" do
+    before do
+      @project = PivotalTracker::Project.find(PROJECT_ID)
+    end
+
+    it "should be an instance of Project" do
+      @project.should be_a(PivotalTracker::Project)
+    end
+
+    it "should have a use_https attribute" do
+      @project.respond_to?(:use_https).should be_true
+    end
+
+    it "should have false for use_https" do
+      @project.use_https.should be_false
+    end
+    
+    it "should have first_iteration_start_time attribute" do
+      @project.respond_to?(:first_iteration_start_time).should be_true
+    end
+     
+    it "should have current_iteration_number attribute" do  
+      @project.respond_to?(:current_iteration_number).should be_true
+    end
+  end
+
+  context ".stories" do
+    before do
+      PivotalTracker::Client.token = TOKEN
+      @project = PivotalTracker::Project.find(PROJECT_ID)
+    end
+
+    it "should have a stories association" do
+      @project.respond_to?(:stories).should be_true
+    end
+  end
+
+  context ".memberships" do
+    before do
+      PivotalTracker::Client.token = TOKEN
+      @project = PivotalTracker::Project.find(PROJECT_ID)
+    end
+
+    it "should have a memberships association" do
+      @project.respond_to?(:memberships).should be_true
+    end
+  end
+
+  context ".create" do
+    before do
+      PivotalTracker::Client.token = TOKEN
+      @project = PivotalTracker::Project.new(:name => 'Pivotal Tracker API Gem')
+    end
+
+    it "should return the created project" do
+      @project.create
+      @project.should be_a(PivotalTracker::Project)
+      @project.name.should == 'Pivotal Tracker API Gem'
+    end
+
+    context "on failure" do
+      before do
+        FakeWeb.register_uri(:post, "#{PivotalTracker::Client.api_url}/projects",
+                             :body   => %{<?xml version="1.0" encoding="UTF-8"?>
+             <errors>
+               <error>error#1 message</error>
+               <error>error#2 message</error>
+             </errors>%},
+                             :status => "422")
+      end
+
+      it "should not raise an exception" do
+        expect { @project.create }.to_not raise_error(Exception)
+      end
+
+      it "should report errors encountered" do
+        @project.create
+        @project.errors.messages.should =~ ["error#1 message", "error#2 message"]
+      end
+    end
+  end
+
+end