pulumi-null 0.0.3a1709366046__py3-none-any.whl → 0.1.0a1715061333__py3-none-any.whl

pulumi_null/get_data_source.py

@@ -96,7 +96,8 @@ def get_data_source(has_computed_default: Optional[str] = None,
                     inputs: Optional[Mapping[str, str]] = None,
                     opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableGetDataSourceResult:
     """
-    Use this data source to access information about an existing resource.
+    ## Example Usage
+
 
     :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.
@@ -120,7 +121,8 @@ def get_data_source_output(has_computed_default: Optional[pulumi.Input[Optional[
                            inputs: Optional[pulumi.Input[Optional[Mapping[str, str]]]] = None,
                            opts: Optional[pulumi.InvokeOptions] = None) -> pulumi.Output[GetDataSourceResult]:
     """
-    Use this data source to access information about an existing resource.
+    ## Example Usage
+
 
     :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.

pulumi_null/resource.py

@@ -67,7 +67,33 @@ class Resource(pulumi.CustomResource):
                  triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  __props__=None):
         """
-        Create a Resource resource with the given unique name, props, and options.
+        ## 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.
@@ -79,7 +105,33 @@ class Resource(pulumi.CustomResource):
                  args: Optional[ResourceArgs] = None,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        Create a Resource resource with the given unique name, props, and options.
+        ## 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.3a1709366046.dist-info → pulumi_null-0.1.0a1715061333.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: pulumi_null
-Version: 0.0.3a1709366046
+Version: 0.1.0a1715061333
 Summary: A Pulumi package for creating and managing Null cloud resources.
 License: Apache-2.0
 Project-URL: Homepage, https://www.pulumi.com/

pulumi_null-0.1.0a1715061333.dist-info/RECORD

@@ -0,0 +1,11 @@
+pulumi_null/__init__.py,sha256=vfO-Nyln5Y_KQyhBViIfR85yyF-7e_dM8AWDOgBltxk,682
+pulumi_null/_utilities.py,sha256=b6gJn0IIeM1t6Q7EVjqw3yhuGyP-uENQhtL5yp7aHR8,9248
+pulumi_null/get_data_source.py,sha256=fAZn0ddoCFmZnWkky1nvISA_xZCtWRzXHvmQHee9g5A,5564
+pulumi_null/provider.py,sha256=SLc7l69q4BwAiTTj6UutzTFplKhivhcTH8x06xaqsuM,3414
+pulumi_null/pulumi-plugin.json,sha256=xKWQ3pWIFdx8ao-qagk5twTTzey4mlMpszE1QbEoV9s,41
+pulumi_null/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pulumi_null/resource.py,sha256=ozZbh7enU3dEorIF4ztQH4hc6P2v4EWdKCjbPVqK4p0,8640
+pulumi_null-0.1.0a1715061333.dist-info/METADATA,sha256=DzZmLjJgNLkxRqVuKaNpdBKDTydK17umM6oB1EJ7-pI,2774
+pulumi_null-0.1.0a1715061333.dist-info/WHEEL,sha256=GJ7t_kWBFywbagK5eo9IoUwLW6oyOeTKmQ-9iHFVNxQ,92
+pulumi_null-0.1.0a1715061333.dist-info/top_level.txt,sha256=Ru9dJEzD8mCrozV4N2VCSavoQqMS9aa8gq-PLsirmtc,12
+pulumi_null-0.1.0a1715061333.dist-info/RECORD,,

{pulumi_null-0.0.3a1709366046.dist-info → pulumi_null-0.1.0a1715061333.dist-info}/WHEEL

@@ -1,5 +1,5 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.42.0)
+Generator: bdist_wheel (0.43.0)
 Root-Is-Purelib: true
 Tag: py3-none-any
 

pulumi_null-0.0.3a1709366046.dist-info/RECORD

@@ -1,11 +0,0 @@
-pulumi_null/__init__.py,sha256=vfO-Nyln5Y_KQyhBViIfR85yyF-7e_dM8AWDOgBltxk,682
-pulumi_null/_utilities.py,sha256=b6gJn0IIeM1t6Q7EVjqw3yhuGyP-uENQhtL5yp7aHR8,9248
-pulumi_null/get_data_source.py,sha256=KwW7lzYd9L1Uis5LdSDhz4OiROB1ubzVaaNbprF5jWM,5670
-pulumi_null/provider.py,sha256=SLc7l69q4BwAiTTj6UutzTFplKhivhcTH8x06xaqsuM,3414
-pulumi_null/pulumi-plugin.json,sha256=xKWQ3pWIFdx8ao-qagk5twTTzey4mlMpszE1QbEoV9s,41
-pulumi_null/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-pulumi_null/resource.py,sha256=kJ34pwpvzfi7jBub7fhYNCcTi7-YD-Zo4vYLMD13mMk,6526
-pulumi_null-0.0.3a1709366046.dist-info/METADATA,sha256=NNDTWK97SQx2pRZck73uZ0W-2hzOjxxgR1NVfqKHCFk,2774
-pulumi_null-0.0.3a1709366046.dist-info/WHEEL,sha256=oiQVh_5PnQM0E3gPdiz09WCNmwiHDMaGer_elqB3coM,92
-pulumi_null-0.0.3a1709366046.dist-info/top_level.txt,sha256=Ru9dJEzD8mCrozV4N2VCSavoQqMS9aa8gq-PLsirmtc,12
-pulumi_null-0.0.3a1709366046.dist-info/RECORD,,