pivotal-tracker-fox 0.5.10

data/lib/pivotal-tracker/iteration.rb

@@ -0,0 +1,40 @@
+module PivotalTracker
+  class Iteration
+    include HappyMapper
+
+    class << self
+      def all(project, options={})
+        params = PivotalTracker.encode_options(options)
+        parse(Client.connection["/projects/#{project.id}/iterations#{params}"].get)
+      end
+      
+      def current(project)
+        array = parse(Client.connection["projects/#{project.id}/iterations/current"].get)
+        array.first if array
+      end
+
+      def done(project, options={})
+        params = PivotalTracker.encode_options(options)
+        parse(Client.connection["/projects/#{project.id}/iterations/done#{params}"].get)
+      end
+
+      def backlog(project, options={})
+        params = PivotalTracker.encode_options(options)
+        parse(Client.connection["/projects/#{project.id}/iterations/backlog#{params}"].get)
+      end
+      
+      def current_backlog(project, options={})
+        params = PivotalTracker.encode_options(options)
+        parse(Client.connection["/projects/#{project.id}/iterations/current_backlog#{params}"].get)
+      end      
+    end
+    
+    element :id, Integer
+    element :number, Integer
+    element :start, DateTime
+    element :finish, DateTime
+    element :team_strength, Float
+    has_many :stories, Story
+
+  end
+end

data/lib/pivotal-tracker/membership.rb

@@ -0,0 +1,20 @@
+module PivotalTracker
+  class Membership
+    include HappyMapper
+
+    class << self
+      def all(project, options={})
+        parse(Client.connection["/projects/#{project.id}/memberships"].get)
+      end
+    end
+
+    element :id, Integer
+    element :role, String
+
+    # Flattened Attributes from <person>...</person>
+    element :name, String, :deep => true
+    element :email, String, :deep => true
+    element :initials, String, :deep => true
+
+  end
+end

data/lib/pivotal-tracker/note.rb

@@ -0,0 +1,58 @@
+module PivotalTracker
+  class Note
+    include HappyMapper
+
+    class << self
+      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
+
+    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/project.rb

@@ -0,0 +1,94 @@
+module PivotalTracker
+  class Project
+    include HappyMapper
+
+    class << self
+      def all
+        @found = parse(Client.connection['/projects'].get)
+      end
+
+      def find(id)
+        if @found
+          @found.detect { |document| document.id == id }
+        else
+          parse(Client.connection["/projects/#{id}"].get)
+        end
+      end
+    end
+
+    element :id, Integer
+    element :name, String
+    element :account, String
+    element :week_start_day, String
+    element :point_scale, String
+    element :labels, String
+    element :velocity_scheme, String
+    element :iteration_length, Integer
+    element :initial_velocity, Integer
+    element :current_velocity, Integer
+    element :last_activity_at, DateTime
+    element :use_https, Boolean
+    element :first_iteration_start_time, DateTime
+    element :current_iteration_number, Integer
+
+    def initialize(attributes={})
+      update_attributes(attributes)
+    end
+
+    def create
+      response = Client.connection["/projects"].post(self.to_xml, :content_type => 'application/xml')
+      project = Project.parse(response)
+      return project
+    end
+
+    def activities
+      @activities ||= Proxy.new(self, Activity)
+    end
+
+    def iterations
+      @iterations ||= Proxy.new(self, Iteration)
+    end
+
+    def stories
+      @stories ||= Proxy.new(self, Story)
+    end
+
+    def memberships
+      @memberships ||= Proxy.new(self, Membership)
+    end
+
+    def iteration(group)
+      case group.to_sym
+      when :done then Iteration.done(self)
+      when :current then Iteration.current(self)
+      when :backlog then Iteration.backlog(self)
+      when :current_backlog then Iteration.current_backlog(self)
+      else
+        raise ArgumentError, "Invalid group. Use :done, :current, :backlog or :current_backlog instead."
+      end
+    end
+
+    protected
+
+      def to_xml
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.project {
+            xml.name "#{name}"
+            xml.iteration_length.integer "#{iteration_length}" unless iteration_length.nil?
+            xml.point_scale "#{point_scale}" unless point_scale.nil?
+          }
+        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
+  class Project
+    include Validation
+  end
+end

data/lib/pivotal-tracker/proxy.rb

@@ -0,0 +1,64 @@
+class BasicObject #:nodoc:
+  instance_methods.each { |m| undef_method m unless m =~ /(^__|^nil\?$|^send$|instance_eval|proxy_|^object_id$)/ }
+end unless defined?(BasicObject)
+
+module PivotalTracker
+  class Proxy < BasicObject
+
+    def initialize(owner, target)
+      @owner = owner
+      @target = target
+      @opts = {}
+    end
+
+    def all(options={})
+      proxy_found(options)
+    end
+
+    def find(param, options={})
+      return all(options) if param == :all
+      return @target.find(param, @owner.id) if @target.respond_to?("find")
+      return proxy_found(options).detect { |document| document.id == param }
+    end
+
+    def <<(*objects)
+      objects.flatten.each do |object|
+        if obj = object.create
+          return obj
+        else
+          return object
+        end
+      end
+    end
+
+    def create(args = {})
+      object = @target.new(args.merge({:owner => @owner}))
+      if obj = object.create
+        return obj
+      else
+        return object
+      end
+    end
+
+    protected
+
+      def proxy_found(options)
+        if @found.nil? or @opts != options
+          @opts = options
+          @found = load_found()
+        end
+        @found
+      end
+
+    private
+
+      def method_missing(method, *args, &block)
+        @target.send(method, *args, &block)
+      end
+
+      def load_found()
+        @target.all(@owner, @opts)
+      end
+
+  end
+end

data/lib/pivotal-tracker/story.rb

@@ -0,0 +1,157 @@
+module PivotalTracker
+  class Story
+    include HappyMapper
+
+    class << self
+      def all(project, options={})
+        params = PivotalTracker.encode_options(options)
+        stories = parse(Client.connection["/projects/#{project.id}/stories#{params}"].get)
+        stories.each { |s| s.project_id = project.id }
+        return stories
+      end
+
+      def find(param, project_id)
+        begin
+          story = parse(Client.connection["/projects/#{project_id}/stories/#{param}"].get)
+          story.project_id = project_id
+        rescue RestClient::ExceptionWithResponse
+          story = nil
+        end
+        return story
+      end
+      
+      def parse_stories(xml_string)
+        parse(xml_string)
+      end
+    end
+
+    tag "story"
+
+    element :id, Integer
+    element :url, String
+    element :created_at, DateTime
+    element :accepted_at, DateTime
+    element :project_id, Integer
+
+    element :name, String
+    element :description, String
+    element :story_type, String
+    element :estimate, Integer
+    element :current_state, String
+    element :requested_by, String
+    element :owned_by, String
+    element :labels, String
+    element :jira_id, Integer
+    element :jira_url, String
+    element :other_id, String
+    element :integration_id, Integer
+    element :deadline, DateTime # Only available for Release stories
+
+    has_many :attachments, Attachment, :tag => 'attachments', :xpath => '//attachments'
+
+    def initialize(attributes={})
+      if attributes[:owner]
+        self.project_id = attributes.delete(:owner).id
+      end
+      update_attributes(attributes)
+    end
+
+    def create
+      return self if project_id.nil?
+      response = Client.connection["/projects/#{project_id}/stories"].post(self.to_xml, :content_type => 'application/xml')
+      new_story = Story.parse(response)
+      new_story.project_id = project_id
+      return new_story
+    end
+
+    def update(attrs={})
+      update_attributes(attrs)
+      response = Client.connection["/projects/#{project_id}/stories/#{id}"].put(self.to_xml, :content_type => 'application/xml')
+      return Story.parse(response)
+    end
+    
+    def move(position, story)
+      raise ArgumentError, "Can only move :before or :after" unless [:before, :after].include? position
+      Story.parse(Client.connection["/projects/#{project_id}/stories/#{id}/moves?move\[move\]=#{position}&move\[target\]=#{story.id}"].post(''))
+    end
+
+    def delete
+      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
+
+    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
+
+      def to_xml
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.story {
+            xml.name "#{name}"
+            xml.description "#{description}"
+            xml.story_type "#{story_type}"
+            xml.estimate "#{estimate}"
+            xml.current_state "#{current_state}"
+            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}" if other_id
+            xml.integration_id "#{integration_id}" if integration_id
+            xml.created_at DateTime.parse(created_at.to_s).to_s if created_at
+            xml.accepted_at DateTime.parse(accepted_at.to_s).to_s if accepted_at
+            xml.deadline DateTime.parse(deadline.to_s).to_s if deadline
+          }
+        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
+
+  class Story
+    include Validation
+  end
+end

data/lib/pivotal-tracker/task.rb

@@ -0,0 +1,71 @@
+module PivotalTracker
+  class Task
+    include HappyMapper
+
+    class << self
+      def all(story, options={})
+        tasks = parse(Client.connection["/projects/#{story.project_id}/stories/#{story.id}/tasks"].get)
+        tasks.each { |t| t.project_id, t.story_id = story.project_id, story.id }
+        return tasks
+      end
+    end
+
+    attr_accessor :project_id, :story_id
+
+    element :id, Integer
+    element :description, String
+    element :position, Integer
+    element :complete, Boolean
+    element :created_at, DateTime
+    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}/tasks"].post(self.to_xml, :content_type => 'application/xml')
+      return Task.parse(response)
+    end
+
+    def update(attr = {})
+      update_attributes(attr)
+      response = Client.connection["/projects/#{project_id}/stories/#{story_id}/tasks/#{id}"].put(self.to_xml, :content_type => 'application/xml')
+      return Task.parse(response)
+    end
+
+    def delete
+      Client.connection["/projects/#{project_id}/stories/#{story_id}/tasks/#{id}"].delete
+    end
+
+    protected
+
+      def to_xml
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.task {
+            xml.description "#{description}"
+            # xml.position "#{position}"
+            xml.complete "#{complete}"
+          }
+        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
+
+  class Task
+    include Validation
+  end
+end