gitlab-org--gitlab-foss/lib/gitlab/graphql/docs/helper.rb

# frozen_string_literal: true

return if Rails.env.production?

module Gitlab
  module Graphql
    module Docs
      # Helper with functions to be used by HAML templates
      # This includes graphql-docs gem helpers class.
      # You can check the included module on: https://github.com/gjtorikian/graphql-docs/blob/v1.6.0/lib/graphql-docs/helpers.rb
      module Helper
        include GraphQLDocs::Helpers

        def auto_generated_comment
          <<-MD.strip_heredoc
            <!---
              This documentation is auto generated by a script.

              Please do not edit this file directly, check compile_docs task on lib/tasks/gitlab/graphql.rake.
            --->
          MD
        end

        def sorted_fields(fields)
          fields.sort_by { |field| field[:name] }
        end

        def render_field(field)
          '| %s | %s | %s |' % [
            render_field_name(field),
            render_field_type(field[:type][:info]),
            render_field_description(field)
            ]
        end

        def render_field_name(field)
          rendered_name = "`#{field[:name]}`"
          rendered_name += ' **{warning-solid}**' if field[:is_deprecated]
          rendered_name
        end

        # Returns the field description. If the field has been deprecated,
        # the deprecation reason will be returned in place of the description.
        def render_field_description(field)
          return field[:description] unless field[:is_deprecated]

          "**Deprecated:** #{field[:deprecation_reason]}"
        end

        # Some fields types are arrays of other types and are displayed
        # on docs wrapped in square brackets, for example: [String!].
        # This makes GitLab docs renderer thinks they are links so here
        # we change them to be rendered as: String! => Array.
        def render_field_type(type)
          array_type = type[/\[(.+)\]/, 1]

          if array_type
            "#{array_type} => Array"
          else
            type
          end
        end

        # We are ignoring connections and built in types for now,
        # they should be added when queries are generated.
        def objects
          graphql_object_types.select do |object_type|
            !object_type[:name]["Connection"] &&
              !object_type[:name]["Edge"] &&
              !object_type[:name]["__"]
          end
        end
      end
    end
  end
end