# expressions.py # # Copyright 2022 James Westman # # This file is free software; you can redistribute it and/or modify it # under the terms of the GNU Lesser General Public License as # published by the Free Software Foundation; either version 3 of the # License, or (at your option) any later version. # # This file is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU # Lesser General Public License for more details. # # You should have received a copy of the GNU Lesser General Public # License along with this program. If not, see . # # SPDX-License-Identifier: LGPL-3.0-or-later from .common import * from .contexts import ScopeCtx, ValueTypeCtx from .gtkbuilder_template import Template from .types import TypeName expr = Sequence() class ExprBase(AstNode): @context(ValueTypeCtx) def value_type(self) -> ValueTypeCtx: if rhs := self.rhs: return rhs.context[ValueTypeCtx] else: return self.parent.context[ValueTypeCtx] @property def type(self) -> T.Optional[GirType]: raise NotImplementedError() @property def type_complete(self) -> bool: return True @property def rhs(self) -> T.Optional["ExprBase"]: if isinstance(self.parent, Expression): children = list(self.parent.children) if children.index(self) + 1 < len(children): return children[children.index(self) + 1] else: return self.parent.rhs else: return None class Expression(ExprBase): grammar = expr @property def last(self) -> ExprBase: return self.children[-1] @property def type(self) -> T.Optional[GirType]: return self.last.type @property def type_complete(self) -> bool: return self.last.type_complete class InfixExpr(ExprBase): @property def lhs(self): children = list(self.parent_by_type(Expression).children) return children[children.index(self) - 1] class LiteralExpr(ExprBase): grammar = LITERAL @property def is_object(self) -> bool: from .values import IdentLiteral return isinstance(self.literal.value, IdentLiteral) and ( self.literal.value.ident in self.context[ScopeCtx].objects or self.root.is_legacy_template(self.literal.value.ident) ) @property def literal(self): from .values import Literal return self.children[Literal][0] @property def type(self) -> T.Optional[GirType]: return self.literal.value.type @property def type_complete(self) -> bool: from .values import IdentLiteral if isinstance(self.literal.value, IdentLiteral): if object := self.context[ScopeCtx].objects.get(self.literal.value.ident): return not object.gir_class.incomplete return True class LookupOp(InfixExpr): grammar = [".", UseIdent("property")] @context(ValueTypeCtx) def value_type(self) -> ValueTypeCtx: return ValueTypeCtx(None) @property def property_name(self) -> str: return self.tokens["property"] @property def type(self) -> T.Optional[GirType]: if isinstance(self.lhs.type, gir.Class) or isinstance( self.lhs.type, gir.Interface ): if property := self.lhs.type.properties.get(self.property_name): return property.type return None @validate("property") def property_exists(self): if self.lhs.type is None: raise CompileError( f"Could not determine the type of the preceding expression", hints=[ f"add a type cast so blueprint knows which type the property {self.property_name} belongs to" ], ) if self.lhs.type.incomplete: return elif not isinstance(self.lhs.type, gir.Class) and not isinstance( self.lhs.type, gir.Interface ): raise CompileError( f"Type {self.lhs.type.full_name} does not have properties" ) elif self.lhs.type.properties.get(self.property_name) is None: raise CompileError( f"{self.lhs.type.full_name} does not have a property called {self.property_name}", did_you_mean=(self.property_name, self.lhs.type.properties.keys()), ) class CastExpr(InfixExpr): grammar = [ "as", AnyOf( ["<", TypeName, Match(">").expected()], [ UseExact("lparen", "("), TypeName, UseExact("rparen", ")").expected("')'"), ], ), ] @context(ValueTypeCtx) def value_type(self): return ValueTypeCtx(self.type) @property def type(self) -> T.Optional[GirType]: return self.children[TypeName][0].gir_type @property def type_complete(self) -> bool: return True @validate() def cast_makes_sense(self): if self.type is None or self.lhs.type is None: return if not self.type.assignable_to(self.lhs.type): raise CompileError( f"Invalid cast. No instance of {self.lhs.type.full_name} can be an instance of {self.type.full_name}." ) @validate("lparen", "rparen") def upgrade_to_angle_brackets(self): if self.tokens["lparen"]: raise UpgradeWarning( "Use angle bracket syntax introduced in blueprint 0.8.0", actions=[ CodeAction( "Use <> instead of ()", f"<{self.children[TypeName][0].as_string}>", ) ], ) class ClosureArg(AstNode): grammar = Expression @property def expr(self) -> Expression: return self.children[Expression][0] @context(ValueTypeCtx) def value_type(self) -> ValueTypeCtx: return ValueTypeCtx(None) class ClosureExpr(ExprBase): grammar = [ Optional(["$", UseLiteral("extern", True)]), UseIdent("name"), "(", Delimited(ClosureArg, ","), ")", ] @property def type(self) -> T.Optional[GirType]: if isinstance(self.rhs, CastExpr): return self.rhs.type else: return None @property def closure_name(self) -> str: return self.tokens["name"] @property def args(self) -> T.List[ClosureArg]: return self.children[ClosureArg] @validate() def cast_to_return_type(self): if not isinstance(self.rhs, CastExpr): raise CompileError( "Closure expression must be cast to the closure's return type" ) @validate() def builtin_exists(self): if not self.tokens["extern"]: raise CompileError(f"{self.closure_name} is not a builtin function") expr.children = [ AnyOf(ClosureExpr, LiteralExpr, ["(", Expression, ")"]), ZeroOrMore(AnyOf(LookupOp, CastExpr)), ]