wesley-key-sdk 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 1b7f68e0d65c4e998b5166bca622f595cb3752cd8109a9cbddafda349e10d87e
+  data.tar.gz: 3c6f5657cadf1efb23a2a2f5236da7b41555ddb2bed71e96443857b515c9d412
+SHA512:
+  metadata.gz: da0d9f1aa80e9ff43402e330a6c1c4dff22193565eaf04d9266ad637b9cc008fa82244dffbc946508b2701876d1749c94dcc5b92698184f37e895432761af691
+  data.tar.gz: d95ea0a4b26234419259772005030bc8beafe989e1d82df03a639bf0065ab6d52fdf70b5d33057458062c9f9da864e1edb032c26fa67298b7453fee12a15347e

data/LICENSE

@@ -0,0 +1,28 @@
+License: 
+========
+The MIT License (MIT)
+http://opensource.org/licenses/MIT
+
+Copyright (c) 2014 - 2025 APIMATIC Limited
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+Trade Mark:
+==========
+APIMATIC is a trade mark for APIMATIC Limited

data/README.md

@@ -0,0 +1,126 @@
+
+# Getting Started with Swagger Petstore
+
+## Introduction
+
+This is a sample server Petstore server.  You can find out more about Swagger at [http://swagger.io](http://swagger.io) or on [irc.freenode.net, #swagger](http://swagger.io/irc/).  For this sample, you can use the api key `special-key` to test the authorization filters.
+
+Find out more about Swagger: [http://swagger.io](http://swagger.io)
+
+## Install the Package
+
+Install the gem from the command line:
+
+```bash
+gem install wesley-key-sdk -v 0.1.2
+```
+
+Or add the gem to your Gemfile and run `bundle`:
+
+```ruby
+gem 'wesley-key-sdk', '0.1.2'
+```
+
+For additional gem details, see the [RubyGems page for the wesley-key-sdk gem](https://rubygems.org/gems/wesley-key-sdk/versions/0.1.2).
+
+## Test the SDK
+
+To run the tests, navigate to the root directory of the SDK in your terminal and execute the following command:
+
+```
+rake
+```
+
+## Initialize the API Client
+
+**_Note:_** Documentation for the client can be found [here.](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/client.md)
+
+The following parameters are configurable for the API Client:
+
+| Parameter | Type | Description |
+|  --- | --- | --- |
+| test_header | `String` | This is a test header<br>*Default*: `'TestHeaderDefaultValue'` |
+| environment | `Environment` | The API environment. <br> **Default: `Environment.PRODUCTION`** |
+| connection | `Faraday::Connection` | The Faraday connection object passed by the SDK user for making requests |
+| adapter | `Faraday::Adapter` | The Faraday adapter object passed by the SDK user for performing http requests |
+| timeout | `Float` | The value to use for connection timeout. <br> **Default: 60** |
+| max_retries | `Integer` | The number of times to retry an endpoint call if it fails. <br> **Default: 0** |
+| retry_interval | `Float` | Pause in seconds between retries. <br> **Default: 1** |
+| backoff_factor | `Float` | The amount to multiply each successive retry's interval amount by in order to provide backoff. <br> **Default: 2** |
+| retry_statuses | `Array` | A list of HTTP statuses to retry. <br> **Default: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524]** |
+| retry_methods | `Array` | A list of HTTP methods to retry. <br> **Default: %i[get put]** |
+| http_callback | `HttpCallBack` | The Http CallBack allows defining callables for pre and post API calls. |
+| proxy_settings | [`ProxySettings`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/proxy-settings.md) | Optional proxy configuration to route HTTP requests through a proxy server. |
+| api_key_credentials | [`ApiKeyCredentials`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/auth/custom-header-signature.md) | The credential object for Custom Header Signature |
+| http_basic_credentials | [`HttpBasicCredentials`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/auth/basic-authentication.md) | The credential object for Basic Authentication |
+| petstore_auth_credentials | [`PetstoreAuthCredentials`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/auth/oauth-2-implicit-grant.md) | The credential object for OAuth 2 Implicit Grant |
+
+The API client can be initialized as follows:
+
+```ruby
+require 'swagger_petstore'
+include SwaggerPetstore
+
+client = Client.new(
+  test_header: 'TestHeaderDefaultValue',
+  api_key_credentials: ApiKeyCredentials.new(
+    api_key: 'api_key'
+  ),
+  http_basic_credentials: HttpBasicCredentials.new(
+    username: 'username',
+    passwprd: 'passwprd'
+  ),
+  petstore_auth_credentials: PetstoreAuthCredentials.new(
+    o_auth_client_id: 'OAuthClientId',
+    o_auth_redirect_uri: 'OAuthRedirectUri',
+    o_auth_scopes: [
+      OAuthScopePetstoreAuthEnum::READPETS,
+      OAuthScopePetstoreAuthEnum::WRITEPETS
+    ]
+  ),
+  environment: Environment::PRODUCTION
+)
+```
+
+## Environments
+
+The SDK can be configured to use a different environment for making API calls. Available environments are:
+
+### Fields
+
+| Name | Description |
+|  --- | --- |
+| production | **Default** |
+| environment2 | - |
+| environment3 | - |
+
+## Authorization
+
+This API uses the following authentication schemes.
+
+* [`api_key (Custom Header Signature)`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/auth/custom-header-signature.md)
+* [`httpBasic (Basic Authentication)`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/auth/basic-authentication.md)
+* [`petstore_auth (OAuth 2 Implicit Grant)`](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/auth/oauth-2-implicit-grant.md)
+
+## List of APIs
+
+* [Pet](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/controllers/pet.md)
+* [Store](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/controllers/store.md)
+* [User](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/controllers/user.md)
+
+## SDK Infrastructure
+
+### Configuration
+
+* [ProxySettings](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/proxy-settings.md)
+
+### HTTP
+
+* [HttpResponse](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/http-response.md)
+* [HttpRequest](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/http-request.md)
+
+### Utilities
+
+* [ApiHelper](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/api-helper.md)
+* [DateTimeHelper](https://www.github.com/ZahraN444/wesley-key-ruby-sdk/tree/0.1.2/doc/date-time-helper.md)
+

data/lib/swagger_petstore/api_helper.rb

@@ -0,0 +1,10 @@
+# swagger_petstore
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module SwaggerPetstore
+  # API utility class
+  class APIHelper < CoreLibrary::ApiHelper
+  end
+end

data/lib/swagger_petstore/client.rb

@@ -0,0 +1,84 @@
+# swagger_petstore
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module SwaggerPetstore
+  #  swagger_petstore client class.
+  class Client
+    include CoreLibrary
+    attr_reader :config, :auth_managers
+
+    # Returns the configured authentication petstore_auth instance.
+    def petstore_auth
+      @auth_managers['petstore_auth']
+    end
+
+    # Access to pet controller.
+    # @return [PetController] Returns the controller instance.
+    def pet
+      @pet ||= PetController.new @global_configuration
+    end
+
+    # Access to store controller.
+    # @return [StoreController] Returns the controller instance.
+    def store
+      @store ||= StoreController.new @global_configuration
+    end
+
+    # Access to user controller.
+    # @return [UserController] Returns the controller instance.
+    def user
+      @user ||= UserController.new @global_configuration
+    end
+
+    def initialize(
+      connection: nil, adapter: :net_http_persistent, timeout: 60,
+      max_retries: 0, retry_interval: 1, backoff_factor: 2,
+      retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
+      retry_methods: %i[get put], http_callback: nil, proxy_settings: nil,
+      environment: Environment::PRODUCTION, api_key_credentials: nil,
+      http_basic_credentials: nil, petstore_auth_credentials: nil,
+      test_header: 'TestHeaderDefaultValue', config: nil
+    )
+      @config = if config.nil?
+                  Configuration.new(
+                    connection: connection, adapter: adapter, timeout: timeout,
+                    max_retries: max_retries, retry_interval: retry_interval,
+                    backoff_factor: backoff_factor,
+                    retry_statuses: retry_statuses,
+                    retry_methods: retry_methods, http_callback: http_callback,
+                    proxy_settings: proxy_settings, environment: environment,
+                    api_key_credentials: api_key_credentials,
+                    http_basic_credentials: http_basic_credentials,
+                    petstore_auth_credentials: petstore_auth_credentials,
+                    test_header: test_header
+                  )
+                else
+                  config
+                end
+
+      @global_configuration = GlobalConfiguration.new(client_configuration: @config)
+                                                 .base_uri_executor(@config.method(:get_base_uri))
+                                                 .global_errors(BaseController::GLOBAL_ERRORS)
+                                                 .user_agent(BaseController.user_agent)
+                                                 .global_header('TestHeader', @config.test_header)
+
+      initialize_auth_managers(@global_configuration)
+      @global_configuration = @global_configuration.auth_managers(@auth_managers)
+    end
+
+    # Initializes the auth managers hash used for authenticating API calls.
+    # @param [GlobalConfiguration] global_config The global configuration of the SDK)
+    def initialize_auth_managers(global_config)
+      @auth_managers = {}
+      http_client_config = global_config.client_configuration
+      %w[api_key httpBasic petstore_auth].each { |auth| @auth_managers[auth] = nil }
+      @auth_managers['api_key'] = ApiKey.new(http_client_config.api_key_credentials)
+      @auth_managers['httpBasic'] = HttpBasic.new(http_client_config.http_basic_credentials)
+      @auth_managers['petstore_auth'] = PetstoreAuth.new(
+        http_client_config.petstore_auth_credentials, global_config
+      )
+    end
+  end
+end

data/lib/swagger_petstore/configuration.rb

@@ -0,0 +1,127 @@
+# swagger_petstore
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module SwaggerPetstore
+  # An enum for SDK environments.
+  class Environment
+    ENVIRONMENT = [
+      PRODUCTION = 'production'.freeze,
+      ENVIRONMENT2 = 'environment2'.freeze,
+      ENVIRONMENT3 = 'environment3'.freeze
+    ].freeze
+  end
+
+  # An enum for API servers.
+  class Server
+    SERVER = [
+      DEFAULT = 'default'.freeze
+    ].freeze
+  end
+
+  # All configuration including auth info and base URI for the API access
+  # are configured in this class.
+  class Configuration < CoreLibrary::HttpClientConfiguration
+    # The attribute readers for properties.
+    attr_reader :environment, :api_key_credentials, :http_basic_credentials,
+                :petstore_auth_credentials, :test_header
+
+    class << self
+      attr_reader :environments
+    end
+
+    def initialize(
+      connection: nil, adapter: :net_http_persistent, timeout: 60,
+      max_retries: 0, retry_interval: 1, backoff_factor: 2,
+      retry_statuses: [408, 413, 429, 500, 502, 503, 504, 521, 522, 524],
+      retry_methods: %i[get put], http_callback: nil, proxy_settings: nil,
+      environment: Environment::PRODUCTION, api_key_credentials: nil,
+      http_basic_credentials: nil, petstore_auth_credentials: nil,
+      test_header: 'TestHeaderDefaultValue'
+    )
+      super connection: connection, adapter: adapter, timeout: timeout,
+            max_retries: max_retries, retry_interval: retry_interval,
+            backoff_factor: backoff_factor, retry_statuses: retry_statuses,
+            retry_methods: retry_methods, http_callback: http_callback,
+            proxy_settings: proxy_settings
+
+      # Current API environment
+      @environment = String(environment)
+
+      # The object holding Custom Header Signature credentials
+      @api_key_credentials = api_key_credentials
+
+      # The object holding Basic Authentication credentials
+      @http_basic_credentials = http_basic_credentials
+
+      # The object holding OAuth 2 Implicit Grant credentials
+      @petstore_auth_credentials = petstore_auth_credentials
+
+      # This is a test header
+      @test_header = test_header
+
+      # The Http Client to use for making requests.
+      set_http_client CoreLibrary::FaradayClient.new(self)
+    end
+
+    def clone_with(connection: nil, adapter: nil, timeout: nil,
+                   max_retries: nil, retry_interval: nil, backoff_factor: nil,
+                   retry_statuses: nil, retry_methods: nil, http_callback: nil,
+                   proxy_settings: nil, environment: nil,
+                   api_key_credentials: nil, http_basic_credentials: nil,
+                   petstore_auth_credentials: nil, test_header: nil)
+      connection ||= self.connection
+      adapter ||= self.adapter
+      timeout ||= self.timeout
+      max_retries ||= self.max_retries
+      retry_interval ||= self.retry_interval
+      backoff_factor ||= self.backoff_factor
+      retry_statuses ||= self.retry_statuses
+      retry_methods ||= self.retry_methods
+      http_callback ||= self.http_callback
+      proxy_settings ||= self.proxy_settings
+      environment ||= self.environment
+      api_key_credentials ||= self.api_key_credentials
+      http_basic_credentials ||= self.http_basic_credentials
+      petstore_auth_credentials ||= self.petstore_auth_credentials
+      test_header ||= self.test_header
+
+      Configuration.new(connection: connection, adapter: adapter,
+                        timeout: timeout, max_retries: max_retries,
+                        retry_interval: retry_interval,
+                        backoff_factor: backoff_factor,
+                        retry_statuses: retry_statuses,
+                        retry_methods: retry_methods,
+                        http_callback: http_callback,
+                        proxy_settings: proxy_settings,
+                        environment: environment,
+                        api_key_credentials: api_key_credentials,
+                        http_basic_credentials: http_basic_credentials,
+                        petstore_auth_credentials: petstore_auth_credentials,
+                        test_header: test_header)
+    end
+
+
+    # All the environments the SDK can run in.
+    ENVIRONMENTS = {
+      Environment::PRODUCTION => {
+        Server::DEFAULT => 'https://petstore.swagger.io/v2'
+      },
+      Environment::ENVIRONMENT2 => {
+        Server::DEFAULT => 'http://petstore.swagger.io/v2'
+      },
+      Environment::ENVIRONMENT3 => {
+        Server::DEFAULT => 'https://petstore.swagger.io/oauth'
+      }
+    }.freeze
+
+    # Generates the appropriate base URI for the environment and the server.
+    # @param [Configuration::Server] server The server enum for which the base URI is
+    # required.
+    # @return [String] The base URI.
+    def get_base_uri(server = Server::DEFAULT)
+      ENVIRONMENTS[environment][server].clone
+    end
+  end
+end

data/lib/swagger_petstore/controllers/base_controller.rb

@@ -0,0 +1,60 @@
+# swagger_petstore
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module SwaggerPetstore
+  # BaseController.
+  class BaseController
+    include CoreLibrary
+    attr_accessor :config, :http_call_back
+
+    def self.user_agent
+      'APIMATIC 3.0'
+    end
+
+
+    GLOBAL_ERRORS = {
+      'default' => ErrorCase.new
+                            .error_message('HTTP response not OK.')
+                            .exception_type(APIException)
+    }.freeze
+
+    # Initialization constructor.
+    # @param [GlobalConfiguration] global_configuration The instance of GlobalConfiguration.
+    def initialize(global_configuration)
+      @global_configuration = global_configuration
+      @config = @global_configuration.client_configuration
+      @http_call_back = @config.http_callback
+      @api_call = ApiCall.new(@global_configuration)
+    end
+
+    # Creates a new instance of the request builder.
+    # @param [String] http_method The HTTP method to use in the request.
+    # @param [String] path The endpoint path to use in the request.
+    # @param [String] server The server to extract the base uri for the request.
+    # @return [RequestBuilder] The instance of RequestBuilder.
+    def new_request_builder(http_method, path, server)
+      RequestBuilder.new
+                    .http_method(http_method)
+                    .path(path)
+                    .server(server)
+    end
+
+    # Creates a new instance of the response handler.
+    # @return [ResponseHandler] The instance of ResponseHandler.
+    def new_response_handler
+      ResponseHandler.new
+    end
+
+    # Creates a new instance of the parameter.
+    # @param [String|optional] key The key of the parameter.
+    # @param [Object] value The value of the parameter.
+    # @return [Parameter] The instance of Parameter.
+    def new_parameter(value, key: nil)
+      Parameter.new
+               .key(key)
+               .value(value)
+    end
+  end
+end

data/lib/swagger_petstore/controllers/pet_controller.rb

@@ -0,0 +1,206 @@
+# swagger_petstore
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module SwaggerPetstore
+  # PetController
+  class PetController < BaseController
+    # Returns a single pet
+    # @param [Integer] pet_id Required parameter: ID of pet to return
+    # @return [Pet] Response from the API call.
+    def get_pet_by_id(pet_id)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/pet/{petId}',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(pet_id, key: 'petId')
+                                    .should_encode(true))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('api_key')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Pet.method(:from_hash))
+                    .local_error('400',
+                                 'Invalid ID supplied',
+                                 APIException)
+                    .local_error('404',
+                                 'Pet not found',
+                                 APIException))
+        .execute
+    end
+
+    # Updates a pet in the store with form data
+    # @param [Integer] pet_id Required parameter: ID of pet that needs to be
+    # updated
+    # @param [ContentTypeEnum] content_type Required parameter: Example:
+    # @param [String] name Optional parameter: Updated name of the pet
+    # @param [String] status Optional parameter: Updated status of the pet
+    # @return [void] Response from the API call.
+    def update_pet_with_form(pet_id,
+                             content_type,
+                             name: nil,
+                             status: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/pet/{petId}',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(pet_id, key: 'petId')
+                                    .should_encode(true))
+                   .form_param(new_parameter(name, key: 'name'))
+                   .form_param(new_parameter(status, key: 'status'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .auth(Single.new('petstore_auth')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .local_error('405',
+                                 'Invalid input',
+                                 APIException))
+        .execute
+    end
+
+    # Deletes a pet
+    # @param [Integer] pet_id Required parameter: Pet id to delete
+    # @param [String] api_key Optional parameter: Example:
+    # @return [void] Response from the API call.
+    def delete_pet(pet_id,
+                   api_key: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::DELETE,
+                                     '/pet/{petId}',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(pet_id, key: 'petId')
+                                    .should_encode(true))
+                   .header_param(new_parameter(api_key, key: 'api_key'))
+                   .auth(Single.new('petstore_auth')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .local_error('400',
+                                 'Invalid ID supplied',
+                                 APIException)
+                    .local_error('404',
+                                 'Pet not found',
+                                 APIException))
+        .execute
+    end
+
+    # Add a new pet to the store
+    # @param [PetRequest] body Required parameter: Pet object that needs to be
+    # added to the store
+    # @return [void] Response from the API call.
+    def add_pet(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/pet',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('petstore_auth')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .local_error('405',
+                                 'Invalid input',
+                                 APIException))
+        .execute
+    end
+
+    # Update an existing pet
+    # @param [PetRequest] body Required parameter: Pet object that needs to be
+    # added to the store
+    # @return [void] Response from the API call.
+    def update_pet(body)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::PUT,
+                                     '/pet',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'Content-Type'))
+                   .body_param(new_parameter(body))
+                   .body_serializer(proc do |param| param.to_json unless param.nil? end)
+                   .auth(Single.new('petstore_auth')))
+        .response(new_response_handler
+                    .is_response_void(true)
+                    .local_error('400',
+                                 'Invalid ID supplied',
+                                 APIException)
+                    .local_error('404',
+                                 'Pet not found',
+                                 APIException)
+                    .local_error('405',
+                                 'Validation exception',
+                                 APIException))
+        .execute
+    end
+
+    # Multiple status values can be provided with comma separated strings
+    # @param [Array[Status2Enum]] status Required parameter: Status values that
+    # need to be considered for filter
+    # @return [Array[Pet]] Response from the API call.
+    def find_pets_by_status(status)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/pet/findByStatus',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(status, key: 'status'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('petstore_auth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Pet.method(:from_hash))
+                    .is_response_array(true)
+                    .local_error('400',
+                                 'Invalid status value',
+                                 APIException))
+        .execute
+    end
+
+    # uploads an image
+    # @param [Integer] pet_id Required parameter: ID of pet to update
+    # @param [String] additional_metadata Optional parameter: Additional data to
+    # pass to server
+    # @param [File | UploadIO] file Optional parameter: file to upload
+    # @return [ApiResponse] Response from the API call.
+    def upload_file(pet_id,
+                    additional_metadata: nil,
+                    file: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/pet/{petId}/uploadImage',
+                                     Server::DEFAULT)
+                   .template_param(new_parameter(pet_id, key: 'petId')
+                                    .should_encode(true))
+                   .form_param(new_parameter(additional_metadata, key: 'additionalMetadata'))
+                   .multipart_param(new_parameter(file, key: 'file')
+                                     .default_content_type('application/octet-stream'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('petstore_auth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ApiResponse.method(:from_hash)))
+        .execute
+    end
+
+    # Multiple tags can be provided with comma separated strings. Use tag1,
+    # tag2, tag3 for testing.
+    # @param [Array[String]] tags Required parameter: Tags to filter by
+    # @return [Array[Pet]] Response from the API call.
+    def find_pets_by_tags(tags)
+      warn 'Endpoint find_pets_by_tags in PetController is deprecated'
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/pet/findByTags',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(tags, key: 'tags'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('petstore_auth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(Pet.method(:from_hash))
+                    .is_response_array(true)
+                    .local_error('400',
+                                 'Invalid tag value',
+                                 APIException))
+        .execute
+    end
+  end
+end