utils

Utils

The Generator

This directory hosts The Generator, a tool that generates the classes for each API endpoint from the Elasticsearch REST API JSON Specification.

Generate

To generate the code, you need to have the Elasticsearch REST API spec files in tmp/rest-api-spec in the root of the project. You can run a rake task from the root of the project to download the specs corresponding to the current running cluster:

$ rake elasticsearch:download_artifacts

Once the JSON files have been downloaded, you need to run (from this folder):

$ thor code:generate

• The Ruby code will be generated in elasticsearch-api/lib/elasticsearch/api/actions.
• The generator runs Rubocop to autolint and clean up the generated files.

Development

The main entry point is generate_source.rb, which contains a class that implements a Thor task: generate:

$ thor api:code:generate

It uses Thor::Actions' template method and templates/method.erb to generate the final code. The generator directory contains some helpers used to generate the code. The ERB template is split into partials and you can find all ERB files in the templates directory.

There's also a lister task:

$ thor api:list

It's implemented in lister.rb and it lists all the REST API endpoints from the JSON specification.