flagvar - 扩展Go标准flag包参数类型的插件库

flagvar是一个用于扩展Go标准库flag包参数类型的插件库，它提供了许多常见类型的flag变量实现，简化了命令行参数处理。

基本使用

首先安装flagvar库：

go get github.com/namsral/flagvar

常用变量类型示例

1. 字符串切片 (StringSlice)

package main

import (
	"flag"
	"fmt"
	"github.com/namsral/flagvar"
)

func main() {
	var files flagvar.StringSlice
	flag.Var(&files, "file", "input files")
	flag.Parse()
	
	fmt.Println("Files:", files)
}

使用方式：

./program -file file1.txt -file file2.txt -file file3.txt

2. 整数范围 (IntRange)

var portRange flagvar.IntRange
flag.Var(&portRange, "port", "port range (min:max)")
flag.Parse()

fmt.Printf("Port range: %d-%d\n", portRange.Min, portRange.Max)

使用方式：

./program -port 8000:9000

3. 枚举值 (Enum)

var logLevel flagvar.Enum
flag.Var(&logLevel, "log-level", "log level", []string{"debug", "info", "warn", "error"})
flag.Parse()

fmt.Println("Log level:", logLevel)

使用方式：

./program -log-level info

4. 正则表达式 (Regexp)

var pattern flagvar.Regexp
flag.Var(&pattern, "pattern", "regex pattern")
flag.Parse()

fmt.Println("Pattern:", pattern.String())

使用方式：

./program -pattern "^[A-Za-z]+$"

5. 时间间隔 (Duration)

var timeout flagvar.Duration
flag.Var(&timeout, "timeout", "operation timeout")
flag.Parse()

fmt.Println("Timeout:", timeout)

使用方式：

./program -timeout 30s

自定义验证器

type PositiveInt int

func (p *PositiveInt) Set(s string) error {
    v, err := strconv.Atoi(s)
    if err != nil {
        return err
    }
    if v <= 0 {
        return fmt.Errorf("must be positive")
    }
    *p = PositiveInt(v)
    return nil
}

func (p *PositiveInt) String() string {
    return strconv.Itoa(int(*p))
}

func main() {
    var count PositiveInt
    flag.Var(&count, "count", "positive integer")
    flag.Parse()
    
    fmt.Println("Count:", count)
}

完整示例

package main

import (
	"flag"
	"fmt"
	"github.com/namsral/flagvar"
)

func main() {
	// 字符串切片
	var files flagvar.StringSlice
	flag.Var(&files, "file", "input files")
	
	// 整数范围
	var ports flagvar.IntRange
	flag.Var(&ports, "ports", "port range (min:max)")
	
	// 枚举值
	var mode flagvar.Enum
	flag.Var(&mode, "mode", "operation mode", []string{"read", "write", "delete"})
	
	// 正则表达式
	var pattern flagvar.Regexp
	flag.Var(&pattern, "pattern", "matching pattern")
	
	// 时间间隔
	var interval flagvar.Duration
	flag.Var(&interval, "interval", "polling interval")
	
	flag.Parse()
	
	fmt.Println("Files:", files)
	fmt.Printf("Ports: %d-%d\n", ports.Min, ports.Max)
	fmt.Println("Mode:", mode)
	fmt.Println("Pattern:", pattern.String())
	fmt.Println("Interval:", interval)
}

使用方式：

./program -file a.txt -file b.txt -ports 8000:9000 -mode write -pattern ".*go$" -interval 5s

优势

1. 提供丰富的预定义参数类型
2. 简化复杂参数的处理
3. 内置参数验证
4. 与标准flag包完全兼容
5. 易于扩展自定义类型

flagvar库是标准flag包的完美补充，特别适合需要处理复杂命令行参数的场景。