a Go interpreter that can be used in plugins and debuggers.

This is work in progress. See examples for runnable examples using the gi cli. See status for the supported Go language features.

go install github.com/emicklei/gi/cmd/gi@latest

gi run .

For development, the following environment variables control the execution and output:

• GI_TRACE=1 : produce tracing of the virtual machine that executes the statements and expressions.
• GI_CALL=out.dot : produce a Graphviz DOT file showing the call graph.
• GI_AST=out.ast : produce the mirror AST text file.

package main

import "github.com/emicklei/gi"

func main() {
	pkg, _ := gi.ParseSource(`package main

import "fmt"

func Hello(name string) int {
	fmt.Println("Hello,", name)
	return 42
}
`)
	answer, err := gi.Call(pkg, "Hello", "3i/Atlas")
}

The build pipeline uses all programs of Go By Example to check whether they are executable with gi.

© 2025. https://ernestmicklei.com . MIT License