Elasticsearch query formatter and highlighter. Pretty print for Elasticsearch queries
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
bin
dist
docs
src
.eslintrc.json
.gitignore
.npmignore
LICENSE
README.md
package.json
test-queries.txt
yarn.lock

README.md

prettier-elastic-query

npm version

prettier-elastic-query is a library for formatting and highlighting Elasticsearch queries.

prettier-elastic-query uses Ohm parser to parse the query and Prism for highlighting it. See demo page for examples or try live editor with your own query.

Getting Started

Installation

If you are using Node.js, you can just install the prettier-elastic-query package using npm:

npm install prettier-elastic-query

This will install prettier-elastic-query in the local node_modules folder. Use require to access it from a Node script:

var prettier = require('prettier-elastic-query');

If you want to use prettier-elastic-query in a browser, you can download prettier-elastic-query.min.js and prettier-elastic-query.min.css and reference it in your HTML file.

<link href="resources/prettier-elastic-query.min.css" rel="stylesheet" type="text/css"/>
<script src="resources/prettier-elastic-query.min.js" type="text/javascript"></script>
<script>
    console.info(PrettierEs.prettify("query text", 80));
</script>

See demo page source for usage example.

API reference

prettify(query, maxWidth, style) - format and highlight ES query. Calls format() and highlight() functions inside;

prettifyElement(elementId, showErrors, maxWidth, errorCss) - formats and highlights ES query inplace inside HTML element. showErrors - boolean indicating if error information should be rendered, false by default. errorCss class to be used in error message formatting;

format(query, maxWidth, style) - format ES query, fitting it in maxWidth characters per line and following provided style. Possible style options are lisp and simple, with lisp being used if no style argument provided;

highlight(query) - highlight query with Prism. prettier-elastic-query build provides default Prism css theme. You can use any Prism theme, just include theme's css style file in your html file;

parse(query) - parse query and return syntax tree. This function throws an error if parsing fails. Used by format() function;

extendHighlighter(options) - takes options dictionary and extends Prism highlighter. At the moment only keywords key in options is supported and is used to extend keyword Prism language configuration;

markErrorInQuery(query, error, cssClass) - inserts <u> element around offending character in the query. error here is an instance of the error thrown by format function.

prism - Prism object;

grammar - Ohm grammar.