parser

Documentation

Overview

Package parser wraps Go's go/parser to produce ASTs from source files with error tolerance. Partial ASTs are returned even when files contain syntax errors.

Index

• type ParsedFile
  • func ParseFile(sf model.SourceFile, log *slog.Logger) (*ParsedFile, error)
  • func ParseFiles(files []model.SourceFile, log *slog.Logger) []*ParsedFile

Types

type ParsedFile

type ParsedFile struct {
	File    *ast.File
	Fset    *token.FileSet
	Source  model.SourceFile
	Content []byte
}

ParsedFile holds the AST and metadata for a single parsed Go source file.

func ParseFile

func ParseFile(sf model.SourceFile, log *slog.Logger) (*ParsedFile, error)

ParseFile parses a single Go source file. It tolerates syntax errors and returns partial ASTs when possible. If the file fails to parse entirely, it returns nil with an error.

func ParseFiles

func ParseFiles(files []model.SourceFile, log *slog.Logger) []*ParsedFile

ParseFiles parses all source files and returns successfully parsed files. Files that fail to parse are logged and skipped.