pulumi/pkg/codegen/schema
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
..
README.md Document code generation concepts (#17162) 2024-09-05 13:12:59 +00:00
bind.go Prepare golangci-lint upgrade (#17065) 2024-08-28 07:57:38 +00:00
docs_parser.go Enable goheader rule and add missing license headers (#15473) 2024-09-09 12:05:45 +00:00
docs_renderer.go Enable goheader rule and add missing license headers (#15473) 2024-09-09 12:05:45 +00:00
docs_test.go Enable goheader rule and add missing license headers (#15473) 2024-09-09 12:05:45 +00:00
loader.go Have `Host.Provider` accept a `PackageDescriptor` (#17244) 2024-09-12 13:17:30 +00:00
loader_cached.go Split caching logic into it's own type to use with LoaderClient (#17118) 2024-08-31 13:25:20 +00:00
loader_cached_test.go Split caching logic into it's own type to use with LoaderClient (#17118) 2024-08-31 13:25:20 +00:00
loader_client.go Support loading parameterized schemas in the schema loader (#17108) 2024-08-30 14:25:29 +00:00
loader_js.go [display] Enable WASM compilation (#16246) 2024-05-24 20:27:56 +00:00
loader_mmap.go [display] Enable WASM compilation (#16246) 2024-05-24 20:27:56 +00:00
loader_schema_test.go Enable goheader rule and add missing license headers (#15473) 2024-09-09 12:05:45 +00:00
loader_server.go Add schema loader service 2023-07-27 15:03:52 +01:00
loader_test.go Have `Host.Provider` accept a `PackageDescriptor` (#17244) 2024-09-12 13:17:30 +00:00
mock_pulumi_schema.go Enable goheader rule and add missing license headers (#15473) 2024-09-09 12:05:45 +00:00
package_reference.go Enable goheader rule and add missing license headers (#15473) 2024-09-09 12:05:45 +00:00
pulumi.json Change parameterization in schemas to base64 strings (#16614) 2024-07-10 15:36:05 +00:00
schema.go Prepare golangci-lint upgrade (#17065) 2024-08-28 07:57:38 +00:00
schema_test.go Ensure internal provider state doesn't clash with user config (#16837) 2024-07-30 12:22:32 +00:00

README.md

(schema)=

Pulumi Schema

This package defines Pulumi Schema, a language-neutral specification for cloud resource models. Pulumi Schema is the interface definition language for all Pulumi Packages, and is used as the input to SDK code generation for each supported Pulumi language.