Add various Map key and value validators #304

ewbankkit · 2020-01-24T22:58:26Z

Add various validators for Map keys and values:

MapKeyLenBetween validates that the provided value is of type map and the length of all keys are between min and max
MapValueLenBetween validates that the provided value is of type map and the length of all values are between min and max
MapKeyMatch validates that the provided value is of type map and all keys match a given regex
MapValueMatch validates that the provided value is of type map and all values match a given regex

$ make test
==> Checking that code complies with gofmt requirements...
go generate ./...
go test ./...
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/acctest	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/customdiff	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/helper/encryption	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/hashcode	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/helper/logging	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/mutexkv	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/pathorcontents	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/resource	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/schema	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/structure	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/helper/validation	0.012s
ok  	github.com/hashicorp/terraform-plugin-sdk/httpclient	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/addrs	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/command/format	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/configs	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/configs/configload	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/configs/configschema	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/configs/hcl2shim	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/dag	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/internal/earlyconfig	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/flatmap	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/helper/config	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/helper/didyoumean	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/helper/experiment	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/helper/plugin	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/httpclient	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/initwd	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/lang	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/lang/blocktoattr	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/lang/funcs	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/internal/modsdir	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/moduledeps	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/plans	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/internal/plans/internal/planproto	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/plans/objchange	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/plans/planfile	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/plugin/convert	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/plugin/discovery	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/internal/plugin/mock_proto	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/providers	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/internal/provisioners	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/registry	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/registry/regsrc	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/registry/response	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/internal/registry/test	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/states	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/states/statefile	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/tfdiags	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/internal/tfplugin5	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/vault/helper/pgpkeys	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/vault/sdk/helper/compressutil	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/internal/vault/sdk/helper/jsonutil	(cached)
?   	github.com/hashicorp/terraform-plugin-sdk/internal/version	[no test files]
?   	github.com/hashicorp/terraform-plugin-sdk/meta	[no test files]
ok  	github.com/hashicorp/terraform-plugin-sdk/plugin	(cached)
ok  	github.com/hashicorp/terraform-plugin-sdk/terraform	(cached)

helper/validation/map.go

ewbankkit · 2020-03-26T17:46:49Z

@appilon Sorry for the delay in responding, must have missed the e-mail.
Some examples from AWS-world are aws_eks_node_group.labels:

labels
The Kubernetes labels applied to the nodes in the node group.
Type: String to string map
Key Length Constraints: Minimum length of 1. Maximum length of 63.
Value Length Constraints: Minimum length of 1. Maximum length of 253.
Required: No

or aws_s3_bucket_object.metadata where keys must be lowercase, which could be a regexp.

appilon · 2020-04-15T22:22:37Z

Hello @ewbankkit sorry for the delayed back and forth. I see now the value of these validators. I wanted to share with you though we are working on V2 of the SDK and one of the main enhancements is Diagnostic support #368 . Validators for maps would be greatly enhanced using the new validation API being introduced in that PR. Would you be interested in landing this in V2 instead against the new function signature? I can work with you on adapting the implementation.

Or do you feel demand for these validators to land and be available in V1 of the SDK?

Either way we can get these in, and if needed forward ported or back ported.

ewbankkit · 2020-04-15T22:31:05Z

@appilon Thanks for the response. No, there's no need to get these into v1 of the SDK as we have been OK this long without them 😄. Yes, I'd be interested in adapting for v2.
I'll take a look at that linked PR to get some context.

appilon · 2020-04-15T23:03:26Z

@ewbankkit awesome! The PR is likely opaque so feel free to send me any questions on that PR or this one. I will try and update the description of it to show how to define a new ValidateDiagFunc within the next 24h

ewbankkit · 2020-04-16T22:02:57Z

@appilon Can I use the diagnostics branch in #368 to start on?

appilon · 2020-04-17T00:57:58Z

Yes @ewbankkit please rebase off that branch, it will be merged very soon and then you can rebase off version2! ~~Please give me an hour before you start, there is an important change i need to rebase into that PR.~~

ewbankkit · 2020-04-20T15:28:10Z

@appilon I had a go at converting the first of the new functions, MapKeyLenBetween and can get unit tests to pass but I have a few questions/comments:

What is the value to return for a successful validation? I assume nil
The documentation says that the v interface{} parameter will always be of the correct type so I just cast it to map[string]interface{} without a type check. Is this OK?
I pass an empty cty.Path{} as the 2nd parameter to the validation function as I don't use it (other than as the first element in the AttributePath field of the response Diagnostic
It would be helpful to see what the output of a failed validation will look like in real-life so that I can format the Summary and Detail fields nicely

appilon · 2020-04-21T23:01:18Z

helper/validation/map.go

+			len := len(key)
+			if len < min || len > max {
+				return diag.Diagnostics{{
+					Severity:      diag.Error,


As mentioned in my question answering it might be a better pattern to declare var diags diag.Diagnostics at the top and append to the slice, returning diags at the end. You could exit at the first error or actually accumulate all of them to return. Of course in situations where you cannot continue you should exit early, but in situations such as this were we can actually successfully collect multiple errors you have the ability to do so.

Right now I'm exiting at the first error but it would make sense to accumulate a Diagnostic for every key (in this function) that is in error.
This will complicate the Equals helper or expanded equivalent as for example map iteration is non-deterministic and the Diagnostics entries will potentially be in different orders.
OK, I think I've just talked myself into sorting the keys and then iterating the map in a known order and accumulating all errors - The user's experience will be better in this case.

appilon · 2020-04-21T23:04:41Z

helper/validation/map_test.go

+				t.Fatalf("%s: wrong number of diags, expected %d, got %d", tn, len(tc.ExpectedDiags), len(diags))
+			}
+			for j := range diags {
+				if diags[j].Severity != tc.ExpectedDiags[j].Severity {


Seeing test cases around diags makes me think it should have a .Equals() helper. to reduce boilerplate like this for devs. You could PR that helper in with this PR if you like. Or I can add it and you rebase.

appilon · 2020-04-21T23:07:49Z

Great @ewbankkit I'll answer each question:

What is the value to return for a successful validation? I assume nil

An empty slice of diag.Diagnostic, I believe technically returning nil is semantically fine too. The common pattern would be to begin every function with var diags diag.Diagnostics and append to it, returning the slice at the end. You could also use a named return to effectively save that one line however I personally prefer declarations at the top.

The documentation says that the v interface{} parameter will always be of the correct type so I just cast it to map[string]interface{} without a type check. Is this OK?

The SDK doesn't always agree with itself 😂 but yes I believe that's fine to just do a type assert (no ok check), Go will panic if the type isn't right which should be a signal to file a bug with the SDK.

I pass an empty cty.Path{} as the 2nd parameter to the validation function as I don't use it (other than as the first element in the AttributePath field of the response Diagnostic

I'm not sure what you meant by this? Are you referring to the tests?

It would be helpful to see what the output of a failed validation will look like in real-life so that I can format the Summary and Detail fields nicely

Here is an example:

Summary is the bolded text rendered after Error and Detail is the text rendered below the file info. We consider Detail optional.

appilon · 2020-04-22T18:29:22Z

helper/validation/map.go

+	return func(v interface{}, path cty.Path) diag.Diagnostics {
+		var diags diag.Diagnostics
+
+		for _, key := range sortedKeys(v.(map[string]interface{})) {


You could sort here or just sort in the check/test instead. Having a deterministic user experience for the diagnostics might be nice though so sorting here is certainly appropriate.

ewbankkit · 2020-04-22T19:33:19Z

helper/validation/map_test.go

+	}
+}
+
+func checkDiagnostics(t *testing.T, tn string, got, expected diag.Diagnostics) {


I've added this for now. As you mention, maybe replace with a method on Diagnostics?

This is good enough for now

ewbankkit · 2020-04-22T19:34:19Z

I've converted all 4 functions and tests.

appilon

Great Work!

ghost · 2020-05-23T01:50:06Z

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.

If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.

appilon reviewed Mar 4, 2020

View reviewed changes

helper/validation/map.go Outdated Show resolved Hide resolved

paultyng added the enhancement New feature or request label Apr 2, 2020

ewbankkit changed the base branch from master to diagnostics April 17, 2020 19:36

appilon force-pushed the diagnostics branch from f52624a to 9a3f2bf Compare April 17, 2020 21:20

appilon reviewed Apr 21, 2020

View reviewed changes

ewbankkit added 2 commits April 22, 2020 12:52

Add various Map key and value validators.

6606a63

Convert 'MapKeyLenBetween' to use diag.Diagnostics.

68bdf51

ewbankkit changed the base branch from diagnostics to version2 April 22, 2020 16:53

ewbankkit added 3 commits April 22, 2020 13:25

Changes after review.

40e95fc

Sort map keys and return a Diagnostic for all invalid keys.

f7d2432

Convert 'MapValueLenBetween' to use diag.Diagnostics.

24d31ca

appilon reviewed Apr 22, 2020

View reviewed changes

Convert 'MapKeyMatch' and 'MapValueMatch' to use diag.Diagnostics.

f43dac4

ewbankkit commented Apr 22, 2020

View reviewed changes

appilon approved these changes Apr 22, 2020

View reviewed changes

appilon merged commit 8c61605 into hashicorp:version2 Apr 22, 2020

ewbankkit deleted the map-validators branch April 23, 2020 11:27

ghost locked and limited conversation to collaborators May 23, 2020

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add various Map key and value validators #304

Add various Map key and value validators #304

ewbankkit commented Jan 24, 2020

ewbankkit commented Mar 26, 2020

appilon commented Apr 15, 2020

ewbankkit commented Apr 15, 2020

appilon commented Apr 15, 2020

ewbankkit commented Apr 16, 2020

appilon commented Apr 17, 2020 •

edited

Loading

ewbankkit commented Apr 20, 2020

appilon Apr 21, 2020 •

edited

Loading

ewbankkit Apr 22, 2020

appilon Apr 21, 2020

appilon commented Apr 21, 2020

appilon Apr 22, 2020

ewbankkit Apr 22, 2020

appilon Apr 22, 2020

ewbankkit commented Apr 22, 2020

appilon left a comment

ghost commented May 23, 2020

Add various Map key and value validators #304

Add various Map key and value validators #304

Conversation

ewbankkit commented Jan 24, 2020

ewbankkit commented Mar 26, 2020

appilon commented Apr 15, 2020

ewbankkit commented Apr 15, 2020

appilon commented Apr 15, 2020

ewbankkit commented Apr 16, 2020

appilon commented Apr 17, 2020 • edited Loading

ewbankkit commented Apr 20, 2020

appilon Apr 21, 2020 • edited Loading

Choose a reason for hiding this comment

ewbankkit Apr 22, 2020

Choose a reason for hiding this comment

appilon Apr 21, 2020

Choose a reason for hiding this comment

appilon commented Apr 21, 2020

appilon Apr 22, 2020

Choose a reason for hiding this comment

ewbankkit Apr 22, 2020

Choose a reason for hiding this comment

appilon Apr 22, 2020

Choose a reason for hiding this comment

ewbankkit commented Apr 22, 2020

appilon left a comment

Choose a reason for hiding this comment

ghost commented May 23, 2020

appilon commented Apr 17, 2020 •

edited

Loading

appilon Apr 21, 2020 •

edited

Loading