How to use rabl with swagger?

[arparthasarathi]

How to use rabl with swagger?

[EpiphanyMachine]

Its possible, but it wasn't really simple:

We use a custom rake tasks that builds response examples using rabl + factory bot

We use factory girl to seed data based on a custom "for_docs" trait. Then loop through our rabl files and generate a response json from rabl for each of our views and save them as files. Those files are referenced by name in our api definitions swagger yaml file. Finally we combine all separate/referenced files into one and use that as our swagger file.

Here are some code snippets. We do this over a several different files so its not an easy copy paste of the full code.

      Rabl.render(
        object,
        @public_api_document.template_short_path,
        view_path: HintApi::Application.root.join('app', 'views'),
        format: :hash,
      )

built = JSONRef.new('index.yaml', input_format: :yaml, base_path: File.join(Rails.root, 'public', 'swagger')).expand
...
file.write(JSON.pretty_generate(built))

[Amerr]

@EpiphanyMachine is it possible to give a detailed explanation or separate repo illustrating this implementation .