mirror of
https://github.com/taigrr/jety.git
synced 2026-04-02 03:19:03 -07:00
Tai Groot
dd7e2e3ecb
- Add GetFloat64 and GetInt64 methods to ConfigManager and package-level API - Fix README precedence: actual order is Set > env > file > default (was incorrectly documented as file > env > default) - Fix GetStringMap return type in API table: map[string]any, not map[string]string - Bump Go to 1.26.1 - Add tests for all new getters (coverage 94.7% → 95.2%)
151 lines
4.6 KiB
Markdown
151 lines
4.6 KiB
Markdown
# JETY
|
|
|
|
[](https://github.com/taigrr/jety/actions/workflows/test.yml)
|
|
[](https://github.com/taigrr/jety/actions/workflows/govulncheck.yml)
|
|
|
|
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](http://github.com/gogrlx/grlx).
|
|
|
|
## Installation
|
|
|
|
```bash
|
|
go get github.com/taigrr/jety
|
|
```
|
|
|
|
Requires Go 1.26.1 or later.
|
|
|
|
## Quick Start
|
|
|
|
```go
|
|
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:
|
|
|
|
```toml
|
|
[services.cloud]
|
|
var = "xyz"
|
|
timeout = "30s"
|
|
|
|
[services.cloud.auth]
|
|
client_id = "abc123"
|
|
```
|
|
|
|
Access nested values using `GetStringMap` and type assertions:
|
|
|
|
```go
|
|
services := jety.GetStringMap("services")
|
|
cloud := services["cloud"].(map[string]any)
|
|
varValue := cloud["var"].(string) // "xyz"
|
|
|
|
// For deeper nesting
|
|
auth := cloud["auth"].(map[string]any)
|
|
clientID := auth["client_id"].(string) // "abc123"
|
|
```
|
|
|
|
### Environment Variable Overrides
|
|
|
|
Environment variables use uppercase keys. For nested config, the env var name is the key in uppercase:
|
|
|
|
```bash
|
|
# 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:
|
|
|
|
```go
|
|
cm := jety.NewConfigManager().WithEnvPrefix("MYAPP_")
|
|
```
|
|
|
|
```bash
|
|
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 |
|
|
| `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](LICENSE) file.
|