2022-04-19 16:39:23 +00:00
|
|
|
// Code generated by test DO NOT EDIT.
|
|
|
|
// *** WARNING: Do not edit by hand unless you're certain you know what you are doing! ***
|
2021-01-19 23:59:51 +00:00
|
|
|
|
2023-06-14 16:34:49 +00:00
|
|
|
package internal
|
2021-01-19 23:59:51 +00:00
|
|
|
|
|
|
|
import (
|
|
|
|
"fmt"
|
|
|
|
"os"
|
|
|
|
"reflect"
|
|
|
|
"regexp"
|
|
|
|
"strconv"
|
|
|
|
"strings"
|
|
|
|
|
|
|
|
"github.com/blang/semver"
|
2021-03-17 13:20:05 +00:00
|
|
|
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
|
2021-01-19 23:59:51 +00:00
|
|
|
)
|
|
|
|
|
Support returning plain values from methods (#13592)
Support returning plain values from methods.
Implements Node, Python and Go support.
Remaining:
- [x] test receiving unknowns
- [x] acceptance tests written and passing locally for Node, Python, Go
clients against a Go server
- [x] acceptance tests passing in CI
- [x] tickets filed for remaining languages
- [x] https://github.com/pulumi/pulumi-yaml/issues/499
- [x] https://github.com/pulumi/pulumi-java/issues/1193
- [x] https://github.com/pulumi/pulumi-dotnet/issues/170
Known limitations:
- this is technically a breaking change in case there is code out there
that already uses methods that return Plain: true
- struct-wrapping limitation: the provider for the component resource
needs to still wrap the plain-returning Method response with a 1-arg
struct; by convention the field is named "res", and this is how it
travels through the plumbing
- resources cannot return plain values yet
- the provider for the component resource cannot have unknown
configuration, if it does, the methods will not be called
- Per Luke https://github.com/pulumi/pulumi/issues/11520 this might not
be supported/realizable yet
<!---
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 https://github.com/pulumi/pulumi/issues/12709
## 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. -->
2023-11-18 06:02:06 +00:00
|
|
|
import (
|
|
|
|
"github.com/pulumi/pulumi/sdk/v3/go/pulumi/internals"
|
|
|
|
)
|
|
|
|
|
2021-01-19 23:59:51 +00:00
|
|
|
type envParser func(v string) interface{}
|
|
|
|
|
2023-06-14 16:34:49 +00:00
|
|
|
func ParseEnvBool(v string) interface{} {
|
2021-01-19 23:59:51 +00:00
|
|
|
b, err := strconv.ParseBool(v)
|
|
|
|
if err != nil {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
return b
|
|
|
|
}
|
|
|
|
|
2023-06-14 16:34:49 +00:00
|
|
|
func ParseEnvInt(v string) interface{} {
|
2021-01-19 23:59:51 +00:00
|
|
|
i, err := strconv.ParseInt(v, 0, 0)
|
|
|
|
if err != nil {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
return int(i)
|
|
|
|
}
|
|
|
|
|
2023-06-14 16:34:49 +00:00
|
|
|
func ParseEnvFloat(v string) interface{} {
|
2021-01-19 23:59:51 +00:00
|
|
|
f, err := strconv.ParseFloat(v, 64)
|
|
|
|
if err != nil {
|
|
|
|
return nil
|
|
|
|
}
|
|
|
|
return f
|
|
|
|
}
|
|
|
|
|
2023-06-14 16:34:49 +00:00
|
|
|
func ParseEnvStringArray(v string) interface{} {
|
2021-01-19 23:59:51 +00:00
|
|
|
var result pulumi.StringArray
|
|
|
|
for _, item := range strings.Split(v, ";") {
|
|
|
|
result = append(result, pulumi.String(item))
|
|
|
|
}
|
|
|
|
return result
|
|
|
|
}
|
|
|
|
|
2023-06-14 16:34:49 +00:00
|
|
|
func GetEnvOrDefault(def interface{}, parser envParser, vars ...string) interface{} {
|
2021-01-19 23:59:51 +00:00
|
|
|
for _, v := range vars {
|
2023-05-18 21:48:37 +00:00
|
|
|
if value, ok := os.LookupEnv(v); ok {
|
2021-01-19 23:59:51 +00:00
|
|
|
if parser != nil {
|
|
|
|
return parser(value)
|
|
|
|
}
|
|
|
|
return value
|
|
|
|
}
|
|
|
|
}
|
|
|
|
return def
|
|
|
|
}
|
|
|
|
|
|
|
|
// PkgVersion uses reflection to determine the version of the current package.
|
2022-03-02 19:57:33 +00:00
|
|
|
// If a version cannot be determined, v1 will be assumed. The second return
|
|
|
|
// value is always nil.
|
2021-01-19 23:59:51 +00:00
|
|
|
func PkgVersion() (semver.Version, error) {
|
2023-06-14 16:34:49 +00:00
|
|
|
// emptyVersion defaults to v0.0.0
|
|
|
|
if !SdkVersion.Equals(semver.Version{}) {
|
|
|
|
return SdkVersion, nil
|
|
|
|
}
|
2021-01-19 23:59:51 +00:00
|
|
|
type sentinal struct{}
|
|
|
|
pkgPath := reflect.TypeOf(sentinal{}).PkgPath()
|
|
|
|
re := regexp.MustCompile("^.*/pulumi-example/sdk(/v\\d+)?")
|
|
|
|
if match := re.FindStringSubmatch(pkgPath); match != nil {
|
|
|
|
vStr := match[1]
|
|
|
|
if len(vStr) == 0 { // If the version capture group was empty, default to v1.
|
|
|
|
return semver.Version{Major: 1}, nil
|
|
|
|
}
|
|
|
|
return semver.MustParse(fmt.Sprintf("%s.0.0", vStr[2:])), nil
|
|
|
|
}
|
2022-03-02 19:57:33 +00:00
|
|
|
return semver.Version{Major: 1}, nil
|
2021-01-19 23:59:51 +00:00
|
|
|
}
|
2021-11-23 23:10:15 +00:00
|
|
|
|
|
|
|
// isZero is a null safe check for if a value is it's types zero value.
|
2023-06-14 16:34:49 +00:00
|
|
|
func IsZero(v interface{}) bool {
|
2021-11-23 23:10:15 +00:00
|
|
|
if v == nil {
|
|
|
|
return true
|
|
|
|
}
|
|
|
|
return reflect.ValueOf(v).IsZero()
|
|
|
|
}
|
2022-01-11 01:38:54 +00:00
|
|
|
|
Support returning plain values from methods (#13592)
Support returning plain values from methods.
Implements Node, Python and Go support.
Remaining:
- [x] test receiving unknowns
- [x] acceptance tests written and passing locally for Node, Python, Go
clients against a Go server
- [x] acceptance tests passing in CI
- [x] tickets filed for remaining languages
- [x] https://github.com/pulumi/pulumi-yaml/issues/499
- [x] https://github.com/pulumi/pulumi-java/issues/1193
- [x] https://github.com/pulumi/pulumi-dotnet/issues/170
Known limitations:
- this is technically a breaking change in case there is code out there
that already uses methods that return Plain: true
- struct-wrapping limitation: the provider for the component resource
needs to still wrap the plain-returning Method response with a 1-arg
struct; by convention the field is named "res", and this is how it
travels through the plumbing
- resources cannot return plain values yet
- the provider for the component resource cannot have unknown
configuration, if it does, the methods will not be called
- Per Luke https://github.com/pulumi/pulumi/issues/11520 this might not
be supported/realizable yet
<!---
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 https://github.com/pulumi/pulumi/issues/12709
## 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. -->
2023-11-18 06:02:06 +00:00
|
|
|
func CallPlain(
|
|
|
|
ctx *pulumi.Context,
|
|
|
|
tok string,
|
|
|
|
args pulumi.Input,
|
|
|
|
output pulumi.Output,
|
|
|
|
self pulumi.Resource,
|
|
|
|
property string,
|
|
|
|
resultPtr reflect.Value,
|
|
|
|
errorPtr *error,
|
|
|
|
opts ...pulumi.InvokeOption,
|
|
|
|
) {
|
|
|
|
res, err := callPlainInner(ctx, tok, args, output, self, opts...)
|
|
|
|
if err != nil {
|
|
|
|
*errorPtr = err
|
|
|
|
return
|
|
|
|
}
|
|
|
|
|
|
|
|
v := reflect.ValueOf(res)
|
|
|
|
|
|
|
|
// extract res.property field if asked to do so
|
|
|
|
if property != "" {
|
|
|
|
v = v.FieldByName("Res")
|
|
|
|
}
|
|
|
|
|
|
|
|
// return by setting the result pointer; this style of returns shortens the generated code without generics
|
|
|
|
resultPtr.Elem().Set(v)
|
|
|
|
}
|
|
|
|
|
|
|
|
func callPlainInner(
|
|
|
|
ctx *pulumi.Context,
|
|
|
|
tok string,
|
|
|
|
args pulumi.Input,
|
|
|
|
output pulumi.Output,
|
|
|
|
self pulumi.Resource,
|
|
|
|
opts ...pulumi.InvokeOption,
|
|
|
|
) (any, error) {
|
|
|
|
o, err := ctx.Call(tok, args, output, self, opts...)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
outputData, err := internals.UnsafeAwaitOutput(ctx.Context(), o)
|
|
|
|
if err != nil {
|
|
|
|
return nil, err
|
|
|
|
}
|
|
|
|
|
|
|
|
// Ingoring deps silently. They are typically non-empty, r.f() calls include r as a dependency.
|
|
|
|
known := outputData.Known
|
|
|
|
value := outputData.Value
|
|
|
|
secret := outputData.Secret
|
|
|
|
|
|
|
|
problem := ""
|
|
|
|
if !known {
|
|
|
|
problem = "an unknown value"
|
|
|
|
} else if secret {
|
|
|
|
problem = "a secret value"
|
|
|
|
}
|
|
|
|
|
|
|
|
if problem != "" {
|
|
|
|
return nil, fmt.Errorf("Plain resource method %q incorrectly returned %s. "+
|
|
|
|
"This is an error in the provider, please report this to the provider developer.",
|
|
|
|
tok, problem)
|
|
|
|
}
|
|
|
|
|
|
|
|
return value, nil
|
|
|
|
}
|
|
|
|
|
2023-06-14 16:34:49 +00:00
|
|
|
// PkgResourceDefaultOpts provides package level defaults to pulumi.OptionResource.
|
|
|
|
func PkgResourceDefaultOpts(opts []pulumi.ResourceOption) []pulumi.ResourceOption {
|
|
|
|
defaults := []pulumi.ResourceOption{}
|
|
|
|
defaults = append(defaults, pulumi.PluginDownloadURL("example.com/download"))
|
|
|
|
version := semver.MustParse("1.2.3")
|
|
|
|
if !version.Equals(semver.Version{}) {
|
|
|
|
defaults = append(defaults, pulumi.Version(version.String()))
|
|
|
|
}
|
2022-01-11 01:38:54 +00:00
|
|
|
return append(defaults, opts...)
|
|
|
|
}
|
|
|
|
|
2023-06-14 16:34:49 +00:00
|
|
|
// PkgInvokeDefaultOpts provides package level defaults to pulumi.OptionInvoke.
|
|
|
|
func PkgInvokeDefaultOpts(opts []pulumi.InvokeOption) []pulumi.InvokeOption {
|
|
|
|
defaults := []pulumi.InvokeOption{}
|
|
|
|
defaults = append(defaults, pulumi.PluginDownloadURL("example.com/download"))
|
|
|
|
version := semver.MustParse("1.2.3")
|
|
|
|
if !version.Equals(semver.Version{}) {
|
|
|
|
defaults = append(defaults, pulumi.Version(version.String()))
|
|
|
|
}
|
2022-01-11 01:38:54 +00:00
|
|
|
return append(defaults, opts...)
|
|
|
|
}
|