The Gremlin Style Guide

Use soft tabs (spaces) for indentation

This ensures that your code looks the same for anyone, regardless of their text editor settings.

// Bad
g.V().label().
      groupCount() // Indented using hard tabs

// Good
g.V().label().
∙∙∙∙∙∙groupCount() // indented using spaces

Vertically align unnested methods after initial node selection

// Bad
g.V().hasLabel('movie').values('year').min()

// Bad
g.V().
  hasLabel('movie').
  values('year').
  min()

// Good
g.V().hasLabel('movie').
      values('year').
      min()

Add linebreak after punctuation

While adding the linebreak before the punctuation looks good in most cases, it introduces alignment problems when not all lines start with a punctuation. You never know if the next line should be indented relative to the punctuation of the previous line or the method of the previous line. Adding the punctuation before the linebreak also means that you can know if you have reached the end of the query without reading the next line.

// Bad
g.V().by(
       inE('category')
       .count())

// Bad
g.V().by(
       inE('category')
      .count())

// Bad
g.V().by(
        inE('category')
        .count())

// Bad
g.V().by(
        inE('category')
       .count())

// Good
g.V().by(
        inE('category').
        count())

Add linebreak and indentation of two spaces for nested methods

// Bad
g.V().hasLabel('movie').
      as('a','b').
      where(inE('rated').count().is(10))

// Bad
g.V().hasLabel('movie').
      as('a','b').
      where(
      inE('rated').
      count().
      is(10))

// Good
g.V().hasLabel('movie').
      as('a','b').
      where(
        inE('rated').
        count().
        is(10))

Place all trailing parentheses on a single line instead of distinct lines

// Bad
g.V().hasLabel('movie').
      by(
        inE('rated').
        values('stars').
        mean()
      ).
      order().
      limit(10)

// Good
g.V().hasLabel('movie').
      by(
        inE('rated').
        values('stars').
        mean()).
      order().
      limit(10)

Use // for single line comments. Place single line comments on a newline above the subject of the comment.

// Bad
g.V().hasLabel('movie').
      values('year'). // Find the year in which the oldest movie was produced
      min()

// Good
g.V().hasLabel('movie').
      // Find the year in which the oldest movie was produced
      values('year').
      min()