=begin
{% include "api_info.j2" %}
=end

require 'cgi'

module {{ module_name }}::{{ version|upper }}
{%- set classname = name.replace(" ", "") + "API" %}
  class {{ classname }}
    attr_accessor :api_client

    def initialize(api_client = {{ module_name }}::APIClient.default)
      @api_client = api_client
    end

{%- for path, method, operation in operations|sort(attribute="2.operationId") %}
    {%- set httpMethod = method.upper() %}
    {%- set returnType = operation|return_type %}

    {{ operation.summary|block_comment|indent(4) }}.
    #
    # @see #{{ operation.operationId|snake_case }}_with_http_info
    def {{ operation.operationId|snake_case }}({% for name, parameter in operation|parameters if parameter.required %}{{ name|attribute_name }}, {% endfor %}opts = {})
      {% if returnType %}data, _status_code, _headers = {% endif %}{{ operation.operationId|snake_case }}_with_http_info({% for name, parameter in operation|parameters if parameter.required %}{{ name|attribute_name }}, {% endfor %}opts)
      {% if returnType %}data{% else %}nil{% endif %}
    end

    {{ operation.summary|block_comment|indent(4) }}.
    {%- if operation.description %}
    #
    {{ operation.description|block_comment|indent(4) }}
    #
    {%- endif %}
    {%- if operation.deprecated %}
    # @deprecated This API is deprecated.
    #
    {%- endif %}
    {%- for name, parameter in operation|parameters if parameter.required %}
    # @param {{ name|attribute_name }} [{{ get_type_for_parameter(parameter) }}] {{ parameter.get("description", "").replace('\n', ' ') }}
    {%- endfor %}
    # @param opts [Hash] the optional parameters
    {%- for name, parameter in operation|parameters if not parameter.required %}
    # @option opts [{{ get_type_for_parameter(parameter) }}] :{{ name|attribute_name }} {{ parameter.get("description", "").replace('\n', ' ') }}{% if "default" in parameter%} (default to {{ parameter.default|json }}) {% endif %}
    {%- endfor %}
    # @return [Array<({% if returnType %}{{ returnType }}{% else %}nil{% endif %}, Integer, Hash)>] {% if returnType %}{{ returnType }} data{% else %}nil{% endif %}, response status code and response headers
    def {{ operation.operationId|snake_case }}_with_http_info({% for name, parameter in operation|parameters if parameter.required %}{{ name|attribute_name }}, {% endfor %}opts = {})
      {%- if operation.deprecated %}
      warn "[DEPRECATION] `{{ operation.operationId }}` is deprecated."
      {%- endif %}
      {%- if "x-unstable" in operation %}
      unstable_enabled = @api_client.config.unstable_operations["{{ version }}.{{ operation.operationId|snake_case }}".to_sym]
      if unstable_enabled
        @api_client.config.logger.warn format("Using unstable operation '%s'", "{{ version }}.{{ operation.operationId|snake_case }}")
      else
        raise {{ module_name }}::APIError.new(message: format("Unstable operation '%s' is disabled", "{{ version }}.{{ operation.operationId|snake_case }}"))
      end
      {%- endif %}

      if @api_client.config.debugging
        @api_client.config.logger.debug 'Calling API: {{classname}}.{{ operation.operationId|snake_case }} ...'
      end

{%- for name, parameter in operation|parameters %}
  {%- set schema = parameter|parameter_schema %}
  {%- if parameter.required %}
    {%- if not parameter.nullable %}
      # verify the required parameter '{{ name|attribute_name }}' is set
      if @api_client.config.client_side_validation && {{ name|attribute_name }}.nil?
        fail ArgumentError, "Missing the required parameter '{{ name|attribute_name }}' when calling {{classname}}.{{ operation.operationId|snake_case }}"
      end
      {%- if schema.enum is defined and not parameter|collection_format %}
      # verify enum value
      allowable_values = [{% for value in schema.enum %}{{ value|format_value }}{%- if not loop.last %}, {% endif %}{% endfor %}]
      if @api_client.config.client_side_validation && !allowable_values.include?({{ name|attribute_name }})
        fail ArgumentError, "invalid value for \"{{ name|attribute_name }}\", must be one of #{allowable_values}"
      end
      {%- endif %}
    {%- endif %}
  {%- else %}
    {%- if schema.enum is defined %}
      allowable_values = [{% for value in schema.enum %}{{ value|format_value }}{%- if not loop.last %}, {% endif %}{% endfor %}]
      {%- if parameter|collection_format %}
      if @api_client.config.client_side_validation && opts[:'{{ name|attribute_name }}'] && !opts[:'{{ name|attribute_name }}'].all? { |item| allowable_values.include?(item) }
        fail ArgumentError, "invalid value for \"{{ name|attribute_name }}\", must include one of #{allowable_values}"
      end
      {%- else %}
      if @api_client.config.client_side_validation && opts[:'{{ name|attribute_name }}'] && !allowable_values.include?(opts[:'{{ name|attribute_name }}'])
        fail ArgumentError, "invalid value for \"{{ name|attribute_name }}\", must be one of #{allowable_values}"
      end
      {%- endif %}
    {%- endif %}

  {%- endif %}
  {%- if schema.maxLength is defined %}
      if @api_client.config.client_side_validation && {% if not parameter.required %}!opts[:'{{ name|attribute_name }}'].nil? && {% endif %}{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:'{{ name|attribute_name }}']{% endif %}.to_s.length > {{ schema.maxLength }}
        fail ArgumentError, 'invalid value for "{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:"{{ name|attribute_name }}"]{% endif %}" when calling {{classname}}.{{ operation.operationId|snake_case }}, the character length must be smaller than or equal to {{ schema.maxLength }}.'
      end

  {%- endif %}
  {%- if schema.minLength is defined %}
      if @api_client.config.client_side_validation && {% if not parameter.required %}!opts[:'{{ name|attribute_name }}'].nil? && {% endif %}{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:'{{ name|attribute_name }}']{% endif %}.to_s.length < {{ schema.minLength }}
        fail ArgumentError, 'invalid value for "{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:"{{ name|attribute_name }}"]{% endif %}" when calling {{classname}}.{{ operation.operationId|snake_case }}, the character length must be great than or equal to {{ schema.minLength }}.'
      end

  {%- endif %}
  {%- if schema.maximum is defined %}
      if @api_client.config.client_side_validation && {% if not parameter.required %}!opts[:'{{ name|attribute_name }}'].nil? && {% endif %}{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:'{{ name|attribute_name }}']{% endif %} >{% if parameter.exclusiveMaximum %}={% endif %} {{ schema.maximum }}
        fail ArgumentError, 'invalid value for "{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:"{{ name|attribute_name }}"]{% endif %}" when calling {{classname}}.{{ operation.operationId|snake_case }}, must be smaller than {% if not parameter.exclusiveMaximum %}or equal to {% endif %}{{ schema.maximum }}.'
      end

  {%- endif %}
  {%- if schema.minimum is defined %}
      if @api_client.config.client_side_validation && {% if not parameter.required %}!opts[:'{{ name|attribute_name }}'].nil? && {% endif %}{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:'{{ name|attribute_name }}']{% endif %} <{% if parameter.exclusiveMinimum %}={% endif %} {{ schema.minimum }}
        fail ArgumentError, 'invalid value for "{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:"{{ name|attribute_name }}"]{% endif %}" when calling {{classname}}.{{ operation.operationId|snake_case }}, must be greater than {% if not parameter.exclusiveMinimum %}or equal to {% endif %}{{ schema.minimum }}.'
      end

  {%- endif %}
  {%- if schema.pattern is defined %}
      pattern = Regexp.new("{{ schema.pattern }}")
      if @api_client.config.client_side_validation && {% if not parameter.required %}!opts[:'{{ name|attribute_name }}'].nil? && {% endif %}{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:'{{ name|attribute_name }}']{% endif %} !~ pattern
        fail ArgumentError, "invalid value for '{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:\"{{ name|attribute_name }}\"]{% endif %}' when calling {{classname}}.{{ operation.operationId|snake_case }}, must conform to the pattern #{pattern}."
      end

  {%- endif %}
  {%- if schema.maxItems is defined %}
      if @api_client.config.client_side_validation && {% if not parameter.required %}!opts[:'{{ name|attribute_name }}'].nil? && {% endif %}{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:'{{ name|attribute_name }}']{% endif %}.length > {{ schema.maxItems }}
        fail ArgumentError, 'invalid value for "{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:"{{ name|attribute_name }}"]{% endif %}" when calling {{classname}}.{{ operation.operationId|snake_case }}, number of items must be less than or equal to {{ schema.maxItems }}.'
      end

      {%- endif %}
  {%- if schema.minItems is defined %}
      if @api_client.config.client_side_validation && {% if not parameter.required %}!opts[:'{{ name|attribute_name }}'].nil? && {% endif %}{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:'{{ name|attribute_name }}']{% endif %}.length < {{ schema.minItems }}
        fail ArgumentError, 'invalid value for "{% if parameter.required %}{{ name|attribute_name }}{% else %}opts[:"{{ name|attribute_name }}"]{% endif %}" when calling {{classname}}.{{ operation.operationId|snake_case }}, number of items must be greater than or equal to {{ schema.minItems }}.'
      end

  {%- endif %}
{%- endfor %}
      # resource path
      local_var_path = '{{ path }}'{% for parameter in operation.parameters if parameter.in == "path" %}.sub('{{ '{' }}{{ parameter.name }}{{ '}'}}', CGI.escape({{ parameter.name }}.to_s).gsub('%2F', '/')){% endfor %}

      # query parameters
      query_params = opts[:query_params] || {}
      {%- for name, parameter in operation|parameters if parameter.in == "query" and parameter.required %}
      {%- set collection = parameter|collection_format %}
      query_params[:'{{ name }}'] = {% if collection %}@api_client.build_collection_param({{ name|attribute_name }}, :{{ collection }}){% else %}{{ name|attribute_name }}{% endif %}
      {%- endfor %}
      {%- for name, parameter in operation|parameters if parameter.in == "query" and not parameter.required %}
      {%- set collection = parameter|collection_format %}
      query_params[:'{{ name }}'] = {% if collection %}@api_client.build_collection_param(opts[:'{{ name|attribute_name }}'], :{{ collection }}){% else %}opts[:'{{ name|attribute_name }}']{% endif %} if !opts[:'{{ name|attribute_name }}'].nil?
      {%- endfor %}

      # header parameters
      header_params = opts[:header_params] || {}
      {%- if operation.responses %}
      # HTTP header 'Accept' (if needed)
      header_params['Accept'] = @api_client.select_header_accept([{% for mediaType in operation|accept_headers %}'{{ mediaType }}'{%- if not loop.last %}, {% endif %}{% endfor %}])
      {%- endif %}

      {%- if operation.requestBody %}
      # HTTP header 'Content-Type'
      header_params['Content-Type'] = @api_client.select_header_content_type([{% for mediaType in operation.requestBody.content.keys() %}'{{ mediaType }}'{%- if not loop.last %}, {% endif %}{% endfor %}])
      {%- endif %}

      {%- for name, parameter in operation|parameters if parameter.in == "header" and parameter.required %}
      {%- set collection = parameter|collection_format %}
      header_params['{{ name }}'] = {% if collection %}@api_client.build_collection_param({{ name|attribute_name }}, :{{ collection }}){% else %}{{ name|attribute_name }}{% endif %}
      {%- endfor %}
      {%- for name, parameter in operation|parameters if parameter.in == "header" and not parameter.required %}
      {%- set collection = parameter|collection_format %}
      header_params['{{ name }}'] = {% if collection %}@api_client.build_collection_param(opts[:'{{ name|attribute_name }}'], :{{ collection }}){% else %}opts[:'{{ name|attribute_name }}']{% endif %} if !opts[:'{{ name|attribute_name }}'].nil?
      {%- endfor %}

      # form parameters
      form_params = opts[:form_params] || {}
      {%- for name, parameter in operation|parameters if parameter.in == "form" and parameter.required %}
      {%- set collection = parameter|collection_format %}
      form_params['{{ name }}'] = {% if collection %}@api_client.build_collection_param({{ name|attribute_name }}, :{{ collection }}){% else %}{{ name|attribute_name }}{% endif %}
      {%- endfor %}
      {%- for name, parameter in operation|parameters if parameter.in == "form" and not parameter.required %}
      {%- set collection = parameter|collection_format %}
      form_params['{{ name }}'] = {% if collection %}@api_client.build_collection_param(opts[:'{{ name|attribute_name }}'], :{{ collection }}){% else %}opts[:'{{ name|attribute_name }}']{% endif %} if !opts[:'{{ name|attribute_name }}'].nil?
      {%- endfor %}

      # http body (model)
      post_body = opts[:debug_body]{% if operation.requestBody %} || @api_client.object_to_http_body(
        {%- if operation.requestBody.required -%}
        {{ operation.get("x-codegen-request-body-name", "body") }}
        {%- else -%}
        opts[:'{{ operation.get("x-codegen-request-body-name", "body") }}']
        {%- endif -%}
      ){% endif %}

      # return_type
      return_type = opts[:debug_return_type]{% if returnType %} || '{{ returnType }}'{% endif %}

      # auth_names
      {%- set authMethods = operation.security if "security" in operation else openapi.security %}
      auth_names = opts[:debug_auth_names] || [{% for auth in (authMethods or []) %}:{{ ", :".join(auth.keys()) }}{%- if not loop.last %}, {% endif %}{% endfor %}]

      new_options = opts.merge(
        :operation => :{{ operation.operationId|snake_case }},
        :header_params => header_params,
        :query_params => query_params,
        :form_params => form_params,
        :body => post_body,
        :auth_names => auth_names,
        :return_type => return_type,
        :api_version => "{{ version|upper }}"
      )

      data, status_code, headers = @api_client.call_api(Net::HTTP::{{ httpMethod|camel_case }}, local_var_path, new_options)
      if @api_client.config.debugging
        @api_client.config.logger.debug "API called: {{ classname }}#{{ operation.operationId|snake_case }}\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
      end
      return data, status_code, headers
    end
{%- if operation["x-pagination"] %}
{%- set pagination = operation["x-pagination"] %}

    {{ operation.summary|block_comment|indent(4) }}.
    #
    # Provide a paginated version of {{ '{' }}#{{ operation.operationId|snake_case }}{{ '}' }}, returning all items.
    #
    # To use it you need to use a block: {{ operation.operationId|snake_case }}_with_pagination { |item| p item }
    #
    # @yield [{{ get_type_at_path(operation, pagination.resultsPath) }}] Paginated items
    def {{ operation.operationId|snake_case }}_with_pagination({% for name, parameter in operation|parameters if parameter.required %}{{ name|attribute_name }}, {% endfor %}opts = {})
        api_version = "{{ version|upper }}"
        page_size = @api_client.get_attribute_from_path({{ get_container(operation, pagination.limitParam) }}, {{ get_default(operation, pagination.limitParam) }})
        @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.limitParam, True) }}, page_size)
        while true do
            response = {{ operation.operationId|snake_case }}({% for name, parameter in operation|parameters if parameter.required %}{{ name|attribute_name }}, {% endfor %}opts)
            @api_client.get_attribute_from_path(response, "{{ pagination.resultsPath|attribute_path }}").each { |item| yield(item) }
            if @api_client.get_attribute_from_path(response, "{{ pagination.resultsPath|attribute_path }}").length < page_size
              break
            end
            {%- if pagination.pageOffsetParam %}
            @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.pageOffsetParam, True) }}, @api_client.get_attribute_from_path({{ get_container(operation, pagination.pageOffsetParam) }}, 0) + page_size)
            {%- endif %}
            {%- if pagination.cursorParam %}
            @api_client.set_attribute_from_path(api_version, {{ get_container(operation, pagination.cursorParam, True) }}, @api_client.get_attribute_from_path(response, "{{ pagination.cursorPath }}"))
            {%- endif %}
        end
    end
{%- endif %}
{%- if not loop.last %}

{%- endif %}
{%- endfor %}
  end
end
{# keep new line at the end of file #}