asana 0.3.0 → 0.4.0

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    YmFmMWNhNTVhYWY5NjkwYmQ3YjA4NWE4NzJkMDhmNWY1YjJhNTBmZA==
+    MGY4ZTk0NDM4YmM4MmU3MjVjZTQ2NDM3ZGYzZWU5YTg3NWNhYzc4Yg==
   data.tar.gz: !binary |-
-    N2VhZDRkN2YyMDQ2NGE2ZmVkYTU4NGVhOGUwYmM2YmQyZGEyOWZiNA==
+    NTNlYzI5OTg1MWY4YzA1ODAxMGYyNjk5MDUxODZiZDU5YTI4YzUxMA==
 SHA512:
   metadata.gz: !binary |-
-    YzY0MzQxYjZhMzhlOWYxOTBkNTViMWY3M2ZkMWE5YmU4OTUyODNjZmUxYzYz
-    MWNkMWU4YjIzYzFhZGJmODIyZDI1ZmM1ZGE0YzdiMTU2OWJhNzdlZjFiOGIw
-    ZmE5MzY5MDFjODVmNjg0NDI3M2FmNDkzNjM0NWQ1YjM4NmUxMzQ=
+    ZGMwNWM0NjI2ZjhlZmVlZjk3MzA3ZTE5ODhmMjA2ZGM4YzY3ZGEwYThmMDlk
+    ZmJhOWY4MjAxNGEwNGI1MjFmODc1YzBiYjUzYzE4NDIxNjE3YTgwOGFmM2Yy
+    NmYzNDAyMDBlNDYwYjZmMDkwN2QyZWEyNzY3MWY5YmYwZjEzYzA=
   data.tar.gz: !binary |-
-    YTczZDZlNzRiZDhjNThkMDZjM2MwZjgyZGQ1YjgzYjhlYmEzMjMwYTljYjFl
-    NjU4MzQ2YmQ1MGFiNWFkZWJjNTBiMzBlMGM1MTk1ZTNiMmIzOWUyNTE5ZWZk
-    YWQxZjFjMzllYTY5OWZjZmUzZGZiMGJlY2RlZTVjYmM2OTZhZjY=
+    Mjk3OGIzNDY1ZjI0NDg0ZWIxMDU2NGU5YmU3YzJhYzIwMzZjNTk3M2E5ODU0
+    YWY1ZjRjZWFiOTZlYjFkNGExMTVmOWZmNzY5YmNjYTYyODE0ODU2YzlmMzIx
+    NjJmZWFhYTE5NmNmMzYzZmUxMmRjNzkwMGE1ODJkNzA4ODhhNjY=

data/README.md

@@ -351,5 +351,5 @@ to make a release, as they'll need to run a release script from the
 
 [apidocs]: https://asana.com/developers
 [io]: https://asana.com/developers/documentation/getting-started/input-output-options
-[docs]: https://asana.github.com/ruby-asana
+[docs]: http://www.rubydoc.info/github/Asana/ruby-asana/master
 [meta]: https://github.com/asana/asana-api-meta

data/lib/asana/resources/project.rb

@@ -16,17 +16,27 @@ module Asana
       include EventSubscription
 
 
+      attr_reader :name
+
       attr_reader :id
 
-      attr_reader :archived
+      attr_reader :owner
 
-      attr_reader :created_at
+      attr_reader :current_status
 
-      attr_reader :followers
+      attr_reader :due_date
+
+      attr_reader :created_at
 
       attr_reader :modified_at
 
-      attr_reader :name
+      attr_reader :archived
+
+      attr_reader :public
+
+      attr_reader :members
+
+      attr_reader :followers
 
       attr_reader :color
 
@@ -186,6 +196,49 @@ module Asana
         Collection.new(parse(client.get("/projects/#{id}/tasks", params: params, options: options)), type: Task, client: client)
       end
 
+      # Adds the specified list of users as followers to the project. Followers are a subset of members, therefore if
+      # the users are not already members of the project they will also become members as a result of this operation.
+      # Returns the updated project record.
+      #
+      # followers - [Array] An array of followers to add to the project.
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def add_followers(followers: required("followers"), options: {}, **data)
+        with_params = data.merge(followers: followers).reject { |_,v| v.nil? || Array(v).empty? }
+        refresh_with(parse(client.post("/projects/#{id}/addFollowers", body: with_params, options: options)).first)
+      end
+
+      # Removes the specified list of users from following the project, this will not affect project membership status.
+      # Returns the updated project record.
+      #
+      # followers - [Array] An array of followers to remove from the project.
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def remove_followers(followers: required("followers"), options: {}, **data)
+        with_params = data.merge(followers: followers).reject { |_,v| v.nil? || Array(v).empty? }
+        refresh_with(parse(client.post("/projects/#{id}/removeFollowers", body: with_params, options: options)).first)
+      end
+
+      # Adds the specified list of users as members of the project. Returns the updated project record.
+      #
+      # members - [Array] An array of members to add to the project.
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def add_members(members: required("members"), options: {}, **data)
+        with_params = data.merge(members: members).reject { |_,v| v.nil? || Array(v).empty? }
+        refresh_with(parse(client.post("/projects/#{id}/addMembers", body: with_params, options: options)).first)
+      end
+
+      # Removes the specified list of members from the project. Returns the updated project record.
+      #
+      # members - [Array] An array of members to remove from the project.
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def remove_members(members: required("members"), options: {}, **data)
+        with_params = data.merge(members: members).reject { |_,v| v.nil? || Array(v).empty? }
+        refresh_with(parse(client.post("/projects/#{id}/removeMembers", body: with_params, options: options)).first)
+      end
+
     end
   end
 end

data/lib/asana/resources/story.rb

@@ -41,16 +41,6 @@ module Asana
           'stories'
         end
 
-        # Returns the full record for a single story.
-        #
-        # id - [Id] Globally unique identifier for the story.
-        #
-        # options - [Hash] the request I/O options.
-        def find_by_id(client, id, options: {})
-
-          self.new(parse(client.get("/stories/#{id}", options: options)).first, client: client)
-        end
-
         # Returns the compact records for all stories on the task.
         #
         # task - [Id] Globally unique identifier for the task.
@@ -62,6 +52,16 @@ module Asana
           Collection.new(parse(client.get("/tasks/#{task}/stories", params: params, options: options)), type: self, client: client)
         end
 
+        # Returns the full record for a single story.
+        #
+        # id - [Id] Globally unique identifier for the story.
+        #
+        # options - [Hash] the request I/O options.
+        def find_by_id(client, id, options: {})
+
+          self.new(parse(client.get("/stories/#{id}", options: options)).first, client: client)
+        end
+
         # Adds a comment to a task. The comment will be authored by the
         # currently authenticated user, and timestamped when the server receives
         # the request.

data/lib/asana/resources/task.rb

@@ -54,6 +54,8 @@ module Asana
 
       attr_reader :memberships
 
+      attr_reader :tags
+
       class << self
         # Returns the plural name of the resource.
         def plural_name
@@ -125,7 +127,7 @@ module Asana
         # Returns the compact task records for some filtered set of tasks. Use one
         # or more of the parameters provided to filter the tasks returned.
         #
-        # assignee - [Id] The assignee to filter tasks on.
+        # assignee - [String] The assignee to filter tasks on.
         # workspace - [Id] The workspace or organization to filter tasks on.
         # completed_since - [String] Only return tasks that are either incomplete or that have been
         # completed since this time.

data/lib/asana/resources/team.rb

@@ -50,6 +50,36 @@ module Asana
         Collection.new(parse(client.get("/teams/#{id}/users", params: params, options: options)), type: User, client: client)
       end
 
+      # The user making this call must be a member of the team in order to add others.
+      # The user to add must exist in the same organization as the team in order to be added.
+      # The user to add can be referenced by their globally unique user ID or their email address.
+      # Returns the full user record for the added user.
+      #
+      # user - [String] An identifier for the user. Can be one of an email address,
+      # the globally unique identifier for the user, or the keyword `me`
+      # to indicate the current user making the request.
+      #
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def add_user(user: required("user"), options: {}, **data)
+        with_params = data.merge(user: user).reject { |_,v| v.nil? || Array(v).empty? }
+        User.new(parse(client.post("/teams/#{id}/addUser", body: with_params, options: options)).first, client: client)
+      end
+
+      # The user to remove can be referenced by their globally unique user ID or their email address.
+      # Removes the user from the specified team. Returns an empty data record.
+      #
+      # user - [String] An identifier for the user. Can be one of an email address,
+      # the globally unique identifier for the user, or the keyword `me`
+      # to indicate the current user making the request.
+      #
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def remove_user(user: required("user"), options: {}, **data)
+        with_params = data.merge(user: user).reject { |_,v| v.nil? || Array(v).empty? }
+        client.post("/teams/#{id}/removeUser", body: with_params, options: options) && true
+      end
+
     end
   end
 end

data/lib/asana/resources/user.rb

@@ -38,12 +38,14 @@ module Asana
 
         # Returns the full user record for the single user with the provided ID.
         #
-        # id - [Id] Globally unique identifier for the user.
+        # user - [String] An identifier for the user. Can be one of an email address,
+        # the globally unique identifier for the user, or the keyword `me`
+        # to indicate the current user making the request.
         #
         # options - [Hash] the request I/O options.
-        def find_by_id(client, id, options: {})
-
-          self.new(parse(client.get("/users/#{id}", options: options)).first, client: client)
+        def find_by_id(client, user: required("user"), options: {})
+          params = { user: user }.reject { |_,v| v.nil? || Array(v).empty? }
+          Resource.new(parse(client.get("/users/%s", params: params, options: options)).first, client: client)
         end
 
         # Returns the user records for all users in the specified workspace or

data/lib/asana/resources/workspace.rb

@@ -92,6 +92,34 @@ module Asana
         Collection.new(parse(client.get("/workspaces/#{id}/typeahead", params: params, options: options)), type: Resource, client: client)
       end
 
+      # The user can be referenced by their globally unique user ID or their email address.
+      # Returns the full user record for the invited user.
+      #
+      # user - [String] An identifier for the user. Can be one of an email address,
+      # the globally unique identifier for the user, or the keyword `me`
+      # to indicate the current user making the request.
+      #
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def add_user(user: required("user"), options: {}, **data)
+        with_params = data.merge(user: user).reject { |_,v| v.nil? || Array(v).empty? }
+        User.new(parse(client.post("/workspaces/#{id}/addUser", body: with_params, options: options)).first, client: client)
+      end
+
+      # The user making this call must be an admin in the workspace.
+      # Returns an empty data record.
+      #
+      # user - [String] An identifier for the user. Can be one of an email address,
+      # the globally unique identifier for the user, or the keyword `me`
+      # to indicate the current user making the request.
+      #
+      # options - [Hash] the request I/O options.
+      # data - [Hash] the attributes to post.
+      def remove_user(user: required("user"), options: {}, **data)
+        with_params = data.merge(user: user).reject { |_,v| v.nil? || Array(v).empty? }
+        client.post("/workspaces/#{id}/removeUser", body: with_params, options: options) && true
+      end
+
     end
   end
 end

data/lib/asana/version.rb

@@ -1,5 +1,5 @@
 #:nodoc:
 module Asana
   # Public: Version of the gem.
-  VERSION = '0.3.0'
+  VERSION = '0.4.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: asana
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Txus
 autorequire: 
 bindir: exe
 cert_chain: []
-date: 2015-09-02 00:00:00.000000000 Z
+date: 2015-10-20 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: oauth2