Clear unloads the config. DANGEROUS, should only be used for testing.
Get a config entry. Panics if the entry doesn't exist.
GetBool a config entry as bool. Panics if entry is not a bool or if it doesn't exist.
GetBoolSlice a config entry as bool. Panics if entry is not a bool slice or if it doesn't exist.
GetFloat a config entry as float64. Panics if entry is not a float64 or if it doesn't exist.
GetFloatSlice a config entry as float64. Panics if entry is not a float slice or if it doesn't exist.
GetInt a config entry as int. Panics if entry is not an int or if it doesn't exist.
GetIntSlice a config entry as int. Panics if entry is not an int slice or if it doesn't exist.
GetString a config entry as string. Panics if entry is not a string or if it doesn't exist.
GetStringSlice a config entry as string. Panics if entry is not a string slice or if it doesn't exist.
Has check if a config entry exists.
IsLoaded returns true if the config have been loaded.
Load loads the config.json file in the current working directory. If the "GOYAVE_ENV" env variable is set, the config file will be picked like so: - "production": "config.production.json" - "test": "config.test.json" - By default: "config.json"
LoadFrom loads a config file from the given path.
Register a new config entry and its validation.
Each module should register its config entries in an "init()" function, even if they don't have a default value, in order to ensure they will be validated. Each module should use its own category and use a name both expressive and unique to avoid collisions. For example, the "auth" package registers, among others, "auth.basic.username" and "auth.jwt.expiry", thus creating a category for its package, and two subcategories for its features.
To register an entry without a default value (only specify how it will be validated), set "Entry.Value" to "nil".
Panics if an entry already exists for this key and is not identical to the one passed as parameter of this function. On the other hand, if the entries are identical, no conflict is expected so the configuration is left in its current state.
Set a config entry. The change is temporary and will not be saved for next boot. Use "nil" to unset a value.
- A category cannot be replaced with an entry. - An entry cannot be replaced with a category. - New categories can be created with they don't already exist. - New entries can be created if they don't already exist. This new entry will be subsequently validated using the type of its initial value and have an empty slice as authorized values (meaning it can have any value of its type)
Panics and revert changes in case of error.
Entry is the internal reprensentation of a config entry. It contains the entry value, its expected type (for validation) and a slice of authorized values (for validation too). If this slice is empty, it means any value can be used, provided it is of the correct type.