sqlglot.tokens
1from __future__ import annotations 2 3import typing as t 4from enum import auto 5 6from sqlglot.helper import AutoName 7from sqlglot.trie import in_trie, new_trie 8 9 10class TokenType(AutoName): 11 L_PAREN = auto() 12 R_PAREN = auto() 13 L_BRACKET = auto() 14 R_BRACKET = auto() 15 L_BRACE = auto() 16 R_BRACE = auto() 17 COMMA = auto() 18 DOT = auto() 19 DASH = auto() 20 PLUS = auto() 21 COLON = auto() 22 DCOLON = auto() 23 SEMICOLON = auto() 24 STAR = auto() 25 BACKSLASH = auto() 26 SLASH = auto() 27 LT = auto() 28 LTE = auto() 29 GT = auto() 30 GTE = auto() 31 NOT = auto() 32 EQ = auto() 33 NEQ = auto() 34 NULLSAFE_EQ = auto() 35 AND = auto() 36 OR = auto() 37 AMP = auto() 38 DPIPE = auto() 39 PIPE = auto() 40 CARET = auto() 41 TILDA = auto() 42 ARROW = auto() 43 DARROW = auto() 44 FARROW = auto() 45 HASH = auto() 46 HASH_ARROW = auto() 47 DHASH_ARROW = auto() 48 LR_ARROW = auto() 49 DOLLAR = auto() 50 PARAMETER = auto() 51 SESSION_PARAMETER = auto() 52 NATIONAL = auto() 53 54 BLOCK_START = auto() 55 BLOCK_END = auto() 56 57 SPACE = auto() 58 BREAK = auto() 59 60 STRING = auto() 61 NUMBER = auto() 62 IDENTIFIER = auto() 63 COLUMN = auto() 64 COLUMN_DEF = auto() 65 SCHEMA = auto() 66 TABLE = auto() 67 VAR = auto() 68 BIT_STRING = auto() 69 HEX_STRING = auto() 70 BYTE_STRING = auto() 71 72 # types 73 BOOLEAN = auto() 74 TINYINT = auto() 75 SMALLINT = auto() 76 INT = auto() 77 BIGINT = auto() 78 FLOAT = auto() 79 DOUBLE = auto() 80 DECIMAL = auto() 81 CHAR = auto() 82 NCHAR = auto() 83 VARCHAR = auto() 84 NVARCHAR = auto() 85 TEXT = auto() 86 MEDIUMTEXT = auto() 87 LONGTEXT = auto() 88 MEDIUMBLOB = auto() 89 LONGBLOB = auto() 90 BINARY = auto() 91 VARBINARY = auto() 92 JSON = auto() 93 JSONB = auto() 94 TIME = auto() 95 TIMESTAMP = auto() 96 TIMESTAMPTZ = auto() 97 TIMESTAMPLTZ = auto() 98 DATETIME = auto() 99 DATE = auto() 100 UUID = auto() 101 GEOGRAPHY = auto() 102 NULLABLE = auto() 103 GEOMETRY = auto() 104 HLLSKETCH = auto() 105 HSTORE = auto() 106 SUPER = auto() 107 SERIAL = auto() 108 SMALLSERIAL = auto() 109 BIGSERIAL = auto() 110 XML = auto() 111 UNIQUEIDENTIFIER = auto() 112 MONEY = auto() 113 SMALLMONEY = auto() 114 ROWVERSION = auto() 115 IMAGE = auto() 116 VARIANT = auto() 117 OBJECT = auto() 118 119 # keywords 120 ALIAS = auto() 121 ALTER = auto() 122 ALWAYS = auto() 123 ALL = auto() 124 ANTI = auto() 125 ANY = auto() 126 APPLY = auto() 127 ARRAY = auto() 128 ASC = auto() 129 ASOF = auto() 130 AT_TIME_ZONE = auto() 131 AUTO_INCREMENT = auto() 132 BEGIN = auto() 133 BETWEEN = auto() 134 BOTH = auto() 135 BUCKET = auto() 136 BY_DEFAULT = auto() 137 CACHE = auto() 138 CASCADE = auto() 139 CASE = auto() 140 CHARACTER_SET = auto() 141 CHECK = auto() 142 CLUSTER_BY = auto() 143 COLLATE = auto() 144 COMMAND = auto() 145 COMMENT = auto() 146 COMMIT = auto() 147 COMPOUND = auto() 148 CONSTRAINT = auto() 149 CREATE = auto() 150 CROSS = auto() 151 CUBE = auto() 152 CURRENT_DATE = auto() 153 CURRENT_DATETIME = auto() 154 CURRENT_ROW = auto() 155 CURRENT_TIME = auto() 156 CURRENT_TIMESTAMP = auto() 157 DEFAULT = auto() 158 DELETE = auto() 159 DESC = auto() 160 DESCRIBE = auto() 161 DISTINCT = auto() 162 DISTINCT_FROM = auto() 163 DISTRIBUTE_BY = auto() 164 DIV = auto() 165 DROP = auto() 166 ELSE = auto() 167 ENCODE = auto() 168 END = auto() 169 ESCAPE = auto() 170 EXCEPT = auto() 171 EXECUTE = auto() 172 EXISTS = auto() 173 FALSE = auto() 174 FETCH = auto() 175 FILTER = auto() 176 FINAL = auto() 177 FIRST = auto() 178 FOLLOWING = auto() 179 FOR = auto() 180 FOREIGN_KEY = auto() 181 FORMAT = auto() 182 FROM = auto() 183 FULL = auto() 184 FUNCTION = auto() 185 GENERATED = auto() 186 GLOB = auto() 187 GLOBAL = auto() 188 GROUP_BY = auto() 189 GROUPING_SETS = auto() 190 HAVING = auto() 191 HINT = auto() 192 IDENTITY = auto() 193 IF = auto() 194 IGNORE_NULLS = auto() 195 ILIKE = auto() 196 IN = auto() 197 INDEX = auto() 198 INNER = auto() 199 INSERT = auto() 200 INTERSECT = auto() 201 INTERVAL = auto() 202 INTO = auto() 203 INTRODUCER = auto() 204 IRLIKE = auto() 205 IS = auto() 206 ISNULL = auto() 207 JOIN = auto() 208 LANGUAGE = auto() 209 LATERAL = auto() 210 LAZY = auto() 211 LEADING = auto() 212 LEFT = auto() 213 LIKE = auto() 214 LIMIT = auto() 215 LOAD_DATA = auto() 216 LOCAL = auto() 217 MAP = auto() 218 MATCH_RECOGNIZE = auto() 219 MATERIALIZED = auto() 220 MERGE = auto() 221 MOD = auto() 222 NATURAL = auto() 223 NEXT = auto() 224 NO_ACTION = auto() 225 NOTNULL = auto() 226 NULL = auto() 227 NULLS_FIRST = auto() 228 NULLS_LAST = auto() 229 OFFSET = auto() 230 ON = auto() 231 ONLY = auto() 232 OPTIONS = auto() 233 ORDER_BY = auto() 234 ORDERED = auto() 235 ORDINALITY = auto() 236 OUTER = auto() 237 OUT_OF = auto() 238 OVER = auto() 239 OVERWRITE = auto() 240 PARTITION = auto() 241 PARTITION_BY = auto() 242 PERCENT = auto() 243 PIVOT = auto() 244 PLACEHOLDER = auto() 245 PRECEDING = auto() 246 PRIMARY_KEY = auto() 247 PROCEDURE = auto() 248 PROPERTIES = auto() 249 PSEUDO_TYPE = auto() 250 QUALIFY = auto() 251 QUOTE = auto() 252 RANGE = auto() 253 RECURSIVE = auto() 254 REPLACE = auto() 255 RESPECT_NULLS = auto() 256 REFERENCES = auto() 257 RIGHT = auto() 258 RLIKE = auto() 259 ROLLBACK = auto() 260 ROLLUP = auto() 261 ROW = auto() 262 ROWS = auto() 263 SCHEMA_COMMENT = auto() 264 SEED = auto() 265 SELECT = auto() 266 SEMI = auto() 267 SEPARATOR = auto() 268 SERDE_PROPERTIES = auto() 269 SET = auto() 270 SHOW = auto() 271 SIMILAR_TO = auto() 272 SOME = auto() 273 SORTKEY = auto() 274 SORT_BY = auto() 275 STRUCT = auto() 276 TABLE_SAMPLE = auto() 277 TEMPORARY = auto() 278 TOP = auto() 279 THEN = auto() 280 TRAILING = auto() 281 TRUE = auto() 282 UNBOUNDED = auto() 283 UNCACHE = auto() 284 UNION = auto() 285 UNLOGGED = auto() 286 UNNEST = auto() 287 UNPIVOT = auto() 288 UPDATE = auto() 289 USE = auto() 290 USING = auto() 291 VALUES = auto() 292 VIEW = auto() 293 VOLATILE = auto() 294 WHEN = auto() 295 WHERE = auto() 296 WINDOW = auto() 297 WITH = auto() 298 WITH_TIME_ZONE = auto() 299 WITH_LOCAL_TIME_ZONE = auto() 300 WITHIN_GROUP = auto() 301 WITHOUT_TIME_ZONE = auto() 302 UNIQUE = auto() 303 304 305class Token: 306 __slots__ = ("token_type", "text", "line", "col", "comments") 307 308 @classmethod 309 def number(cls, number: int) -> Token: 310 """Returns a NUMBER token with `number` as its text.""" 311 return cls(TokenType.NUMBER, str(number)) 312 313 @classmethod 314 def string(cls, string: str) -> Token: 315 """Returns a STRING token with `string` as its text.""" 316 return cls(TokenType.STRING, string) 317 318 @classmethod 319 def identifier(cls, identifier: str) -> Token: 320 """Returns an IDENTIFIER token with `identifier` as its text.""" 321 return cls(TokenType.IDENTIFIER, identifier) 322 323 @classmethod 324 def var(cls, var: str) -> Token: 325 """Returns an VAR token with `var` as its text.""" 326 return cls(TokenType.VAR, var) 327 328 def __init__( 329 self, 330 token_type: TokenType, 331 text: str, 332 line: int = 1, 333 col: int = 1, 334 comments: t.List[str] = [], 335 ) -> None: 336 self.token_type = token_type 337 self.text = text 338 self.line = line 339 self.col = max(col - len(text), 1) 340 self.comments = comments 341 342 def __repr__(self) -> str: 343 attributes = ", ".join(f"{k}: {getattr(self, k)}" for k in self.__slots__) 344 return f"<Token {attributes}>" 345 346 347class _Tokenizer(type): 348 def __new__(cls, clsname, bases, attrs): # type: ignore 349 klass = super().__new__(cls, clsname, bases, attrs) 350 351 klass._QUOTES = { 352 f"{prefix}{s}": e 353 for s, e in cls._delimeter_list_to_dict(klass.QUOTES).items() 354 for prefix in (("",) if s[0].isalpha() else ("", "n", "N")) 355 } 356 klass._BIT_STRINGS = cls._delimeter_list_to_dict(klass.BIT_STRINGS) 357 klass._HEX_STRINGS = cls._delimeter_list_to_dict(klass.HEX_STRINGS) 358 klass._BYTE_STRINGS = cls._delimeter_list_to_dict(klass.BYTE_STRINGS) 359 klass._IDENTIFIERS = cls._delimeter_list_to_dict(klass.IDENTIFIERS) 360 klass._STRING_ESCAPES = set(klass.STRING_ESCAPES) 361 klass._IDENTIFIER_ESCAPES = set(klass.IDENTIFIER_ESCAPES) 362 klass._COMMENTS = dict( 363 (comment, None) if isinstance(comment, str) else (comment[0], comment[1]) 364 for comment in klass.COMMENTS 365 ) 366 367 klass.KEYWORD_TRIE = new_trie( 368 key.upper() 369 for key in { 370 **klass.KEYWORDS, 371 **{comment: TokenType.COMMENT for comment in klass._COMMENTS}, 372 **{quote: TokenType.QUOTE for quote in klass._QUOTES}, 373 **{bit_string: TokenType.BIT_STRING for bit_string in klass._BIT_STRINGS}, 374 **{hex_string: TokenType.HEX_STRING for hex_string in klass._HEX_STRINGS}, 375 **{byte_string: TokenType.BYTE_STRING for byte_string in klass._BYTE_STRINGS}, 376 } 377 if " " in key or any(single in key for single in klass.SINGLE_TOKENS) 378 ) 379 380 return klass 381 382 @staticmethod 383 def _delimeter_list_to_dict(list: t.List[str | t.Tuple[str, str]]) -> t.Dict[str, str]: 384 return dict((item, item) if isinstance(item, str) else (item[0], item[1]) for item in list) 385 386 387class Tokenizer(metaclass=_Tokenizer): 388 SINGLE_TOKENS = { 389 "(": TokenType.L_PAREN, 390 ")": TokenType.R_PAREN, 391 "[": TokenType.L_BRACKET, 392 "]": TokenType.R_BRACKET, 393 "{": TokenType.L_BRACE, 394 "}": TokenType.R_BRACE, 395 "&": TokenType.AMP, 396 "^": TokenType.CARET, 397 ":": TokenType.COLON, 398 ",": TokenType.COMMA, 399 ".": TokenType.DOT, 400 "-": TokenType.DASH, 401 "=": TokenType.EQ, 402 ">": TokenType.GT, 403 "<": TokenType.LT, 404 "%": TokenType.MOD, 405 "!": TokenType.NOT, 406 "|": TokenType.PIPE, 407 "+": TokenType.PLUS, 408 ";": TokenType.SEMICOLON, 409 "/": TokenType.SLASH, 410 "\\": TokenType.BACKSLASH, 411 "*": TokenType.STAR, 412 "~": TokenType.TILDA, 413 "?": TokenType.PLACEHOLDER, 414 "@": TokenType.PARAMETER, 415 # used for breaking a var like x'y' but nothing else 416 # the token type doesn't matter 417 "'": TokenType.QUOTE, 418 "`": TokenType.IDENTIFIER, 419 '"': TokenType.IDENTIFIER, 420 "#": TokenType.HASH, 421 } 422 423 QUOTES: t.List[t.Tuple[str, str] | str] = ["'"] 424 425 BIT_STRINGS: t.List[str | t.Tuple[str, str]] = [] 426 427 HEX_STRINGS: t.List[str | t.Tuple[str, str]] = [] 428 429 BYTE_STRINGS: t.List[str | t.Tuple[str, str]] = [] 430 431 IDENTIFIERS: t.List[str | t.Tuple[str, str]] = ['"'] 432 433 STRING_ESCAPES = ["'"] 434 435 _STRING_ESCAPES: t.Set[str] = set() 436 437 IDENTIFIER_ESCAPES = ['"'] 438 439 _IDENTIFIER_ESCAPES: t.Set[str] = set() 440 441 KEYWORDS = { 442 **{ 443 f"{key}{postfix}": TokenType.BLOCK_START 444 for key in ("{{", "{%", "{#") 445 for postfix in ("", "+", "-") 446 }, 447 **{ 448 f"{prefix}{key}": TokenType.BLOCK_END 449 for key in ("%}", "#}") 450 for prefix in ("", "+", "-") 451 }, 452 "+}}": TokenType.BLOCK_END, 453 "-}}": TokenType.BLOCK_END, 454 "/*+": TokenType.HINT, 455 "==": TokenType.EQ, 456 "::": TokenType.DCOLON, 457 "||": TokenType.DPIPE, 458 ">=": TokenType.GTE, 459 "<=": TokenType.LTE, 460 "<>": TokenType.NEQ, 461 "!=": TokenType.NEQ, 462 "<=>": TokenType.NULLSAFE_EQ, 463 "->": TokenType.ARROW, 464 "->>": TokenType.DARROW, 465 "=>": TokenType.FARROW, 466 "#>": TokenType.HASH_ARROW, 467 "#>>": TokenType.DHASH_ARROW, 468 "<->": TokenType.LR_ARROW, 469 "ALL": TokenType.ALL, 470 "ALWAYS": TokenType.ALWAYS, 471 "AND": TokenType.AND, 472 "ANTI": TokenType.ANTI, 473 "ANY": TokenType.ANY, 474 "ASC": TokenType.ASC, 475 "AS": TokenType.ALIAS, 476 "AT TIME ZONE": TokenType.AT_TIME_ZONE, 477 "AUTOINCREMENT": TokenType.AUTO_INCREMENT, 478 "AUTO_INCREMENT": TokenType.AUTO_INCREMENT, 479 "BEGIN": TokenType.BEGIN, 480 "BETWEEN": TokenType.BETWEEN, 481 "BOTH": TokenType.BOTH, 482 "BUCKET": TokenType.BUCKET, 483 "BY DEFAULT": TokenType.BY_DEFAULT, 484 "CACHE": TokenType.CACHE, 485 "UNCACHE": TokenType.UNCACHE, 486 "CASE": TokenType.CASE, 487 "CASCADE": TokenType.CASCADE, 488 "CHARACTER SET": TokenType.CHARACTER_SET, 489 "CHECK": TokenType.CHECK, 490 "CLUSTER BY": TokenType.CLUSTER_BY, 491 "COLLATE": TokenType.COLLATE, 492 "COLUMN": TokenType.COLUMN, 493 "COMMENT": TokenType.SCHEMA_COMMENT, 494 "COMMIT": TokenType.COMMIT, 495 "COMPOUND": TokenType.COMPOUND, 496 "CONSTRAINT": TokenType.CONSTRAINT, 497 "CREATE": TokenType.CREATE, 498 "CROSS": TokenType.CROSS, 499 "CUBE": TokenType.CUBE, 500 "CURRENT_DATE": TokenType.CURRENT_DATE, 501 "CURRENT ROW": TokenType.CURRENT_ROW, 502 "CURRENT_TIMESTAMP": TokenType.CURRENT_TIMESTAMP, 503 "DEFAULT": TokenType.DEFAULT, 504 "DELETE": TokenType.DELETE, 505 "DESC": TokenType.DESC, 506 "DESCRIBE": TokenType.DESCRIBE, 507 "DISTINCT": TokenType.DISTINCT, 508 "DISTINCT FROM": TokenType.DISTINCT_FROM, 509 "DISTRIBUTE BY": TokenType.DISTRIBUTE_BY, 510 "DIV": TokenType.DIV, 511 "DROP": TokenType.DROP, 512 "ELSE": TokenType.ELSE, 513 "END": TokenType.END, 514 "ESCAPE": TokenType.ESCAPE, 515 "EXCEPT": TokenType.EXCEPT, 516 "EXECUTE": TokenType.EXECUTE, 517 "EXISTS": TokenType.EXISTS, 518 "FALSE": TokenType.FALSE, 519 "FETCH": TokenType.FETCH, 520 "FILTER": TokenType.FILTER, 521 "FIRST": TokenType.FIRST, 522 "FULL": TokenType.FULL, 523 "FUNCTION": TokenType.FUNCTION, 524 "FOLLOWING": TokenType.FOLLOWING, 525 "FOR": TokenType.FOR, 526 "FOREIGN KEY": TokenType.FOREIGN_KEY, 527 "FORMAT": TokenType.FORMAT, 528 "FROM": TokenType.FROM, 529 "GENERATED": TokenType.GENERATED, 530 "GLOB": TokenType.GLOB, 531 "GROUP BY": TokenType.GROUP_BY, 532 "GROUPING SETS": TokenType.GROUPING_SETS, 533 "HAVING": TokenType.HAVING, 534 "IDENTITY": TokenType.IDENTITY, 535 "IF": TokenType.IF, 536 "ILIKE": TokenType.ILIKE, 537 "IGNORE NULLS": TokenType.IGNORE_NULLS, 538 "IN": TokenType.IN, 539 "INDEX": TokenType.INDEX, 540 "INNER": TokenType.INNER, 541 "INSERT": TokenType.INSERT, 542 "INTERVAL": TokenType.INTERVAL, 543 "INTERSECT": TokenType.INTERSECT, 544 "INTO": TokenType.INTO, 545 "IS": TokenType.IS, 546 "ISNULL": TokenType.ISNULL, 547 "JOIN": TokenType.JOIN, 548 "LATERAL": TokenType.LATERAL, 549 "LAZY": TokenType.LAZY, 550 "LEADING": TokenType.LEADING, 551 "LEFT": TokenType.LEFT, 552 "LIKE": TokenType.LIKE, 553 "LIMIT": TokenType.LIMIT, 554 "LOAD DATA": TokenType.LOAD_DATA, 555 "LOCAL": TokenType.LOCAL, 556 "MATERIALIZED": TokenType.MATERIALIZED, 557 "MERGE": TokenType.MERGE, 558 "NATURAL": TokenType.NATURAL, 559 "NEXT": TokenType.NEXT, 560 "NO ACTION": TokenType.NO_ACTION, 561 "NOT": TokenType.NOT, 562 "NOTNULL": TokenType.NOTNULL, 563 "NULL": TokenType.NULL, 564 "NULLS FIRST": TokenType.NULLS_FIRST, 565 "NULLS LAST": TokenType.NULLS_LAST, 566 "OBJECT": TokenType.OBJECT, 567 "OFFSET": TokenType.OFFSET, 568 "ON": TokenType.ON, 569 "ONLY": TokenType.ONLY, 570 "OPTIONS": TokenType.OPTIONS, 571 "OR": TokenType.OR, 572 "ORDER BY": TokenType.ORDER_BY, 573 "ORDINALITY": TokenType.ORDINALITY, 574 "OUTER": TokenType.OUTER, 575 "OUT OF": TokenType.OUT_OF, 576 "OVER": TokenType.OVER, 577 "OVERWRITE": TokenType.OVERWRITE, 578 "PARTITION": TokenType.PARTITION, 579 "PARTITION BY": TokenType.PARTITION_BY, 580 "PARTITIONED BY": TokenType.PARTITION_BY, 581 "PARTITIONED_BY": TokenType.PARTITION_BY, 582 "PERCENT": TokenType.PERCENT, 583 "PIVOT": TokenType.PIVOT, 584 "PRECEDING": TokenType.PRECEDING, 585 "PRIMARY KEY": TokenType.PRIMARY_KEY, 586 "PROCEDURE": TokenType.PROCEDURE, 587 "QUALIFY": TokenType.QUALIFY, 588 "RANGE": TokenType.RANGE, 589 "RECURSIVE": TokenType.RECURSIVE, 590 "REGEXP": TokenType.RLIKE, 591 "REPLACE": TokenType.REPLACE, 592 "RESPECT NULLS": TokenType.RESPECT_NULLS, 593 "REFERENCES": TokenType.REFERENCES, 594 "RIGHT": TokenType.RIGHT, 595 "RLIKE": TokenType.RLIKE, 596 "ROLLBACK": TokenType.ROLLBACK, 597 "ROLLUP": TokenType.ROLLUP, 598 "ROW": TokenType.ROW, 599 "ROWS": TokenType.ROWS, 600 "SCHEMA": TokenType.SCHEMA, 601 "SEED": TokenType.SEED, 602 "SELECT": TokenType.SELECT, 603 "SEMI": TokenType.SEMI, 604 "SET": TokenType.SET, 605 "SHOW": TokenType.SHOW, 606 "SIMILAR TO": TokenType.SIMILAR_TO, 607 "SOME": TokenType.SOME, 608 "SORTKEY": TokenType.SORTKEY, 609 "SORT BY": TokenType.SORT_BY, 610 "TABLE": TokenType.TABLE, 611 "TABLESAMPLE": TokenType.TABLE_SAMPLE, 612 "TEMP": TokenType.TEMPORARY, 613 "TEMPORARY": TokenType.TEMPORARY, 614 "THEN": TokenType.THEN, 615 "TRUE": TokenType.TRUE, 616 "TRAILING": TokenType.TRAILING, 617 "UNBOUNDED": TokenType.UNBOUNDED, 618 "UNION": TokenType.UNION, 619 "UNLOGGED": TokenType.UNLOGGED, 620 "UNNEST": TokenType.UNNEST, 621 "UNPIVOT": TokenType.UNPIVOT, 622 "UPDATE": TokenType.UPDATE, 623 "USE": TokenType.USE, 624 "USING": TokenType.USING, 625 "VALUES": TokenType.VALUES, 626 "VIEW": TokenType.VIEW, 627 "VOLATILE": TokenType.VOLATILE, 628 "WHEN": TokenType.WHEN, 629 "WHERE": TokenType.WHERE, 630 "WINDOW": TokenType.WINDOW, 631 "WITH": TokenType.WITH, 632 "WITH TIME ZONE": TokenType.WITH_TIME_ZONE, 633 "WITH LOCAL TIME ZONE": TokenType.WITH_LOCAL_TIME_ZONE, 634 "WITHIN GROUP": TokenType.WITHIN_GROUP, 635 "WITHOUT TIME ZONE": TokenType.WITHOUT_TIME_ZONE, 636 "APPLY": TokenType.APPLY, 637 "ARRAY": TokenType.ARRAY, 638 "BOOL": TokenType.BOOLEAN, 639 "BOOLEAN": TokenType.BOOLEAN, 640 "BYTE": TokenType.TINYINT, 641 "TINYINT": TokenType.TINYINT, 642 "SHORT": TokenType.SMALLINT, 643 "SMALLINT": TokenType.SMALLINT, 644 "INT2": TokenType.SMALLINT, 645 "INTEGER": TokenType.INT, 646 "INT": TokenType.INT, 647 "INT4": TokenType.INT, 648 "LONG": TokenType.BIGINT, 649 "BIGINT": TokenType.BIGINT, 650 "INT8": TokenType.BIGINT, 651 "DECIMAL": TokenType.DECIMAL, 652 "MAP": TokenType.MAP, 653 "NULLABLE": TokenType.NULLABLE, 654 "NUMBER": TokenType.DECIMAL, 655 "NUMERIC": TokenType.DECIMAL, 656 "FIXED": TokenType.DECIMAL, 657 "REAL": TokenType.FLOAT, 658 "FLOAT": TokenType.FLOAT, 659 "FLOAT4": TokenType.FLOAT, 660 "FLOAT8": TokenType.DOUBLE, 661 "DOUBLE": TokenType.DOUBLE, 662 "DOUBLE PRECISION": TokenType.DOUBLE, 663 "JSON": TokenType.JSON, 664 "CHAR": TokenType.CHAR, 665 "NCHAR": TokenType.NCHAR, 666 "VARCHAR": TokenType.VARCHAR, 667 "VARCHAR2": TokenType.VARCHAR, 668 "NVARCHAR": TokenType.NVARCHAR, 669 "NVARCHAR2": TokenType.NVARCHAR, 670 "STR": TokenType.TEXT, 671 "STRING": TokenType.TEXT, 672 "TEXT": TokenType.TEXT, 673 "CLOB": TokenType.TEXT, 674 "LONGVARCHAR": TokenType.TEXT, 675 "BINARY": TokenType.BINARY, 676 "BLOB": TokenType.VARBINARY, 677 "BYTEA": TokenType.VARBINARY, 678 "VARBINARY": TokenType.VARBINARY, 679 "TIME": TokenType.TIME, 680 "TIMESTAMP": TokenType.TIMESTAMP, 681 "TIMESTAMPTZ": TokenType.TIMESTAMPTZ, 682 "TIMESTAMPLTZ": TokenType.TIMESTAMPLTZ, 683 "DATE": TokenType.DATE, 684 "DATETIME": TokenType.DATETIME, 685 "UNIQUE": TokenType.UNIQUE, 686 "STRUCT": TokenType.STRUCT, 687 "VARIANT": TokenType.VARIANT, 688 "ALTER": TokenType.ALTER, 689 "ALTER AGGREGATE": TokenType.COMMAND, 690 "ALTER DEFAULT": TokenType.COMMAND, 691 "ALTER DOMAIN": TokenType.COMMAND, 692 "ALTER ROLE": TokenType.COMMAND, 693 "ALTER RULE": TokenType.COMMAND, 694 "ALTER SEQUENCE": TokenType.COMMAND, 695 "ALTER TYPE": TokenType.COMMAND, 696 "ALTER USER": TokenType.COMMAND, 697 "ALTER VIEW": TokenType.COMMAND, 698 "ANALYZE": TokenType.COMMAND, 699 "CALL": TokenType.COMMAND, 700 "COPY": TokenType.COMMAND, 701 "EXPLAIN": TokenType.COMMAND, 702 "OPTIMIZE": TokenType.COMMAND, 703 "PREPARE": TokenType.COMMAND, 704 "TRUNCATE": TokenType.COMMAND, 705 "VACUUM": TokenType.COMMAND, 706 } 707 708 WHITE_SPACE = { 709 " ": TokenType.SPACE, 710 "\t": TokenType.SPACE, 711 "\n": TokenType.BREAK, 712 "\r": TokenType.BREAK, 713 "\r\n": TokenType.BREAK, 714 } 715 716 COMMANDS = { 717 TokenType.COMMAND, 718 TokenType.EXECUTE, 719 TokenType.FETCH, 720 TokenType.SET, 721 TokenType.SHOW, 722 } 723 724 COMMAND_PREFIX_TOKENS = {TokenType.SEMICOLON, TokenType.BEGIN} 725 726 # handle numeric literals like in hive (3L = BIGINT) 727 NUMERIC_LITERALS: t.Dict[str, str] = {} 728 ENCODE: t.Optional[str] = None 729 730 COMMENTS = ["--", ("/*", "*/")] 731 KEYWORD_TRIE = None # autofilled 732 733 IDENTIFIER_CAN_START_WITH_DIGIT = False 734 735 __slots__ = ( 736 "sql", 737 "size", 738 "tokens", 739 "_start", 740 "_current", 741 "_line", 742 "_col", 743 "_comments", 744 "_char", 745 "_end", 746 "_peek", 747 "_prev_token_line", 748 "_prev_token_comments", 749 "_prev_token_type", 750 "_replace_backslash", 751 ) 752 753 def __init__(self) -> None: 754 self._replace_backslash = "\\" in self._STRING_ESCAPES 755 self.reset() 756 757 def reset(self) -> None: 758 self.sql = "" 759 self.size = 0 760 self.tokens: t.List[Token] = [] 761 self._start = 0 762 self._current = 0 763 self._line = 1 764 self._col = 1 765 self._comments: t.List[str] = [] 766 767 self._char = None 768 self._end = None 769 self._peek = None 770 self._prev_token_line = -1 771 self._prev_token_comments: t.List[str] = [] 772 self._prev_token_type = None 773 774 def tokenize(self, sql: str) -> t.List[Token]: 775 """Returns a list of tokens corresponding to the SQL string `sql`.""" 776 self.reset() 777 self.sql = sql 778 self.size = len(sql) 779 self._scan() 780 return self.tokens 781 782 def _scan(self, until: t.Optional[t.Callable] = None) -> None: 783 while self.size and not self._end: 784 self._start = self._current 785 self._advance() 786 787 if not self._char: 788 break 789 790 white_space = self.WHITE_SPACE.get(self._char) # type: ignore 791 identifier_end = self._IDENTIFIERS.get(self._char) # type: ignore 792 793 if white_space: 794 if white_space == TokenType.BREAK: 795 self._col = 1 796 self._line += 1 797 elif self._char.isdigit(): # type:ignore 798 self._scan_number() 799 elif identifier_end: 800 self._scan_identifier(identifier_end) 801 else: 802 self._scan_keywords() 803 804 if until and until(): 805 break 806 807 def _chars(self, size: int) -> str: 808 if size == 1: 809 return self._char # type: ignore 810 start = self._current - 1 811 end = start + size 812 if end <= self.size: 813 return self.sql[start:end] 814 return "" 815 816 def _advance(self, i: int = 1) -> None: 817 self._col += i 818 self._current += i 819 self._end = self._current >= self.size # type: ignore 820 self._char = self.sql[self._current - 1] # type: ignore 821 self._peek = self.sql[self._current] if self._current < self.size else "" # type: ignore 822 823 @property 824 def _text(self) -> str: 825 return self.sql[self._start : self._current] 826 827 def _add(self, token_type: TokenType, text: t.Optional[str] = None) -> None: 828 self._prev_token_line = self._line 829 self._prev_token_comments = self._comments 830 self._prev_token_type = token_type # type: ignore 831 self.tokens.append( 832 Token( 833 token_type, 834 self._text if text is None else text, 835 self._line, 836 self._col, 837 self._comments, 838 ) 839 ) 840 self._comments = [] 841 842 # If we have either a semicolon or a begin token before the command's token, we'll parse 843 # whatever follows the command's token as a string 844 if token_type in self.COMMANDS and ( 845 len(self.tokens) == 1 or self.tokens[-2].token_type in self.COMMAND_PREFIX_TOKENS 846 ): 847 start = self._current 848 tokens = len(self.tokens) 849 self._scan(lambda: self._peek == ";") 850 self.tokens = self.tokens[:tokens] 851 text = self.sql[start : self._current].strip() 852 if text: 853 self._add(TokenType.STRING, text) 854 855 def _scan_keywords(self) -> None: 856 size = 0 857 word = None 858 chars = self._text 859 char = chars 860 prev_space = False 861 skip = False 862 trie = self.KEYWORD_TRIE 863 864 while chars: 865 if skip: 866 result = 1 867 else: 868 result, trie = in_trie(trie, char.upper()) # type: ignore 869 870 if result == 0: 871 break 872 if result == 2: 873 word = chars 874 size += 1 875 end = self._current - 1 + size 876 877 if end < self.size: 878 char = self.sql[end] 879 is_space = char in self.WHITE_SPACE 880 881 if not is_space or not prev_space: 882 if is_space: 883 char = " " 884 chars += char 885 prev_space = is_space 886 skip = False 887 else: 888 skip = True 889 else: 890 chars = None # type: ignore 891 892 if not word: 893 if self._char in self.SINGLE_TOKENS: 894 self._add(self.SINGLE_TOKENS[self._char]) # type: ignore 895 return 896 self._scan_var() 897 return 898 899 if self._scan_string(word): 900 return 901 if self._scan_formatted_string(word): 902 return 903 if self._scan_comment(word): 904 return 905 906 self._advance(size - 1) 907 self._add(self.KEYWORDS[word.upper()]) 908 909 def _scan_comment(self, comment_start: str) -> bool: 910 if comment_start not in self._COMMENTS: # type: ignore 911 return False 912 913 comment_start_line = self._line 914 comment_start_size = len(comment_start) 915 comment_end = self._COMMENTS[comment_start] # type: ignore 916 917 if comment_end: 918 comment_end_size = len(comment_end) 919 920 while not self._end and self._chars(comment_end_size) != comment_end: 921 self._advance() 922 923 self._comments.append(self._text[comment_start_size : -comment_end_size + 1]) # type: ignore 924 self._advance(comment_end_size - 1) 925 else: 926 while not self._end and self.WHITE_SPACE.get(self._peek) != TokenType.BREAK: # type: ignore 927 self._advance() 928 self._comments.append(self._text[comment_start_size:]) # type: ignore 929 930 # Leading comment is attached to the succeeding token, whilst trailing comment to the preceding. 931 # Multiple consecutive comments are preserved by appending them to the current comments list. 932 if comment_start_line == self._prev_token_line: 933 self.tokens[-1].comments.extend(self._comments) 934 self._comments = [] 935 936 return True 937 938 def _scan_number(self) -> None: 939 if self._char == "0": 940 peek = self._peek.upper() # type: ignore 941 if peek == "B": 942 return self._scan_bits() 943 elif peek == "X": 944 return self._scan_hex() 945 946 decimal = False 947 scientific = 0 948 949 while True: 950 if self._peek.isdigit(): # type: ignore 951 self._advance() 952 elif self._peek == "." and not decimal: 953 decimal = True 954 self._advance() 955 elif self._peek in ("-", "+") and scientific == 1: 956 scientific += 1 957 self._advance() 958 elif self._peek.upper() == "E" and not scientific: # type: ignore 959 scientific += 1 960 self._advance() 961 elif self._peek.isidentifier(): # type: ignore 962 number_text = self._text 963 literal = [] 964 965 while self._peek.strip() and self._peek not in self.SINGLE_TOKENS: # type: ignore 966 literal.append(self._peek.upper()) # type: ignore 967 self._advance() 968 969 literal = "".join(literal) # type: ignore 970 token_type = self.KEYWORDS.get(self.NUMERIC_LITERALS.get(literal)) # type: ignore 971 972 if token_type: 973 self._add(TokenType.NUMBER, number_text) 974 self._add(TokenType.DCOLON, "::") 975 return self._add(token_type, literal) # type: ignore 976 elif self.IDENTIFIER_CAN_START_WITH_DIGIT: 977 return self._add(TokenType.VAR) 978 979 self._add(TokenType.NUMBER, number_text) 980 return self._advance(-len(literal)) 981 else: 982 return self._add(TokenType.NUMBER) 983 984 def _scan_bits(self) -> None: 985 self._advance() 986 value = self._extract_value() 987 try: 988 self._add(TokenType.BIT_STRING, f"{int(value, 2)}") 989 except ValueError: 990 self._add(TokenType.IDENTIFIER) 991 992 def _scan_hex(self) -> None: 993 self._advance() 994 value = self._extract_value() 995 try: 996 self._add(TokenType.HEX_STRING, f"{int(value, 16)}") 997 except ValueError: 998 self._add(TokenType.IDENTIFIER) 999 1000 def _extract_value(self) -> str: 1001 while True: 1002 char = self._peek.strip() # type: ignore 1003 if char and char not in self.SINGLE_TOKENS: 1004 self._advance() 1005 else: 1006 break 1007 1008 return self._text 1009 1010 def _scan_string(self, quote: str) -> bool: 1011 quote_end = self._QUOTES.get(quote) # type: ignore 1012 if quote_end is None: 1013 return False 1014 1015 self._advance(len(quote)) 1016 text = self._extract_string(quote_end) 1017 text = text.encode(self.ENCODE).decode(self.ENCODE) if self.ENCODE else text # type: ignore 1018 text = text.replace("\\\\", "\\") if self._replace_backslash else text 1019 self._add(TokenType.NATIONAL if quote[0].upper() == "N" else TokenType.STRING, text) 1020 return True 1021 1022 # X'1234, b'0110', E'\\\\\' etc. 1023 def _scan_formatted_string(self, string_start: str) -> bool: 1024 if string_start in self._HEX_STRINGS: # type: ignore 1025 delimiters = self._HEX_STRINGS # type: ignore 1026 token_type = TokenType.HEX_STRING 1027 base = 16 1028 elif string_start in self._BIT_STRINGS: # type: ignore 1029 delimiters = self._BIT_STRINGS # type: ignore 1030 token_type = TokenType.BIT_STRING 1031 base = 2 1032 elif string_start in self._BYTE_STRINGS: # type: ignore 1033 delimiters = self._BYTE_STRINGS # type: ignore 1034 token_type = TokenType.BYTE_STRING 1035 base = None 1036 else: 1037 return False 1038 1039 self._advance(len(string_start)) 1040 string_end = delimiters.get(string_start) 1041 text = self._extract_string(string_end) 1042 1043 if base is None: 1044 self._add(token_type, text) 1045 else: 1046 try: 1047 self._add(token_type, f"{int(text, base)}") 1048 except: 1049 raise RuntimeError( 1050 f"Numeric string contains invalid characters from {self._line}:{self._start}" 1051 ) 1052 1053 return True 1054 1055 def _scan_identifier(self, identifier_end: str) -> None: 1056 text = "" 1057 identifier_end_is_escape = identifier_end in self._IDENTIFIER_ESCAPES 1058 1059 while True: 1060 if self._end: 1061 raise RuntimeError(f"Missing {identifier_end} from {self._line}:{self._start}") 1062 1063 self._advance() 1064 if self._char == identifier_end: 1065 if identifier_end_is_escape and self._peek == identifier_end: 1066 text += identifier_end # type: ignore 1067 self._advance() 1068 continue 1069 1070 break 1071 1072 text += self._char # type: ignore 1073 1074 self._add(TokenType.IDENTIFIER, text) 1075 1076 def _scan_var(self) -> None: 1077 while True: 1078 char = self._peek.strip() # type: ignore 1079 if char and char not in self.SINGLE_TOKENS: 1080 self._advance() 1081 else: 1082 break 1083 self._add( 1084 TokenType.VAR 1085 if self._prev_token_type == TokenType.PARAMETER 1086 else self.KEYWORDS.get(self._text.upper(), TokenType.VAR) 1087 ) 1088 1089 def _extract_string(self, delimiter: str) -> str: 1090 text = "" 1091 delim_size = len(delimiter) 1092 1093 while True: 1094 if ( 1095 self._char in self._STRING_ESCAPES 1096 and self._peek 1097 and (self._peek == delimiter or self._peek in self._STRING_ESCAPES) 1098 ): 1099 text += self._peek 1100 self._advance(2) 1101 else: 1102 if self._chars(delim_size) == delimiter: 1103 if delim_size > 1: 1104 self._advance(delim_size - 1) 1105 break 1106 1107 if self._end: 1108 raise RuntimeError(f"Missing {delimiter} from {self._line}:{self._start}") 1109 text += self._char # type: ignore 1110 self._advance() 1111 1112 return text
11class TokenType(AutoName): 12 L_PAREN = auto() 13 R_PAREN = auto() 14 L_BRACKET = auto() 15 R_BRACKET = auto() 16 L_BRACE = auto() 17 R_BRACE = auto() 18 COMMA = auto() 19 DOT = auto() 20 DASH = auto() 21 PLUS = auto() 22 COLON = auto() 23 DCOLON = auto() 24 SEMICOLON = auto() 25 STAR = auto() 26 BACKSLASH = auto() 27 SLASH = auto() 28 LT = auto() 29 LTE = auto() 30 GT = auto() 31 GTE = auto() 32 NOT = auto() 33 EQ = auto() 34 NEQ = auto() 35 NULLSAFE_EQ = auto() 36 AND = auto() 37 OR = auto() 38 AMP = auto() 39 DPIPE = auto() 40 PIPE = auto() 41 CARET = auto() 42 TILDA = auto() 43 ARROW = auto() 44 DARROW = auto() 45 FARROW = auto() 46 HASH = auto() 47 HASH_ARROW = auto() 48 DHASH_ARROW = auto() 49 LR_ARROW = auto() 50 DOLLAR = auto() 51 PARAMETER = auto() 52 SESSION_PARAMETER = auto() 53 NATIONAL = auto() 54 55 BLOCK_START = auto() 56 BLOCK_END = auto() 57 58 SPACE = auto() 59 BREAK = auto() 60 61 STRING = auto() 62 NUMBER = auto() 63 IDENTIFIER = auto() 64 COLUMN = auto() 65 COLUMN_DEF = auto() 66 SCHEMA = auto() 67 TABLE = auto() 68 VAR = auto() 69 BIT_STRING = auto() 70 HEX_STRING = auto() 71 BYTE_STRING = auto() 72 73 # types 74 BOOLEAN = auto() 75 TINYINT = auto() 76 SMALLINT = auto() 77 INT = auto() 78 BIGINT = auto() 79 FLOAT = auto() 80 DOUBLE = auto() 81 DECIMAL = auto() 82 CHAR = auto() 83 NCHAR = auto() 84 VARCHAR = auto() 85 NVARCHAR = auto() 86 TEXT = auto() 87 MEDIUMTEXT = auto() 88 LONGTEXT = auto() 89 MEDIUMBLOB = auto() 90 LONGBLOB = auto() 91 BINARY = auto() 92 VARBINARY = auto() 93 JSON = auto() 94 JSONB = auto() 95 TIME = auto() 96 TIMESTAMP = auto() 97 TIMESTAMPTZ = auto() 98 TIMESTAMPLTZ = auto() 99 DATETIME = auto() 100 DATE = auto() 101 UUID = auto() 102 GEOGRAPHY = auto() 103 NULLABLE = auto() 104 GEOMETRY = auto() 105 HLLSKETCH = auto() 106 HSTORE = auto() 107 SUPER = auto() 108 SERIAL = auto() 109 SMALLSERIAL = auto() 110 BIGSERIAL = auto() 111 XML = auto() 112 UNIQUEIDENTIFIER = auto() 113 MONEY = auto() 114 SMALLMONEY = auto() 115 ROWVERSION = auto() 116 IMAGE = auto() 117 VARIANT = auto() 118 OBJECT = auto() 119 120 # keywords 121 ALIAS = auto() 122 ALTER = auto() 123 ALWAYS = auto() 124 ALL = auto() 125 ANTI = auto() 126 ANY = auto() 127 APPLY = auto() 128 ARRAY = auto() 129 ASC = auto() 130 ASOF = auto() 131 AT_TIME_ZONE = auto() 132 AUTO_INCREMENT = auto() 133 BEGIN = auto() 134 BETWEEN = auto() 135 BOTH = auto() 136 BUCKET = auto() 137 BY_DEFAULT = auto() 138 CACHE = auto() 139 CASCADE = auto() 140 CASE = auto() 141 CHARACTER_SET = auto() 142 CHECK = auto() 143 CLUSTER_BY = auto() 144 COLLATE = auto() 145 COMMAND = auto() 146 COMMENT = auto() 147 COMMIT = auto() 148 COMPOUND = auto() 149 CONSTRAINT = auto() 150 CREATE = auto() 151 CROSS = auto() 152 CUBE = auto() 153 CURRENT_DATE = auto() 154 CURRENT_DATETIME = auto() 155 CURRENT_ROW = auto() 156 CURRENT_TIME = auto() 157 CURRENT_TIMESTAMP = auto() 158 DEFAULT = auto() 159 DELETE = auto() 160 DESC = auto() 161 DESCRIBE = auto() 162 DISTINCT = auto() 163 DISTINCT_FROM = auto() 164 DISTRIBUTE_BY = auto() 165 DIV = auto() 166 DROP = auto() 167 ELSE = auto() 168 ENCODE = auto() 169 END = auto() 170 ESCAPE = auto() 171 EXCEPT = auto() 172 EXECUTE = auto() 173 EXISTS = auto() 174 FALSE = auto() 175 FETCH = auto() 176 FILTER = auto() 177 FINAL = auto() 178 FIRST = auto() 179 FOLLOWING = auto() 180 FOR = auto() 181 FOREIGN_KEY = auto() 182 FORMAT = auto() 183 FROM = auto() 184 FULL = auto() 185 FUNCTION = auto() 186 GENERATED = auto() 187 GLOB = auto() 188 GLOBAL = auto() 189 GROUP_BY = auto() 190 GROUPING_SETS = auto() 191 HAVING = auto() 192 HINT = auto() 193 IDENTITY = auto() 194 IF = auto() 195 IGNORE_NULLS = auto() 196 ILIKE = auto() 197 IN = auto() 198 INDEX = auto() 199 INNER = auto() 200 INSERT = auto() 201 INTERSECT = auto() 202 INTERVAL = auto() 203 INTO = auto() 204 INTRODUCER = auto() 205 IRLIKE = auto() 206 IS = auto() 207 ISNULL = auto() 208 JOIN = auto() 209 LANGUAGE = auto() 210 LATERAL = auto() 211 LAZY = auto() 212 LEADING = auto() 213 LEFT = auto() 214 LIKE = auto() 215 LIMIT = auto() 216 LOAD_DATA = auto() 217 LOCAL = auto() 218 MAP = auto() 219 MATCH_RECOGNIZE = auto() 220 MATERIALIZED = auto() 221 MERGE = auto() 222 MOD = auto() 223 NATURAL = auto() 224 NEXT = auto() 225 NO_ACTION = auto() 226 NOTNULL = auto() 227 NULL = auto() 228 NULLS_FIRST = auto() 229 NULLS_LAST = auto() 230 OFFSET = auto() 231 ON = auto() 232 ONLY = auto() 233 OPTIONS = auto() 234 ORDER_BY = auto() 235 ORDERED = auto() 236 ORDINALITY = auto() 237 OUTER = auto() 238 OUT_OF = auto() 239 OVER = auto() 240 OVERWRITE = auto() 241 PARTITION = auto() 242 PARTITION_BY = auto() 243 PERCENT = auto() 244 PIVOT = auto() 245 PLACEHOLDER = auto() 246 PRECEDING = auto() 247 PRIMARY_KEY = auto() 248 PROCEDURE = auto() 249 PROPERTIES = auto() 250 PSEUDO_TYPE = auto() 251 QUALIFY = auto() 252 QUOTE = auto() 253 RANGE = auto() 254 RECURSIVE = auto() 255 REPLACE = auto() 256 RESPECT_NULLS = auto() 257 REFERENCES = auto() 258 RIGHT = auto() 259 RLIKE = auto() 260 ROLLBACK = auto() 261 ROLLUP = auto() 262 ROW = auto() 263 ROWS = auto() 264 SCHEMA_COMMENT = auto() 265 SEED = auto() 266 SELECT = auto() 267 SEMI = auto() 268 SEPARATOR = auto() 269 SERDE_PROPERTIES = auto() 270 SET = auto() 271 SHOW = auto() 272 SIMILAR_TO = auto() 273 SOME = auto() 274 SORTKEY = auto() 275 SORT_BY = auto() 276 STRUCT = auto() 277 TABLE_SAMPLE = auto() 278 TEMPORARY = auto() 279 TOP = auto() 280 THEN = auto() 281 TRAILING = auto() 282 TRUE = auto() 283 UNBOUNDED = auto() 284 UNCACHE = auto() 285 UNION = auto() 286 UNLOGGED = auto() 287 UNNEST = auto() 288 UNPIVOT = auto() 289 UPDATE = auto() 290 USE = auto() 291 USING = auto() 292 VALUES = auto() 293 VIEW = auto() 294 VOLATILE = auto() 295 WHEN = auto() 296 WHERE = auto() 297 WINDOW = auto() 298 WITH = auto() 299 WITH_TIME_ZONE = auto() 300 WITH_LOCAL_TIME_ZONE = auto() 301 WITHIN_GROUP = auto() 302 WITHOUT_TIME_ZONE = auto() 303 UNIQUE = auto()
An enumeration.
L_PAREN = <TokenType.L_PAREN: 'L_PAREN'>
R_PAREN = <TokenType.R_PAREN: 'R_PAREN'>
L_BRACKET = <TokenType.L_BRACKET: 'L_BRACKET'>
R_BRACKET = <TokenType.R_BRACKET: 'R_BRACKET'>
L_BRACE = <TokenType.L_BRACE: 'L_BRACE'>
R_BRACE = <TokenType.R_BRACE: 'R_BRACE'>
COMMA = <TokenType.COMMA: 'COMMA'>
DOT = <TokenType.DOT: 'DOT'>
DASH = <TokenType.DASH: 'DASH'>
PLUS = <TokenType.PLUS: 'PLUS'>
COLON = <TokenType.COLON: 'COLON'>
DCOLON = <TokenType.DCOLON: 'DCOLON'>
SEMICOLON = <TokenType.SEMICOLON: 'SEMICOLON'>
STAR = <TokenType.STAR: 'STAR'>
BACKSLASH = <TokenType.BACKSLASH: 'BACKSLASH'>
SLASH = <TokenType.SLASH: 'SLASH'>
LT = <TokenType.LT: 'LT'>
LTE = <TokenType.LTE: 'LTE'>
GT = <TokenType.GT: 'GT'>
GTE = <TokenType.GTE: 'GTE'>
NOT = <TokenType.NOT: 'NOT'>
EQ = <TokenType.EQ: 'EQ'>
NEQ = <TokenType.NEQ: 'NEQ'>
NULLSAFE_EQ = <TokenType.NULLSAFE_EQ: 'NULLSAFE_EQ'>
AND = <TokenType.AND: 'AND'>
OR = <TokenType.OR: 'OR'>
AMP = <TokenType.AMP: 'AMP'>
DPIPE = <TokenType.DPIPE: 'DPIPE'>
PIPE = <TokenType.PIPE: 'PIPE'>
CARET = <TokenType.CARET: 'CARET'>
TILDA = <TokenType.TILDA: 'TILDA'>
ARROW = <TokenType.ARROW: 'ARROW'>
DARROW = <TokenType.DARROW: 'DARROW'>
FARROW = <TokenType.FARROW: 'FARROW'>
HASH = <TokenType.HASH: 'HASH'>
HASH_ARROW = <TokenType.HASH_ARROW: 'HASH_ARROW'>
DHASH_ARROW = <TokenType.DHASH_ARROW: 'DHASH_ARROW'>
LR_ARROW = <TokenType.LR_ARROW: 'LR_ARROW'>
DOLLAR = <TokenType.DOLLAR: 'DOLLAR'>
PARAMETER = <TokenType.PARAMETER: 'PARAMETER'>
SESSION_PARAMETER = <TokenType.SESSION_PARAMETER: 'SESSION_PARAMETER'>
NATIONAL = <TokenType.NATIONAL: 'NATIONAL'>
BLOCK_START = <TokenType.BLOCK_START: 'BLOCK_START'>
BLOCK_END = <TokenType.BLOCK_END: 'BLOCK_END'>
SPACE = <TokenType.SPACE: 'SPACE'>
BREAK = <TokenType.BREAK: 'BREAK'>
STRING = <TokenType.STRING: 'STRING'>
NUMBER = <TokenType.NUMBER: 'NUMBER'>
IDENTIFIER = <TokenType.IDENTIFIER: 'IDENTIFIER'>
COLUMN = <TokenType.COLUMN: 'COLUMN'>
COLUMN_DEF = <TokenType.COLUMN_DEF: 'COLUMN_DEF'>
SCHEMA = <TokenType.SCHEMA: 'SCHEMA'>
TABLE = <TokenType.TABLE: 'TABLE'>
VAR = <TokenType.VAR: 'VAR'>
BIT_STRING = <TokenType.BIT_STRING: 'BIT_STRING'>
HEX_STRING = <TokenType.HEX_STRING: 'HEX_STRING'>
BYTE_STRING = <TokenType.BYTE_STRING: 'BYTE_STRING'>
BOOLEAN = <TokenType.BOOLEAN: 'BOOLEAN'>
TINYINT = <TokenType.TINYINT: 'TINYINT'>
SMALLINT = <TokenType.SMALLINT: 'SMALLINT'>
INT = <TokenType.INT: 'INT'>
BIGINT = <TokenType.BIGINT: 'BIGINT'>
FLOAT = <TokenType.FLOAT: 'FLOAT'>
DOUBLE = <TokenType.DOUBLE: 'DOUBLE'>
DECIMAL = <TokenType.DECIMAL: 'DECIMAL'>
CHAR = <TokenType.CHAR: 'CHAR'>
NCHAR = <TokenType.NCHAR: 'NCHAR'>
VARCHAR = <TokenType.VARCHAR: 'VARCHAR'>
NVARCHAR = <TokenType.NVARCHAR: 'NVARCHAR'>
TEXT = <TokenType.TEXT: 'TEXT'>
MEDIUMTEXT = <TokenType.MEDIUMTEXT: 'MEDIUMTEXT'>
LONGTEXT = <TokenType.LONGTEXT: 'LONGTEXT'>
MEDIUMBLOB = <TokenType.MEDIUMBLOB: 'MEDIUMBLOB'>
LONGBLOB = <TokenType.LONGBLOB: 'LONGBLOB'>
BINARY = <TokenType.BINARY: 'BINARY'>
VARBINARY = <TokenType.VARBINARY: 'VARBINARY'>
JSON = <TokenType.JSON: 'JSON'>
JSONB = <TokenType.JSONB: 'JSONB'>
TIME = <TokenType.TIME: 'TIME'>
TIMESTAMP = <TokenType.TIMESTAMP: 'TIMESTAMP'>
TIMESTAMPTZ = <TokenType.TIMESTAMPTZ: 'TIMESTAMPTZ'>
TIMESTAMPLTZ = <TokenType.TIMESTAMPLTZ: 'TIMESTAMPLTZ'>
DATETIME = <TokenType.DATETIME: 'DATETIME'>
DATE = <TokenType.DATE: 'DATE'>
UUID = <TokenType.UUID: 'UUID'>
GEOGRAPHY = <TokenType.GEOGRAPHY: 'GEOGRAPHY'>
NULLABLE = <TokenType.NULLABLE: 'NULLABLE'>
GEOMETRY = <TokenType.GEOMETRY: 'GEOMETRY'>
HLLSKETCH = <TokenType.HLLSKETCH: 'HLLSKETCH'>
HSTORE = <TokenType.HSTORE: 'HSTORE'>
SUPER = <TokenType.SUPER: 'SUPER'>
SERIAL = <TokenType.SERIAL: 'SERIAL'>
SMALLSERIAL = <TokenType.SMALLSERIAL: 'SMALLSERIAL'>
BIGSERIAL = <TokenType.BIGSERIAL: 'BIGSERIAL'>
XML = <TokenType.XML: 'XML'>
UNIQUEIDENTIFIER = <TokenType.UNIQUEIDENTIFIER: 'UNIQUEIDENTIFIER'>
MONEY = <TokenType.MONEY: 'MONEY'>
SMALLMONEY = <TokenType.SMALLMONEY: 'SMALLMONEY'>
ROWVERSION = <TokenType.ROWVERSION: 'ROWVERSION'>
IMAGE = <TokenType.IMAGE: 'IMAGE'>
VARIANT = <TokenType.VARIANT: 'VARIANT'>
OBJECT = <TokenType.OBJECT: 'OBJECT'>
ALIAS = <TokenType.ALIAS: 'ALIAS'>
ALTER = <TokenType.ALTER: 'ALTER'>
ALWAYS = <TokenType.ALWAYS: 'ALWAYS'>
ALL = <TokenType.ALL: 'ALL'>
ANTI = <TokenType.ANTI: 'ANTI'>
ANY = <TokenType.ANY: 'ANY'>
APPLY = <TokenType.APPLY: 'APPLY'>
ARRAY = <TokenType.ARRAY: 'ARRAY'>
ASC = <TokenType.ASC: 'ASC'>
ASOF = <TokenType.ASOF: 'ASOF'>
AT_TIME_ZONE = <TokenType.AT_TIME_ZONE: 'AT_TIME_ZONE'>
AUTO_INCREMENT = <TokenType.AUTO_INCREMENT: 'AUTO_INCREMENT'>
BEGIN = <TokenType.BEGIN: 'BEGIN'>
BETWEEN = <TokenType.BETWEEN: 'BETWEEN'>
BOTH = <TokenType.BOTH: 'BOTH'>
BUCKET = <TokenType.BUCKET: 'BUCKET'>
BY_DEFAULT = <TokenType.BY_DEFAULT: 'BY_DEFAULT'>
CACHE = <TokenType.CACHE: 'CACHE'>
CASCADE = <TokenType.CASCADE: 'CASCADE'>
CASE = <TokenType.CASE: 'CASE'>
CHARACTER_SET = <TokenType.CHARACTER_SET: 'CHARACTER_SET'>
CHECK = <TokenType.CHECK: 'CHECK'>
CLUSTER_BY = <TokenType.CLUSTER_BY: 'CLUSTER_BY'>
COLLATE = <TokenType.COLLATE: 'COLLATE'>
COMMAND = <TokenType.COMMAND: 'COMMAND'>
COMMENT = <TokenType.COMMENT: 'COMMENT'>
COMMIT = <TokenType.COMMIT: 'COMMIT'>
COMPOUND = <TokenType.COMPOUND: 'COMPOUND'>
CONSTRAINT = <TokenType.CONSTRAINT: 'CONSTRAINT'>
CREATE = <TokenType.CREATE: 'CREATE'>
CROSS = <TokenType.CROSS: 'CROSS'>
CUBE = <TokenType.CUBE: 'CUBE'>
CURRENT_DATE = <TokenType.CURRENT_DATE: 'CURRENT_DATE'>
CURRENT_DATETIME = <TokenType.CURRENT_DATETIME: 'CURRENT_DATETIME'>
CURRENT_ROW = <TokenType.CURRENT_ROW: 'CURRENT_ROW'>
CURRENT_TIME = <TokenType.CURRENT_TIME: 'CURRENT_TIME'>
CURRENT_TIMESTAMP = <TokenType.CURRENT_TIMESTAMP: 'CURRENT_TIMESTAMP'>
DEFAULT = <TokenType.DEFAULT: 'DEFAULT'>
DELETE = <TokenType.DELETE: 'DELETE'>
DESC = <TokenType.DESC: 'DESC'>
DESCRIBE = <TokenType.DESCRIBE: 'DESCRIBE'>
DISTINCT = <TokenType.DISTINCT: 'DISTINCT'>
DISTINCT_FROM = <TokenType.DISTINCT_FROM: 'DISTINCT_FROM'>
DISTRIBUTE_BY = <TokenType.DISTRIBUTE_BY: 'DISTRIBUTE_BY'>
DIV = <TokenType.DIV: 'DIV'>
DROP = <TokenType.DROP: 'DROP'>
ELSE = <TokenType.ELSE: 'ELSE'>
ENCODE = <TokenType.ENCODE: 'ENCODE'>
END = <TokenType.END: 'END'>
ESCAPE = <TokenType.ESCAPE: 'ESCAPE'>
EXCEPT = <TokenType.EXCEPT: 'EXCEPT'>
EXECUTE = <TokenType.EXECUTE: 'EXECUTE'>
EXISTS = <TokenType.EXISTS: 'EXISTS'>
FALSE = <TokenType.FALSE: 'FALSE'>
FETCH = <TokenType.FETCH: 'FETCH'>
FILTER = <TokenType.FILTER: 'FILTER'>
FINAL = <TokenType.FINAL: 'FINAL'>
FIRST = <TokenType.FIRST: 'FIRST'>
FOLLOWING = <TokenType.FOLLOWING: 'FOLLOWING'>
FOR = <TokenType.FOR: 'FOR'>
FOREIGN_KEY = <TokenType.FOREIGN_KEY: 'FOREIGN_KEY'>
FORMAT = <TokenType.FORMAT: 'FORMAT'>
FROM = <TokenType.FROM: 'FROM'>
FULL = <TokenType.FULL: 'FULL'>
FUNCTION = <TokenType.FUNCTION: 'FUNCTION'>
GENERATED = <TokenType.GENERATED: 'GENERATED'>
GLOB = <TokenType.GLOB: 'GLOB'>
GLOBAL = <TokenType.GLOBAL: 'GLOBAL'>
GROUP_BY = <TokenType.GROUP_BY: 'GROUP_BY'>
GROUPING_SETS = <TokenType.GROUPING_SETS: 'GROUPING_SETS'>
HAVING = <TokenType.HAVING: 'HAVING'>
HINT = <TokenType.HINT: 'HINT'>
IDENTITY = <TokenType.IDENTITY: 'IDENTITY'>
IF = <TokenType.IF: 'IF'>
IGNORE_NULLS = <TokenType.IGNORE_NULLS: 'IGNORE_NULLS'>
ILIKE = <TokenType.ILIKE: 'ILIKE'>
IN = <TokenType.IN: 'IN'>
INDEX = <TokenType.INDEX: 'INDEX'>
INNER = <TokenType.INNER: 'INNER'>
INSERT = <TokenType.INSERT: 'INSERT'>
INTERSECT = <TokenType.INTERSECT: 'INTERSECT'>
INTERVAL = <TokenType.INTERVAL: 'INTERVAL'>
INTO = <TokenType.INTO: 'INTO'>
INTRODUCER = <TokenType.INTRODUCER: 'INTRODUCER'>
IRLIKE = <TokenType.IRLIKE: 'IRLIKE'>
IS = <TokenType.IS: 'IS'>
ISNULL = <TokenType.ISNULL: 'ISNULL'>
JOIN = <TokenType.JOIN: 'JOIN'>
LANGUAGE = <TokenType.LANGUAGE: 'LANGUAGE'>
LATERAL = <TokenType.LATERAL: 'LATERAL'>
LAZY = <TokenType.LAZY: 'LAZY'>
LEADING = <TokenType.LEADING: 'LEADING'>
LEFT = <TokenType.LEFT: 'LEFT'>
LIKE = <TokenType.LIKE: 'LIKE'>
LIMIT = <TokenType.LIMIT: 'LIMIT'>
LOAD_DATA = <TokenType.LOAD_DATA: 'LOAD_DATA'>
LOCAL = <TokenType.LOCAL: 'LOCAL'>
MAP = <TokenType.MAP: 'MAP'>
MATCH_RECOGNIZE = <TokenType.MATCH_RECOGNIZE: 'MATCH_RECOGNIZE'>
MATERIALIZED = <TokenType.MATERIALIZED: 'MATERIALIZED'>
MERGE = <TokenType.MERGE: 'MERGE'>
MOD = <TokenType.MOD: 'MOD'>
NATURAL = <TokenType.NATURAL: 'NATURAL'>
NEXT = <TokenType.NEXT: 'NEXT'>
NO_ACTION = <TokenType.NO_ACTION: 'NO_ACTION'>
NOTNULL = <TokenType.NOTNULL: 'NOTNULL'>
NULL = <TokenType.NULL: 'NULL'>
NULLS_FIRST = <TokenType.NULLS_FIRST: 'NULLS_FIRST'>
NULLS_LAST = <TokenType.NULLS_LAST: 'NULLS_LAST'>
OFFSET = <TokenType.OFFSET: 'OFFSET'>
ON = <TokenType.ON: 'ON'>
ONLY = <TokenType.ONLY: 'ONLY'>
OPTIONS = <TokenType.OPTIONS: 'OPTIONS'>
ORDER_BY = <TokenType.ORDER_BY: 'ORDER_BY'>
ORDERED = <TokenType.ORDERED: 'ORDERED'>
ORDINALITY = <TokenType.ORDINALITY: 'ORDINALITY'>
OUTER = <TokenType.OUTER: 'OUTER'>
OUT_OF = <TokenType.OUT_OF: 'OUT_OF'>
OVER = <TokenType.OVER: 'OVER'>
OVERWRITE = <TokenType.OVERWRITE: 'OVERWRITE'>
PARTITION = <TokenType.PARTITION: 'PARTITION'>
PARTITION_BY = <TokenType.PARTITION_BY: 'PARTITION_BY'>
PERCENT = <TokenType.PERCENT: 'PERCENT'>
PIVOT = <TokenType.PIVOT: 'PIVOT'>
PLACEHOLDER = <TokenType.PLACEHOLDER: 'PLACEHOLDER'>
PRECEDING = <TokenType.PRECEDING: 'PRECEDING'>
PRIMARY_KEY = <TokenType.PRIMARY_KEY: 'PRIMARY_KEY'>
PROCEDURE = <TokenType.PROCEDURE: 'PROCEDURE'>
PROPERTIES = <TokenType.PROPERTIES: 'PROPERTIES'>
PSEUDO_TYPE = <TokenType.PSEUDO_TYPE: 'PSEUDO_TYPE'>
QUALIFY = <TokenType.QUALIFY: 'QUALIFY'>
QUOTE = <TokenType.QUOTE: 'QUOTE'>
RANGE = <TokenType.RANGE: 'RANGE'>
RECURSIVE = <TokenType.RECURSIVE: 'RECURSIVE'>
REPLACE = <TokenType.REPLACE: 'REPLACE'>
RESPECT_NULLS = <TokenType.RESPECT_NULLS: 'RESPECT_NULLS'>
REFERENCES = <TokenType.REFERENCES: 'REFERENCES'>
RIGHT = <TokenType.RIGHT: 'RIGHT'>
RLIKE = <TokenType.RLIKE: 'RLIKE'>
ROLLBACK = <TokenType.ROLLBACK: 'ROLLBACK'>
ROLLUP = <TokenType.ROLLUP: 'ROLLUP'>
ROW = <TokenType.ROW: 'ROW'>
ROWS = <TokenType.ROWS: 'ROWS'>
SCHEMA_COMMENT = <TokenType.SCHEMA_COMMENT: 'SCHEMA_COMMENT'>
SEED = <TokenType.SEED: 'SEED'>
SELECT = <TokenType.SELECT: 'SELECT'>
SEMI = <TokenType.SEMI: 'SEMI'>
SEPARATOR = <TokenType.SEPARATOR: 'SEPARATOR'>
SERDE_PROPERTIES = <TokenType.SERDE_PROPERTIES: 'SERDE_PROPERTIES'>
SET = <TokenType.SET: 'SET'>
SHOW = <TokenType.SHOW: 'SHOW'>
SIMILAR_TO = <TokenType.SIMILAR_TO: 'SIMILAR_TO'>
SOME = <TokenType.SOME: 'SOME'>
SORTKEY = <TokenType.SORTKEY: 'SORTKEY'>
SORT_BY = <TokenType.SORT_BY: 'SORT_BY'>
STRUCT = <TokenType.STRUCT: 'STRUCT'>
TABLE_SAMPLE = <TokenType.TABLE_SAMPLE: 'TABLE_SAMPLE'>
TEMPORARY = <TokenType.TEMPORARY: 'TEMPORARY'>
TOP = <TokenType.TOP: 'TOP'>
THEN = <TokenType.THEN: 'THEN'>
TRAILING = <TokenType.TRAILING: 'TRAILING'>
TRUE = <TokenType.TRUE: 'TRUE'>
UNBOUNDED = <TokenType.UNBOUNDED: 'UNBOUNDED'>
UNCACHE = <TokenType.UNCACHE: 'UNCACHE'>
UNION = <TokenType.UNION: 'UNION'>
UNLOGGED = <TokenType.UNLOGGED: 'UNLOGGED'>
UNNEST = <TokenType.UNNEST: 'UNNEST'>
UNPIVOT = <TokenType.UNPIVOT: 'UNPIVOT'>
UPDATE = <TokenType.UPDATE: 'UPDATE'>
USE = <TokenType.USE: 'USE'>
USING = <TokenType.USING: 'USING'>
VALUES = <TokenType.VALUES: 'VALUES'>
VIEW = <TokenType.VIEW: 'VIEW'>
VOLATILE = <TokenType.VOLATILE: 'VOLATILE'>
WHEN = <TokenType.WHEN: 'WHEN'>
WHERE = <TokenType.WHERE: 'WHERE'>
WINDOW = <TokenType.WINDOW: 'WINDOW'>
WITH = <TokenType.WITH: 'WITH'>
WITH_TIME_ZONE = <TokenType.WITH_TIME_ZONE: 'WITH_TIME_ZONE'>
WITH_LOCAL_TIME_ZONE = <TokenType.WITH_LOCAL_TIME_ZONE: 'WITH_LOCAL_TIME_ZONE'>
WITHIN_GROUP = <TokenType.WITHIN_GROUP: 'WITHIN_GROUP'>
WITHOUT_TIME_ZONE = <TokenType.WITHOUT_TIME_ZONE: 'WITHOUT_TIME_ZONE'>
UNIQUE = <TokenType.UNIQUE: 'UNIQUE'>
Inherited Members
- enum.Enum
- name
- value
class
Token:
306class Token: 307 __slots__ = ("token_type", "text", "line", "col", "comments") 308 309 @classmethod 310 def number(cls, number: int) -> Token: 311 """Returns a NUMBER token with `number` as its text.""" 312 return cls(TokenType.NUMBER, str(number)) 313 314 @classmethod 315 def string(cls, string: str) -> Token: 316 """Returns a STRING token with `string` as its text.""" 317 return cls(TokenType.STRING, string) 318 319 @classmethod 320 def identifier(cls, identifier: str) -> Token: 321 """Returns an IDENTIFIER token with `identifier` as its text.""" 322 return cls(TokenType.IDENTIFIER, identifier) 323 324 @classmethod 325 def var(cls, var: str) -> Token: 326 """Returns an VAR token with `var` as its text.""" 327 return cls(TokenType.VAR, var) 328 329 def __init__( 330 self, 331 token_type: TokenType, 332 text: str, 333 line: int = 1, 334 col: int = 1, 335 comments: t.List[str] = [], 336 ) -> None: 337 self.token_type = token_type 338 self.text = text 339 self.line = line 340 self.col = max(col - len(text), 1) 341 self.comments = comments 342 343 def __repr__(self) -> str: 344 attributes = ", ".join(f"{k}: {getattr(self, k)}" for k in self.__slots__) 345 return f"<Token {attributes}>"
Token( token_type: sqlglot.tokens.TokenType, text: str, line: int = 1, col: int = 1, comments: List[str] = [])
309 @classmethod 310 def number(cls, number: int) -> Token: 311 """Returns a NUMBER token with `number` as its text.""" 312 return cls(TokenType.NUMBER, str(number))
Returns a NUMBER token with number
as its text.
314 @classmethod 315 def string(cls, string: str) -> Token: 316 """Returns a STRING token with `string` as its text.""" 317 return cls(TokenType.STRING, string)
Returns a STRING token with string
as its text.
319 @classmethod 320 def identifier(cls, identifier: str) -> Token: 321 """Returns an IDENTIFIER token with `identifier` as its text.""" 322 return cls(TokenType.IDENTIFIER, identifier)
Returns an IDENTIFIER token with identifier
as its text.
class
Tokenizer:
388class Tokenizer(metaclass=_Tokenizer): 389 SINGLE_TOKENS = { 390 "(": TokenType.L_PAREN, 391 ")": TokenType.R_PAREN, 392 "[": TokenType.L_BRACKET, 393 "]": TokenType.R_BRACKET, 394 "{": TokenType.L_BRACE, 395 "}": TokenType.R_BRACE, 396 "&": TokenType.AMP, 397 "^": TokenType.CARET, 398 ":": TokenType.COLON, 399 ",": TokenType.COMMA, 400 ".": TokenType.DOT, 401 "-": TokenType.DASH, 402 "=": TokenType.EQ, 403 ">": TokenType.GT, 404 "<": TokenType.LT, 405 "%": TokenType.MOD, 406 "!": TokenType.NOT, 407 "|": TokenType.PIPE, 408 "+": TokenType.PLUS, 409 ";": TokenType.SEMICOLON, 410 "/": TokenType.SLASH, 411 "\\": TokenType.BACKSLASH, 412 "*": TokenType.STAR, 413 "~": TokenType.TILDA, 414 "?": TokenType.PLACEHOLDER, 415 "@": TokenType.PARAMETER, 416 # used for breaking a var like x'y' but nothing else 417 # the token type doesn't matter 418 "'": TokenType.QUOTE, 419 "`": TokenType.IDENTIFIER, 420 '"': TokenType.IDENTIFIER, 421 "#": TokenType.HASH, 422 } 423 424 QUOTES: t.List[t.Tuple[str, str] | str] = ["'"] 425 426 BIT_STRINGS: t.List[str | t.Tuple[str, str]] = [] 427 428 HEX_STRINGS: t.List[str | t.Tuple[str, str]] = [] 429 430 BYTE_STRINGS: t.List[str | t.Tuple[str, str]] = [] 431 432 IDENTIFIERS: t.List[str | t.Tuple[str, str]] = ['"'] 433 434 STRING_ESCAPES = ["'"] 435 436 _STRING_ESCAPES: t.Set[str] = set() 437 438 IDENTIFIER_ESCAPES = ['"'] 439 440 _IDENTIFIER_ESCAPES: t.Set[str] = set() 441 442 KEYWORDS = { 443 **{ 444 f"{key}{postfix}": TokenType.BLOCK_START 445 for key in ("{{", "{%", "{#") 446 for postfix in ("", "+", "-") 447 }, 448 **{ 449 f"{prefix}{key}": TokenType.BLOCK_END 450 for key in ("%}", "#}") 451 for prefix in ("", "+", "-") 452 }, 453 "+}}": TokenType.BLOCK_END, 454 "-}}": TokenType.BLOCK_END, 455 "/*+": TokenType.HINT, 456 "==": TokenType.EQ, 457 "::": TokenType.DCOLON, 458 "||": TokenType.DPIPE, 459 ">=": TokenType.GTE, 460 "<=": TokenType.LTE, 461 "<>": TokenType.NEQ, 462 "!=": TokenType.NEQ, 463 "<=>": TokenType.NULLSAFE_EQ, 464 "->": TokenType.ARROW, 465 "->>": TokenType.DARROW, 466 "=>": TokenType.FARROW, 467 "#>": TokenType.HASH_ARROW, 468 "#>>": TokenType.DHASH_ARROW, 469 "<->": TokenType.LR_ARROW, 470 "ALL": TokenType.ALL, 471 "ALWAYS": TokenType.ALWAYS, 472 "AND": TokenType.AND, 473 "ANTI": TokenType.ANTI, 474 "ANY": TokenType.ANY, 475 "ASC": TokenType.ASC, 476 "AS": TokenType.ALIAS, 477 "AT TIME ZONE": TokenType.AT_TIME_ZONE, 478 "AUTOINCREMENT": TokenType.AUTO_INCREMENT, 479 "AUTO_INCREMENT": TokenType.AUTO_INCREMENT, 480 "BEGIN": TokenType.BEGIN, 481 "BETWEEN": TokenType.BETWEEN, 482 "BOTH": TokenType.BOTH, 483 "BUCKET": TokenType.BUCKET, 484 "BY DEFAULT": TokenType.BY_DEFAULT, 485 "CACHE": TokenType.CACHE, 486 "UNCACHE": TokenType.UNCACHE, 487 "CASE": TokenType.CASE, 488 "CASCADE": TokenType.CASCADE, 489 "CHARACTER SET": TokenType.CHARACTER_SET, 490 "CHECK": TokenType.CHECK, 491 "CLUSTER BY": TokenType.CLUSTER_BY, 492 "COLLATE": TokenType.COLLATE, 493 "COLUMN": TokenType.COLUMN, 494 "COMMENT": TokenType.SCHEMA_COMMENT, 495 "COMMIT": TokenType.COMMIT, 496 "COMPOUND": TokenType.COMPOUND, 497 "CONSTRAINT": TokenType.CONSTRAINT, 498 "CREATE": TokenType.CREATE, 499 "CROSS": TokenType.CROSS, 500 "CUBE": TokenType.CUBE, 501 "CURRENT_DATE": TokenType.CURRENT_DATE, 502 "CURRENT ROW": TokenType.CURRENT_ROW, 503 "CURRENT_TIMESTAMP": TokenType.CURRENT_TIMESTAMP, 504 "DEFAULT": TokenType.DEFAULT, 505 "DELETE": TokenType.DELETE, 506 "DESC": TokenType.DESC, 507 "DESCRIBE": TokenType.DESCRIBE, 508 "DISTINCT": TokenType.DISTINCT, 509 "DISTINCT FROM": TokenType.DISTINCT_FROM, 510 "DISTRIBUTE BY": TokenType.DISTRIBUTE_BY, 511 "DIV": TokenType.DIV, 512 "DROP": TokenType.DROP, 513 "ELSE": TokenType.ELSE, 514 "END": TokenType.END, 515 "ESCAPE": TokenType.ESCAPE, 516 "EXCEPT": TokenType.EXCEPT, 517 "EXECUTE": TokenType.EXECUTE, 518 "EXISTS": TokenType.EXISTS, 519 "FALSE": TokenType.FALSE, 520 "FETCH": TokenType.FETCH, 521 "FILTER": TokenType.FILTER, 522 "FIRST": TokenType.FIRST, 523 "FULL": TokenType.FULL, 524 "FUNCTION": TokenType.FUNCTION, 525 "FOLLOWING": TokenType.FOLLOWING, 526 "FOR": TokenType.FOR, 527 "FOREIGN KEY": TokenType.FOREIGN_KEY, 528 "FORMAT": TokenType.FORMAT, 529 "FROM": TokenType.FROM, 530 "GENERATED": TokenType.GENERATED, 531 "GLOB": TokenType.GLOB, 532 "GROUP BY": TokenType.GROUP_BY, 533 "GROUPING SETS": TokenType.GROUPING_SETS, 534 "HAVING": TokenType.HAVING, 535 "IDENTITY": TokenType.IDENTITY, 536 "IF": TokenType.IF, 537 "ILIKE": TokenType.ILIKE, 538 "IGNORE NULLS": TokenType.IGNORE_NULLS, 539 "IN": TokenType.IN, 540 "INDEX": TokenType.INDEX, 541 "INNER": TokenType.INNER, 542 "INSERT": TokenType.INSERT, 543 "INTERVAL": TokenType.INTERVAL, 544 "INTERSECT": TokenType.INTERSECT, 545 "INTO": TokenType.INTO, 546 "IS": TokenType.IS, 547 "ISNULL": TokenType.ISNULL, 548 "JOIN": TokenType.JOIN, 549 "LATERAL": TokenType.LATERAL, 550 "LAZY": TokenType.LAZY, 551 "LEADING": TokenType.LEADING, 552 "LEFT": TokenType.LEFT, 553 "LIKE": TokenType.LIKE, 554 "LIMIT": TokenType.LIMIT, 555 "LOAD DATA": TokenType.LOAD_DATA, 556 "LOCAL": TokenType.LOCAL, 557 "MATERIALIZED": TokenType.MATERIALIZED, 558 "MERGE": TokenType.MERGE, 559 "NATURAL": TokenType.NATURAL, 560 "NEXT": TokenType.NEXT, 561 "NO ACTION": TokenType.NO_ACTION, 562 "NOT": TokenType.NOT, 563 "NOTNULL": TokenType.NOTNULL, 564 "NULL": TokenType.NULL, 565 "NULLS FIRST": TokenType.NULLS_FIRST, 566 "NULLS LAST": TokenType.NULLS_LAST, 567 "OBJECT": TokenType.OBJECT, 568 "OFFSET": TokenType.OFFSET, 569 "ON": TokenType.ON, 570 "ONLY": TokenType.ONLY, 571 "OPTIONS": TokenType.OPTIONS, 572 "OR": TokenType.OR, 573 "ORDER BY": TokenType.ORDER_BY, 574 "ORDINALITY": TokenType.ORDINALITY, 575 "OUTER": TokenType.OUTER, 576 "OUT OF": TokenType.OUT_OF, 577 "OVER": TokenType.OVER, 578 "OVERWRITE": TokenType.OVERWRITE, 579 "PARTITION": TokenType.PARTITION, 580 "PARTITION BY": TokenType.PARTITION_BY, 581 "PARTITIONED BY": TokenType.PARTITION_BY, 582 "PARTITIONED_BY": TokenType.PARTITION_BY, 583 "PERCENT": TokenType.PERCENT, 584 "PIVOT": TokenType.PIVOT, 585 "PRECEDING": TokenType.PRECEDING, 586 "PRIMARY KEY": TokenType.PRIMARY_KEY, 587 "PROCEDURE": TokenType.PROCEDURE, 588 "QUALIFY": TokenType.QUALIFY, 589 "RANGE": TokenType.RANGE, 590 "RECURSIVE": TokenType.RECURSIVE, 591 "REGEXP": TokenType.RLIKE, 592 "REPLACE": TokenType.REPLACE, 593 "RESPECT NULLS": TokenType.RESPECT_NULLS, 594 "REFERENCES": TokenType.REFERENCES, 595 "RIGHT": TokenType.RIGHT, 596 "RLIKE": TokenType.RLIKE, 597 "ROLLBACK": TokenType.ROLLBACK, 598 "ROLLUP": TokenType.ROLLUP, 599 "ROW": TokenType.ROW, 600 "ROWS": TokenType.ROWS, 601 "SCHEMA": TokenType.SCHEMA, 602 "SEED": TokenType.SEED, 603 "SELECT": TokenType.SELECT, 604 "SEMI": TokenType.SEMI, 605 "SET": TokenType.SET, 606 "SHOW": TokenType.SHOW, 607 "SIMILAR TO": TokenType.SIMILAR_TO, 608 "SOME": TokenType.SOME, 609 "SORTKEY": TokenType.SORTKEY, 610 "SORT BY": TokenType.SORT_BY, 611 "TABLE": TokenType.TABLE, 612 "TABLESAMPLE": TokenType.TABLE_SAMPLE, 613 "TEMP": TokenType.TEMPORARY, 614 "TEMPORARY": TokenType.TEMPORARY, 615 "THEN": TokenType.THEN, 616 "TRUE": TokenType.TRUE, 617 "TRAILING": TokenType.TRAILING, 618 "UNBOUNDED": TokenType.UNBOUNDED, 619 "UNION": TokenType.UNION, 620 "UNLOGGED": TokenType.UNLOGGED, 621 "UNNEST": TokenType.UNNEST, 622 "UNPIVOT": TokenType.UNPIVOT, 623 "UPDATE": TokenType.UPDATE, 624 "USE": TokenType.USE, 625 "USING": TokenType.USING, 626 "VALUES": TokenType.VALUES, 627 "VIEW": TokenType.VIEW, 628 "VOLATILE": TokenType.VOLATILE, 629 "WHEN": TokenType.WHEN, 630 "WHERE": TokenType.WHERE, 631 "WINDOW": TokenType.WINDOW, 632 "WITH": TokenType.WITH, 633 "WITH TIME ZONE": TokenType.WITH_TIME_ZONE, 634 "WITH LOCAL TIME ZONE": TokenType.WITH_LOCAL_TIME_ZONE, 635 "WITHIN GROUP": TokenType.WITHIN_GROUP, 636 "WITHOUT TIME ZONE": TokenType.WITHOUT_TIME_ZONE, 637 "APPLY": TokenType.APPLY, 638 "ARRAY": TokenType.ARRAY, 639 "BOOL": TokenType.BOOLEAN, 640 "BOOLEAN": TokenType.BOOLEAN, 641 "BYTE": TokenType.TINYINT, 642 "TINYINT": TokenType.TINYINT, 643 "SHORT": TokenType.SMALLINT, 644 "SMALLINT": TokenType.SMALLINT, 645 "INT2": TokenType.SMALLINT, 646 "INTEGER": TokenType.INT, 647 "INT": TokenType.INT, 648 "INT4": TokenType.INT, 649 "LONG": TokenType.BIGINT, 650 "BIGINT": TokenType.BIGINT, 651 "INT8": TokenType.BIGINT, 652 "DECIMAL": TokenType.DECIMAL, 653 "MAP": TokenType.MAP, 654 "NULLABLE": TokenType.NULLABLE, 655 "NUMBER": TokenType.DECIMAL, 656 "NUMERIC": TokenType.DECIMAL, 657 "FIXED": TokenType.DECIMAL, 658 "REAL": TokenType.FLOAT, 659 "FLOAT": TokenType.FLOAT, 660 "FLOAT4": TokenType.FLOAT, 661 "FLOAT8": TokenType.DOUBLE, 662 "DOUBLE": TokenType.DOUBLE, 663 "DOUBLE PRECISION": TokenType.DOUBLE, 664 "JSON": TokenType.JSON, 665 "CHAR": TokenType.CHAR, 666 "NCHAR": TokenType.NCHAR, 667 "VARCHAR": TokenType.VARCHAR, 668 "VARCHAR2": TokenType.VARCHAR, 669 "NVARCHAR": TokenType.NVARCHAR, 670 "NVARCHAR2": TokenType.NVARCHAR, 671 "STR": TokenType.TEXT, 672 "STRING": TokenType.TEXT, 673 "TEXT": TokenType.TEXT, 674 "CLOB": TokenType.TEXT, 675 "LONGVARCHAR": TokenType.TEXT, 676 "BINARY": TokenType.BINARY, 677 "BLOB": TokenType.VARBINARY, 678 "BYTEA": TokenType.VARBINARY, 679 "VARBINARY": TokenType.VARBINARY, 680 "TIME": TokenType.TIME, 681 "TIMESTAMP": TokenType.TIMESTAMP, 682 "TIMESTAMPTZ": TokenType.TIMESTAMPTZ, 683 "TIMESTAMPLTZ": TokenType.TIMESTAMPLTZ, 684 "DATE": TokenType.DATE, 685 "DATETIME": TokenType.DATETIME, 686 "UNIQUE": TokenType.UNIQUE, 687 "STRUCT": TokenType.STRUCT, 688 "VARIANT": TokenType.VARIANT, 689 "ALTER": TokenType.ALTER, 690 "ALTER AGGREGATE": TokenType.COMMAND, 691 "ALTER DEFAULT": TokenType.COMMAND, 692 "ALTER DOMAIN": TokenType.COMMAND, 693 "ALTER ROLE": TokenType.COMMAND, 694 "ALTER RULE": TokenType.COMMAND, 695 "ALTER SEQUENCE": TokenType.COMMAND, 696 "ALTER TYPE": TokenType.COMMAND, 697 "ALTER USER": TokenType.COMMAND, 698 "ALTER VIEW": TokenType.COMMAND, 699 "ANALYZE": TokenType.COMMAND, 700 "CALL": TokenType.COMMAND, 701 "COPY": TokenType.COMMAND, 702 "EXPLAIN": TokenType.COMMAND, 703 "OPTIMIZE": TokenType.COMMAND, 704 "PREPARE": TokenType.COMMAND, 705 "TRUNCATE": TokenType.COMMAND, 706 "VACUUM": TokenType.COMMAND, 707 } 708 709 WHITE_SPACE = { 710 " ": TokenType.SPACE, 711 "\t": TokenType.SPACE, 712 "\n": TokenType.BREAK, 713 "\r": TokenType.BREAK, 714 "\r\n": TokenType.BREAK, 715 } 716 717 COMMANDS = { 718 TokenType.COMMAND, 719 TokenType.EXECUTE, 720 TokenType.FETCH, 721 TokenType.SET, 722 TokenType.SHOW, 723 } 724 725 COMMAND_PREFIX_TOKENS = {TokenType.SEMICOLON, TokenType.BEGIN} 726 727 # handle numeric literals like in hive (3L = BIGINT) 728 NUMERIC_LITERALS: t.Dict[str, str] = {} 729 ENCODE: t.Optional[str] = None 730 731 COMMENTS = ["--", ("/*", "*/")] 732 KEYWORD_TRIE = None # autofilled 733 734 IDENTIFIER_CAN_START_WITH_DIGIT = False 735 736 __slots__ = ( 737 "sql", 738 "size", 739 "tokens", 740 "_start", 741 "_current", 742 "_line", 743 "_col", 744 "_comments", 745 "_char", 746 "_end", 747 "_peek", 748 "_prev_token_line", 749 "_prev_token_comments", 750 "_prev_token_type", 751 "_replace_backslash", 752 ) 753 754 def __init__(self) -> None: 755 self._replace_backslash = "\\" in self._STRING_ESCAPES 756 self.reset() 757 758 def reset(self) -> None: 759 self.sql = "" 760 self.size = 0 761 self.tokens: t.List[Token] = [] 762 self._start = 0 763 self._current = 0 764 self._line = 1 765 self._col = 1 766 self._comments: t.List[str] = [] 767 768 self._char = None 769 self._end = None 770 self._peek = None 771 self._prev_token_line = -1 772 self._prev_token_comments: t.List[str] = [] 773 self._prev_token_type = None 774 775 def tokenize(self, sql: str) -> t.List[Token]: 776 """Returns a list of tokens corresponding to the SQL string `sql`.""" 777 self.reset() 778 self.sql = sql 779 self.size = len(sql) 780 self._scan() 781 return self.tokens 782 783 def _scan(self, until: t.Optional[t.Callable] = None) -> None: 784 while self.size and not self._end: 785 self._start = self._current 786 self._advance() 787 788 if not self._char: 789 break 790 791 white_space = self.WHITE_SPACE.get(self._char) # type: ignore 792 identifier_end = self._IDENTIFIERS.get(self._char) # type: ignore 793 794 if white_space: 795 if white_space == TokenType.BREAK: 796 self._col = 1 797 self._line += 1 798 elif self._char.isdigit(): # type:ignore 799 self._scan_number() 800 elif identifier_end: 801 self._scan_identifier(identifier_end) 802 else: 803 self._scan_keywords() 804 805 if until and until(): 806 break 807 808 def _chars(self, size: int) -> str: 809 if size == 1: 810 return self._char # type: ignore 811 start = self._current - 1 812 end = start + size 813 if end <= self.size: 814 return self.sql[start:end] 815 return "" 816 817 def _advance(self, i: int = 1) -> None: 818 self._col += i 819 self._current += i 820 self._end = self._current >= self.size # type: ignore 821 self._char = self.sql[self._current - 1] # type: ignore 822 self._peek = self.sql[self._current] if self._current < self.size else "" # type: ignore 823 824 @property 825 def _text(self) -> str: 826 return self.sql[self._start : self._current] 827 828 def _add(self, token_type: TokenType, text: t.Optional[str] = None) -> None: 829 self._prev_token_line = self._line 830 self._prev_token_comments = self._comments 831 self._prev_token_type = token_type # type: ignore 832 self.tokens.append( 833 Token( 834 token_type, 835 self._text if text is None else text, 836 self._line, 837 self._col, 838 self._comments, 839 ) 840 ) 841 self._comments = [] 842 843 # If we have either a semicolon or a begin token before the command's token, we'll parse 844 # whatever follows the command's token as a string 845 if token_type in self.COMMANDS and ( 846 len(self.tokens) == 1 or self.tokens[-2].token_type in self.COMMAND_PREFIX_TOKENS 847 ): 848 start = self._current 849 tokens = len(self.tokens) 850 self._scan(lambda: self._peek == ";") 851 self.tokens = self.tokens[:tokens] 852 text = self.sql[start : self._current].strip() 853 if text: 854 self._add(TokenType.STRING, text) 855 856 def _scan_keywords(self) -> None: 857 size = 0 858 word = None 859 chars = self._text 860 char = chars 861 prev_space = False 862 skip = False 863 trie = self.KEYWORD_TRIE 864 865 while chars: 866 if skip: 867 result = 1 868 else: 869 result, trie = in_trie(trie, char.upper()) # type: ignore 870 871 if result == 0: 872 break 873 if result == 2: 874 word = chars 875 size += 1 876 end = self._current - 1 + size 877 878 if end < self.size: 879 char = self.sql[end] 880 is_space = char in self.WHITE_SPACE 881 882 if not is_space or not prev_space: 883 if is_space: 884 char = " " 885 chars += char 886 prev_space = is_space 887 skip = False 888 else: 889 skip = True 890 else: 891 chars = None # type: ignore 892 893 if not word: 894 if self._char in self.SINGLE_TOKENS: 895 self._add(self.SINGLE_TOKENS[self._char]) # type: ignore 896 return 897 self._scan_var() 898 return 899 900 if self._scan_string(word): 901 return 902 if self._scan_formatted_string(word): 903 return 904 if self._scan_comment(word): 905 return 906 907 self._advance(size - 1) 908 self._add(self.KEYWORDS[word.upper()]) 909 910 def _scan_comment(self, comment_start: str) -> bool: 911 if comment_start not in self._COMMENTS: # type: ignore 912 return False 913 914 comment_start_line = self._line 915 comment_start_size = len(comment_start) 916 comment_end = self._COMMENTS[comment_start] # type: ignore 917 918 if comment_end: 919 comment_end_size = len(comment_end) 920 921 while not self._end and self._chars(comment_end_size) != comment_end: 922 self._advance() 923 924 self._comments.append(self._text[comment_start_size : -comment_end_size + 1]) # type: ignore 925 self._advance(comment_end_size - 1) 926 else: 927 while not self._end and self.WHITE_SPACE.get(self._peek) != TokenType.BREAK: # type: ignore 928 self._advance() 929 self._comments.append(self._text[comment_start_size:]) # type: ignore 930 931 # Leading comment is attached to the succeeding token, whilst trailing comment to the preceding. 932 # Multiple consecutive comments are preserved by appending them to the current comments list. 933 if comment_start_line == self._prev_token_line: 934 self.tokens[-1].comments.extend(self._comments) 935 self._comments = [] 936 937 return True 938 939 def _scan_number(self) -> None: 940 if self._char == "0": 941 peek = self._peek.upper() # type: ignore 942 if peek == "B": 943 return self._scan_bits() 944 elif peek == "X": 945 return self._scan_hex() 946 947 decimal = False 948 scientific = 0 949 950 while True: 951 if self._peek.isdigit(): # type: ignore 952 self._advance() 953 elif self._peek == "." and not decimal: 954 decimal = True 955 self._advance() 956 elif self._peek in ("-", "+") and scientific == 1: 957 scientific += 1 958 self._advance() 959 elif self._peek.upper() == "E" and not scientific: # type: ignore 960 scientific += 1 961 self._advance() 962 elif self._peek.isidentifier(): # type: ignore 963 number_text = self._text 964 literal = [] 965 966 while self._peek.strip() and self._peek not in self.SINGLE_TOKENS: # type: ignore 967 literal.append(self._peek.upper()) # type: ignore 968 self._advance() 969 970 literal = "".join(literal) # type: ignore 971 token_type = self.KEYWORDS.get(self.NUMERIC_LITERALS.get(literal)) # type: ignore 972 973 if token_type: 974 self._add(TokenType.NUMBER, number_text) 975 self._add(TokenType.DCOLON, "::") 976 return self._add(token_type, literal) # type: ignore 977 elif self.IDENTIFIER_CAN_START_WITH_DIGIT: 978 return self._add(TokenType.VAR) 979 980 self._add(TokenType.NUMBER, number_text) 981 return self._advance(-len(literal)) 982 else: 983 return self._add(TokenType.NUMBER) 984 985 def _scan_bits(self) -> None: 986 self._advance() 987 value = self._extract_value() 988 try: 989 self._add(TokenType.BIT_STRING, f"{int(value, 2)}") 990 except ValueError: 991 self._add(TokenType.IDENTIFIER) 992 993 def _scan_hex(self) -> None: 994 self._advance() 995 value = self._extract_value() 996 try: 997 self._add(TokenType.HEX_STRING, f"{int(value, 16)}") 998 except ValueError: 999 self._add(TokenType.IDENTIFIER) 1000 1001 def _extract_value(self) -> str: 1002 while True: 1003 char = self._peek.strip() # type: ignore 1004 if char and char not in self.SINGLE_TOKENS: 1005 self._advance() 1006 else: 1007 break 1008 1009 return self._text 1010 1011 def _scan_string(self, quote: str) -> bool: 1012 quote_end = self._QUOTES.get(quote) # type: ignore 1013 if quote_end is None: 1014 return False 1015 1016 self._advance(len(quote)) 1017 text = self._extract_string(quote_end) 1018 text = text.encode(self.ENCODE).decode(self.ENCODE) if self.ENCODE else text # type: ignore 1019 text = text.replace("\\\\", "\\") if self._replace_backslash else text 1020 self._add(TokenType.NATIONAL if quote[0].upper() == "N" else TokenType.STRING, text) 1021 return True 1022 1023 # X'1234, b'0110', E'\\\\\' etc. 1024 def _scan_formatted_string(self, string_start: str) -> bool: 1025 if string_start in self._HEX_STRINGS: # type: ignore 1026 delimiters = self._HEX_STRINGS # type: ignore 1027 token_type = TokenType.HEX_STRING 1028 base = 16 1029 elif string_start in self._BIT_STRINGS: # type: ignore 1030 delimiters = self._BIT_STRINGS # type: ignore 1031 token_type = TokenType.BIT_STRING 1032 base = 2 1033 elif string_start in self._BYTE_STRINGS: # type: ignore 1034 delimiters = self._BYTE_STRINGS # type: ignore 1035 token_type = TokenType.BYTE_STRING 1036 base = None 1037 else: 1038 return False 1039 1040 self._advance(len(string_start)) 1041 string_end = delimiters.get(string_start) 1042 text = self._extract_string(string_end) 1043 1044 if base is None: 1045 self._add(token_type, text) 1046 else: 1047 try: 1048 self._add(token_type, f"{int(text, base)}") 1049 except: 1050 raise RuntimeError( 1051 f"Numeric string contains invalid characters from {self._line}:{self._start}" 1052 ) 1053 1054 return True 1055 1056 def _scan_identifier(self, identifier_end: str) -> None: 1057 text = "" 1058 identifier_end_is_escape = identifier_end in self._IDENTIFIER_ESCAPES 1059 1060 while True: 1061 if self._end: 1062 raise RuntimeError(f"Missing {identifier_end} from {self._line}:{self._start}") 1063 1064 self._advance() 1065 if self._char == identifier_end: 1066 if identifier_end_is_escape and self._peek == identifier_end: 1067 text += identifier_end # type: ignore 1068 self._advance() 1069 continue 1070 1071 break 1072 1073 text += self._char # type: ignore 1074 1075 self._add(TokenType.IDENTIFIER, text) 1076 1077 def _scan_var(self) -> None: 1078 while True: 1079 char = self._peek.strip() # type: ignore 1080 if char and char not in self.SINGLE_TOKENS: 1081 self._advance() 1082 else: 1083 break 1084 self._add( 1085 TokenType.VAR 1086 if self._prev_token_type == TokenType.PARAMETER 1087 else self.KEYWORDS.get(self._text.upper(), TokenType.VAR) 1088 ) 1089 1090 def _extract_string(self, delimiter: str) -> str: 1091 text = "" 1092 delim_size = len(delimiter) 1093 1094 while True: 1095 if ( 1096 self._char in self._STRING_ESCAPES 1097 and self._peek 1098 and (self._peek == delimiter or self._peek in self._STRING_ESCAPES) 1099 ): 1100 text += self._peek 1101 self._advance(2) 1102 else: 1103 if self._chars(delim_size) == delimiter: 1104 if delim_size > 1: 1105 self._advance(delim_size - 1) 1106 break 1107 1108 if self._end: 1109 raise RuntimeError(f"Missing {delimiter} from {self._line}:{self._start}") 1110 text += self._char # type: ignore 1111 self._advance() 1112 1113 return text
def
reset(self) -> None:
758 def reset(self) -> None: 759 self.sql = "" 760 self.size = 0 761 self.tokens: t.List[Token] = [] 762 self._start = 0 763 self._current = 0 764 self._line = 1 765 self._col = 1 766 self._comments: t.List[str] = [] 767 768 self._char = None 769 self._end = None 770 self._peek = None 771 self._prev_token_line = -1 772 self._prev_token_comments: t.List[str] = [] 773 self._prev_token_type = None