pivotal-tracker-api 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: cbe2c90c2bba74b1786f6b01037b640aa7bb18cc
+  data.tar.gz: 1f8948d45390620446e88181d5fbf88da5747b79
+SHA512:
+  metadata.gz: be5c6620c49eede7d9804279c3031ff4636653b4c740cc6613e4f702b5e69db06da77b5cb66a62833adad507978e3955d8954bf00cab521751779b40db5043ee
+  data.tar.gz: 4c439b0aad7bf21d998bd770abf2070adfa4041f8a2b5ab60b36e0c35251f4a38bcfbfcf0ba46512437c15f0a783081a093c2242ac79f0488daa67032fdeb5c5

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/.idea/.name

@@ -0,0 +1 @@
+pivotal-tracker-api

data/.idea/.rakeTasks

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<Settings><!--This file was automatically generated by Ruby plugin.
+You are allowed to: 
+1. Remove rake task
+2. Add existing rake tasks
+To add existing rake tasks automatically delete this file and reload the project.
+--><RakeGroup description="" fullCmd="" taksId="rake"><RakeTask description="Build gem into pkg/" fullCmd="build" taksId="build" /><RakeTask description="Remove any temporary products" fullCmd="clean" taksId="clean" /><RakeTask description="Remove any generated file" fullCmd="clobber" taksId="clobber" /><RakeTask description="Remove RDoc HTML files" fullCmd="clobber_rdoc" taksId="clobber_rdoc" /><RakeTask description="Start IRB with all runtime dependencies loaded" fullCmd="console[script]" taksId="console[script]" /><RakeGroup description="" fullCmd="" taksId="gemcutter"><RakeTask description="Release gem to Gemcutter" fullCmd="gemcutter:release" taksId="release" /></RakeGroup><RakeTask description="Generate and validate gemspec" fullCmd="gemspec" taksId="gemspec" /><RakeGroup description="" fullCmd="" taksId="gemspec"><RakeTask description="Display the gemspec for debugging purposes, as jeweler knows it (not from the filesystem)" fullCmd="gemspec:debug" taksId="debug" /><RakeTask description="Regenerate the gemspec on the filesystem" fullCmd="gemspec:generate" taksId="generate" /><RakeTask description="Regenerate and validate gemspec, and then commits and pushes to git" fullCmd="gemspec:release" taksId="release" /><RakeTask description="Validates the gemspec on the filesystem" fullCmd="gemspec:validate" taksId="validate" /></RakeGroup><RakeGroup description="" fullCmd="" taksId="git"><RakeTask description="Tag and push release to git" fullCmd="git:release" taksId="release" /></RakeGroup><RakeTask description="Build and install gem using `gem install`" fullCmd="install" taksId="install" /><RakeTask description="Build RDoc HTML files" fullCmd="rdoc" taksId="rdoc" /><RakeTask description="Release gem" fullCmd="release" taksId="release" /><RakeTask description="Rebuild RDoc HTML files" fullCmd="rerdoc" taksId="rerdoc" /><RakeTask description="Run tests" fullCmd="test" taksId="test" /><RakeTask description="Displays the current version" fullCmd="version" taksId="version" /><RakeGroup description="" fullCmd="" taksId="version"><RakeGroup description="" fullCmd="" taksId="bump"><RakeTask description="Bump the major version by 1" fullCmd="version:bump:major" taksId="major" /><RakeTask description="Bump the a minor version by 1" fullCmd="version:bump:minor" taksId="minor" /><RakeTask description="Bump the patch version by 1" fullCmd="version:bump:patch" taksId="patch" /></RakeGroup><RakeTask description="Writes out an explicit version" fullCmd="version:write" taksId="write" /></RakeGroup><RakeTask description="" fullCmd="console" taksId="console" /><RakeTask description="" fullCmd="default" taksId="default" /><RakeTask description="" fullCmd="gemspec_required" taksId="gemspec_required" /><RakeTask description="" fullCmd="rdoc/index.html" taksId="rdoc/index.html" /><RakeTask description="" fullCmd="version_required" taksId="version_required" /></RakeGroup></Settings>

data/.idea/encodings.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="Encoding" useUTFGuessing="true" native2AsciiForPropertiesFiles="false" />
+</project>
+

data/.idea/misc.xml

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectRootManager" version="2" project-jdk-name="RVM: ruby-2.0.0-p195" project-jdk-type="RUBY_SDK" />
+</project>
+

data/.idea/modules.xml

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="ProjectModuleManager">
+    <modules>
+      <module fileurl="file://$PROJECT_DIR$/.idea/pivotal-tracker-api.iml" filepath="$PROJECT_DIR$/.idea/pivotal-tracker-api.iml" />
+    </modules>
+  </component>
+</project>
+

data/.idea/pivotal-tracker-api.iml

@@ -0,0 +1,53 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<module type="RUBY_MODULE" version="4">
+  <component name="FacetManager">
+    <facet type="gem" name="Gem">
+      <configuration>
+        <option name="GEM_APP_ROOT_PATH" value="$MODULE_DIR$" />
+        <option name="GEM_APP_TEST_PATH" value="$MODULE_DIR$/test" />
+        <option name="GEM_APP_LIB_PATH" value="$MODULE_DIR$/lib" />
+      </configuration>
+    </facet>
+  </component>
+  <component name="NewModuleRootManager">
+    <content url="file://$MODULE_DIR$">
+      <sourceFolder url="file://$MODULE_DIR$/test" isTestSource="true" />
+    </content>
+    <orderEntry type="inheritedJdk" />
+    <orderEntry type="sourceFolder" forTests="false" />
+    <orderEntry type="library" scope="PROVIDED" name="activesupport (v4.0.0, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="addressable (v2.3.5, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="atomic (v1.1.14, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="builder (v3.2.2, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="bundler (v1.3.5, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="faraday (v0.8.8, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="git (v1.2.6, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="github_api (v0.10.1, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="hashie (v2.0.5, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="highline (v1.6.20, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="httpauth (v0.2.0, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="i18n (v0.6.5, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="jeweler (v1.8.8, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="json (v1.8.1, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="jwt (v0.1.8, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="mime-types (v1.25, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="minitest (v4.7.5, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="multi_json (v1.8.2, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="multi_xml (v0.5.5, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="multipart-post (v1.2.0, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="nokogiri (v1.5.10, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="oauth2 (v0.9.2, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rack (v1.5.2, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rake (v10.1.0, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rdoc (v3.12.2, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="rest-client (v1.6.7, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="shoulda (v3.5.0, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="shoulda-context (v1.1.5, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="shoulda-matchers (v2.4.0, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="simplecov (v0.7.1, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="simplecov-html (v0.7.1, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="thread_safe (v0.1.3, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+    <orderEntry type="library" scope="PROVIDED" name="tzinfo (v0.3.38, RVM: ruby-2.0.0-p195) [gem]" level="application" />
+  </component>
+</module>
+

data/.idea/scopes/scope_settings.xml

@@ -0,0 +1,5 @@
+<component name="DependencyValidationManager">
+  <state>
+    <option name="SKIP_IMPORT_STATEMENTS" value="false" />
+  </state>
+</component>

data/.idea/vcs.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project version="4">
+  <component name="VcsDirectoryMappings">
+    <mapping directory="$PROJECT_DIR$" vcs="Git" />
+  </component>
+</project>
+

data/Gemfile

@@ -0,0 +1,15 @@
+source 'http://rubygems.org'
+# Add dependencies required to use your gem here.
+# Example:
+#   gem 'activesupport', '>= 2.3.5'
+gem 'rest-client', '~> 1.6.7'
+
+# Add dependencies to develop your gem here.
+# Include everything needed to run rake, tests, features, etc.
+group :development do
+  gem 'shoulda', '>= 0'
+  gem 'rdoc', '~> 3.12'
+  gem 'bundler', '~> 1.0'
+  gem 'jeweler', '~> 1.8.7'
+  gem 'simplecov'
+end

data/Gemfile.lock

@@ -0,0 +1,81 @@
+GEM
+  remote: http://rubygems.org/
+  specs:
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    addressable (2.3.5)
+    atomic (1.1.14)
+    builder (3.2.2)
+    faraday (0.8.8)
+      multipart-post (~> 1.2.0)
+    git (1.2.6)
+    github_api (0.10.1)
+      addressable
+      faraday (~> 0.8.1)
+      hashie (>= 1.2)
+      multi_json (~> 1.4)
+      nokogiri (~> 1.5.2)
+      oauth2
+    hashie (2.0.5)
+    highline (1.6.20)
+    httpauth (0.2.0)
+    i18n (0.6.5)
+    jeweler (1.8.8)
+      builder
+      bundler (~> 1.0)
+      git (>= 1.2.5)
+      github_api (= 0.10.1)
+      highline (>= 1.6.15)
+      nokogiri (= 1.5.10)
+      rake
+      rdoc
+    json (1.8.1)
+    jwt (0.1.8)
+      multi_json (>= 1.5)
+    mime-types (1.25)
+    minitest (4.7.5)
+    multi_json (1.8.2)
+    multi_xml (0.5.5)
+    multipart-post (1.2.0)
+    nokogiri (1.5.10)
+    oauth2 (0.9.2)
+      faraday (~> 0.8)
+      httpauth (~> 0.2)
+      jwt (~> 0.1.4)
+      multi_json (~> 1.0)
+      multi_xml (~> 0.5)
+      rack (~> 1.2)
+    rack (1.5.2)
+    rake (10.1.0)
+    rdoc (3.12.2)
+      json (~> 1.4)
+    rest-client (1.6.7)
+      mime-types (>= 1.16)
+    shoulda (3.5.0)
+      shoulda-context (~> 1.0, >= 1.0.1)
+      shoulda-matchers (>= 1.4.1, < 3.0)
+    shoulda-context (1.1.5)
+    shoulda-matchers (2.4.0)
+      activesupport (>= 3.0.0)
+    simplecov (0.7.1)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.7.1)
+    simplecov-html (0.7.1)
+    thread_safe (0.1.3)
+      atomic
+    tzinfo (0.3.38)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.0)
+  jeweler (~> 1.8.7)
+  rdoc (~> 3.12)
+  rest-client (~> 1.6.7)
+  shoulda
+  simplecov

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2013 jfox
+
+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,19 @@
+= pivotal-tracker-api
+
+Description goes here.
+
+== Contributing to pivotal-tracker-api
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet.
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it.
+* Fork the project.
+* Start a feature/bugfix branch.
+* Commit and push until you are happy with your contribution.
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2013 jfox. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,53 @@
+# encoding: utf-8
+
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'rake'
+
+require 'jeweler'
+Jeweler::Tasks.new do |gem|
+  # gem is a Gem::Specification... see http://docs.rubygems.org/read/chapter/20 for more options
+  gem.name = "pivotal-tracker-api"
+  gem.homepage = "http://github.com/atljeremy/pivotal-tracker-api"
+  gem.license = "MIT"
+  gem.summary = %Q{A ruby gem to communicate with the Picotal Tracker API v5}
+  gem.description = %Q{A ruby gem to communicate with the Picotal Tracker API v5}
+  gem.email = "atljeremy@me.com"
+  gem.authors = ["jfox"]
+  # dependencies defined in Gemfile
+end
+Jeweler::RubygemsDotOrgTasks.new
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |test|
+  test.libs << 'lib' << 'test'
+  test.pattern = 'test/**/test_*.rb'
+  test.verbose = true
+end
+
+#require 'rcov/rcovtask'
+#Rcov::RcovTask.new do |test|
+#  test.libs << 'test'
+#  test.pattern = 'test/**/test_*.rb'
+#  test.verbose = true
+#  test.rcov_opts << '--exclude "gems/*"'
+#end
+
+task :default => :test
+
+require 'rdoc/task'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "pivotal-tracker-api #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/VERSION

@@ -0,0 +1 @@
+0.1.0

data/lib/pivotal-tracker-api/activity.rb

@@ -0,0 +1,42 @@
+module Scorer
+  class Activity
+
+    attr_accessor :project_id, :occurred_at, :highlight, :primary_resources, :changes, :guid, :kind, :performed_by_id,
+                  :performed_by, :message, :project_version
+
+    def initialize(attributes={})
+      update_attributes(attributes)
+    end
+
+    def self.parse_json_activity(json_activity, project_id)
+      json_activity.each do |activity|
+        new({
+          project_id: project_id,
+          occurred_at: activity[:stories],
+          highlight: activity[:number],
+          primary_resources: activity[:team_strength],
+          changes: activity[:finish],
+          guid: activity[:kind],
+          kind: activity[:start],
+          performed_by_id: activity[:performed_by_id],
+          performed_by: parse_person(activity[:performed_by]),
+          message: activity[:message],
+          project_version: activity[:project_version]
+        })
+      end
+    end
+
+    protected
+
+    def self.parse_person(json_person)
+      Scorer::Person.parse_json_person(json_person)
+    end
+
+    def update_attributes(attrs)
+      attrs.each do |key, value|
+        self.send("#{key}=", value)
+      end
+    end
+
+  end
+end

data/lib/pivotal-tracker-api/attachment.rb

@@ -0,0 +1,19 @@
+module Scorer
+  class Attachment
+
+    attr_accessor :status, :url, :filename, :id, :description, :uploaded_at, :uploaded_by
+
+    def initialize(attributes={})
+      update_attributes(attributes)
+    end
+
+    protected
+
+    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-api/client.rb

@@ -0,0 +1,96 @@
+module Scorer
+  class Client
+
+    class NoToken < StandardError; end
+
+    class << self
+
+      attr_writer :token, :ssl_enabled
+      attr_reader :api_host, :api_projects_path
+
+      def get(path)
+        begin
+          set_response_headers(connection["#{api_version}#{path}"].get)
+        rescue
+          puts "Encountered Error in get: #{$!}"
+          clear_connections
+          set_response_headers(connection["#{api_version}#{path}"].get)
+        end
+      end
+
+      def get_with_caching(path)
+        begin
+          connection["#{api_version}#{path}"].get
+        rescue
+          puts "Encountered Error in get_with_caching: #{$!}"
+          clear_connections
+          connection["#{api_version}#{path}"].get
+        end
+      end
+
+      def put(path, updates={})
+        set_response_headers(connection["#{api_version}#{path}"].put(updates))
+      end
+
+      def connection
+        raise NoToken if @token.to_s.empty?
+        @connections ||= {}
+        cached_connection? ? cached_connection : new_connection
+      end
+
+      def clear_connections
+        @connections = nil
+      end
+
+      def ssl_enabled
+        @ssl_enabled || true
+      end
+
+      def token(username, password)
+        response = RestClient.get("#{api_ssl_host(username, password)}#{api_version}/me")
+        json = JSON.parse(response, {:symbolize_names => true})
+        @token = json[:api_token]
+      end
+
+      def api_ssl_host(user=nil, password=nil)
+        user_password = (user && password) ? "#{user}:#{password}@" : ''
+        "https://#{user_password}www.pivotaltracker.com"
+      end
+
+      def api_host
+        @api_host ||= 'http://www.pivotaltracker.com'
+      end
+
+      def api_projects_path
+        @api_projects_path ||= "#{ssl_enabled ? api_ssl_host : api_host}#{api_version}/projects"
+      end
+
+      protected
+
+        def set_response_headers(response)
+          response.headers['Cache-Control'] = 'no-cache, no-store, must-revalidate' # HTTP 1.1.
+          response.headers['Pragma']        = 'no-cache' # HTTP 1.0.
+          response.headers['Expires']       = '0' # Proxies.
+          response
+        end
+
+        def api_version
+          '/services/v5'
+        end
+
+        def cached_connection?
+          !@connections[@token].nil?
+        end
+
+        def cached_connection
+          @connections[@token]
+        end
+
+        def new_connection
+          @connections[@token] = RestClient::Resource.new("#{ssl_enabled ? api_ssl_host : api_host}", :headers => {'X-TrackerToken' => @token, 'Content-Type' => 'application/json'})
+        end
+
+    end
+
+  end
+end

data/lib/pivotal-tracker-api/comment.rb

@@ -0,0 +1,25 @@
+module Scorer
+  class Comment
+
+    attr_accessor :story, :project_id, :story_id, :id, :text, :author, :created_at
+
+    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
+
+    protected
+
+    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-api/iteration.rb

@@ -0,0 +1,39 @@
+module Scorer
+  class Iteration
+
+    attr_accessor :project_id, :length, :planned, :stories, :story_ids, :number, :team_strength, :finish, :kind, :start
+
+    def initialize(attributes={})
+      update_attributes(attributes)
+    end
+
+    def self.parse_json_iteration(json_iteration)
+      new({
+        project_id: json_iteration[:project_id].to_i,
+        stories: parse_stories(json_iteration[:stories], json_iteration[:project_id].to_i),
+        story_ids: json_iteration[:story_ids],
+        number: json_iteration[:number],
+        team_strength: json_iteration[:team_strength],
+        finish: json_iteration[:finish],
+        kind: json_iteration[:kind],
+        start: json_iteration[:start]
+      })
+    end
+
+    protected
+
+    def self.parse_stories(stories, project_id)
+      story_ids = Array.new
+      stories.each { |story| story_ids << story[:id].to_i if !story[:id].nil? }
+      project = PivotalService.one_project(project_id)
+      PivotalService.stories(project, true, story_ids, Scorer::Story.fields)
+    end
+
+    def update_attributes(attrs)
+      attrs.each do |key, value|
+        self.send("#{key}=", value )
+      end
+    end
+
+  end
+end

data/lib/pivotal-tracker-api/person.rb

@@ -0,0 +1,29 @@
+module Scorer
+  class Person
+
+    attr_accessor :name, :id, :initials, :email, :username
+
+    def initialize(attributes={})
+      update_attributes(attributes)
+    end
+
+    def self.parse_json_person(json_person)
+      new({
+        id: json_person[:id].to_i,
+        name: json_person[:name],
+        initials: json_person[:initals],
+        email: json_person[:email],
+        username: json_person[:username]
+      })
+    end
+
+    protected
+
+    def update_attributes(attrs)
+      attrs.each do |key, value|
+        self.send("#{key}=", value)
+      end
+    end
+
+  end
+end

data/lib/pivotal-tracker-api/pivotal_service.rb

@@ -0,0 +1,114 @@
+require 'json'
+
+class PivotalService
+
+  class << self
+
+    def set_token(token)
+      Scorer::Client.token = token
+    end
+
+    def all_projects(fields=[])
+      api_url = append_fields('/projects', fields)
+      response = Scorer::Client.get(api_url)
+      json_projects = JSON.parse(response, {:symbolize_names => true})
+      Scorer::Project.parse_json_projects(json_projects)
+    end
+
+    def one_project(id, fields=[])
+      return @project if !@project.nil? && @project.id == id
+
+      api_url = append_fields('/projects' + "/#{id}", fields)
+      response = Scorer::Client.get(api_url)
+      json_project = JSON.parse(response, {:symbolize_names => true})
+      @project = Scorer::Project.parse_json_project(json_project)
+    end
+
+    def activity(project_id, story_id=0, limit=20)
+      api_url = "/projects/#{project_id}/"
+      api_url = api_url + "stories/#{story_id}/" if story_id > 0
+      api_url = api_url + "activity?limit=#{limit}"
+      response = Scorer::Client.get(api_url)
+      json_activity = JSON.parse(response, {:symbolize_names => true})
+      Scorer::Activity.parse_json_activity(json_activity, project_id)
+    end
+
+    def iterations(project_id, scope, fields=[], limit=1, offset=1)
+      return @iteration if !@iteration.nil? && @iteration.project_id == project_id
+
+      api_url = "/projects/#{project_id}/iterations?"
+      if scope
+        if scope != 'current'
+          api_url = api_url + "&offset=#{offset}&limit=#{limit}"
+        end
+        api_url = api_url + "&scope=#{scope}"
+      end
+      api_url = append_fields(api_url, fields)
+      response = Scorer::Client.get_with_caching(api_url)
+      json_iterations = JSON.parse(response, {:symbolize_names => true})
+      @iteration = Scorer::Iteration.parse_json_iteration(json_iterations[0])
+    end
+
+    def all_stories(project_label, project, fields=[])
+      api_url = append_fields('/projects' + "/#{project.id}/stories", fields)
+      api_url = api_url + "&with_label=#{project_label}&with_state=unstarted&limit=100"
+      response = Scorer::Client.get(api_url)
+      json_stories = JSON.parse(response, {:symbolize_names => true})
+      Scorer::Story.parse_json_stories(json_stories, project.id)
+    end
+
+    def one_story(project_label, project, fields=[])
+      api_url = append_fields('/projects' + "/#{project.id}/stories", fields)
+      api_url = api_url + "&with_label=#{project_label}&with_state=unstarted&limit=100"
+      response = Scorer::Client.get(api_url)
+      json_story = JSON.parse(response, {:symbolize_names => true})
+      Scorer::Story.parse_json_story(json_story, project.id)
+    end
+
+    def stories(project, should_cache, ids=[], fields=[])
+      @stories = Array.new
+      api_url = append_fields('/projects' + "/#{project.id}/stories", fields)
+      api_url = api_url.rindex('?fields=') ? "#{api_url}&filter=id%3A" : "#{api_url}?filter=id%3A"
+      if ids.size == 1
+        api_url = api_url + ids[0].to_s
+        if should_cache
+          response = Scorer::Client.get_with_caching(api_url)
+        else
+          response = Scorer::Client.get(api_url)
+        end
+        json_story = JSON.parse(response, {:symbolize_names => true})
+        @stories << Scorer::Story.parse_json_story(json_story[0], project.id)
+      else
+        story_ids = ''
+        ids.each do |id|
+          story_ids = "#{story_ids}#{id}%2C"
+        end
+        api_url = api_url + story_ids
+        if should_cache
+          response = Scorer::Client.get_with_caching(api_url)
+        else
+          response = Scorer::Client.get(api_url)
+        end
+        json_stories = JSON.parse(response, {:symbolize_names => true})
+        @stories = Scorer::Story.parse_json_stories(json_stories, project.id)
+      end
+    end
+
+    def update_story(story_id, project_id, updates={})
+      project = one_project(project_id, Scorer::Project.fields)
+      api_url = '/projects' + "/#{project.id}/stories/#{story_id}"
+      Scorer::Client.put(api_url, updates)
+    end
+
+    private
+
+      def append_fields(api_url, fields)
+        url = api_url
+        fields.each do |field|
+          url = url.rindex('?fields=') ? url + ",#{field}" : url + "?fields=#{field}"
+        end
+        url
+      end
+
+  end
+end

data/lib/pivotal-tracker-api/project.rb

@@ -0,0 +1,63 @@
+module Scorer
+  class Project
+
+    attr_accessor :updated_at, :bugs_and_chores_are_estimatable, :enable_planned_mode, :public, :story_ids, :name,
+                  :iteration_length, :start_time, :version, :label_ids, :description, :profile_content,
+                  :iteration_override_numbers, :velocity_averaged_over, :current_velocity, :point_scale_is_custom,
+                  :epic_ids, :membership_ids, :integration_ids, :created_at, :week_start_day, :time_zone,
+                  :shown_iterations_start_time, :has_google_domain, :kind, :id, :point_scale, :current_iteration_number,
+                  :start_date, :number_of_done_iterations_to_show, :account_id, :labels
+
+    class << self
+
+      def fields
+        ['description', 'labels', 'name']
+      end
+
+      def parse_json_projects(json_projects)
+        projects = Array.new
+        json_projects.each do |project|
+          projects << parse_json_project(project)
+        end
+        projects
+      end
+
+      def parse_json_project(project)
+        new({
+          id: project[:id].to_i,
+          name: project[:name],
+          week_start_day: project[:week_start_day],
+          point_scale: project[:point_scale],
+          labels: parse_labels(project[:labels]),
+          iteration_length: project[:iteration_length],
+          current_velocity: project[:current_velocity]
+        })
+      end
+
+      def parse_labels(labels)
+        parsed_labels = ''
+        labels.each do |label|
+          parsed_labels = parsed_labels + "#{label[:name]},"
+        end
+        parsed_labels
+      end
+    end
+
+    def initialize(attributes={})
+      update_attributes(attributes)
+    end
+
+    def get_labels
+      self.labels.split(',')
+    end
+
+    protected
+
+    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-api/story.rb

@@ -0,0 +1,199 @@
+module Scorer
+  class Story
+
+    attr_accessor :project_id, :follower_ids, :updated_at, :current_state, :name, :comment_ids, :url, :story_type,
+                  :label_ids, :description, :requested_by_id, :planned_iteration_number, :external_id, :deadline,
+                  :owned_by_id, :owned_by, :created_at, :estimate, :kind, :id, :task_ids, :integration_id, :accepted_at,
+                  :comments, :tasks, :attachments, :requested_by, :labels, :notes, :started_at, :status
+
+    def initialize(attributes={})
+      update_attributes(attributes)
+    end
+
+    def self.fields
+      ['url', 'name', 'description', 'story_type',
+       'estimate', 'current_state', 'requested_by',
+       'owned_by', 'labels', 'integration_id',
+       'deadline', 'comments', 'tasks']
+    end
+
+    def self.parse_json_story(json_story, project_id)
+      requested_by = json_story[:requested_by][:name] if !json_story[:requested_by].nil?
+      story_id = json_story[:id].to_i
+      estimate = json_story[:estimate] ? json_story[:estimate].to_i : -1
+      current_state = json_story[:current_state]
+      parsed_story = new({
+        id: story_id,
+        url: json_story[:url],
+        project_id: project_id,
+        name: json_story[:name],
+        description: json_story[:description],
+        story_type: json_story[:story_type],
+        estimate: estimate,
+        current_state: current_state,
+        requested_by: requested_by,
+        owned_by_id: json_story[:owned_by_id],
+        owned_by: json_story[:owned_by],
+        labels: parse_labels(json_story[:labels]),
+        integration_id: json_story[:integration_id],
+        deadline: json_story[:deadline]
+      })
+
+      parsed_story.comments = parse_notes(json_story[:comments], json_story)
+      parsed_story.tasks = parse_tasks(json_story[:tasks], json_story)
+      parsed_story.attachments = []
+      parsed_story
+    end
+
+    def self.parse_json_stories(json_stories, project_id)
+      stories = Array.new
+      json_stories.each do |story|
+        stories << parse_json_story(story, project_id)
+      end
+      stories
+    end
+
+    def self.parse_notes(notes, story)
+      comments = Array.new
+      if notes
+        notes.each do |note|
+          comments << Scorer::Comment.new({
+            id: note[:id].to_i,
+            text: note[:text],
+            author: note[:author],
+            created_at: DateTime.parse(note[:created_at].to_s).to_s,
+            story: story
+          })
+        end
+      end
+      comments
+    end
+
+    def self.parse_tasks(tasks, story)
+      parsed_tasks = Array.new
+      if tasks
+        tasks.each do |task|
+          parsed_tasks <<  Scorer::Task.new({
+            id: task[:id].to_i,
+            description: task[:description],
+            complete: task[:complete],
+            created_at: DateTime.parse(task[:created_at].to_s).to_s,
+            story: story
+          })
+        end
+      end
+      parsed_tasks
+    end
+
+    def self.parse_attachments(attachments)
+      parsed_attachments = Array.new
+      if attachments
+        attachments.each do |file|
+          attachment = Scorer::Attachment.new
+          attachment.id = file[:id].to_i
+          attachment.filename = file[:filename]
+          attachment.description = file[:description]
+          attachment.uploaded_by = file[:uploaded_by]
+          attachment.uploaded_at = file[:uploaded_at]
+          attachment.url = file[:url]
+          attachment.status = file[:status]
+          parsed_attachments << attachment
+        end
+      end
+      parsed_attachments
+    end
+
+    def self.parse_labels(labels)
+      parsed_labels = ''
+      labels.each do |label|
+        parsed_labels = parsed_labels + "#{label[:name]},"
+      end
+      parsed_labels
+    end
+
+    def self.get_story_started_at(project_id, story_id)
+      events = Hash.new
+      current_started_at = nil
+      current_accepted_at = nil
+      activity = PivotalService.activity(project_id, story_id, 40)
+      activity.each do |event|
+        case event[:highlight]
+          when 'started'
+            started_at = event[:occurred_at]
+            if current_started_at.nil? || current_started_at < started_at || current_accepted_at === started_at
+              current_started_at = started_at
+              events[:started_at] = current_started_at
+            end
+          when 'accepted'
+            accepted_at = event[:occurred_at]
+            if current_accepted_at.nil? || current_accepted_at < accepted_at
+              current_accepted_at = accepted_at
+              events[:accepted_at] = current_accepted_at
+            end
+        end
+      end
+      events
+    end
+
+    def self.get_story_status(event_times, points, current_state)
+      status = {status: 'ok', hours: -1}
+      if !event_times.nil? && !event_times[:started_at].nil? && points > -1 && current_state != 'unstarted'
+
+        # Times
+        started_at_time = Time.parse(event_times[:started_at])
+
+        # Due Dates
+        due_date = (points.to_i.business_hours.after(started_at_time)).to_datetime
+        almost_due_date = ((points - 1).to_i.business_hours.after(started_at_time)).to_datetime
+
+        if current_state == 'accepted' && !event_times[:accepted_at].nil?
+          accepted_at = event_times[:accepted_at]
+          hours = get_hours_between_times(started_at_time, Time.parse(accepted_at))
+          if accepted_at.to_datetime > due_date || hours >= points
+            status = {status: 'overdue', hours: hours}
+          elsif accepted_at >= almost_due_date || hours == (points - 1)
+            status = {status: 'almost_due', hours: hours}
+          else
+            status = {status: 'ok', hours: hours}
+          end
+        else
+          now = DateTime.now
+          hours = get_hours_between_times(started_at_time, Time.parse(now.to_s))
+          if now >= due_date || hours >= points
+            status = {status: 'overdue', hours: hours}
+          elsif now >= almost_due_date || hours == (points - 1)
+            status = {status: 'almost_due', hours: hours}
+          else
+            status = {status: 'ok', hours: hours}
+          end
+        end
+
+      end
+      status
+    end
+
+    protected
+
+    def self.get_hours_between_times(time1, time2)
+
+      # Check to see if both times occurred outside of business hours.
+      # If so, calculate the total time in between each time
+      if Time::roll_forward(time1) == Time::roll_forward(time2)
+        return (((time2 - time1) / 60) / 60).round
+      end
+
+      ((time1.business_time_until(time2) / 60) / 60).round
+    end
+
+    def self.est_time_zone(time)
+      time.in_time_zone("Eastern Time (US & Canada)")
+    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-api/task.rb

@@ -0,0 +1,25 @@
+module Scorer
+  class Task
+
+    attr_accessor :project_id, :story_id, :story, :id, :description, :position, :complete, :created_at
+
+    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
+
+    protected
+
+    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-api.rb

@@ -0,0 +1,12 @@
+require 'rest_client'
+
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'client')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'project')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'attachment')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'story')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'task')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'activity')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'iteration')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'comment')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'person')
+require File.join(File.dirname(__FILE__), 'pivotal-tracker-api', 'pivotal_service')

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'pivotal-tracker-api'
+
+class Test::Unit::TestCase
+end

data/test/test_pivotal-tracker-api.rb

@@ -0,0 +1,7 @@
+require 'helper'
+
+class TestPivotalTrackerApi < Test::Unit::TestCase
+  should "probably rename this file and start testing for real" do
+
+  end
+end

metadata

@@ -0,0 +1,157 @@
+--- !ruby/object:Gem::Specification
+name: pivotal-tracker-api
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- jfox
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-10-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rest-client
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.7
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.6.7
+- !ruby/object:Gem::Dependency
+  name: shoulda
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.12'
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.0'
+- !ruby/object:Gem::Dependency
+  name: jeweler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.8.7
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: A ruby gem to communicate with the Picotal Tracker API v5
+email: atljeremy@me.com
+executables: []
+extensions: []
+extra_rdoc_files:
+- LICENSE.txt
+- README.rdoc
+files:
+- .document
+- .idea/.name
+- .idea/.rakeTasks
+- .idea/encodings.xml
+- .idea/misc.xml
+- .idea/modules.xml
+- .idea/pivotal-tracker-api.iml
+- .idea/scopes/scope_settings.xml
+- .idea/vcs.xml
+- Gemfile
+- Gemfile.lock
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- VERSION
+- lib/pivotal-tracker-api.rb
+- lib/pivotal-tracker-api/activity.rb
+- lib/pivotal-tracker-api/attachment.rb
+- lib/pivotal-tracker-api/client.rb
+- lib/pivotal-tracker-api/comment.rb
+- lib/pivotal-tracker-api/iteration.rb
+- lib/pivotal-tracker-api/person.rb
+- lib/pivotal-tracker-api/pivotal_service.rb
+- lib/pivotal-tracker-api/project.rb
+- lib/pivotal-tracker-api/story.rb
+- lib/pivotal-tracker-api/task.rb
+- test/helper.rb
+- test/test_pivotal-tracker-api.rb
+homepage: http://github.com/atljeremy/pivotal-tracker-api
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.0.8
+signing_key: 
+specification_version: 4
+summary: A ruby gem to communicate with the Picotal Tracker API v5
+test_files: []