feat: Add gitea_gpg_key resource (#106)

Add a new resource to manage a user's GPG keys. Due to a limitation in
Gitea's API, it is only possible to manage GPG keys for the current
user. This is not ideal, but still better than nothing.
If such an API is created, we could extend this resource with an
optional username, while keeping the current behavior as is.

Co-authored-by: techknowlogick <techknowlogick@noreply.gitea.com>
Reviewed-on: https://gitea.com/gitea/terraform-provider-gitea/pulls/106
Reviewed-by: techknowlogick <techknowlogick@noreply.gitea.com>
Co-authored-by: Mathieu Lemay <acidrain1@gmail.com>
Co-committed-by: Mathieu Lemay <acidrain1@gmail.com>

Author: mathieu-lemay

docs/resources/gpg_key.md

@@ -0,0 +1,25 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "gitea_gpg_key Resource - terraform-provider-gitea"
+subcategory: ""
+description: |-
+  gitea_gpg_key manages gpg keys that are associated with the current user.
+---
+
+# gitea_gpg_key (Resource)
+
+`gitea_gpg_key` manages gpg keys that are associated with the current user.
+
+
+
+<!-- schema generated by tfplugindocs -->
+## Schema
+
+### Required
+
+- `armored_public_key` (String) An armored GPG public key
+
+### Read-Only
+
+- `id` (String) The ID of this resource.
+- `key_id` (String) The ID of the GPG key

gitea/provider.go

@@ -80,6 +80,7 @@ func Provider() *schema.Provider {
 			"gitea_repository":                   resourceGiteaRepository(),
 			"gitea_fork":                         resourceGiteaFork(),
 			"gitea_public_key":                   resourceGiteaPublicKey(),
+			"gitea_gpg_key":                      resourceGiteaGPGKey(),
 			"gitea_team":                         resourceGiteaTeam(),
 			"gitea_team_membership":              resourceGiteaTeamMembership(),
 			"gitea_team_members":                 resourceGiteaTeamMembers(),

gitea/resource_gitea_gpg_key.go

@@ -0,0 +1,116 @@
+package gitea
+
+import (
+	"context"
+	"fmt"
+	"strconv"
+
+	"code.gitea.io/sdk/gitea"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/diag"
+	"github.com/hashicorp/terraform-plugin-sdk/v2/helper/schema"
+)
+
+const (
+	GPGKeyId      string = "id"
+	GPGKeyArmored string = "armored_public_key"
+	GPGKeyGPGId   string = "key_id"
+)
+
+func resourceGPGKeyRead(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*gitea.Client)
+
+	id, err := strconv.ParseInt(d.Id(), 10, 64)
+
+	var resp *gitea.Response
+	var pubKey *gitea.GPGKey
+
+	pubKey, resp, err = client.GetGPGKey(id)
+
+	if err != nil {
+		if resp.StatusCode == 404 {
+			d.SetId("")
+			return nil
+		} else {
+			return diag.FromErr(err)
+		}
+	}
+
+	err = setGPGKeyResourceData(pubKey, d)
+
+	return diag.FromErr(err)
+}
+
+func resourceGPGKeyCreate(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*gitea.Client)
+
+	var pubKey *gitea.GPGKey
+	var err error
+
+	opts := gitea.CreateGPGKeyOption{
+		ArmoredKey: d.Get(GPGKeyArmored).(string),
+	}
+
+	pubKey, _, err = client.CreateGPGKey(opts)
+	if err != nil {
+		return diag.FromErr(fmt.Errorf("error creating gpg key: %w", err))
+	}
+
+	err = setGPGKeyResourceData(pubKey, d)
+
+	return diag.FromErr(err)
+}
+
+func resourceGPGKeyDelete(ctx context.Context, d *schema.ResourceData, meta interface{}) diag.Diagnostics {
+	client := meta.(*gitea.Client)
+
+	id, err := strconv.ParseInt(d.Id(), 10, 64)
+	if err != nil {
+		return diag.FromErr(fmt.Errorf("error deleting gpg key: invalid id: %w", err))
+	}
+
+	var resp *gitea.Response
+
+	resp, err = client.DeleteGPGKey(id)
+
+	if err != nil {
+		if resp.StatusCode == 404 {
+			return nil
+		} else {
+			return diag.FromErr(fmt.Errorf("error deleting gpg key: %w", err))
+		}
+	}
+
+	return nil
+}
+
+func setGPGKeyResourceData(pubKey *gitea.GPGKey, d *schema.ResourceData) error {
+	d.SetId(fmt.Sprintf("%d", pubKey.ID))
+	d.Set(GPGKeyGPGId, pubKey.KeyID)
+
+	return nil
+}
+
+func resourceGiteaGPGKey() *schema.Resource {
+	return &schema.Resource{
+		ReadContext:   resourceGPGKeyRead,
+		CreateContext: resourceGPGKeyCreate,
+		DeleteContext: resourceGPGKeyDelete,
+		Importer: &schema.ResourceImporter{
+			StateContext: schema.ImportStatePassthroughContext,
+		},
+		Schema: map[string]*schema.Schema{
+			"armored_public_key": {
+				Type:        schema.TypeString,
+				Required:    true,
+				ForceNew:    true,
+				Description: "An armored GPG public key",
+			},
+			"key_id": {
+				Type:        schema.TypeString,
+				Computed:    true,
+				Description: "The ID of the GPG key",
+			},
+		},
+		Description: "`gitea_gpg_key` manages gpg keys that are associated with the current user.",
+	}
+}