Merge branch 'master' into function-names

nene · nene · commit 0fe33a25530e · 2022-07-14T12:13:54.000+03:00
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "sql-formatter",
-  "version": "8.1.0",
+  "version": "8.2.0",
   "description": "Format whitespace in a SQL query to make it more readable",
   "license": "MIT",
   "main": "lib/index.js",
diff --git a/sql/alter-table.md b/sql/alter-table.md
diff --git a/sql/syntax.md b/sql/syntax.md
@@ -27,3 +27,4 @@ Reference of SQL syntax variations.
 - [DELETE](./delete.md)
 - [CREATE TABLE](./create-table.md)
 - [CREATE VIEW](./create-view.md)
+- [ALTER TABLE](./alter-table.md)
diff --git a/src/languages/bigquery.formatter.ts b/src/languages/bigquery.formatter.ts
@@ -699,6 +699,7 @@ const reservedCommands = [
   'ORDER BY',
   'QUALIFY',
   'WINDOW',
+  'PARTITION BY',
   'LIMIT',
   'OFFSET',
   'WITH',
diff --git a/src/languages/hive.formatter.ts b/src/languages/hive.formatter.ts
@@ -577,6 +577,8 @@ const reservedCommands = [
   'VALUES',
   'WHERE',
   'WITH',
+  'WINDOW',
+  'PARTITION BY',
 
   // newline keywords
   'STORED AS',
diff --git a/src/languages/mysql.formatter.ts b/src/languages/mysql.formatter.ts
@@ -1306,6 +1306,8 @@ const reservedCommands = [
   'OFFSET',
   'ORDER BY',
   'WHERE',
+  'WINDOW',
+  'PARTITION BY',
 ];
 
 const reservedBinaryCommands = [
diff --git a/src/languages/n1ql.formatter.ts b/src/languages/n1ql.formatter.ts
@@ -476,6 +476,8 @@ const reservedCommands = [
   'VALUES',
   'WHERE',
   'WITH',
+  'WINDOW',
+  'PARTITION BY',
 ];
 
 const reservedBinaryCommands = [
diff --git a/src/languages/postgresql.formatter.ts b/src/languages/postgresql.formatter.ts
@@ -1598,6 +1598,8 @@ const reservedCommands = [
   'ORDER BY',
   'WHERE',
   'WITH',
+  'WINDOW',
+  'PARTITION BY',
 ];
 
 const reservedBinaryCommands = [
diff --git a/src/languages/spark.formatter.ts b/src/languages/spark.formatter.ts
@@ -677,7 +677,6 @@ const reservedCommands = [
   'WITH',
   'CLUSTER BY',
   'DISTRIBUTE BY',
-  'PARTITION BY', // verify
   'GROUP BY',
   'HAVING',
   'VALUES',
@@ -723,7 +722,7 @@ const reservedCommands = [
   'INSERT',
   'LATERAL VIEW',
   'UPDATE',
-  'WINDOW', // verify
+  'WINDOW',
 ];
 
 const reservedBinaryCommands = [
diff --git a/src/languages/sql.formatter.ts b/src/languages/sql.formatter.ts
@@ -385,6 +385,8 @@ const reservedCommands = [
   'VALUES',
   'WHERE',
   'WITH',
+  'WINDOW',
+  'PARTITION BY',
 ];
 
 const reservedBinaryCommands = [
diff --git a/src/languages/sqlite.formatter.ts b/src/languages/sqlite.formatter.ts
@@ -322,6 +322,8 @@ const reservedCommands = [
   'VALUES',
   'WHERE',
   'WITH',
+  'WINDOW',
+  'PARTITION BY',
 ];
 
 const reservedBinaryCommands = [
diff --git a/src/languages/tsql.formatter.ts b/src/languages/tsql.formatter.ts
@@ -1208,6 +1208,8 @@ const reservedCommands = [
   'VALUES',
   'WHERE',
   'WITH',
+  'WINDOW',
+  'PARTITION BY',
 ];
 
 const reservedBinaryCommands = [
diff --git a/test/bigquery.test.ts b/test/bigquery.test.ts
@@ -15,6 +15,7 @@ import supportsDeleteFrom from './features/deleteFrom';
 import supportsComments from './features/comments';
 import supportsIdentifiers from './features/identifiers';
 import supportsParams from './options/param';
+import supportsWindow from './features/window';
 
 describe('BigQueryFormatter', () => {
   const language = 'bigquery';
@@ -32,6 +33,7 @@ describe('BigQueryFormatter', () => {
   supportsJoin(format, { without: ['NATURAL JOIN'] });
   supportsOperators(format, BigQueryFormatter.operators);
   supportsParams(format, { positional: true, named: ['@'], quoted: ['@``'] });
+  supportsWindow(format);
 
   // Note: BigQuery supports single dashes inside identifiers, so my-ident would be
   // detected as identifier, while other SQL dialects would detect it as
diff --git a/test/features/window.ts b/test/features/window.ts
@@ -0,0 +1,47 @@
+import dedent from 'dedent-js';
+
+import { FormatFn } from 'src/sqlFormatter';
+
+export default function supportsWindow(format: FormatFn) {
+  it('formats WINDOW clause at top level', () => {
+    const result = format(
+      'SELECT *, LAG(value) OVER wnd AS next_value FROM tbl WINDOW wnd AS (PARTITION BY id ORDER BY time);'
+    );
+    expect(result).toBe(dedent`
+      SELECT
+        *,
+        LAG(value) OVER wnd AS next_value
+      FROM
+        tbl
+      WINDOW
+        wnd AS (
+          PARTITION BY
+            id
+          ORDER BY
+            time
+        );
+    `);
+  });
+
+  it('formats multiple WINDOW specifications', () => {
+    const result = format(
+      'SELECT * FROM table1 WINDOW w1 AS (PARTITION BY col1), w2 AS (PARTITION BY col1, col2);'
+    );
+    expect(result).toBe(dedent`
+      SELECT
+        *
+      FROM
+        table1
+      WINDOW
+        w1 AS (
+          PARTITION BY
+            col1
+        ),
+        w2 AS (
+          PARTITION BY
+            col1,
+            col2
+        );
+    `);
+  });
+}
diff --git a/test/hive.test.ts b/test/hive.test.ts
@@ -15,6 +15,7 @@ import supportsOperators from './features/operators';
 import supportsArrayAndMapAccessors from './features/arrayAndMapAccessors';
 import supportsComments from './features/comments';
 import supportsIdentifiers from './features/identifiers';
+import supportsWindow from './features/window';
 
 describe('HiveFormatter', () => {
   const language = 'hive';
@@ -31,6 +32,7 @@ describe('HiveFormatter', () => {
   supportsJoin(format, { without: ['NATURAL JOIN'] });
   supportsOperators(format, HiveFormatter.operators);
   supportsArrayAndMapAccessors(format);
+  supportsWindow(format);
 
   it('throws error when params option used', () => {
     expect(() => format('SELECT *', { params: ['1', '2', '3'] })).toThrow(
diff --git a/test/mysql.test.ts b/test/mysql.test.ts
@@ -5,6 +5,7 @@ import MySqlFormatter from 'src/languages/mysql.formatter';
 import behavesLikeMariaDbFormatter from './behavesLikeMariaDbFormatter';
 
 import supportsOperators from './features/operators';
+import supportsWindow from './features/window';
 
 describe('MySqlFormatter', () => {
   const language = 'mysql';
@@ -13,6 +14,7 @@ describe('MySqlFormatter', () => {
   behavesLikeMariaDbFormatter(format);
 
   supportsOperators(format, MySqlFormatter.operators, ['AND', 'OR', 'XOR']);
+  supportsWindow(format);
 
   // TODO: disabled for now
   it.skip('supports @@ system variables', () => {
diff --git a/test/n1ql.test.ts b/test/n1ql.test.ts
@@ -16,6 +16,7 @@ import supportsArrayLiterals from './features/arrayLiterals';
 import supportsComments from './features/comments';
 import supportsIdentifiers from './features/identifiers';
 import supportsParams from './options/param';
+import supportsWindow from './features/window';
 
 describe('N1qlFormatter', () => {
   const language = 'n1ql';
@@ -34,6 +35,7 @@ describe('N1qlFormatter', () => {
   supportsJoin(format, { without: ['FULL', 'CROSS', 'NATURAL'] });
   supportsReturning(format);
   supportsParams(format, { positional: true, numbered: ['$'], named: ['$'] });
+  supportsWindow(format);
 
   it('formats INSERT with {} object literal', () => {
     const result = format(
diff --git a/test/postgresql.test.ts b/test/postgresql.test.ts
@@ -18,6 +18,7 @@ import supportsComments from './features/comments';
 import supportsIdentifiers from './features/identifiers';
 import supportsParams from './options/param';
 import supportsArrayAndMapAccessors from './features/arrayAndMapAccessors';
+import supportsWindow from './features/window';
 
 describe('PostgreSqlFormatter', () => {
   const language = 'postgresql';
@@ -41,6 +42,7 @@ describe('PostgreSqlFormatter', () => {
   supportsJoin(format);
   supportsReturning(format);
   supportsParams(format, { numbered: ['$'] });
+  supportsWindow(format);
 
   it('allows $ character as part of identifiers', () => {
     expect(format('SELECT foo$, some$$ident')).toBe(dedent`
diff --git a/test/spark.test.ts b/test/spark.test.ts
@@ -50,23 +50,19 @@ describe('SparkFormatter', () => {
     ],
   });
 
-  it('formats WINDOW specification as top level', () => {
-    const result = format(
-      'SELECT *, LAG(value) OVER wnd AS next_value FROM tbl WINDOW wnd as (PARTITION BY id ORDER BY time);'
-    );
+  it('formats basic WINDOW clause', () => {
+    const result = format(`SELECT * FROM tbl WINDOW win1, WINDOW win2, WINDOW win3;`);
     expect(result).toBe(dedent`
       SELECT
-        *,
-        LAG(value) OVER wnd AS next_value
+        *
       FROM
         tbl
       WINDOW
-        wnd as (
-          PARTITION BY
-            id
-          ORDER BY
-            time
-        );
+        win1,
+      WINDOW
+        win2,
+      WINDOW
+        win3;
     `);
   });
 
diff --git a/test/sql.test.ts b/test/sql.test.ts
@@ -16,6 +16,7 @@ import supportsDeleteFrom from './features/deleteFrom';
 import supportsComments from './features/comments';
 import supportsIdentifiers from './features/identifiers';
 import supportsParams from './options/param';
+import supportsWindow from './features/window';
 
 describe('SqlFormatter', () => {
   const language = 'sql';
@@ -34,6 +35,7 @@ describe('SqlFormatter', () => {
   supportsJoin(format);
   supportsOperators(format, SqlFormatter.operators);
   supportsParams(format, { positional: true });
+  supportsWindow(format);
 
   it('formats FETCH FIRST like LIMIT', () => {
     const result = format('SELECT * FETCH FIRST 2 ROWS ONLY;');
diff --git a/test/sqlite.test.ts b/test/sqlite.test.ts
@@ -16,6 +16,7 @@ import supportsDeleteFrom from './features/deleteFrom';
 import supportsComments from './features/comments';
 import supportsIdentifiers from './features/identifiers';
 import supportsParams from './options/param';
+import supportsWindow from './features/window';
 
 describe('SqliteFormatter', () => {
   const language = 'sqlite';
@@ -37,6 +38,7 @@ describe('SqliteFormatter', () => {
   });
   supportsOperators(format, SqliteFormatter.operators);
   supportsParams(format, { positional: true, numbered: ['?'], named: [':', '$', '@'] });
+  supportsWindow(format);
 
   it('formats FETCH FIRST like LIMIT', () => {
     const result = format('SELECT * FETCH FIRST 2 ROWS ONLY;');
diff --git a/test/tsql.test.ts b/test/tsql.test.ts
@@ -16,6 +16,7 @@ import supportsDeleteFrom from './features/deleteFrom';
 import supportsComments from './features/comments';
 import supportsIdentifiers from './features/identifiers';
 import supportsParams from './options/param';
+import supportsWindow from './features/window';
 
 describe('TSqlFormatter', () => {
   const language = 'tsql';
@@ -37,6 +38,7 @@ describe('TSqlFormatter', () => {
   );
   supportsJoin(format, { without: ['NATURAL'] });
   supportsParams(format, { named: ['@'], quoted: ['@""', '@[]'] });
+  supportsWindow(format);
 
   // TODO: The following are duplicated from StandardSQLFormatter test
 

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "sql-formatter",`
`3`		`- "version": "8.1.0",`
	`3`	`+ "version": "8.2.0",`
`4`	`4`	`"description": "Format whitespace in a SQL query to make it more readable",`
`5`	`5`	`"license": "MIT",`
`6`	`6`	`"main": "lib/index.js",`