feat(config): Added app description config key

Author: ekkinox

config/README.md

@@ -51,6 +51,7 @@ For the following examples, we will be considering those configuration files:
 # ./configs/config.yaml
 app:
   name: app
+  description: app description
   env: dev
   version: 0.1.0
   debug: false
@@ -109,10 +110,11 @@ func main() {
 	cfg, _ := config.NewDefaultConfigFactory().Create()
 
 	// helpers
-	fmt.Printf("name: %s", cfg.AppName())       // name: app
-	fmt.Printf("env: %s", cfg.AppEnv())         // env: dev
-	fmt.Printf("version: %s", cfg.AppVersion()) // version: 0.1.0
-	fmt.Printf("debug: %v", cfg.AppDebug())     // debug: false
+	fmt.Printf("name: %s", cfg.AppName())                // name: app
+	fmt.Printf("description: %s", cfg.AppDescription())  // description: app description
+	fmt.Printf("env: %s", cfg.AppEnv())                  // env: dev
+	fmt.Printf("version: %s", cfg.AppVersion())          // version: 0.1.0
+	fmt.Printf("debug: %v", cfg.AppDebug())              // debug: false
 
 	// others
 	fmt.Printf("string_value: %s", cfg.GetString("config.values.string_value")) // string_value: default
@@ -146,11 +148,12 @@ func main() {
 	cfg, _ := config.NewDefaultConfigFactory().Create()
 
 	// helpers
-	fmt.Printf("var: %s", cfg.GetEnvVar("APP_ENV")) // var: test
-	fmt.Printf("name: %s", cfg.AppName())           // name: app
-	fmt.Printf("env: %s", cfg.AppEnv())             // env: test
-	fmt.Printf("version: %s", cfg.AppVersion())     // version: 0.1.0
-	fmt.Printf("debug: %v", cfg.AppDebug())         // debug: true
+	fmt.Printf("var: %s", cfg.GetEnvVar("APP_ENV"))      // var: test
+	fmt.Printf("name: %s", cfg.AppName())                // name: app
+	fmt.Printf("description: %s", cfg.AppDescription())  // description: app description
+	fmt.Printf("env: %s", cfg.AppEnv())                  // env: test
+	fmt.Printf("version: %s", cfg.AppVersion())          // version: 0.1.0
+	fmt.Printf("debug: %v", cfg.AppDebug())              // debug: true
 
 	// others
 	fmt.Printf("string_value: %s", cfg.GetString("config.values.string_value")) // string_value: test

config/config.go

@@ -32,6 +32,11 @@ func (c *Config) AppName() string {
 	return c.GetString("app.name")
 }
 
+// AppDescription returns the configured application description (from config field app.description or env var APP_DESCRIPTION).
+func (c *Config) AppDescription() string {
+	return c.GetString("app.description")
+}
+
 // AppEnv returns the configured application environment (from config field app.env or env var APP_ENV).
 func (c *Config) AppEnv() string {
 	return c.GetString("app.env")

config/config_test.go

@@ -41,6 +41,31 @@ func TestAppNameOverrideFromCustomEnvConfig(t *testing.T) {
 	assert.Equal(t, "custom-app", cfg.AppName())
 }
 
+func TestAppDescriptionFromDefaultConfig(t *testing.T) {
+	cfg, err := createTestConfig()
+
+	assert.Nil(t, err)
+	assert.Equal(t, "default-description", cfg.AppDescription())
+}
+
+func TestAppDescriptionOverrideFromTestEnvConfig(t *testing.T) {
+	t.Setenv("APP_ENV", "test")
+
+	cfg, err := createTestConfig()
+
+	assert.NoError(t, err)
+	assert.Equal(t, "test-description", cfg.AppDescription())
+}
+
+func TestAppDescriptionOverrideFromCustomEnvConfig(t *testing.T) {
+	t.Setenv("APP_ENV", "custom")
+
+	cfg, err := createTestConfig()
+
+	assert.NoError(t, err)
+	assert.Equal(t, "custom-description", cfg.AppDescription())
+}
+
 func TestAppNameOverrideFromInvalidEnvConfig(t *testing.T) {
 	t.Setenv("APP_ENV", "invalid")
 

config/testdata/config/valid/config.custom.yaml

@@ -1,5 +1,6 @@
 app:
   name: custom-app
+  description: custom-description
   env: custom
   debug: true
 config:

config/testdata/config/valid/config.test.yaml

@@ -1,5 +1,6 @@
 app:
   name: test-app
+  description: test-description
   env: test
   debug: true
 config:

config/testdata/config/valid/config.yaml

@@ -1,5 +1,6 @@
 app:
   name: default-app
+  description: default-description
   env: dev
   version: 0.1.0
   debug: false