jzimmek / sql-formatter

A whitespace formatter for different query languages

Home Page:https://zeroturnaround.github.io/sql-formatter/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SQL Formatter NPM version Build Status Coverage Status

SQL Formatter is a JavaScript library for pretty-printing SQL queries. It started as a port of a PHP Library, but has since considerably diverged. It supports Standard SQL and Couchbase N1QL dialects.

Try the demo.

Install

Get the latest version from NPM:

npm install --save sql-formatter

Usage

import sqlFormatter from "sql-formatter";

console.log(sqlFormatter.format("SELECT * FROM table1"));

This will output:

SELECT
  *
FROM
  table1

You can also pass in configuration options:

sqlFormatter.format("SELECT *", {
    language: "n1ql" // Defaults to "sql"
    indent: "    "   // Defaults to two spaces
});

Currently just two SQL dialects are supported:

Placeholders replacement

// Named placeholders
sqlFormatter.format("SELECT * FROM tbl WHERE foo = @foo", {
    params: {foo: "'bar'"}
}));

// Indexed placeholders
sqlFormatter.format("SELECT * FROM tbl WHERE foo = ?", {
    params: ["'bar'"]
}));

Both result in:

SELECT
  *
FROM
  tbl
WHERE
  foo = 'bar'

Usage without NPM

If you don't use a module bundler, clone the repository, run npm install and grab a file from /dist directory to use inside a <script> tag. This makes SQL Formatter available as a global variable window.sqlFormatter.

Contributing

# run linter and tests
$ npm run check

...and you're ready to poke us with a pull request.

License

MIT

About

A whitespace formatter for different query languages

https://zeroturnaround.github.io/sql-formatter/

License:MIT License


Languages

Language:JavaScript 93.3%Language:HTML 6.7%