History

Ian Wahbe 78c48204e0 Normalize plugin.Provider methods to (Context, Request) -> (Response, error) (#16302 ) Normalize methods on plugin.Provider to the form: ```go Method(context.Context, MethodRequest) (MethodResponse, error) ``` This provides a more consistent and forwards compatible interface for each of our methods. --- I'm motivated to work on this because the bridge maintains a copy of this interface: `ProviderWithContext`. This doubles the pain of dealing with any breaking change and this PR would allow me to remove the extra interface. I'm willing to fix consumers of `plugin.Provider` in `pulumi/pulumi`, but I wanted to make sure that we would be willing to merge this PR if I get it green. <!--- Thanks so much for your contribution! If this is your first time contributing, please ensure that you have read the [CONTRIBUTING](https://github.com/pulumi/pulumi/blob/master/CONTRIBUTING.md) documentation. --> # Description <!--- Please include a summary of the change and which issue is fixed. Please also include relevant motivation and context. --> Fixes # (issue) ## Checklist - [ ] I have run `make tidy` to update any new dependencies - [ ] I have run `make lint` to verify my code passes the lint check - [ ] I have formatted my code using `gofumpt` <!--- Please provide details if the checkbox below is to be left unchecked. --> - [ ] I have added tests that prove my fix is effective or that my feature works <!--- User-facing changes require a CHANGELOG entry. --> - [ ] I have run `make changelog` and committed the `changelog/pending/<file>` documenting my change <!-- If the change(s) in this PR is a modification of an existing call to the Pulumi Cloud, then the service should honor older versions of the CLI where this change would not exist. You must then bump the API version in /pkg/backend/httpstate/client/api.go, as well as add it to the service. --> - [ ] Yes, there are changes in this PR that warrants bumping the Pulumi Cloud API version <!-- @Pulumi employees: If yes, you must submit corresponding changes in the service repo. -->		2024-06-07 19:47:49 +00:00
..
auto	Add support for `--all` parameter of the `stack ls` command to the Automation API (#16266 )	2024-06-03 15:53:43 +00:00
common	Normalize plugin.Provider methods to (Context, Request) -> (Response, error) (#16302 )	2024-06-07 19:47:49 +00:00
internal	turn on the golangci-lint exhaustive linter (#15028 )	2024-01-17 16:50:41 +00:00
property	Property map keys are just strings (#15767 )	2024-03-25 17:26:41 +00:00
pulumi	Flip stack transforms to non-experimental (#16282 )	2024-05-30 18:01:33 +00:00
pulumi-language-go	Pass ProgramInfo through to LanguageRuntime.About (#16311 )	2024-06-06 08:21:46 +00:00
pulumix	Use EqualError/ErrorContains instead of Error (#14737 )	2023-12-08 06:40:14 +00:00
Makefile	make(sdk/go): Use -C instead of cd for 'go' commands (#13853 )	2023-08-31 21:12:03 +00:00
README.md	`pulumi update` => `pulumi up` (#2702 )	2019-05-06 14:00:18 -07:00

README.md

Pulumi Golang SDK

This directory contains support for writing Pulumi programs in the Go language. There are two aspects to this:

pulumi/ contains the client language bindings Pulumi program's code directly against;
pulumi-language-go/ contains the language host plugin that the Pulumi engine uses to orchestrate updates.

To author a Pulumi program in Go, simply say so in your Pulumi.yaml

name: <my-project>
runtime: go

and ensure you have pulumi-language-go on your path (it is distributed in the Pulumi download automatically).

By default, the language plugin will use your project's name, <my-project>, as the executable that it loads. This too must be on your path for the language provider to load it when you run pulumi preview or pulumi up.