xonfig

README

xonfig-go v2

Load configuration from either CONFIG environment variable or config.toml. Simple, strict.

Import

import "github.com/nixberg/xonfig-go/v2"

Example

package main

import (
	"github.com/gin-gonic/gin"
	"github.com/nixberg/xonfig-go/v2"
)

func main() {
	config := xonfig.MustLoad[struct {
		GinMode         string
		ListenAddress   string
		TrustedPlatform string

		Accounts gin.Accounts
	}]()

	...
}

Contents of ./config.toml:

GinMode = "debug"
ListenAddress = "localhost:8080"
TrustedPlatform = ""

Accounts = {}

Contents of CONFIG environment variable:

GinMode = "release"
ListenAddress = "0.0.0.0:8080"
TrustedPlatform = "CF-Connecting-IP"

[Accounts]
admin = "8mwf9mrtbu2z2zhbec7qg6kc63"

Documentation

Index

• func MustLoad[Config any]() (config Config)
• func MustLoadOr[Config any](config Config) Config

Functions

func MustLoad

func MustLoad[Config any]() (config Config)

func MustLoadOr

func MustLoadOr[Config any](config Config) Config