Add enforcement level to policies

[JarrettSpiker]

Description

Adds support for the EnforcementLevel field for policies, and their create/update options.

The current method of adding enforcement to policies (the Enforce array) is deprecated.

Testing plan

1. Policies can still be created with the existing enforce array
2. Policies can be created using the preferred enforcement level string
3. Either Enforce or EnforcementLevel must be set on policies during creation
4. Enforce and Enforcement level may not both be set on policy creation

External links

• API documentation

Output from tests

go test -timeout 30s -run ^TestPoliciesCreate$ github.com/hashicorp/go-tfe

=== RUN   TestPoliciesCreate
=== RUN   TestPoliciesCreate/with_no_kind
--- PASS: TestPoliciesCreate/with_no_kind (0.47s)
=== RUN   TestPoliciesCreate/with_valid_options_-_Sentinel
--- PASS: TestPoliciesCreate/with_valid_options_-_Sentinel (0.50s)
=== RUN   TestPoliciesCreate/with_valid_options_-_OPA
--- PASS: TestPoliciesCreate/with_valid_options_-_OPA (0.42s)
=== RUN   TestPoliciesCreate/with_valid_options_-_Enforcement_Level
--- PASS: TestPoliciesCreate/with_valid_options_-_Enforcement_Level (0.60s)
=== RUN   TestPoliciesCreate/when_options_has_an_invalid_name
--- PASS: TestPoliciesCreate/when_options_has_an_invalid_name (0.00s)
=== RUN   TestPoliciesCreate/when_options_has_an_invalid_name_-_OPA
--- PASS: TestPoliciesCreate/when_options_has_an_invalid_name_-_OPA (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_name
--- PASS: TestPoliciesCreate/when_options_is_missing_name (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_name_-_OPA
--- PASS: TestPoliciesCreate/when_options_is_missing_name_-_OPA (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_query_-_OPA
--- PASS: TestPoliciesCreate/when_options_is_missing_query_-_OPA (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_an_enforcement-OPA
--- PASS: TestPoliciesCreate/when_options_is_missing_an_enforcement-OPA (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_an_enforcement-Sentinel
--- PASS: TestPoliciesCreate/when_options_is_missing_an_enforcement-Sentinel (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_enforcement_path-Sentinel
--- PASS: TestPoliciesCreate/when_options_is_missing_enforcement_path-Sentinel (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_enforcement_path-OPA
--- PASS: TestPoliciesCreate/when_options_is_missing_enforcement_path-OPA (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_enforcement_path
--- PASS: TestPoliciesCreate/when_options_is_missing_enforcement_path (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_missing_enforcement_mode-OPA
--- PASS: TestPoliciesCreate/when_options_is_missing_enforcement_mode-OPA (0.00s)
=== RUN   TestPoliciesCreate/when_options_is_have_both_enforcement_level_and_enforcement_path
--- PASS: TestPoliciesCreate/when_options_is_have_both_enforcement_level_and_enforcement_path (0.00s)
=== RUN   TestPoliciesCreate/when_options_has_an_invalid_organization
--- PASS: TestPoliciesCreate/when_options_has_an_invalid_organization (0.00s)
--- PASS: TestPoliciesCreate (3.22s)
PASS
ok      github.com/hashicorp/go-tfe     3.413s

go test -timeout 30s -run ^TestPoliciesRead$ github.com/hashicorp/go-tfe

=== RUN   TestPoliciesRead
=== RUN   TestPoliciesRead/when_the_policy_exists_without_content
--- PASS: TestPoliciesRead/when_the_policy_exists_without_content (0.20s)
=== RUN   TestPoliciesRead/when_the_policy_exists_with_content
--- PASS: TestPoliciesRead/when_the_policy_exists_with_content (0.24s)
=== RUN   TestPoliciesRead/when_the_policy_does_not_exist
--- PASS: TestPoliciesRead/when_the_policy_does_not_exist (0.18s)
=== RUN   TestPoliciesRead/without_a_valid_policy_ID
--- PASS: TestPoliciesRead/without_a_valid_policy_ID (0.00s)
--- PASS: TestPoliciesRead (2.84s)
PASS
ok      github.com/hashicorp/go-tfe     3.041s

go test -timeout 30s -run ^TestPoliciesUpdate$ github.com/hashicorp/go-tfe

=== RUN   TestPoliciesUpdate
=== RUN   TestPoliciesUpdate/when_updating_with_an_existing_path
--- PASS: TestPoliciesUpdate/when_updating_with_an_existing_path (1.43s)
=== RUN   TestPoliciesUpdate/when_updating_with_a_nonexisting_path
    /Users/jarretspiker/go/src/github.com/hashicorp/go-tfe/policy_integration_test.go:516: see comment...
--- SKIP: TestPoliciesUpdate/when_updating_with_a_nonexisting_path (0.00s)
=== RUN   TestPoliciesUpdate/with_a_new_description
--- PASS: TestPoliciesUpdate/with_a_new_description (1.31s)
=== RUN   TestPoliciesUpdate/with_a_new_query
--- PASS: TestPoliciesUpdate/with_a_new_query (1.42s)
=== RUN   TestPoliciesUpdate/with_a_new_enforcement_level
--- PASS: TestPoliciesUpdate/with_a_new_enforcement_level (1.34s)
=== RUN   TestPoliciesUpdate/update_query_when_kind_is_not_OPA
--- PASS: TestPoliciesUpdate/update_query_when_kind_is_not_OPA (1.29s)
=== RUN   TestPoliciesUpdate/without_a_valid_policy_ID
--- PASS: TestPoliciesUpdate/without_a_valid_policy_ID (0.00s)
--- PASS: TestPoliciesUpdate (8.01s)
PASS
ok      github.com/hashicorp/go-tfe     8.209s

...

[cam-stitt]

This is beautiful. I haven't tested locally but looks good.

[github-actions]

Reminder to the contributor that merged this PR: if your changes have added important functionality or fixed a relevant bug, open a follow-up PR to update CHANGELOG.md with a note on your changes.