python

type Dependency struct {
	Path       string
	Type       string // "import" | "from"
	LineNumber int
	IsLocal    bool
}

type Entity struct {
	Name      string
	Type      string // "function" | "method" | "class"
	Kind      string // "function" | "async_function" | "method" | "async_method" | "class"
	Signature string
	StartLine int
	EndLine   int
	Docs      string
	Parent    string // name of enclosing class, empty for top-level
}

type ParseResult struct {
	FilePath     string
	Entities     []*Entity
	Dependencies []*Dependency
}

type PythonParser struct{}