providerserver

package

v1.5.1 Latest Latest Go to latest Published: Aug 31, 2023 License: MPL-2.0 Imports: 7 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/hashicorp/terraform-plugin-testing

Links

Open Source Insights

Documentation ¶

Overview ¶

Package providerserver provides testsdk handling of serving a provider.

Index ¶

func DynamicValueToValue(schema *tfprotov6.Schema, dynamicValue *tfprotov6.DynamicValue) (tftypes.Value, *tfprotov6.Diagnostic)
func NewProviderServer(p provider.Provider) func() (tfprotov6.ProviderServer, error)
func NewProviderServerWithError(p provider.Provider, err error) func() (tfprotov6.ProviderServer, error)
func ProviderDataSource(p provider.Provider, typeName string) (datasource.DataSource, *tfprotov6.Diagnostic)
func ProviderResource(p provider.Provider, typeName string) (resource.Resource, *tfprotov6.Diagnostic)
func SchemaAttributeAtPath(schema *tfprotov6.Schema, path *tftypes.AttributePath) *tfprotov6.SchemaAttribute
func ValuetoDynamicValue(schema *tfprotov6.Schema, value tftypes.Value) (*tfprotov6.DynamicValue, *tfprotov6.Diagnostic)
type ProviderServer

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func DynamicValueToValue ¶

func DynamicValueToValue(schema *tfprotov6.Schema, dynamicValue *tfprotov6.DynamicValue) (tftypes.Value, *tfprotov6.Diagnostic)

func NewProviderServer ¶

func NewProviderServer(p provider.Provider) func() (tfprotov6.ProviderServer, error)

NewProviderServer returns a lightweight protocol version 6 provider server for consumption with ProtoV6ProviderFactories.

func NewProviderServerWithError ¶

func NewProviderServerWithError(p provider.Provider, err error) func() (tfprotov6.ProviderServer, error)

NewProviderServerWithError returns a lightweight protocol version 6 provider server and an associated error for consumption with ProtoV6ProviderFactories.

func ProviderDataSource ¶

func ProviderDataSource(p provider.Provider, typeName string) (datasource.DataSource, *tfprotov6.Diagnostic)

func ProviderResource ¶

func ProviderResource(p provider.Provider, typeName string) (resource.Resource, *tfprotov6.Diagnostic)

func SchemaAttributeAtPath ¶

func SchemaAttributeAtPath(schema *tfprotov6.Schema, path *tftypes.AttributePath) *tfprotov6.SchemaAttribute

func ValuetoDynamicValue ¶

func ValuetoDynamicValue(schema *tfprotov6.Schema, value tftypes.Value) (*tfprotov6.DynamicValue, *tfprotov6.Diagnostic)

Types ¶

type ProviderServer ¶

type ProviderServer struct {
	Provider provider.Provider
}

ProviderServer is a lightweight protocol version 6 provider server which is assumed to be well-behaved, e.g. does not return gRPC errors.

This implementation intends to reduce the heaviest parts of terraform-plugin-go based provider development:

Converting *tfprotov6.DynamicValue to tftypes.Value using schema
Splitting ApplyResourceChange into Create/Update/Delete calls
Set PlanResourceChange null config values of Computed attributes to unknown
Roundtrip UpgradeResourceState with equal schema version

By default, the following data is copied automatically:

ApplyResourceChange (create): req.Config -> resp.NewState
ApplyResourceChange (delete): req.PlannedState -> resp.NewState
ApplyResourceChange (update): req.PlannedState -> resp.NewState
PlanResourceChange: req.ProposedNewState -> resp.PlannedState
ReadDataSource: req.Config -> resp.State
ReadResource: req.CurrentState -> resp.NewState

func (ProviderServer) ApplyResourceChange ¶

func (s ProviderServer) ApplyResourceChange(ctx context.Context, req *tfprotov6.ApplyResourceChangeRequest) (*tfprotov6.ApplyResourceChangeResponse, error)

func (ProviderServer) ConfigureProvider ¶

func (s ProviderServer) ConfigureProvider(ctx context.Context, req *tfprotov6.ConfigureProviderRequest) (*tfprotov6.ConfigureProviderResponse, error)

func (ProviderServer) GetProviderSchema ¶

func (s ProviderServer) GetProviderSchema(ctx context.Context, req *tfprotov6.GetProviderSchemaRequest) (*tfprotov6.GetProviderSchemaResponse, error)

func (ProviderServer) ImportResourceState ¶

func (s ProviderServer) ImportResourceState(ctx context.Context, req *tfprotov6.ImportResourceStateRequest) (*tfprotov6.ImportResourceStateResponse, error)

func (ProviderServer) PlanResourceChange ¶

func (s ProviderServer) PlanResourceChange(ctx context.Context, req *tfprotov6.PlanResourceChangeRequest) (*tfprotov6.PlanResourceChangeResponse, error)

func (ProviderServer) ReadDataSource ¶

func (s ProviderServer) ReadDataSource(ctx context.Context, req *tfprotov6.ReadDataSourceRequest) (*tfprotov6.ReadDataSourceResponse, error)

func (ProviderServer) ReadResource ¶

func (s ProviderServer) ReadResource(ctx context.Context, req *tfprotov6.ReadResourceRequest) (*tfprotov6.ReadResourceResponse, error)

func (ProviderServer) StopProvider ¶

func (s ProviderServer) StopProvider(ctx context.Context, req *tfprotov6.StopProviderRequest) (*tfprotov6.StopProviderResponse, error)

func (ProviderServer) UpgradeResourceState ¶

func (s ProviderServer) UpgradeResourceState(ctx context.Context, req *tfprotov6.UpgradeResourceStateRequest) (*tfprotov6.UpgradeResourceStateResponse, error)

func (ProviderServer) ValidateDataResourceConfig ¶

func (s ProviderServer) ValidateDataResourceConfig(ctx context.Context, req *tfprotov6.ValidateDataResourceConfigRequest) (*tfprotov6.ValidateDataResourceConfigResponse, error)

func (ProviderServer) ValidateProviderConfig ¶

func (s ProviderServer) ValidateProviderConfig(ctx context.Context, req *tfprotov6.ValidateProviderConfigRequest) (*tfprotov6.ValidateProviderConfigResponse, error)

func (ProviderServer) ValidateResourceConfig ¶

func (s ProviderServer) ValidateResourceConfig(ctx context.Context, req *tfprotov6.ValidateResourceConfigRequest) (*tfprotov6.ValidateResourceConfigResponse, error)

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL