pivotal-tracker 0.0.9.1

data/.gitignore

@@ -0,0 +1,7 @@
+*.sw?
+.DS_Store
+coverage
+rdoc
+pkg
+
+.bundle

data/Gemfile

@@ -0,0 +1,16 @@
+source :gemcutter
+
+group :runtime do
+  gem 'rest-client', '~> 1.4.1'
+  gem 'happymapper', '>= 0.2.4'
+  gem 'builder'
+  gem 'nokogiri', '~> 1.4.1'
+end
+
+group :test do
+  gem 'rspec', :require => 'spec'
+  gem 'rake'
+  gem 'bundler', '~> 0.9.5'
+  gem 'jeweler'
+  gem 'stale_fish', '~> 1.3.0'
+end

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Justin Smestad, Josh Nichols
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.rdoc

@@ -0,0 +1,60 @@
+= pivotal-tracker.rb
+
+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
+* ActiveRecord-style Wrapper API
+* Support for SSL protected repositories
+
+== Overview
+
+    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 are planned to be added to the final release:
+
+    @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
+
+== Getting Started
+
+* Installing:
+
+    $ gem install pivotal-tracker
+
+* Contributing (requires Bundler >= 0.9.7):
+
+    $ git clone git://github.com/jsmestad/pivotal-tracker
+    $ 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
+
+== Contributers
+
+* Justin Smestad (http://github.com/jsmestad)
+* Josh Nichols (http://github.com/technicalpickles)
+* Terence Lee (http://github.com/hone)

data/Rakefile

@@ -0,0 +1,46 @@
+require 'rake'
+require 'bundler'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "pivotal-tracker"
+    gem.summary = %Q{Ruby wrapper for the Pivotal Tracker API}
+    gem.email = "justin.smestad@gmail.com"
+    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
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :default => :spec
+
+begin
+  require 'yard'
+  YARD::Rake::YardocTask.new
+rescue LoadError
+  task :yardoc do
+    abort "YARD is not available. In order to run yardoc, you must: sudo gem install yard"
+  end
+end
+

data/VERSION

@@ -0,0 +1 @@
+0.0.9.1

data/lib/pivotal-tracker/activity.rb

@@ -0,0 +1,45 @@
+module PivotalTracker
+  class Activity
+    include HappyMapper
+    class << self
+      def all(project=nil, options={})
+        params = self.encode_options(options)
+        if project
+          parse(Client.connection["/projects/#{project.id}/activities#{params}"].get)
+        else
+          parse(Client.connection["/activities#{params}"].get)
+        end
+      end
+
+      protected
+
+        def encode_options(options)
+          return nil if !options.is_a?(Hash) || options.empty?
+
+          options_string = []
+          options_string << "limit=#{options.delete(:limit)}" if options[:limit]
+          options_string << "newer_than_version=#{options.delete(:newer_than_version)}" if options[:newer_than_version]
+
+          if options[:occurred_since]
+            options_string << "occurred_since_date=#{options[:occurred_since].utc}"
+          elsif options[:occurred_since_date]
+            options_string << "occurred_since_date=#{options[:occurred_since]}"
+          end
+
+          return "?#{options_string.join('&')}"
+        end
+
+    end
+
+    element :id, Integer
+    element :version, Integer
+    element :event_type, String
+    element :occurred_at, DateTime
+    element :author, String
+    element :project_id, Integer
+    element :description, String
+
+    has_many :stories, Story
+
+  end
+end

data/lib/pivotal-tracker/client.rb

@@ -0,0 +1,34 @@
+module PivotalTracker
+  class Client
+
+    class << self
+      attr_writer :use_ssl, :token
+
+      def use_ssl
+        @use_ssl || false
+      end
+
+      def token(username, password, method='post')
+        response = if method == 'post'
+          RestClient.post 'https://www.pivotaltracker.com/services/v3/tokens/active', :username => username, :password => password
+        else
+          RestClient.get "https://#{username}:#{password}@www.pivotaltracker.com/services/v3/tokens/active"
+        end
+        @token ||= Nokogiri::XML(response.body).search('guid').inner_html
+      end
+
+      # this is your connection for the entire module
+      def connection(options={})
+        @connection ||= RestClient::Resource.new("#{protocol}://www.pivotaltracker.com/services/v3", :headers => {'X-TrackerToken' => @token, 'Content-Type' => 'application/xml'})
+      end
+
+      protected
+    
+        def protocol
+          use_ssl ? 'https' : 'http'
+        end
+      
+    end
+    
+  end
+end

data/lib/pivotal-tracker/extensions.rb

@@ -0,0 +1,11 @@
+# Happymapper patch for RestClient API Change (response => response.body)
+
+module HappyMapper
+  module ClassMethods
+    alias_method :orig_parse, :parse
+    def parse(xml, options={})
+      xml = xml.to_s if xml.is_a?(RestClient::Response)
+      orig_parse(xml, options)
+    end
+  end
+end

data/lib/pivotal-tracker/iteration.rb

@@ -0,0 +1,20 @@
+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
+    end
+
+    element :id, Integer
+    element :number, Integer
+    element :start, DateTime
+    element :finish, DateTime
+
+    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,17 @@
+module PivotalTracker
+  class Note
+    include HappyMapper
+
+    class << self
+#      def all(story, options={})
+#        parse(Client.connection["/projects/#{project_id}/stories/#{story_id}/notes"].get)
+#      end
+    end
+
+    element :id, Integer
+    element :text, String
+    element :author, String
+    element :noted_at, DateTime
+    # has_one :story, Story
+  end
+end

data/lib/pivotal-tracker/project.rb

@@ -0,0 +1,42 @@
+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 :iteration_length, Integer
+    element :week_start_day, String
+    element :point_scale, String
+
+    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
+
+  end
+end

data/lib/pivotal-tracker/proxy.rb

@@ -0,0 +1,65 @@
+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 = nil
+    end
+
+    def all(options={})
+      proxy_found(options)
+    end
+
+    def find(param, options={})
+      return all(options) if param == :all
+      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)
+        # Check to see if options have changed
+        if @opts == options
+          @found ||= load_found(options)
+        else
+          load_found(options)
+        end
+      end
+
+    private
+
+      def method_missing(method, *args, &block)
+        @target.send(method, *args, &block)
+      end
+
+      def load_found(options)
+        @opts = options
+        @target.all(@owner, @opts)
+      end
+
+  end
+end

data/lib/pivotal-tracker/story.rb

@@ -0,0 +1,87 @@
+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
+    end
+
+    attr_accessor :project_id
+
+    element :id, Integer
+    element :story_type, String
+    element :url, String
+    element :estimate, Integer
+    element :current_state, String
+    element :name, String
+    element :requested_by, String
+    element :owned_by, String
+    element :created_at, DateTime
+    element :accepted_at, DateTime
+    element :labels, String
+    element :description, String
+    element :jira_id, Integer
+    element :jira_url, String
+
+    def initialize(attributes={})
+      self.project_id = attributes.delete(:owner).id if attributes[:owner]
+
+      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')
+      return Story.parse(response)
+    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 delete
+      Client.connection["/projects/#{project_id}/stories/#{id}"].delete
+    end
+
+    def tasks
+      @tasks ||= Proxy.new(self, Task)
+    end
+
+    def project=(proj_id)
+      self.project_id = proj_id
+    end
+
+    protected
+
+      def to_xml
+        builder = Nokogiri::XML::Builder.new do |xml|
+          xml.story {
+            xml.name "#{name}"
+            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.description "#{description}"
+            # xml.jira_id "#{jira_id}"
+            # xml.jira_url "#{jira_url}"
+          }
+        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/task.rb

@@ -0,0 +1,48 @@
+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
+
+    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
+      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
+      end
+
+  end
+end

data/lib/pivotal-tracker.rb

@@ -0,0 +1,40 @@
+require 'cgi'
+require 'rest_client'
+require 'happymapper'
+require 'nokogiri'
+
+
+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', 'story')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'task')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'membership')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'activity')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'iteration')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker', 'note')
+
+module PivotalTracker
+
+  # define error types
+  class ProjectNotSpecified < StandardError; end
+
+  def self.encode_options(options)
+    return nil if !options.is_a?(Hash) || options.empty?
+
+    options_string = []
+    options_string << "limit=#{options.delete(:limit)}" if options[:limit]
+    options_string << "offset=#{options.delete(:offset)}" if options[:offset]
+
+    filters = []
+    options.each do |key, value|
+      values = value.is_a?(Array) ? value.map {|x| CGI.escape(x) }.join(',') : CGI.escape(value)
+      filters << "#{key}%3A#{values}" # %3A => :
+    end
+    options_string << "filter=#{filters.join('%20')}" unless filters.empty? # %20 => &amp;
+
+    return "?#{options_string.join('&')}"
+  end
+
+end

data/lib/pivotal_tracker.rb

@@ -0,0 +1,2 @@
+require "pivotal-tracker"
+