asana 0.9.3 → 0.10.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c7e067666054f042bfbbc6c06ba9dc0097be619f6091ee77e4c2cfb8667deead
-  data.tar.gz: 44858543741b3d8c5e421159eb0c170f830299eea6c8897cc91e61149a2adce5
+  metadata.gz: 7cbc517a0b8e45655043ff4ac2a419f12be72db5a12cb6efc5e80c29b13ab64e
+  data.tar.gz: ce52a082b48c060ca9f0d82c01534451c8a4f0417c745cfd40a71ae72f157944
 SHA512:
-  metadata.gz: 2fcac1831ce273584e5c486793d56fe9c671ef5244d316cd41b3b5092e61c1593c9e47447653237a69e30225908e27f8842a0a5e318fdabbcfd5760e2fe62d4c
-  data.tar.gz: bec2326ce354996184af94806f8da9bf6120fa0f4c3d17c9f494f8d635a2010214c8a2e2e80c200423e73af449cd3799e73499cf93b23b5143a434f70c4a0a44
+  metadata.gz: b04794c205e810df61ae3e97b66c5b17671f5a0ab0843ba2a53d72aa3ed6904c2cc75a9142a517c86831de681c4f77278b1189cfd3f997c09bbd53802dce7e73
+  data.tar.gz: fabf06e3ccd2ea24f09daf62597db360b56b4d666e89d214f793fcaa9159a29a16f0f68cfdbd67fab587b0e0ecc9a1ef6cec8bc86b37617ac56473f6fa51e4b9

data/.swagger-codegen-ignore

@@ -0,0 +1,3 @@
+# Swagger Codegen Ignore
+
+test/*

data/.travis.yml

@@ -1,9 +1,10 @@
 language: ruby
 rvm:
-- 2.2.9
 - 2.3.6
 - 2.4.3
 - 2.5.0
+- 2.7.1
+- 3.0.0
 deploy:
   provider: rubygems
   api_key:

data/Appraisals

@@ -1,37 +1,4 @@
 
-  appraise "faraday-0.9.0" do
-    gem "faraday", "0.9.0"
+  appraise "faraday-1.0.0" do
+    gem "faraday", "1.0.0"
   end
-
-  appraise "faraday-0.9.1" do
-    gem "faraday", "0.9.1"
-  end
-
-  appraise "faraday-0.9.2" do
-    gem "faraday", "0.9.2"
-  end
-
-  appraise "faraday-0.10.0" do
-    gem "faraday", "0.10.0"
-  end
-  appraise "faraday-0.10.1" do
-    gem "faraday", "0.10.1"
-  end
-
-  appraise "faraday-0.11.0" do
-    gem "faraday", "0.11.0"
-  end
-
- # Oauth2 does not yet support 0.12
-
-  # appraise "faraday-0.12.0" do
-  #   gem "faraday", "0.12.0"
-  # end
-  #
-  # appraise "faraday-0.12.0.1" do
-  #   gem "faraday", "0.12.0.1"
-  # end
-  #
-  # appraise "faraday-0.12.1" do
-  #   gem "faraday", "0.12.1"
-  # end

data/Gemfile

@@ -23,4 +23,6 @@ group :tools do
   gem 'byebug'
 
   gem 'simplecov', require: false
+
+  gem "rack-protection", "1.5.5"
 end

data/README.md

@@ -11,53 +11,6 @@ Supported rubies:
 
 * MRI 2.0.0 up to 2.2.x stable
 
-## Required: Security procedures for outdated OpenSSL versions
-
-Older versions of OpenSSL can cause a problem when using `ruby-asana` In particular, at the time of this writing, at least **MacOS X 10.11 and below** ship with a very old version of OpenSSL:
-    
-    $ openssl version
-    OpenSSL 0.9.8zh 14 Jan 2016
-
-OpenSSL 0.9.8 was first released in 2005, and therefore only supports TLS (Transport Layer Security) version 1.0. Asana has deprecated and stopped accepting requests for clients which do not suport [TLS 1.0 and above](https://asa.na/tls), which unfortunately includes any software linked against this version of the library - this includes both the MacOS X provided Ruby interpreter and any homebrew installed Ruby that is not specifically configured to link against a newer version.
-
-To see if your Ruby version is affected, run
-   
-    $ ruby -ropenssl -e 'puts OpenSSL::OPENSSL_VERSION'
-
-If the version printed at the command line is older than `1.0.1`, when, in 2012, OpenSSL first supported TLS 1.1 and 1.2, you will not be able to use `ruby-asana` to connect to Asana. Specifically, you will recieve `400 Bad Request` responses with an error message in the response body about the lack of support for TLS 1.1 and above.
-
-Asana highly recommends using a Ruby installation manager, either RVM or `rbenv`. Instructions on how to install an up-to-date `ruby` for each of these are below.
-
-### Solution when using RVM
-
-RVM makes it easy to install both an updated OpenSSL and a Ruby interpreter that links to it. If you are using MacPorts or Homebrew, you're probably fine out of the box; RVM favors package management using either one of these to satisfy dependencies, and so can keep your ruby up to date automatically. If you are not using these, consider using them, as they're very simple to install and use.
-
-If you don't use your package manager, you can use RVM's [package manager](https://rvm.io/packages) to install from source.
-
-If you want to build OpenSSL from source yourself, you have to specify how to link to this OpenSSL installation:
-
-    $ rvm install ruby-{version} --with-openssl-dir={ssl_dir}
-          # Specify your openssl path prefix, wherever openssl dirs 
-          # "bin", "include", and "lib" are installed; usually
-          # "/usr" for system installs, or $PREFIX for configure/make locally.
-    $ ruby -ropenssl -e 'puts OpenSSL::OPENSSL_VERSION' # Verify inside Ruby
-    OpenSSL 1.0.2h  3 May 2016
-
-If you see the version of OpenSSL greater than OpenSSL 1.0.1, then you're all set to start using `ruby-asana`
-
-### Solution when using rbenv
-
-Similar to RVM, rbenv compiles rubies with knowledge of MacPorts and Homebrew libraries. When a newer version of OpenSSL is installed via the method above, all rubies built (after that time of course) will link to the newer version of OpenSSL.
-
-If you don't use a package manager, as above, you can build by explicitly supplying the directory in which to find OpenSSL:
-
-    $ RUBY_CONFIGURE_OPTS=--with-openssl-dir=/opt/local rbenv install ruby-{version}
-          # Specify your openssl path prefix, wherever openssl dirs 
-          # "bin", "include", and "lib" are installed; usually
-          # "/usr" for system installs, or $PREFIX for configure/make locally.
-    $ ruby -ropenssl -e 'puts OpenSSL::OPENSSL_VERSION' # Verify inside Ruby
-    OpenSSL 1.0.2h  3 May 2016
-
 ## Gem Installation
 Add this line to your application's Gemfile:
 
@@ -402,8 +355,7 @@ If you wish to make changes on the code generation script:
    spec/templates/unicorn_spec.rb`
 
 Once you're sure your code works, submit a pull request and ask the maintainer
-to make a release, as they'll need to run a release script from the
-[asana-api-meta][meta] repository.
+to make a release, as they'll need to run a release script.
 
 ## Contributing
 
@@ -413,7 +365,7 @@ to make a release, as they'll need to run a release script from the
 4. Push to the branch (`git push origin my-new-feature`)
 5. Create a new Pull Request
 
-[apidocs]: https://asana.com/developers
-[io]: https://asana.com/developers/documentation/getting-started/input-output-options
+[apidocs]: https://developers.asana.com/docs
+[io]: https://developers.asana.com/docs/#input-output-options
 [docs]: http://www.rubydoc.info/github/Asana/ruby-asana/master
 [meta]: https://github.com/asana/asana-api-meta

data/VERSION

@@ -0,0 +1 @@
+0.10.3

data/asana.gemspec

@@ -19,11 +19,11 @@ Gem::Specification.new do |spec|
   spec.executables   = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
   spec.require_paths = ["lib"]
 
-  spec.required_ruby_version = '~> 2.0'
+  spec.required_ruby_version = '> 2.0'
 
   spec.add_dependency "oauth2", "~> 1.4"
-  spec.add_dependency "faraday", "~> 0.9"
-  spec.add_dependency "faraday_middleware", "~> 0.9"
+  spec.add_dependency "faraday", "~> 1.0"
+  spec.add_dependency "faraday_middleware", "~> 1.0"
   spec.add_dependency "faraday_middleware-multi_json", "~> 0.0"
 
   spec.add_development_dependency "rake", "~> 10.0"

data/examples/Gemfile.lock

@@ -1,33 +1,33 @@
 PATH
   remote: ..
   specs:
-    asana (0.9.0)
-      faraday (~> 0.9)
-      faraday_middleware (~> 0.9)
+    asana (0.10.3)
+      faraday (~> 1.0)
+      faraday_middleware (~> 1.0)
       faraday_middleware-multi_json (~> 0.0)
       oauth2 (~> 1.4)
 
 GEM
   remote: https://rubygems.org/
   specs:
-    faraday (0.15.4)
+    faraday (1.0.1)
       multipart-post (>= 1.2, < 3)
-    faraday_middleware (0.13.1)
-      faraday (>= 0.7.4, < 1.0)
+    faraday_middleware (1.0.0)
+      faraday (~> 1.0)
     faraday_middleware-multi_json (0.0.6)
       faraday_middleware
       multi_json
     jwt (2.2.1)
-    multi_json (1.13.1)
+    multi_json (1.15.0)
     multi_xml (0.6.0)
     multipart-post (2.1.1)
-    oauth2 (1.4.1)
-      faraday (>= 0.8, < 0.16.0)
+    oauth2 (1.4.4)
+      faraday (>= 0.8, < 2.0)
       jwt (>= 1.0, < 3.0)
       multi_json (~> 1.3)
       multi_xml (~> 0.5)
       rack (>= 1.2, < 3)
-    rack (2.0.7)
+    rack (2.2.3)
 
 PLATFORMS
   ruby

data/lib/asana/client.rb

@@ -59,8 +59,8 @@ module Asana
         @resource = resource
       end
 
-      def method_missing(m, *args, &block)
-        @resource.public_send(m, *([@client] + args), &block)
+      def method_missing(m, *args, **kwargs, &block)
+        @resource.public_send(m, *([@client] + args), **kwargs, &block)
       end
 
       def respond_to_missing?(m, *)
@@ -87,29 +87,29 @@ module Asana
     # Public: Performs a GET request against an arbitrary Asana URL. Allows for
     # the user to interact with the API in ways that haven't been
     # reflected/foreseen in this library.
-    def get(url, *args)
-      @http_client.get(url, *args)
+    def get(url, **args)
+      @http_client.get(url, **args)
     end
 
     # Public: Performs a POST request against an arbitrary Asana URL. Allows for
     # the user to interact with the API in ways that haven't been
     # reflected/foreseen in this library.
-    def post(url, *args)
-      @http_client.post(url, *args)
+    def post(url, **args)
+      @http_client.post(url, **args)
     end
 
     # Public: Performs a PUT request against an arbitrary Asana URL. Allows for
     # the user to interact with the API in ways that haven't been
     # reflected/foreseen in this library.
-    def put(url, *args)
-      @http_client.put(url, *args)
+    def put(url, **args)
+      @http_client.put(url, **args)
     end
 
     # Public: Performs a DELETE request against an arbitrary Asana URL. Allows
     # for the user to interact with the API in ways that haven't been
     # reflected/foreseen in this library.
-    def delete(url, *args)
-      @http_client.delete(url, *args)
+    def delete(url, **args)
+      @http_client.delete(url, **args)
     end
 
     # Public: Exposes queries for all top-evel endpoints.

data/lib/asana/http_client.rb

@@ -108,11 +108,17 @@ module Asana
     #
     # resource_uri - [String] the resource URI relative to the base Asana API
     #                URL, e.g "/tags".
+    # options      - [Hash] the request I/O options
     #
     # Returns an [Asana::HttpClient::Response] if everything went well.
     # Raises [Asana::Errors::APIError] if anything went wrong.
-    def delete(resource_uri)
-      perform_request(:delete, resource_uri)
+    def delete(resource_uri, params: {}, options: {})
+      opts = options.reduce({}) do |acc, (k, v)|
+        acc.tap do |hash|
+          hash[:"opt_#{k}"] = v.is_a?(Array) ? v.join(',') : v
+        end
+      end
+      perform_request(:delete, resource_uri, params.merge(opts), options[:headers])
     end
 
     private

data/lib/asana/resource_includes/attachment_uploading.rb

@@ -5,8 +5,9 @@ module Asana
     module AttachmentUploading
       # Uploads a new attachment to the resource.
       #
-      # filename - [String] the absolute path of the file to upload.
+      # filename - [String] the absolute path of the file to upload OR the desired filename when using +io+
       # mime     - [String] the MIME type of the file
+      # io       - [IO] an object which returns the file's content on +#read+, e.g. a +::StringIO+
       # options  - [Hash] the request I/O options
       # data     - [Hash] extra attributes to post
       #
@@ -14,16 +15,22 @@ module Asana
       # rubocop:disable Metrics/MethodLength
       def attach(filename: required('filename'),
                  mime: required('mime'),
-                 options: {}, **data)
-        path = File.expand_path(filename)
-        unless File.exist?(path)
-          raise ArgumentError, "file #{filename} doesn't exist"
-        end
-        upload = Faraday::UploadIO.new(path, mime)
+                 io: nil, options: {}, **data)
+
+        upload = if io.nil?
+                   path = File.expand_path(filename)
+                   raise ArgumentError, "file #{filename} doesn't exist" unless File.exist?(path)
+
+                   Faraday::FilePart.new(path, mime)
+                 else
+                   Faraday::FilePart.new(io, mime, filename)
+                 end
+
         response = client.post("/#{self.class.plural_name}/#{gid}/attachments",
                                body: data,
                                upload: upload,
                                options: options)
+
         Attachment.new(parse(response).first, client: client)
       end
       # rubocop:enable Metrics/MethodLength

data/lib/asana/resource_includes/collection.rb

@@ -36,6 +36,11 @@ module Asana
         end
       end
 
+      # Public: Returns the last item in the collection.
+      def last
+        @elements.last
+      end
+      
       # Public: Returns the size of the collection.
       def size
         to_a.size

data/lib/asana/resource_includes/resource.rb

@@ -9,10 +9,6 @@ module Asana
       include ResponseHelper
       extend ResponseHelper
 
-      def self.inherited(base)
-        Registry.register(base)
-      end
-
       def initialize(data, client: required('client'))
         @_client = client
         @_data   = data

data/lib/asana/resources/attachment.rb

@@ -1,16 +1,13 @@
-### WARNING: This file is auto-generated by the asana-api-meta repo. Do not
-### edit it manually.
+require_relative 'gen/attachments_base'
 
 module Asana
   module Resources
     # An _attachment_ object represents any file attached to a task in Asana,
     # whether it's an uploaded file or one associated via a third-party service
     # such as Dropbox or Google Drive.
-    class Attachment < Resource
+    class Attachment < AttachmentsBase
 
 
-      attr_reader :id
-
       attr_reader :gid
 
       attr_reader :resource_type

data/lib/asana/resources/batch_api.rb

@@ -0,0 +1,15 @@
+require_relative 'gen/batch_api_base'
+
+module Asana
+  module Resources
+    class BatchAPI < BatchAPIBase
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'batch_apis'
+        end
+      end
+    end
+  end
+end

data/lib/asana/resources/custom_field_settings.rb

@@ -1,5 +1,4 @@
-### WARNING: This file is auto-generated by the asana-api-meta repo. Do not
-### edit it manually.
+require_relative 'gen/custom_field_settings_base'
 
 module Asana
   module Resources
@@ -9,11 +8,9 @@ module Asana
     # stores information that is relevant to that particular pairing; for instance,
     # the `is_important` property determines some possible application-specific
     # handling of that custom field and parent.
-    class CustomFieldSetting < Resource
+    class CustomFieldSetting < CustomFieldSettingsBase
 
 
-      attr_reader :id
-
       attr_reader :gid
 
       attr_reader :resource_type

data/lib/asana/resources/custom_fields.rb

@@ -1,5 +1,4 @@
-### WARNING: This file is auto-generated by the asana-api-meta repo. Do not
-### edit it manually.
+require_relative 'gen/custom_fields_base'
 
 module Asana
   module Resources
@@ -13,11 +12,9 @@ module Asana
     # fields](/guide/help/premium/custom-fields#gl-lock-fields), which will make
     # them read-only when accessed by other users. Attempting to edit a locked
     # custom field will return HTTP error code `403 Forbidden`.
-    class CustomField < Resource
+    class CustomField < CustomFieldsBase
 
 
-      attr_reader :id
-
       attr_reader :gid
 
       attr_reader :resource_type

data/lib/asana/resources/events.rb

@@ -0,0 +1,28 @@
+require_relative 'gen/events_base'
+
+module Asana
+  module Resources
+    class EventResponse < EventsBase
+
+
+      attr_reader :user
+
+      attr_reader :resource
+
+      attr_reader :type
+
+      attr_reader :action
+
+      attr_reader :parent
+
+      attr_reader :created_at
+
+      class << self
+        # Returns the plural name of the resource.
+        def plural_name
+          'event_responses'
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,56 @@
+### 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 AttachmentsBase < Resource
+
+      def self.inherited(base)
+        Registry.register(base)
+      end
+
+      class << self
+        # Delete an attachment
+        #
+        # attachment_gid - [str]  (required) Globally unique identifier for the attachment.
+        # 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_attachment(client, attachment_gid: required("attachment_gid"), options: {})
+          path = "/attachments/{attachment_gid}"
+          path["{attachment_gid}"] = attachment_gid
+          parse(client.delete(path, options: options)).first
+        end
+
+        # Get an attachment
+        #
+        # attachment_gid - [str]  (required) Globally unique identifier for the attachment.
+        # 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 get_attachment(client, attachment_gid: required("attachment_gid"), options: {})
+          path = "/attachments/{attachment_gid}"
+          path["{attachment_gid}"] = attachment_gid
+          Attachment.new(parse(client.get(path, options: options)).first, client: client)
+        end
+
+        # Get attachments for a task
+        #
+        # task_gid - [str]  (required) The task to operate on.
+        # 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.
+        # > 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_attachments_for_task(client, task_gid: required("task_gid"), options: {})
+          path = "/tasks/{task_gid}/attachments"
+          path["{task_gid}"] = task_gid
+          Collection.new(parse(client.get(path, options: options)), type: Attachment, client: client)
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,30 @@
+### 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 BatchAPIBase < Resource
+
+      def self.inherited(base)
+        Registry.register(base)
+      end
+
+      class << self
+        # Submit parallel requests
+        #
+
+        # 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_batch_request(client, options: {}, **data)
+          path = "/batch"
+          Collection.new(parse(client.post(path, body: data, options: options)), type: Resource, client: client)
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,46 @@
+### 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 CustomFieldSettingsBase < Resource
+
+      def self.inherited(base)
+        Registry.register(base)
+      end
+
+      class << self
+        # Get a portfolio's custom fields
+        #
+        # portfolio_gid - [str]  (required) Globally unique identifier for the portfolio.
+        # 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.
+        # > 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_custom_field_settings_for_portfolio(client, portfolio_gid: required("portfolio_gid"), options: {})
+          path = "/portfolios/{portfolio_gid}/custom_field_settings"
+          path["{portfolio_gid}"] = portfolio_gid
+          Collection.new(parse(client.get(path, options: options)), type: CustomFieldSetting, client: client)
+        end
+
+        # Get a project's custom fields
+        #
+        # project_gid - [str]  (required) Globally unique identifier for the project.
+        # 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.
+        # > 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_custom_field_settings_for_project(client, project_gid: required("project_gid"), options: {})
+          path = "/projects/{project_gid}/custom_field_settings"
+          path["{project_gid}"] = project_gid
+          Collection.new(parse(client.get(path, options: options)), type: CustomFieldSetting, client: client)
+        end
+
+      end
+    end
+  end
+end