# completions.py # # Copyright 2021 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 . import annotations, gir, language from .ast_utils import AstNode from .completions_utils import * from .language.types import ClassName from .lsp_utils import Completion, CompletionItemKind, TextEdit, get_docs_section from .parser import SKIP_TOKENS from .tokenizer import Token, TokenType Pattern = T.List[T.Tuple[TokenType, T.Optional[str]]] def _complete( lsp, ast_node: AstNode, tokens: T.List[Token], idx: int, token_idx: int, next_token: Token, ) -> T.Iterator[Completion]: for child in ast_node.children: if child.group.start <= idx and ( idx < child.group.end or (idx == child.group.end and child.incomplete) ): yield from _complete(lsp, child, tokens, idx, token_idx, next_token) return prev_tokens: T.List[Token] = [] # collect the 5 previous non-skipped tokens while len(prev_tokens) < 5 and token_idx >= 0: token = tokens[token_idx] if token.type not in SKIP_TOKENS: prev_tokens.insert(0, token) token_idx -= 1 for completer in ast_node.completers: yield from completer(prev_tokens, next_token, ast_node, lsp, idx) def complete( lsp, ast_node: AstNode, tokens: T.List[Token], idx: int ) -> T.Iterator[Completion]: token_idx = 0 # find the current token for i, token in enumerate(tokens): if token.start < idx <= token.end: token_idx = i if tokens[token_idx].type == TokenType.EOF: next_token = tokens[token_idx] else: next_token_idx = token_idx + 1 while tokens[next_token_idx].type == TokenType.WHITESPACE: next_token_idx += 1 next_token = tokens[next_token_idx] # if the current token is an identifier or whitespace, move to the token before it while tokens[token_idx].type in [TokenType.IDENT, TokenType.WHITESPACE]: idx = tokens[token_idx].start token_idx -= 1 yield from _complete(lsp, ast_node, tokens, idx, token_idx, next_token) @completer([language.GtkDirective]) def using_gtk(_ctx: CompletionContext): yield Completion( "using Gtk 4.0", CompletionItemKind.Keyword, snippet="using Gtk 4.0;\n" ) @completer([language.UI]) def using(ctx: CompletionContext): imported_namespaces = set( [import_.namespace for import_ in ctx.ast_node.root.using] ) # Import statements must be before any content for i in ctx.ast_node.root.children: if not isinstance(i, language.GtkDirective) and not isinstance( i, language.Import ): if ctx.index >= i.range.end: return for ns, version in gir.get_available_namespaces(): if ns not in imported_namespaces and ns != "Gtk": yield Completion( f"using {ns} {version}", CompletionItemKind.Module, text=f"using {ns} {version};", ) @completer([language.UI]) def translation_domain(ctx: CompletionContext): if ctx.ast_node.root.translation_domain is not None: return # Translation domain must be after the import statements but before any content for i in ctx.ast_node.root.children: if isinstance(i, language.Import): if ctx.index <= i.range.start: return elif not isinstance(i, language.GtkDirective): if ctx.index >= i.range.end: return yield Completion( "translation-domain", CompletionItemKind.Keyword, snippet='translation-domain "$0";', docs=get_docs_section("Syntax TranslationDomain"), ) @completer( applies_in=[language.UI, language.ObjectContent, language.Template], matches=new_statement_patterns, ) def namespace(ctx: CompletionContext): yield Completion("Gtk", CompletionItemKind.Module, text="Gtk.") imported_namespaces = set(["Gtk"]) for ns in ctx.ast_node.root.children[language.Import]: if ns.gir_namespace is not None: imported_namespaces.add(ns.gir_namespace.name) yield Completion( ns.gir_namespace.name, CompletionItemKind.Module, text=ns.gir_namespace.name + ".", ) for ns, version in gir.get_available_namespaces(): if ns not in imported_namespaces: yield Completion( ns, CompletionItemKind.Module, text=ns + ".", signature=f" using {ns} {version}", additional_text_edits=[ TextEdit( ctx.ast_node.root.import_range(ns), f"\nusing {ns} {version};" ) ], ) @completer( applies_in=[language.UI, language.ObjectContent, language.Template], matches=[ [(TokenType.IDENT, None), (TokenType.OP, "."), (TokenType.IDENT, None)], [(TokenType.IDENT, None), (TokenType.OP, ".")], ], ) def object_completer(ctx: CompletionContext): ns = ctx.ast_node.root.gir.namespaces.get(ctx.match_variables[0]) if ns is not None: for c in ns.classes.values(): snippet = c.name if str(ctx.next_token) != "{": snippet += " {\n $0\n}" yield Completion( c.name, CompletionItemKind.Class, snippet=snippet, docs=c.doc, detail=c.detail, ) @completer( applies_in=[language.UI, language.ObjectContent, language.Template], matches=new_statement_patterns, ) def gtk_object_completer(ctx: CompletionContext): ns = ctx.ast_node.root.gir.namespaces.get("Gtk") if ns is not None: for c in ns.classes.values(): snippet = c.name if str(ctx.next_token) != "{": snippet += " {\n $0\n}" yield Completion( c.name, CompletionItemKind.Class, snippet=snippet, docs=c.doc, detail=c.detail, ) @completer( applies_in=[language.ObjectContent], matches=new_statement_patterns, ) def property_completer(ctx: CompletionContext): assert isinstance(ctx.ast_node, language.ObjectContent) if ctx.ast_node.gir_class and hasattr(ctx.ast_node.gir_class, "properties"): for prop_name, prop in ctx.ast_node.gir_class.properties.items(): if str(ctx.next_token) == ":": snippet = prop_name elif ( isinstance(prop.type, gir.BoolType) and ctx.client_supports_completion_choice ): snippet = f"{prop_name}: ${{1|true,false|}};" elif isinstance(prop.type, gir.StringType): snippet = ( f'{prop_name}: _("$0");' if annotations.is_property_translated(prop) else f'{prop_name}: "$0";' ) elif ( isinstance(prop.type, gir.Enumeration) and len(prop.type.members) <= 10 and ctx.client_supports_completion_choice ): choices = ",".join(prop.type.members.keys()) snippet = f"{prop_name}: ${{1|{choices}|}};" elif prop.type.full_name == "Gtk.Expression": snippet = f"{prop_name}: expr $0;" else: snippet = f"{prop_name}: $0;" yield Completion( prop_name, CompletionItemKind.Property, sort_text=f"0 {prop_name}", snippet=snippet, docs=prop.doc, detail=prop.detail, ) @completer( applies_in=[language.Property, language.A11yProperty], matches=[[(TokenType.IDENT, None), (TokenType.OP, ":")]], ) def prop_value_completer(ctx: CompletionContext): assert isinstance(ctx.ast_node, language.Property) or isinstance( ctx.ast_node, language.A11yProperty ) if (vt := ctx.ast_node.value_type) is not None: if isinstance(vt.value_type, gir.Enumeration): for name, member in vt.value_type.members.items(): yield Completion( name, CompletionItemKind.EnumMember, docs=member.doc, detail=member.detail, ) elif isinstance(vt.value_type, gir.BoolType): yield Completion("true", CompletionItemKind.Constant) yield Completion("false", CompletionItemKind.Constant) @completer( applies_in=[language.ObjectContent], matches=new_statement_patterns, ) def signal_completer(ctx: CompletionContext): assert isinstance(ctx.ast_node, language.ObjectContent) if ctx.ast_node.gir_class and hasattr(ctx.ast_node.gir_class, "signals"): for signal_name, signal in ctx.ast_node.gir_class.signals.items(): if str(ctx.next_token) == "=>": snippet = signal_name else: if not isinstance(ctx.ast_node.parent, language.Object): name = "on" else: name = "on_" + ( ctx.ast_node.parent.children[ClassName][0].tokens["id"] or ctx.ast_node.parent.children[ClassName][0] .tokens["class_name"] .lower() ) snippet = f"{signal_name} => \\$${{1:${name}_{signal_name.replace('-', '_')}}}()$0;" yield Completion( signal_name, CompletionItemKind.Event, sort_text=f"1 {signal_name}", snippet=snippet, docs=signal.doc, detail=signal.detail, ) @completer(applies_in=[language.UI], matches=new_statement_patterns) def template_completer(_ctx: CompletionContext): yield Completion( "template", CompletionItemKind.Snippet, snippet="template ${1:ClassName} : ${2:ParentClass} {\n $0\n}", )