pulumi 3.216.0a1768477141__py3-none-any.whl → 3.217.0__py3-none-any.whl

pulumi/__init__.py

@@ -60,6 +60,7 @@ from .metadata import (
     get_project,
     get_stack,
     get_root_directory,
+    require_pulumi_version,
 )
 
 from .resource import (
@@ -161,6 +162,7 @@ __all__ = [
     "get_project",
     "get_stack",
     "get_root_directory",
+    "require_pulumi_version",
     # resource
     "Alias",
     "Resource",

pulumi/_version.py

@@ -14,7 +14,7 @@
 
 from semver import VersionInfo
 
-_VERSION = "3.216.0"
+_VERSION = "3.217.0"
 
 version = VersionInfo.parse(_VERSION)
 """Version is the Pulumi SDK's release version."""

pulumi/automation/_server.py

@@ -35,6 +35,12 @@ class LanguageServer(LanguageRuntimeServicer):
     def __init__(self, program: PulumiFn) -> None:
         self.program = program
 
+    def About(self, request, context):
+        return language_pb2.AboutResponse(
+            executable=sys.executable,
+            version=f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}",
+        )
+
     def GetRequiredPlugins(self, request, context):
         return language_pb2.GetRequiredPluginsResponse()
 

pulumi/metadata.py

@@ -1,4 +1,4 @@
-# Copyright 2016-2018, Pulumi Corporation.
+# Copyright 2016-2026, Pulumi Corporation.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -41,3 +41,17 @@ def get_root_directory() -> str:
     Returns the current root directory.
     """
     return settings.get_root_directory()
+
+
+def require_pulumi_version(rg: str) -> None:
+    """
+    Checks if the engine we are connected to is compatible with the passed in version range. If the version is not
+    compatible with the specified range, an exception is raised.
+
+    :param str rg: The range to check. The supported syntax for the range is that of
+           https://pkg.go.dev/github.com/blang/semver#ParseRange. For example ">=3.0.0", or "!3.1.2". Ranges can be
+           AND-ed together by concatenating with spaces ">=3.5.0 !3.7.7", meaning greater-or-equal to 3.5.0 and not
+           exactly 3.7.7. Ranges can be OR-ed with the `||` operator: "<3.4.0 || >3.8.0", meaning less-than 3.4.0 or
+           greater-than 3.8.0.
+    """
+    settings.require_pulumi_version(rg)

pulumi/provider/server.py

@@ -17,7 +17,8 @@ instance as a gRPC server so that it can be used as a Pulumi plugin.
 
 """
 
-from typing import Optional, TypeVar, Any, cast
+from typing import Optional, TypeVar, Any, cast, Union
+import types
 import argparse
 import asyncio
 import sys
@@ -41,6 +42,7 @@ from pulumi.runtime.proto import (
     ResourceProviderServicer,
     status_pb2,
     errors_pb2,
+    alias_pb2,
 )
 from pulumi.runtime.resource_hooks import _binding_from_proto
 from pulumi.runtime.stack import wait_for_rpcs
@@ -237,6 +239,38 @@ class ProviderServicer(ResourceProviderServicer):
             is_secret=_as_future(is_secret),
         )
 
+    @staticmethod
+    def _alias_from_proto(alias: alias_pb2.Alias) -> Union[str | pulumi.Alias]:
+        if alias.urn:
+            return alias.urn
+        else:
+            spec = alias.spec
+            name: Union[str, types.EllipsisType] = ...
+            resource_type: Union[str, types.EllipsisType] = ...
+            parent_urn: Union[str, types.EllipsisType] = ...
+            stack: Union[str, types.EllipsisType] = ...
+            project: Union[str, types.EllipsisType] = ...
+
+            if spec.name:
+                name = spec.name
+            if spec.type:
+                resource_type = spec.type
+            if spec.parentUrn:
+                parent_urn = spec.parentUrn
+            if spec.stack:
+                stack = spec.stack
+            if spec.project:
+                project = spec.project
+            no_parent = spec.noParent
+
+            return pulumi.Alias(
+                name=name,  # type: ignore
+                type_=resource_type,  # type: ignore
+                parent=None if no_parent else parent_urn,  # type: ignore
+                stack=stack,  # type: ignore
+                project=project,  # type: ignore
+            )
+
     @staticmethod
     def _construct_options(request: proto.ConstructRequest) -> pulumi.ResourceOptions:
         parent = None
@@ -264,7 +298,7 @@ class ProviderServicer(ResourceProviderServicer):
         resource_hooks = _binding_from_proto(request.resource_hooks)
 
         return pulumi.ResourceOptions(
-            aliases=list(request.aliases),
+            aliases=[ProviderServicer._alias_from_proto(a) for a in request.aliases],
             depends_on=[DependencyResource(urn) for urn in request.dependencies],
             protect=request.protect,
             providers={

pulumi/runtime/__init__.py

@@ -1,4 +1,4 @@
-# Copyright 2016-2018, Pulumi Corporation.
+# Copyright 2016-2026, Pulumi Corporation.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -41,6 +41,7 @@ from .settings import (
     reset_options,
     get_root_resource,
     get_root_directory,
+    require_pulumi_version,
 )
 
 from .stack import (
@@ -94,6 +95,7 @@ __all__ = [
     "reset_options",
     "get_root_resource",
     "get_root_directory",
+    "require_pulumi_version",
     # stack
     "run_in_stack",
     "register_stack_transformation",

pulumi/runtime/proto/engine_pb2.py

@@ -15,7 +15,7 @@ from google.protobuf import empty_pb2 as google_dot_protobuf_dot_empty__pb2
 from google.protobuf import struct_pb2 as google_dot_protobuf_dot_struct__pb2
 
 
-DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x13pulumi/engine.proto\x12\tpulumirpc\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1cgoogle/protobuf/struct.proto\"y\n\nLogRequest\x12(\n\x08severity\x18\x01 \x01(\x0e\x32\x16.pulumirpc.LogSeverity\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x0b\n\x03urn\x18\x03 \x01(\t\x12\x10\n\x08streamId\x18\x04 \x01(\x05\x12\x11\n\tephemeral\x18\x05 \x01(\x08\"\x18\n\x16GetRootResourceRequest\"&\n\x17GetRootResourceResponse\x12\x0b\n\x03urn\x18\x01 \x01(\t\"%\n\x16SetRootResourceRequest\x12\x0b\n\x03urn\x18\x01 \x01(\t\"\x19\n\x17SetRootResourceResponse\"Q\n\x15StartDebuggingRequest\x12\'\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x0f\n\x07message\x18\x02 \x01(\t\"9\n\x19\x43heckPulumiVersionRequest\x12\x1c\n\x14pulumi_version_range\x18\x01 \x01(\t\"\x1c\n\x1a\x43heckPulumiVersionResponse*:\n\x0bLogSeverity\x12\t\n\x05\x44\x45\x42UG\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03\x32\xab\x03\n\x06\x45ngine\x12\x36\n\x03Log\x12\x15.pulumirpc.LogRequest\x1a\x16.google.protobuf.Empty\"\x00\x12Z\n\x0fGetRootResource\x12!.pulumirpc.GetRootResourceRequest\x1a\".pulumirpc.GetRootResourceResponse\"\x00\x12Z\n\x0fSetRootResource\x12!.pulumirpc.SetRootResourceRequest\x1a\".pulumirpc.SetRootResourceResponse\"\x00\x12L\n\x0eStartDebugging\x12 .pulumirpc.StartDebuggingRequest\x1a\x16.google.protobuf.Empty\"\x00\x12\x63\n\x12\x43heckPulumiVersion\x12$.pulumirpc.CheckPulumiVersionRequest\x1a%.pulumirpc.CheckPulumiVersionResponse\"\x00\x42\x34Z2github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpcb\x06proto3')
+DESCRIPTOR = _descriptor_pool.Default().AddSerializedFile(b'\n\x13pulumi/engine.proto\x12\tpulumirpc\x1a\x1bgoogle/protobuf/empty.proto\x1a\x1cgoogle/protobuf/struct.proto\"y\n\nLogRequest\x12(\n\x08severity\x18\x01 \x01(\x0e\x32\x16.pulumirpc.LogSeverity\x12\x0f\n\x07message\x18\x02 \x01(\t\x12\x0b\n\x03urn\x18\x03 \x01(\t\x12\x10\n\x08streamId\x18\x04 \x01(\x05\x12\x11\n\tephemeral\x18\x05 \x01(\x08\"\x18\n\x16GetRootResourceRequest\"&\n\x17GetRootResourceResponse\x12\x0b\n\x03urn\x18\x01 \x01(\t\"%\n\x16SetRootResourceRequest\x12\x0b\n\x03urn\x18\x01 \x01(\t\"\x19\n\x17SetRootResourceResponse\"Q\n\x15StartDebuggingRequest\x12\'\n\x06\x63onfig\x18\x01 \x01(\x0b\x32\x17.google.protobuf.Struct\x12\x0f\n\x07message\x18\x02 \x01(\t\";\n\x1bRequirePulumiVersionRequest\x12\x1c\n\x14pulumi_version_range\x18\x01 \x01(\t\"\x1e\n\x1cRequirePulumiVersionResponse*:\n\x0bLogSeverity\x12\t\n\x05\x44\x45\x42UG\x10\x00\x12\x08\n\x04INFO\x10\x01\x12\x0b\n\x07WARNING\x10\x02\x12\t\n\x05\x45RROR\x10\x03\x32\xb1\x03\n\x06\x45ngine\x12\x36\n\x03Log\x12\x15.pulumirpc.LogRequest\x1a\x16.google.protobuf.Empty\"\x00\x12Z\n\x0fGetRootResource\x12!.pulumirpc.GetRootResourceRequest\x1a\".pulumirpc.GetRootResourceResponse\"\x00\x12Z\n\x0fSetRootResource\x12!.pulumirpc.SetRootResourceRequest\x1a\".pulumirpc.SetRootResourceResponse\"\x00\x12L\n\x0eStartDebugging\x12 .pulumirpc.StartDebuggingRequest\x1a\x16.google.protobuf.Empty\"\x00\x12i\n\x14RequirePulumiVersion\x12&.pulumirpc.RequirePulumiVersionRequest\x1a\'.pulumirpc.RequirePulumiVersionResponse\"\x00\x42\x34Z2github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpcb\x06proto3')
 
 _builder.BuildMessageAndEnumDescriptors(DESCRIPTOR, globals())
 _builder.BuildTopDescriptorsAndMessages(DESCRIPTOR, 'pulumi.engine_pb2', globals())
@@ -23,8 +23,8 @@ if _descriptor._USE_C_DESCRIPTORS == False:
 
   DESCRIPTOR._options = None
   DESCRIPTOR._serialized_options = b'Z2github.com/pulumi/pulumi/sdk/v3/proto/go;pulumirpc'
-  _LOGSEVERITY._serialized_start=520
-  _LOGSEVERITY._serialized_end=578
+  _LOGSEVERITY._serialized_start=524
+  _LOGSEVERITY._serialized_end=582
   _LOGREQUEST._serialized_start=93
   _LOGREQUEST._serialized_end=214
   _GETROOTRESOURCEREQUEST._serialized_start=216
@@ -37,10 +37,10 @@ if _descriptor._USE_C_DESCRIPTORS == False:
   _SETROOTRESOURCERESPONSE._serialized_end=346
   _STARTDEBUGGINGREQUEST._serialized_start=348
   _STARTDEBUGGINGREQUEST._serialized_end=429
-  _CHECKPULUMIVERSIONREQUEST._serialized_start=431
-  _CHECKPULUMIVERSIONREQUEST._serialized_end=488
-  _CHECKPULUMIVERSIONRESPONSE._serialized_start=490
-  _CHECKPULUMIVERSIONRESPONSE._serialized_end=518
-  _ENGINE._serialized_start=581
-  _ENGINE._serialized_end=1008
+  _REQUIREPULUMIVERSIONREQUEST._serialized_start=431
+  _REQUIREPULUMIVERSIONREQUEST._serialized_end=490
+  _REQUIREPULUMIVERSIONRESPONSE._serialized_start=492
+  _REQUIREPULUMIVERSIONRESPONSE._serialized_end=522
+  _ENGINE._serialized_start=585
+  _ENGINE._serialized_end=1018
 # @@protoc_insertion_point(module_scope)

pulumi/runtime/proto/engine_pb2.pyi

@@ -178,7 +178,7 @@ class StartDebuggingRequest(google.protobuf.message.Message):
 global___StartDebuggingRequest = StartDebuggingRequest
 
 @typing.final
-class CheckPulumiVersionRequest(google.protobuf.message.Message):
+class RequirePulumiVersionRequest(google.protobuf.message.Message):
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
 
     PULUMI_VERSION_RANGE_FIELD_NUMBER: builtins.int
@@ -196,10 +196,10 @@ class CheckPulumiVersionRequest(google.protobuf.message.Message):
     ) -> None: ...
     def ClearField(self, field_name: typing.Literal["pulumi_version_range", b"pulumi_version_range"]) -> None: ...
 
-global___CheckPulumiVersionRequest = CheckPulumiVersionRequest
+global___RequirePulumiVersionRequest = RequirePulumiVersionRequest
 
 @typing.final
-class CheckPulumiVersionResponse(google.protobuf.message.Message):
+class RequirePulumiVersionResponse(google.protobuf.message.Message):
     """empty"""
 
     DESCRIPTOR: google.protobuf.descriptor.Descriptor
@@ -208,4 +208,4 @@ class CheckPulumiVersionResponse(google.protobuf.message.Message):
         self,
     ) -> None: ...
 
-global___CheckPulumiVersionResponse = CheckPulumiVersionResponse
+global___RequirePulumiVersionResponse = RequirePulumiVersionResponse

pulumi/runtime/proto/engine_pb2_grpc.py

@@ -38,10 +38,10 @@ class EngineStub(object):
                 request_serializer=pulumi_dot_engine__pb2.StartDebuggingRequest.SerializeToString,
                 response_deserializer=google_dot_protobuf_dot_empty__pb2.Empty.FromString,
                 )
-        self.CheckPulumiVersion = channel.unary_unary(
-                '/pulumirpc.Engine/CheckPulumiVersion',
-                request_serializer=pulumi_dot_engine__pb2.CheckPulumiVersionRequest.SerializeToString,
-                response_deserializer=pulumi_dot_engine__pb2.CheckPulumiVersionResponse.FromString,
+        self.RequirePulumiVersion = channel.unary_unary(
+                '/pulumirpc.Engine/RequirePulumiVersion',
+                request_serializer=pulumi_dot_engine__pb2.RequirePulumiVersionRequest.SerializeToString,
+                response_deserializer=pulumi_dot_engine__pb2.RequirePulumiVersionResponse.FromString,
                 )
 
 
@@ -81,8 +81,8 @@ class EngineServicer(object):
         context.set_details('Method not implemented!')
         raise NotImplementedError('Method not implemented!')
 
-    def CheckPulumiVersion(self, request, context):
-        """CheckPulumiVersion checks that the version of the engine satisfies the passed in range.
+    def RequirePulumiVersion(self, request, context):
+        """RequirePulumiVersion checks that the version of the engine satisfies the passed in range.
         """
         context.set_code(grpc.StatusCode.UNIMPLEMENTED)
         context.set_details('Method not implemented!')
@@ -111,10 +111,10 @@ def add_EngineServicer_to_server(servicer, server):
                     request_deserializer=pulumi_dot_engine__pb2.StartDebuggingRequest.FromString,
                     response_serializer=google_dot_protobuf_dot_empty__pb2.Empty.SerializeToString,
             ),
-            'CheckPulumiVersion': grpc.unary_unary_rpc_method_handler(
-                    servicer.CheckPulumiVersion,
-                    request_deserializer=pulumi_dot_engine__pb2.CheckPulumiVersionRequest.FromString,
-                    response_serializer=pulumi_dot_engine__pb2.CheckPulumiVersionResponse.SerializeToString,
+            'RequirePulumiVersion': grpc.unary_unary_rpc_method_handler(
+                    servicer.RequirePulumiVersion,
+                    request_deserializer=pulumi_dot_engine__pb2.RequirePulumiVersionRequest.FromString,
+                    response_serializer=pulumi_dot_engine__pb2.RequirePulumiVersionResponse.SerializeToString,
             ),
     }
     generic_handler = grpc.method_handlers_generic_handler(
@@ -198,7 +198,7 @@ class Engine(object):
             insecure, call_credentials, compression, wait_for_ready, timeout, metadata)
 
     @staticmethod
-    def CheckPulumiVersion(request,
+    def RequirePulumiVersion(request,
             target,
             options=(),
             channel_credentials=None,
@@ -208,8 +208,8 @@ class Engine(object):
             wait_for_ready=None,
             timeout=None,
             metadata=None):
-        return grpc.experimental.unary_unary(request, target, '/pulumirpc.Engine/CheckPulumiVersion',
-            pulumi_dot_engine__pb2.CheckPulumiVersionRequest.SerializeToString,
-            pulumi_dot_engine__pb2.CheckPulumiVersionResponse.FromString,
+        return grpc.experimental.unary_unary(request, target, '/pulumirpc.Engine/RequirePulumiVersion',
+            pulumi_dot_engine__pb2.RequirePulumiVersionRequest.SerializeToString,
+            pulumi_dot_engine__pb2.RequirePulumiVersionResponse.FromString,
             options, channel_credentials,
             insecure, call_credentials, compression, wait_for_ready, timeout, metadata)

pulumi/runtime/proto/engine_pb2_grpc.pyi

@@ -68,11 +68,11 @@ class EngineStub:
     should notify the user of how to connect to the debugger.
     """
 
-    CheckPulumiVersion: grpc.UnaryUnaryMultiCallable[
-        pulumi.engine_pb2.CheckPulumiVersionRequest,
-        pulumi.engine_pb2.CheckPulumiVersionResponse,
+    RequirePulumiVersion: grpc.UnaryUnaryMultiCallable[
+        pulumi.engine_pb2.RequirePulumiVersionRequest,
+        pulumi.engine_pb2.RequirePulumiVersionResponse,
     ]
-    """CheckPulumiVersion checks that the version of the engine satisfies the passed in range."""
+    """RequirePulumiVersion checks that the version of the engine satisfies the passed in range."""
 
 class EngineAsyncStub:
     """Engine is an auxiliary service offered to language and resource provider plugins. Its main purpose today is
@@ -108,11 +108,11 @@ class EngineAsyncStub:
     should notify the user of how to connect to the debugger.
     """
 
-    CheckPulumiVersion: grpc.aio.UnaryUnaryMultiCallable[
-        pulumi.engine_pb2.CheckPulumiVersionRequest,
-        pulumi.engine_pb2.CheckPulumiVersionResponse,
+    RequirePulumiVersion: grpc.aio.UnaryUnaryMultiCallable[
+        pulumi.engine_pb2.RequirePulumiVersionRequest,
+        pulumi.engine_pb2.RequirePulumiVersionResponse,
     ]
-    """CheckPulumiVersion checks that the version of the engine satisfies the passed in range."""
+    """RequirePulumiVersion checks that the version of the engine satisfies the passed in range."""
 
 class EngineServicer(metaclass=abc.ABCMeta):
     """Engine is an auxiliary service offered to language and resource provider plugins. Its main purpose today is
@@ -157,11 +157,11 @@ class EngineServicer(metaclass=abc.ABCMeta):
         """
 
     
-    def CheckPulumiVersion(
+    def RequirePulumiVersion(
         self,
-        request: pulumi.engine_pb2.CheckPulumiVersionRequest,
+        request: pulumi.engine_pb2.RequirePulumiVersionRequest,
         context: _ServicerContext,
-    ) -> typing.Union[pulumi.engine_pb2.CheckPulumiVersionResponse, collections.abc.Awaitable[pulumi.engine_pb2.CheckPulumiVersionResponse]]:
-        """CheckPulumiVersion checks that the version of the engine satisfies the passed in range."""
+    ) -> typing.Union[pulumi.engine_pb2.RequirePulumiVersionResponse, collections.abc.Awaitable[pulumi.engine_pb2.RequirePulumiVersionResponse]]:
+        """RequirePulumiVersion checks that the version of the engine satisfies the passed in range."""
 
 def add_EngineServicer_to_server(servicer: EngineServicer, server: typing.Union[grpc.Server, grpc.aio.Server]) -> None: ...

pulumi/runtime/proto/language_pb2.pyi

@@ -1255,7 +1255,7 @@ class LinkRequest(google.protobuf.message.Message):
     @property
     def packages(self) -> google.protobuf.internal.containers.RepeatedCompositeFieldContainer[global___LinkRequest.LinkDependency]:
         """Local dependencies that should be linked into the program or plugin's language specific project files.
-        Each dependency has a path to a a language specific artifact. This can be a binary artifact like a
+        Each dependency has a path to a language specific artifact. This can be a binary artifact like a
         Python wheel or a tar.gz for Node.js, or a source directory.
         """
 

pulumi/runtime/proto/language_pb2_grpc.py

@@ -210,7 +210,7 @@ class LanguageRuntimeServicer(object):
 
     def RunPlugin(self, request, context):
         """`RunPlugin` is used to execute a program written in this host's language that implements a Pulumi
-        [plugin](plugins). It it is plugins what [](pulumirpc.LanguageRuntime.Run) is to programs. Since a plugin is not
+        [plugin](plugins). It is to plugins what [](pulumirpc.LanguageRuntime.Run) is to programs. Since a plugin is not
         expected to terminate until instructed/for a long time, this method returns a stream of
         [](pulumirpc.RunPluginResponse) messages containing information about standard error and output, as well as the
         exit code of the plugin when it does terminate.

pulumi/runtime/proto/language_pb2_grpc.pyi

@@ -139,7 +139,7 @@ class LanguageRuntimeStub:
         pulumi.language_pb2.RunPluginResponse,
     ]
     """`RunPlugin` is used to execute a program written in this host's language that implements a Pulumi
-    [plugin](plugins). It it is plugins what [](pulumirpc.LanguageRuntime.Run) is to programs. Since a plugin is not
+    [plugin](plugins). It is to plugins what [](pulumirpc.LanguageRuntime.Run) is to programs. Since a plugin is not
     expected to terminate until instructed/for a long time, this method returns a stream of
     [](pulumirpc.RunPluginResponse) messages containing information about standard error and output, as well as the
     exit code of the plugin when it does terminate.
@@ -309,7 +309,7 @@ class LanguageRuntimeAsyncStub:
         pulumi.language_pb2.RunPluginResponse,
     ]
     """`RunPlugin` is used to execute a program written in this host's language that implements a Pulumi
-    [plugin](plugins). It it is plugins what [](pulumirpc.LanguageRuntime.Run) is to programs. Since a plugin is not
+    [plugin](plugins). It is to plugins what [](pulumirpc.LanguageRuntime.Run) is to programs. Since a plugin is not
     expected to terminate until instructed/for a long time, this method returns a stream of
     [](pulumirpc.RunPluginResponse) messages containing information about standard error and output, as well as the
     exit code of the plugin when it does terminate.
@@ -501,7 +501,7 @@ class LanguageRuntimeServicer(metaclass=abc.ABCMeta):
         context: _ServicerContext,
     ) -> typing.Union[collections.abc.Iterator[pulumi.language_pb2.RunPluginResponse], collections.abc.AsyncIterator[pulumi.language_pb2.RunPluginResponse]]:
         """`RunPlugin` is used to execute a program written in this host's language that implements a Pulumi
-        [plugin](plugins). It it is plugins what [](pulumirpc.LanguageRuntime.Run) is to programs. Since a plugin is not
+        [plugin](plugins). It is to plugins what [](pulumirpc.LanguageRuntime.Run) is to programs. Since a plugin is not
         expected to terminate until instructed/for a long time, this method returns a stream of
         [](pulumirpc.RunPluginResponse) messages containing information about standard error and output, as well as the
         exit code of the plugin when it does terminate.