prettier-plugin-groq weekly downloads statistics

Prettier GROQ

This formatter follows the Prettier philosophy of being opinionated and provide few options. The input code is formatted directly from the AST, thereby not preserving whitespace and ignoring comments (see _currently unsupported_ below).

Overview

Groups

Much of the formatting work revolves around grouping object properties in different ways:

1. All properties are placed on separate lines except for properties using the shorthand syntax (_see options below_). 2. All properties of the same value type are grouped and separated from the next group by an empty line. 3. All properties that include projections or object-like values are separated by an empty line.

Line length

The formatter respects the printWidth setting and wraps your code accordingly.

Object expansion

The expansion operator is printed inline if the projection has exactly 2 properties. This is useful for simple exceptions.

Select

The select function arguments are always printed on separate lines:

Order

The order component is rarely used with many arguments and is therefore always printed inline.

This is also done to prevent wrapping the order scope before wrapping the filter component in long queries:

_Bad:_

_Better:_

Installation

Install as a development dependency

Integration

When installed locally, the plugin should automatically be picked up by your editor if it supports Prettier (VS Code, Sublime Text 3). When installed globally, the plugin is picked up by the prettier CLI:

Options

• groqInlineShorthandProperties _(default: true)_

Controls whether object properties using the shorthand syntax will be grouped inline:

or not:

Currently unsupported

• Inline comments //like this as they're currently ignored by the parser • Map components * | ([ like, this ]) as they're currently not supported by the parser

Description from the npm listing.