flowquery 1.0.45 → 1.0.47

package/flowquery-py/src/tokenization/token.py

@@ -1,693 +0,0 @@
-"""Represents a single token in the FlowQuery language."""
-
-from __future__ import annotations
-
-from typing import Optional
-
-from ..parsing.ast_node import ASTNode
-from ..utils.string_utils import StringUtils
-from .keyword import Keyword
-from .operator import Operator
-from .symbol import Symbol
-from .token_type import TokenType
-
-
-class Token:
-    """Represents a single token in the FlowQuery language.
-
-    Tokens are the atomic units of lexical analysis, produced by the tokenizer
-    and consumed by the parser. Each token has a type (keyword, operator, identifier, etc.)
-    and an optional value.
-
-    Example:
-        with_token = Token.WITH()
-        ident_token = Token.IDENTIFIER("myVar")
-        num_token = Token.NUMBER("42")
-    """
-
-    def __init__(self, type_: TokenType, value: Optional[str] = None):
-        """Creates a new Token instance.
-
-        Args:
-            type_: The type of the token
-            value: The optional value associated with the token
-        """
-        self._position: int = -1
-        self._type = type_
-        self._value = value
-        self._case_sensitive_value: Optional[str] = None
-        self._can_be_identifier = StringUtils.can_be_identifier(value or "")
-
-    def equals(self, other: Token) -> bool:
-        """Checks if this token equals another token.
-
-        Args:
-            other: The token to compare against
-
-        Returns:
-            True if tokens are equal, False otherwise
-        """
-        if self._type == TokenType.IDENTIFIER and other.type == TokenType.IDENTIFIER:
-            return True  # Identifier values are not compared
-        return self._type == other.type and self._value == other.value
-
-    @property
-    def position(self) -> int:
-        return self._position
-
-    @position.setter
-    def position(self, value: int) -> None:
-        self._position = value
-
-    @property
-    def type(self) -> TokenType:
-        return self._type
-
-    @property
-    def value(self) -> Optional[str]:
-        return self._case_sensitive_value or self._value
-
-    @property
-    def case_sensitive_value(self) -> Optional[str]:
-        return self._case_sensitive_value
-
-    @case_sensitive_value.setter
-    def case_sensitive_value(self, value: str) -> None:
-        self._case_sensitive_value = value
-
-    @property
-    def can_be_identifier(self) -> bool:
-        return self._can_be_identifier
-
-    @property
-    def node(self) -> ASTNode:
-        # Import at runtime to avoid circular dependency
-        from ..parsing.token_to_node import TokenToNode
-        return TokenToNode.convert(self)
-
-    def __str__(self) -> str:
-        return f"{self._type.value} {self._value}"
-
-    # Comment tokens
-
-    @staticmethod
-    def COMMENT(comment: str) -> Token:
-        return Token(TokenType.COMMENT, comment)
-
-    def is_comment(self) -> bool:
-        return self._type == TokenType.COMMENT
-
-    # Identifier token
-
-    @staticmethod
-    def IDENTIFIER(value: str) -> Token:
-        return Token(TokenType.IDENTIFIER, value)
-
-    def is_identifier(self) -> bool:
-        return self._type == TokenType.IDENTIFIER or self._type == TokenType.BACKTICK_STRING
-
-    def is_keyword_that_cannot_be_identifier(self) -> bool:
-        """Returns True for keywords that have special expression-level roles
-        and should not be treated as identifiers (NULL, CASE, WHEN, THEN, ELSE, END)."""
-        return self.is_keyword() and (
-            self.is_null()
-            or self.is_case()
-            or self.is_when()
-            or self.is_then()
-            or self.is_else()
-            or self.is_end()
-        )
-
-    def is_identifier_or_keyword(self) -> bool:
-        """Returns True if the token is an identifier or a keyword that can be used as an identifier."""
-        return self.is_identifier() or (
-            self.is_keyword() and not self.is_keyword_that_cannot_be_identifier()
-        )
-
-    # String token
-
-    @staticmethod
-    def STRING(value: str, quote_char: str = '"') -> Token:
-        unquoted = StringUtils.unquote(value)
-        unescaped = StringUtils.remove_escaped_quotes(unquoted, quote_char)
-        return Token(TokenType.STRING, unescaped)
-
-    def is_string(self) -> bool:
-        return self._type == TokenType.STRING or self._type == TokenType.BACKTICK_STRING
-
-    @staticmethod
-    def BACKTICK_STRING(value: str, quote_char: str = '"') -> Token:
-        unquoted = StringUtils.unquote(value)
-        unescaped = StringUtils.remove_escaped_quotes(unquoted, quote_char)
-        return Token(TokenType.BACKTICK_STRING, unescaped)
-
-    @staticmethod
-    def F_STRING(value: str, quote_char: str = '"') -> Token:
-        unquoted = StringUtils.unquote(value)
-        unescaped = StringUtils.remove_escaped_quotes(unquoted, quote_char)
-        fstring = StringUtils.remove_escaped_braces(unescaped)
-        return Token(TokenType.F_STRING, fstring)
-
-    def is_f_string(self) -> bool:
-        return self._type == TokenType.F_STRING
-
-    # Number token
-
-    @staticmethod
-    def NUMBER(value: str) -> Token:
-        return Token(TokenType.NUMBER, value)
-
-    def is_number(self) -> bool:
-        return self._type == TokenType.NUMBER
-
-    # Boolean token
-
-    @staticmethod
-    def BOOLEAN(value: str) -> Token:
-        return Token(TokenType.BOOLEAN, value)
-
-    def is_boolean(self) -> bool:
-        return self._type == TokenType.BOOLEAN and self._value in ("TRUE", "FALSE")
-
-    # Symbol tokens
-
-    @staticmethod
-    def LEFT_PARENTHESIS() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.LEFT_PARENTHESIS.value)
-
-    def is_left_parenthesis(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.LEFT_PARENTHESIS.value
-
-    @staticmethod
-    def RIGHT_PARENTHESIS() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.RIGHT_PARENTHESIS.value)
-
-    def is_right_parenthesis(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.RIGHT_PARENTHESIS.value
-
-    @staticmethod
-    def COMMA() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.COMMA.value)
-
-    def is_comma(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.COMMA.value
-
-    @staticmethod
-    def DOT() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.DOT.value)
-
-    def is_dot(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.DOT.value
-
-    @staticmethod
-    def COLON() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.COLON.value)
-
-    def is_colon(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.COLON.value
-
-    @staticmethod
-    def OPENING_BRACE() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.OPENING_BRACE.value)
-
-    def is_opening_brace(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.OPENING_BRACE.value
-
-    @staticmethod
-    def CLOSING_BRACE() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.CLOSING_BRACE.value)
-
-    def is_closing_brace(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.CLOSING_BRACE.value
-
-    @staticmethod
-    def OPENING_BRACKET() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.OPENING_BRACKET.value)
-
-    def is_opening_bracket(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.OPENING_BRACKET.value
-
-    @staticmethod
-    def CLOSING_BRACKET() -> Token:
-        return Token(TokenType.SYMBOL, Symbol.CLOSING_BRACKET.value)
-
-    def is_closing_bracket(self) -> bool:
-        return self._type == TokenType.SYMBOL and self._value == Symbol.CLOSING_BRACKET.value
-
-    # Whitespace token
-
-    @staticmethod
-    def WHITESPACE() -> Token:
-        return Token(TokenType.WHITESPACE)
-
-    def is_whitespace(self) -> bool:
-        return self._type == TokenType.WHITESPACE
-
-    # Operator tokens
-
-    def is_operator(self) -> bool:
-        return self._type == TokenType.OPERATOR
-
-    def is_unary_operator(self) -> bool:
-        return self._type == TokenType.UNARY_OPERATOR
-
-    @staticmethod
-    def ADD() -> Token:
-        return Token(TokenType.OPERATOR, Operator.ADD.value)
-
-    def is_add(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.ADD.value
-
-    @staticmethod
-    def SUBTRACT() -> Token:
-        return Token(TokenType.OPERATOR, Operator.SUBTRACT.value)
-
-    def is_subtract(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.SUBTRACT.value
-
-    def is_negation(self) -> bool:
-        return self.is_subtract()
-
-    @staticmethod
-    def MULTIPLY() -> Token:
-        return Token(TokenType.OPERATOR, Operator.MULTIPLY.value)
-
-    def is_multiply(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.MULTIPLY.value
-
-    @staticmethod
-    def DIVIDE() -> Token:
-        return Token(TokenType.OPERATOR, Operator.DIVIDE.value)
-
-    def is_divide(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.DIVIDE.value
-
-    @staticmethod
-    def EXPONENT() -> Token:
-        return Token(TokenType.OPERATOR, Operator.EXPONENT.value)
-
-    def is_exponent(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.EXPONENT.value
-
-    @staticmethod
-    def MODULO() -> Token:
-        return Token(TokenType.OPERATOR, Operator.MODULO.value)
-
-    def is_modulo(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.MODULO.value
-
-    @staticmethod
-    def EQUALS() -> Token:
-        return Token(TokenType.OPERATOR, Operator.EQUALS.value)
-
-    def is_equals(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.EQUALS.value
-
-    @staticmethod
-    def NOT_EQUALS() -> Token:
-        return Token(TokenType.OPERATOR, Operator.NOT_EQUALS.value)
-
-    def is_not_equals(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.NOT_EQUALS.value
-
-    @staticmethod
-    def LESS_THAN() -> Token:
-        return Token(TokenType.OPERATOR, Operator.LESS_THAN.value)
-
-    def is_less_than(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.LESS_THAN.value
-
-    @staticmethod
-    def LESS_THAN_OR_EQUAL() -> Token:
-        return Token(TokenType.OPERATOR, Operator.LESS_THAN_OR_EQUAL.value)
-
-    def is_less_than_or_equal(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.LESS_THAN_OR_EQUAL.value
-
-    @staticmethod
-    def GREATER_THAN() -> Token:
-        return Token(TokenType.OPERATOR, Operator.GREATER_THAN.value)
-
-    def is_greater_than(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.GREATER_THAN.value
-
-    @staticmethod
-    def GREATER_THAN_OR_EQUAL() -> Token:
-        return Token(TokenType.OPERATOR, Operator.GREATER_THAN_OR_EQUAL.value)
-
-    def is_greater_than_or_equal(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.GREATER_THAN_OR_EQUAL.value
-
-    @staticmethod
-    def AND() -> Token:
-        return Token(TokenType.OPERATOR, Operator.AND.value)
-
-    def is_and(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.AND.value
-
-    @staticmethod
-    def OR() -> Token:
-        return Token(TokenType.OPERATOR, Operator.OR.value)
-
-    def is_or(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.OR.value
-
-    @staticmethod
-    def NOT() -> Token:
-        return Token(TokenType.UNARY_OPERATOR, Operator.NOT.value)
-
-    def is_not(self) -> bool:
-        return self._type == TokenType.UNARY_OPERATOR and self._value == Operator.NOT.value
-
-    @staticmethod
-    def IS() -> Token:
-        return Token(TokenType.OPERATOR, Operator.IS.value)
-
-    def is_is(self) -> bool:
-        return self._type == TokenType.OPERATOR and self._value == Operator.IS.value
-
-    # Keyword tokens
-
-    def is_keyword(self) -> bool:
-        return self._type == TokenType.KEYWORD
-
-    @staticmethod
-    def WITH() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.WITH.value)
-
-    def is_with(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.WITH.value
-
-    @staticmethod
-    def RETURN() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.RETURN.value)
-
-    def is_return(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.RETURN.value
-
-    @staticmethod
-    def LOAD() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.LOAD.value)
-
-    def is_load(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.LOAD.value
-
-    @staticmethod
-    def CALL() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.CALL.value)
-
-    def is_call(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.CALL.value
-
-    @staticmethod
-    def YIELD() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.YIELD.value)
-
-    def is_yield(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.YIELD.value
-
-    @staticmethod
-    def JSON() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.JSON.value)
-
-    def is_json(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.JSON.value
-
-    @staticmethod
-    def CSV() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.CSV.value)
-
-    def is_csv(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.CSV.value
-
-    @staticmethod
-    def TEXT() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.TEXT.value)
-
-    def is_text(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.TEXT.value
-
-    @staticmethod
-    def FROM() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.FROM.value)
-
-    def is_from(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.FROM.value
-
-    @staticmethod
-    def HEADERS() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.HEADERS.value)
-
-    def is_headers(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.HEADERS.value
-
-    @staticmethod
-    def POST() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.POST.value)
-
-    def is_post(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.POST.value
-
-    @staticmethod
-    def UNWIND() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.UNWIND.value)
-
-    def is_unwind(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.UNWIND.value
-
-    @staticmethod
-    def MATCH() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.MATCH.value)
-
-    def is_match(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.MATCH.value
-
-    @staticmethod
-    def OPTIONAL() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.OPTIONAL.value)
-
-    def is_optional(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.OPTIONAL.value
-
-    @staticmethod
-    def AS() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.AS.value)
-
-    def is_as(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.AS.value
-
-    @staticmethod
-    def WHERE() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.WHERE.value)
-
-    def is_where(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.WHERE.value
-
-    @staticmethod
-    def MERGE() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.MERGE.value)
-
-    def is_merge(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.MERGE.value
-
-    @staticmethod
-    def CREATE() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.CREATE.value)
-
-    def is_create(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.CREATE.value
-
-    @staticmethod
-    def VIRTUAL() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.VIRTUAL.value)
-
-    def is_virtual(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.VIRTUAL.value
-
-    @staticmethod
-    def DELETE() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.DELETE.value)
-
-    def is_delete(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.DELETE.value
-
-    @staticmethod
-    def SET() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.SET.value)
-
-    def is_set(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.SET.value
-
-    @staticmethod
-    def REMOVE() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.REMOVE.value)
-
-    def is_remove(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.REMOVE.value
-
-    @staticmethod
-    def CASE() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.CASE.value)
-
-    def is_case(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.CASE.value
-
-    @staticmethod
-    def WHEN() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.WHEN.value)
-
-    def is_when(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.WHEN.value
-
-    @staticmethod
-    def THEN() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.THEN.value)
-
-    def is_then(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.THEN.value
-
-    @staticmethod
-    def ELSE() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.ELSE.value)
-
-    def is_else(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.ELSE.value
-
-    @staticmethod
-    def END() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.END.value)
-
-    def is_end(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.END.value
-
-    @staticmethod
-    def NULL() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.NULL.value)
-
-    def is_null(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.NULL.value
-
-    @staticmethod
-    def IN() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.IN.value)
-
-    def is_in(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.IN.value
-
-    @staticmethod
-    def CONTAINS() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.CONTAINS.value)
-
-    def is_contains(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.CONTAINS.value
-
-    @staticmethod
-    def STARTS() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.STARTS.value)
-
-    def is_starts(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.STARTS.value
-
-    @staticmethod
-    def ENDS() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.ENDS.value)
-
-    def is_ends(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.ENDS.value
-
-    @staticmethod
-    def PIPE() -> Token:
-        return Token(TokenType.KEYWORD, Operator.PIPE.value)
-
-    def is_pipe(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Operator.PIPE.value
-
-    @staticmethod
-    def DISTINCT() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.DISTINCT.value)
-
-    def is_distinct(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.DISTINCT.value
-
-    @staticmethod
-    def LIMIT() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.LIMIT.value)
-
-    def is_limit(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.LIMIT.value
-
-    @staticmethod
-    def UNION() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.UNION.value)
-
-    def is_union(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.UNION.value
-
-    @staticmethod
-    def ALL() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.ALL.value)
-
-    def is_all(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.ALL.value
-
-    @staticmethod
-    def ORDER() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.ORDER.value)
-
-    def is_order(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.ORDER.value
-
-    @staticmethod
-    def BY() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.BY.value)
-
-    def is_by(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.BY.value
-
-    @staticmethod
-    def ASC() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.ASC.value)
-
-    def is_asc(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.ASC.value
-
-    @staticmethod
-    def DESC() -> Token:
-        return Token(TokenType.KEYWORD, Keyword.DESC.value)
-
-    def is_desc(self) -> bool:
-        return self._type == TokenType.KEYWORD and self._value == Keyword.DESC.value
-
-    # End of file token
-
-    @staticmethod
-    def EOF() -> Token:
-        return Token(TokenType.EOF)
-
-    def is_eof(self) -> bool:
-        return self._type == TokenType.EOF
-
-    # Other utility methods
-
-    def is_operand(self) -> bool:
-        return self.is_number() or self.is_boolean() or self.is_string() or self.is_null()
-
-    def is_whitespace_or_comment(self) -> bool:
-        return self.is_whitespace() or self.is_comment()
-
-    def is_symbol(self) -> bool:
-        return self._type == TokenType.SYMBOL
-
-    # Static class method lookup via string
-    @staticmethod
-    def method(name: str) -> Optional[Token]:
-        name_upper = name.upper()
-        if hasattr(Token, name_upper):
-            attr = getattr(Token, name_upper)
-            if callable(attr):
-                result = attr()
-                if isinstance(result, Token):
-                    return result
-            elif isinstance(attr, Token):
-                return attr
-        return None