ssconfig

Super Simple Config: read from json file, overwrite with ENV vars.

• values are read directly into your config struct,
• field names of the struct match the ENV vars (with optional prefix)
• single source file
• full test coverage
• no dependencies

Example Usage

go get github.com/jpxor/ssconfig

package main

import (
    "github.com/jpxor/ssconfig"
)

type my_config struct {
  PORT        string
  WWW_ROOT    string
  PRIVATE_KEY string
}

func main() {
  var env my_config
  
  // default: load from environment variables matching struct field names
  ssconfig.Load(&env)
 
  // or set optional parameters to:
  err := ssconfig.Set{
    FilePath: "config.json",    // load from config file before env vars,
    EnvPrefix: "MY_APP_",       // set env var name prefix,
    Logger: myLogger,           // use custom log.Logger
  }.Load(&env)

  // any error will contain a list of fields that failed to load
  if err != nil {
    log.Println(err)
  }
  log.Printf("%+v\n", env)
}

Documentation

See the example above, that's 99% what you need to know. The other 1%:

• ssconfig supports loading all types via "encoding/json" unmarshal. You can use the json struct tags for loading from config file.
• ssconfig logs to default logger if one is not set. It names the Fields loaded, but not their values (keeps any private api keys or passwords out of the logs).
• need default values? Then set them before loading; the load will overwrite the existing values.

About

I tried a few different config packages from a 'curated list' and they all had lots of dependencies and features I didn't need, or returned errors I wasn't expecting (config was missing from config file, so it gave up instead of looking in the env vars). So I quickly whipped up a config package that does one simple thing, has no dependencies, and doesn't immediately give up when it can't find the config value for one of the fields.