config

package

v0.0.5 Latest Latest Go to latest Published: Apr 14, 2026 License: MIT Imports: 7 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/compozy/kb

Links

Open Source Insights

Documentation ¶

Overview ¶

Package config loads TOML configuration and environment-backed runtime overrides for the kb CLI.

Index ¶

Constants
func ApplyEnvOverrides(cfg *Config)
func LoadDotEnvIfPresent(path string) error
type AppConfig
- func (c AppConfig) Validate() error
type Config
- func Default() Config
- func Load(path string) (Config, error)
- func (c Config) Validate() error
type FirecrawlConfig
type LogConfig
- func (c LogConfig) Validate() error
type OpenRouterConfig

Constants ¶

View Source

const (
	// DefaultDotEnvPath is the local dotenv file loaded by the CLI entrypoint.
	DefaultDotEnvPath = ".env"

	// EnvConfigPath overrides the config file path.
	EnvConfigPath = "APP_CONFIG"

	// EnvFirecrawlAPIKey stores the Firecrawl API key override.
	EnvFirecrawlAPIKey = "FIRECRAWL_API_KEY"

	// EnvFirecrawlAPIURL stores the Firecrawl API URL override.
	EnvFirecrawlAPIURL = "FIRECRAWL_API_URL"

	// EnvOpenRouterAPIKey stores the OpenRouter API key override.
	EnvOpenRouterAPIKey = "OPENROUTER_API_KEY"

	// EnvOpenRouterAPIURL stores the OpenRouter API URL override.
	EnvOpenRouterAPIURL = "OPENROUTER_API_URL"
)

Variables ¶

This section is empty.

Functions ¶

func ApplyEnvOverrides ¶

func ApplyEnvOverrides(cfg *Config)

ApplyEnvOverrides overlays config values that are sourced from environment variables at runtime.

func LoadDotEnvIfPresent ¶

func LoadDotEnvIfPresent(path string) error

LoadDotEnvIfPresent loads a local dotenv file without overriding env vars already supplied by the shell or process manager.

Types ¶

type AppConfig ¶

type AppConfig struct {
	Name string `toml:"name"`
	Env  string `toml:"env"`
}

AppConfig contains the application identity and environment.

func (AppConfig) Validate ¶

func (c AppConfig) Validate() error

Validate ensures application identity settings are usable.

type Config ¶

type Config struct {
	App        AppConfig        `toml:"app"`
	Log        LogConfig        `toml:"log"`
	Firecrawl  FirecrawlConfig  `toml:"firecrawl"`
	OpenRouter OpenRouterConfig `toml:"openrouter"`
}

Config contains the complete TOML-backed runtime configuration.

func Default ¶

func Default() Config

Default returns a sane starting configuration.

func Load ¶

func Load(path string) (Config, error)

Load reads and validates the TOML config file, then overlays runtime secrets from the environment.

func (Config) Validate ¶

func (c Config) Validate() error

Validate ensures the config is internally consistent before runtime startup.

type FirecrawlConfig ¶

type FirecrawlConfig struct {
	APIKey string `toml:"api_key"`
	APIURL string `toml:"api_url"`
}

FirecrawlConfig controls URL scraping API access.

type LogConfig ¶

type LogConfig struct {
	Level string `toml:"level"`
}

LogConfig controls structured logging output.

func (LogConfig) Validate ¶

func (c LogConfig) Validate() error

Validate ensures the log level is supported.

type OpenRouterConfig ¶

type OpenRouterConfig struct {
	APIKey   string `toml:"api_key"`
	APIURL   string `toml:"api_url"`
	STTModel string `toml:"stt_model"`
}

OpenRouterConfig controls the STT fallback provider.

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL