typedenv

README

TypedEnv

Strongly typed environment variable management for Go.

Configure your requirements using a Go struct. TypedEnv validates required environment variables and returns explicit errors for missing or invalid values. .env files are intentionally unsupported to reduce accidental secret exposure, and to keep configuration sourcing explicit.

Features

• Errors for missing environment variables
• Errors for type mismatches and parsing failures
• No variable values in errors or logs
• No iteration of OS variables; look only at what's necessary
• No unsafe usage
• No panics

Installation

go get github.com/saas-craft/typedenv

Usage

package main

import (
    "fmt"
    "log"
    "net/url"
    "time"

    "github.com/saas-craft/typedenv"
)

func main() {
    type config struct {
        AppHost    string        `env:"HOST"`
        AppPort    int           `env:"PORT"`
        Timeout    time.Duration `env:"TIMEOUT"`
        ServiceURL url.URL       `env:"SERVICE_URL"`
    }

    cfg, err := typedenv.Load[config]()
    if err != nil {
        log.Fatalf("load config: %v", err)
    }

    fmt.Println(cfg)
}

Supported Types

Go Type	Example value
string	hello
bool	true, false, 1, 0
int, int8, int16, int32, int64	-42
uint, uint8, uint16, uint32, uint64	42
float32, float64	3.14
time.Duration	1h30m, 500ms, 2s
url.URL	https://saascraft.com/v1

License

SaaS Craft TypedEnv is licensed under the MIT License - see LICENSE for details.

Documentation

Overview

Package typedenv is a strongly typed environment variable manager.

Index

• func Load[S any]() (S, error)

Functions

func Load

func Load[S any]() (S, error)

Load returns a new instance of the given struct, or an error. It fills public fields with operating system environment variable values. The struct fields must be tagged with `env`, which specifies the environment variable key value to use eg. `env:"APP_ENV"`.