chore(release): 0.0.3

CHANGELOG.md

@@ -9,6 +9,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [0.0.3] - 2025-07-23
 
 ### Added
+- handle errors via. required (tests)
 - only error on non required values
 
 ## [0.0.2] - 2025-07-22

config_test.go

@@ -165,4 +165,36 @@ func TestLoad(t *testing.T) {
 		assert.Equal(t, "some-item", val.SomeItem)
 		assert.Equal(t, "some-other-item", val.SomeOtherItem)
 	})
+
+	t.Run("required true, error returned", func(t *testing.T) {
+		type Config struct {
+			SomeItem      string
+			SomeOtherItem string `cfg:"required:true"`
+			someBool      bool
+		}
+
+		t.Setenv("SOME_OTHER_ITEM", "")
+
+		val, err := yourconfig.Load[Config]()
+		require.Error(t, err)
+		require.Zero(t, val)
+
+		assert.Equal(t, "config failed: field: SomeOtherItem (env=SOME_OTHER_ITEM) is not set and is required", err.Error())
+	})
+
+	t.Run("required false, no error returned", func(t *testing.T) {
+		type Config struct {
+			SomeItem      string
+			SomeOtherItem string `cfg:"required:false"`
+			someBool      bool
+		}
+
+		t.Setenv("SOME_OTHER_ITEM", "")
+
+		val, err := yourconfig.Load[Config]()
+		require.NoError(t, err)
+
+		assert.Zero(t, val)
+	})
+
 }