reflect.go

package gocsv

import (
	"fmt"
	"reflect"
	"strconv"
	"strings"
	"sync"
)

// --------------------------------------------------------------------------
// Reflection helpers

type structInfo struct {
	Fields []fieldInfo
}

// fieldInfo is a struct field that should be mapped to a CSV column, or vice-versa
// Each IndexChain element before the last is the index of an the embedded struct field
// that defines Key as a tag
type fieldInfo struct {
	keys         []string
	omitEmpty    bool
	IndexChain   []int
	defaultValue string
}

func (f fieldInfo) getFirstKey() string {
	return f.keys[0]
}

func (f fieldInfo) matchesKey(key string) bool {
	for _, k := range f.keys {
		if key == k || strings.TrimSpace(key) == k {
			return true
		}
	}
	return false
}

var structInfoCache sync.Map
var structMap = make(map[reflect.Type]*structInfo)
var structMapMutex sync.RWMutex

func getStructInfoNoCache(rType reflect.Type) *structInfo {
	fieldsList := getFieldInfos(rType, []int{}, []string{})
	return &structInfo{fieldsList}
}

func getStructInfo(rType reflect.Type) *structInfo {
	stInfo, ok := structInfoCache.Load(rType)
	if ok {
		return stInfo.(*structInfo)
	}

	fieldsList := getFieldInfos(rType, []int{}, []string{})
	stInfo = &structInfo{fieldsList}
	structInfoCache.Store(rType, stInfo)

	return stInfo.(*structInfo)
}

func getFieldInfos(rType reflect.Type, parentIndexChain []int, parentKeys []string) []fieldInfo {
	fieldsCount := rType.NumField()
	fieldsList := make([]fieldInfo, 0, fieldsCount)
	for i := 0; i < fieldsCount; i++ {
		field := rType.Field(i)
		if field.PkgPath != "" {
			continue
		}

		var cpy = make([]int, len(parentIndexChain))
		copy(cpy, parentIndexChain)
		indexChain := append(cpy, i)

		var currFieldInfo *fieldInfo
		if !field.Anonymous {
			filteredTags := []string{}
			currFieldInfo, filteredTags = filterTags(TagName, indexChain, field)

			if len(filteredTags) == 1 && filteredTags[0] == "-" {
				// ignore nested structs with - tag
				continue
			} else if len(filteredTags) > 0 && filteredTags[0] != "" {
				currFieldInfo.keys = filteredTags
			} else {
				currFieldInfo.keys = []string{normalizeName(field.Name)}
			}

			if len(parentKeys) > 0 && currFieldInfo != nil && !canMarshal(field.Type) {
				// create cartesian product of keys
				// eg: parent keys x field keys
				keys := make([]string, 0, len(parentKeys)*len(currFieldInfo.keys))
				for _, pkey := range parentKeys {
					for _, ckey := range currFieldInfo.keys {
						keys = append(keys, normalizeName(fmt.Sprintf("%s.%s", pkey, ckey)))
					}
				}
				currFieldInfo.keys = keys
			}
		}

		// handle struct
		fieldType := field.Type
		// if the field is a pointer, follow the pointer
		if fieldType.Kind() == reflect.Ptr {
			fieldType = fieldType.Elem()
		}
		// if the field is a struct, create a fieldInfo for each of its fields
		if fieldType.Kind() == reflect.Struct {
			// Structs that implement any of the text or CSV marshaling methods
			// should result in one value and not have their fields exposed
			if !(canMarshal(fieldType)) {
				// if the field is an embedded struct, pass along parent keys
				keys := parentKeys
				if currFieldInfo != nil {
					keys = currFieldInfo.keys
				}
				fieldsList = append(fieldsList, getFieldInfos(fieldType, indexChain, keys)...)
				continue
			}
		}

		// if the field is an embedded struct, ignore the csv tag
		if currFieldInfo == nil {
			continue
		}

		if field.Type.Kind() == reflect.Slice || field.Type.Kind() == reflect.Array {
			var arrayLength = -1
			if arrayTag, ok := field.Tag.Lookup(TagName + "[]"); ok {
				arrayLength, _ = strconv.Atoi(arrayTag)
			}

			// When the field is a slice/array of structs, create a fieldInfo for each index and each field
			if field.Type.Elem().Kind() == reflect.Struct {
				fieldInfos := getFieldInfos(field.Type.Elem(), []int{}, []string{})

				for idx := 0; idx < arrayLength; idx++ {
					// copy index chain and append array index
					var cpy2 = make([]int, len(indexChain))
					copy(cpy2, indexChain)
					arrayIndexChain := append(cpy2, idx)
					for _, childFieldInfo := range fieldInfos {
						// copy array index chain and append array index
						var cpy3 = make([]int, len(arrayIndexChain))
						copy(cpy3, arrayIndexChain)

						arrayFieldInfo := fieldInfo{
							IndexChain:   append(cpy3, childFieldInfo.IndexChain...),
							omitEmpty:    childFieldInfo.omitEmpty,
							defaultValue: childFieldInfo.defaultValue,
						}

						// create cartesian product of keys
						// eg: array field keys x struct field keys
						for _, akey := range currFieldInfo.keys {
							for _, fkey := range childFieldInfo.keys {
								arrayFieldInfo.keys = append(arrayFieldInfo.keys, normalizeName(fmt.Sprintf("%s[%d].%s", akey, idx, fkey)))
							}
						}

						fieldsList = append(fieldsList, arrayFieldInfo)
					}
				}
			} else if arrayLength > 0 {
				// When the field is a slice/array of primitives, create a fieldInfo for each index
				for idx := 0; idx < arrayLength; idx++ {
					// copy index chain and append array index
					var cpy2 = make([]int, len(indexChain))
					copy(cpy2, indexChain)

					arrayFieldInfo := fieldInfo{
						IndexChain:   append(cpy2, idx),
						omitEmpty:    currFieldInfo.omitEmpty,
						defaultValue: currFieldInfo.defaultValue,
					}

					for _, akey := range currFieldInfo.keys {
						arrayFieldInfo.keys = append(arrayFieldInfo.keys, normalizeName(fmt.Sprintf("%s[%d]", akey, idx)))
					}

					fieldsList = append(fieldsList, arrayFieldInfo)
				}
			} else {
				fieldsList = append(fieldsList, *currFieldInfo)
			}
		} else {
			fieldsList = append(fieldsList, *currFieldInfo)
		}
	}
	return fieldsList
}

func filterTags(tagName string, indexChain []int, field reflect.StructField) (*fieldInfo, []string) {
	currFieldInfo := fieldInfo{IndexChain: indexChain}

	fieldTag := field.Tag.Get(tagName)
	fieldTags := strings.Split(fieldTag, TagSeparator)

	filteredTags := []string{}
	for _, fieldTagEntry := range fieldTags {
		trimmedFieldTagEntry := strings.TrimSpace(fieldTagEntry) // handles cases like `csv:"foo, omitempty, default=test"`
		if trimmedFieldTagEntry == "omitempty" {
			currFieldInfo.omitEmpty = true
		} else if strings.HasPrefix(trimmedFieldTagEntry, "default=") {
			currFieldInfo.defaultValue = strings.TrimPrefix(trimmedFieldTagEntry, "default=")
		} else {
			filteredTags = append(filteredTags, normalizeName(trimmedFieldTagEntry))
		}
	}

	return &currFieldInfo, filteredTags
}

func getConcreteContainerInnerType(in reflect.Type) (inInnerWasPointer bool, inInnerType reflect.Type) {
	inInnerType = in.Elem()
	inInnerWasPointer = false
	if inInnerType.Kind() == reflect.Ptr {
		inInnerWasPointer = true
		inInnerType = inInnerType.Elem()
	}
	return inInnerWasPointer, inInnerType
}

func getConcreteReflectValueAndType(in interface{}) (reflect.Value, reflect.Type) {
	value := reflect.ValueOf(in)
	if value.Kind() == reflect.Ptr {
		value = value.Elem()
	}
	return value, value.Type()
}

var errorInterface = reflect.TypeOf((*error)(nil)).Elem()

func isErrorType(outType reflect.Type) bool {
	if outType.Kind() != reflect.Interface {
		return false
	}

	return outType.Implements(errorInterface)
}