History

Fraser Waters a0e0208dd1 Change parameterization to be bytes based (#16606 ) Making this change has a couple of benefits. Firstly (and honestly the main one) is it make codegen much simpler. We just to emit a base64 string and/or other embedded byte array to the generated SDK. Currently we need emit a full `proto.Value` expression for each language, and that's not hard but it's also not trivial and means more combinations of things per test per language. Secondly it will allow providers to use more efficient encodings of their parameter than JSON if there is one. I imagine some providers might make the parameter value a protobuf message and parse that (similar to what we do for transform functions), but they can easily fallback to just treating the bytes as a JSON string if they want. The only downside to this is the value is obfuscated in the generated SDK and in the state file. Neither of those are really expected to be viewed by users, so this feels like a minor loss.		2024-07-10 11:15:35 +00:00
..
auto	Fix slice bounds out of range panic in fixupPath (#16575 )	2024-07-08 09:10:58 +00:00
common	Change parameterization to be bytes based (#16606 )	2024-07-10 11:15:35 +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	Keep package refs separate from providers (#16458 )	2024-06-24 14:59:18 +00:00
pulumi-language-go	Changelog and go.mod updates for v3.122.0 (#16551 )	2024-07-02 07:54:27 +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.