JMESPath Formatter (VS Code)

March 23, 2026 ยท View on GitHub

This extension adds a deterministic formatter for JMESPath expressions in VS Code.

Features

  • Registers a jmespath language with default .jmespath file association.
  • Adds a document formatter for JMESPath.
  • Adds command JMESPath: Format Document (jmespathFormatter.formatDocument).
  • Supports core JMESPath syntax plus parser-supported community extensions.
  • Supports Liongard "RoarPath" compatibility mode (including ~ root and legacy backtick literal parsing). See Liongard RoarPath commands documentation.

Settings

  • jmespathFormatter.maxLineLength (number, default: 100)
  • jmespathFormatter.dialect (auto | standard | roarpath, default: auto)

Quality Gates

npm run verify

This runs compile + tests and is the minimum gate before every commit/PR.

Development

npm install
npm run verify

Build a local VSIX:

npm run package:vsix

The VSIX is written to dist/vscode-jmespath-formatter.vsix.

Documentation