asana 2.0.0 → 2.0.2

data/lib/asana/resource_includes/resource.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require_relative 'registry'
 require_relative 'response_helper'
 
@@ -21,6 +23,7 @@ module Asana
       def refresh
         raise "#{self.class.name} does not respond to #find_by_id" unless \
           self.class.respond_to?(:find_by_id)
+
         self.class.find_by_id(client, gid)
       end
 
@@ -30,17 +33,17 @@ module Asana
       # Returns the value for the requested property.
       #
       # Raises a NoMethodError if the property doesn't exist.
-      def method_missing(m, *args)
-        super unless respond_to_missing?(m, *args)
-        cache(m, wrapped(to_h[m.to_s]))
+      def method_missing(method_name, *args)
+        super unless respond_to_missing?(method_name, *args)
+        cache(method_name, wrapped(to_h[method_name.to_s]))
       end
 
       # Internal: Guard for the method_missing proxy. Checks if the resource
       # actually has a specific piece of data at all.
       #
       # Returns true if the resource has the property, false otherwise.
-      def respond_to_missing?(m, *)
-        to_h.key?(m.to_s)
+      def respond_to_missing?(method_name, *)
+        to_h.key?(method_name.to_s)
       end
 
       # Public:

data/lib/asana/resource_includes/response_helper.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 module Asana
   module Resources
     # Internal: A helper to make response body parsing easier.

data/lib/asana/resources/audit_log_api.rb

@@ -0,0 +1,42 @@
+require_relative 'gen/audit_log_api_base'
+
+module Asana
+  module Resources
+    class AuditLogAPI < AuditLogAPIBase
+
+
+      attr_reader :gid
+
+      attr_reader :actor
+
+      attr_reader :context
+      
+      attr_reader :api_authentication_method
+
+      attr_reader :client_ip_address
+      
+      attr_reader :context_type
+
+      attr_reader :oauth_app_name
+
+      attr_reader :user_agent
+
+      attr_reader :created_at
+
+      attr_reader :details
+
+      attr_reader :event_category
+
+      attr_reader :event_type
+
+      attr_reader :resource
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'audit_log_apis'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/gen/attachments_base.rb

@@ -39,7 +39,7 @@ module Asana
         # Get attachments from an object
         #
 
-        # parent - [str]  (required) Globally unique identifier for object to fetch statuses from. Must be a GID for a task, project, or project_brief.
+        # parent - [str]  (required) Globally unique identifier for object to fetch statuses from. Must be a GID for a `project`, `project_brief`, or `task`.
         # options - [Hash] the request I/O options
         # > offset - [str]  Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. 'Note: You can only pass in an offset that was returned to you via a previously paginated request.'
         # > limit - [int]  Results per page. The number of objects to return per page. The value must be between 1 and 100.

data/lib/asana/resources/gen/audit_log_api_base.rb

@@ -17,7 +17,7 @@ module Asana
         # workspace_gid - [str]  (required) Globally unique identifier for the workspace or organization.
         # start_at - [datetime]  Filter to events created after this time (inclusive).
         # end_at - [datetime]  Filter to events created before this time (exclusive).
-        # event_type - [str]  Filter to events of this type. Refer to the [Supported AuditLogEvents](/docs/supported-auditlogevents) for a full list of values.
+        # event_type - [str]  Filter to events of this type. Refer to the [supported audit log events](/docs/audit-log-events#supported-audit-log-events) for a full list of values.
         # actor_type - [str]  Filter to events with an actor of this type. This only needs to be included if querying for actor types without an ID. If `actor_gid` is included, this should be excluded.
         # actor_gid - [str]  Filter to events triggered by the actor with this ID.
         # resource_gid - [str]  Filter to events with this resource ID.

data/lib/asana/resources/gen/memberships_base.rb

@@ -0,0 +1,71 @@
+### WARNING: This file is auto-generated by our OpenAPI spec. Do not
+### edit it manually.
+
+require_relative '../../resource_includes/response_helper'
+
+module Asana
+  module Resources
+    class MembershipsBase < Resource
+
+      def self.inherited(base)
+        Registry.register(base)
+      end
+
+      class << self
+        # Create a membership
+        #
+
+        # options - [Hash] the request I/O options
+        # > opt_fields - [list[str]]  Defines fields to return. Some requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
+        # > opt_pretty - [bool]  Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
+        # data - [Hash] the attributes to POST
+        def create_membership(client, options: {}, **data)
+          path = "/memberships"
+          parse(client.post(path, body: data, options: options)).first
+        end
+
+        # Delete a membership
+        #
+        # membership_gid - [str]  (required) Globally unique identifier for the membership.
+        # options - [Hash] the request I/O options
+        # > opt_fields - [list[str]]  Defines fields to return. Some requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
+        # > opt_pretty - [bool]  Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
+        def delete_membership(client, membership_gid: required("membership_gid"), options: {})
+          path = "/memberships/{membership_gid}"
+          path["{membership_gid}"] = membership_gid
+          parse(client.delete(path, options: options)).first
+        end
+
+        # Get multiple memberships
+        #
+
+        # parent - [str]  (required) Globally unique identifier for `project`, `portfolio`,   `team`, `goal`, and `workspace`.
+        # member - [str]  Globally unique identifier for `team` and `user`.
+        # options - [Hash] the request I/O options
+        # > offset - [str]  Offset token. An offset to the next page returned by the API. A pagination request will return an offset token, which can be used as an input parameter to the next request. If an offset is not passed in, the API will return the first page of results. 'Note: You can only pass in an offset that was returned to you via a previously paginated request.'
+        # > limit - [int]  Pagination limit for the request.
+        # > opt_fields - [list[str]]  Defines fields to return. Some requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
+        # > opt_pretty - [bool]  Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
+        def get_memberships(client, parent: nil, member: nil, options: {})
+          path = "/memberships"
+          params = { parent: parent, member: member }.reject { |_,v| v.nil? || Array(v).empty? }
+          Collection.new(parse(client.get(path, params: params, options: options)), type: Resource, client: client)
+        end
+
+        # Update a membership
+        #
+        # membership_gid - [str]  (required) Globally unique identifier for the membership.
+        # options - [Hash] the request I/O options
+        # > opt_fields - [list[str]]  Defines fields to return. Some requests return *compact* representations of objects in order to conserve resources and complete the request more efficiently. Other times requests return more information than you may need. This option allows you to list the exact set of fields that the API should be sure to return for the objects. The field names should be provided as paths, described below. The id of included objects will always be returned, regardless of the field options.
+        # > opt_pretty - [bool]  Provides “pretty” output. Provides the response in a “pretty” format. In the case of JSON this means doing proper line breaking and indentation to make it readable. This will take extra time and increase the response size so it is advisable only to use this during debugging.
+        # data - [Hash] the attributes to PUT
+        def update_membership(client, membership_gid: required("membership_gid"), options: {}, **data)
+          path = "/memberships/{membership_gid}"
+          path["{membership_gid}"] = membership_gid
+          parse(client.put(path, body: data, options: options)).first
+        end
+
+      end
+    end
+  end
+end

data/lib/asana/resources/gen/tasks_base.rb

@@ -186,7 +186,7 @@ module Asana
 
         # assignee - [str]  The assignee to filter tasks on. If searching for unassigned tasks, assignee.any = null can be specified. *Note: If you specify `assignee`, you must also specify the `workspace` to filter on.*
         # project - [str]  The project to filter tasks on.
-        # section - [str]  The section to filter tasks on. *Note: Currently, this is only supported in board views.*
+        # section - [str]  The section to filter tasks on.
         # workspace - [str]  The workspace to filter tasks on. *Note: If you specify `workspace`, you must also specify the `assignee` to filter on.*
         # completed_since - [datetime]  Only return tasks that are either incomplete or that have been completed since this time.
         # modified_since - [datetime]  Only return tasks that have been modified since the given time.  *Note: A task is considered “modified” if any of its properties change, or associations between it and other objects are modified (e.g.  a task being added to a project). A task is not considered modified just because another object it is associated with (e.g. a subtask) is modified. Actions that count as modifying the task include assigning, renaming, completing, and adding stories.*

data/lib/asana/resources/goal.rb

@@ -0,0 +1,54 @@
+require_relative 'gen/goals_base'
+
+module Asana
+  module Resources
+    class Goal < GoalsBase
+
+
+      attr_reader :gid
+
+      attr_reader :resource_type
+
+      attr_reader :due_on
+      
+      attr_reader :html_notes
+
+      attr_reader :is_workspace_level
+
+      attr_reader :liked
+
+      attr_reader :name
+
+      attr_reader :notes
+
+      attr_reader :start_on
+
+      attr_reader :status
+
+      attr_reader :current_status_update
+
+      attr_reader :followers
+
+      attr_reader :likes
+      
+      attr_reader :metric
+      
+      attr_reader :num_likes
+
+      attr_reader :owner
+
+      attr_reader :team
+
+      attr_reader :time_period
+
+      attr_reader :workspace
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'goals'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/goal_relationship.rb

@@ -0,0 +1,32 @@
+require_relative 'gen/goal_relationships_base'
+
+module Asana
+  module Resources
+    class GoalRelationship < GoalRelationshipsBase
+
+
+      attr_reader :gid
+
+      attr_reader :resource_type
+
+      attr_reader :contribution_weight
+      
+      attr_reader :resource_subtype
+
+      attr_reader :supported_goal
+
+      attr_reader :owner
+
+      attr_reader :supporting_resource
+
+      attr_reader :supporting_resource
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'goal_relationships'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/membership.rb

@@ -0,0 +1,20 @@
+require_relative 'gen/memberships_base'
+
+module Asana
+  module Resources
+    class Membership < MembershipsBase
+
+
+      attr_reader :gid
+
+      attr_reader :resource_type
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'memberships'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/project_brief.rb

@@ -0,0 +1,30 @@
+require_relative 'gen/project_briefs_base'
+
+module Asana
+  module Resources
+    class ProjectBrief < ProjectBriefsBase
+
+
+      attr_reader :gid
+
+      attr_reader :resource_type
+
+      attr_reader :html_text
+      
+      attr_reader :title
+
+      attr_reader :permalink_url
+
+      attr_reader :project
+
+      attr_reader :text
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'project_briefs'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/project_template.rb

@@ -0,0 +1,36 @@
+require_relative 'gen/project_templates_base'
+
+module Asana
+  module Resources
+    class ProjectTemplate < ProjectTemplatesBase
+
+
+      attr_reader :gid
+
+      attr_reader :resource_type
+
+      attr_reader :color
+      
+      attr_reader :description
+
+      attr_reader :html_description
+
+      attr_reader :name
+
+      attr_reader :owner
+
+      attr_reader :public
+
+      attr_reader :requested_dates
+
+      attr_reader :team
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'project_templates'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/status_update.rb

@@ -0,0 +1,54 @@
+require_relative 'gen/status_updates_base'
+
+module Asana
+  module Resources
+    class StatusUpdate < StatusUpdatesBase
+
+
+      attr_reader :gid
+
+      attr_reader :resource_type
+
+      attr_reader :html_text
+      
+      attr_reader :resource_subtype
+
+      attr_reader :status_type
+
+      attr_reader :text
+
+      attr_reader :title
+
+      attr_reader :author
+
+      attr_reader :created_at
+
+      attr_reader :created_by
+
+      attr_reader :hearted
+
+      attr_reader :hearts
+
+      attr_reader :liked
+
+      attr_reader :likes
+
+      attr_reader :created_at
+
+      attr_reader :modified_at
+
+      attr_reader :num_hearts
+
+      attr_reader :num_likes
+
+      attr_reader :parent
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'status_updates'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/time_period.rb

@@ -0,0 +1,30 @@
+require_relative 'gen/time_periods_base'
+
+module Asana
+  module Resources
+    class TimePeriod < TimePeriodsBase
+
+
+      attr_reader :gid
+
+      attr_reader :resource_type
+
+      attr_reader :display_name
+      
+      attr_reader :end_on
+
+      attr_reader :parent
+
+      attr_reader :period
+
+      attr_reader :start_on
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'time_periods'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/typeahead.rb

@@ -14,7 +14,7 @@ module Asana
       class << self
         # Returns the plural name of the resource.
         def plural_name
-          'typeaheads'
+          'typeahead'
         end
       end
     end

data/lib/asana/resources.rb

@@ -1,11 +1,11 @@
+# frozen_string_literal: true
+
 require_relative 'resource_includes/resource'
 require_relative 'resource_includes/collection'
 
-Dir[File.join(File.dirname(__FILE__), 'resource_includes', '*.rb')]
-  .each { |resource| require resource }
+Dir[File.join(File.dirname(__FILE__), 'resource_includes', '*.rb')].sort.each { |resource| require resource }
 
-Dir[File.join(File.dirname(__FILE__), 'resources', '*.rb')]
-  .each { |resource| require resource }
+Dir[File.join(File.dirname(__FILE__), 'resources', '*.rb')].sort.each { |resource| require resource }
 
 module Asana
   # Public: Contains all the resources that the Asana API can return.

data/lib/asana/ruby2_0_0_compatibility.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 def required(name)
   raise(ArgumentError, "#{name} is a required keyword argument")
 end

data/lib/asana/version.rb

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

data/lib/asana.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 require 'asana/ruby2_0_0_compatibility'
 require 'asana/authentication'
 require 'asana/resources'

data/samples/memberships_sample.yaml

@@ -0,0 +1,41 @@
+memberships: 
+    create_membership: >-
+        require 'asana'
+
+
+        client = Asana::Client.new do |c|
+            c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'
+        end
+
+
+        result = client.memberships.create_membership(field: "value", field: "value", options: {pretty: true})
+    delete_membership: >-
+        require 'asana'
+
+
+        client = Asana::Client.new do |c|
+            c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'
+        end
+
+
+        result = client.memberships.delete_membership(membership_gid: 'membership_gid', options: {pretty: true})
+    get_memberships: >-
+        require 'asana'
+
+
+        client = Asana::Client.new do |c|
+            c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'
+        end
+
+
+        result = client.memberships.get_memberships(parent: ''parent_example'', param: "value", param: "value", options: {pretty: true})
+    update_membership: >-
+        require 'asana'
+
+
+        client = Asana::Client.new do |c|
+            c.authentication :access_token, 'PERSONAL_ACCESS_TOKEN'
+        end
+
+
+        result = client.memberships.update_membership(membership_gid: 'membership_gid', field: "value", field: "value", options: {pretty: true})