env

一个简单的零依赖性库，可将env Ironment变量分解为结构。

go get github.com/caarlos0/ env /v11

 type config struct {
  Home string ` env :"HOME"`
}

// parse
var cfg config
err := env . Parse ( & cfg )

// parse with generics
cfg , err := env . ParseAs [ config ]()

您可以在pkg.go.dev上查看完整的文档和示例列表。

Encore - 构建基于GO的云后端的平台。

• Parse ：将当前的env熨斗分解成一种类型
• ParseAs ：使用仿制药将当前的env熨斗分解为一种类型
• ParseWithOptions ：将当前的env熨斗分解为具有自定义选项的类型
• ParseAsWithOptions ：将当前的env熨斗分解为具有自定义选项的类型，并使用仿制药
• Must ：可以用来Parse.*
• GetFieldParams ：获取一种类型的env分析选项
• GetFieldParamsWithOptions ：获取带有自定义选项的类型的env解析选项

开箱即用，所有内置类型都得到了支持，还有一些常用的其他类型。

完整列表：

• bool
• float32
• float64
• int16
• int32
• int64
• int8
• int
• string
• uint16
• uint32
• uint64
• uint8
• uint
• time.Duration
• time.Location
• encoding.TextUnmarshaler
• url.URL

还支持指针的指针，切片和切片以及这些类型的地图。

您也可以为您的类型添加自定义解析器。

提供以下标签：

• env ：设置env Ironment变量名称，并选择取下下面描述的标签选项
• env Default ：设置字段的默认值
• env Prefix ：可以在一个复杂类型的字段中使用，以设置所有env Ironment变量的前缀
• env Separator ：设置用于在切片和地图中分离项目的字符（默认值： , ）
• env KeyValSeparator ：设置用于在地图中分离键及其值的字符（Default ： :

以下是env标签的所有选项：

• ,expand ：扩展env Ironment变量，例如FOO_${BAR}
• ,file ：指示该变量的内容是应读取的文件的途径
• ,init ：初始化零指针
• ,notEmpty ：如果env Ironment变量为空，则将字段错误
• ,required ：如果未设置env Ironment变量，则将字段错误
• ,unset ：使用后拆除env Ironment变量

功能中有几个选项， WithOptions结束：

• env ironment ：要使用的键和值代替os. env iron()
• TagName ：指定要使用的另一个标签名称，而不是默认的env
• PrefixTagName ：指定要使用的另一个前缀标签名称，而不是默认的env Prefix
• DefaultValueTagName ：指定要使用的另一个默认标签名称，而不是默认的env Default
• RequiredIfNoDef ：如果不声明env Default env
• OnSet ：允许在设置值时钩住env分析并做某事
• Prefix ：在所有env Ironment变量中使用的前缀
• UseFieldNameByDefault ：定义如果丢失env键，默认env默认情况
• FuncMap ：自定义类型的自定义解析功能

示例在pkg.go.dev中和示例测试文件中进行。

env被认为是功能完整的。

除非确实有意义，否则我不打算添加任何新功能，并且由许多人要求。

最终的错误修复将继续合并。

• env doc-从env标签生成env铁变量的文档