dropbox-sign 1.5.0 → 1.6.0

data/run-build

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-# see https://github.com/OpenAPITools/openapi-generator/tree/08296c2b1dc732829e3aaa2c2cad7c2c8c44eb8d/modules/openapi-generator/src/main/resources/ruby-client
+# see https://github.com/OpenAPITools/openapi-generator/tree/v7.8.0/modules/openapi-generator/src/main/resources/ruby-client
 
 set -e
 
@@ -9,7 +9,7 @@ WORKING_DIR="/app/ruby"
 
 docker run --rm \
   -v "${DIR}/:/local" \
-  openapitools/openapi-generator-cli:v7.7.0 generate \
+  openapitools/openapi-generator-cli:v7.8.0 generate \
     -i "/local/openapi-sdk.yaml" \
     -c "/local/openapi-config.yaml" \
     -t "/local/templates" \

data/spec/spec_helper.rb

@@ -6,7 +6,7 @@
 The version of the OpenAPI document: 3.0.0
 Contact: apisupport@hellosign.com
 Generated by: https://openapi-generator.tech
-Generator version: 7.7.0
+Generator version: 7.8.0
 
 =end
 

data/templates/Gemfile.mustache

@@ -6,5 +6,7 @@ group :development, :test do
   gem 'rake', '~> 13.0.1'
   gem 'pry-byebug'
   gem 'rubocop', '~> 0.66.0'
+{{#useCustomTemplateCode}}
   gem 'json_spec', '~> 1.1.5'
+{{/useCustomTemplateCode}}
 end

data/templates/README.mustache

@@ -6,6 +6,7 @@
 {{{.}}}
 {{/appDescriptionWithNewLines}}
 
+{{#useCustomTemplateCode}}
 ## Migrating from legacy SDK
 
 This SDK is generated from our officially maintained [OpenAPI spec](https://github.com/hellosign/hellosign-openapi/blob/main/openapi.yaml).
@@ -24,6 +25,7 @@ Pull Requests *must* be opened against the
 You must make SDK code changes in the mustache file within the `templates`
 directory that corresponds to the file you want updated.
 
+{{/useCustomTemplateCode}}
 This SDK is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: {{appVersion}}
@@ -39,11 +41,13 @@ For more information, please visit [{{{infoUrl}}}]({{{infoUrl}}})
 
 ## Installation
 
+{{#useCustomTemplateCode}}
 ### Install gem
 ```shell
 gem install {{{gemName}}}
 ```
 
+{{/useCustomTemplateCode}}
 ### Build a gem
 
 To build the Ruby code into a gem:
@@ -52,7 +56,12 @@ To build the Ruby code into a gem:
 gem build {{{gemName}}}.gemspec
 ```
 
+{{^useCustomTemplateCode}}
+Then either install the gem locally:
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 Then install the gem locally:
+{{/useCustomTemplateCode}}
 
 ```shell
 gem install ./{{{gemName}}}-{{{gemVersion}}}.gem
@@ -60,6 +69,10 @@ gem install ./{{{gemName}}}-{{{gemVersion}}}.gem
 
 (for development, run `gem install --dev ./{{{gemName}}}-{{{gemVersion}}}.gem` to install the development dependencies)
 
+{{^useCustomTemplateCode}}
+or publish the gem to a gem hosting service, e.g. [RubyGems](https://rubygems.org/).
+{{/useCustomTemplateCode}}
+
 Finally add this to the Gemfile:
 
     gem '{{{gemName}}}', '~> {{{gemVersion}}}'
@@ -82,20 +95,87 @@ ruby -Ilib script.rb
 
 Please follow the [installation](#installation) procedure and then run the following code:
 
+{{^useCustomTemplateCode}}
+```ruby
+# Load the gem
+require '{{{gemName}}}'
+{{#apiInfo}}{{#apis}}{{#-first}}{{#operations}}{{#operation}}{{#-first}}{{#hasAuthMethods}}
+# Setup authorization
+{{{moduleName}}}.configure do |config|{{#authMethods}}{{#isBasic}}{{#isBasicBasic}}
+  # Configure HTTP basic authorization: {{{name}}}
+  config.username = 'YOUR_USERNAME'
+  config.password = 'YOUR_PASSWORD'{{/isBasicBasic}}{{#isBasicBearer}}
+  # Configure Bearer authorization{{#bearerFormat}} ({{{.}}}){{/bearerFormat}}: {{{name}}}
+  config.access_token = 'YOUR_BEARER_TOKEN'
+  # Configure a proc to get access tokens in lieu of the static access_token configuration
+  config.access_token_getter = -> { 'YOUR TOKEN GETTER PROC' } {{/isBasicBearer}}{{/isBasic}}{{#isApiKey}}
+  # Configure API key authorization: {{{name}}}
+  config.api_key['{{{name}}}'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['{{{name}}}'] = 'Bearer'{{/isApiKey}}{{#isOAuth}}
+  # Configure OAuth2 access token for authorization: {{{name}}}
+  config.access_token = 'YOUR ACCESS TOKEN'
+  # Configure a proc to get access tokens in lieu of the static access_token configuration
+  config.access_token_getter = -> { 'YOUR TOKEN GETTER PROC' } {{/isOAuth}}
+  {{#isFaraday}}
+  # Configure faraday connection
+  config.configure_faraday_connection { |connection| 'YOUR CONNECTION CONFIG PROC' }
+  {{/isFaraday}}
+  {{#isHttpx}}
+  # Configure httpx session
+  config.configure_session { |session| 'YOUR CONNECTION CONFIG PROC' }
+  {{/isHttpx}}
+{{/authMethods}}end
+{{/hasAuthMethods}}
+
+api_instance = {{{moduleName}}}::{{{classname}}}.new
+{{#requiredParams}}
+{{{paramName}}} = {{{vendorExtensions.x-ruby-example}}} # {{{dataType}}} | {{{description}}}
+{{/requiredParams}}
+{{#optionalParams}}
+{{#-first}}
+opts = {
+{{/-first}}
+  {{{paramName}}}: {{{vendorExtensions.x-ruby-example}}}{{^-last}},{{/-last}} # {{{dataType}}} | {{{description}}}
+{{#-last}}
+}
+{{/-last}}
+{{/optionalParams}}
+
+begin
+{{#summary}}  #{{{.}}}
+{{/summary}}  {{#returnType}}result = {{/returnType}}api_instance.{{{operationId}}}{{#hasParams}}({{#requiredParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/requiredParams}}{{#optionalParams}}{{#-last}}{{#hasRequiredParams}}, {{/hasRequiredParams}}opts{{/-last}}{{/optionalParams}}){{/hasParams}}{{#returnType}}
+  p result{{/returnType}}
+rescue {{{moduleName}}}::ApiError => e
+  puts "Exception when calling {{classname}}->{{{operationId}}}: #{e}"
+end
+{{/-first}}{{/operation}}{{/operations}}{{/-first}}{{/apis}}{{/apiInfo}}
+```
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 {{#apiInfo}}{{#apis}}{{#-first}}{{#operations}}{{#operation}}{{#-first}}
 ```ruby
 REPLACE_ME_WITH_EXAMPLE_FOR__{{{operationId}}}_Ruby_CODE
 ```
 {{/-first}}{{/operation}}{{/operations}}{{/-first}}{{/apis}}{{/apiInfo}}
+{{/useCustomTemplateCode}}
 
 ## Documentation for API Endpoints
 
 All URIs are relative to *{{basePath}}*
 
+{{^useCustomTemplateCode}}
+Class | Method | HTTP request | Description
+------------ | ------------- | ------------- | -------------
+{{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}*{{moduleName}}::{{classname}}* | [**{{operationId}}**]({{apiDocPath}}{{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{{summary}}}
+{{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 |Class | Method | HTTP request | Description|
 |------------ | ------------- | ------------- | -------------|
 {{#apiInfo}}{{#apis}}{{#operations}}{{#operation}}|*{{moduleName}}::{{classname}}* | [**{{operationId}}**]({{apiDocPath}}{{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{{summary}}} |
 {{/operation}}{{/operations}}{{/apis}}{{/apiInfo}}
+{{/useCustomTemplateCode}}
 
 ## Documentation for Models
 
@@ -104,9 +184,16 @@ All URIs are relative to *{{basePath}}*
 
 ## Documentation for Authorization
 
+{{^useCustomTemplateCode}}
+{{^authMethods}}Endpoints do not require authorization.{{/authMethods}}
+{{#hasAuthMethods}}Authentication schemes defined for the API:{{/hasAuthMethods}}
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 {{^authMethods}} All endpoints do not require authorization.
 {{/authMethods}}{{#authMethods}}{{#last}} Authentication schemes defined for the API:{{/last}}{{/authMethods}}
-{{#authMethods}}### {{name}}
+{{/useCustomTemplateCode}}
+{{#authMethods}}
+### {{name}}
 
 {{#isApiKey}}
 
@@ -117,7 +204,8 @@ All URIs are relative to *{{basePath}}*
 {{#isBasic}}
 {{#isBasicBasic}}- **Type**: HTTP basic authentication
 {{/isBasicBasic}}{{#isBasicBearer}}- **Type**: Bearer authentication{{#bearerFormat}} ({{{.}}}){{/bearerFormat}}
-{{/isBasicBearer}}
+{{/isBasicBearer}}{{#isHttpSignature}}- **Type**: HTTP signature authentication
+{{/isHttpSignature}}
 {{/isBasic}}
 {{#isOAuth}}
 

data/templates/api.mustache

@@ -4,9 +4,11 @@
 
 require 'cgi'
 
+{{#useCustomTemplateCode}}
 module Dropbox
 end
 
+{{/useCustomTemplateCode}}
 module {{moduleName}}
 {{#operations}}
   class {{classname}}
@@ -191,7 +193,7 @@ module {{moduleName}}
       header_params = opts[:header_params] || {}
       {{#hasProduces}}
       # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept([{{#produces}}'{{{mediaType}}}'{{^-last}}, {{/-last}}{{/produces}}])
+      header_params['Accept'] = @api_client.select_header_accept([{{#produces}}'{{{mediaType}}}'{{^-last}}, {{/-last}}{{/produces}}]) unless header_params['Accept']
       {{/hasProduces}}
       {{#hasConsumes}}
       # HTTP header 'Content-Type'
@@ -202,7 +204,7 @@ module {{moduleName}}
       {{/hasConsumes}}
       {{#headerParams}}
       {{#required}}
-      header_params[:'{{{baseName}}}'] = {{#collectionFormat}}@api_client.build_collection_param({{{paramName}}}, :{{{collectionFormat}}}){{/collectionFormat}}{{^collectionFormat}}{{{paramName}}}{{/collectionFormat}}
+      header_params[{{#lambdaFixHeaderKey}}:'{{{baseName}}}'{{/lambdaFixHeaderKey}}] = {{#collectionFormat}}@api_client.build_collection_param({{{paramName}}}, :{{{collectionFormat}}}){{/collectionFormat}}{{^collectionFormat}}{{{paramName}}}{{/collectionFormat}}
       {{/required}}
       {{/headerParams}}
       {{#headerParams}}
@@ -211,6 +213,24 @@ module {{moduleName}}
       {{/required}}
       {{/headerParams}}
 
+{{^useCustomTemplateCode}}
+      # form parameters
+      form_params = opts[:form_params] || {}
+      {{#formParams}}
+      {{#required}}
+      form_params['{{baseName}}'] = {{#collectionFormat}}@api_client.build_collection_param({{{paramName}}}, :{{{collectionFormat}}}){{/collectionFormat}}{{^collectionFormat}}{{{paramName}}}{{/collectionFormat}}
+      {{/required}}
+      {{/formParams}}
+      {{#formParams}}
+      {{^required}}
+      form_params['{{baseName}}'] = {{#collectionFormat}}@api_client.build_collection_param(opts[:'{{{paramName}}}'], :{{{collectionFormat}}}){{/collectionFormat}}{{^collectionFormat}}opts[:'{{{paramName}}}']{{/collectionFormat}} if !opts[:'{{paramName}}'].nil?
+      {{/required}}
+      {{/formParams}}
+
+      # http body (model)
+      post_body = opts[:debug_body]{{#bodyParam}} || @api_client.object_to_http_body({{#required}}{{{paramName}}}{{/required}}{{^required}}opts[:'{{{paramName}}}']{{/required}}){{/bodyParam}}
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
       post_body = {}
       form_params = opts[:form_params] || {}
       {{#bodyParam}}
@@ -233,6 +253,7 @@ module {{moduleName}}
       # http body (model)
       post_body = opts[:debug_body]{{#bodyParam}} || @api_client.object_to_http_body({{#required}}{{{paramName}}}{{/required}}{{^required}}opts[:'{{{paramName}}}']{{/required}}){{/bodyParam}}
       {{/bodyParam}}
+{{/useCustomTemplateCode}}
 
       # return_type
       return_type = opts[:debug_return_type]{{#returnType}} || '{{{.}}}'{{/returnType}}
@@ -250,6 +271,10 @@ module {{moduleName}}
         :return_type => return_type
       )
 
+{{^useCustomTemplateCode}}
+      data, status_code, headers = @api_client.call_api(:{{httpMethod}}, local_var_path, new_options)
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
       begin
         data, status_code, headers = @api_client.call_api(:{{httpMethod}}, local_var_path, new_options)
       rescue Dropbox::Sign::ApiError => e
@@ -315,6 +340,7 @@ module {{moduleName}}
         {{/returnType}}
       end
 
+{{/useCustomTemplateCode}}
       if @api_client.config.debugging
         @api_client.config.logger.debug "API called: {{classname}}#{{operationId}}\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
       end

data/templates/api_client.mustache

@@ -20,8 +20,10 @@ require 'httpx'
 require 'net/http/status'
 {{/isHttpx}}
 
+{{#useCustomTemplateCode}}
 module Dropbox
 end
+{{/useCustomTemplateCode}}
 
 module {{moduleName}}
   class ApiClient
@@ -133,7 +135,9 @@ module {{moduleName}}
           data.each { |k, v| hash[k] = convert_to_type(v, sub_type) }
         end
       else
-        # models (e.g. Pet)
+{{^useCustomTemplateCode}}
+        # models (e.g. Pet) or oneOf
+{{/useCustomTemplateCode}}
         klass = {{moduleName}}.const_get(return_type)
         klass.respond_to?(:openapi_one_of) ? klass.build(data) : klass.build_from_hash(data)
       end
@@ -244,6 +248,7 @@ module {{moduleName}}
         fail "unknown collection format: #{collection_format.inspect}"
       end
     end
+{{#useCustomTemplateCode}}
 
     def generate_form_data(obj, openapi_types)
       params = {}
@@ -268,5 +273,6 @@ module {{moduleName}}
         :params   => params,
       }
     end
+{{/useCustomTemplateCode}}
   end
 end

data/templates/api_client_faraday_partial.mustache

@@ -117,35 +117,41 @@
       request.options.on_data = Proc.new do |chunk, overall_received_bytes|
         stream << chunk
       end
+
       stream
     end
 
     def deserialize_file(response, stream)
-      body = response.body
-      if @config.return_binary_data == true
-        # return byte stream
-        encoding = body.encoding
-        stream.join.force_encoding(encoding)
+      body     = response.body
+      encoding = body.encoding
+
+      # reconstruct content
+      content = stream.join
+      content = content.unpack('m').join if response.headers['Content-Transfer-Encoding'] == 'binary'
+      content = content.force_encoding(encoding)
+
+      # return byte stream
+      return content if @config.return_binary_data == true
+
+      # return file instead of binary data
+      content_disposition = response.headers['Content-Disposition']
+      if content_disposition && content_disposition =~ /filename=/i
+        filename = content_disposition[/filename=['"]?([^'"\s]+)['"]?/, 1]
+        prefix = sanitize_filename(filename)
       else
-        # return file instead of binary data
-        content_disposition = response.headers['Content-Disposition']
-        if content_disposition && content_disposition =~ /filename=/i
-          filename = content_disposition[/filename=['"]?([^'"\s]+)['"]?/, 1]
-          prefix = sanitize_filename(filename)
-        else
-          prefix = 'download-'
-        end
-        prefix = prefix + '-' unless prefix.end_with?('-')
-        encoding = body.encoding
-        tempfile = Tempfile.open(prefix, @config.temp_folder_path, encoding: encoding)
-        tempfile.write(stream.join.force_encoding(encoding))
-        tempfile.close
-        config.logger.info "Temp file written to #{tempfile.path}, please copy the file to a proper folder "\
-                            "with e.g. `FileUtils.cp(tempfile.path, '/new/file/path')` otherwise the temp file "\
-                            "will be deleted automatically with GC. It's also recommended to delete the temp file "\
-                            "explicitly with `tempfile.delete`"
-        tempfile
+        prefix = 'download-'
       end
+      prefix = prefix + '-' unless prefix.end_with?('-')
+
+      tempfile = Tempfile.open(prefix, @config.temp_folder_path, encoding: encoding)
+      tempfile.write(content)
+      tempfile.close
+
+      config.logger.info "Temp file written to #{tempfile.path}, please copy the file to a proper folder "\
+                          "with e.g. `FileUtils.cp(tempfile.path, '/new/file/path')` otherwise the temp file "\
+                          "will be deleted automatically with GC. It's also recommended to delete the temp file "\
+                          "explicitly with `tempfile.delete`"
+      tempfile
     end
 
     def connection(opts)

data/templates/api_client_typhoeus_partial.mustache

@@ -154,7 +154,7 @@
                             "will be deleted automatically with GC. It's also recommended to delete the temp file "\
                             "explicitly with `tempfile.delete`"
       else
-        fail ApiError.new("Failed to create the tempfile based on the HTTP response from the server: #{request.inspect}")
+        fail ApiError.new("Failed to create the tempfile based on the HTTP response from the server: #{request.inspect}") 
       end
 
       tempfile

data/templates/api_doc.mustache

@@ -8,16 +8,28 @@ All URIs are relative to *{{basePath}}*
 | ------ | ------------ | ----------- |
 {{#operations}}
 {{#operation}}
+{{^useCustomTemplateCode}}
+| [**{{operationId}}**]({{classname}}.md#{{operationId}}) | **{{httpMethod}}** {{path}} | {{summary}} |
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 | [`{{operationId}}`]({{classname}}.md#{{operationId}}) | **{{httpMethod}}** `{{path}}` | {{summary}} |
+{{/useCustomTemplateCode}}
 {{/operation}}
 {{/operations}}
 
 {{#operations}}
 {{#operation}}
 
+{{^useCustomTemplateCode}}
+## {{operationId}}
+
+> {{#returnType}}{{#returnTypeIsPrimitive}}{{returnType}}{{/returnTypeIsPrimitive}}{{^returnTypeIsPrimitive}}<{{{returnType}}}>{{/returnTypeIsPrimitive}} {{/returnType}}{{operationId}}{{#hasParams}}({{^vendorExtensions.x-group-parameters}}{{#requiredParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/requiredParams}}{{#optionalParams}}{{#-last}}{{#hasRequiredParams}}, {{/hasRequiredParams}}opts{{/-last}}{{/optionalParams}}{{/vendorExtensions.x-group-parameters}}{{#vendorExtensions.x-group-parameters}}opts{{/vendorExtensions.x-group-parameters}}){{/hasParams}}
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 ## `{{operationId}}`
 
 > `{{#returnType}}{{#returnTypeIsPrimitive}}{{returnType}}{{/returnTypeIsPrimitive}}{{^returnTypeIsPrimitive}}<{{{returnType}}}>{{/returnTypeIsPrimitive}} {{/returnType}}{{operationId}}{{#hasParams}}({{#requiredParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/requiredParams}}{{#optionalParams}}{{#-last}}{{#hasRequiredParams}}, {{/hasRequiredParams}}opts{{/-last}}{{/optionalParams}}){{/hasParams}}`
+{{/useCustomTemplateCode}}
 
 {{{summary}}}{{#notes}}
 
@@ -26,14 +38,84 @@ All URIs are relative to *{{basePath}}*
 ### Examples
 
 ```ruby
+{{^useCustomTemplateCode}}
+require 'time'
+require '{{{gemName}}}'
+{{#hasAuthMethods}}
+# setup authorization
+{{{moduleName}}}.configure do |config|{{#authMethods}}{{#isBasic}}{{#isBasicBasic}}
+  # Configure HTTP basic authorization: {{{name}}}
+  config.username = 'YOUR USERNAME'
+  config.password = 'YOUR PASSWORD'{{/isBasicBasic}}{{#isBasicBearer}}
+  # Configure Bearer authorization{{#bearerFormat}} ({{{.}}}){{/bearerFormat}}: {{{name}}}
+  config.access_token = 'YOUR_BEARER_TOKEN'{{/isBasicBearer}}{{/isBasic}}{{#isApiKey}}
+  # Configure API key authorization: {{{name}}}
+  config.api_key['{{{name}}}'] = 'YOUR API KEY'
+  # Uncomment the following line to set a prefix for the API key, e.g. 'Bearer' (defaults to nil)
+  # config.api_key_prefix['{{{name}}}'] = 'Bearer'{{/isApiKey}}{{#isOAuth}}
+  # Configure OAuth2 access token for authorization: {{{name}}}
+  config.access_token = 'YOUR ACCESS TOKEN'{{/isOAuth}}
+{{/authMethods}}end
+{{/hasAuthMethods}}
+
+api_instance = {{{moduleName}}}::{{{classname}}}.new
+{{^vendorExtensions.x-group-parameters}}
+{{#requiredParams}}
+{{{paramName}}} = {{{vendorExtensions.x-ruby-example}}} # {{{dataType}}} | {{{description}}}
+{{/requiredParams}}
+{{#optionalParams}}
+{{#-first}}
+opts = {
+{{/-first}}
+  {{{paramName}}}: {{{vendorExtensions.x-ruby-example}}}{{^-last}},{{/-last}} # {{{dataType}}} | {{{description}}}
+{{#-last}}
+}
+{{/-last}}
+{{/optionalParams}}
+{{/vendorExtensions.x-group-parameters}}
+{{#vendorExtensions.x-group-parameters}}
+{{#hasParams}}
+opts = {
+{{#requiredParams}}
+    {{{paramName}}}: {{{vendorExtensions.x-ruby-example}}}, # {{{dataType}}} | {{{description}}} (required)
+{{/requiredParams}}
+{{#optionalParams}}
+    {{{paramName}}}: {{{vendorExtensions.x-ruby-example}}}, # {{{dataType}}} | {{{description}}}
+{{/optionalParams}}
+}
+{{/hasParams}}
+{{/vendorExtensions.x-group-parameters}}
+
+begin
+  {{#summary}}# {{{.}}}{{/summary}}
+  {{#returnType}}result = {{/returnType}}api_instance.{{{operationId}}}{{#hasParams}}({{^vendorExtensions.x-group-parameters}}{{#requiredParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/requiredParams}}{{#optionalParams}}{{#-last}}{{#hasRequiredParams}}, {{/hasRequiredParams}}opts{{/-last}}{{/optionalParams}}{{/vendorExtensions.x-group-parameters}}{{#vendorExtensions.x-group-parameters}}opts{{/vendorExtensions.x-group-parameters}}){{/hasParams}}
+  {{#returnType}}
+  p result
+  {{/returnType}}
+rescue {{{moduleName}}}::ApiError => e
+  puts "Error when calling {{classname}}->{{{operationId}}}: #{e}"
+end
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 REPLACE_ME_WITH_EXAMPLE_FOR__{{{operationId}}}_Ruby_CODE
+{{/useCustomTemplateCode}}
 ```
 
+{{^useCustomTemplateCode}}
+#### Using the {{operationId}}_with_http_info variant
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 #### Using the `{{operationId}}_with_http_info` variant
+{{/useCustomTemplateCode}}
 
 This returns an Array which contains the response data{{^returnType}} (`nil` in this case){{/returnType}}, status code and headers.
 
+{{^useCustomTemplateCode}}
+> <Array({{#returnType}}{{#returnTypeIsPrimitive}}{{returnType}}{{/returnTypeIsPrimitive}}{{^returnTypeIsPrimitive}}<{{{returnType}}}>{{/returnTypeIsPrimitive}}{{/returnType}}{{^returnType}}nil{{/returnType}}, Integer, Hash)> {{operationId}}_with_http_info{{#hasParams}}({{^vendorExtensions.x-group-parameters}}{{#requiredParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/requiredParams}}{{#optionalParams}}{{#-last}}{{#hasRequiredParams}}, {{/hasRequiredParams}}opts{{/-last}}{{/optionalParams}}{{/vendorExtensions.x-group-parameters}}{{#vendorExtensions.x-group-parameters}}opts{{/vendorExtensions.x-group-parameters}}){{/hasParams}}
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 > `<Array({{#returnType}}{{#returnTypeIsPrimitive}}{{returnType}}{{/returnTypeIsPrimitive}}{{^returnTypeIsPrimitive}}<{{{returnType}}}>{{/returnTypeIsPrimitive}}{{/returnType}}{{^returnType}}nil{{/returnType}}, Integer, Hash)> {{operationId}}_with_http_info{{#hasParams}}({{#requiredParams}}{{{paramName}}}{{^-last}}, {{/-last}}{{/requiredParams}}{{#optionalParams}}{{#-last}}{{#hasRequiredParams}}, {{/hasRequiredParams}}opts{{/-last}}{{/optionalParams}}){{/hasParams}}`
+{{/useCustomTemplateCode}}
 
 ```ruby
 begin
@@ -57,7 +139,12 @@ This endpoint does not need any parameter.
 | Name | Type | Description | Notes |
 | ---- | ---- | ----------- | ----- |
 {{/-first}}
+{{^useCustomTemplateCode}}
+| **{{paramName}}** | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}{{#isFile}}**{{dataType}}**{{/isFile}}{{^isFile}}[**{{dataType}}**]({{baseType}}.md){{/isFile}}{{/isPrimitiveType}} | {{description}} | {{^required}}[optional]{{/required}}{{#defaultValue}}[default to {{.}}]{{/defaultValue}} |
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
 | `{{paramName}}` | {{#isPrimitiveType}}**{{dataType}}**{{/isPrimitiveType}}{{^isPrimitiveType}}{{#isFile}}**{{dataType}}**{{/isFile}}{{^isFile}}[**{{dataType}}**]({{baseType}}.md){{/isFile}}{{/isPrimitiveType}} | {{description}} | {{^required}}[optional]{{/required}}{{#defaultValue}}[default to {{.}}]{{/defaultValue}} |
+{{/useCustomTemplateCode}}
 {{/allParams}}
 
 ### Return type

data/templates/api_error.mustache

@@ -2,12 +2,22 @@
 {{> api_info}}
 =end
 
+{{#useCustomTemplateCode}}
 module Dropbox
 end
 
+{{/useCustomTemplateCode}}
 module {{moduleName}}
   class ApiError < StandardError
+{{^useCustomTemplateCode}}
     attr_reader :code, :response_headers, :response_body
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
+    attr_reader :code, :response_headers
+
+    # @return [ErrorResponse]
+    attr_accessor :response_body
+{{/useCustomTemplateCode}}
 
     # Usage examples:
     #   ApiError.new

data/templates/base_object.mustache

@@ -1,6 +1,31 @@
     # Builds the object from hash
     # @param [Hash] attributes Model attributes in the form of hash
     # @return [Object] Returns the model itself
+{{^useCustomTemplateCode}}
+    def self.build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+      {{#parent}}
+      super(attributes)
+      {{/parent}}
+      attributes = attributes.transform_keys(&:to_sym)
+      transformed_hash = {}
+      openapi_types.each_pair do |key, type|
+        if attributes.key?(attribute_map[key]) && attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = nil
+        elsif type =~ /\AArray<(.*)>/i
+          # check to ensure the input is an array given that the attribute
+          # is documented as an array but the input is not
+          if attributes[attribute_map[key]].is_a?(Array)
+            transformed_hash["#{key}"] = attributes[attribute_map[key]].map { |v| _deserialize($1, v) }
+          end
+        elsif !attributes[attribute_map[key]].nil?
+          transformed_hash["#{key}"] = _deserialize(type, attributes[attribute_map[key]])
+        end
+      end
+      new(transformed_hash)
+    end
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
     def self.build_from_hash(attributes)
 {{#discriminator}}
       if !attributes[self.openapi_discriminator_name].nil?
@@ -38,12 +63,18 @@
 
       self
     end
+{{/useCustomTemplateCode}}
 
     # Deserializes the data based on type
     # @param string type Data type
     # @param string value Value to be deserialized
     # @return [Object] Deserialized data
+{{^useCustomTemplateCode}}
+    def self._deserialize(type, value)
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
     def _deserialize(type, value)
+{{/useCustomTemplateCode}}
       case type.to_sym
       when :Time
         Time.parse(value)
@@ -76,7 +107,9 @@
           end
         end
       else # model
-        # models (e.g. Pet)
+{{^useCustomTemplateCode}}
+        # models (e.g. Pet) or oneOf
+{{/useCustomTemplateCode}}
         klass = {{moduleName}}.const_get(type)
         klass.respond_to?(:openapi_any_of) || klass.respond_to?(:openapi_one_of) ? klass.build(value) : klass.build_from_hash(value)
       end
@@ -96,17 +129,37 @@
 
     # Returns the object in the form of hash
     # @return [Hash] Returns the object in the form of hash
+{{^useCustomTemplateCode}}
+    def to_hash
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
     def to_hash(include_nil = true)
+{{/useCustomTemplateCode}}
       hash = {{^parent}}{}{{/parent}}{{#parent}}super{{/parent}}
+{{^useCustomTemplateCode}}
+      self.class.attribute_map.each_pair do |attr, param|
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
       self.class.merged_attributes.each_pair do |attr, param|
+{{/useCustomTemplateCode}}
         value = self.send(attr)
         if value.nil?
+{{^useCustomTemplateCode}}
+          is_nullable = self.class.openapi_nullable.include?(attr)
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
           next unless include_nil
           is_nullable = self.class.merged_nullable.include?(attr)
+{{/useCustomTemplateCode}}
           next if !is_nullable || (is_nullable && !instance_variable_defined?(:"@#{attr}"))
         end
 
+{{^useCustomTemplateCode}}
+        hash[param] = _to_hash(value)
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
         hash[param] = _to_hash(value, include_nil)
+{{/useCustomTemplateCode}}
       end
       hash
     end
@@ -115,15 +168,35 @@
     # For object, use to_hash. Otherwise, just return the value
     # @param [Object] value Any valid value
     # @return [Hash] Returns the value in the form of hash
+{{^useCustomTemplateCode}}
+    def _to_hash(value)
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
     def _to_hash(value, include_nil = true)
+{{/useCustomTemplateCode}}
       if value.is_a?(Array)
+{{^useCustomTemplateCode}}
+        value.compact.map { |v| _to_hash(v) }
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
         value.compact.map { |v| _to_hash(v, include_nil) }
+{{/useCustomTemplateCode}}
       elsif value.is_a?(Hash)
         {}.tap do |hash|
+{{^useCustomTemplateCode}}
+          value.each { |k, v| hash[k] = _to_hash(v) }
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
           value.each { |k, v| hash[k] = _to_hash(v, include_nil) }
+{{/useCustomTemplateCode}}
         end
       elsif value.respond_to? :to_hash
+{{^useCustomTemplateCode}}
+        value.to_hash
+{{/useCustomTemplateCode}}
+{{#useCustomTemplateCode}}
         value.to_hash(include_nil)
+{{/useCustomTemplateCode}}
       else
         value
       end