config

type Capability string

type Config struct {
	// HTTP is the "http" configuration section.
	HTTP *HTTP `toml:"http"`
	// Repos is the collection of repository configuration, keyed by their ID.
	Repos map[string]*Repo `toml:"repos"`
}

type HTTP struct {
	// Host is the host string, used for http.ListenAndServe, defaults to ":8000".
	Host string `toml:"host"`
}

type MetadataSource string

type Repo struct {
	// Name is the name of the repository, defaults to the repository ID.
	Name string `toml:"name"`
	// Path is the relative or absolute path of the repository's directory.
	Path string `toml:"path"`
	// Path is the relative or absolute path of the repository's index file, can be empty.
	IndexPath string `toml:"index_path"`
	// CachePath is the relative or absolute path of the repository's operation cache, defaults to <path>/.katana/cache.
	CachePath string `toml:"cache_path"`
	// Capabilities are the capability IDs of the repository.
	Capabilities []Capability `toml:"capabilities"`
	// Sources is a mapping of used metadata sources and their configuration, keyed by their name.
	Sources map[MetadataSource]map[string]interface{} `toml:"sources"`
}

type Section[T any] interface {
	// Defaults completes the section with default values, set values are not replaced.
	Defaults() T
}