✨ Generic map and slice serialisers (#622)

<!--
Copyright (C) 2020-2022 Arm Limited or its affiliates and Contributors.
All rights reserved.
SPDX-License-Identifier: Apache-2.0
-->
### Description

- extended mapstructure decode
- add ways to flatten and expand maps



### Test Coverage

<!--
Please put an `x` in the correct box e.g. `[x]` to indicate the testing
coverage of this change.
-->

- [x]  This change is covered by existing or additional automated tests.
- [ ] Manual testing has been performed (and evidence provided) as
automated testing was not feasible.
- [ ] Additional tests are not required for this change (e.g.
documentation update).

Author: acabarbaye

.secrets.baseline

@@ -265,5 +265,5 @@
       }
     ]
   },
-  "generated_at": "2025-05-12T17:01:47Z"
+  "generated_at": "2025-05-30T10:38:21Z"
 }

changes/20250530113842.bugfix

@@ -0,0 +1 @@
+:camel: Upgrade dependencies

changes/20250530114030.bugfix

@@ -0,0 +1 @@
+:gear: Move dependency on mapstructure to use https://github.com/go-viper/mapstructure as https://github.com/mitchellh/mapstructure is [no longer maintained](https://github.com/go-viper/mapstructure?tab=readme-ov-file#migrating-from-githubcommitchellhmapstructure)

changes/20250530114133.feature

@@ -0,0 +1 @@
+:sparkles: [serialization] Added ways to serialise structs into maps or slice

changes/20250530114405.feature

@@ -0,0 +1 @@
+:sparkles: [maps] Added ways to expand and flatten maps in a similar fashion to https://github.com/krakend/flatmap and no longer available  https://pkg.go.dev/github.com/hashicorp/terraform/flatmap

utils/charset/iconv/interfaces.go

@@ -11,7 +11,7 @@ import (
 	"io"
 )
 
-//go:generate mockgen -destination=../../mocks/mock_$GOPACKAGE.go -package=mocks github.com/ARM-software/golang-utils/utils/charset/$GOPACKAGE ICharsetConverter
+//go:generate go tool mockgen -destination=../../mocks/mock_$GOPACKAGE.go -package=mocks github.com/ARM-software/golang-utils/utils/charset/$GOPACKAGE ICharsetConverter
 
 type ICharsetConverter interface {
 	// ConvertString converts the charset of an input string

utils/collection/pagination/interfaces.go

@@ -12,7 +12,7 @@ import (
 	"io"
 )
 
-//go:generate mockgen -destination=../../mocks/mock_$GOPACKAGE.go -package=mocks github.com/ARM-software/golang-utils/utils/collection/$GOPACKAGE IStaticPage,IPage,IStaticPageStream,IStream,IIterator,IPaginator,IPaginatorAndPageFetcher,IStreamPaginator,IStreamPaginatorAndPageFetcher
+//go:generate go tool mockgen -destination=../../mocks/mock_$GOPACKAGE.go -package=mocks github.com/ARM-software/golang-utils/utils/collection/$GOPACKAGE IStaticPage,IPage,IStaticPageStream,IStream,IIterator,IPaginator,IPaginatorAndPageFetcher,IStreamPaginator,IStreamPaginatorAndPageFetcher
 
 // IIterator defines an iterator over a collection of items.
 type IIterator interface {

utils/collection/parseLists.go

@@ -6,6 +6,7 @@ package collection
 
 import (
 	"fmt"
+	"slices"
 	"strings"
 	"unicode"
 
@@ -75,11 +76,9 @@ func ConvertSliceToMap[T comparable](input []T) (pairs map[T]T, err error) {
 	}
 
 	pairs = make(map[T]T, numElements/2)
-	// TODO use slices.Chunk introduced in go 23 when library is upgraded
-	for i := 0; i < numElements; i += 2 {
-		pairs[input[i]] = input[i+1]
+	for pair := range slices.Chunk(input, 2) {
+		pairs[pair[0]] = pair[1]
 	}
-
 	return
 }
 

utils/config/interfaces.go

@@ -6,7 +6,7 @@
 // Package config provides utilities to load configuration from an environment and perform validation at load time.
 package config
 
-//go:generate mockgen -destination=../mocks/mock_$GOPACKAGE.go -package=mocks github.com/ARM-software/golang-utils/utils/$GOPACKAGE IServiceConfiguration,Validator
+//go:generate go tool mockgen -destination=../mocks/mock_$GOPACKAGE.go -package=mocks github.com/ARM-software/golang-utils/utils/$GOPACKAGE IServiceConfiguration,Validator
 
 // IServiceConfiguration defines a typical service configuration.
 type IServiceConfiguration interface {

utils/config/service_configuration.go

@@ -9,8 +9,8 @@ import (
 	"fmt"
 	"strings"
 
+	"github.com/go-viper/mapstructure/v2"
 	"github.com/joho/godotenv"
-	"github.com/mitchellh/mapstructure"
 	"github.com/spf13/pflag"
 	"github.com/spf13/viper"