🫶 Add support encoding.TextUnmarshaler

README.md

@@ -4,7 +4,7 @@
 
 Minimalistic configuration reader
 
-[![Mentioned in Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go) 
+[![Mentioned in Awesome Go](https://awesome.re/mentioned-badge.svg)](https://github.com/avelino/awesome-go)
 [![GoDoc](https://godoc.org/github.com/ilyakaznacheev/cleanenv?status.svg)](https://godoc.org/github.com/ilyakaznacheev/cleanenv)
 [![Go Report Card](https://goreportcard.com/badge/github.com/ilyakaznacheev/cleanenv)](https://goreportcard.com/report/github.com/ilyakaznacheev/cleanenv)
 [![Coverage Status](https://codecov.io/github/ilyakaznacheev/cleanenv/coverage.svg?branch=master)](https://codecov.io/gh/ilyakaznacheev/cleanenv)
@@ -24,18 +24,18 @@ This is a simple configuration reading tool. It just does the following:
 
 - [Installation](#installation)
 - [Usage](#usage)
-    - [Read Configuration](#read-configuration)
-    - [Read Environment Variables Only](#read-environment-variables-only)
-    - [Update Environment Variables](#update-environment-variables)
-    - [Description](#description)
+  - [Read Configuration](#read-configuration)
+  - [Read Environment Variables Only](#read-environment-variables-only)
+  - [Update Environment Variables](#update-environment-variables)
+  - [Description](#description)
 - [Model Format](#model-format)
 - [Supported types](#supported-types)
 - [Custom Functions](#custom-functions)
-    - [Custom Value Setter](#custom-value-setter)
-    - [Custom Value Update](#custom-value-update)
+  - [Custom Value Setter](#custom-value-setter)
+  - [Custom Value Update](#custom-value-update)
 - [Supported File Formats](#supported-file-formats)
 - [Integration](#integration)
-    - [Flag](#flag)
+  - [Flag](#flag)
 - [Examples](#examples)
 - [Contribution](#contribution)
 - [Thanks](#thanks)
@@ -93,7 +93,7 @@ This will do the following:
 
 Sometimes you don't want to use configuration files at all, or you may want to use `.env` file format instead. Thus, you can limit yourself with only reading environment variables:
 
-```go 
+```go
 import "github.com/ilyakaznacheev/cleanenv"
 
 type ConfigDatabase struct {
@@ -193,9 +193,9 @@ There are following supported types:
 - `time.Duration`;
 - `time.Time` (layout by default is RFC3339, may be overridden by `env-layout`);
 - `*time.Location` (time zone parsing [depends](https://pkg.go.dev/time#LoadLocation) on running machine)
+- any type that implements `encoding.TextUnmarshaler`;
 - any type implementing `cleanenv.Setter` interface.
 
-
 ## Custom Functions
 
 To enhance package abilities you can use some custom functions.
@@ -251,6 +251,7 @@ There are several most popular config file formats supported:
 - ENV (`.env`)
 
 **Note**:
+
 - while using `.env` file the library will set corresponding data to process environment variables.
   It will override existing variables with the same keys in the process environment.
 

cleanenv.go

@@ -1,6 +1,7 @@
 package cleanenv
 
 import (
+	"encoding"
 	"encoding/json"
 	"flag"
 	"fmt"
@@ -459,15 +460,27 @@ func readEnvVars(cfg interface{}, update bool) error {
 func parseValue(field reflect.Value, value, sep string, layout *string) error {
 	// TODO: simplify recursion
 
+	valueType := field.Type()
+
+	// look for supported struct parser
+	if structParser, found := validStructs[valueType]; found {
+		return structParser(&field, value, layout)
+	}
+
 	if field.CanInterface() {
+		if ctp, ok := field.Addr().Interface().(encoding.TextUnmarshaler); ok {
+			return ctp.UnmarshalText([]byte(value))
+		} else if ct, ok := field.Interface().(encoding.TextUnmarshaler); ok {
+			return ct.UnmarshalText([]byte(value))
+		}
+
 		if cs, ok := field.Interface().(Setter); ok {
 			return cs.SetValue(value)
 		} else if csp, ok := field.Addr().Interface().(Setter); ok {
 			return csp.SetValue(value)
 		}
 	}
 
-	valueType := field.Type()
 	switch valueType.Kind() {
 
 	// parse string value
@@ -542,11 +555,6 @@ func parseValue(field reflect.Value, value, sep string, layout *string) error {
 		field.Set(*mapValue)
 
 	default:
-		// look for supported struct parser
-		if structParser, found := validStructs[valueType]; found {
-			return structParser(&field, value, layout)
-		}
-
 		return fmt.Errorf("unsupported type %s.%s", valueType.PkgPath(), valueType.Name())
 	}