tracker_api 1.0.0 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 3fbc8caee5a56cdf59e58fc545d0390f76685dc2
-  data.tar.gz: cae843ef9bdc193e763d440db310a79e9fb7fe4a
+  metadata.gz: 0c36830bc748e4e3d5a45d61f64ba9df00e4f6d2
+  data.tar.gz: 15b700b9490e7b950862bc23ef55d7965e7de984
 SHA512:
-  metadata.gz: 81a23229a778910df741e89fea770bec3096cadeb85c40dc9f79b587fc8fa1e6617c4e853f7f0722d6eb6037162276d49a6f6132e0501a8dfd0fdd1aa6db2e58
-  data.tar.gz: 5be684a973dd96a30c032fd50179790505bab01ba8be8a61d0fb7b9a9bd30ec8a25bb697b8836764f116e7c0070f130d21d69f548e7e80c67ea171c19e4da36c
+  metadata.gz: 0411d1435854aa5c42dd379340caed6fb4e515e6279d873af31398088d871314d05f06a1bc153a56936c467a5ee208fc921fcabd652a2df8d84dfcfe581e8da0
+  data.tar.gz: 526003eba259c2f63e49aa0ffdb428ef723bfe438b2a88440b351d2aa01cad084a096591b3c858441d0dce88922b8dd816b2f5a9f2df64ddf8cb1d9cad2f99d7

data/.travis.yml

@@ -4,9 +4,7 @@ rvm:
   - "2.0.0"
   - "2.1.0"
   - "2.2.3"
-  # Faraday::ConnectionFailed: Could not generate DH keypair (Java::JavaLang::RuntimeException)
-  # http://bugs.java.com/bugdatabase/view_bug.do?bug_id=7044060
-  - "jruby"
+  # - "jruby"
   #  - rbx
   #  - "1.8.7"
 # uncomment this line if your project needs to run something other than `rake`:

data/README.md

@@ -59,8 +59,11 @@ story.save                                                                # Save
 story = TrackerApi::Resources::Story.new( client:     client,
                                           project_id: 123456,
                                           id:         847762630)          # Use the Story resource to get the story
-comments = story.comments                                                 # comments without first fetching the story.
+comments = story.comments                                                 #   comments without first fetching the story
 
+task = story.tasks.first                                                  # Get story tasks
+task.complete = true
+task.save                                                                 # Mark a task complete
 
 epics = project.epics                                                     # Get all epics for a project
 epic  = epics.first
@@ -86,6 +89,17 @@ story.comments(fields: ':default,person')                                 # Eage
 - Add missing resources and endpoints
 - Add create, update, delete for resources
 
+## Semantic Versioning
+http://semver.org/
+
+Given a version number MAJOR.MINOR.PATCH, increment the:
+
+1. MAJOR version when you make incompatible API changes,
+2. MINOR version when you add functionality in a backwards-compatible manner, and
+3. PATCH version when you make backwards-compatible bug fixes.
+
+Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.
+
 ## Contributing
 
 Currently this client supports read-only access to Pivotal Tracker.

data/lib/tracker_api/endpoints/task.rb

@@ -9,7 +9,18 @@ module TrackerApi
 
       def create(project_id, story_id, params={})
         data = client.post("/projects/#{project_id}/stories/#{story_id}/tasks", params: params).body
-        Resources::Task.new(data)
+        Resources::Task.new({ client: client }.merge(data))
+      end
+
+      def update(task, params={})
+        raise ArgumentError, 'Valid task required to update.' unless task.instance_of?(Resources::Task)
+
+        data = client.put("/projects/#{task.project_id}/stories/#{task.story_id}/tasks/#{task.id}",
+                          params: params).body
+
+        task.attributes = data
+        task.clean!
+        task
       end
     end
   end

data/lib/tracker_api/endpoints/tasks.rb

@@ -12,7 +12,9 @@ module TrackerApi
         raise Errors::UnexpectedData, 'Array of tasks expected' unless data.is_a? Array
 
         data.map do |task|
-          Resources::Task.new({ story_id: story_id }.merge(task))
+          Resources::Task.new({ client: client,
+                                project_id: project_id,
+                                story_id: story_id }.merge(task))
         end
       end
     end

data/lib/tracker_api/resources/task.rb

@@ -3,6 +3,9 @@ module TrackerApi
     class Task
       include Shared::Base
 
+      attribute :client
+
+      attribute :project_id, Integer
       attribute :story_id, Integer
       attribute :description, String
       attribute :complete, Boolean
@@ -10,6 +13,22 @@ module TrackerApi
       attribute :created_at, DateTime
       attribute :updated_at, DateTime
       attribute :kind, String
+
+      class UpdateRepresenter < Representable::Decorator
+        include Representable::JSON
+
+        property :id
+        property :description
+        property :complete
+        property :position
+      end
+
+      def save
+        raise ArgumentError, 'Cannot update a task with an unknown project_id.' if project_id.nil?
+        raise ArgumentError, 'Cannot update a task with an unknown story_id.' if story_id.nil?
+
+        Endpoints::Task.new(client).update(self, UpdateRepresenter.new(Task.new(self.dirty_attributes)))
+      end
     end
   end
 end

data/lib/tracker_api/version.rb

@@ -1,3 +1,3 @@
 module TrackerApi
-  VERSION = '1.0.0'
+  VERSION = '1.1.0'
 end

data/test/task_test.rb

@@ -0,0 +1,27 @@
+require_relative 'minitest_helper'
+
+describe TrackerApi::Resources::Task do
+  let(:pt_user) { PT_USER_1 }
+  let(:client) { TrackerApi::Client.new token: pt_user[:token] }
+  let(:project_id) { pt_user[:project_id] }
+  let(:project) { VCR.use_cassette('get project') { client.project(project_id) } }
+  let(:story_id) { '66728004' }
+  let(:story) { VCR.use_cassette('get story') { project.story(story_id) } }
+  let(:tasks) { VCR.use_cassette('get tasks', record: :new_episodes) {
+                  VCR.use_cassette('get tasks for story') { story.tasks } } }
+  let(:task) { tasks.first }
+
+  it 'can update an existing task' do
+    new_description = "#{task.description}+"
+    task.description = new_description
+    task.complete = true
+
+    VCR.use_cassette('save task', record: :new_episodes) do
+      task.save
+    end
+
+    task.description.must_equal new_description
+    task.complete.must_equal true
+    task.clean?.must_equal true
+  end
+end

data/test/vcr/cassettes/save_task.json

@@ -0,0 +1 @@
+{"http_interactions":[{"request":{"method":"put","uri":"https://www.pivotaltracker.com/services/v5/projects/1027488/stories/66728004/tasks/22778038","body":{"encoding":"UTF-8","string":"{\"description\":\"Check unscaled+\",\"complete\":true}"},"headers":{"User-Agent":["Ruby/2.1.3 (x86_64-darwin15.0; ruby) TrackerApi/1.0.0 Faraday/0.9.2"],"X-TrackerToken":["d55c3bc1f74346b843ca84ba340b29bf"],"Content-Type":["application/json"]}},"response":{"status":{"code":200,"message":null},"headers":{"Content-Type":["application/json; charset=utf-8"],"Status":["200 OK"],"Cache-Control":["max-age=0, private, must-revalidate"],"Date":["Fri, 18 Mar 2016 19:14:30 GMT"],"X-Tracker-Project-Version":["122"],"X-Request-Id":["8e0ec08fef65b2f8fa9bae27a697c8db"],"X-UA-Compatible":["IE=Edge,chrome=1"],"ETag":["\"914ce4063b95be351bc4878e1242b175\""],"X-Runtime":["0.175452"],"X-Rack-Cache":["invalidate, pass"],"X-Powered-By":["Phusion Passenger Enterprise"],"Server":["nginx + Phusion Passenger"],"Access-Control-Allow-Origin":["*"],"Access-Control-Allow-Credentials":["false"],"Access-Control-Allow-Methods":["GET, POST, PUT, DELETE, OPTIONS"],"Access-Control-Allow-Headers":["X-TrackerToken,DNT,X-Mx-ReqToken,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type,X-Tracker-Warn-Unless-Project-Version-Is"],"X-Tracker-Client-Pinger-Interval":["12"]},"body":{"encoding":"UTF-8","string":"{\"kind\":\"task\",\"id\":22778038,\"story_id\":66728004,\"description\":\"Check unscaled+\",\"complete\":true,\"position\":1,\"created_at\":\"2014-06-02T12:44:52Z\",\"updated_at\":\"2016-03-18T19:14:30Z\"}"},"http_version":null},"recorded_at":"Fri, 18 Mar 2016 19:14:30 GMT"}],"recorded_with":"VCR 3.0.1"}

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tracker_api
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.1.0
 platform: ruby
 authors:
 - Forest Carlisle
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-02-18 00:00:00.000000000 Z
+date: 2016-03-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bundler
@@ -268,6 +268,7 @@ files:
 - test/minitest_helper.rb
 - test/project_test.rb
 - test/story_test.rb
+- test/task_test.rb
 - test/vcr/cassettes/client_done_iterations_with_pagination.json
 - test/vcr/cassettes/client_get_all_stories_with_pagination.json
 - test/vcr/cassettes/client_get_limited_stories_with_no_pagination.json
@@ -304,6 +305,7 @@ files:
 - test/vcr/cassettes/save_story.json
 - test/vcr/cassettes/save_story_with_multiple_changes.json
 - test/vcr/cassettes/save_story_with_new_label.json
+- test/vcr/cassettes/save_task.json
 - test/vcr/cassettes/update_story_to_create_activity.json
 - tracker_api.gemspec
 homepage: https://github.com/dashofcode/tracker_api
@@ -335,6 +337,7 @@ test_files:
 - test/minitest_helper.rb
 - test/project_test.rb
 - test/story_test.rb
+- test/task_test.rb
 - test/vcr/cassettes/client_done_iterations_with_pagination.json
 - test/vcr/cassettes/client_get_all_stories_with_pagination.json
 - test/vcr/cassettes/client_get_limited_stories_with_no_pagination.json
@@ -371,4 +374,5 @@ test_files:
 - test/vcr/cassettes/save_story.json
 - test/vcr/cassettes/save_story_with_multiple_changes.json
 - test/vcr/cassettes/save_story_with_new_label.json
+- test/vcr/cassettes/save_task.json
 - test/vcr/cassettes/update_story_to_create_activity.json