A TOML parser that produces output compatible with ESLint
MIT License
A TOML parser that produces output compatible with ESLint.
npm install --save-dev toml-eslint-parser
Use .eslintrc.*
file to configure parser. See also: https://eslint.org/docs/user-guide/configuring.
Example .eslintrc.js:
module.exports = {
overrides: [
{
files: ["*.toml"],
parser: "toml-eslint-parser",
},
],
};
The following additional configuration options are available by specifying them in parserOptions in your ESLint configuration file.
Example .eslintrc.js:
module.exports = {
overrides: [
{
files: ["*.toml"],
parser: "toml-eslint-parser",
// Additional configuration options
parserOptions: {
tomlVersion: "1.0.0",
},
},
],
};
parserOptions.tomlVersion
Select the TOML version by setting "1.0.0"
, "1.1.0"
, "1.0"
, "1.1"
, "latest"
, or "next"
. By default "1.0.0"
is used.
"1.0.0"
... Parsed using TOML v1.0.0 specifications."1.0"
... Alias for "1.0.0"
."1.1.0"
... Parsed using the TOML v1.1.0 specification, which is currently under development. TOML 1.1.0 has not been released yet, so "1.1.0"
is still an experimental feature. Please note that this may be subject to breaking changes in minor version releases of this parser."1.1"
... Alias for "1.1.0"
."latest"
... Currently an alias for "1.0.0"
. When a new version of TOML is released, we plan to change to that version in a minor version release of this parser."next"
... Currently an alias for "1.1.0"
.Example:
import type { AST } from "toml-eslint-parser";
import { parseTOML, getStaticTOMLValue } from "toml-eslint-parser";
const code = `
# This is a TOML document
title = "TOML Example"
[owner]
name = "Tom Preston-Werner"
dob = 1979-05-27T07:32:00-08:00
[database]
enabled = true
ports = [ 8001, 8001, 8002 ]
data = [ ["delta", "phi"], [3.14] ]
temp_targets = { cpu = 79.5, case = 72.0 }
[servers]
[servers.alpha]
ip = "10.0.0.1"
role = "frontend"
[servers.beta]
ip = "10.0.0.2"
role = "backend"
`;
const ast: AST.TOMLProgram = parseTOML(code);
console.log(ast);
// {
// type: 'Program',
// body: [
// {
// type: 'TOMLTopLevelTable',
// body: [
// {
// type: 'TOMLKeyValue',
// key: { /* ... */ },
// value: { /* ... */ },
// /* ... */
// },
// {
// type: 'TOMLTable',
// kind: 'standard',
// key: { /* ... */ },
// body: [ /* ... */ ],
// /* ... */
// },
// /* ... */
// ]
// /* ... */
// }
// ],
// tokens: [ /* ... */ ],
// comments: [
// {
// type: 'Block',
// value: ' This is a TOML document',
// // ...
// }
// ],
// }
const value = getStaticTOMLValue(ast);
console.log(value);
// {
// title: 'TOML Example',
// owner: { name: 'Tom Preston-Werner', dob: 1979-05-27T15:32:00.000Z },
// database: {
// enabled: true,
// ports: [ 8001, 8001, 8002 ],
// data: [ [ /* ... */ ], [ /* ... */ ] ],
// temp_targets: { cpu: 79.5, case: 72 }
// },
// servers: {
// alpha: { ip: '10.0.0.1', role: 'frontend' },
// beta: { ip: '10.0.0.2', role: 'backend' }
// }
// }
This project uses files from BurntSushi/toml-test and iarna/toml-spec-tests repositories for testing.