mirror of https://github.com/taigrr/jety.git synced 2026-04-01 19:08:58 -07:00

Files

Tai Groot c8cbb72ed7 feat(api): add Delete and Sub methods, update CI workflows

- Add Delete(key) to remove keys from all config layers
- Add Sub(key) to get a scoped ConfigManager for nested sections
- Update CodeQL workflow actions to v4/v5/v3
- Update govulncheck workflow checkout to v4
- Remove boilerplate comments from CodeQL workflow
- Add comprehensive tests for both new methods
- Update README with Sub() usage example and API docs

2026-03-07 11:03:48 +00:00

4.9 KiB

Raw Permalink Blame History

JETY

JSON, ENV, TOML, YAML

A lightweight Go configuration management library supporting JSON, ENV, TOML, and YAML formats. It provides viper-like AutomaticEnv functionality with fewer dependencies. Originally built to support grlx.

Installation

go get github.com/taigrr/jety

Requires Go 1.26.1 or later.

Quick Start

package main

import "github.com/taigrr/jety"

func main() {
    // Set defaults
    jety.SetDefault("port", 8080)
    jety.SetDefault("host", "localhost")

    // Environment variables are loaded automatically
    // e.g., PORT=9000 overrides the default

    // Read from config file
    jety.SetConfigFile("config.toml")
    jety.SetConfigType("toml")
    if err := jety.ReadInConfig(); err != nil {
        // handle error
    }

    // Get values (Set > env > config file > default)
    port := jety.GetInt("port")
    host := jety.GetString("host")
}

Features

Multiple formats: JSON, TOML, YAML
Automatic env loading: Environment variables loaded on init
Prefix filtering: Filter env vars by prefix (e.g., MYAPP_)
Case-insensitive keys: Keys normalized to lowercase
Type coercion: Getters handle type conversion gracefully
Thread-safe: Safe for concurrent access
Config precedence: Set() > environment > config file > defaults

Nested Configuration

For nested config structures like:

[services.cloud]
var = "xyz"
timeout = "30s"

[services.cloud.auth]
client_id = "abc123"

Use Sub() to get a scoped ConfigManager for a nested section:

cloud := jety.Sub("services")
if cloud != nil {
    inner := cloud.Sub("cloud")
    if inner != nil {
        varValue := inner.GetString("var")      // "xyz"
        timeout := inner.GetDuration("timeout")  // 30s
    }
}

Or access nested values directly with GetStringMap and type assertions:

services := jety.GetStringMap("services")
cloud := services["cloud"].(map[string]any)
varValue := cloud["var"].(string)  // "xyz"

Environment Variable Overrides

Environment variables use uppercase keys. For nested config, the env var name is the key in uppercase:

# Override top-level key
export PORT=9000

# For nested keys, use the full key name in uppercase
export SERVICES_CLOUD_VAR=override_value

With a prefix:

cm := jety.NewConfigManager().WithEnvPrefix("MYAPP_")

export MYAPP_PORT=9000
export MYAPP_SERVICES_CLOUD_VAR=override_value

Note: Environment variables override both defaults and config file values for registered keys (keys that appear in defaults or the config file).

API

Configuration

Function	Description
`SetConfigFile(path)`	Set config file path
`SetConfigDir(dir)`	Set config directory
`SetConfigName(name)`	Set config file name (without extension)
`SetConfigType(type)`	Set config type: `"toml"`, `"yaml"`, `"json"`
`ReadInConfig()`	Read config file
`WriteConfig()`	Write config to file

Values

Function	Description
`Set(key, value)`	Set a value
`SetDefault(key, value)`	Set a default value
`Delete(key)`	Remove a key
`Sub(key)`	Get scoped sub-config
`Get(key)`	Get raw value
`GetString(key)`	Get as string
`GetInt(key)`	Get as int
`GetInt64(key)`	Get as int64
`GetFloat64(key)`	Get as float64
`GetBool(key)`	Get as bool
`GetDuration(key)`	Get as time.Duration
`GetStringSlice(key)`	Get as []string
`GetIntSlice(key)`	Get as []int
`GetStringMap(key)`	Get as map[string]any
`IsSet(key)`	Check if key has a value
`AllKeys()`	List all known keys
`AllSettings()`	Get all values as a map

Environment

Function	Description
`WithEnvPrefix(prefix)`	Filter env vars by prefix (strips prefix from keys)
`SetEnvPrefix(prefix)`	Set prefix for env var lookups

License

See LICENSE file.

4.9 KiB Raw Permalink Blame History