feat: add custom_property block for repository resource (#9)

Author: mroyme

docs/resources/repository.md

@@ -46,6 +46,64 @@ resource "github_repository" "example" {
 }
 ```
 
+## Example Usage with Custom Properties
+
+```terraform
+# This example matches the user's requested format with native HCL lists
+resource "github_repository" "example" {
+  name        = "example"
+  description = "My awesome codebase"
+
+  custom_property {
+    name  = "foo"
+    value = ["bar"]
+  }
+
+  custom_property {
+    name  = "boolean"
+    value = ["false"]
+  }
+
+  custom_property {
+    name  = "multiselect"
+    value = ["goo", "zoo"]
+  }
+
+  custom_property {
+    name  = "singleselect"
+    value = ["acme"]
+  }
+}
+```
+
+## Example Usage with Collaborative Custom Property Management
+
+The following example illustrates collaborative management of repository custom properties by setting `exclusive_custom_properties = false` and delegating an additional property to the standalone `github_repository_custom_property` resource.
+
+```terraform
+# This example demonstrates collaborative management of repository custom properties.
+# It assumes the organization already defines the referenced custom properties.
+
+resource "github_repository" "example" {
+  name        = "example-shared-custom-props"
+  description = "Repository with collaboratively managed custom properties"
+
+  exclusive_custom_properties = false
+
+  custom_property {
+    name  = "deployment-environment"
+    value = ["production"]
+  }
+}
+
+resource "github_repository_custom_property" "compliance" {
+  repository     = github_repository.example.name
+  property_name  = "compliance-tier"
+  property_type  = "string"
+  property_value = ["regulated"]
+}
+```
+
 <!-- schema generated by tfplugindocs -->
 ## Schema
 
@@ -63,9 +121,11 @@ resource "github_repository" "example" {
 - `archive_on_destroy` (Boolean) Set to 'true' to archive the repository instead of deleting on destroy.
 - `archived` (Boolean) Specifies if the repository should be archived. Defaults to 'false'. NOTE Currently, the API does not support unarchiving.
 - `auto_init` (Boolean) Set to 'true' to produce an initial commit in the repository.
+- `custom_property` (Block Set) Custom properties for the repository. (see [below for nested schema](#nestedblock--custom_property))
 - `default_branch` (String, Deprecated) Can only be set after initial repository creation, and only if the target branch exists
 - `delete_branch_on_merge` (Boolean) Automatically delete head branch after a pull request is merged. Defaults to 'false'.
 - `description` (String) A description of the repository.
+- `exclusive_custom_properties` (Boolean) Whether this resource exclusively manages all custom properties. Defaults to 'true'; if set to 'false', only properties defined in custom_property blocks will be managed by this resource, allowing collaborative management of custom property settings.
 - `gitignore_template` (String) Use the name of the template without the extension. For example, 'Haskell'.
 - `has_discussions` (Boolean) Set to 'true' to enable GitHub Discussions on the repository. Defaults to 'false'.
 - `has_downloads` (Boolean) Set to 'true' to enable the (deprecated) downloads features on the repository.
@@ -91,6 +151,7 @@ resource "github_repository" "example" {
 
 ### Read-Only
 
+- `all_custom_properties` (Map of String) All custom properties set on the repository, including those not managed by this resource.
 - `etag` (String)
 - `full_name` (String) A string of the form 'orgname/reponame'.
 - `git_clone_url` (String) URL that can be provided to 'git clone' to clone the repository anonymously via the git protocol.
@@ -103,6 +164,15 @@ resource "github_repository" "example" {
 - `ssh_clone_url` (String) URL that can be provided to 'git clone' to clone the repository via SSH.
 - `svn_url` (String) URL that can be provided to 'svn checkout' to check out the repository via GitHub's Subversion protocol emulation.
 
+<a id="nestedblock--custom_property"></a>
+### Nested Schema for `custom_property`
+
+Required:
+
+- `name` (String) The name of the custom property.
+- `value` (List of String) The value(s) of the custom property. For single-value properties, provide a list with one element. For multi-select properties, provide multiple elements.
+
+
 <a id="nestedblock--pages"></a>
 ### Nested Schema for `pages`
 

examples/resources/github_organization_custom_property/README.md

@@ -0,0 +1,72 @@
+# GitHub Organization Custom Property
+
+This example demonstrates how to create and manage custom properties for a GitHub organization.
+
+## Usage
+
+```hcl
+resource "github_organization_custom_property" "environment" {
+  name               = "environment"
+  value_type         = "single_select"
+  required           = true
+  default_value      = "production"
+  description        = "Prod or dev environment"
+  allowed_values     = ["production", "development"]
+  values_editable_by = "org_actors"
+}
+```
+
+## Attributes
+
+- `name` - (Required) Name of the custom property
+- `value_type` - (Required) Type of the value for the property. Can be one of: `single_select`, `multi_select`, `string`, `true_false`
+- `required` - (Optional) Whether the property is required. Defaults to `false`
+- `default_value` - (Optional) Default value of the property
+- `description` - (Optional) A short description of the property
+- `allowed_values` - (Optional) List of allowed values for the property. Only applies when `value_type` is `single_select` or `multi_select`
+- `values_editable_by` - (Optional) Who can edit the values of the property. Can be one of: `org_actors`, `org_and_repo_actors`. Defaults to `org_actors`
+
+## Additional Examples
+
+### Multi-select property
+
+```hcl
+resource "github_organization_custom_property" "tags" {
+  name               = "tags"
+  value_type         = "multi_select"
+  required           = false
+  description        = "Project tags"
+  allowed_values     = ["frontend", "backend", "database", "api"]
+  values_editable_by = "org_and_repo_actors"
+}
+```
+
+### String property
+
+```hcl
+resource "github_organization_custom_property" "owner" {
+  name               = "owner"
+  value_type         = "string"
+  required           = false
+  description        = "Repository owner"
+  values_editable_by = "org_actors"
+}
+```
+
+### True/False property
+
+```hcl
+resource "github_organization_custom_property" "archived" {
+  name               = "archived"
+  value_type         = "true_false"
+  required           = false
+  description        = "Is this repository archived"
+  values_editable_by = "org_actors"
+}
+```
+
+## Notes
+
+- Custom properties are defined at the organization level and can be applied to repositories within the organization
+- When using `single_select` or `multi_select`, the `allowed_values` field is required
+- The `name` and `value_type` fields cannot be changed after creation (they are ForceNew)

examples/resources/github_repository/example_3.tf

@@ -0,0 +1,25 @@
+# This example matches the user's requested format with native HCL lists
+resource "github_repository" "example" {
+  name        = "example"
+  description = "My awesome codebase"
+
+  custom_property {
+    name  = "foo"
+    value = ["bar"]
+  }
+
+  custom_property {
+    name  = "boolean"
+    value = ["false"]
+  }
+
+  custom_property {
+    name  = "multiselect"
+    value = ["goo", "zoo"]
+  }
+
+  custom_property {
+    name  = "singleselect"
+    value = ["acme"]
+  }
+}

examples/resources/github_repository/example_4.tf

@@ -0,0 +1,21 @@
+# This example demonstrates collaborative management of repository custom properties.
+# It assumes the organization already defines the referenced custom properties.
+
+resource "github_repository" "example" {
+  name        = "example-shared-custom-props"
+  description = "Repository with collaboratively managed custom properties"
+
+  exclusive_custom_properties = false
+
+  custom_property {
+    name  = "deployment-environment"
+    value = ["production"]
+  }
+}
+
+resource "github_repository_custom_property" "compliance" {
+  repository     = github_repository.example.name
+  property_name  = "compliance-tier"
+  property_type  = "string"
+  property_value = ["regulated"]
+}