go-ataman：Golang终端ANSI彩色文本渲染库

go-ataman是一个轻量级的Golang库，用于在终端中渲染带有ANSI颜色代码的彩色文本模板。它提供了一种简单的方式来创建和渲染彩色终端输出。

基本特性

• 支持16色和256色ANSI颜色代码
• 简单的模板语法
• 高性能的模板渲染
• 支持嵌套样式
• 线程安全

安装

go get github.com/workanator/go-ataman

基本用法

1. 创建渲染器

package main

import (
	"fmt"
	"github.com/workanator/go-ataman"
)

func main() {
	// 创建默认渲染器
	renderer := ataman.DefaultRenderer()
	
	// 渲染彩色文本
	colored := renderer.MustRender("<green>Hello</green>, <red>World</red>!")
	fmt.Println(colored)
}

2. 模板语法

go-ataman使用类似HTML的标签语法来定义颜色和样式：

text := renderer.MustRender(`
<light/yellow>Warning:</> This is a <b>bold</b> message with 
<fg=white,bg=blue>white on blue</> text.
`)
fmt.Println(text)

3. 预定义样式

// 使用预定义样式
text := renderer.MustRender(`
<header>This is a header</header>
<error>Error message</error>
<success>Success message</success>
`)
fmt.Println(text)

4. 自定义渲染器

// 创建自定义渲染器
r := ataman.New(ataman.Config{
	// 定义自定义样式
	StylePrimitives: map[string]string{
		"header":  "fg=white bg=blue bold",
		"error":   "fg=red bold",
		"success": "fg=green bold",
	},
	// 禁用颜色（用于非TTY输出）
	Disabled: false,
})

// 使用自定义样式
text := r.MustRender("<header>Custom Header</header>")
fmt.Println(text)

5. 嵌套样式

text := renderer.MustRender(`
<green>This is <b>bold green</b> text</green>
`)
fmt.Println(text)

6. 动态内容渲染

data := struct {
	Name string
	Age  int
}{
	Name: "Alice",
	Age:  30,
}

// 使用模板渲染动态内容
tpl := "<green>Name:</> {Name} <red>Age:</> {Age}"
result := renderer.MustRenderf(tpl, data)
fmt.Println(result)

颜色和样式参考

基本颜色

• black, red, green, yellow, blue, magenta, cyan, white
• light/前缀表示亮色变体，如light/red

文本属性

• b 或 bold - 粗体
• u 或 underline - 下划线
• i 或 italic - 斜体
• inverse - 反色
• strike - 删除线

高级颜色指定

• fg=<color> - 前景色
• bg=<color> - 背景色
• 256色模式：fg=124, bg=202
• RGB模式：fg=255;100;0, bg=0;50;100

性能考虑

go-ataman在渲染前会缓存已解析的模板，因此重复渲染相同的模板非常高效。对于动态内容，建议使用Renderf方法而不是字符串拼接。

完整示例

package main

import (
	"fmt"
	"github.com/workanator/go-ataman"
)

func main() {
	// 创建自定义渲染器
	r := ataman.New(ataman.Config{
		StylePrimitives: map[string]string{
			"header":  "fg=white bg=blue bold",
			"error":   "fg=red bold",
			"success": "fg=green bold",
			"warning": "fg=yellow bold",
		},
	})

	// 渲染各种样式
	fmt.Println(r.MustRender("<header>Application Status</header>"))
	fmt.Println(r.MustRender("<success>✓ Service is running</success>"))
	fmt.Println(r.MustRender("<warning>⚠ Maintenance scheduled</warning>"))
	fmt.Println(r.MustRender("<error>✗ Database connection failed</error>"))

	// 复杂嵌套示例
	fmt.Println(r.MustRender(`
<header>User Details:</>
  <green>Name:</> {Name}
  <yellow>Age:</> {Age} years
  <cyan>Status:</> <b>{Status}</b>
`, struct {
		Name   string
		Age    int
		Status string
	}{
		Name:   "Alice",
		Age:    30,
		Status: "active",
	}))
}

go-ataman是一个简单但功能强大的库，适合需要在终端输出中添加颜色和样式的Golang应用程序。它的轻量级设计和直观的模板语法使得集成和使用都非常方便。