pulumi-std 2.3.0__py3-none-any.whl

pulumi_std/__init__.py

@@ -0,0 +1,121 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+from . import _utilities
+import typing
+# Export this package's modules as members:
+from .abs import *
+from .abspath import *
+from .alltrue import *
+from .anytrue import *
+from .base64decode import *
+from .base64encode import *
+from .base64gzip import *
+from .base64sha256 import *
+from .base64sha512 import *
+from .basename import *
+from .bcrypt import *
+from .ceil import *
+from .chomp import *
+from .chunklist import *
+from .cidrhost import *
+from .cidrnetmask import *
+from .cidrsubnet import *
+from .cidrsubnets import *
+from .coalesce import *
+from .coalescelist import *
+from .compact import *
+from .concat import *
+from .contains import *
+from .csvdecode import *
+from .dirname import *
+from .distinct import *
+from .element import *
+from .endswith import *
+from .file import *
+from .filebase64 import *
+from .filebase64sha256 import *
+from .filebase64sha512 import *
+from .fileexists import *
+from .filemd5 import *
+from .filesha1 import *
+from .filesha256 import *
+from .filesha512 import *
+from .flatten import *
+from .floor import *
+from .format import *
+from .formatlist import *
+from .indent import *
+from .index import *
+from .join import *
+from .jsondecode import *
+from .jsonencode import *
+from .keys import *
+from .length import *
+from .log import *
+from .lookup import *
+from .lower import *
+from .map import *
+from .matchkeys import *
+from .max import *
+from .md5 import *
+from .merge import *
+from .min import *
+from .parseint import *
+from .pathexpand import *
+from .pow import *
+from .provider import *
+from .range import *
+from .regex import *
+from .regexall import *
+from .replace import *
+from .reverse import *
+from .rsadecrypt import *
+from .setintersection import *
+from .sha1 import *
+from .sha256 import *
+from .sha512 import *
+from .signum import *
+from .slice import *
+from .sort import *
+from .split import *
+from .startswith import *
+from .strrev import *
+from .substr import *
+from .sum import *
+from .timeadd import *
+from .timecmp import *
+from .timestamp import *
+from .title import *
+from .tobool import *
+from .tolist import *
+from .tonumber import *
+from .toset import *
+from .tostring import *
+from .transpose import *
+from .trim import *
+from .trimprefix import *
+from .trimspace import *
+from .trimsuffix import *
+from .upper import *
+from .urlencode import *
+from .uuid import *
+from .values import *
+from .zipmap import *
+_utilities.register(
+    resource_modules="""
+[]
+""",
+    resource_packages="""
+[
+ {
+  "pkg": "std",
+  "token": "pulumi:providers:std",
+  "fqn": "pulumi_std",
+  "class": "Provider"
+ }
+]
+"""
+)

pulumi_std/_utilities.py

@@ -0,0 +1,331 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+
+import asyncio
+import functools
+import importlib.metadata
+import importlib.util
+import inspect
+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:
+        value = os.getenv(v)
+        if value is not None:
+            return value
+    return None
+
+
+def get_env_bool(*args):
+    str = get_env(*args)
+    if str is not None:
+        # NOTE: these values are taken from https://golang.org/src/strconv/atob.go?s=351:391#L1, which is what
+        # Terraform uses internally when parsing boolean values.
+        if str in ["1", "t", "T", "true", "TRUE", "True"]:
+            return True
+        if str in ["0", "f", "F", "false", "FALSE", "False"]:
+            return False
+    return None
+
+
+def get_env_int(*args):
+    str = get_env(*args)
+    if str is not None:
+        try:
+            return int(str)
+        except:
+            return None
+    return None
+
+
+def get_env_float(*args):
+    str = get_env(*args)
+    if str is not None:
+        try:
+            return float(str)
+        except:
+            return None
+    return None
+
+
+def _get_semver_version():
+    # __name__ is set to the fully-qualified name of the current module, In our case, it will be
+    # <some module>._utilities. <some module> is the module we want to query the version for.
+    root_package, *rest = __name__.split('.')
+
+    # pkg_resources uses setuptools to inspect the set of installed packages. We use it here to ask
+    # for the currently installed version of the root package (i.e. us) and get its version.
+
+    # Unfortunately, PEP440 and semver differ slightly in incompatible ways. The Pulumi engine expects
+    # to receive a valid semver string when receiving requests from the language host, so it's our
+    # responsibility as the library to convert our own PEP440 version into a valid semver string.
+
+    pep440_version_string = importlib.metadata.version(root_package)
+    pep440_version = PEP440Version.parse(pep440_version_string)
+    (major, minor, patch) = pep440_version.release
+    prerelease = None
+    if pep440_version.pre_tag == 'a':
+        prerelease = f"alpha.{pep440_version.pre}"
+    elif pep440_version.pre_tag == 'b':
+        prerelease = f"beta.{pep440_version.pre}"
+    elif pep440_version.pre_tag == 'rc':
+        prerelease = f"rc.{pep440_version.pre}"
+    elif pep440_version.dev is not None:
+        # PEP440 has explicit support for dev builds, while semver encodes them as "prerelease" versions. To bridge 
+        # between the two, we convert our dev build version into a prerelease tag. This matches what all of our other
+        # packages do when constructing their own semver string.
+        prerelease = f"dev.{pep440_version.dev}"
+    elif pep440_version.local is not None:
+        # PEP440 only allows a small set of prerelease tags, so when converting an arbitrary prerelease,
+        # PypiVersion in /pkg/codegen/python/utilities.go converts it to a local version. Therefore, we need to
+        # do the reverse conversion here and set the local version as the prerelease tag.
+        prerelease = pep440_version.local
+
+    return SemverVersion(major=major, minor=minor, patch=patch, prerelease=prerelease)
+
+
+# Determine the version once and cache the value, which measurably improves program performance.
+_version = _get_semver_version()
+_version_str = str(_version)
+
+def get_resource_opts_defaults() -> pulumi.ResourceOptions:
+    return pulumi.ResourceOptions(
+        version=get_version(),
+        plugin_download_url=get_plugin_download_url(),
+    )
+
+def get_invoke_opts_defaults() -> pulumi.InvokeOptions:
+    return pulumi.InvokeOptions(
+        version=get_version(),
+        plugin_download_url=get_plugin_download_url(),
+    )
+
+def get_resource_args_opts(resource_args_type, resource_options_type, *args, **kwargs):
+    """
+    Return the resource args and options given the *args and **kwargs of a resource's
+    __init__ method.
+    """
+
+    resource_args, opts = None, None
+
+    # If the first item is the resource args type, save it and remove it from the args list.
+    if args and isinstance(args[0], resource_args_type):
+        resource_args, args = args[0], args[1:]
+
+    # Now look at the first item in the args list again.
+    # If the first item is the resource options class, save it.
+    if args and isinstance(args[0], resource_options_type):
+        opts = args[0]
+
+    # If resource_args is None, see if "args" is in kwargs, and, if so, if it's typed as the
+    # the resource args type.
+    if resource_args is None:
+        a = kwargs.get("args")
+        if isinstance(a, resource_args_type):
+            resource_args = a
+
+    # If opts is None, look it up in kwargs.
+    if opts is None:
+        opts = kwargs.get("opts")
+
+    return resource_args, opts
+
+
+# Temporary: just use pulumi._utils.lazy_import once everyone upgrades.
+def lazy_import(fullname):
+
+    import pulumi._utils as u
+    f = getattr(u, 'lazy_import', None)
+    if f is None:
+        f = _lazy_import_temp
+
+    return f(fullname)
+
+
+# Copied from pulumi._utils.lazy_import, see comments there.
+def _lazy_import_temp(fullname):
+    m = sys.modules.get(fullname, None)
+    if m is not None:
+        return m
+
+    spec = importlib.util.find_spec(fullname)
+
+    m = sys.modules.get(fullname, None)
+    if m is not None:
+        return m
+
+    loader = importlib.util.LazyLoader(spec.loader)
+    spec.loader = loader
+    module = importlib.util.module_from_spec(spec)
+
+    m = sys.modules.get(fullname, None)
+    if m is not None:
+        return m
+
+    sys.modules[fullname] = module
+    loader.exec_module(module)
+    return module
+
+
+class Package(pulumi.runtime.ResourcePackage):
+    def __init__(self, pkg_info):
+        super().__init__()
+        self.pkg_info = pkg_info
+
+    def version(self):
+        return _version
+
+    def construct_provider(self, name: str, typ: str, urn: str) -> pulumi.ProviderResource:
+        if typ != self.pkg_info['token']:
+            raise Exception(f"unknown provider type {typ}")
+        Provider = getattr(lazy_import(self.pkg_info['fqn']), self.pkg_info['class'])
+        return Provider(name, pulumi.ResourceOptions(urn=urn))
+
+
+class Module(pulumi.runtime.ResourceModule):
+    def __init__(self, mod_info):
+        super().__init__()
+        self.mod_info = mod_info
+
+    def version(self):
+        return _version
+
+    def construct(self, name: str, typ: str, urn: str) -> pulumi.Resource:
+        class_name = self.mod_info['classes'].get(typ, None)
+
+        if class_name is None:
+            raise Exception(f"unknown resource type {typ}")
+
+        TheClass = getattr(lazy_import(self.mod_info['fqn']), class_name)
+        return TheClass(name, pulumi.ResourceOptions(urn=urn))
+
+
+def register(resource_modules, resource_packages):
+    resource_modules = json.loads(resource_modules)
+    resource_packages = json.loads(resource_packages)
+
+    for pkg_info in resource_packages:
+        pulumi.runtime.register_resource_package(pkg_info['pkg'], Package(pkg_info))
+
+    for mod_info in resource_modules:
+        pulumi.runtime.register_resource_module(
+            mod_info['pkg'],
+            mod_info['mod'],
+            Module(mod_info))
+
+
+_F = typing.TypeVar('_F', bound=typing.Callable[..., typing.Any])
+
+
+def lift_output_func(func: typing.Any) -> typing.Callable[[_F], _F]:
+    """Decorator internally used on {fn}_output lifted function versions
+    to implement them automatically from the un-lifted function."""
+
+    func_sig = inspect.signature(func)
+
+    def lifted_func(*args, opts=None, **kwargs):
+        bound_args = func_sig.bind(*args, **kwargs)
+        # Convert tuple to list, see pulumi/pulumi#8172
+        args_list = list(bound_args.args)
+        return pulumi.Output.from_input({
+            'args': args_list,
+            'kwargs': bound_args.kwargs
+        }).apply(lambda resolved_args: func(*resolved_args['args'],
+                                            opts=opts,
+                                            **resolved_args['kwargs']))
+
+    return (lambda _: lifted_func)
+
+
+def call_plain(
+    tok: str,
+    props: pulumi.Inputs,
+    res: typing.Optional[pulumi.Resource] = None,
+    typ: typing.Optional[type] = None,
+) -> typing.Any:
+    """
+    Wraps pulumi.runtime.plain to force the output and return it plainly.
+    """
+
+    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.create_task(_await_output(output)))
+
+    problem = None
+    if not known:
+        problem = ' an unknown value'
+    elif secret:
+        problem = ' a secret value'
+
+    if problem:
+        raise AssertionError(
+            f"Plain resource method '{tok}' incorrectly returned {problem}. "
+            + "This is an error in the provider, please report this to the provider developer."
+        )
+
+    return result
+
+
+async def _await_output(o: pulumi.Output[typing.Any]) -> typing.Tuple[object, bool, bool, set]:
+    return (
+        await o._future,
+        await o._is_known,
+        await o._is_secret,
+        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_std/abs.py

@@ -0,0 +1,70 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+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__ = [
+    'AbsResult',
+    'AwaitableAbsResult',
+    'abs',
+    'abs_output',
+]
+
+@pulumi.output_type
+class AbsResult:
+    def __init__(__self__, result=None):
+        if result and not isinstance(result, float):
+            raise TypeError("Expected argument 'result' to be a float")
+        pulumi.set(__self__, "result", result)
+
+    @_builtins.property
+    @pulumi.getter
+    def result(self) -> _builtins.float:
+        return pulumi.get(self, "result")
+
+
+class AwaitableAbsResult(AbsResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return AbsResult(
+            result=self.result)
+
+
+def abs(input: Optional[_builtins.float] = None,
+        opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableAbsResult:
+    """
+    Returns the absolute value of a given float.
+    Example: abs(1) returns 1, and abs(-1) would also return 1, whereas abs(-3.14) would return 3.14.
+    """
+    __args__ = dict()
+    __args__['input'] = input
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('std:index:abs', __args__, opts=opts, typ=AbsResult).value
+
+    return AwaitableAbsResult(
+        result=pulumi.get(__ret__, 'result'))
+def abs_output(input: Optional[pulumi.Input[_builtins.float]] = None,
+               opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[AbsResult]:
+    """
+    Returns the absolute value of a given float.
+    Example: abs(1) returns 1, and abs(-1) would also return 1, whereas abs(-3.14) would return 3.14.
+    """
+    __args__ = dict()
+    __args__['input'] = input
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('std:index:abs', __args__, opts=opts, typ=AbsResult)
+    return __ret__.apply(lambda __response__: AbsResult(
+        result=pulumi.get(__response__, 'result')))

pulumi_std/abspath.py

@@ -0,0 +1,70 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+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__ = [
+    'AbspathResult',
+    'AwaitableAbspathResult',
+    'abspath',
+    'abspath_output',
+]
+
+@pulumi.output_type
+class AbspathResult:
+    def __init__(__self__, result=None):
+        if result and not isinstance(result, str):
+            raise TypeError("Expected argument 'result' to be a str")
+        pulumi.set(__self__, "result", result)
+
+    @_builtins.property
+    @pulumi.getter
+    def result(self) -> _builtins.str:
+        return pulumi.get(self, "result")
+
+
+class AwaitableAbspathResult(AbspathResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return AbspathResult(
+            result=self.result)
+
+
+def abspath(input: Optional[_builtins.str] = None,
+            opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableAbspathResult:
+    """
+    Returns an absolute representation of the specified path.
+    If the path is not absolute it will be joined with the current working directory to turn it into an absolute path.
+    """
+    __args__ = dict()
+    __args__['input'] = input
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('std:index:abspath', __args__, opts=opts, typ=AbspathResult).value
+
+    return AwaitableAbspathResult(
+        result=pulumi.get(__ret__, 'result'))
+def abspath_output(input: Optional[pulumi.Input[_builtins.str]] = None,
+                   opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[AbspathResult]:
+    """
+    Returns an absolute representation of the specified path.
+    If the path is not absolute it will be joined with the current working directory to turn it into an absolute path.
+    """
+    __args__ = dict()
+    __args__['input'] = input
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('std:index:abspath', __args__, opts=opts, typ=AbspathResult)
+    return __ret__.apply(lambda __response__: AbspathResult(
+        result=pulumi.get(__response__, 'result')))

pulumi_std/alltrue.py

@@ -0,0 +1,70 @@
+# coding=utf-8
+# *** WARNING: this file was generated by pulumi-language-python. ***
+# *** Do not edit by hand unless you're certain you know what you are doing! ***
+
+import builtins as _builtins
+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__ = [
+    'AlltrueResult',
+    'AwaitableAlltrueResult',
+    'alltrue',
+    'alltrue_output',
+]
+
+@pulumi.output_type
+class AlltrueResult:
+    def __init__(__self__, result=None):
+        if result and not isinstance(result, bool):
+            raise TypeError("Expected argument 'result' to be a bool")
+        pulumi.set(__self__, "result", result)
+
+    @_builtins.property
+    @pulumi.getter
+    def result(self) -> _builtins.bool:
+        return pulumi.get(self, "result")
+
+
+class AwaitableAlltrueResult(AlltrueResult):
+    # pylint: disable=using-constant-test
+    def __await__(self):
+        if False:
+            yield self
+        return AlltrueResult(
+            result=self.result)
+
+
+def alltrue(input: Optional[Sequence[Any]] = None,
+            opts: Optional[pulumi.InvokeOptions] = None) -> AwaitableAlltrueResult:
+    """
+    Returns true if all elements in a given collection are true or \\"true\\".
+    It also returns true if the collection is empty.
+    """
+    __args__ = dict()
+    __args__['input'] = input
+    opts = pulumi.InvokeOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke('std:index:alltrue', __args__, opts=opts, typ=AlltrueResult).value
+
+    return AwaitableAlltrueResult(
+        result=pulumi.get(__ret__, 'result'))
+def alltrue_output(input: Optional[pulumi.Input[Sequence[Any]]] = None,
+                   opts: Optional[Union[pulumi.InvokeOptions, pulumi.InvokeOutputOptions]] = None) -> pulumi.Output[AlltrueResult]:
+    """
+    Returns true if all elements in a given collection are true or \\"true\\".
+    It also returns true if the collection is empty.
+    """
+    __args__ = dict()
+    __args__['input'] = input
+    opts = pulumi.InvokeOutputOptions.merge(_utilities.get_invoke_opts_defaults(), opts)
+    __ret__ = pulumi.runtime.invoke_output('std:index:alltrue', __args__, opts=opts, typ=AlltrueResult)
+    return __ret__.apply(lambda __response__: AlltrueResult(
+        result=pulumi.get(__response__, 'result')))