pulumi-null 0.0.3a1710157610__tar.gz → 0.1.0a1736849544__tar.gz

{pulumi_null-0.0.3a1710157610 → pulumi_null-0.1.0a1736849544}/PKG-INFO

@@ -1,16 +1,17 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: pulumi_null
-Version: 0.0.3a1710157610
+Version: 0.1.0a1736849544
 Summary: A Pulumi package for creating and managing Null cloud resources.
 License: Apache-2.0
 Project-URL: Homepage, https://www.pulumi.com/
 Project-URL: Repository, https://github.com/pulumi/pulumi-null
 Keywords: pulumi,category/cloud
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: parver>=0.2.1
-Requires-Dist: pulumi<4.0.0,>=3.0.0
+Requires-Dist: pulumi<4.0.0,>=3.142.0
 Requires-Dist: semver>=2.8.1
+Requires-Dist: typing-extensions>=4.11; python_version < "3.11"
 
 [![Actions Status](https://github.com/pulumi/pulumi-null/workflows/master/badge.svg)](https://github.com/pulumi/pulumi-null/actions)
 [![NPM version](https://img.shields.io/npm/v/@pulumi/null)](https://www.npmjs.com/package/@pulumi/null)

{pulumi_null-0.0.3a1710157610 → pulumi_null-0.1.0a1736849544}/pulumi_null/_utilities.py

@@ -4,6 +4,7 @@
 
 
 import asyncio
+import functools
 import importlib.metadata
 import importlib.util
 import inspect
@@ -11,14 +12,19 @@ import json
 import os
 import sys
 import typing
+import warnings
+import base64
 
 import pulumi
 import pulumi.runtime
 from pulumi.runtime.sync_await import _sync_await
+from pulumi.runtime.proto import resource_pb2
 
 from semver import VersionInfo as SemverVersion
 from parver import Version as PEP440Version
 
+C = typing.TypeVar("C", bound=typing.Callable)
+
 
 def get_env(*args):
     for v in args:
@@ -96,10 +102,6 @@ def _get_semver_version():
 _version = _get_semver_version()
 _version_str = str(_version)
 
-
-def get_version():
-    return _version_str
-
 def get_resource_opts_defaults() -> pulumi.ResourceOptions:
     return pulumi.ResourceOptions(
         version=get_version(),
@@ -262,7 +264,7 @@ def call_plain(
     output = pulumi.runtime.call(tok, props, res, typ)
 
     # Ingoring deps silently. They are typically non-empty, r.f() calls include r as a dependency.
-    result, known, secret, _ = _sync_await(asyncio.ensure_future(_await_output(output)))
+    result, known, secret, _ = _sync_await(asyncio.create_task(_await_output(output)))
 
     problem = None
     if not known:
@@ -287,5 +289,39 @@ async def _await_output(o: pulumi.Output[typing.Any]) -> typing.Tuple[object, bo
         await o._resources,
     )
 
+
+# This is included to provide an upgrade path for users who are using a version
+# of the Pulumi SDK (<3.121.0) that does not include the `deprecated` decorator.
+def deprecated(message: str) -> typing.Callable[[C], C]:
+    """
+    Decorator to indicate a function is deprecated.
+
+    As well as inserting appropriate statements to indicate that the function is
+    deprecated, this decorator also tags the function with a special attribute
+    so that Pulumi code can detect that it is deprecated and react appropriately
+    in certain situations.
+
+    message is the deprecation message that should be printed if the function is called.
+    """
+
+    def decorator(fn: C) -> C:
+        if not callable(fn):
+            raise TypeError("Expected fn to be callable")
+
+        @functools.wraps(fn)
+        def deprecated_fn(*args, **kwargs):
+            warnings.warn(message)
+            pulumi.warn(f"{fn.__name__} is deprecated: {message}")
+
+            return fn(*args, **kwargs)
+
+        deprecated_fn.__dict__["_pulumi_deprecated_callable"] = fn
+        return typing.cast(C, deprecated_fn)
+
+    return decorator
+
 def get_plugin_download_url():
 	return None
+
+def get_version():
+     return _version_str

{pulumi_null-0.0.3a1710157610 → pulumi_null-0.1.0a1736849544}/pulumi_null/get_data_source.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = [
@@ -48,13 +53,11 @@ class GetDataSourceResult:
 
     @property
     @pulumi.getter
+    @_utilities.deprecated("""This attribute is only present for some legacy compatibility issues and should not be used. It will be removed in a future version.""")
     def id(self) -> str:
         """
         This attribute is only present for some legacy compatibility issues and should not be used. It will be removed in a future version.
         """
-        warnings.warn("""This attribute is only present for some legacy compatibility issues and should not be used. It will be removed in a future version.""", DeprecationWarning)
-        pulumi.log.warn("""id is deprecated: This attribute is only present for some legacy compatibility issues and should not be used. It will be removed in a future version.""")
-
         return pulumi.get(self, "id")
 
     @property
@@ -114,12 +117,9 @@ def get_data_source(has_computed_default: Optional[str] = None,
         inputs=pulumi.get(__ret__, 'inputs'),
         outputs=pulumi.get(__ret__, 'outputs'),
         random=pulumi.get(__ret__, 'random'))
-
-
-@_utilities.lift_output_func(get_data_source)
 def get_data_source_output(has_computed_default: Optional[pulumi.Input[Optional[str]]] = None,
                            inputs: Optional[pulumi.Input[Optional[Mapping[str, str]]]] = None,
-                           opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDataSourceResult]:
+                           opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[GetDataSourceResult]:
     """
     ## Example Usage
 
@@ -127,4 +127,14 @@ def get_data_source_output(has_computed_default: Optional[pulumi.Input[Optional[
     :param str has_computed_default: If set, its literal value will be stored and returned. If not, its value defaults to `"default"`. This argument exists primarily for testing and has little practical use.
     :param Mapping[str, str] inputs: A map of arbitrary strings that is copied into the `outputs` attribute, and accessible directly for interpolation.
     """
-    ...
+    __args__ = dict()
+    __args__['hasComputedDefault'] = has_computed_default
+    __args__['inputs'] = inputs
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('null:index/getDataSource:getDataSource', __args__, opts=opts, typ=GetDataSourceResult)
+    return __ret__.apply(lambda __response__: GetDataSourceResult(
+        has_computed_default=pulumi.get(__response__, 'has_computed_default'),
+        id=pulumi.get(__response__, 'id'),
+        inputs=pulumi.get(__response__, 'inputs'),
+        outputs=pulumi.get(__response__, 'outputs'),
+        random=pulumi.get(__response__, 'random')))

{pulumi_null-0.0.3a1710157610 → pulumi_null-0.1.0a1736849544}/pulumi_null/provider.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['ProviderArgs', 'Provider']

pulumi_null-0.1.0a1736849544/pulumi_null/pulumi-plugin.json

@@ -0,0 +1,5 @@
+{
+  "resource": true,
+  "name": "null",
+  "version": "0.1.0-alpha.1736849544"
+}

{pulumi_null-0.0.3a1710157610 → pulumi_null-0.1.0a1736849544}/pulumi_null/resource.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['ResourceArgs', 'Resource']
@@ -69,6 +74,31 @@ class Resource(pulumi.CustomResource):
         """
         ## Example Usage
 
+        ```python
+        import pulumi
+        import pulumi_aws as aws
+        import pulumi_null as null
+        import pulumi_std as std
+
+        cluster = []
+        for range in [{"value": i} for i in range(0, 3)]:
+            cluster.append(aws.index.Instance(f"cluster-{range['value']}",
+                ami=ami-0dcc1e21636832c5d,
+                instance_type=m5.large))
+        # The primary use-case for the null resource is as a do-nothing container
+        # for arbitrary actions taken by a provisioner.
+        #
+        # In this example, three EC2 instances are created and then a
+        # null_resource instance is used to gather data about all three
+        # and execute a single action that affects them all. Due to the triggers
+        # map, the null_resource will be replaced each time the instance ids
+        # change, and thus the remote-exec provisioner will be re-run.
+        cluster_resource = null.Resource("cluster", triggers={
+            "cluster_instance_ids": std.join(separator=",",
+                input=[__item["id"] for __item in cluster]).result,
+        })
+        ```
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the null resource to be replaced, re-running any associated provisioners.
@@ -82,6 +112,31 @@ class Resource(pulumi.CustomResource):
         """
         ## Example Usage
 
+        ```python
+        import pulumi
+        import pulumi_aws as aws
+        import pulumi_null as null
+        import pulumi_std as std
+
+        cluster = []
+        for range in [{"value": i} for i in range(0, 3)]:
+            cluster.append(aws.index.Instance(f"cluster-{range['value']}",
+                ami=ami-0dcc1e21636832c5d,
+                instance_type=m5.large))
+        # The primary use-case for the null resource is as a do-nothing container
+        # for arbitrary actions taken by a provisioner.
+        #
+        # In this example, three EC2 instances are created and then a
+        # null_resource instance is used to gather data about all three
+        # and execute a single action that affects them all. Due to the triggers
+        # map, the null_resource will be replaced each time the instance ids
+        # change, and thus the remote-exec provisioner will be re-run.
+        cluster_resource = null.Resource("cluster", triggers={
+            "cluster_instance_ids": std.join(separator=",",
+                input=[__item["id"] for __item in cluster]).result,
+        })
+        ```
+
         :param str resource_name: The name of the resource.
         :param ResourceArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.

{pulumi_null-0.0.3a1710157610 → pulumi_null-0.1.0a1736849544}/pulumi_null.egg-info/PKG-INFO

@@ -1,16 +1,17 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: pulumi_null
-Version: 0.0.3a1710157610
+Version: 0.1.0a1736849544
 Summary: A Pulumi package for creating and managing Null cloud resources.
 License: Apache-2.0
 Project-URL: Homepage, https://www.pulumi.com/
 Project-URL: Repository, https://github.com/pulumi/pulumi-null
 Keywords: pulumi,category/cloud
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 Requires-Dist: parver>=0.2.1
-Requires-Dist: pulumi<4.0.0,>=3.0.0
+Requires-Dist: pulumi<4.0.0,>=3.142.0
 Requires-Dist: semver>=2.8.1
+Requires-Dist: typing-extensions>=4.11; python_version < "3.11"
 
 [![Actions Status](https://github.com/pulumi/pulumi-null/workflows/master/badge.svg)](https://github.com/pulumi/pulumi-null/actions)
 [![NPM version](https://img.shields.io/npm/v/@pulumi/null)](https://www.npmjs.com/package/@pulumi/null)

pulumi_null-0.1.0a1736849544/pulumi_null.egg-info/requires.txt

@@ -0,0 +1,6 @@
+parver>=0.2.1
+pulumi<4.0.0,>=3.142.0
+semver>=2.8.1
+
+[:python_version < "3.11"]
+typing-extensions>=4.11

{pulumi_null-0.0.3a1710157610 → pulumi_null-0.1.0a1736849544}/pyproject.toml

@@ -1,11 +1,11 @@
 [project]
   name = "pulumi_null"
   description = "A Pulumi package for creating and managing Null cloud resources."
-  dependencies = ["parver>=0.2.1", "pulumi>=3.0.0,<4.0.0", "semver>=2.8.1"]
+  dependencies = ["parver>=0.2.1", "pulumi>=3.142.0,<4.0.0", "semver>=2.8.1", "typing-extensions>=4.11; python_version < \"3.11\""]
   keywords = ["pulumi", "category/cloud"]
   readme = "README.md"
-  requires-python = ">=3.8"
-  version = "0.0.3a1710157610"
+  requires-python = ">=3.9"
+  version = "0.1.0a1736849544"
   [project.license]
     text = "Apache-2.0"
   [project.urls]

pulumi_null-0.0.3a1710157610/pulumi_null/pulumi-plugin.json

@@ -1,4 +0,0 @@
-{
-  "resource": true,
-  "name": "null"
-}

pulumi_null-0.0.3a1710157610/pulumi_null.egg-info/requires.txt

@@ -1,3 +0,0 @@
-parver>=0.2.1
-pulumi<4.0.0,>=3.0.0
-semver>=2.8.1