Skip to content

Add CQL Query Parser #1582

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
gonzalotguerrero wants to merge 6 commits into
base: master
Choose a base branch
from
Open

Add CQL Query Parser #1582

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
6 commits
Select commit Hold shift + click to select a range
fe62cd3
Add antlr-based CQL query parser and utils
gonzalotguerrero Jun 9, 2026
ac1ee6c
Add tests for parser utils
gonzalotguerrero Jun 9, 2026
f0576f6
Merge branch 'master' into feature/cql-query-parser
gonzalotguerrero Jun 9, 2026
5ff2d33
Adapt pom.xml to avoid future conflicts
gonzalotguerrero Jun 11, 2026
7f782c9
Merge branch 'master' into feature/cql-query-parser
gonzalotguerrero Jun 11, 2026
a6d028a
Merge branch 'master' into feature/cql-query-parser
gonzalotguerrero Jun 11, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 19 additions & 5 deletions client-java/controller/pom.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -81,10 +81,10 @@
<artifactId>javax.ws.rs-api</artifactId>
<version>2.1.1</version>
</dependency>
<!-- <dependency>-->
<!-- <groupId>net.java.dev.jna</groupId>-->
<!-- <artifactId>jna-platform</artifactId>-->
<!-- </dependency>-->
<!-- <dependency>-->
<!-- <groupId>net.java.dev.jna</groupId>-->
<!-- <artifactId>jna-platform</artifactId>-->
<!-- </dependency>-->

<dependency>
<groupId>com.ea.agentloader</groupId>
Expand Down Expand Up @@ -122,6 +122,10 @@
<groupId>com.github.jsqlparser</groupId>
<artifactId>jsqlparser</artifactId>
</dependency>
<dependency>
<groupId>org.antlr</groupId>
<artifactId>antlr4-runtime</artifactId>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-engine</artifactId>
Expand Down Expand Up @@ -346,13 +350,23 @@
<pattern>net.sf.jsqlparser</pattern>
<shadedPattern>shaded.net.sf.jsqlparser</shadedPattern>
</relocation>
<relocation>
<pattern>org.antlr</pattern>
<shadedPattern>shaded.org.antlr</shadedPattern>
</relocation>
</relocations>
</configuration>
</execution>
</executions>
</plugin>

<!-- Generates the Cypher parser from the Neo4j Cypher25 grammar and the CQL parser-->
<plugin>
<groupId>org.antlr</groupId>
<artifactId>antlr4-maven-plugin</artifactId>
</plugin>

</plugins>
</build>

</project>
</project>
260 changes: 260 additions & 0 deletions ...troller/src/main/antlr4/org/evomaster/client/java/controller/cassandra/parser/CqlLexer.g4
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,260 @@
// $antlr-format alignTrailingComments true, columnLimit 150, maxEmptyLinesToKeep 1, reflowComments false, useTab false
// $antlr-format allowShortRulesOnASingleLine true, allowShortBlocksOnASingleLine true, minEmptyLines 0, alignSemicolons ownLine
// $antlr-format alignColons trailing, singleLineOverrulesHangingColon true, alignLexerCommands true, alignLabels true, alignTrailers true

lexer grammar CqlLexer;

options {
caseInsensitive = true;
}

// Operators and Punctuators

LR_BRACKET : '(';
RR_BRACKET : ')';
LC_BRACKET : '{';
RC_BRACKET : '}';
LS_BRACKET : '[';
RS_BRACKET : ']';
COMMA : ',';
SEMI : ';';
COLON : ':';
DOT : '.';
STAR : '*';
DIVIDE : '/';
MODULE : '%';
PLUS : '+';
MINUSMINUS : '--';
MINUS : '-';
DQUOTE : '"';
SQUOTE : '\'';
OPERATOR_EQ : '=';
OPERATOR_LT : '<';
OPERATOR_GT : '>';
OPERATOR_LTE : '<=';
OPERATOR_GTE : '>=';

// Keywords

K_ADD : 'ADD';
K_AGGREGATE : 'AGGREGATE';
K_ALL : 'ALL';
K_ALLOW : 'ALLOW';
K_ALTER : 'ALTER';
K_AND : 'AND';
K_ANY : 'ANY';
K_APPLY : 'APPLY';
K_AS : 'AS';
K_ASC : 'ASC';
K_AUTHORIZE : 'AUTHORIZE';
K_BATCH : 'BATCH';
K_BEGIN : 'BEGIN';
K_BY : 'BY';
K_CALLED : 'CALLED';
K_CLUSTERING : 'CLUSTERING';
K_COLUMNFAMILY : 'COLUMNFAMILY';
K_COMPACT : 'COMPACT';
K_CONSISTENCY : 'CONSISTENCY';
K_CONTAINS : 'CONTAINS';
K_CREATE : 'CREATE';
K_CUSTOM : 'CUSTOM';
K_DEFAULT : 'DEFAULT';
K_DELETE : 'DELETE';
K_DESC : 'DESC';
K_DESCRIBE : 'DESCRIBE';
K_DISTINCT : 'DISTINCT';
K_DROP : 'DROP';
K_DURABLE_WRITES : 'DURABLE_WRITES';
K_EACH_QUORUM : 'EACH_QUORUM';
K_ENTRIES : 'ENTRIES';
K_EXECUTE : 'EXECUTE';
K_EXISTS : 'EXISTS';
K_FALSE : [Ff][Aa][Ll][Ss][Ee];
K_FILTERING : 'FILTERING';
K_FINALFUNC : 'FINALFUNC';
K_FROM : 'FROM';
K_FULL : 'FULL';
K_FUNCTION : 'FUNCTION';
K_FUNCTIONS : 'FUNCTIONS';
K_GRANT : 'GRANT';
K_IF : 'IF';
K_IN : 'IN';
K_INDEX : 'INDEX';
K_INFINITY : 'INFINITY';
K_INITCOND : 'INITCOND';
K_INPUT : 'INPUT';
K_INSERT : 'INSERT';
K_INTO : 'INTO';
K_IS : 'IS';
K_JSON : 'JSON';
K_KEY : 'KEY';
K_KEYS : 'KEYS';
K_KEYSPACE : 'KEYSPACE';
K_KEYSPACES : 'KEYSPACES';
K_LANGUAGE : 'LANGUAGE';
K_LEVEL : 'LEVEL';
K_LIMIT : 'LIMIT';
K_LOCAL_ONE : 'LOCAL_ONE';
K_LOCAL_QUORUM : 'LOCAL_QUORUM';
K_LOGGED : 'LOGGED';
K_LOGIN : 'LOGIN';
K_MASKED : 'MASKED';
K_MATERIALIZED : 'MATERIALIZED';
K_MODIFY : 'MODIFY';
K_NAN : 'NAN';
K_NORECURSIVE : 'NORECURSIVE';
K_NOSUPERUSER : 'NOSUPERUSER';
K_NOT : 'NOT';
K_NULL : 'NULL';
K_OF : 'OF';
K_ON : 'ON';
K_ONE : 'ONE';
K_OPTIONS : 'OPTIONS';
K_OR : 'OR';
K_ORDER : 'ORDER';
K_PARTITION : 'PARTITION';
K_PASSWORD : 'PASSWORD';
K_PER : 'PER';
K_PERMISSION : 'PERMISSION';
K_PERMISSIONS : 'PERMISSIONS';
K_PRIMARY : 'PRIMARY';
K_QUORUM : 'QUORUM';
K_RENAME : 'RENAME';
K_REPLACE : 'REPLACE';
K_REPLICATION : 'REPLICATION';
K_RETURNS : 'RETURNS';
K_REVOKE : 'REVOKE';
K_ROLE : 'ROLE';
K_ROLES : 'ROLES';
K_SCHEMA : 'SCHEMA';
K_SELECT : 'SELECT';
K_SET : 'SET';
K_SFUNC : 'SFUNC';
K_STATIC : 'STATIC';
K_STORAGE : 'STORAGE';
K_STYPE : 'STYPE';
K_SUPERUSER : 'SUPERUSER';
K_TABLE : 'TABLE';
K_THREE : 'THREE';
K_TIMESTAMP : 'TIMESTAMP';
K_TO : 'TO';
K_TOKEN : 'TOKEN';
K_TRIGGER : 'TRIGGER';
K_TRUE : [Tt][Rr][Uu][Ee];
K_TRUNCATE : 'TRUNCATE';
K_TTL : 'TTL';
K_TWO : 'TWO';
K_TYPE : 'TYPE';
K_UNLOGGED : 'UNLOGGED';
K_UPDATE : 'UPDATE';
K_USE : 'USE';
K_USER : 'USER';
K_USING : 'USING';
K_UUID : 'UUID';
K_VALUES : 'VALUES';
K_VECTOR : 'VECTOR';
K_VIEW : 'VIEW';
K_WHERE : 'WHERE';
K_WITH : 'WITH';
K_WRITETIME : 'WRITETIME';
K_ASCII : 'ASCII';
K_BIGINT : 'BIGINT';
K_BLOB : 'BLOB';
K_BOOLEAN : 'BOOLEAN';
K_COUNTER : 'COUNTER';
K_DATE : 'DATE';
K_DECIMAL : 'DECIMAL';
K_DOUBLE : 'DOUBLE';
K_FLOAT : 'FLOAT';
K_FROZEN : 'FROZEN';
K_INET : 'INET';
K_INT : 'INT';
K_LIST : 'LIST';
K_MAP : 'MAP';
K_SMALLINT : 'SMALLINT';
K_TEXT : 'TEXT';
K_TIMEUUID : 'TIMEUUID';
K_TIME : 'TIME';
K_TINYINT : 'TINYINT';
K_TUPLE : 'TUPLE';
K_VARCHAR : 'VARCHAR';
K_VARINT : 'VARINT';

// Literals

CODE_BLOCK: '$$' (~ '$' | '$' ~'$')* '$$';

STRING_LITERAL: '\'' ('\\' . | '\'\'' | ~('\'' | '\\'))* '\'';

DECIMAL_LITERAL: DEC_DIGIT+;

FLOAT_LITERAL: MINUS? [0-9]+ (DOT [0-9]+)?;

HEXADECIMAL_LITERAL: 'X' '\'' (HEX_DIGIT HEX_DIGIT)+ '\'' | '0X' HEX_DIGIT+;

REAL_LITERAL: DEC_DIGIT+ '.'? EXPONENT_NUM_PART | DEC_DIGIT* '.' DEC_DIGIT+ EXPONENT_NUM_PART?;

// Duration literal — must appear before OBJECT_NAME so that ISO-format tokens like
// PT89H8M53S or P1Y2M3D are not consumed as OBJECT_NAME first.
// Three accepted formats (all case-insensitive via explicit char classes):
// 1. Standard quantity-unit: 89h4m48s 1y2mo3d -2mo (units: y mo w d h ms m us ns s)
// 2. ISO 8601 standard: P1Y2M3DT4H5M6S PT89H8M53S
// 3. ISO 8601 alternative: P0000-00-00T89:09:09
DURATION_LITERAL
: MINUS? DEC_DIGIT+ DURATION_UNIT (DEC_DIGIT+ DURATION_UNIT)*
| [pP] DURATION_ISO_BODY
;

OBJECT_NAME: [A-Za-z] [A-Za-z0-9_$]* | '"' ~'"'+ '"';

UUID:
HEX_4DIGIT HEX_4DIGIT '-' HEX_4DIGIT '-' HEX_4DIGIT '-' HEX_4DIGIT '-' HEX_4DIGIT HEX_4DIGIT HEX_4DIGIT
;

// Hidden

SPACE : [ \t\r\n]+ -> channel (HIDDEN);
SPEC_MYSQL_COMMENT : '/*!' .+? '*/' -> channel (HIDDEN);
COMMENT_INPUT : '/*' .*? '*/' -> channel (HIDDEN);
LINE_COMMENT:
(('-- ' | '#' | '//') ~ [\r\n]* ('\r'? '\n' | EOF) | '--' ('\r'? '\n' | EOF)) -> channel (HIDDEN)
;

// Fragments

fragment HEX_4DIGIT: [0-9A-Fa-f] [0-9A-Fa-f] [0-9A-Fa-f] [0-9A-Fa-f];

fragment HEX_DIGIT: [0-9A-Fa-f];

fragment DEC_DIGIT: [0-9];

fragment EXPONENT_NUM_PART: 'E' '-'? DEC_DIGIT+;

// Duration unit suffixes — ordered longest-first within each ambiguous group:
// 'mo' before 'm', 'ms' before 'm', 'us' before 's', 'ns' before 's'
fragment DURATION_UNIT
: [yY]
| [mM][oO]
| [wW]
| [dD]
| [hH]
| [mM][sS]
| [mM]
| [uU][sS]
| [nN][sS]
| [sS]
;

// ISO 8601 duration body (the part after the leading P).
// Each alternative requires at least one component so that bare 'P' or 'PT' is not matched.
// Date-M (months) is unambiguous from time-M (minutes) because time components follow the T separator.
fragment DURATION_ISO_BODY
: DEC_DIGIT+ [yY] (DEC_DIGIT+ [mM])? (DEC_DIGIT+ [wW])? (DEC_DIGIT+ [dD])? ([tT] (DEC_DIGIT+ [hH])? (DEC_DIGIT+ [mM])? (DEC_DIGIT+ [sS])?)?
| DEC_DIGIT+ [mM] (DEC_DIGIT+ [wW])? (DEC_DIGIT+ [dD])? ([tT] (DEC_DIGIT+ [hH])? (DEC_DIGIT+ [mM])? (DEC_DIGIT+ [sS])?)?
| DEC_DIGIT+ [wW] (DEC_DIGIT+ [dD])? ([tT] (DEC_DIGIT+ [hH])? (DEC_DIGIT+ [mM])? (DEC_DIGIT+ [sS])?)?
| DEC_DIGIT+ [dD] ([tT] (DEC_DIGIT+ [hH])? (DEC_DIGIT+ [mM])? (DEC_DIGIT+ [sS])?)?
| [tT] DEC_DIGIT+ [hH] (DEC_DIGIT+ [mM])? (DEC_DIGIT+ [sS])?
| [tT] DEC_DIGIT+ [mM] (DEC_DIGIT+ [sS])?
| [tT] DEC_DIGIT+ [sS]
| DEC_DIGIT DEC_DIGIT DEC_DIGIT DEC_DIGIT '-' DEC_DIGIT DEC_DIGIT '-' DEC_DIGIT DEC_DIGIT [tT] DEC_DIGIT DEC_DIGIT ':' DEC_DIGIT DEC_DIGIT ':' DEC_DIGIT DEC_DIGIT
;
Loading