asana 0.0.4 → 0.0.5

checksums.yaml

@@ -0,0 +1,15 @@
+---
+!binary "U0hBMQ==":
+  metadata.gz: !binary |-
+    YWVkYTQzZjIzNWRmYWY4OWE1OWUyN2E4ZDIzY2MyOWYzMmE3MzI5Zg==
+  data.tar.gz: !binary |-
+    NjU1MzU5MGIwM2RhMWE3ZGUzZDQxMTdkZjE5NTY2MTZmYmQ5YjkyMQ==
+!binary "U0hBNTEy":
+  metadata.gz: !binary |-
+    NWUxMWUwMWIwZWFkMTdkODUxOTM1N2Q3YjYyNmE0NmFjYjIwOTYxNGNlOTk3
+    MDQyYTQ3ODg5ZTllZjhlZDE0ZmZkOTNmMWM5NGEyZTMyYTU1MTc0NjlmYzA3
+    OTg0OGE1Y2JmZDQ3NTljYzdjN2U0OTk5YmJkNmUwOTM1NDc0ZWY=
+  data.tar.gz: !binary |-
+    M2E3YjUwNDE1YWJmYTRiMmZkMjA1OTYyYjVkMDc3NDdiZThhYzdlZTMwMTA0
+    ZDk5Y2QxNWUyZTA0ZDQzMGJkMmFiMTRkMDVjMmQ1ZTAwMDRkMGExY2U3Yjg2
+    M2U3NGUyNmYxMDJlYmQxODNiNTI5YzZiOGE0ZWNiZjA3YjJmMjY=

data/README.md

@@ -87,11 +87,17 @@ tasks = workspace.tasks(:user_id)
 # Get all users with access to a given workspace
 users = workspace.users
 
+# Get all tags in a given workspace
+tags = workspace.tags
+
 # Create a new task in a given workspace and assign it to the current user
 workspace.create_task(:name => 'Get milk from the grocery store')
 
 # Create a new project in a given workspace, current user as a watcher
 workspace.create_project(:name => 'Upgrade Asana gem')
+
+# Create a new tag in a given workspace
+workspace.create_tag(:name => 'Programming')
 ```
 
 ### [Projects][]
@@ -133,6 +139,10 @@ tasks = project.tasks
 workspace = Asana::Workspace.find(:workspace_id)
 tasks = workspace.tasks
 
+# Get all tasks with a given tag
+tag = Asana::Tag.find(:tag_id)
+tasks = tag.tasks
+
 # Get all stories for a given task
 task = tasks.first
 stories = task.stories
@@ -147,6 +157,33 @@ task.create_story(story_settings)
 task.add_project(project.id)
 ```
 
+### [Tags][]
+
+> A tag is a label that can be attached to any task in Asana. It exists in
+> a single workspace or organization.
+>
+> Tags have some metadata associated with them, but it is possible that we will
+> simplify them in the future so it is not encouraged to rely too heavily on
+> it. Unlike projects, tags do not provide any ordering on the tasks they are
+> associated with.
+
+```ruby
+# Get all tags in a given workspace
+workspace = Asana::Workspace.find(:workspace_id)
+tags = workspace.tags
+
+# Get all tasks with a given tag
+tag = Asana::Tag.find(:tag_id)
+tasks = tag.tasks
+
+# Create a new tag in a given workspace
+workspace.create_tag(:name => 'Programming')
+
+# Update a tag
+tag = Asana::Tag.find(:tag_id)
+tag.modify(:name => 'Development')
+```
+
 ### [Stories][]
 
 > A story represents an activity associated with an object in the Asana
@@ -167,7 +204,6 @@ story = Story.find(:story_id)
 
 # Create a new story for the given task/project
 task.create_story(story_settings)
-project.create_story(story_settings)
 ```
 
 ## Contributing
@@ -186,3 +222,4 @@ project.create_story(story_settings)
 [Projects]: http://developer.asana.com/documentation/#projects
 [Tasks]: http://developer.asana.com/documentation/#tasks
 [Stories]: http://developer.asana.com/documentation/#stories
+[Tags]: http://developer.asana.com/documentation/#tags

data/asana.gemspec

@@ -10,8 +10,7 @@ Gem::Specification.new do |gem|
 
   gem.add_dependency 'activeresource', '~> 3.2.3'
 
-  gem.add_development_dependency 'growl', '~> 1.0.3'
-  gem.add_development_dependency 'guard-minitest', '~> 0.5.0'
+  gem.add_development_dependency 'guard-minitest', '~> 1.0.0'
   gem.add_development_dependency 'minitest', '~> 2.12.1'
   gem.add_development_dependency 'rake', '~> 0.9.2.2'
   gem.add_development_dependency 'vcr', '~> 2.1.0'

data/lib/asana.rb

@@ -4,6 +4,7 @@ require 'asana/config'
 require 'asana/version'
 
 require 'asana/resources/project'
+require 'asana/resources/tag'
 require 'asana/resources/story'
 require 'asana/resources/task'
 require 'asana/resources/user'

data/lib/asana/resources/project.rb

@@ -23,13 +23,6 @@ module Asana
       response = Project.put(self.id, nil, resource.to_json)
       Project.new(connection.format.decode(response.body))
     end
-    
-    def create_story(*args)
-      path = "#{self.id}/stories"
-      story = Story.new(args.first)
-      response = Project.post(path, nil, story.to_json)
-      Story.new(connection.format.decode(response.body))
-    end    
 
   end
 end

data/lib/asana/resources/tag.rb

@@ -0,0 +1,28 @@
+module Asana
+  class Tag < Asana::Resource
+
+    alias :create :method_not_allowed
+    alias :destroy :method_not_allowed
+
+    def self.all_by_task(*args)
+      parent_resources :task
+      all(*args)
+    end
+
+    def self.all_by_workspace(*args)
+      parent_resources :workspace
+      all(*args)
+    end
+
+    def tasks
+      Task.all_by_tag(:params => { :tag_id => self.id })
+    end
+
+    def modify(modified_fields)
+      resource = Resource.new(modified_fields)
+      response = Tag.put(self.id, nil, resource.to_json)
+      Tag.new(connection.format.decode(response.body))
+    end
+
+  end
+end

data/lib/asana/resources/task.rb

@@ -6,6 +6,11 @@ module Asana
       all(*args)
     end
 
+    def self.all_by_tag(*args)
+      parent_resources :tag
+      all(*args)
+    end
+
     def self.all_by_workspace(*args)
       parent_resources :workspace
       all(*args)
@@ -21,6 +26,10 @@ module Asana
       Project.all_by_task(:params => { :task_id => self.id })
     end
 
+    def tags
+      Tag.all_by_task(:params => { :task_id => self.id })
+    end
+
     def add_project(project_id)
       path = "#{self.id}/addProject"
       resource = Resource.new({:project => project_id})
@@ -28,6 +37,13 @@ module Asana
       self
     end
 
+    def add_tag(tag_id)
+      path = "#{self.id}/addTag"
+      resource = Resource.new({:tag => tag_id})
+      Task.post(path, nil, resource.to_json)
+      self
+    end
+
     def create_story(*args)
       path = "#{self.id}/stories"
       options = { :task => self.id }
@@ -40,5 +56,18 @@ module Asana
       Story.all_by_task(:params => { :task_id => self.id })
     end
 
+    def create_subtask(*args)
+      path = "#{self.id}/subtasks"
+      options = { :task => self.id }
+      task = Task.new(options.merge(args.first))
+      response = Task.post(path, nil, task.to_json)
+      Task.new(connection.format.decode(response.body).merge parent: self)
+    end
+
+    def subtasks
+      path = "#{self.id}/subtasks"
+      Task.get(path, nil).map { |subtask| Task.new(subtask.merge(parent: self)) }
+    end
+
   end
 end

data/lib/asana/resources/workspace.rb

@@ -27,6 +27,17 @@ module Asana
       Task.new(connection.format.decode(response.body))
     end
 
+    def tags
+      Tag.all_by_workspace(:params => { :workspace_id => self.id })
+    end
+
+    def create_tag(*args)
+      options = { :workspace => self.id }
+      tag = Tag.new(options.merge(args.first))
+      response = Tag.post(nil, nil, tag.to_json)
+      Tag.new(connection.format.decode(response.body))
+    end
+
     def users
       User.all_by_workspace(:params => { :workspace_id => self.id })
     end

data/lib/asana/version.rb

@@ -1,3 +1,3 @@
 module Asana
-  VERSION = "0.0.4"
+  VERSION = "0.0.5"
 end

data/spec/asana/resources/project_spec.rb

@@ -59,13 +59,5 @@ module Asana
       end
     end
 
-    describe '#create_story' do
-      it 'should create a new story for the given project' do
-        project = Workspace.all.first.create_project(:name => 'asana-test-project-story')
-        story = project.create_story(:text => 'foo')
-        story.must_be_instance_of Story
-      end
-    end    
-
   end
 end

data/spec/asana/resources/tag_spec.rb

@@ -0,0 +1,63 @@
+require_relative '../../spec_helper'
+
+module Asana
+  describe Tag do
+
+    before do
+      VCR.insert_cassette('tags', :record => :all)
+      Asana.configure do |c|
+        c.api_key = ENV['ASANA_API_KEY']
+      end
+    end
+
+    after do
+      VCR.eject_cassette
+    end
+
+    describe '.all' do
+      it 'should return all of the user\'s tags' do
+        tags = Tag.all
+        tags.must_be_instance_of Array
+        tags.first.must_be_instance_of Tag
+      end
+    end
+
+    describe '.create' do
+      it 'should raise an ActiveResource::MethodNotAllowed exception' do
+        tag = Tag.new
+        lambda { tag.save }.must_raise ActiveResource::MethodNotAllowed
+      end
+    end
+
+    describe '.find' do
+      it 'should return a single tag' do
+        tag = Tag.find(Tag.all.first.id)
+        tag.must_be_instance_of Tag
+      end
+    end
+
+    describe '#destroy' do
+      it 'should raise an ActiveResource::MethodNotAllowed exception' do
+        tag = Tag.all.first
+        lambda { tag.destroy}.must_raise ActiveResource::MethodNotAllowed
+      end
+    end
+
+    describe '#modify' do
+      it 'should modify the given tag with a new name' do
+        tag = Workspace.all.first.create_tag(:name => 'asana-test-tag-foo')
+        tag.modify(:name => 'asana-test-tag-bar').name.must_equal 'asana-test-tag-bar'
+      end
+    end
+
+    describe '#tasks' do
+      it 'should return all tasks for the given tag' do
+        tag = Tag.all.first
+        tasks = tag.tasks
+        tasks.must_be_instance_of Array
+        tasks.first.must_be_instance_of Task
+      end
+    end
+
+  end
+end

data/spec/asana/resources/task_spec.rb

@@ -44,7 +44,15 @@ module Asana
         task.add_project project.id
       end
     end
-    
+
+    describe '#add_tag' do
+      it 'should add the tag to the given task' do
+        task = Workspace.all.first.create_task(:name => 'asana-test-task-add-tag', :assignee => 'me')
+        tag = Workspace.all.first.create_tag(:name => 'asana-test-task-parent-tag')
+        task.add_tag tag.id
+      end
+    end
+
     describe '#create_story' do
       it 'should create a new story for the given task' do
         task = Project.all.first.tasks.first
@@ -62,5 +70,26 @@ module Asana
       end
     end
 
+    describe '#create_subtask' do
+      it 'should create a new subtask for the given task' do
+        task = Project.all.first.tasks.first
+        subtask = task.create_subtask(:name => 'asana-test-subtask', :assignee => 'me')
+        subtask.must_be_instance_of Task
+        subtask.parent.must_be_instance_of Task
+        subtask.parent.id.must_equal task.id
+      end
+    end
+
+    describe '#subtasks' do
+      it 'should return all subtasks for the given task' do
+        task = Project.all.first.tasks.first
+        subtasks = task.subtasks
+        subtasks.must_be_instance_of Array
+        subtasks.first.must_be_instance_of Task
+        subtasks.first.parent.must_be_instance_of Task
+        subtasks.first.parent.id.must_equal task.id
+      end
+    end
+
   end
 end

data/spec/asana/resources/workspace_spec.rb

@@ -50,7 +50,7 @@ module Asana
         project = workspace.create_project(:name => 'asana-test-project')
         project.must_be_instance_of Project
       end
-    end    
+    end
 
     describe '#update' do
       it 'should update the given workspace with a new name' do
@@ -76,6 +76,15 @@ module Asana
       end
     end
 
+    describe '#tags' do
+      it 'should return all tags for the given workspace' do
+        workspace = Workspace.all.first
+        tags = workspace.tags
+        tags.must_be_instance_of Array
+        tags.first.must_be_instance_of Tag
+      end
+    end
+
     describe '#tasks' do
       it 'should return all tasks for the given workspace' do
         workspace = Workspace.all.first

metadata

@@ -1,20 +1,18 @@
 --- !ruby/object:Gem::Specification
 name: asana
 version: !ruby/object:Gem::Version
-  version: 0.0.4
-  prerelease: 
+  version: 0.0.5
 platform: ruby
 authors:
 - Ryan Bright
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-25 00:00:00.000000000 Z
+date: 2013-07-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activeresource
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -22,47 +20,27 @@ dependencies:
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
         version: 3.2.3
-- !ruby/object:Gem::Dependency
-  name: growl
-  requirement: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.0.3
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    none: false
-    requirements:
-    - - ~>
-      - !ruby/object:Gem::Version
-        version: 1.0.3
 - !ruby/object:Gem::Dependency
   name: guard-minitest
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 1.0.0
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
-        version: 0.5.0
+        version: 1.0.0
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -70,7 +48,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -78,7 +55,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -86,7 +62,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -94,7 +69,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: vcr
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -102,7 +76,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -110,7 +83,6 @@ dependencies:
 - !ruby/object:Gem::Dependency
   name: webmock
   requirement: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -118,7 +90,6 @@ dependencies:
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
-    none: false
     requirements:
     - - ~>
       - !ruby/object:Gem::Version
@@ -142,45 +113,46 @@ files:
 - lib/asana/resource.rb
 - lib/asana/resources/project.rb
 - lib/asana/resources/story.rb
+- lib/asana/resources/tag.rb
 - lib/asana/resources/task.rb
 - lib/asana/resources/user.rb
 - lib/asana/resources/workspace.rb
 - lib/asana/version.rb
 - spec/asana/resources/project_spec.rb
 - spec/asana/resources/story_spec.rb
+- spec/asana/resources/tag_spec.rb
 - spec/asana/resources/task_spec.rb
 - spec/asana/resources/user_spec.rb
 - spec/asana/resources/workspace_spec.rb
 - spec/spec_helper.rb
 homepage: http://github.com/rbright/asana
 licenses: []
+metadata: {}
 post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
-  none: false
   requirements:
   - - ! '>='
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
 rubyforge_project: 
-rubygems_version: 1.8.23
+rubygems_version: 2.0.5
 signing_key: 
-specification_version: 3
+specification_version: 4
 summary: Ruby wrapper for the Asana REST API
 test_files:
 - spec/asana/resources/project_spec.rb
 - spec/asana/resources/story_spec.rb
+- spec/asana/resources/tag_spec.rb
 - spec/asana/resources/task_spec.rb
 - spec/asana/resources/user_spec.rb
 - spec/asana/resources/workspace_spec.rb
 - spec/spec_helper.rb
-has_rdoc: