# collect_stats.py # # Copyright 2026 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 """ Collects statistics about property, signal, and child object usage from a sample of blueprint files to help improve completion suggestions. Usage: ./blueprint-compiler.py tools collect-stats """ import json import os from collections import defaultdict from dataclasses import dataclass, field from ..ast_utils import AstNode from ..language import Child, Object, Property, Signal, Template from ..parser import parse from ..tokenizer import tokenize MAX_ITEMS = 5 MIN_OCCURRENCES = 5 @dataclass class ClassStats: usages: dict[str, int] = field(default_factory=lambda: defaultdict(int)) def summarize(self): often_enough = [x for x in self.usages.items() if x[1] >= MIN_OCCURRENCES] if len(often_enough) == 0: return None most_frequent = sorted(often_enough, key=lambda x: x[1], reverse=True) return [x[0] for x in most_frequent[:MAX_ITEMS]] def collect_stats(dir: str): class_stats: defaultdict[str, ClassStats] = defaultdict(lambda: ClassStats()) def walk_ast(ast: AstNode): if isinstance(ast, Object) and not isinstance(ast, Template): if ( not ast.class_name.is_extern and ast.class_name.gir_type is not None and not ast.class_name.gir_type.deprecated ): class_name = ast.class_name.gir_type.full_name class_stat = class_stats[class_name] for prop in ast.content.children[Property]: class_stat.usages["p:" + prop.name] += 1 for signal in ast.content.children[Signal]: class_stat.usages["s:" + signal.full_name] += 1 for child in ast.content.children[Child]: if not child.object.class_name.is_extern: child_class_name = child.object.class_name.gir_type.full_name class_stat.usages["c:" + child_class_name] += 1 for child in ast.children: walk_ast(child) for root, _, files in os.walk(dir): for fname in files: if not fname.endswith(".blp"): continue path = os.path.join(root, fname) with open(path, "r") as f: content = f.read() tokens = tokenize(content) ast, errors, warnings = parse(tokens) if errors is not None or ast is None: continue walk_ast(ast) results = {k: v.summarize() for k, v in class_stats.items()} results = {k: v for k, v in results.items() if v is not None} with open(os.path.join(os.path.dirname(__file__), "stats.json"), "w") as f: json.dump(results, f, indent=2, sort_keys=True)