History

Will Jones b85a92cd5c Have `Host.Provider` accept a `PackageDescriptor` (#17244 ) Plugins are the core means by which Pulumi may be extended. Language hosts, resource providers, analyzers, and converters, for instance, are all kinds of plugin. Plugins are loaded by a plugin `Host`, which also offers convenience methods for loading specific kinds of plugin such as those mentioned above. The `Provider` method on `Host` currently accepts a name and version. This is not ideal, since there are several other parameters that may affect the plugin to be loaded, as well as what operations may be run on it when it is loaded: * Custom download URLs and checksums may be desirable to control where a plugin is retrieved from, and to verify a plugin's integrity. * Parameterization means that while the `aws` provider is desired, it is actually provided by a dynamically-bridging `terraform` plugin which is to be supplied with a parameter such as `{"name":"aws","version":"..."}`. This PR begins reworking the `Host` interface so that its `Provider` method accepts a more complete `PackageDescriptor`, consisting of a full `PluginSpec` and an optional `Parameterization`. Presently this PR just replicates existing call sites to use the new data structure -- if this merges successfully then several of these call sites can likely be cleaned up further by moving duplicated logic that handles things like custom download URLs, etc. _into_ the newly capable `Provider` implementation.		2024-09-12 13:17:30 +00:00
..
cgstrings	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00
convert	Have `Host.Provider` accept a `PackageDescriptor` (#17244 )	2024-09-12 13:17:30 +00:00
docs	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00
dotnet	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00
gen_program_test	all: Reformat with gofumpt	2023-03-03 09:00:24 -08:00
go	[go] Allow output-versioned invokes to resolve and maintain secrets (#17132 )	2024-09-09 12:57:43 +00:00
hcl2	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00
nodejs	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00
pcl	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00
python	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00
report	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00
schema	Have `Host.Provider` accept a `PackageDescriptor` (#17244 )	2024-09-12 13:17:30 +00:00
testing	upgrade pulumi-dotnet to 3.67.0 (#17223 )	2024-09-10 23:47:01 +00:00
README.md	Document code generation concepts (#17162 )	2024-09-05 13:12:59 +00:00
docs.go	Support "lifting" single-valued method returns to their return type (#8111 )	2021-10-01 11:33:02 -07:00
docs_test.go	ci: radical idea - what if slow tests & no stdout makes GH consider runner dead?	2022-03-06 14:52:13 -08:00
programs.md	Document code generation concepts (#17162 )	2024-09-05 13:12:59 +00:00
sdks.md	Document code generation concepts (#17162 )	2024-09-05 13:12:59 +00:00
utilities.go	Use slice.Prealloc instead of make([]T, 0, ...)	2023-06-29 11:27:50 +01:00
utilities_test.go	ci: radical idea - what if slow tests & no stdout makes GH consider runner dead?	2022-03-06 14:52:13 -08:00
utilities_types.go	Enable goheader rule and add missing license headers (#15473 )	2024-09-09 12:05:45 +00:00

README.md

(codegen)= (crosscode)=

Code generation

Code generation is essential to Pulumi's ability to support both a variety of programming languages and a variety of cloud providers. This package defines the core components of Pulumi's code generation functionality (known as Pulumi CrossCode). At a high level, code generation is used to manage three categories of output: SDKs, programs, and documentation. At a lower level, these all make use of a number of shared concepts such as schema and Pulumi Configuration Language (PCL).

:::{toctree} :maxdepth: 1 :titlesonly:

/pkg/codegen/sdks.md /pkg/codegen/programs.md /pkg/codegen/docs/README /pkg/codegen/schema/README /pkg/codegen/pcl/README :::