使用mini库解析INI风格配置文件

mini是一个轻量级的Go语言INI配置文件解析库，它提供了简单易用的API来读取和操作INI格式的配置文件。下面我将详细介绍如何使用mini库。

安装mini库

首先需要安装mini库：

go get github.com/go-ini/ini

基本使用方法

1. 加载INI文件

package main

import (
	"fmt"
	"log"
	
	"gopkg.in/ini.v1"
)

func main() {
	cfg, err := ini.Load("my.ini")
	if err != nil {
		log.Fatalf("Fail to read file: %v", err)
	}
	
	// 获取默认分区(section)的值
	fmt.Println("App Mode:", cfg.Section("").Key("app_mode").String())
	
	// 获取指定分区的值
	fmt.Println("Data Path:", cfg.Section("paths").Key("data").String())
}

2. 读取不同类型的值

mini支持自动类型转换：

// 读取字符串
val := cfg.Section("section").Key("key").String()

// 读取整数
num, err := cfg.Section("section").Key("key").Int()

// 读取布尔值
flag, err := cfg.Section("section").Key("key").Bool()

// 读取浮点数
f, err := cfg.Section("section").Key("key").Float64()

3. 检查键是否存在

if cfg.Section("section").HasKey("key") {
	// 键存在
}

4. 获取所有分区和键

// 获取所有分区
sections := cfg.Sections()
for _, section := range sections {
	fmt.Println("Section:", section.Name())
	
	// 获取分区下所有键
	keys := section.Keys()
	for _, key := range keys {
		fmt.Printf("%s = %s\n", key.Name(), key.Value())
	}
}

高级功能

1. 设置默认值

value := cfg.Section("section").Key("key").MustString("default_value")

2. 修改和保存配置

// 修改值
cfg.Section("section").Key("key").SetValue("new_value")

// 添加新分区和键
cfg.Section("new_section").Key("new_key").SetValue("value")

// 保存到文件
err = cfg.SaveTo("my.ini")
if err != nil {
	log.Fatal(err)
}

3. 结构体映射

mini支持将配置映射到结构体：

type ServerConfig struct {
	Port     int    `ini:"port"`
	Host     string `ini:"host"`
	LogLevel string `ini:"log_level"`
}

func main() {
	cfg, err := ini.Load("server.ini")
	if err != nil {
		log.Fatal(err)
	}
	
	var server ServerConfig
	err = cfg.Section("server").MapTo(&server)
	if err != nil {
		log.Fatal(err)
	}
	
	fmt.Printf("Server config: %+v\n", server)
}

4. 从字符串加载配置

data := `
app_mode = development

[server]
port = 8080
`

cfg, err := ini.Load([]byte(data))
if err != nil {
	log.Fatal(err)
}

实际示例

下面是一个完整的示例，展示如何读取和修改INI配置文件：

package main

import (
	"fmt"
	"log"
	
	"gopkg.in/ini.v1"
)

func main() {
	// 加载或创建配置文件
	cfg, err := ini.Load("config.ini")
	if err != nil {
		fmt.Println("配置文件不存在，将创建新文件")
		cfg = ini.Empty()
	}
	
	// 确保有默认分区
	if _, err := cfg.GetSection(""); err != nil {
		_, err = cfg.NewSection("")
		if err != nil {
			log.Fatal(err)
		}
	}
	
	// 设置默认值
	cfg.Section("").Key("app_name").SetValue("My Awesome App")
	cfg.Section("").Key("version").SetValue("1.0.0")
	
	// 确保有database分区
	if _, err := cfg.GetSection("database"); err != nil {
		_, err = cfg.NewSection("database")
		if err != nil {
			log.Fatal(err)
		}
	}
	
	// 设置数据库配置
	cfg.Section("database").Key("host").SetValue("localhost")
	cfg.Section("database").Key("port").SetValue("3306")
	cfg.Section("database").Key("username").SetValue("root")
	cfg.Section("database").Key("password").SetValue("secret")
	
	// 保存配置
	err = cfg.SaveTo("config.ini")
	if err != nil {
		log.Fatal(err)
	}
	
	fmt.Println("配置文件已保存")
	
	// 读取配置
	host := cfg.Section("database").Key("host").String()
	port := cfg.Section("database").Key("port").MustInt(3306)
	
	fmt.Printf("数据库配置: host=%s, port=%d\n", host, port)
}

总结

mini库提供了以下主要功能：

1. 加载和解析INI格式文件
2. 支持多种数据类型读取
3. 支持配置修改和保存
4. 支持结构体映射
5. 轻量级且API简单易用

对于需要处理INI配置文件的Go项目，mini是一个非常好的选择，它既简单又功能齐全，能够满足大多数配置管理的需求。