feat: support rich text fields

.changes/unreleased/Fixed-20240607-111741.yaml

@@ -0,0 +1,3 @@
+kind: Fixed
+body: Added support for richtext
+time: 2024-06-07T11:17:41.0428528+02:00

.changes/unreleased/Fixed-20240607-111759.yaml

@@ -0,0 +1,3 @@
+kind: Fixed
+body: Added better error handling
+time: 2024-06-07T11:17:59.25875202+02:00

.github/workflows/release.yaml

@@ -7,14 +7,14 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           fetch-depth: 0
 
       - name: Set up Go
-        uses: actions/setup-go@v4
+        uses: actions/setup-go@v5
         with:
-          go-version: "1.21"
+          go-version-file: 'go.mod'
 
       - name: Import GPG key
         id: import_gpg

.github/workflows/tests.yaml

@@ -8,12 +8,12 @@ jobs:
     runs-on: ubuntu-latest
 
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
 
-      - name: Set up Go 1.21
-        uses: actions/setup-go@v2
+      - name: Set up Go
+        uses: actions/setup-go@v5
         with:
-          go-version: "1.21"
+          go-version-file: 'go.mod'
 
       - name: golangci-lint
         continue-on-error: true
@@ -43,7 +43,7 @@ jobs:
           fetch-depth: 0
 
       - name: Prepare release
-        uses: labd/changie-release-action@v0.2.0
+        uses: labd/changie-release-action@v0.3.2
         with:
           github-token: ${{ secrets.GITHUB_TOKEN }}
           release-workflow: 'release.yaml'

contentful/errors.go

@@ -0,0 +1,34 @@
+package contentful
+
+import (
+	"errors"
+	"fmt"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/labd/contentful-go"
+	"strings"
+)
+
+func parseError(err error) diag.Diagnostics {
+	if !errors.As(err, &contentful.ErrorResponse{}) {
+		return diag.FromErr(err)
+	}
+
+	var warnings []diag.Diagnostic
+	for _, e := range err.(contentful.ErrorResponse).Details.Errors {
+		var path []string
+		if e.Path != nil {
+			for _, p := range e.Path.([]interface{}) {
+				path = append(path, fmt.Sprintf("%v", p))
+			}
+		}
+		warnings = append(warnings, diag.Diagnostic{
+			Severity: diag.Warning,
+			Summary:  fmt.Sprintf("%s (%s)", e.Details, strings.Join(path, ".")),
+		})
+	}
+
+	return append(warnings, diag.Diagnostic{
+		Severity: diag.Error,
+		Summary:  err.(contentful.ErrorResponse).Message,
+	})
+}

contentful/errors_test.go

@@ -0,0 +1,69 @@
+package contentful
+
+import (
+	"fmt"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/labd/contentful-go"
+	"github.com/stretchr/testify/assert"
+	"testing"
+)
+
+func TestParseError_Nil(t *testing.T) {
+	d := parseError(nil)
+	assert.Nil(t, d)
+}
+
+func TestParseError_RegularErr(t *testing.T) {
+	d := parseError(fmt.Errorf("regular error"))
+	assert.True(t, d.HasError())
+	assert.Equal(t, d[0].Summary, "regular error")
+}
+
+func TestParseError_WithoutWarning(t *testing.T) {
+	d := parseError(&contentful.ErrorResponse{
+		Message: "error message",
+	})
+	assert.True(t, d.HasError())
+	assert.Equal(t, len(d), 1)
+	assert.Equal(t, d[0].Summary, "error message")
+	assert.Equal(t, d[0].Severity, diag.Error)
+}
+
+func TestParseError_WithWarning_WithoutPath(t *testing.T) {
+	d := parseError(contentful.ErrorResponse{
+		Message: "error message",
+		Details: &contentful.ErrorDetails{
+			Errors: []*contentful.ErrorDetail{
+				{
+					Details: "error detail",
+				},
+			},
+		},
+	})
+	assert.True(t, d.HasError())
+	assert.Equal(t, len(d), 2)
+	assert.Equal(t, d[0].Summary, "error detail ()")
+	assert.Equal(t, d[0].Severity, diag.Warning)
+	assert.Equal(t, d[1].Summary, "error message")
+	assert.Equal(t, d[1].Severity, diag.Error)
+}
+
+func TestParseError_WithWarning_WithPath(t *testing.T) {
+	d := parseError(contentful.ErrorResponse{
+		Message: "error message",
+		Details: &contentful.ErrorDetails{
+			Errors: []*contentful.ErrorDetail{
+				{
+					Path:    []interface{}{"path", "to", "error"},
+					Details: "error detail",
+				},
+			},
+		},
+	})
+	assert.True(t, d.HasError())
+	assert.Equal(t, len(d), 2)
+	assert.Equal(t, d[0].Summary, "error detail (path.to.error)")
+	assert.Equal(t, d[0].Severity, diag.Warning)
+	assert.Equal(t, d[1].Summary, "error message")
+	assert.Equal(t, d[1].Severity, diag.Error)
+}

contentful/provider_test.go

@@ -27,11 +27,14 @@ func TestProvider_impl(t *testing.T) {
 }
 
 func testAccPreCheck(t *testing.T) {
-	var cmaToken, organizationID string
+	var cmaToken, organizationID, sId string
 	if cmaToken = CMAToken; cmaToken == "" {
 		t.Fatal("CONTENTFUL_MANAGEMENT_TOKEN must set with a valid Contentful Content Management API Token for acceptance tests")
 	}
 	if organizationID = orgID; organizationID == "" {
 		t.Fatal("CONTENTFUL_ORGANIZATION_ID must set with a valid Contentful Organization ID for acceptance tests")
 	}
+	if sId = spaceID; sId == "" {
+		t.Fatal("SPACE_ID must set with a valid Space ID for acceptance tests")
+	}
 }

contentful/resource_contentful_apikey.go

@@ -1,6 +1,9 @@
 package contentful
 
 import (
+	"context"
+	"errors"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
 	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
 	"github.com/labd/contentful-go"
 )
@@ -9,10 +12,10 @@ func resourceContentfulAPIKey() *schema.Resource {
 	return &schema.Resource{
 		Description: "A Contentful API Key represents a token that can be used to authenticate against the Contentful Content Delivery API and Content Preview API.",
 
-		Create: resourceCreateAPIKey,
-		Read:   resourceReadAPIKey,
-		Update: resourceUpdateAPIKey,
-		Delete: resourceDeleteAPIKey,
+		CreateContext: resourceCreateAPIKey,
+		ReadContext:   resourceReadAPIKey,
+		UpdateContext: resourceUpdateAPIKey,
+		DeleteContext: resourceDeleteAPIKey,
 
 		Schema: map[string]*schema.Schema{
 			"version": {
@@ -39,80 +42,91 @@ func resourceContentfulAPIKey() *schema.Resource {
 	}
 }
 
-func resourceCreateAPIKey(d *schema.ResourceData, m interface{}) (err error) {
+func resourceCreateAPIKey(_ context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	client := m.(*contentful.Client)
 
 	apiKey := &contentful.APIKey{
 		Name:        d.Get("name").(string),
 		Description: d.Get("description").(string),
 	}
 
-	err = client.APIKeys.Upsert(d.Get("space_id").(string), apiKey)
+	err := client.APIKeys.Upsert(d.Get("space_id").(string), apiKey)
 	if err != nil {
-		return err
+		return parseError(err)
 	}
 
 	if err := setAPIKeyProperties(d, apiKey); err != nil {
-		return err
+		return parseError(err)
 	}
 
 	d.SetId(apiKey.Sys.ID)
 
 	return nil
 }
 
-func resourceUpdateAPIKey(d *schema.ResourceData, m interface{}) (err error) {
+func resourceUpdateAPIKey(_ context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	client := m.(*contentful.Client)
 	spaceID := d.Get("space_id").(string)
 	apiKeyID := d.Id()
 
 	apiKey, err := client.APIKeys.Get(spaceID, apiKeyID)
 	if err != nil {
-		return err
+		return parseError(err)
 	}
 
 	apiKey.Name = d.Get("name").(string)
 	apiKey.Description = d.Get("description").(string)
 
 	err = client.APIKeys.Upsert(spaceID, apiKey)
 	if err != nil {
-		return err
+		return parseError(err)
 	}
 
 	if err := setAPIKeyProperties(d, apiKey); err != nil {
-		return err
+		return parseError(err)
 	}
 
 	d.SetId(apiKey.Sys.ID)
 
 	return nil
 }
 
-func resourceReadAPIKey(d *schema.ResourceData, m interface{}) (err error) {
+func resourceReadAPIKey(_ context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	client := m.(*contentful.Client)
 	spaceID := d.Get("space_id").(string)
 	apiKeyID := d.Id()
 
 	apiKey, err := client.APIKeys.Get(spaceID, apiKeyID)
-	if _, ok := err.(contentful.NotFoundError); ok {
+	var notFoundError contentful.NotFoundError
+	if errors.As(err, &notFoundError) {
 		d.SetId("")
 		return nil
 	}
 
-	return setAPIKeyProperties(d, apiKey)
+	err = setAPIKeyProperties(d, apiKey)
+	if err != nil {
+		return parseError(err)
+	}
+
+	return nil
 }
 
-func resourceDeleteAPIKey(d *schema.ResourceData, m interface{}) (err error) {
+func resourceDeleteAPIKey(_ context.Context, d *schema.ResourceData, m interface{}) diag.Diagnostics {
 	client := m.(*contentful.Client)
 	spaceID := d.Get("space_id").(string)
 	apiKeyID := d.Id()
 
 	apiKey, err := client.APIKeys.Get(spaceID, apiKeyID)
 	if err != nil {
-		return err
+		return parseError(err)
 	}
 
-	return client.APIKeys.Delete(spaceID, apiKey)
+	err = client.APIKeys.Delete(spaceID, apiKey)
+	if err != nil {
+		return parseError(err)
+	}
+
+	return nil
 }
 
 func setAPIKeyProperties(d *schema.ResourceData, apiKey *contentful.APIKey) error {