Gentee - Go 嵌入式脚本语言插件库

Gentee 是一个轻量级的 Go 嵌入式脚本语言，它允许你在 Go 应用程序中嵌入脚本功能。Gentee 脚本语法简单，执行速度快，特别适合需要动态执行用户提供逻辑的场景。

主要特性

• 简单易学的脚本语法
• 与 Go 无缝集成
• 高性能执行
• 类型安全
• 支持协程
• 内置标准库

安装

go get github.com/gentee/gentee

基本使用示例

1. 执行简单脚本

package main

import (
	"fmt"
	"github.com/gentee/gentee"
)

func main() {
	// 创建 Gentee 工作空间
	workspace := gentee.New()

	// 执行简单脚本
	result, err := workspace.Run(`"Hello, Gentee!"`, nil)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Println(result) // 输出: Hello, Gentee!
}

2. 使用变量和函数

package main

import (
	"fmt"
	"github.com/gentee/gentee"
)

func main() {
	workspace := gentee.New()

	script := `
		func add(a int, b int) int {
			return a + b
		}
		
		x = 5
		y = 7
		add(x, y)
	`

	result, err := workspace.Run(script, nil)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Println(result) // 输出: 12
}

3. 与 Go 交互

package main

import (
	"fmt"
	"github.com/gentee/gentee"
)

func main() {
	workspace := gentee.New()

	// 注册 Go 函数供脚本调用
	err := workspace.RegisterFunc("double", func(i int64) int64 {
		return i * 2
	})
	if err != nil {
		fmt.Println("Error registering function:", err)
		return
	}

	script := `
		x = 10
		double(x)
	`

	result, err := workspace.Run(script, nil)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Println(result) // 输出: 20
}

4. 处理复杂数据结构

package main

import (
	"fmt"
	"github.com/gentee/gentee"
)

func main() {
	workspace := gentee.New()

	script := `
		func process(data map) map {
			data["processed"] = true
			data["value"] *= 2
			return data
		}
		
		input = {"value": 5, "name": "test"}
		process(input)
	`

	result, err := workspace.Run(script, nil)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Printf("%+v\n", result) 
	// 输出: map[name:test processed:true value:10]
}

5. 错误处理

package main

import (
	"fmt"
	"github.com/gentee/gentee"
)

func main() {
	workspace := gentee.New()

	script := `
		func divide(a int, b int) int {
			if b == 0 {
				error("division by zero")
			}
			return a / b
		}
		
		divide(10, 0)
	`

	_, err := workspace.Run(script, nil)
	if err != nil {
		fmt.Println("Script error:", err)
		// 输出: Script error: division by zero (line 4)
	}
}

高级特性

协程支持

package main

import (
	"fmt"
	"time"
	"github.com/gentee/gentee"
)

func main() {
	workspace := gentee.New()

	script := `
		func worker(id int) {
			for i in 1..5 {
				sleep(100) // 毫秒
				println("Worker $$id: $$i")
			}
		}
		
		go worker(1)
		go worker(2)
		sleep(1000)
	`

	_, err := workspace.Run(script, nil)
	if err != nil {
		fmt.Println("Error:", err)
	}
	// 输出两个worker交替执行的日志
	time.Sleep(2 * time.Second)
}

自定义类型

package main

import (
	"fmt"
	"github.com/gentee/gentee"
)

type Person struct {
	Name string
	Age  int
}

func main() {
	workspace := gentee.New()

	// 注册自定义类型
	err := workspace.RegisterType("Person", Person{})
	if err != nil {
		fmt.Println("Error registering type:", err)
		return
	}

	// 注册构造函数
	err = workspace.RegisterFunc("newPerson", func(name string, age int64) Person {
		return Person{Name: name, Age: int(age)}
	})
	if err != nil {
		fmt.Println("Error registering function:", err)
		return
	}

	script := `
		p = newPerson("Alice", 30)
		p.Name + " is " + str(p.Age) + " years old"
	`

	result, err := workspace.Run(script, nil)
	if err != nil {
		fmt.Println("Error:", err)
		return
	}
	fmt.Println(result) // 输出: Alice is 30 years old
}

性能优化建议

1. 预编译频繁使用的脚本
2. 复用工作空间对象
3. 限制脚本执行时间和资源使用
4. 对复杂脚本进行模块化

Gentee 是一个强大而灵活的嵌入式脚本解决方案，特别适合需要安全执行用户提供逻辑的 Go 应用程序。它的简单语法和与 Go 的良好集成使其成为许多场景下的理想选择。