Golang 生成趣味头像的库与命令行工具 - govatar

govatar 简介

govatar 是一个用 Go 语言编写的库和命令行工具，用于生成风格化的头像（类似 Gravatar 但更灵活）。它可以生成基于性别、主题和用户 ID 的随机头像，支持多种输出格式。

安装 govatar

作为库使用

go get github.com/o1egl/govatar

作为命令行工具使用

go install github.com/o1egl/govatar/cmd/govatar@latest

基本使用示例

1. 作为库使用

package main

import (
	"fmt"
	"image/png"
	"os"
	
	"github.com/o1egl/govatar"
)

func main() {
	// 生成男性头像
	maleAvatar, err := govatar.Generate(govatar.MALE)
	if err != nil {
		fmt.Println("Error generating male avatar:", err)
		return
	}
	
	// 保存男性头像
	maleFile, err := os.Create("male_avatar.png")
	if err != nil {
		fmt.Println("Error creating file:", err)
		return
	}
	defer maleFile.Close()
	png.Encode(maleFile, maleAvatar)
	
	// 生成女性头像
	femaleAvatar, err := govatar.Generate(govatar.FEMALE)
	if err != nil {
		fmt.Println("Error generating female avatar:", err)
		return
	}
	
	// 保存女性头像
	femaleFile, err := os.Create("female_avatar.png")
	if err != nil {
		fmt.Println("Error creating file:", err)
		return
	}
	defer femaleFile.Close()
	png.Encode(femaleFile, femaleAvatar)
	
	fmt.Println("Avatars generated successfully!")
}

2. 作为命令行工具使用

# 生成随机男性头像
govatar generate male -o male_avatar.png

# 生成随机女性头像
govatar generate female -o female_avatar.png

# 基于特定用户名生成确定性头像
govatar generate -u "john.doe@example.com" -o john_avatar.png

# 生成头像并指定大小
govatar generate male -s 512 -o large_avatar.png

高级功能

1. 自定义主题

govatar 支持自定义颜色主题：

package main

import (
	"image/png"
	"os"
	
	"github.com/o1egl/govatar"
)

func main() {
	// 创建自定义主题
	customTheme := &govatar.Theme{
		BackgroundColor: []string{"#FF5733", "#33FF57", "#3357FF"},
		HairColor:       []string{"#000000", "#333333"},
		SkinColor:       []string{"#F5D0A9", "#F7BE81"},
		ClothesColor:    []string{"#FFFFFF", "#EEEEEE"},
	}
	
	// 设置自定义主题
	govatar.SetTheme(customTheme)
	
	// 使用自定义主题生成头像
	avatar, err := govatar.Generate(govatar.MALE)
	if err != nil {
		panic(err)
	}
	
	file, err := os.Create("custom_theme_avatar.png")
	if err != nil {
		panic(err)
	}
	defer file.Close()
	
	png.Encode(file, avatar)
}

2. 基于用户名的确定性头像

package main

import (
	"image/png"
	"os"
	
	"github.com/o1egl/govatar"
)

func main() {
	// 基于用户名生成确定性头像
	avatar, err := govatar.GenerateForUsername(govatar.MALE, "john.doe@example.com")
	if err != nil {
		panic(err)
	}
	
	file, err := os.Create("deterministic_avatar.png")
	if err != nil {
		panic(err)
	}
	defer file.Close()
	
	png.Encode(file, avatar)
}

命令行工具完整选项

Usage:
  govatar [command]

Available Commands:
  generate    Generate avatar
  help        Help about any command
  version     Print the version number

Flags:
  -h, --help   help for govatar

Use "govatar [command] --help" for more information about a command.

生成命令选项：

govatar generate [flags]

Flags:
  -f, --female             Generate female avatar
  -h, --help               help for generate
  -m, --male               Generate male avatar
  -o, --output string      Output file (default "avatar.png")
  -s, --size int           Image size (default 200)
  -t, --theme string       Theme name (light/dark)
  -u, --username string    Deterministic generation based on username

总结

govatar 是一个简单易用的 Go 头像生成库和工具，具有以下特点：

1. 支持生成男性和女性风格化头像
2. 支持基于用户名的确定性生成
3. 可自定义颜色主题
4. 提供命令行工具和库两种使用方式
5. 轻量级，无外部依赖

你可以根据需要将 govatar 集成到你的 Go 应用中，或者直接使用命令行工具快速生成头像。生成的图像可以用于用户系统、评论系统等需要用户头像但又不希望强制用户上传的场景。