pivotal-tracker-fox 0.5.10

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 80d343bd4d40b36df622edb5fe15fa98b76ec0fd
+  data.tar.gz: 8fa41a04e8520910f816cb30d70e77c52e36f87a
+SHA512:
+  metadata.gz: 09742ce0b199d6439c49868dad497285ec1c3d5d3d14b0c8ca463bad5b10efb2cb29bc667bddf3d2f6bd3f0391416056a8124cfa097ddc48a5619a5965ac2367
+  data.tar.gz: bf9455c9183e487da98d2770e7f989550c6eea875ee85abdfe49c65149e2ba835e0f2c126774a6484cac3c77794b91217e4dd568e8bf20ffdf916abca36b3488

data/.rspec

@@ -0,0 +1 @@
+--colour

data/.travis.yml

@@ -0,0 +1,5 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3

data/Gemfile

@@ -0,0 +1,17 @@
+source 'http://rubygems.org'
+
+group :runtime do
+  gem 'rest-client', '~> 1.6.0'
+  gem 'nokogiri-happymapper', '>= 0.5.4', :require => 'happymapper'
+  gem 'builder'
+  gem 'nokogiri', '>= 1.5.5'
+  gem 'crack'
+end
+
+group :test do
+  gem 'rspec'
+  gem 'rake'
+  gem 'jeweler'
+  gem 'stale_fish', '~> 1.3.2'
+  gem 'autotest'
+end

data/Gemfile.lock

@@ -0,0 +1,57 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    ZenTest (4.8.2)
+    activesupport (3.2.9)
+      i18n (~> 0.6)
+      multi_json (~> 1.0)
+    autotest (4.4.6)
+      ZenTest (>= 4.4.1)
+    builder (3.1.4)
+    crack (0.3.1)
+    diff-lcs (1.1.3)
+    fakeweb (1.3.0)
+    git (1.2.5)
+    i18n (0.6.1)
+    jeweler (1.8.4)
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      rake
+      rdoc
+    json (1.7.5)
+    mime-types (1.19)
+    multi_json (1.3.7)
+    nokogiri (1.5.5)
+    nokogiri-happymapper (0.5.6)
+      nokogiri (~> 1.5)
+    rake (10.0.2)
+    rdoc (3.12)
+      json (~> 1.4)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    rspec (2.12.0)
+      rspec-core (~> 2.12.0)
+      rspec-expectations (~> 2.12.0)
+      rspec-mocks (~> 2.12.0)
+    rspec-core (2.12.0)
+    rspec-expectations (2.12.0)
+      diff-lcs (~> 1.1.3)
+    rspec-mocks (2.12.0)
+    stale_fish (1.3.2)
+      activesupport
+      fakeweb
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  autotest
+  builder
+  crack
+  jeweler
+  nokogiri (>= 1.5.5)
+  nokogiri-happymapper (>= 0.5.4)
+  rake
+  rest-client (~> 1.6.0)
+  rspec
+  stale_fish (~> 1.3.2)

data/LICENSE

@@ -0,0 +1,20 @@
+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
+"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,82 @@
+= pivotal-tracker.rb
+
+Ruby wrapper for Pivotal Tracker API, no frameworks required. Simply Ruby.
+
+{<img src="https://secure.travis-ci.org/jsmestad/pivotal-tracker.png" />}[http://travis-ci.org/jsmestad/pivotal-tracker]
+{<img src="https://badge.fury.io/rb/pivotal-tracker.png" alt="Gem Version" />}[http://rubygems.org/gems/pivotal-tracker]
+
+== 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 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 comment', :noted_at => '06/29/2010 05:00 EST')  # add a new note
+
+
+    @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
+
+
+    # Connect to custom API endpoint
+    PivotalTracker::Client.tracker_host = 'www.my-pivotal-tracker.com'
+
+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
+* Pivotal API v3 Docs: http://www.pivotaltracker.com/help/api?version=v3
+
+== 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

@@ -0,0 +1,46 @@
+#!/usr/bin/env rake
+begin
+    require 'bundler/setup'
+rescue LoadError
+    puts 'You must `gem install bundler` and `bundle install` to run rake tasks'
+end
+
+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"]
+
+    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'
+
+    gem.add_development_dependency 'rspec'
+    gem.add_development_dependency 'bundler', '~> 1.0.12'
+    gem.add_development_dependency 'jeweler'
+    gem.add_development_dependency 'stale_fish', '~> 1.3.0'
+  end
+  Jeweler::GemcutterTasks.new
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'rspec/core'
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+
+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.5.11

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', 'validation')
+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')
+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)
+    options_strings = options.inject({}) do |m, (k,v)|
+      if [:limit, :offset].include?(k.to_sym)
+        m.update k => v
+      elsif k.to_sym == :search
+        m.update :filter => v
+      else
+        filter_query = %{#{k}:#{[v].flatten.join(",")}}
+        m.update :filter => (m[:filter] ? "#{m[:filter]} #{filter_query}" : filter_query)
+      end
+    end.map {|k,v| "#{k}=#{CGI.escape(v.to_s)}"}
+
+    %{?#{options_strings.join("&")}} unless options_strings.empty?
+  end
+
+end

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=#{URI.escape options[:occurred_since_date].strftime("%Y/%m/%d %H:%M:%S %Z")}"
+          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/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/client.rb

@@ -0,0 +1,81 @@
+module PivotalTracker
+
+  class Client
+
+    class NoToken < StandardError; end
+
+    class << self
+      attr_writer :use_ssl, :token, :tracker_host
+
+      def use_ssl
+        @use_ssl || false
+      end
+
+      def token(username, password, method='post')
+        response = if method == 'post'
+          RestClient.post api_ssl_url + '/tokens/active', :username => username, :password => password
+        else
+          RestClient.get "#{api_ssl_url(username, password)}/tokens/active"
+        end
+        @token= Nokogiri::XML(response.body).search('guid').inner_html
+      end
+
+      # this is your connection for the entire module
+      def connection(options={})
+        raise NoToken if @token.to_s.empty?
+
+        @connections ||= {}
+
+        cached_connection? && !protocol_changed? ? cached_connection : new_connection
+      end
+
+      def clear_connections
+        @connections = nil
+      end
+
+      def tracker_host
+        @tracker_host ||= "www.pivotaltracker.com"
+      end
+
+      def api_ssl_url(user=nil, password=nil)
+        user_password = (user && password) ? "#{user}:#{password}@" : ''
+        "https://#{user_password}#{tracker_host}#{api_path}"
+      end
+
+      def api_url
+        "http://#{tracker_host}#{api_path}"
+      end
+
+      protected
+
+        def protocol
+          use_ssl ? 'https' : 'http'
+        end
+
+        def cached_connection?
+          !@connections[@token].nil?
+        end
+
+        def cached_connection
+          @connections[@token]
+        end
+
+        def new_connection
+          @connections[@token] = RestClient::Resource.new("#{use_ssl ? api_ssl_url : api_url}", :headers => {'X-TrackerToken' => @token, 'Content-Type' => 'application/xml'})
+        end
+
+        def protocol_changed?
+          cached_connection? ? (cached_connection_protocol != protocol) : false
+        end
+
+        def cached_connection_protocol
+          cached_connection.url.match(/^(.*):\/\//).captures.first
+        end
+
+        def api_path
+          '/services/v3'
+        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