yaegi

Yaegi 是另一个优雅的 Go 解释器。它为可执行的 Go 脚本和插件提供支持，可用于嵌入式解释器或交互式 shell，基于 Go 运行时。

特性

完全支持 Go 语言规范
使用纯 Go 编写，仅使用标准库
简单的解释器 API：New()、Eval()、Use()
可在 Go 支持的任何地方运行
所有 Go 和运行时资源都可从脚本访问（可控制）
安全性：默认情况下不使用也不导出 unsafe 和 syscall 包
支持最新的两个主要 Go 版本（Go 1.21 和 Go 1.22）

安装

Go 包

import "github.com/traefik/yaegi/interp"

命令行可执行文件

go install github.com/traefik/yaegi/cmd/yaegi@latest

注意，您可以使用 rlwrap（使用您喜欢的包管理器安装），并在 ~/.bashrc 中将 yaegi 命令别名为 alias yaegi='rlwrap yaegi'，以获得历史记录和命令行编辑功能。

CI 集成

curl -sfL https://raw.githubusercontent.com/traefik/yaegi/master/install.sh | bash -s -- -b $GOPATH/bin v0.9.0

使用方法

作为嵌入式解释器

使用 New() 创建解释器，使用 Eval() 运行 Go 代码：

package main

import (
	"github.com/traefik/yaegi/interp"
	"github.com/traefik/yaegi/stdlib"
)

func main() {
	i := interp.New(interp.Options{})

	i.Use(stdlib.Symbols)

	_, err := i.Eval(`import "fmt"`)
	if err != nil {
		panic(err)
	}

	_, err = i.Eval(`fmt.Println("Hello Yaegi")`)
	if err != nil {
		panic(err)
	}
}

Go Playground

作为动态扩展框架

以下程序是预先编译的，除了 bar() 是解释执行的，具体步骤如下：

使用 i.Eval(src) 在解释器上下文中评估脚本
使用 v, err := i.Eval("foo.Bar") 从解释器上下文获取符号，作为 reflect.Value
应用 Interface() 方法和类型断言将 v 转换为 bar，就像它是编译好的一样

package main

import "github.com/traefik/yaegi/interp"

const src = `package foo
func Bar(s string) string { return s + "-Foo" }`

func main() {
	i := interp.New(interp.Options{})

	_, err := i.Eval(src)
	if err != nil {
		panic(err)
	}

	v, err := i.Eval("foo.Bar")
	if err != nil {
		panic(err)
	}

	bar := v.Interface().(func(string) string)

	r := bar("Kung")
	println(r)
}

Go Playground

作为命令行解释器

Yaegi 命令可以运行交互式的读取-求值-打印循环（REPL）：

$ yaegi
> 1 + 2
3
> import "fmt"
> fmt.Println("Hello World")
Hello World
>

请注意，在交互模式下，所有标准库包都是预先导入的，您可以直接使用它们：

$ yaegi
> reflect.TypeOf(time.Date)
: func(int, time.Month, int, int, int, int, int, *time.Location) time.Time
>

或者解释 Go 包、目录或文件，包括它自身：

$ yaegi -syscall -unsafe -unrestricted github.com/traefik/yaegi/cmd/yaegi
>

或者在 shebang 行中用于 Go 脚本：

$ cat /tmp/test
#!/usr/bin/env yaegi
package main

import "fmt"

func main() {
	fmt.Println("test")
}
$ ls -la /tmp/test
-rwxr-xr-x 1 dow184 dow184 93 Jan  6 13:38 /tmp/test
$ /tmp/test
test