# gobject_object.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 import typing as T from functools import cached_property from .common import * from .response_id import ResponseId class ObjectContent(AstNode): grammar = ["{", Until(OBJECT_CONTENT_HOOKS, "}")] @property def gir_class(self): return self.parent.gir_class def emit_xml(self, xml: XmlEmitter): for x in self.children: x.emit_xml(xml) class Object(AstNode): grammar: T.Any = [ class_name, Optional(UseIdent("id")), ObjectContent, ] @validate("namespace") def gir_ns_exists(self): if not self.tokens["ignore_gir"]: self.root.gir.validate_ns(self.tokens["namespace"]) @validate("class_name") def gir_class_exists(self): if self.tokens["class_name"] and not self.tokens["ignore_gir"] and self.gir_ns is not None: self.root.gir.validate_class(self.tokens["class_name"], self.tokens["namespace"]) @validate("namespace", "class_name") def not_abstract(self): if self.gir_class is not None and self.gir_class.abstract: raise CompileError( f"{self.gir_class.full_name} can't be instantiated because it's abstract", hints=[f"did you mean to use a subclass of {self.gir_class.full_name}?"] ) @property def gir_ns(self): if not self.tokens["ignore_gir"]: return self.root.gir.namespaces.get(self.tokens["namespace"] or "Gtk") @property def gir_class(self): if self.tokens["class_name"] and not self.tokens["ignore_gir"]: return self.root.gir.get_class(self.tokens["class_name"], self.tokens["namespace"]) @docs("namespace") def namespace_docs(self): if ns := self.root.gir.namespaces.get(self.tokens["namespace"]): return ns.doc @docs("class_name") def class_docs(self): if self.gir_class: return self.gir_class.doc @cached_property def action_widgets(self) -> T.List[ResponseId]: """Get list of widget's action widgets. Empty if object doesn't have action widgets. """ from .gtkbuilder_child import Child return [ child.response_id for child in self.children[ObjectContent][0].children[Child] if child.response_id ] def emit_xml(self, xml: XmlEmitter): from .gtkbuilder_child import Child xml.start_tag("object", **{ "class": self.gir_class or self.tokens["class_name"], "id": self.tokens["id"], }) for child in self.children: child.emit_xml(xml) # List action widgets action_widgets = self.action_widgets if action_widgets: xml.start_tag("action-widgets") for action_widget in action_widgets: action_widget.emit_action_widget(xml) xml.end_tag() xml.end_tag() def validate_parent_type(node, ns: str, name: str, err_msg: str): parent = node.root.gir.get_type(name, ns) container_type = node.parent_by_type(Object).gir_class if container_type and not container_type.assignable_to(parent): raise CompileError(f"{container_type.full_name} is not a {parent.full_name}, so it doesn't have {err_msg}") @decompiler("object") def decompile_object(ctx, gir, klass, id=None): gir_class = ctx.type_by_cname(klass) klass_name = decompile.full_name(gir_class) if gir_class is not None else "." + klass if id is None: ctx.print(f"{klass_name} {{") else: ctx.print(f"{klass_name} {id} {{") return gir_class