45 lines
2.0 KiB
Go
45 lines
2.0 KiB
Go
package configkit
|
|
|
|
import (
|
|
"io"
|
|
"io/fs"
|
|
|
|
"gitea.maximumdirect.net/eric/ConfigKit/internal/engine"
|
|
)
|
|
|
|
// Source is an opaque configuration input. Construct sources with File,
|
|
// Filesystem.File, Bytes, Reader, or NoSource; the zero value is invalid.
|
|
type Source struct{ value engine.Source }
|
|
|
|
// Filesystem is a reusable opaque namespace for a caller-owned fs.FS. Copies
|
|
// preserve identity; separately constructed values are distinct even if their
|
|
// labels or underlying filesystems match. The filesystem is never closed.
|
|
type Filesystem struct{ value engine.Filesystem }
|
|
|
|
// NewFilesystem borrows filesystem without opening it. Label must be nonempty
|
|
// and safe to display; a nil filesystem or invalid label is reported when a
|
|
// source from the returned namespace is consumed.
|
|
func NewFilesystem(label string, filesystem fs.FS) Filesystem {
|
|
return Filesystem{value: engine.NewFilesystem(label, filesystem)}
|
|
}
|
|
|
|
// File selects a non-root fs.ValidPath name in this filesystem. Each load
|
|
// reopens the file; constructor problems are reported when the source is used.
|
|
func (f Filesystem) File(name string) Source { return Source{value: f.value.File(name)} }
|
|
|
|
// File returns a source that reopens path for every load attempt.
|
|
func File(path string) Source { return Source{value: engine.File(path)} }
|
|
|
|
// Bytes snapshots data immediately. Label must be nonempty and safe to display;
|
|
// constructor problems are reported when the source is consumed.
|
|
func Bytes(label string, data []byte) Source { return Source{value: engine.Bytes(label, data)} }
|
|
|
|
// Reader returns a single-use source. ConfigKit consumes input but never closes it.
|
|
// Copies of the returned Source share the same single-use claim.
|
|
func Reader(label string, input io.Reader) Source { return Source{value: engine.Reader(label, input)} }
|
|
|
|
// NoSource explicitly selects a defaults-only input. It creates no source record.
|
|
func NoSource() Source { return Source{value: engine.NoSource()} }
|
|
|
|
func (s Source) toEngine() engine.Source { return s.value }
|