ast.md

Overview

• How to parse and (re)write *.go source files

Key Concepts

1. Use parser.ParseFile(...) to build a *ast.File from a file or from source as []byte
2. Use printer.Fprint(...) to write a *ast.File to a Writer
3. core ast package handles comments poorly
   1. see https://github.com/dave/dst

Idioms

TODO ...

Other Resources

1. https://github.com/dave/dst
2. https://eli.thegreenplace.net/2021/rewriting-go-source-code-with-ast-tooling/
3. https://medium.com/justforfunc/understanding-go-programs-with-go-parser-c4e88a6edb87
4. https://astexplorer.net/
5. https://yuroyoro.github.io/goast-viewer/index.html
6. https://abhinavg.net/posts/understanding-token-pos/