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>.pymodulecontainert 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ályokKü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ésasync 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); aselfés aclskimarad. - Konstansok:
NAGYBETŰSnevek, 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 éstry/ifalatt 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ória | Mikor |
|---|---|
internal_helper | ugyanabban a fájlban definiált függvény, vagy self.f() / cls.f() a fájlbeli metódusra |
instantiation | nagybetűs puszta név, Foo() |
static_call | Osztály.metódus() a fájlban definiált osztályon |
native_python | beépített függvények, stdlib-modulok és gyakori beépített metódusok: len, os.path.join, append… |
external_call | importált nem-stdlib csomag, super().x(), vagy olyan fogadó, amit a callgraph nem tud megnevezni |
global_helper | ismeretlen 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ójaselfmarad, é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
appendisnative_python.