pulumi-docker 4.6.0b4__py3-none-any.whl → 4.6.2__py3-none-any.whl

pulumi_docker/_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:
@@ -83,12 +89,16 @@ def _get_semver_version():
     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
 
-    # The only significant difference between PEP440 and semver as it pertains to us is that PEP440 has explicit support
-    # for dev builds, while semver encodes them as "prerelease" versions. In order 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.
     return SemverVersion(major=major, minor=minor, patch=patch, prerelease=prerelease)
 
 
@@ -96,10 +106,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 +268,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 +293,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_docker/config/__init__.pyi

@@ -4,43 +4,46 @@
 
 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
 from . import outputs
 
 caMaterial: Optional[str]
 """
-PEM-encoded content of Docker host CA certificate.
+PEM-encoded content of Docker host CA certificate
 """
 
 certMaterial: Optional[str]
 """
-PEM-encoded content of Docker client certificate.
+PEM-encoded content of Docker client certificate
 """
 
 certPath: Optional[str]
 """
-Path to a directory with Docker TLS config. This directory is expected to contain `ca.pem`, `cert.pem`, and `key.pem`
-files.
+Path to directory with Docker TLS config
 """
 
 host: Optional[str]
 """
-The Docker daemon's address.
+The Docker daemon address
 """
 
 keyMaterial: Optional[str]
 """
-PEM-encoded content of Docker client private key.
+PEM-encoded content of Docker client private key
 """
 
 registryAuth: Optional[str]
 
 sshOpts: Optional[str]
 """
-Additional SSH option flags to be appended when using `ssh://` protocol. The `ssh://` protocol is not supported for
-`buildx.Image` resources. Instead, use a [remote](https://docs.docker.com/build/drivers/remote/) driver.
+Additional SSH option flags to be appended when using `ssh://` protocol
 """
 

pulumi_docker/config/outputs.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__ = [
@@ -23,7 +28,7 @@ class RegistryAuth(dict):
                  password: Optional[str] = None,
                  username: Optional[str] = None):
         """
-        :param str address: Address of the registry.
+        :param str address: Address of the registry
         :param str config_file: Path to docker json file for registry auth. Defaults to `~/.docker/config.json`. If `DOCKER_CONFIG` is set, the value of `DOCKER_CONFIG` is used as the path. `config_file` has predencen over all other options.
         :param str config_file_content: Plain content of the docker json file for registry auth. `config_file_content` has precedence over username/password.
         :param str password: Password for the registry. Defaults to `DOCKER_REGISTRY_PASS` env variable if set.
@@ -45,7 +50,7 @@ class RegistryAuth(dict):
     @pulumi.getter
     def address(self) -> str:
         """
-        Address of the registry.
+        Address of the registry
         """
         return pulumi.get(self, "address")
 

pulumi_docker/config/vars.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
 from . import outputs
 
@@ -19,36 +24,35 @@ class _ExportableConfig(types.ModuleType):
     @property
     def ca_material(self) -> Optional[str]:
         """
-        PEM-encoded content of Docker host CA certificate.
+        PEM-encoded content of Docker host CA certificate
         """
         return __config__.get('caMaterial')
 
     @property
     def cert_material(self) -> Optional[str]:
         """
-        PEM-encoded content of Docker client certificate.
+        PEM-encoded content of Docker client certificate
         """
         return __config__.get('certMaterial')
 
     @property
     def cert_path(self) -> Optional[str]:
         """
-        Path to a directory with Docker TLS config. This directory is expected to contain `ca.pem`, `cert.pem`, and `key.pem`
-        files.
+        Path to directory with Docker TLS config
         """
         return __config__.get('certPath')
 
     @property
     def host(self) -> Optional[str]:
         """
-        The Docker daemon's address.
+        The Docker daemon address
         """
         return __config__.get('host') or _utilities.get_env('DOCKER_HOST')
 
     @property
     def key_material(self) -> Optional[str]:
         """
-        PEM-encoded content of Docker client private key.
+        PEM-encoded content of Docker client private key
         """
         return __config__.get('keyMaterial')
 
@@ -59,8 +63,7 @@ class _ExportableConfig(types.ModuleType):
     @property
     def ssh_opts(self) -> Optional[str]:
         """
-        Additional SSH option flags to be appended when using `ssh://` protocol. The `ssh://` protocol is not supported for
-        `buildx.Image` resources. Instead, use a [remote](https://docs.docker.com/build/drivers/remote/) driver.
+        Additional SSH option flags to be appended when using `ssh://` protocol
         """
         return __config__.get('sshOpts')