gogen

README

gogen

gogen is a token-based source generation library for Go, TypeScript, TSX, and Python. Language adapters provide composable builders while shared internals handle reusable token rendering and layout.

Demo

Generate a formatted Go source file:

package main

import (
	"bytes"
	"fmt"

	gogen "go.osspkg.com/gogen/golang"
)

func main() {
	file := gogen.Package("main").Import("fmt", "fmt").Join(
		gogen.Func().ID("main").Bracket().Block(
			gogen.Pkg("fmt").ID("Println").Call(gogen.Text("hello, gogen")),
		),
	)

	var source bytes.Buffer
	if err := gogen.Render(&source, file); err != nil {
		panic(err)
	}
	fmt.Print(source.String())
}

Getting started

Requires Go 1.26 or newer:

go get go.osspkg.com/gogen/golang go.osspkg.com/gogen/typescript go.osspkg.com/gogen/python

Language guides

Language	Package	Guide
Go	go.osspkg.com/gogen/golang	Go builder guide
TypeScript and TSX	go.osspkg.com/gogen/typescript	TypeScript and TSX guide
Python 3.10+	go.osspkg.com/gogen/python	Python guide

The Go adapter applies go/format by default. The TypeScript and Python adapters write readable source without invoking a formatter; use the language toolchain or a formatter separately when needed.

Contributing

See CONTRIBUTING.md for setup and local checks.

Contributors

License

This project is licensed under the BSD 3-Clause License.