Envconfig

envconfig is a Go configuration decoder and environment variable mapper that deserializes environment variables into structured Go data types. It provides tools for validating mandatory fields and ensuring application configuration adheres to the external configuration patterns of twelve-factor app compliance.

The library features a help generator that creates formatted usage text based on struct definitions to describe expected environment variables. It also includes a validation tool capable of detecting unused environment variables that match a specific prefix but do not correspond to any defined struct fields.

The project covers application configuration management through the use of struct tags for mapping names, defining default values, and implementing custom type decoding. It supports hierarchical configuration organization by processing nested embedded structs.

Features

Environment Variable Mapping - Binds environment variables to application configuration settings using custom names and default values.
Struct Mapping - Decodes environment variables into application-defined structs using a specified prefix.
Environment Variable Validation - Ensures that required environment variables are present and correctly formatted before the application starts.
Environment Variable Mappers - Maps system-level environment variables to internal Go configuration structs using tags for defaults and requirements.
Configuration Decoders - Deserializes environment variables into structured Go data types with support for custom decoding logic.
Environment Variable Management - Provides a system for loading and managing runtime environment variables as the primary configuration source.
Struct Tags - Uses Go struct tags to define the relationship between environment variable names and configuration fields.
Custom Deserialization Providers - Enables custom deserialization logic for unique data types through a decoder interface or setter methods.
Help Generators - Provides automatic generation of terminal-friendly documentation based on configuration struct metadata.
Help Text Generators - Automatically constructs and formats instructional documentation for expected environment variables.
Go Development Workflows - Provides strongly typed configuration parsing optimized for Go application development workflows.
Configuration Help Generators - Generates formatted help text describing expected environment variables based on configuration struct definitions.
Custom Type Decoders - Enables custom deserialization logic for unique data types through a dedicated decoder interface.
Configuration Field Population - Inspects struct types at runtime to dynamically inject environment variables into the correct fields.
Recursive Struct Traversal - Processes nested embedded structs to allow hierarchical configuration organization within flat environment variables.
Twelve-Factor App Implementations - Implements the external configuration pattern of the Twelve-Factor App methodology by loading environment variables at runtime.
Configuration Management - Configuration management from environment variables.
Configuration Management - Listed in the “Configuration Management” section of the Awesome Go awesome list.
Gestión de configuración - Environment variable to struct mapper.

Historial de estrellas

kelseyhightowerenvconfig

Name: kelseyhightower/envconfig
Author: kelseyhightower

View on GitHub

5,404 estrellas392 forksGomit12 vistas

Envconfig

Features

Environment Variable Mapping - Binds environment variables to application configuration settings using custom names and default values.
Struct Mapping - Decodes environment variables into application-defined structs using a specified prefix.
Environment Variable Validation - Ensures that required environment variables are present and correctly formatted before the application starts.
Environment Variable Mappers - Maps system-level environment variables to internal Go configuration structs using tags for defaults and requirements.
Configuration Decoders - Deserializes environment variables into structured Go data types with support for custom decoding logic.
Environment Variable Management - Provides a system for loading and managing runtime environment variables as the primary configuration source.
Struct Tags - Uses Go struct tags to define the relationship between environment variable names and configuration fields.
Custom Deserialization Providers - Enables custom deserialization logic for unique data types through a decoder interface or setter methods.
Help Generators - Provides automatic generation of terminal-friendly documentation based on configuration struct metadata.
Help Text Generators - Automatically constructs and formats instructional documentation for expected environment variables.
Go Development Workflows - Provides strongly typed configuration parsing optimized for Go application development workflows.
Configuration Help Generators - Generates formatted help text describing expected environment variables based on configuration struct definitions.
Custom Type Decoders - Enables custom deserialization logic for unique data types through a dedicated decoder interface.
Configuration Field Population - Inspects struct types at runtime to dynamically inject environment variables into the correct fields.
Recursive Struct Traversal - Processes nested embedded structs to allow hierarchical configuration organization within flat environment variables.
Twelve-Factor App Implementations - Implements the external configuration pattern of the Twelve-Factor App methodology by loading environment variables at runtime.
Configuration Management - Configuration management from environment variables.
Configuration Management - Listed in the “Configuration Management” section of the Awesome Go awesome list.
Gestión de configuración - Environment variable to struct mapper.

Alternativas open-source a Envconfig

Proyectos open-source similares, clasificados según cuántas características comparten con Envconfig.

alecthomas/kong
alecthomas/kong
2,976Ver en GitHub
Kong is a declarative command line interface framework and parser for Go. It maps flags and positional arguments directly into typed Go structures using struct tags, allowing developers to define terminal interfaces through data models rather than manual parsing logic. The project functions as a configuration mapper that populates Go structures from a combination of command-line arguments, environment variables, and JSON files. It distinguishes itself by providing a dependency injection container to pass external services into command handlers and a plugin architecture for dynamic command reg
Gocommand-linecommandsflags
Ver en GitHub2,976
caarlos0/env
caarlos0/env
6,004Ver en GitHub
env is a Go library that reads environment variables and populates the fields of a Go struct according to tag directives. It uses reflection to iterate over struct types and tags at runtime, mapping environment variable names to struct fields and applying parsing behavior defined in struct tags. The library supports required field validation, returning errors when marked fields are missing or empty after parsing. It also provides default value fallback from struct tags when environment variables are not set, environment variable expansion that recursively substitutes references within values,
Goconfigconfigurationenvironment
Ver en GitHub6,004
joho/godotenv
joho/godotenv
10,483Ver en GitHub
godotenv is a Go library designed to load, parse, and serialize environment configuration files. It provides tools to extract configuration data from files into maps and inject those key-value pairs directly into the system environment of a Go application process. The project includes a configuration file serializer for exporting environment variable maps back into formatted files and a parser for extracting data without modifying the system environment. It supports injecting variables from strings or files into the process environment using priority-based overloading and overwriting. The li
Godotenvenvironment-variablesgo
Ver en GitHub10,483
theskumar/python-dotenv
theskumar/python-dotenv
8,794Ver en GitHub
python-dotenv is a library and command line interface for managing environment variables in Python applications. It functions as a configuration parser and loader that reads key-value pairs from files and injects them into the system environment, enabling the decoupling of application configuration from source code. The project provides a command line interface for manipulating and editing environment variables within configuration files. It also includes a mechanism for recursive variable interpolation, allowing dynamic placeholders within configuration files to be resolved using existing en
Python
Ver en GitHub8,794

Ver las 30 alternativas a Envconfig

Preguntas frecuentes

¿Qué hace kelseyhightower/envconfig?

¿Cuáles son las características principales de kelseyhightower/envconfig?

Las características principales de kelseyhightower/envconfig son: Environment Variable Mapping, Struct Mapping, Environment Variable Validation, Environment Variable Mappers, Configuration Decoders, Environment Variable Management, Struct Tags, Custom Deserialization Providers.

¿Qué alternativas de código abierto existen para kelseyhightower/envconfig?

Las alternativas de código abierto para kelseyhightower/envconfig incluyen: alecthomas/kong — Kong is a declarative command line interface framework and parser for Go. It maps flags and positional arguments… caarlos0/env — env is a Go library that reads environment variables and populates the fields of a Go struct according to tag… joho/godotenv — godotenv is a Go library designed to load, parse, and serialize environment configuration files. It provides tools to… theskumar/python-dotenv — python-dotenv is a library and command line interface for managing environment variables in Python applications. It… knadh/koanf — koanf is a configuration management library for Go designed to load, merge, and unmarshal application settings from… mitchellh/mapstructure — mapstructure is a reflection-based library for the bidirectional encoding and decoding of generic map data into native…