Golang configuration parser. This package allow to work with flags, environment variables, external sources (json configuration file e.g.).
Alternatives To Envconf
Project NameStarsDownloadsRepos Using ThisPackages Using ThisMost Recent CommitTotal ReleasesLatest ReleaseOpen IssuesLicenseLanguage
a month ago13June 19, 20227otherPHP
Constantly updated lists of world countries and their associated alpha-2, alpha-3 and numeric country codes as defined by the ISO 3166 standard, available in CSV, JSON , PHP, SQL and XML formats, in multiple languages and with national flags included; also available are the ISO 3166-2 codes of provinces/ states associated with the countries
12 months ago33January 07, 2020mitSwift
🚩 Allows developers to configure feature flags, run multiple A/B tests or phase feature roll out using a JSON configuration file.
Config4471818 hours ago59October 16, 20223mitGo
📝 Go configuration manage(load,get,set,export). support JSON, YAML, TOML, Properties, INI, HCL, ENV and Flags. Multi file load, data override merge, parse ENV var. Go应用配置加载管理,支持多种格式,多文件加载,远程文件加载,支持数据合并,解析环境变量名
Aconfig404165 months ago65October 15, 202210mitGo
Simple, useful and opinionated config loader.
25 days ago1October 25, 2018mitGo
A feature flags client library for Go
Paerser39162 months ago7March 16, 20222apache-2.0Go
Country Flag Emoji Json3912 years ago4September 11, 2021cc-by-sa-4.0JavaScript
Country flag emojis in JSON format.
5 years ago1July 23, 2018mitGo
An extensible Go library for handling program configuration using flags.
111 days ago5January 04, 2022unlicenseGo
Configuration loader in Go
Json Typedef Infer22
a year ago4mitRust
A CLI tool that generates JSON Typedef schemas from example data
Alternatives To Envconf
Select To Compare

Alternative Project Comparisons


Go Report GoDoc Build and Test codecov

EnvConf is a Go package, for parsing configuration values from different sources.


go get github.com/antonmashko/envconf

Parse Configs

Usually you need a tag with desire configuration sources and execution of a single function envconf.Parse for getting all configuration values into your golang structure.

Supported Configurations

  • command line flags
  • environment variables
  • default values
  • external sources (can be anything that is implementing interface External)


Use tags for getting values from different configuration sources.

  • flag - name of flag;
  • env - name of environment variable;
  • default - if nothing set this value will be used as field value;
  • required - on true checks that configuration exists in flag or env source;
  • description - field description in help output.
  • envconf - only for structs. override struct name for generating configuration name.

Supported Types

  1. Primitives: bool, string, all types of int and unit, float32, float64, complex64, complex128;
  2. Collections:
    • Array and Slice - comma-separated string can be converted into slice or array. NOTE: if elements in string more than len of array EnvConf will panic with index out of range.
    • Map - comma-separated string with a colon-separated key and value can be converted into map. example input: key1:value1, key2:value2
  3. Golang types:
    • time.Duration;
    • time.Time - using time.RFC3339 as a time.Parse layout argument;
    • net.IP;
    • url.URL;


Let's take a look at a simple example. Here we're creating struct with 3 tags for different configuration sources: flag, env, and default value. NOTE: It's not necessary to specify tags for each configuration type, add desired only

package main

import (


type Example struct {
	Field1 string `flag:"flag-name" env:"ENV_VAR_NAME" default:"default-value"`

func main() {
	var cfg Example
	if err := envconf.Parse(&cfg); err != nil {
	fmt.Printf("%#v\n", cfg)

Testing! If you want to get set Field1 from command line flag, use flag name that is set in flag tag.

$ go run main.go -flag-name="variable-from-flag"

The same result would be for other configuration types.

-help output

Using envconf will also generate help output with all registered fields and types. Use flag -help or -h for getting it.

$ go run main.go -help


Field1 <string> default-value
        flag: flag-name
        environment variable: ENV_VAR_NAME
        required: false
        description: ""

Auto-generating Config Names

EnvConf can generate environment variable name or flag name from golang field path. All you need is to set * in specific tag. For environment variables name envconf will use field path in uppercase and underscore as a delimiter. Example:

type Config struct {
	HTTP struct {
		Addr string `env:"*"`

Now we can use HTTP_ADDR environment variable for defining Addr field. The same approach will work for flag. But flag names will be generated in lowercase and the dash will be as a delimiter.

Overriding Parent struct name for Auto-generation

In case if parent struct name doesn't satisfy for configuration variable name, it can be changed with envconf tag. Example:

type Config struct {
	HTTP struct {
		Addr string `env:"*"`
	} `envconf:"httpserver"`

Now we'll get HTTPSERVER_ADDR as environment variable name. See: EnvConf example

Configuration Priority


1) Flag 
2) Environment variable 
3) External source
4) Default value
Popular Json Projects
Popular Flags Projects
Popular Data Formats Categories
Related Searches

Get A Weekly Email With Trending Projects For These Categories
No Spam. Unsubscribe easily at any time.
Configuration Management