pivotal-tracker 0.1.3 → 0.2.0

data/Gemfile

@@ -1,7 +1,7 @@
 source 'http://rubygems.org'
 
 group :runtime do
-  gem 'rest-client', '~> 1.4.1'
+  gem 'rest-client', '~> 1.5.1'
   gem 'happymapper', '>= 0.2.4'
   gem 'builder'
   gem 'nokogiri', '~> 1.4.1'

data/README.rdoc

@@ -26,6 +26,11 @@ Version 0.0.8 and above are incompatible with previous versions.
     
     @a_project.stories.create(:name => 'My Story', :story_type => 'feature')      # create a story for this project
 
+    @story = @a_project.stories.find(847762630)
+    @story.notes.all                                                              # return all notes (comments) for a story
+    @story.notes.create(:text => 'A new coment', :noted_at => '06/29/2010 05:00 EST')  # add a new story
+    
+
     # all tracker defined filters are allowed, as well as :limit & :offset for pagination
 
     # The below are planned to be added to the final release:

data/VERSION

@@ -1 +1 @@
-0.1.3
+0.2.0

data/lib/pivotal-tracker/note.rb

@@ -3,15 +3,56 @@ module PivotalTracker
     include HappyMapper
 
     class << self
-#      def all(story, options={})
-#        parse(Client.connection["/projects/#{project_id}/stories/#{story_id}/notes"].get)
-#      end
+      def all(story, options={})
+        notes = parse(Client.connection["/projects/#{story.project_id}/stories/#{story.id}/notes"].get)
+        notes.each { |n| n.project_id, n.story_id = story.project_id, story.id }
+        return notes
+      end
     end
 
+    attr_accessor :project_id, :story_id
+
     element :id, Integer
     element :text, String
     element :author, String
     element :noted_at, DateTime
-    # has_one :story, Story
+    has_one :story, Story
+
+    def initialize(attributes={})
+      if attributes[:owner]
+        self.story = attributes.delete(:owner) 
+        self.project_id = self.story.project_id
+        self.story_id = self.story.id
+      end
+
+      update_attributes(attributes)
+    end
+    
+    def create
+      response = Client.connection["/projects/#{project_id}/stories/#{story_id}/notes"].post(self.to_xml, :content_type => 'application/xml')
+      return Note.parse(response)
+    end
+
+    # Pivotal Tracker API doesn't seem to support updating or deleting notes at this time.
+
+    protected
+
+      def to_xml
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.note {
+            #xml.author "#{author}"
+            xml.text_ "#{text}"
+            xml.noted_at "#{noted_at}"
+          }
+        end
+        return builder.to_xml
+      end
+
+      def update_attributes(attrs)
+        attrs.each do |key, value|
+          self.send("#{key}=", value.is_a?(Array) ? value.join(',') : value )
+        end
+      end
+      
   end
 end

data/lib/pivotal-tracker/story.rb

@@ -39,7 +39,9 @@ module PivotalTracker
     def create
       return self if project_id.nil?
       response = Client.connection["/projects/#{project_id}/stories"].post(self.to_xml, :content_type => 'application/xml')
-      return Story.parse(response)
+      new_story = Story.parse(response)
+      new_story.project_id = project_id
+      return new_story
     end
 
     def update(attrs={})
@@ -52,6 +54,10 @@ module PivotalTracker
       Client.connection["/projects/#{project_id}/stories/#{id}"].delete
     end
 
+    def notes
+      @notes ||= Proxy.new(self, Note)
+    end
+
     def tasks
       @tasks ||= Proxy.new(self, Task)
     end

data/pivotal-tracker.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{pivotal-tracker}
-  s.version = "0.1.3"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Justin Smestad", "Josh Nichols", "Terence Lee"]
-  s.date = %q{2010-05-09}
+  s.date = %q{2010-07-05}
   s.email = %q{justin.smestad@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
@@ -36,12 +36,14 @@ Gem::Specification.new do |s|
      "lib/pivotal_tracker.rb",
      "pivotal-tracker.gemspec",
      "spec/fixtures/activity.xml",
+     "spec/fixtures/created_note.xml",
      "spec/fixtures/created_story.xml",
      "spec/fixtures/iterations_all.xml",
      "spec/fixtures/iterations_backlog.xml",
      "spec/fixtures/iterations_current.xml",
      "spec/fixtures/iterations_done.xml",
      "spec/fixtures/memberships.xml",
+     "spec/fixtures/notes.xml",
      "spec/fixtures/project.xml",
      "spec/fixtures/project_activity.xml",
      "spec/fixtures/projects.xml",
@@ -54,6 +56,7 @@ Gem::Specification.new do |s|
      "spec/unit/pivotal-tracker/activity_spec.rb",
      "spec/unit/pivotal-tracker/iteration_spec.rb",
      "spec/unit/pivotal-tracker/membership_spec.rb",
+     "spec/unit/pivotal-tracker/note_spec.rb",
      "spec/unit/pivotal-tracker/project_spec.rb",
      "spec/unit/pivotal-tracker/story_spec.rb",
      "spec/unit/pivotal-tracker/task_spec.rb"
@@ -69,6 +72,7 @@ Gem::Specification.new do |s|
      "spec/unit/pivotal-tracker/activity_spec.rb",
      "spec/unit/pivotal-tracker/iteration_spec.rb",
      "spec/unit/pivotal-tracker/membership_spec.rb",
+     "spec/unit/pivotal-tracker/note_spec.rb",
      "spec/unit/pivotal-tracker/project_spec.rb",
      "spec/unit/pivotal-tracker/story_spec.rb",
      "spec/unit/pivotal-tracker/task_spec.rb"
@@ -79,18 +83,18 @@ Gem::Specification.new do |s|
     s.specification_version = 3
 
     if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
-      s.add_runtime_dependency(%q<rest-client>, ["~> 1.4.1"])
+      s.add_runtime_dependency(%q<rest-client>, ["~> 1.5.1"])
       s.add_runtime_dependency(%q<happymapper>, [">= 0.2.4"])
       s.add_runtime_dependency(%q<builder>, [">= 0"])
       s.add_runtime_dependency(%q<nokogiri>, ["~> 1.4.1"])
     else
-      s.add_dependency(%q<rest-client>, ["~> 1.4.1"])
+      s.add_dependency(%q<rest-client>, ["~> 1.5.1"])
       s.add_dependency(%q<happymapper>, [">= 0.2.4"])
       s.add_dependency(%q<builder>, [">= 0"])
       s.add_dependency(%q<nokogiri>, ["~> 1.4.1"])
     end
   else
-    s.add_dependency(%q<rest-client>, ["~> 1.4.1"])
+    s.add_dependency(%q<rest-client>, ["~> 1.5.1"])
     s.add_dependency(%q<happymapper>, [">= 0.2.4"])
     s.add_dependency(%q<builder>, [">= 0"])
     s.add_dependency(%q<nokogiri>, ["~> 1.4.1"])

data/spec/fixtures/created_note.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<story>
+  <id type="integer">4097942</id>
+  <project_id type="integer">59022</project_id>
+  <story_type>feature</story_type>
+  <url>http://www.pivotaltracker.com/story/show/4097942</url>
+  <estimate type="integer">-1</estimate>
+  <current_state>unscheduled</current_state>
+  <description></description>
+  <name>Create stuff</name>
+  <requested_by>Leon Miller-Out</requested_by>
+  <created_at type="datetime">2010/06/30 03:02:32 UTC</created_at>
+  <updated_at type="datetime">2010/06/30 03:02:33 UTC</updated_at>
+</story>

data/spec/fixtures/notes.xml

@@ -0,0 +1,17 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<notes type="array">
+  <note>
+    <id type="integer">1922689</id>
+    <text>This is comment 1</text>
+    <author>Leon Miller-Out</author>
+    <noted_at type="datetime">2010/06/30 03:01:59 UTC</noted_at>
+  </note>
+  <note>
+    <id type="integer">1922690</id>
+    <text>This is comment 2.
+
+It has some line breaks in it.</text>
+    <author>Leon Miller-Out</author>
+    <noted_at type="datetime">2010/06/30 03:02:03 UTC</noted_at>
+  </note>
+</notes>

data/spec/fixtures/stale_fish.yml

@@ -6,81 +6,95 @@
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/memberships
       request_type: GET
       update_method: StaleFishFixtures.update_memberships_fixture
-      last_updated_at: 2010-04-28T16:08:18-06:00
+      last_updated_at: 2010-06-29T23:02:18-04:00
   - projects:
       file: 'projects.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects
       request_type: GET
       update_method: StaleFishFixtures.update_projects_fixture
-      last_updated_at: 2010-04-28T16:08:19-06:00
+      last_updated_at: 2010-06-29T23:02:20-04:00
   - tasks:
       file: 'tasks.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/stories/2606200/tasks
       request_type: GET
       update_method: StaleFishFixtures.update_tasks_fixture
-      last_updated_at: 2010-04-28T16:08:19-06:00
+      last_updated_at: 2010-06-29T23:02:25-04:00
   - project:
       file: 'project.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022
       request_type: GET
       update_method: StaleFishFixtures.update_project_fixture
-      last_updated_at: 2010-04-28T16:08:19-06:00
+      last_updated_at: 2010-06-29T23:02:26-04:00
   - activity:
       file: 'activity.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/activities
       request_type: GET
       update_method: StaleFishFixtures.update_activity_fixture
-      last_updated_at: 2010-04-28T16:09:01-06:00
+      last_updated_at: 2010-06-29T23:02:26-04:00
   - stories:
       file: 'stories.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/stories
       request_type: GET
       update_method: StaleFishFixtures.update_stories_fixture
-      last_updated_at: 2010-04-28T16:09:02-06:00
+      last_updated_at: 2010-06-29T23:02:28-04:00
   - project_activity:
       file: 'project_activity.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/activities
       request_type: GET
       update_method: StaleFishFixtures.update_project_activity_fixture
-      last_updated_at: 2010-04-28T16:09:02-06:00
+      last_updated_at: 2010-06-29T23:02:29-04:00
   - create_story:
       file: 'created_story.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/stories
       request_type: POST
       update_method: StaleFishFixtures.create_new_story
-      last_updated_at: 2010-04-28T16:09:03-06:00
+      last_updated_at: 2010-06-29T23:02:29-04:00
   - iterations_current:
       file: 'iterations_current.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/iterations/current
       request_type: GET
       update_method: StaleFishFixtures.update_iterations_current_fixture
-      last_updated_at: 2010-04-28T16:09:06-06:00
+      last_updated_at: 2010-06-29T23:02:30-04:00
   - iterations_done:
       file: 'iterations_done.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/iterations/done
       request_type: GET
       update_method: StaleFishFixtures.update_iterations_done_fixture
-      last_updated_at: 2010-04-28T16:17:45-06:00
+      last_updated_at: 2010-06-29T23:02:30-04:00
   - iterations_backlog:
       file: 'iterations_backlog.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/iterations/backlog
       request_type: GET
       update_method: StaleFishFixtures.update_iterations_backlog_fixture
-      last_updated_at: 2010-04-28T16:17:45-06:00
+      last_updated_at: 2010-06-29T23:02:31-04:00
   - iterations_all:
       file: 'iterations_all.xml'
       update_interval: 2.weeks
       check_against: http://www.pivotaltracker.com/services/v3/projects/59022/iterations
       request_type: GET
       update_method: StaleFishFixtures.update_iterations_all_fixture
-      last_updated_at: 2010-04-28T16:15:31-06:00
+      last_updated_at: 2010-06-29T23:02:31-04:00
+  - notes:
+      file: 'notes.xml'
+      update_interval: 2.weeks
+      check_against: http://www.pivotaltracker.com/services/v3/projects/59022/stories/2524689/notes
+      request_type: GET
+      update_method: StaleFishFixtures.update_notes_fixture
+      last_updated_at: 2010-06-29T23:02:31-04:00
+  - create_note:
+      file: 'created_note.xml'
+      update_interval: 2.weeks
+      check_against: http://www.pivotaltracker.com/services/v3/projects/59022/stories/2524689/notes
+      request_type: POST
+      update_method: StaleFishFixtures.create_new_story
+      last_updated_at: 2010-06-29T23:02:32-04:00

data/spec/support/stale_fish_fixtures.rb

@@ -48,6 +48,10 @@ module StaleFishFixtures
     def create_new_story
       connection["/projects/59022/stories"].post("<story><name>Create stuff</name></story>", :content_type => 'application/xml')
     end
+    
+    def update_notes_fixture
+      connection["/projects/59022/stories/2524689/notes"].get
+    end
 
     protected
 

data/spec/unit/pivotal-tracker/note_spec.rb

@@ -0,0 +1,61 @@
+require File.join(File.dirname(__FILE__), '..', '..', 'spec_helper')
+
+describe PivotalTracker::Note do
+  before do
+    @project = PivotalTracker::Project.find(59022)
+    @story = @project.stories.find(2524689)
+  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 = Hash.from_xml(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/unit/pivotal-tracker/task_spec.rb

@@ -3,7 +3,7 @@ require File.join(File.dirname(__FILE__), '..', '..', 'spec_helper')
 describe PivotalTracker::Task do
   before do
     @project = PivotalTracker::Project.find(59022)
-    @story = @project.stories.all.first
+    @story = @project.stories.find(2606200)
   end
 
   context ".all" do

metadata

@@ -4,9 +4,9 @@ version: !ruby/object:Gem::Version
   prerelease: false
   segments: 
   - 0
-  - 1
-  - 3
-  version: 0.1.3
+  - 2
+  - 0
+  version: 0.2.0
 platform: ruby
 authors: 
 - Justin Smestad
@@ -16,7 +16,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-09 00:00:00 -06:00
+date: 2010-07-05 00:00:00 -06:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -28,9 +28,9 @@ dependencies:
       - !ruby/object:Gem::Version 
         segments: 
         - 1
-        - 4
+        - 5
         - 1
-        version: 1.4.1
+        version: 1.5.1
   requirement: *id001
   prerelease: false
 - !ruby/object:Gem::Dependency 
@@ -103,12 +103,14 @@ files:
 - lib/pivotal_tracker.rb
 - pivotal-tracker.gemspec
 - spec/fixtures/activity.xml
+- spec/fixtures/created_note.xml
 - spec/fixtures/created_story.xml
 - spec/fixtures/iterations_all.xml
 - spec/fixtures/iterations_backlog.xml
 - spec/fixtures/iterations_current.xml
 - spec/fixtures/iterations_done.xml
 - spec/fixtures/memberships.xml
+- spec/fixtures/notes.xml
 - spec/fixtures/project.xml
 - spec/fixtures/project_activity.xml
 - spec/fixtures/projects.xml
@@ -121,6 +123,7 @@ files:
 - spec/unit/pivotal-tracker/activity_spec.rb
 - spec/unit/pivotal-tracker/iteration_spec.rb
 - spec/unit/pivotal-tracker/membership_spec.rb
+- spec/unit/pivotal-tracker/note_spec.rb
 - spec/unit/pivotal-tracker/project_spec.rb
 - spec/unit/pivotal-tracker/story_spec.rb
 - spec/unit/pivotal-tracker/task_spec.rb
@@ -160,6 +163,7 @@ test_files:
 - spec/unit/pivotal-tracker/activity_spec.rb
 - spec/unit/pivotal-tracker/iteration_spec.rb
 - spec/unit/pivotal-tracker/membership_spec.rb
+- spec/unit/pivotal-tracker/note_spec.rb
 - spec/unit/pivotal-tracker/project_spec.rb
 - spec/unit/pivotal-tracker/story_spec.rb
 - spec/unit/pivotal-tracker/task_spec.rb