pivotal-tracker 0.2.0 → 0.2.1

data/.gitignore

@@ -3,5 +3,7 @@
 coverage
 rdoc
 pkg
-
+vendor
 .bundle
+.idea
+request_test.rb

data/Gemfile

@@ -1,16 +1,15 @@
 source 'http://rubygems.org'
 
 group :runtime do
-  gem 'rest-client', '~> 1.5.1'
-  gem 'happymapper', '>= 0.2.4'
+  gem 'rest-client', '~> 1.6.0'
+  gem 'happymapper', '>= 0.3.2'
   gem 'builder'
-  gem 'nokogiri', '~> 1.4.1'
+  gem 'nokogiri', '~> 1.4.3.1'
 end
 
 group :test do
-  gem 'rspec', :require => 'spec'
+  gem 'rspec', '~> 1.3.0', :require => 'spec'
   gem 'rake'
-  gem 'bundler', '~> 0.9.5'
   gem 'jeweler'
   gem 'stale_fish', '~> 1.3.0'
 end

data/Gemfile.lock

@@ -0,0 +1,40 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (2.3.8)
+    builder (2.1.2)
+    fakeweb (1.2.8)
+    gemcutter (0.6.1)
+    git (1.2.5)
+    happymapper (0.3.2)
+      libxml-ruby (~> 1.1.3)
+    jeweler (1.4.0)
+      gemcutter (>= 0.1.0)
+      git (>= 1.2.5)
+      rubyforge (>= 2.0.0)
+    json_pure (1.4.5)
+    libxml-ruby (1.1.4)
+    mime-types (1.16)
+    nokogiri (1.4.3.1)
+    rake (0.8.7)
+    rest-client (1.6.0)
+      mime-types (>= 1.16)
+    rspec (1.3.0)
+    rubyforge (2.0.4)
+      json_pure (>= 1.1.7)
+    stale_fish (1.3.0)
+      activesupport
+      fakeweb
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  builder
+  happymapper (>= 0.3.2)
+  jeweler
+  nokogiri (~> 1.4.3.1)
+  rake
+  rest-client (~> 1.6.0)
+  rspec (~> 1.3.0)
+  stale_fish (~> 1.3.0)

data/LICENSE

@@ -1,4 +1,4 @@
-Copyright (c) 2009 Justin Smestad, Josh Nichols
+Copyright (c) 2009 Justin Smestad
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.rdoc

@@ -2,10 +2,6 @@
 
 Ruby wrapper for Pivotal Tracker API, no frameworks required. Simply Ruby.
 
-== Note
-
-Version 0.0.8 and above are incompatible with previous versions. 
-
 == Features
 
 * Compatible with Pivotal Tracker API version 3
@@ -16,26 +12,39 @@ Version 0.0.8 and above are incompatible with previous versions.
 
     PivotalTracker::Client.token('myusername@email.com', 'secretpassword')        # Automatically fetch API Token
     PivotalTracker::Client.token = 'jkfduisj97823974j2kl24899234'                 # Manually set API Token
-  
+
     @projects = PivotalTracker::Project.all                                       # return all projects
     @a_project = PivotalTracker::Project.find(84739)                              # find project with a given ID
-    
+
     @a_project.stories.all                                                        # return all stories for "a_project"
     @a_project.stories.all(:label => 'overdue', :story_type => ['bug', 'chore'])  # return all stories that match the passed filters
     @a_project.stories.find(847762630)                                            # find story with a given ID
-    
+
     @a_project.stories.create(:name => 'My Story', :story_type => 'feature')      # create a story for this project
 
+    # all tracker defined filters are allowed, as well as :limit & :offset for pagination
+
+    # The below pattern below is planned to be added to the final release:
+
+    @a_project.stories << PivotalTracker::Story.new(84739, :name => 'Ur Story')   # same as earlier story creation, useful for copying/cloning from proj
+
+
     @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
-    
+    @story.notes.create(:text => 'A new comment', :noted_at => '06/29/2010 05:00 EST')  # add a new note
 
-    # all tracker defined filters are allowed, as well as :limit & :offset for pagination
 
-    # The below are planned to be added to the final release:
+    @story.attachments                                                            # return an array of all attachment items (data only, not the files)
+    @story.upload_attachment(file_path)                                           # add a file attachment to @story that can be found at file_path
+
+
+    # All 4 examples below return a PivotalTracker::Story from the new project, with the same story ID
+
+    @story.move_to_project(123456)                                                # move @story to the project with ID 123456
+    @story.move_to_project('123456')                                              # same as above
+    @story.move_to_project(@project)                                              # move @story to @project
+    @story.move_to_project(@another_story)                                        # move @story into the same project as @another_story
 
-    @a_project.stories << PivotalTracker::Story.new(84739, :name => 'Ur Story')   # same as above, useful for copying/cloning from proj
 
 
 The API is based on the following this gist: http://gist.github.com/283120
@@ -52,14 +61,17 @@ The API is based on the following this gist: http://gist.github.com/283120
     $ cd pivotal-tracker
     $ bundle install
     $ bundle exec rake
-    
+
 == Additional Information
 
-Wiki: http://wiki.github.com/jsmestad/pivotal-tracker
-Documentation: http://rdoc.info/projects/jsmestad/pivotal-tracker
+* Wiki: http://wiki.github.com/jsmestad/pivotal-tracker
+* Documentation: http://rdoc.info/projects/jsmestad/pivotal-tracker
+* Pivotal API v3 Docs: http://www.pivotaltracker.com/help/api?version=v3
 
-== Contributers
+== Contributors along the way
 
 * Justin Smestad (http://github.com/jsmestad)
 * Josh Nichols (http://github.com/technicalpickles)
 * Terence Lee (http://github.com/hone)
+* Jon Mischo (http://github.com/supertaz)
+* Gabor Ratky (http://github.com/rgabo)

data/Rakefile

@@ -1,5 +1,4 @@
 require 'rake'
-require 'bundler'
 
 begin
   require 'jeweler'
@@ -10,11 +9,15 @@ begin
     gem.homepage = "http://github.com/jsmestad/pivotal-tracker"
     gem.authors = ["Justin Smestad", "Josh Nichols", "Terence Lee"]
 
-    bundle = Bundler::Definition.from_gemfile('Gemfile')
-    bundle.dependencies.each do |dep|
-      next unless dep.groups.include?(:runtime)
-      gem.add_dependency(dep.name, dep.requirement.to_s)
-    end
+    gem.add_dependency 'rest-client', '~> 1.6.0'
+    gem.add_dependency 'happymapper', '>= 0.3.2'
+    gem.add_dependency 'builder'
+    gem.add_dependency 'nokogiri', '~> 1.4.3.1'
+    
+    gem.add_development_dependency 'rspec'
+    gem.add_development_dependency 'bundler', '>= 0.9.26'
+    gem.add_development_dependency 'jeweler'
+    gem.add_development_dependency 'stale_fish', '~> 1.3.0'
   end
   Jeweler::GemcutterTasks.new
 rescue LoadError

data/VERSION

@@ -1 +1 @@
-0.2.0
+0.2.1

data/lib/pivotal-tracker/attachment.rb

@@ -0,0 +1,16 @@
+module PivotalTracker
+  class Attachment
+    include HappyMapper
+
+    tag 'attachment'
+
+    element :id, Integer
+    element :filename, String
+    element :description, String
+    element :uploaded_by, String
+    element :uploaded_at, DateTime
+    element :url, String
+    element :status, String
+
+  end
+end

data/lib/pivotal-tracker/project.rb

@@ -18,6 +18,7 @@ module PivotalTracker
 
     element :id, Integer
     element :name, String
+    element :account, String
     element :week_start_day, String
     element :point_scale, String
     element :week_start_day, String
@@ -26,6 +27,7 @@ module PivotalTracker
     element :initial_velocity, Integer
     element :current_velocity, Integer
     element :last_activity_at, DateTime
+    element :use_https, Boolean
 
     def activities
       @activities ||= Proxy.new(self, Activity)
@@ -43,5 +45,14 @@ module PivotalTracker
       @memberships ||= Proxy.new(self, Membership)
     end
 
+    def iteration(group)
+      case group.to_sym
+      when :done: Iteration.done(self)
+      when :current: Iteration.current(self)
+      when :backlog: Iteration.backlog(self)
+      else
+        raise ArgumentError, "Invalid group. Use :done, :current or :backlog instead."
+      end
+    end
   end
 end

data/lib/pivotal-tracker/story.rb

@@ -11,12 +11,13 @@ module PivotalTracker
       end
     end
 
-    attr_accessor :project_id
+    tag "story"
 
     element :id, Integer
-    element :url, String    
+    element :url, String
     element :created_at, DateTime
     element :accepted_at, DateTime
+    element :project_id, Integer
 
     element :name, String
     element :description, String
@@ -29,10 +30,14 @@ module PivotalTracker
     element :jira_id, Integer
     element :jira_url, String
     element :other_id, Integer
+    element :integration_id, Integer
 
-    def initialize(attributes={})
-      self.project_id = attributes.delete(:owner).id if attributes[:owner]
+    has_many :attachments, Attachment, :tag => 'attachments'
 
+    def initialize(attributes={})
+      if attributes[:owner]
+        self.project_id = attributes.delete(:owner).id
+      end
       update_attributes(attributes)
     end
 
@@ -62,8 +67,34 @@ module PivotalTracker
       @tasks ||= Proxy.new(self, Task)
     end
 
-    def project=(proj_id)
-      self.project_id = proj_id
+    def upload_attachment(filename)
+      Attachment.parse(Client.connection["/projects/#{project_id}/stories/#{id}/attachments"].post(:Filedata => File.new(filename)))
+    end
+
+    def move_to_project(new_project)
+      move = true
+      old_project_id = self.project_id
+      target_project = -1
+      case new_project.class.to_s
+        when 'PivotalTracker::Story'
+          target_project = new_project.project_id
+        when 'PivotalTracker::Project'
+          target_project = new_project.id
+        when 'String'
+          target_project = new_project.to_i
+        when 'Fixnum', 'Integer'
+          target_project = new_project
+        else
+          move = false
+      end
+      if move
+        move_builder = Nokogiri::XML::Builder.new do |story|
+          story.story {
+            story.project_id "#{target_project}"
+                  }
+        end
+        Story.parse(Client.connection["/projects/#{old_project_id}/stories/#{id}"].put(move_builder.to_xml, :content_type => 'application/xml'))
+      end
     end
 
     protected
@@ -79,10 +110,12 @@ module PivotalTracker
             xml.requested_by "#{requested_by}"
             xml.owned_by "#{owned_by}"
             xml.labels "#{labels}"
+            xml.project_id "#{project_id}"
             # See spec
             # xml.jira_id "#{jira_id}"
             # xml.jira_url "#{jira_url}"
             xml.other_id "#{other_id}"
+            xml.integration_id "#{integration_id}"
           }
         end
         return builder.to_xml

data/lib/pivotal-tracker.rb

@@ -8,6 +8,7 @@ require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'extensions')
 require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'proxy')
 require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'client')
 require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'project')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'attachment')
 require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'story')
 require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'task')
 require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'membership')

data/pivotal-tracker.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{pivotal-tracker}
-  s.version = "0.2.0"
+  s.version = "0.2.1"
 
   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-07-05}
+  s.date = %q{2010-08-07}
   s.email = %q{justin.smestad@gmail.com}
   s.extra_rdoc_files = [
     "LICENSE",
@@ -18,12 +18,14 @@ Gem::Specification.new do |s|
   s.files = [
     ".gitignore",
      "Gemfile",
+     "Gemfile.lock",
      "LICENSE",
      "README.rdoc",
      "Rakefile",
      "VERSION",
      "lib/pivotal-tracker.rb",
      "lib/pivotal-tracker/activity.rb",
+     "lib/pivotal-tracker/attachment.rb",
      "lib/pivotal-tracker/client.rb",
      "lib/pivotal-tracker/extensions.rb",
      "lib/pivotal-tracker/iteration.rb",
@@ -54,6 +56,7 @@ Gem::Specification.new do |s|
      "spec/spec_helper.rb",
      "spec/support/stale_fish_fixtures.rb",
      "spec/unit/pivotal-tracker/activity_spec.rb",
+     "spec/unit/pivotal-tracker/attachment_spec.rb",
      "spec/unit/pivotal-tracker/iteration_spec.rb",
      "spec/unit/pivotal-tracker/membership_spec.rb",
      "spec/unit/pivotal-tracker/note_spec.rb",
@@ -64,12 +67,13 @@ Gem::Specification.new do |s|
   s.homepage = %q{http://github.com/jsmestad/pivotal-tracker}
   s.rdoc_options = ["--charset=UTF-8"]
   s.require_paths = ["lib"]
-  s.rubygems_version = %q{1.3.6}
+  s.rubygems_version = %q{1.3.7}
   s.summary = %q{Ruby wrapper for the Pivotal Tracker API}
   s.test_files = [
     "spec/spec_helper.rb",
      "spec/support/stale_fish_fixtures.rb",
      "spec/unit/pivotal-tracker/activity_spec.rb",
+     "spec/unit/pivotal-tracker/attachment_spec.rb",
      "spec/unit/pivotal-tracker/iteration_spec.rb",
      "spec/unit/pivotal-tracker/membership_spec.rb",
      "spec/unit/pivotal-tracker/note_spec.rb",
@@ -82,22 +86,34 @@ Gem::Specification.new do |s|
     current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
     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.5.1"])
-      s.add_runtime_dependency(%q<happymapper>, [">= 0.2.4"])
+    if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<rest-client>, ["~> 1.6.0"])
+      s.add_runtime_dependency(%q<happymapper>, [">= 0.3.2"])
       s.add_runtime_dependency(%q<builder>, [">= 0"])
-      s.add_runtime_dependency(%q<nokogiri>, ["~> 1.4.1"])
+      s.add_runtime_dependency(%q<nokogiri>, ["~> 1.4.3.1"])
+      s.add_development_dependency(%q<rspec>, [">= 0"])
+      s.add_development_dependency(%q<bundler>, [">= 0.9.26"])
+      s.add_development_dependency(%q<jeweler>, [">= 0"])
+      s.add_development_dependency(%q<stale_fish>, ["~> 1.3.0"])
     else
-      s.add_dependency(%q<rest-client>, ["~> 1.5.1"])
-      s.add_dependency(%q<happymapper>, [">= 0.2.4"])
+      s.add_dependency(%q<rest-client>, ["~> 1.6.0"])
+      s.add_dependency(%q<happymapper>, [">= 0.3.2"])
       s.add_dependency(%q<builder>, [">= 0"])
-      s.add_dependency(%q<nokogiri>, ["~> 1.4.1"])
+      s.add_dependency(%q<nokogiri>, ["~> 1.4.3.1"])
+      s.add_dependency(%q<rspec>, [">= 0"])
+      s.add_dependency(%q<bundler>, [">= 0.9.26"])
+      s.add_dependency(%q<jeweler>, [">= 0"])
+      s.add_dependency(%q<stale_fish>, ["~> 1.3.0"])
     end
   else
-    s.add_dependency(%q<rest-client>, ["~> 1.5.1"])
-    s.add_dependency(%q<happymapper>, [">= 0.2.4"])
+    s.add_dependency(%q<rest-client>, ["~> 1.6.0"])
+    s.add_dependency(%q<happymapper>, [">= 0.3.2"])
     s.add_dependency(%q<builder>, [">= 0"])
-    s.add_dependency(%q<nokogiri>, ["~> 1.4.1"])
+    s.add_dependency(%q<nokogiri>, ["~> 1.4.3.1"])
+    s.add_dependency(%q<rspec>, [">= 0"])
+    s.add_dependency(%q<bundler>, [">= 0.9.26"])
+    s.add_dependency(%q<jeweler>, [">= 0"])
+    s.add_dependency(%q<stale_fish>, ["~> 1.3.0"])
   end
 end