# 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 ValueTypeCtx from .types import TypeName from .gtkbuilder_template import Template expr = Sequence() class Expr(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["Expr"]: if isinstance(self.parent, ExprChain): 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 ExprChain(Expr): grammar = expr @property def last(self) -> Expr: 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(Expr): @property def lhs(self): children = list(self.parent_by_type(ExprChain).children) return children[children.index(self) - 1] class LiteralExpr(Expr): 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.root.objects_by_id ) @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.root.objects_by_id.get(self.literal.value.ident): return not isinstance(object, Template) 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 isinstance(self.lhs.type, UncheckedType) or not self.lhs.type_complete: 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", "(", TypeName, ")"] @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}." ) class ClosureArg(AstNode): grammar = ExprChain @property def expr(self) -> ExprChain: return self.children[ExprChain][0] @context(ValueTypeCtx) def value_type(self) -> ValueTypeCtx: return ValueTypeCtx(None) class ClosureExpr(Expr): 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, ["(", ExprChain, ")"]), ZeroOrMore(AnyOf(LookupOp, CastExpr)), ]