env

README

Environment Variables

The Dracory framework utilizes environment variables for configuration. The env package provides utilities for loading and accessing these variables.

Loading Environment Variables

Environment variables can be loaded from a .env file using the env.Initialize() function. This function attempts to load variables from a .env file in the current directory.

import "github.com/dracory/base/env"

func main() {
    env.Initialize() // Loads from .env file
}

Accessing Environment Variables

The env package provides two functions for accessing environment variables:

• env.Value(key string) string: Retrieves the value of an environment variable.
• env.Must(key string) string: Retrieves the value of an environment variable. If the variable is not set, the program will panic.

import "github.com/dracory/base/env"

func main() {
    apiKey := env.Value("API_KEY")
    dbPassword := env.Must("DB_PASSWORD")
    fmt.Println("API Key:", apiKey)
    fmt.Println("DB Password:", dbPassword)
}

Special Prefixes

The env.Value() function supports special prefixes for processing environment variable values:

• base64:: Decodes the value as a base64 encoded string.
• obfuscated:: Deobfuscates the value using the envenc package.

import "github.com/dracory/base/env"

func main() {
    decodedValue := env.Value("BASE64_VALUE") // If BASE64_VALUE is "base64:SGVsbG8gV29ybGQh", it will return "Hello World!"
    obfuscatedValue := env.Value("OBFUSCATED_VALUE") // If OBFUSCATED_VALUE is "obfuscated:some_obfuscated_string", it will deobfuscate the string
    fmt.Println("Decoded Value:", decodedValue)
    fmt.Println("Obfuscated Value:", obfuscatedValue)
}

Documentation

Overview

Package env contains functions to interact with environment variables.

The package is imported like this:

import "github.com/gouniverse/base/env"

Index

• func Initialize(envFilePath ...string)
• func Must(key string) string
• func Value(key string) string
• func VaultLoad(options struct{ ... }) error

Functions

func Initialize

func Initialize(envFilePath ...string)

Initialize initializes the environment variables

func Must

func Must(key string) string

Must retrieves the value of an environment variable, panicking if not set.

func Value

func Value(key string) string

Env returns the value for an environment key

func VaultLoad

func VaultLoad(options struct {
	Password      string
	VaultFilePath string
	VaultContent  string
}) error

EncInitialize initializes environment variables from a vault file or content using the provided password. It takes an options struct containing the password and either a vault file path or vault content. It returns an error if the initialization fails.