envx

go get github.com/cnb.cool/jun3.work/cloud/envx

# 在 go.mod 中添加
module your/project

go 1.24

require cnb.cool/jun3.work/cloud/envx v1.0.0

package main

import (
    "fmt"
    "cnb.cool/jun3.work/cloud/envx"
)

func main() {
    // 获取整数类型环境变量
    port := envx.Get[int]("PORT", 8080)
    fmt.Printf("Port: %d\n", port)

    // 获取字符串类型环境变量
    name := envx.Get[string]("APP_NAME", "default")
    fmt.Printf("Name: %s\n", name)

    // 获取布尔类型环境变量
    debug := envx.Get[bool]("DEBUG", false)
    fmt.Printf("Debug: %v\n", debug)

    // 获取浮点数类型环境变量
    timeout := envx.Get[float64]("TIMEOUT", 30.0)
    fmt.Printf("Timeout: %f\n", timeout)
}

import (
    "cnb.cool/jun3.work/cloud/envx"
    "time"
)

// 获取时间类型
exp := envx.Get[envx.Time]("EXPIRY", envx.NowTime())
fmt.Println(exp.String()) // RFC3339 格式

// 获取日期类型
startDate := envx.Get[envx.Date]("START_DATE", envx.TodayDate())
fmt.Println(startDate.String()) // 2026-04-15 格式

// 时间操作
fmt.Println(exp.Unix())        // Unix 时间戳
fmt.Println(exp.Year())        // 年份
fmt.Println(exp.Month())       // 月份

// 日期操作
fmt.Println(startDate.AddDays(7))      // 7 天后
fmt.Println(startDate.IsWeekend())    // 是否周末
fmt.Println(startDate.IsWorkday())    // 是否工作日

import "cnb.cool/jun3.work/cloud/envx"

// 解析时长字符串
dur, err := envx.ConvertToDuration("1h30m")
if err != nil {
    panic(err)
}

// 使用自定义 Duration 类型
duration := envx.NewDuration(dur)
fmt.Println(duration.String())        // 1h30m0s
fmt.Println(duration.Hours())         // 1.5

// 时长运算
newDur := duration.Add(envx.NewDuration(30 * time.Minute))
newDur = duration.Multiply(2)
newDur = duration.Divide(3)

// 时长比较
if duration.Greater(other) {
    fmt.Println("当前时长更长")
}

// 时长格式化
fmt.Println(envx.DurationString(dur))

import "cnb.cool/jun3.work/cloud/envx"

// 创建数组
arr := envx.NewArray("apple", "banana", "cherry")

// 数组操作
arr = arr.Append("date")           // 追加元素
arr = arr.Prepend("apricot")       // 前置元素
arr = arr.RemoveValue("banana")    // 移除元素

// 数组查询
if arr.Contains("apple") {
    fmt.Println("包含苹果")
}

// 数组转换
arr = arr.Unique()                 // 去重
arr = arr.Sort()                   // 排序
arr = arr.Reverse()                // 反转

// 数组信息
fmt.Println(arr.Len())             // 长度
fmt.Println(arr.Join(","))         // 连接成字符串

import "cnb.cool/jun3.work/cloud/envx"

// 创建映射
m := envx.NewMap("name", "John", "age", "30")

// 映射操作
m = m.Set("city", "Beijing")       // 设置键值
value, exists := m.Get("name")     // 获取值
m, removed := m.Remove("age")      // 移除键

// 映射查询
if m.Contains("city") {
    fmt.Println("包含城市信息")
}

// 映射信息
keys := m.Keys()                   // 获取所有键
values := m.Values()               // 获取所有值
fmt.Println(m.Len())               // 映射大小

import "cnb.cool/jun3.work/cloud/envx"

// TryGet: 检查键是否存在
val, exists := envx.TryGet("DATABASE_URL")
if exists {
    fmt.Println("数据库配置:", val)
}

// TryGetWithDefault: 尝试获取并转换，返回转换结果和成功标志
port, ok := envx.TryGetWithDefault[int]("PORT", 8080)
if ok {
    fmt.Println("端口:", port)
} else {
    fmt.Println("使用默认端口:", port)
}

envx/
├── README.md           # 项目文档（本文件）
├── go.mod              # Go 模块定义
├── converters.go       # 类型转换函数和自定义类型定义
├── get.go              # 泛型 Get 函数实现
├── utils.go            # 工具函数和辅助功能
├── get_test.go         # 单元测试文件
└── .gitignore          # Git 忽略规则

# 运行所有测试
go test -v

# 运行特定测试
go test -v -run TestGet_Int

# 生成测试覆盖率报告
go test -v -cover

# 查看覆盖率详情
go test -v -coverprofile=coverage.out && go tool cover -html=coverage.out

// 定义配置结构
type Config struct {
    Port      int
    Debug     bool
    Timeout   float64
    Expiry    envx.Time
    Features  envx.Array
}

// 加载配置
func LoadConfig() Config {
    return Config{
        Port:     envx.Get[int]("PORT", 8080),
        Debug:    envx.Get[bool]("DEBUG", false),
        Timeout:  envx.Get[float64]("TIMEOUT", 30.0),
        Expiry:   envx.Get[envx.Time]("EXPIRY", envx.NowTime()),
        Features: envx.Get[envx.Array]("FEATURES", envx.NewArray()),
    }
}

// 使用 TryGetWithDefault 进行验证
if port, ok := envx.TryGetWithDefault[int]("PORT", 0); !ok || port <= 0 {
    log.Fatal("无效的环境变量：PORT")
}

// 合理设置默认值，确保应用不会因缺失配置而崩溃
maxRetries := envx.Get[int]("MAX_RETRIES", 3) // 默认重试 3 次
logLevel := envx.Get[string]("LOG_LEVEL", "info") // 默认日志级别

<type>: <subject>

[optional body]