Teach psql to show the location of syntax errors visually, per recent

discussions.  Patch by Fabien Coelho and Tom Lane.  Still needs to be
taught about multi-screen-column kanji characters; Tatsuo has promised
to provide the needed infrastructure for that.
This commit is contained in:
Tom Lane 2004-03-14 04:25:18 +00:00
parent 181d4d410a
commit 7665d1bc16
5 changed files with 503 additions and 12 deletions

View File

@ -3,7 +3,7 @@
*
* Copyright (c) 2000-2003, PostgreSQL Global Development Group
*
* $PostgreSQL: pgsql/src/bin/psql/common.c,v 1.82 2004/01/25 03:07:22 neilc Exp $
* $PostgreSQL: pgsql/src/bin/psql/common.c,v 1.83 2004/03/14 04:25:17 tgl Exp $
*/
#include "postgres_fe.h"
#include "common.h"
@ -345,6 +345,216 @@ ResetCancelConn(void)
}
/*
* on errors, print syntax error position if available.
*
* the query is expected to be in the client encoding.
*/
static void
ReportSyntaxErrorPosition(const PGresult *result, const char *query)
{
#define DISPLAY_SIZE 60 /* screen width limit, in screen cols */
#define MIN_RIGHT_CUT 10 /* try to keep this far away from EOL */
int loc = 0;
const char *sp;
int clen, slen, i, *qidx, *scridx, qoffset, scroffset, ibeg, iend,
loc_line;
char *wquery;
bool beg_trunc, end_trunc;
PQExpBufferData msg;
if (query == NULL)
return; /* nothing to do */
sp = PQresultErrorField(result, PG_DIAG_STATEMENT_POSITION);
if (sp == NULL)
return; /* no syntax error location */
/*
* We punt if the report contains any CONTEXT. This typically means that
* the syntax error is from inside a function, and the cursor position
* is not relevant to the original query string.
*/
if (PQresultErrorField(result, PG_DIAG_CONTEXT) != NULL)
return;
if (sscanf(sp, "%d", &loc) != 1)
{
psql_error("INTERNAL ERROR: unexpected statement position \"%s\"\n",
sp);
return;
}
/* Make a writable copy of the query, and a buffer for messages. */
wquery = pg_strdup(query);
initPQExpBuffer(&msg);
/*
* The returned cursor position is measured in logical characters.
* Each character might occupy multiple physical bytes in the string,
* and in some Far Eastern character sets it might take more than one
* screen column as well. We compute the starting byte offset and
* starting screen column of each logical character, and store these
* in qidx[] and scridx[] respectively.
*/
/* we need a safe allocation size... */
slen = strlen(query) + 1;
qidx = (int *) pg_malloc(slen * sizeof(int));
scridx = (int *) pg_malloc(slen * sizeof(int));
qoffset = 0;
scroffset = 0;
for (i = 0; query[qoffset] != '\0'; i++)
{
qidx[i] = qoffset;
scridx[i] = scroffset;
scroffset += 1; /* XXX fix me when we have screen width info */
qoffset += PQmblen(&query[qoffset], pset.encoding);
}
qidx[i] = qoffset;
scridx[i] = scroffset;
clen = i;
psql_assert(clen < slen);
/* convert loc to zero-based offset in qidx/scridx arrays */
loc--;
/* do we have something to show? */
if (loc >= 0 && loc <= clen)
{
/* input line number of our syntax error. */
loc_line = 1;
/* first included char of extract. */
ibeg = 0;
/* last-plus-1 included char of extract. */
iend = clen;
/*
* Replace tabs with spaces in the writable copy. (Later we might
* want to think about coping with their variable screen width,
* but not today.)
*
* Extract line number and begin and end indexes of line containing
* error location. There will not be any newlines or carriage
* returns in the selected extract.
*/
for (i=0; i<clen; i++)
{
/* character length must be 1 or it's not ASCII */
if ((qidx[i+1]-qidx[i]) == 1)
{
if (wquery[qidx[i]] == '\t')
wquery[qidx[i]] = ' ';
else if (wquery[qidx[i]] == '\r' || wquery[qidx[i]] == '\n')
{
if (i < loc)
{
/*
* count lines before loc. Each \r or \n counts
* as a line except when \r \n appear together.
*/
if (wquery[qidx[i]] == '\r' ||
i == 0 ||
(qidx[i]-qidx[i-1]) != 1 ||
wquery[qidx[i-1]] != '\r')
loc_line++;
/* extract beginning = last line start before loc. */
ibeg = i+1;
}
else
{
/* set extract end. */
iend = i;
/* done scanning. */
break;
}
}
}
}
/* If the line extracted is too long, we truncate it. */
beg_trunc = false;
end_trunc = false;
if (scridx[iend]-scridx[ibeg] > DISPLAY_SIZE)
{
/*
* We first truncate right if it is enough. This code might
* be off a space or so on enforcing MIN_RIGHT_CUT if there's
* a wide character right there, but that should be okay.
*/
if (scridx[ibeg]+DISPLAY_SIZE >= scridx[loc]+MIN_RIGHT_CUT)
{
while (scridx[iend]-scridx[ibeg] > DISPLAY_SIZE)
iend--;
end_trunc = true;
}
else
{
/* Truncate right if not too close to loc. */
while (scridx[loc]+MIN_RIGHT_CUT < scridx[iend])
{
iend--;
end_trunc = true;
}
/* Truncate left if still too long. */
while (scridx[iend]-scridx[ibeg] > DISPLAY_SIZE)
{
ibeg++;
beg_trunc = true;
}
}
}
/* the extract MUST contain the target position! */
psql_assert(ibeg<=loc && loc<=iend);
/* truncate working copy at desired endpoint */
wquery[qidx[iend]] = '\0';
/* Begin building the finished message. */
printfPQExpBuffer(&msg, gettext("LINE %d: "), loc_line);
if (beg_trunc)
appendPQExpBufferStr(&msg, "...");
/*
* While we have the prefix in the msg buffer, compute its screen
* width.
*/
scroffset = 0;
for (i = 0; i < msg.len; i += PQmblen(&msg.data[i], pset.encoding))
{
scroffset += 1; /* XXX fix me when we have screen width info */
}
/* Finish and emit the message. */
appendPQExpBufferStr(&msg, &wquery[qidx[ibeg]]);
if (end_trunc)
appendPQExpBufferStr(&msg, "...");
psql_error("%s\n", msg.data);
/* Now emit the cursor marker line. */
scroffset += scridx[loc] - scridx[ibeg];
resetPQExpBuffer(&msg);
for (i = 0; i < scroffset; i++)
appendPQExpBufferChar(&msg, ' ');
appendPQExpBufferChar(&msg, '^');
psql_error("%s\n", msg.data);
}
/* Clean up. */
termPQExpBuffer(&msg);
free(wquery);
free(qidx);
free(scridx);
}
/*
* AcceptResult
*
@ -355,7 +565,7 @@ ResetCancelConn(void)
* Returns true for valid result, false for error state.
*/
static bool
AcceptResult(const PGresult *result)
AcceptResult(const PGresult *result, const char *query)
{
bool OK = true;
@ -386,6 +596,7 @@ AcceptResult(const PGresult *result)
if (!OK)
{
psql_error("%s", PQerrorMessage(pset.db));
ReportSyntaxErrorPosition(result, query);
CheckConnection();
}
@ -449,7 +660,7 @@ PSQLexec(const char *query, bool start_xact)
res = PQexec(pset.db, query);
if (!AcceptResult(res) && res)
if (!AcceptResult(res, query) && res)
{
PQclear(res);
res = NULL;
@ -695,7 +906,7 @@ SendQuery(const char *query)
results = PQexec(pset.db, query);
/* these operations are included in the timing result: */
OK = (AcceptResult(results) && ProcessCopyResult(results));
OK = (AcceptResult(results, query) && ProcessCopyResult(results));
if (pset.timing)
GETTIMEOFDAY(&after);

View File

@ -23,12 +23,16 @@ select 1;
-- missing relation name
select;
ERROR: syntax error at or near ";" at character 7
LINE 1: select;
^
-- no such relation
select * from nonesuch;
ERROR: relation "nonesuch" does not exist
-- missing target list
select from pg_database;
ERROR: syntax error at or near "from" at character 8
LINE 1: select from pg_database;
^
-- bad name in target list
select nonesuch from pg_database;
ERROR: column "nonesuch" does not exist
@ -41,6 +45,8 @@ ERROR: column "nonesuch" does not exist
-- bad select distinct on syntax, distinct attribute missing
select distinct on (foobar) from pg_database;
ERROR: syntax error at or near "from" at character 29
LINE 1: select distinct on (foobar) from pg_database;
^
-- bad select distinct on syntax, distinct attribute not in target list
select distinct on (foobar) * from pg_database;
ERROR: column "foobar" does not exist
@ -50,6 +56,8 @@ ERROR: column "foobar" does not exist
-- missing relation name (this had better not wildcard!)
delete from;
ERROR: syntax error at or near ";" at character 12
LINE 1: delete from;
^
-- no such relation
delete from nonesuch;
ERROR: relation "nonesuch" does not exist
@ -59,6 +67,8 @@ ERROR: relation "nonesuch" does not exist
-- missing relation name (this had better not wildcard!)
drop table;
ERROR: syntax error at or near ";" at character 11
LINE 1: drop table;
^
-- no such relation
drop table nonesuch;
ERROR: table "nonesuch" does not exist
@ -69,6 +79,8 @@ ERROR: table "nonesuch" does not exist
-- missing relation name
alter table rename;
ERROR: syntax error at or near ";" at character 19
LINE 1: alter table rename;
^
-- no such relation
alter table nonesuch rename to newnonesuch;
ERROR: relation "nonesuch" does not exist
@ -123,9 +135,13 @@ ERROR: aggregate basetype must be specified
-- missing index name
drop index;
ERROR: syntax error at or near ";" at character 11
LINE 1: drop index;
^
-- bad index name
drop index 314159;
ERROR: syntax error at or near "314159" at character 12
LINE 1: drop index 314159;
^
-- no such index
drop index nonesuch;
ERROR: index "nonesuch" does not exist
@ -135,12 +151,18 @@ ERROR: index "nonesuch" does not exist
-- missing aggregate name
drop aggregate;
ERROR: syntax error at or near ";" at character 15
LINE 1: drop aggregate;
^
-- missing aggregate type
drop aggregate newcnt1;
ERROR: syntax error at or near ";" at character 23
LINE 1: drop aggregate newcnt1;
^
-- bad aggregate name
drop aggregate 314159 (int);
ERROR: syntax error at or near "314159" at character 16
LINE 1: drop aggregate 314159 (int);
^
-- bad aggregate type
drop aggregate newcnt (nonesuch);
ERROR: type "nonesuch" does not exist
@ -156,9 +178,13 @@ ERROR: aggregate newcnt(real) does not exist
-- missing function name
drop function ();
ERROR: syntax error at or near "(" at character 15
LINE 1: drop function ();
^
-- bad function name
drop function 314159();
ERROR: syntax error at or near "314159" at character 15
LINE 1: drop function 314159();
^
-- no such function
drop function nonesuch();
ERROR: function nonesuch() does not exist
@ -168,9 +194,13 @@ ERROR: function nonesuch() does not exist
-- missing type name
drop type;
ERROR: syntax error at or near ";" at character 10
LINE 1: drop type;
^
-- bad type name
drop type 314159;
ERROR: syntax error at or near "314159" at character 11
LINE 1: drop type 314159;
^
-- no such type
drop type nonesuch;
ERROR: type "nonesuch" does not exist
@ -180,21 +210,33 @@ ERROR: type "nonesuch" does not exist
-- missing everything
drop operator;
ERROR: syntax error at or near ";" at character 14
LINE 1: drop operator;
^
-- bad operator name
drop operator equals;
ERROR: syntax error at or near ";" at character 21
LINE 1: drop operator equals;
^
-- missing type list
drop operator ===;
ERROR: syntax error at or near ";" at character 18
LINE 1: drop operator ===;
^
-- missing parentheses
drop operator int4, int4;
ERROR: syntax error at or near "," at character 19
LINE 1: drop operator int4, int4;
^
-- missing operator name
drop operator (int4, int4);
ERROR: syntax error at or near "(" at character 15
LINE 1: drop operator (int4, int4);
^
-- missing type list contents
drop operator === ();
ERROR: syntax error at or near ")" at character 20
LINE 1: drop operator === ();
^
-- no such operator
drop operator === (int4);
ERROR: missing argument
@ -209,6 +251,8 @@ HINT: Use NONE to denote the missing argument of a unary operator.
-- no such type1
drop operator = ( , int4);
ERROR: syntax error at or near "," at character 19
LINE 1: drop operator = ( , int4);
^
-- no such type1
drop operator = (nonesuch, int4);
ERROR: type nonesuch does not exist
@ -218,27 +262,37 @@ ERROR: type nonesuch does not exist
-- no such type2
drop operator = (int4, );
ERROR: syntax error at or near ")" at character 24
LINE 1: drop operator = (int4, );
^
--
-- DROP RULE
-- missing rule name
drop rule;
ERROR: syntax error at or near ";" at character 10
LINE 1: drop rule;
^
-- bad rule name
drop rule 314159;
ERROR: syntax error at or near "314159" at character 11
LINE 1: drop rule 314159;
^
-- no such rule
drop rule nonesuch on noplace;
ERROR: relation "noplace" does not exist
-- bad keyword
-- these postquel variants are no longer supported
drop tuple rule nonesuch;
ERROR: syntax error at or near "tuple" at character 6
-- no such rule
LINE 1: drop tuple rule nonesuch;
^
drop instance rule nonesuch on noplace;
ERROR: syntax error at or near "instance" at character 6
-- no such rule
LINE 1: drop instance rule nonesuch on noplace;
^
drop rewrite rule nonesuch;
ERROR: syntax error at or near "rewrite" at character 6
LINE 1: drop rewrite rule nonesuch;
^
--
-- Check that division-by-zero is properly caught.
--
@ -264,3 +318,129 @@ select 1::float4/0;
ERROR: division by zero
select 1/0::float4;
ERROR: division by zero
--
-- Test psql's reporting of syntax error location
--
xxx;
ERROR: syntax error at or near "xxx" at character 1
LINE 1: xxx;
^
CREATE foo;
ERROR: syntax error at or near "foo" at character 8
LINE 1: CREATE foo;
^
CREATE TABLE ;
ERROR: syntax error at or near ";" at character 14
LINE 1: CREATE TABLE ;
^
CREATE TABLE
\g
ERROR: syntax error at end of input at character 13
LINE 1: CREATE TABLE
^
INSERT INTO foo VALUES(123) foo;
ERROR: syntax error at or near "foo" at character 29
LINE 1: INSERT INTO foo VALUES(123) foo;
^
INSERT INTO 123
VALUES(123);
ERROR: syntax error at or near "123" at character 13
LINE 1: INSERT INTO 123
^
INSERT INTO foo
VALUES(123) 123
;
ERROR: syntax error at or near "123" at character 30
LINE 2: VALUES(123) 123
^
-- with a tab
CREATE TABLE foo
(id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY,
id3 INTEGER NOT NUL,
id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL);
ERROR: syntax error at or near "NUL" at character 94
LINE 3: id3 INTEGER NOT NUL,
^
-- long line to be truncated on the left
CREATE TABLE foo(id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL,
id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL);
ERROR: syntax error at or near "NUL" at character 90
LINE 1: ...T NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL,
^
-- long line to be truncated on the right
CREATE TABLE foo(
id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL, id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY);
ERROR: syntax error at or near "NUL" at character 35
LINE 2: id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQ...
^
-- long line to be truncated both ways
CREATE TABLE foo(id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL);
ERROR: syntax error at or near "NUL" at character 90
LINE 1: ...L, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 I...
^
-- long line to be truncated on the left, many lines
CREATE
TEMPORARY
TABLE
foo(id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL,
id4 INT4
UNIQUE
NOT
NULL,
id5 TEXT
UNIQUE
NOT
NULL)
;
ERROR: syntax error at or near "NUL" at character 101
LINE 4: ...T NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL,
^
-- long line to be truncated on the right, many lines
CREATE
TEMPORARY
TABLE
foo(
id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL, id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY)
;
ERROR: syntax error at or near "NUL" at character 47
LINE 5: id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQ...
^
-- long line to be truncated both ways, many lines
CREATE
TEMPORARY
TABLE
foo
(id
INT4
UNIQUE NOT NULL, idx INT4 UNIQUE NOT NULL, idy INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL,
idz INT4 UNIQUE NOT NULL,
idv INT4 UNIQUE NOT NULL);
ERROR: syntax error at or near "NUL" at character 157
LINE 7: ...L, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 I...
^
-- more than 10 lines...
CREATE
TEMPORARY
TABLE
foo
(id
INT4
UNIQUE
NOT
NULL
,
idm
INT4
UNIQUE
NOT
NULL,
idx INT4 UNIQUE NOT NULL, idy INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL,
idz INT4 UNIQUE NOT NULL,
idv
INT4
UNIQUE
NOT
NULL);
ERROR: syntax error at or near "NUL" at character 190
LINE 16: ...L, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 I...
^

View File

@ -19,6 +19,8 @@ SELECT 'first line'
' - third line'
AS "Illegal comment within continuation";
ERROR: syntax error at or near "' - third line'" at character 75
LINE 3: ' - third line'
^
--
-- test conversions between various string types
-- E021-10 implicit casting among the character data types

View File

@ -46,11 +46,15 @@ SELECT '' AS four, * FROM DEFAULTEXPR_TBL;
-- test for extraneous comma
CREATE TABLE error_tbl (i int DEFAULT (100, ));
ERROR: syntax error at or near "," at character 43
LINE 1: CREATE TABLE error_tbl (i int DEFAULT (100, ));
^
-- this will fail because gram.y uses b_expr not a_expr for defaults,
-- to avoid a shift/reduce conflict that arises from NOT NULL being
-- part of the column definition syntax:
CREATE TABLE error_tbl (b1 bool DEFAULT 1 IN (1, 2));
ERROR: syntax error at or near "IN" at character 43
LINE 1: CREATE TABLE error_tbl (b1 bool DEFAULT 1 IN (1, 2));
^
-- this should work, however:
CREATE TABLE error_tbl (b1 bool DEFAULT (1 IN (1, 2)));
DROP TABLE error_tbl;

View File

@ -242,13 +242,9 @@ drop rule 314159;
-- no such rule
drop rule nonesuch on noplace;
-- bad keyword
-- these postquel variants are no longer supported
drop tuple rule nonesuch;
-- no such rule
drop instance rule nonesuch on noplace;
-- no such rule
drop rewrite rule nonesuch;
--
@ -276,3 +272,101 @@ select 1/0::float8;
select 1::float4/0;
select 1/0::float4;
--
-- Test psql's reporting of syntax error location
--
xxx;
CREATE foo;
CREATE TABLE ;
CREATE TABLE
\g
INSERT INTO foo VALUES(123) foo;
INSERT INTO 123
VALUES(123);
INSERT INTO foo
VALUES(123) 123
;
-- with a tab
CREATE TABLE foo
(id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY,
id3 INTEGER NOT NUL,
id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL);
-- long line to be truncated on the left
CREATE TABLE foo(id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL,
id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL);
-- long line to be truncated on the right
CREATE TABLE foo(
id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL, id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY);
-- long line to be truncated both ways
CREATE TABLE foo(id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL);
-- long line to be truncated on the left, many lines
CREATE
TEMPORARY
TABLE
foo(id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL,
id4 INT4
UNIQUE
NOT
NULL,
id5 TEXT
UNIQUE
NOT
NULL)
;
-- long line to be truncated on the right, many lines
CREATE
TEMPORARY
TABLE
foo(
id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL, id INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY)
;
-- long line to be truncated both ways, many lines
CREATE
TEMPORARY
TABLE
foo
(id
INT4
UNIQUE NOT NULL, idx INT4 UNIQUE NOT NULL, idy INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL,
idz INT4 UNIQUE NOT NULL,
idv INT4 UNIQUE NOT NULL);
-- more than 10 lines...
CREATE
TEMPORARY
TABLE
foo
(id
INT4
UNIQUE
NOT
NULL
,
idm
INT4
UNIQUE
NOT
NULL,
idx INT4 UNIQUE NOT NULL, idy INT4 UNIQUE NOT NULL, id2 TEXT NOT NULL PRIMARY KEY, id3 INTEGER NOT NUL, id4 INT4 UNIQUE NOT NULL, id5 TEXT UNIQUE NOT NULL,
idz INT4 UNIQUE NOT NULL,
idv
INT4
UNIQUE
NOT
NULL);