✨ Added message utilities (#10)

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

- made few fixes
- added utilities to work with messages
- added utilities to paginate through some collections


### 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).

Co-authored-by: acabarbaye <[email protected]>

Author: acabarbaye

README.md

@@ -1,5 +1,5 @@
 <!--
-Copyright (C) 2020-2022 Arm Limited or its affiliates and Contributors. All rights reserved.
+Copyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.
 SPDX-License-Identifier: Apache-2.0
 -->
 # Embedded development services HTTP client utilities

changes/20221229173222.feature

@@ -0,0 +1 @@
+:sparkles: `[field]` Added conversion utilities for `any`

changes/20221229173247.feature

@@ -0,0 +1 @@
+:sparkles: `[message]` Added utilities to work with messages

changes/20221229173318.feature

@@ -0,0 +1 @@
+:sparkles: `[pagination]` Added converters for collections and streams

utils/api/api.go

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2020-2022 Arm Limited or its affiliates and Contributors. All rights reserved.
+ * Copyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

utils/api/api_test.go

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2020-2022 Arm Limited or its affiliates and Contributors. All rights reserved.
+ * Copyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

utils/errors/errors.go

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2020-2022 Arm Limited or its affiliates and Contributors. All rights reserved.
+ * Copyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 

utils/errors/errors_test.go

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2020-2022 Arm Limited or its affiliates and Contributors. All rights reserved.
+ * Copyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 package errors

utils/field/fields.go

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2020-2022 Arm Limited or its affiliates and Contributors. All rights reserved.
+ * Copyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 
@@ -113,6 +113,19 @@ func OptionalString(ptr *string, defaultValue string) string {
 	return defaultValue
 }
 
+// ToOptionalAny returns a pointer to a object.
+func ToOptionalAny(a any) *any {
+	return &a
+}
+
+// OptionalAny returns the value of an optional field or else returns defaultValue.
+func OptionalAny(ptr *any, defaultValue any) any {
+	if ptr != nil {
+		return *ptr
+	}
+	return defaultValue
+}
+
 // ToOptionalFloat32 returns a pointer to a float32.
 func ToOptionalFloat32(i float32) *float32 {
 	return &i

utils/field/fields_test.go

@@ -1,5 +1,5 @@
 /*
- * Copyright (C) 2020-2022 Arm Limited or its affiliates and Contributors. All rights reserved.
+ * Copyright (C) 2020-2023 Arm Limited or its affiliates and Contributors. All rights reserved.
  * SPDX-License-Identifier: Apache-2.0
  */
 package field
@@ -185,6 +185,21 @@ func TestOptionalField(t *testing.T) {
 				return OptionalDuration(ptr, a2.(time.Duration))
 			},
 		},
+		{
+			fieldType:    "Any",
+			value:        faker.Sentence(),
+			defaultValue: time.Now(),
+			setFunction: func(a any) any {
+				return ToOptionalAny(a)
+			},
+			getFunction: func(a any, a2 any) any {
+				var ptr *any
+				if a != nil {
+					ptr = a.(*any)
+				}
+				return OptionalAny(ptr, a2)
+			},
+		},
 	}
 	for i := range tests {
 		test := tests[i]