Popularity
0.4
Growing
Activity
0.6
-
0
0
0
Description
Quick and easy way to load config files based on a simple set of rules.
Project inspired by https://github.com/lorenwest/node-config
Programming language: Go
txgruppi-config alternatives and similar packages
Based on the "Configuration" category
-
kelseyhightower/envconfig
Go library for managing configuration data from environment variables. -
konfig
Composable, observable and performant config handling for Go for the distributed processing era. -
hjson
Human JSON, a configuration file format for humans. Relaxed syntax, fewer mistakes, more comments. -
gcfg
read INI-style configuration files into Go structs; supports user-defined types and subsections -
joshbetz/config
A small configuration library for Go that parses environment variables, JSON files, and reloads automatically on SIGHUP. -
gookit/config
application config manage(load,get,set). support JSON, YAML, TOML, INI, HCL. multi file load, data override merge. -
koanf
Light weight, extensible library for reading config in Go applications. Built in support for JSON, TOML, YAML, env, command line. -
goConfig
Parse a struct as input and populates the fields of this struct with parameters fom command line, environment variables and configuration file. -
onion
Layer based configuration for Go, Supports JSON, TOML, YAML, properties, etcd, env, and encryption using PGP. -
harvester
Harvester, a easy to use static and dynamic configuration package supportig seeding, env vars and Consul integration. -
configure
Provides configuration through multiple sources, including JSON, flags and environment variables. -
configuro
opinionated configuration loading & validation framework from ENV and Files focused towards 12-Factor compliant applications. -
configuration
Library for initializing configuration structs from env variables, files, flags and 'default' tag. -
hocon
Configuration library for working with the HOCON(a human-friendly JSON superset) format, supports features like environment variables, referencing other values, comments and multiple files. -
sprbox
Build-environment aware toolbox factory and agnostic config parser (YAML, TOML, JSON and Environment vars). -
swap
Instantiate/configure structs recursively, based on build environment. (YAML, TOML, JSON and env). -
gone/jconf
Modular JSON configuration. Keep you config structs along the code they configure and delegate parsing to submodules without sacrificing full config serialization. -
nasermirzaei89/env
Simple useful package for read environment variables. -
go-aws-ssm
Go package that fetches parameters from AWS System Manager -
typenv
Minimalistic, zero dependency, typed environment variables library.
Do you think we are missing an alternative of txgruppi-config or a related project?
README
config
Quick and easy way to load config files based on a simple set of rules.
Project inspired by https://github.com/lorenwest/node-config
Important stuff
Supported files
Before you can load any file you must register parsers using Loader.RegisterParser.
Each parser has a list of supported extensions that will be used to find files to load.
Config folder
By default the load will try to find the files based on the environment variable name given to it (defaults to CONFIG_DIR). If the variable name is empty or the variable value is empty, it will look for files in ./config.
File load order
default.{ext}
{deployment}.{ext}
{hostname}.{ext}
{hostname}-{deployment}.{ext}
local.{ext}
local-{deployment}.{ext}
Where
{ext}is one of the registered extensions.{deployment}is the deployment name, from the$ENVenvironment variable. (No default value, ignored if empty){hostname}is the value returned fromos.Hostname()with no changes. (No default value, ignored if empty)
Installation
go get -u github.com/txgruppi/config
Example
package main
import (
"fmt"
"log"
"github.com/txgruppi/config"
"github.com/txgruppi/config/parsers/json"
)
type Config struct {
Server struct {
Bind string `json:"bind"`
Port int `json:"port"`
} `json:"server"`
}
func main() {
loader := NewLoader()
if err := loader.RegisterParser(json.NewParser()); err != nil {
log.Fatal(err)
}
var config Config
info, err := loader.Load(&config)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Looked for files in: %s\n", info.ConfigFolder)
fmt.Printf("Loaded files: %v\n", info.LoadedFiles)
fmt.Printf("Loaded config: %v\n", config)
}