terraform-provider-binarylane/CONTRIBUTING.md

Contributing

Local development

First time setup

Based on this example from the terraform docs,

1. go mod tidy
2. Run go generate to fetch/transform the OpenAPI spec in internal/binarylane/openapi.json
3. Create or modify ~/.terraformrc in your home directory

provider_installation {
  dev_overrides {
    # Example GOBIN path, will need to be replaced with your own GOBIN path. Default is $GOPATH/bin
    "oscarhermoso/binarylane" = "/home/oscarhermoso/Git/terraform-provider-binarylane/bin"
  }

  direct {}
}

4. Build and test the provider

go build -o bin/terraform-provider-binarylane
go install
cd examples/basic
terraform plan
terraform apply

Testing

TF_ACC=1 go test -v ./...

Adding resources/data sources to the provider

1. Make any changes to provider_gen_config.yml (see https://developer.hashicorp.com/terraform/plugin/code-generation/openapi-generator#generator-config)
2. Update generated files

go generate

3. Scaffold any new resources and data sources

tfplugingen-framework scaffold resource \
    --output-dir ./internal/provider \
    --name REPLACE_ME

tfplugingen-framework scaffold data-source \
    --output-dir ./internal/provider \
    --name REPLACE_ME

4. Populate the template scaffolding:

Define the interfaces that the resource/data source should implement:

- var _ resource.Resource = (*exampleResource)(nil)
+ // Ensure the implementation satisfies the expected interfaces.
+ var (
+ 	_ resource.Resource              = &exampleResource{}
+ 	_ resource.ResourceWithConfigure = &exampleResource{}
+ 	// _ resource.ResourceWithImportState = &exampleResource{}
+ )

Pass the API client to the resource:

- type exampleResource struct{}
+ type exampleResource struct {
+ 	bc *BinarylaneClient
+ }

Add a Configure method to the resource:

+ func (d *exampleResource) Configure(_ context.Context, req resource.ConfigureRequest, resp *resource.ConfigureResponse) {
+ 	if req.ProviderData == nil {
+ 		return
+ 	}

+ 	bc, ok := req.ProviderData.(BinarylaneClient)
+ 	if !ok {
+ 		resp.Diagnostics.AddError(
+ 			"Unexpected Data Source Configure Type",
+ 			fmt.Sprintf("Expected *BinarylaneClient, got: %T.", req.ProviderData),
+ 		)

+ 		return
+ 	}

+ 	d.bc = &bc
+ }

Extend the resource model from the generated resources.*Model.

  type exampleResourceModel struct {
- 	Id types.String `tfsdk:"id"`
+ 	*resources.ExampleModel
+   // Add any additional fields here
  }

Add the new data source/resource to provider.go:

  return []func() resource.Resource{
    # ...
+   NewExampleResource,
  }