callgraph

Python call graph AI agenteknek

A callgraph a tree-sitter-python-nal elemzi a .py és .pyi fájlokat, és megmutatja az agentnek az osztályokat, függvényeket és metódusokat sortartománnyal, a szignatúrákat és minden hívást kategóriánként.

Mit nyer ki a callgraph a Python-kódból

  • Minden fájl kap egy <fájl>.py module containert a modul-szintű függvényeivel és konstansaival; a modul-docstring a doksija.
  • Osztályok az ősökkel (extends) és dekorátorokkal (uses @dataclass); a beágyazott osztályok Külső.Belső néven; a sortartomány az első dekorátortól indul. ABC ős esetén az osztály absztrakt.
  • Függvények és metódusok: def és async def, @staticmethod, @classmethod, @property (a @cached_property és a setterek is), @abstractmethod. A vezető aláhúzás privátot jelent. A törzs első string-literálja a docstring.
  • Szignatúrák alapértékkel és annotációval: add(n: int): int (--signatures, --format api); a self és a cls kimarad.
  • Konstansok: NAGYBETŰS nevek, minden annotált értékadás és az __all__; az osztály-attribútumok property-ként, a típussal az annotációból vagy az értékből.
  • Importok minden alakban, a relatívak is (from .m import x), függvényen belül és try / if alatt is.
  • String-literálok (az f-stringek statikus részei) és szintaktikai hibák: a nem parse-olható fájl is megmutat mindent a hibás sor előtt és után, plusz egy figyelmeztetést.

A django-t, flask-et vagy fastapi-t importáló fájl az adott keretrendszerrel van jelölve. A __pycache__, venv, .venv és site-packages alapból kimarad.

Hívás-kategóriák

KategóriaMikor
internal_helperugyanabban a fájlban definiált függvény, vagy self.f() / cls.f() a fájlbeli metódusra
instantiationnagybetűs puszta név, Foo()
static_callOsztály.metódus() a fájlban definiált osztályon
native_pythonbeépített függvények, stdlib-modulok és gyakori beépített metódusok: len, os.path.join, append…
external_callimportált nem-stdlib csomag, super().x(), vagy olyan fogadó, amit a callgraph nem tud megnevezni
global_helperismeretlen puszta név, valószínűleg *-gal importált vagy máshol definiált

Parancsok

CG=~/.claude/skills/callgraph/callgraph.sh
bash $CG --project myapp <út/a>/cart.py                  # outline: osztályok, függvények, property-k, hívások
bash $CG --project myapp <út/a>/cart.py --signatures     # a szignatúra minden metódus-soron
bash $CG --project myapp <út/a>/cart.py::add --body      # csak az a metódus, sorszámozva
bash $CG --project myapp <út/a>/cart.py --format api     # csak a publikus felület

Az outline kimenete egy kis fájlra

FILE  pkg/cart.py

module cart.py  L1-11
  constants (1):
    MAX = 3
  __module__()  L2-2
  helper(n)  L10-11

class Cart uses @dataclass  L4-8
  properties (1):
    int $total
  add(n: int): int  L7-8
    internal_helper   helper

Ki hívja ezt a Python-függvényt?

bash $CG --project myapp <mappa> --grep '(^|::|\.|->)helper$'      # a név minden hívása
bash $CG --project myapp <mappa> --grep '(^|::|\.|->)helper$' --depth 2

Pythonban a callgraph nem old fel típusokat, ezért név szerint keress: a minta a helper minden hívását megtalálja, bármi a fogadó. Minden találat a hívás saját forrássorát is mutatja.

Dinamikus hívások: jelölve, nem találgatva

A futásidőben eldőlő célú hívás (getattr(obj, name)(), globals()[name](), importlib.import_module(name), eval / exec) mostantól dynamic_call néven szerepel az outline-ban, a hívott kifejezéssel, nem hiányzik némán.

Jelölés, nem hívó-él: a --grep, a --depth és a locate figyelmen kívül hagyja, a --depth pedig megmondja, hány hívó tartalmaz ilyet. A literál esetek (pl. getattr(obj, 'x')()) közönséges hívások maradnak. Szűrés: --category dynamic_call.

bash ~/.claude/skills/callgraph/callgraph.sh --project app a.py

Kimenet (rövidítve)

module a.py  L1-10
  run()  L3-10
    external_call     obj.plain
    native_python     eval, getattr, globals, importlib.import_module
    dynamic_call      eval("1+1"), getattr(obj, name), globals()[name], importlib.import_module(mod)

Korlátok

Ez a Python-támogatás első fázisa.

  • Nincs típus-feloldás: a self.repo.save() fogadója self marad, és az importált modult nem oldja fel fájlra.
  • A keretrendszer-felismerés csak a fájl importjait nézi; még nincsenek Django URL- / modell-nézetek, sem Flask / FastAPI route-nézetek, és nincsenek --format flow ágak.
  • A beágyazott függvény és a lambda nem külön elem: a hívásai a külső függvényhez tartoznak.
  • A beépített metódusok listája név szerinti: egy saját append is native_python.