colorado-booth-sdk 1.0.0

data/lib/multi_auth_sample/controllers/authentication_controller.rb

@@ -0,0 +1,149 @@
+# multi_auth_sample
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module MultiAuthSample
+  # AuthenticationController
+  class AuthenticationController < BaseController
+    # TODO: type endpoint description here
+    # @return [String] Response from the API call.
+    def custom_authentication
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/auth/customAuthentication',
+                                     Server::DEFAULT)
+                   .auth(Single.new('CustomAuth')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:deserialize_primitive_types))
+                    .deserialize_into(proc do |response| response&.to_s end)
+                    .is_primitive_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @return [String] Response from the API call.
+    def o_auth_bearer_token
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/auth/oauth2',
+                                     Server::DEFAULT)
+                   .auth(Single.new('OAuthBearerToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:deserialize_primitive_types))
+                    .deserialize_into(proc do |response| response&.to_s end)
+                    .is_primitive_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @return [ServiceStatus] Response from the API call.
+    def o_auth_client_credentials_grant
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/oauth2/non-auth-server/status',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(Single.new('OAuthCCG')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(ServiceStatus.method(:from_hash)))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @return [User] Response from the API call.
+    def o_auth_authorization_grant
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/oauth2/non-auth-server/user',
+                                     Server::DEFAULT)
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .auth(And.new('OAuthACG', 'OAuthROPCG')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(User.method(:from_hash)))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @return [String] Response from the API call.
+    def custom_query_or_header_authentication
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/auth/customQueryOrHeaderParam',
+                                     Server::DEFAULT)
+                   .auth(Or.new('apiKey', 'apiHeader')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:deserialize_primitive_types))
+                    .deserialize_into(proc do |response| response&.to_s end)
+                    .is_primitive_response(true))
+        .execute
+    end
+
+    # TODO: type endpoint description here
+    # @return [String] Response from the API call.
+    def basic_auth_and_api_header_auth
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/auth/basicAndApiKeyAndApiHeader',
+                                     Server::DEFAULT)
+                   .auth(And.new('basicAuth', 'apiKey', 'apiHeader')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:deserialize_primitive_types))
+                    .deserialize_into(proc do |response| response&.to_s end)
+                    .is_primitive_response(true))
+        .execute
+    end
+
+    # This endpoint tests or combinations of OAuth types
+    # @return [String] Response from the API call.
+    def o_auth_grant_types_or_combinations
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/oauth2/oauthOrCombination',
+                                     Server::DEFAULT)
+                   .auth(Or.new('OAuthCCG', 'OAuthBearerToken')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:deserialize_primitive_types))
+                    .deserialize_into(proc do |response| response&.to_s end)
+                    .is_primitive_response(true))
+        .execute
+    end
+
+    # This endpoint uses globally applied auth which is a hypothetical scneraio
+    # but covers the worst case.
+    # @return [String] Response from the API call.
+    def multiple_auth_combination
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/auth/multipleAuthCombination',
+                                     Server::DEFAULT)
+                   .auth(Or.new('CustomAuth', 'OAuthBearerToken', And.new('basicAuth', 'apiKey', 'apiHeader'))))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:deserialize_primitive_types))
+                    .deserialize_into(proc do |response| response&.to_s end)
+                    .is_primitive_response(true))
+        .execute
+    end
+
+    # This endpoint does not use auth.
+    # @return [String] Response from the API call.
+    def no_auth
+      warn 'Endpoint no_auth in AuthenticationController is deprecated since v'\
+           'ersion 0.0.1-alpha.    You should not use this method as it requir'\
+           'es no auth and can bring security issues to the server and api cal'\
+           'l itself!!'
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::GET,
+                                     '/auth/noAuth',
+                                     Server::DEFAULT)
+                   .query_param(new_parameter(true, key: 'array')))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:deserialize_primitive_types))
+                    .deserialize_into(proc do |response| response&.to_s end)
+                    .is_primitive_response(true))
+        .execute
+    end
+  end
+end

data/lib/multi_auth_sample/controllers/base_controller.rb

@@ -0,0 +1,60 @@
+# multi_auth_sample
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module MultiAuthSample
+  # 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/multi_auth_sample/controllers/o_auth_authorization_controller.rb

@@ -0,0 +1,188 @@
+# multi_auth_sample
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module MultiAuthSample
+  # OAuthAuthorizationController
+  class OAuthAuthorizationController < BaseController
+    # Create a new OAuth 2 token.
+    # @param [String] authorization Required parameter: Authorization header in
+    # Basic auth format
+    # @param [String] scope Optional parameter: Requested scopes as a
+    # space-delimited list.
+    # @param [Hash] _field_parameters Additional optional form parameters are
+    # supported by this endpoint.
+    # @return [OAuthToken] Response from the API call.
+    def request_token_o_auth_ccg(authorization,
+                                 scope: nil,
+                                 _field_parameters: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/request_token',
+                                     Server::AUTH)
+                   .form_param(new_parameter('client_credentials', key: 'grant_type'))
+                   .header_param(new_parameter(authorization, key: 'Authorization'))
+                   .form_param(new_parameter(scope, key: 'scope'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .additional_form_params(_field_parameters))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OAuthToken.method(:from_hash))
+                    .local_error('400',
+                                 'OAuth 2 provider returned an error.',
+                                 OAuthProviderException)
+                    .local_error('401',
+                                 'OAuth 2 provider says client authentication failed.',
+                                 OAuthProviderException))
+        .execute
+    end
+
+    # Create a new OAuth 2 token.
+    # @param [String] authorization Required parameter: Authorization header in
+    # Basic auth format
+    # @param [String] code Required parameter: Authorization Code
+    # @param [String] redirect_uri Required parameter: Redirect Uri
+    # @param [Hash] _field_parameters Additional optional form parameters are
+    # supported by this endpoint.
+    # @return [OAuthToken] Response from the API call.
+    def request_token_o_auth_acg(authorization,
+                                 code,
+                                 redirect_uri,
+                                 _field_parameters: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/oauth2/non-auth-server/token',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter('authorization_code', key: 'grant_type'))
+                   .header_param(new_parameter(authorization, key: 'Authorization'))
+                   .form_param(new_parameter(code, key: 'code'))
+                   .form_param(new_parameter(redirect_uri, key: 'redirect_uri'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .additional_form_params(_field_parameters))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OAuthToken.method(:from_hash))
+                    .local_error('400',
+                                 'OAuth 2 provider returned an error.',
+                                 OAuthProviderException)
+                    .local_error('401',
+                                 'OAuth 2 provider says client authentication failed.',
+                                 OAuthProviderException))
+        .execute
+    end
+
+    # Obtain a new access token using a refresh token
+    # @param [String] authorization Required parameter: Authorization header in
+    # Basic auth format
+    # @param [String] refresh_token Required parameter: Refresh token
+    # @param [String] scope Optional parameter: Requested scopes as a
+    # space-delimited list.
+    # @param [Hash] _field_parameters Additional optional form parameters are
+    # supported by this endpoint.
+    # @return [OAuthToken] Response from the API call.
+    def refresh_token_o_auth_acg(authorization,
+                                 refresh_token,
+                                 scope: nil,
+                                 _field_parameters: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/oauth2/non-auth-server/token',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter('refresh_token', key: 'grant_type'))
+                   .header_param(new_parameter(authorization, key: 'Authorization'))
+                   .form_param(new_parameter(refresh_token, key: 'refresh_token'))
+                   .form_param(new_parameter(scope, key: 'scope'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .additional_form_params(_field_parameters))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OAuthToken.method(:from_hash))
+                    .local_error('400',
+                                 'OAuth 2 provider returned an error.',
+                                 OAuthProviderException)
+                    .local_error('401',
+                                 'OAuth 2 provider says client authentication failed.',
+                                 OAuthProviderException))
+        .execute
+    end
+
+    # Create a new OAuth 2 token.
+    # @param [String] authorization Required parameter: Authorization header in
+    # Basic auth format
+    # @param [String] username Required parameter: Resource owner username
+    # @param [String] password Required parameter: Resource owner password
+    # @param [String] scope Optional parameter: Requested scopes as a
+    # space-delimited list.
+    # @param [Hash] _field_parameters Additional optional form parameters are
+    # supported by this endpoint.
+    # @return [OAuthToken] Response from the API call.
+    def request_token_o_auth_ropcg(authorization,
+                                   username,
+                                   password,
+                                   scope: nil,
+                                   _field_parameters: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/oauth2/non-auth-server/token',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter('password', key: 'grant_type'))
+                   .header_param(new_parameter(authorization, key: 'Authorization'))
+                   .form_param(new_parameter(username, key: 'username'))
+                   .form_param(new_parameter(password, key: 'password'))
+                   .form_param(new_parameter(scope, key: 'scope'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .additional_form_params(_field_parameters))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OAuthToken.method(:from_hash))
+                    .local_error('400',
+                                 'OAuth 2 provider returned an error.',
+                                 OAuthProviderException)
+                    .local_error('401',
+                                 'OAuth 2 provider says client authentication failed.',
+                                 OAuthProviderException))
+        .execute
+    end
+
+    # Obtain a new access token using a refresh token
+    # @param [String] authorization Required parameter: Authorization header in
+    # Basic auth format
+    # @param [String] refresh_token Required parameter: Refresh token
+    # @param [String] scope Optional parameter: Requested scopes as a
+    # space-delimited list.
+    # @param [Hash] _field_parameters Additional optional form parameters are
+    # supported by this endpoint.
+    # @return [OAuthToken] Response from the API call.
+    def refresh_token_o_auth_ropcg(authorization,
+                                   refresh_token,
+                                   scope: nil,
+                                   _field_parameters: nil)
+      @api_call
+        .request(new_request_builder(HttpMethodEnum::POST,
+                                     '/oauth2/non-auth-server/token',
+                                     Server::DEFAULT)
+                   .form_param(new_parameter('refresh_token', key: 'grant_type'))
+                   .header_param(new_parameter(authorization, key: 'Authorization'))
+                   .form_param(new_parameter(refresh_token, key: 'refresh_token'))
+                   .form_param(new_parameter(scope, key: 'scope'))
+                   .header_param(new_parameter('application/x-www-form-urlencoded', key: 'content-type'))
+                   .header_param(new_parameter('application/json', key: 'accept'))
+                   .additional_form_params(_field_parameters))
+        .response(new_response_handler
+                    .deserializer(APIHelper.method(:custom_type_deserializer))
+                    .deserialize_into(OAuthToken.method(:from_hash))
+                    .local_error('400',
+                                 'OAuth 2 provider returned an error.',
+                                 OAuthProviderException)
+                    .local_error('401',
+                                 'OAuth 2 provider says client authentication failed.',
+                                 OAuthProviderException))
+        .execute
+    end
+  end
+end

data/lib/multi_auth_sample/exceptions/api_exception.rb

@@ -0,0 +1,21 @@
+# multi_auth_sample
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module MultiAuthSample
+  # Class for exceptions when there is a network error, status code error, etc.
+  class APIException < CoreLibrary::ApiException
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status_code: #{@response_code}, reason: #{@reason}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} status_code: #{@response_code.inspect}, reason: #{@reason.inspect}>"
+    end
+  end
+end

data/lib/multi_auth_sample/exceptions/o_auth_provider_exception.rb

@@ -0,0 +1,64 @@
+# multi_auth_sample
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module MultiAuthSample
+  # OAuth 2 Authorization endpoint exception.
+  class OAuthProviderException < APIException
+    SKIP = Object.new
+    private_constant :SKIP
+
+    # Gets or sets error code.
+    # @return [OAuthProviderErrorEnum]
+    attr_accessor :error
+
+    # Gets or sets human-readable text providing additional information on
+    # error.
+    # Used to assist the client developer in understanding the error that
+    # occurred.
+    # @return [String]
+    attr_accessor :error_description
+
+    # Gets or sets a URI identifying a human-readable web page with information
+    # about the error, used to provide the client developer with additional
+    # information about the error.
+    # @return [String]
+    attr_accessor :error_uri
+
+    # The constructor.
+    # @param [String] reason The reason for raising an exception.
+    # @param [HttpResponse] response The HttpReponse of the API call.
+    def initialize(reason, response)
+      super(reason, response)
+      hash = APIHelper.json_deserialize(@response.raw_body)
+      unbox(hash)
+    end
+
+    # Populates this object by extracting properties from a hash.
+    # @param [Hash] hash The deserialized response sent by the server in the
+    # response body.
+    def unbox(hash)
+      return nil unless hash
+
+      @error = hash.key?('error') ? hash['error'] : nil
+      @error_description =
+        hash.key?('error_description') ? hash['error_description'] : SKIP
+      @error_uri = hash.key?('error_uri') ? hash['error_uri'] : SKIP
+    end
+
+    # Provides a human-readable string representation of the object.
+    def to_s
+      class_name = self.class.name.split('::').last
+      "<#{class_name} error: #{@error}, error_description: #{@error_description}, error_uri:"\
+      " #{@error_uri}>"
+    end
+
+    # Provides a debugging-friendly string with detailed object information.
+    def inspect
+      class_name = self.class.name.split('::').last
+      "<#{class_name} error: #{@error.inspect}, error_description: #{@error_description.inspect},"\
+      " error_uri: #{@error_uri.inspect}>"
+    end
+  end
+end

data/lib/multi_auth_sample/http/auth/api_header.rb

@@ -0,0 +1,59 @@
+# multi_auth_sample
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module MultiAuthSample
+  # Utility class for custom header authorization.
+  class ApiHeader < CoreLibrary::HeaderAuth
+    # Display error message on occurrence of authentication failure.
+    # @returns [String] The oAuth error message.
+    def error_message
+      'ApiHeader: token or api_key is undefined.'
+    end
+
+    # Initialization constructor.
+    def initialize(api_header_credentials)
+      auth_params = {}
+      auth_params['token'] = api_header_credentials.token unless
+        api_header_credentials.nil? || api_header_credentials.token.nil?
+      auth_params['api-key'] = api_header_credentials.api_key unless
+        api_header_credentials.nil? || api_header_credentials.api_key.nil?
+
+      super auth_params
+    end
+  end
+
+  # Data class for ApiHeaderCredentials.
+  # Data class for ApiHeaderCredentials.
+  class ApiHeaderCredentials
+    attr_reader :token, :api_key
+
+    def initialize(token:, api_key:)
+      raise ArgumentError, 'token cannot be nil' if token.nil?
+      raise ArgumentError, 'api_key cannot be nil' if api_key.nil?
+
+      @token = token
+      @api_key = api_key
+    end
+
+    def self.from_env
+      token = ENV['API_HEADER_TOKEN']
+      api_key = ENV['API_HEADER_API_KEY']
+      all_nil = [
+        token,
+        api_key
+      ].all?(&:nil?)
+      return nil if all_nil
+
+      new(token: token, api_key: api_key)
+    end
+
+    def clone_with(token: nil, api_key: nil)
+      token ||= self.token
+      api_key ||= self.api_key
+
+      ApiHeaderCredentials.new(token: token, api_key: api_key)
+    end
+  end
+end

data/lib/multi_auth_sample/http/auth/api_key.rb

@@ -0,0 +1,59 @@
+# multi_auth_sample
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module MultiAuthSample
+  # Utility class for custom query_parameter authorization.
+  class ApiKey < CoreLibrary::QueryAuth
+    # Display error message on occurrence of authentication failure.
+    # @returns [String] The oAuth error message.
+    def error_message
+      'ApiKey: token or api_key is undefined.'
+    end
+
+    # Initialization constructor.
+    def initialize(api_key_credentials)
+      auth_params = {}
+      auth_params['token'] = api_key_credentials.token unless
+        api_key_credentials.nil? || api_key_credentials.token.nil?
+      auth_params['api-key'] = api_key_credentials.api_key unless
+        api_key_credentials.nil? || api_key_credentials.api_key.nil?
+
+      super auth_params
+    end
+  end
+
+  # Data class for ApiKeyCredentials.
+  # Data class for ApiKeyCredentials.
+  class ApiKeyCredentials
+    attr_reader :token, :api_key
+
+    def initialize(token:, api_key:)
+      raise ArgumentError, 'token cannot be nil' if token.nil?
+      raise ArgumentError, 'api_key cannot be nil' if api_key.nil?
+
+      @token = token
+      @api_key = api_key
+    end
+
+    def self.from_env
+      token = ENV['API_KEY_TOKEN']
+      api_key = ENV['API_KEY_API_KEY']
+      all_nil = [
+        token,
+        api_key
+      ].all?(&:nil?)
+      return nil if all_nil
+
+      new(token: token, api_key: api_key)
+    end
+
+    def clone_with(token: nil, api_key: nil)
+      token ||= self.token
+      api_key ||= self.api_key
+
+      ApiKeyCredentials.new(token: token, api_key: api_key)
+    end
+  end
+end

data/lib/multi_auth_sample/http/auth/basic_auth.rb

@@ -0,0 +1,62 @@
+# multi_auth_sample
+#
+# This file was automatically generated by APIMATIC v3.0
+# ( https://www.apimatic.io ).
+
+module MultiAuthSample
+  # Utility class for basic authorization.
+  class BasicAuth < CoreLibrary::HeaderAuth
+    include CoreLibrary
+    # Display error message on occurrence of authentication failure.
+    # @returns [String] The oAuth error message.
+    def error_message
+      'BasicAuth: username or password is undefined.'
+    end
+
+    # Initialization constructor.
+    def initialize(basic_auth_credentials)
+      auth_params = {}
+      unless basic_auth_credentials.nil? ||
+             basic_auth_credentials.username.nil? ||
+             basic_auth_credentials.password.nil?
+        auth_params['Authorization'] =
+          "Basic #{AuthHelper.get_base64_encoded_value(basic_auth_credentials.username,
+                                                       basic_auth_credentials.password)}"
+      end
+
+      super auth_params
+    end
+  end
+
+  # Data class for BasicAuthCredentials.
+  class BasicAuthCredentials
+    attr_reader :username, :password
+
+    def initialize(username:, password:)
+      raise ArgumentError, 'username cannot be nil' if username.nil?
+      raise ArgumentError, 'password cannot be nil' if password.nil?
+
+      @username = username
+      @password = password
+    end
+
+    def self.from_env
+      username = ENV['BASIC_AUTH_USERNAME']
+      password = ENV['BASIC_AUTH_PASSWORD']
+      all_nil = [
+        username,
+        password
+      ].all?(&:nil?)
+      return nil if all_nil
+
+      new(username: username, password: password)
+    end
+
+    def clone_with(username: nil, password: nil)
+      username ||= self.username
+      password ||= self.password
+
+      BasicAuthCredentials.new(username: username, password: password)
+    end
+  end
+end