use config.Load (#61)

CHANGELOG.md

@@ -9,12 +9,7 @@ to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ### Changed
 
-- Split file and fs provider (#49).
-- Split Watch and OnChange for watching configuration changes (#52).
-
-### Removed
-
-- Remove konf.Logger in favor of slog (#48).
+- [BREAKING] Redesign API.
 
 ## [v0.2.0] - 3/18/2023
 

README.md

@@ -15,7 +15,7 @@ It defers the actual configuration loading to the `Loader` interface.
 The `Loader` and `Watcher` interface is intended for configuration source library implementers.
 They are pure interfaces which can be implemented to provide the actual configuration.
 
-This decoupling allows application developers to write code in terms of `konf.Config`
+This decoupling allows application developers to write code in terms of `*konf.Config`
 while the configuration source(s) is managed "up stack" (e.g. in or near `main()`).
 Application developers can then switch configuration sources(s) as necessary.
 
@@ -29,15 +29,14 @@ configuration source(s) (implementation) it actually wants to use. Something lik
     var config embed.FS
 
     func main() {
-        // Create the global Config that loads configuration
-        // from embed file system and environment variables.
-        config, err := konf.New(
-            konf.WithLoader(
-                fs.New(config, "config/config.json"),
-                env.New(env.WithPrefix("server")),
-            ),
-        )
-        if err != nil {
+        // Create the Config.
+        config := konf.New()
+
+        // Load configuration from embed file system and environment variables.
+        if err := config.Load(
+            fs.New(config, "config/config.json"),
+            env.New(env.WithPrefix("server")),
+        ); err != nil {
             // Handle error here.
         }
 

benchmark_test.go

@@ -12,11 +12,12 @@ import (
 
 func BenchmarkNew(b *testing.B) {
 	var (
-		config konf.Config
+		config *konf.Config
 		err    error
 	)
 	for i := 0; i < b.N; i++ {
-		config, err = konf.New(konf.WithLoader(mapLoader{"k": "v"}))
+		config = konf.New()
+		err = config.Load(mapLoader{"k": "v"})
 	}
 	b.StopTimer()
 
@@ -26,7 +27,8 @@ func BenchmarkNew(b *testing.B) {
 }
 
 func BenchmarkGet(b *testing.B) {
-	config, err := konf.New(konf.WithLoader(mapLoader{"k": "v"}))
+	config := konf.New()
+	err := config.Load(mapLoader{"k": "v"})
 	assert.NoError(b, err)
 	konf.SetGlobal(config)
 	b.ResetTimer()
@@ -41,7 +43,8 @@ func BenchmarkGet(b *testing.B) {
 }
 
 func BenchmarkUnmarshal(b *testing.B) {
-	config, err := konf.New(konf.WithLoader(mapLoader{"k": "v"}))
+	config := konf.New()
+	err := config.Load(mapLoader{"k": "v"})
 	assert.NoError(b, err)
 	konf.SetGlobal(config)
 	b.ResetTimer()