#!/usr/bin/env python3 """Generate UTFCN's popular_node_signatures.json artifact.""" import ast import json import os from datetime import datetime, timezone from pathlib import Path SCHEMA_VERSION = 1 MANAGER_LIST_URL = "https://raw.githubusercontent.com/ltdrdata/ComfyUI-Manager/main/custom-node-list.json" REGISTRY_NODES_URL = "https://api.comfy.org/nodes" class UnsupportedStaticExpression(Exception): pass _MISSING = object() _INVALID = object() _MUTATING_METHODS = { "add", "append", "clear", "discard", "extend", "insert", "pop", "popitem", "remove", "reverse", "setdefault", "sort", "update", } def _literal(node, env): if isinstance(node, ast.Constant): return node.value if isinstance(node, ast.List): return [_literal(item, env) for item in node.elts] if isinstance(node, ast.Tuple): return tuple(_literal(item, env) for item in node.elts) if isinstance(node, ast.Dict): result = {} for key, value in zip(node.keys, node.values): if key is None: raise UnsupportedStaticExpression("dict unpacking is not supported") result[_literal(key, env)] = _literal(value, env) return result if isinstance(node, ast.Name) and node.id in env: return env[node.id] raise UnsupportedStaticExpression(type(node).__name__) def _is_mutable_static_value(value): return isinstance(value, (dict, list, set)) def _target_names(target): if isinstance(target, ast.Name): return {target.id} if isinstance(target, (ast.List, ast.Tuple)): names = set() for item in target.elts: names.update(_target_names(item)) return names if isinstance(target, ast.Starred): return _target_names(target.value) if isinstance(target, (ast.Attribute, ast.Subscript)): return _target_names(target.value) return set() def _pattern_bound_names(pattern): names = set() if isinstance(pattern, ast.MatchAs): if pattern.name: names.add(pattern.name) if pattern.pattern is not None: names.update(_pattern_bound_names(pattern.pattern)) elif isinstance(pattern, ast.MatchStar): if pattern.name: names.add(pattern.name) elif isinstance(pattern, ast.MatchMapping): if pattern.rest: names.add(pattern.rest) for subpattern in pattern.patterns: names.update(_pattern_bound_names(subpattern)) elif isinstance(pattern, ast.MatchSequence): for subpattern in pattern.patterns: names.update(_pattern_bound_names(subpattern)) elif isinstance(pattern, ast.MatchClass): for subpattern in pattern.patterns: names.update(_pattern_bound_names(subpattern)) for subpattern in pattern.kwd_patterns: names.update(_pattern_bound_names(subpattern)) elif isinstance(pattern, ast.MatchOr): for subpattern in pattern.patterns: names.update(_pattern_bound_names(subpattern)) return names def _named_expr_target_names(node): names = set() class NamedExprVisitor(ast.NodeVisitor): def visit_FunctionDef(self, child): return None def visit_AsyncFunctionDef(self, child): return None def visit_ClassDef(self, child): return None def visit_Lambda(self, child): return None def visit_NamedExpr(self, child): names.update(_target_names(child.target)) self.visit(child.value) NamedExprVisitor().visit(node) return names def _bound_names(stmt): names = set() if isinstance(stmt, (ast.FunctionDef, ast.AsyncFunctionDef, ast.ClassDef)): names.add(stmt.name) elif isinstance(stmt, ast.Import): for alias in stmt.names: names.add(alias.asname or alias.name.split(".", 1)[0]) elif isinstance(stmt, ast.ImportFrom): for alias in stmt.names: if alias.name != "*": names.add(alias.asname or alias.name) elif isinstance(stmt, (ast.With, ast.AsyncWith)): for item in stmt.items: if item.optional_vars is not None: names.update(_target_names(item.optional_vars)) elif isinstance(stmt, ast.Match): for case in stmt.cases: names.update(_pattern_bound_names(case.pattern)) names.update(_named_expr_target_names(stmt)) return names def _has_wildcard_import(stmt): return isinstance(stmt, ast.ImportFrom) and any(alias.name == "*" for alias in stmt.names) def _assignment_target_names(stmt): if isinstance(stmt, ast.Assign): names = set() for target in stmt.targets: names.update(_target_names(target)) return names if isinstance(stmt, (ast.AnnAssign, ast.AugAssign)): return _target_names(stmt.target) if isinstance(stmt, (ast.For, ast.AsyncFor)): return _target_names(stmt.target) return set() def _delete_target_names(stmt): if not isinstance(stmt, ast.Delete): return set() names = set() for target in stmt.targets: names.update(_target_names(target)) return names def _mutating_call_target_names(stmt): if not isinstance(stmt, ast.Expr): return set() call = stmt.value if not isinstance(call, ast.Call) or not isinstance(call.func, ast.Attribute): return set() if call.func.attr not in _MUTATING_METHODS: return set() return _target_names(call.func.value) def _assigned_names_in_control_flow(stmt): names = set() class AssignmentVisitor(ast.NodeVisitor): def visit_FunctionDef(self, node): names.add(node.name) return None def visit_AsyncFunctionDef(self, node): names.add(node.name) return None def visit_ClassDef(self, node): names.add(node.name) return None def visit_Import(self, node): names.update(_bound_names(node)) def visit_ImportFrom(self, node): names.update(_bound_names(node)) def visit_Assign(self, node): names.update(_assignment_target_names(node)) def visit_AnnAssign(self, node): names.update(_assignment_target_names(node)) def visit_AugAssign(self, node): names.update(_assignment_target_names(node)) def visit_Delete(self, node): names.update(_delete_target_names(node)) def visit_Expr(self, node): names.update(_mutating_call_target_names(node)) names.update(_named_expr_target_names(node)) def visit_With(self, node): names.update(_bound_names(node)) self.generic_visit(node) def visit_AsyncWith(self, node): names.update(_bound_names(node)) self.generic_visit(node) def visit_NamedExpr(self, node): names.update(_target_names(node.target)) self.visit(node.value) def visit_Match(self, node): names.update(_bound_names(node)) self.generic_visit(node) def visit_For(self, node): names.update(_assignment_target_names(node)) self.generic_visit(node) def visit_AsyncFor(self, node): names.update(_assignment_target_names(node)) self.generic_visit(node) AssignmentVisitor().visit(stmt) return names def _collect_module_env(tree): env = {} for stmt in tree.body: if isinstance(stmt, ast.Assign): names = _assignment_target_names(stmt) if len(stmt.targets) == 1 and isinstance(stmt.targets[0], ast.Name): name = stmt.targets[0].id if ( isinstance(stmt.value, ast.Name) and stmt.value.id in env and _is_mutable_static_value(env[stmt.value.id]) ): env.pop(stmt.value.id, None) env.pop(name, None) continue try: env[name] = _literal(stmt.value, env) except UnsupportedStaticExpression: env.pop(name, None) else: for name in names: env.pop(name, None) continue if isinstance(stmt, ast.AnnAssign): names = _assignment_target_names(stmt) if stmt.value is None: continue if isinstance(stmt.target, ast.Name): name = stmt.target.id if ( isinstance(stmt.value, ast.Name) and stmt.value.id in env and _is_mutable_static_value(env[stmt.value.id]) ): env.pop(stmt.value.id, None) env.pop(name, None) continue try: env[name] = _literal(stmt.value, env) except UnsupportedStaticExpression: env.pop(name, None) else: for name in names: env.pop(name, None) continue if isinstance(stmt, ast.AugAssign): for name in _assignment_target_names(stmt): env.pop(name, None) continue if isinstance(stmt, ast.Delete): for name in _delete_target_names(stmt): env.pop(name, None) continue if isinstance(stmt, ast.Expr): for name in _mutating_call_target_names(stmt): env.pop(name, None) for name in _bound_names(stmt): env.pop(name, None) continue if isinstance(stmt, (ast.If, ast.For, ast.AsyncFor, ast.While, ast.Try, ast.With, ast.AsyncWith, ast.Match)): for name in _assigned_names_in_control_flow(stmt): env.pop(name, None) continue if _has_wildcard_import(stmt): env.clear() continue for name in _bound_names(stmt): env.pop(name, None) return env def normalise_input_spec(spec): first = spec[0] if isinstance(spec, (list, tuple)) and spec else spec if isinstance(first, list): return "COMBO" return str(first) def _class_defs(tree): return {node.name: node for node in ast.walk(tree) if isinstance(node, ast.ClassDef)} def _class_attr(cls, name, env): value = _MISSING for stmt in cls.body: if isinstance(stmt, ast.Assign): if not any(isinstance(target, ast.Name) and target.id == name for target in stmt.targets): continue if len(stmt.targets) == 1 and isinstance(stmt.targets[0], ast.Name): try: value = _literal(stmt.value, env) except UnsupportedStaticExpression: value = _INVALID else: value = _INVALID continue if isinstance(stmt, ast.AnnAssign): if not isinstance(stmt.target, ast.Name) or stmt.target.id != name: continue if stmt.value is None: continue try: value = _literal(stmt.value, env) except UnsupportedStaticExpression: value = _INVALID continue if isinstance(stmt, ast.AugAssign): if isinstance(stmt.target, ast.Name) and stmt.target.id == name: value = _INVALID continue if isinstance(stmt, ast.Delete): if name in _delete_target_names(stmt): value = _INVALID continue if isinstance(stmt, ast.Expr): if name in _mutating_call_target_names(stmt): value = _INVALID if name in _bound_names(stmt): value = _INVALID continue if isinstance(stmt, (ast.If, ast.For, ast.AsyncFor, ast.While, ast.Try, ast.With, ast.AsyncWith, ast.Match)): if name in _assigned_names_in_control_flow(stmt): value = _INVALID continue if name in _bound_names(stmt): value = _INVALID if value in (_MISSING, _INVALID): return None return value def _input_types(cls, env): for stmt in cls.body: if not isinstance(stmt, ast.FunctionDef) or stmt.name != "INPUT_TYPES": continue if len(stmt.body) != 1 or not isinstance(stmt.body[0], ast.Return): return None try: value = _literal(stmt.body[0].value, env) except UnsupportedStaticExpression: return None return value if isinstance(value, dict) else None return None def _mapping_value_name(value): if isinstance(value, str): return value if isinstance(value, ast.Name): return value.id return None def _name_is_assigned(stmt, name): return name in _assignment_target_names(stmt) def _module_dict_entries(node, env, value_converter): if not isinstance(node, ast.Dict): raise UnsupportedStaticExpression(type(node).__name__) result = {} for key, value in zip(node.keys, node.values): if key is None: raise UnsupportedStaticExpression("dict unpacking is not supported") converted_value = value_converter(value) if converted_value is None: continue result[_literal(key, env)] = converted_value return result def _final_module_dict(tree, env, name, value_converter): value = _MISSING for stmt in tree.body: if isinstance(stmt, ast.Assign): if not _name_is_assigned(stmt, name): if isinstance(stmt.value, ast.Name) and stmt.value.id == name: value = _INVALID continue if len(stmt.targets) == 1 and isinstance(stmt.targets[0], ast.Name): try: value = _module_dict_entries(stmt.value, env, value_converter) except UnsupportedStaticExpression: value = _INVALID else: value = _INVALID continue if isinstance(stmt, ast.AnnAssign): if not _name_is_assigned(stmt, name): if isinstance(stmt.value, ast.Name) and stmt.value.id == name: value = _INVALID continue if isinstance(stmt.target, ast.Name) and stmt.value is not None: try: value = _module_dict_entries(stmt.value, env, value_converter) except UnsupportedStaticExpression: value = _INVALID else: value = _INVALID continue if isinstance(stmt, ast.AugAssign): if _name_is_assigned(stmt, name): value = _INVALID continue if isinstance(stmt, ast.Delete): if name in _delete_target_names(stmt): value = _INVALID continue if isinstance(stmt, ast.Expr): if name in _mutating_call_target_names(stmt): value = _INVALID if name in _bound_names(stmt): value = _INVALID continue if isinstance(stmt, (ast.If, ast.For, ast.AsyncFor, ast.While, ast.Try, ast.With, ast.AsyncWith, ast.Match)): if name in _assigned_names_in_control_flow(stmt): value = _INVALID continue if _has_wildcard_import(stmt): value = _INVALID continue if name in _bound_names(stmt): value = _INVALID if value in (_MISSING, _INVALID): return {} return value def _node_class_mappings(tree, env): mappings = _final_module_dict(tree, env, "NODE_CLASS_MAPPINGS", _mapping_value_name) return {str(node_type): class_name for node_type, class_name in mappings.items() if node_type and class_name} def _display_mappings(tree, env): displays = _final_module_dict(tree, env, "NODE_DISPLAY_NAME_MAPPINGS", lambda value: _literal(value, env)) return {str(k): str(v) for k, v in displays.items()} def _signature_from_class(node_type, cls, display, pack_meta, env): input_types = _input_types(cls, env) return_types = _class_attr(cls, "RETURN_TYPES", env) return_names = _class_attr(cls, "RETURN_NAMES", env) if not isinstance(input_types, dict) or not isinstance(return_types, (list, tuple)): return None inputs = {} required = [] for section in ("required", "optional"): values = input_types.get(section) or {} if not isinstance(values, dict): return None for name, spec in values.items(): inputs[str(name)] = normalise_input_spec(spec) if section == "required": required.append(str(name)) output_names = [] if isinstance(return_names, (list, tuple)): output_names = [str(name) for name in return_names] return { "type": node_type, "display": display or node_type, "pack": pack_meta["id"], "repository": pack_meta.get("repository", ""), "inputs": inputs, "required": required, "outputs": [str(value) for value in return_types], "output_names": output_names, "confidence": "static_exact", } def _python_files(repo_dir): skipped = {".git", "__pycache__", ".venv", "venv", "env", "site-packages"} for root, dirs, files in os.walk(repo_dir): dirs[:] = [dirname for dirname in dirs if dirname not in skipped] for filename in files: if filename.endswith(".py"): yield Path(root, filename) def _parse_python_file(path): try: return ast.parse(path.read_text(encoding="utf-8"), filename=str(path)) except UnicodeDecodeError: return None except SyntaxError: return None def extract_repo_signatures(repo_dir, pack_meta): nodes = {} for path in sorted(_python_files(repo_dir)): tree = _parse_python_file(path) if tree is None: continue env = _collect_module_env(tree) mappings = _node_class_mappings(tree, env) displays = _display_mappings(tree, env) classes = _class_defs(tree) for node_type, class_name in sorted(mappings.items()): cls = classes.get(class_name) if cls is None: continue sig = _signature_from_class(node_type, cls, displays.get(node_type), pack_meta, env) if sig is not None: nodes[node_type] = sig pack = { "id": pack_meta["id"], "title": pack_meta.get("title", pack_meta["id"]), "repository": pack_meta.get("repository", ""), "rank": pack_meta.get("rank", 0), "status": "ok" if nodes else "no_static_nodes", "node_count": len(nodes), } return {"pack": pack, "nodes": nodes} def _sorted_json_value(value): if isinstance(value, dict): return {key: _sorted_json_value(value[key]) for key in sorted(value)} if isinstance(value, list): return [_sorted_json_value(item) for item in value] return value def write_artifact(path, sources, packs, nodes): payload = { "schema_version": SCHEMA_VERSION, "generated_at": datetime.now(timezone.utc).replace(microsecond=0).isoformat().replace("+00:00", "Z"), "sources": _sorted_json_value(sources), "packs": _sorted_json_value(packs), "nodes": _sorted_json_value(nodes), } path.parent.mkdir(parents=True, exist_ok=True) path.write_text(json.dumps(payload, indent=2, sort_keys=False) + "\n", encoding="utf-8")