pulumi-cloudamqp 3.18.0a1709359306__tar.gz → 3.21.0a1736832130__tar.gz

{pulumi_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/PKG-INFO

@@ -1,16 +1,17 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.2
 Name: pulumi_cloudamqp
-Version: 3.18.0a1709359306
+Version: 3.21.0a1736832130
 Summary: A Pulumi package for creating and managing CloudAMQP resources.
 License: Apache-2.0
 Project-URL: Homepage, https://pulumi.io
 Project-URL: Repository, https://github.com/pulumi/pulumi-cloudamqp
 Keywords: pulumi,cloudamqp
-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-cloudamqp/workflows/master/badge.svg)](https://github.com/pulumi/pulumi-cloudamqp/actions)
 [![Slack](http://www.pulumi.com/images/docs/badges/slack.svg)](https://slack.pulumi.com)

{pulumi_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/pulumi_cloudamqp/__init__.py

@@ -34,6 +34,7 @@ from .privatelink_azure import *
 from .provider import *
 from .rabbit_configuration import *
 from .security_firewall import *
+from .upgrade_lavinmq import *
 from .upgrade_rabbitmq import *
 from .vpc import *
 from .vpc_connect import *
@@ -181,6 +182,14 @@ _utilities.register(
    "cloudamqp:index/securityFirewall:SecurityFirewall": "SecurityFirewall"
   }
  },
+ {
+  "pkg": "cloudamqp",
+  "mod": "index/upgradeLavinmq",
+  "fqn": "pulumi_cloudamqp",
+  "classes": {
+   "cloudamqp:index/upgradeLavinmq:UpgradeLavinmq": "UpgradeLavinmq"
+  }
+ },
  {
   "pkg": "cloudamqp",
   "mod": "index/upgradeRabbitmq",

{pulumi_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/pulumi_cloudamqp/_inputs.py

@@ -4,18 +4,43 @@
 
 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__ = [
     'ExtraDiskSizeNodeArgs',
+    'ExtraDiskSizeNodeArgsDict',
     'InstanceCopySettingArgs',
+    'InstanceCopySettingArgsDict',
     'NotificationResponderArgs',
+    'NotificationResponderArgsDict',
     'SecurityFirewallRuleArgs',
+    'SecurityFirewallRuleArgsDict',
 ]
 
+MYPY = False
+
+if not MYPY:
+    class ExtraDiskSizeNodeArgsDict(TypedDict):
+        additional_disk_size: NotRequired[pulumi.Input[int]]
+        """
+        Additional added disk size
+        """
+        disk_size: NotRequired[pulumi.Input[int]]
+        """
+        Subscription plan disk size
+        """
+        name: NotRequired[pulumi.Input[str]]
+elif False:
+    ExtraDiskSizeNodeArgsDict: TypeAlias = Mapping[str, Any]
+
 @pulumi.input_type
 class ExtraDiskSizeNodeArgs:
     def __init__(__self__, *,
@@ -67,6 +92,21 @@ class ExtraDiskSizeNodeArgs:
         pulumi.set(self, "name", value)
 
 
+if not MYPY:
+    class InstanceCopySettingArgsDict(TypedDict):
+        settings: pulumi.Input[Sequence[pulumi.Input[str]]]
+        """
+        Array of one or more settings to be copied. Allowed values: [alarms, config, definitions, firewall, logs, metrics, plugins]
+
+        See more below, copy settings
+        """
+        subscription_id: pulumi.Input[str]
+        """
+        Instance identifier of the CloudAMQP instance to copy the settings from.
+        """
+elif False:
+    InstanceCopySettingArgsDict: TypeAlias = Mapping[str, Any]
+
 @pulumi.input_type
 class InstanceCopySettingArgs:
     def __init__(__self__, *,
@@ -108,6 +148,30 @@ class InstanceCopySettingArgs:
         pulumi.set(self, "subscription_id", value)
 
 
+if not MYPY:
+    class NotificationResponderArgsDict(TypedDict):
+        type: pulumi.Input[str]
+        """
+        Type of responder. [`team`, `user`, `escalation`, `schedule`]
+        """
+        id: NotRequired[pulumi.Input[str]]
+        """
+        Identifier in UUID format
+        """
+        name: NotRequired[pulumi.Input[str]]
+        """
+        Name of the responder
+        """
+        username: NotRequired[pulumi.Input[str]]
+        """
+        Username of the responder
+
+        Responders of type `team`, `escalation` and `schedule` can use either id or name.
+        While `user` can use either id or username.
+        """
+elif False:
+    NotificationResponderArgsDict: TypeAlias = Mapping[str, Any]
+
 @pulumi.input_type
 class NotificationResponderArgs:
     def __init__(__self__, *,
@@ -184,6 +248,49 @@ class NotificationResponderArgs:
         pulumi.set(self, "username", value)
 
 
+if not MYPY:
+    class SecurityFirewallRuleArgsDict(TypedDict):
+        ip: pulumi.Input[str]
+        """
+        CIDR address: IP address with CIDR notation (e.g. 10.56.72.0/24)
+        """
+        description: NotRequired[pulumi.Input[str]]
+        """
+        Description name of the rule. e.g. Default.
+
+        Pre-defined services for RabbitMQ:
+
+        | Service name | Port  |
+        |--------------|-------|
+        | AMQP         | 5672  |
+        | AMQPS        | 5671  |
+        | HTTPS        | 443   |
+        | MQTT         | 1883  |
+        | MQTTS        | 8883  |
+        | STOMP        | 61613 |
+        | STOMPS       | 61614 |
+        | STREAM       | 5552  |
+        | STREAM_SSL   | 5551  |
+
+        Pre-defined services for LavinMQ:
+
+        | Service name | Port  |
+        |--------------|-------|
+        | AMQP         | 5672  |
+        | AMQPS        | 5671  |
+        | HTTPS        | 443   |
+        """
+        ports: NotRequired[pulumi.Input[Sequence[pulumi.Input[int]]]]
+        """
+        Custom ports to be opened
+        """
+        services: NotRequired[pulumi.Input[Sequence[pulumi.Input[str]]]]
+        """
+        Pre-defined service ports, see table below
+        """
+elif False:
+    SecurityFirewallRuleArgsDict: TypeAlias = Mapping[str, Any]
+
 @pulumi.input_type
 class SecurityFirewallRuleArgs:
     def __init__(__self__, *,
@@ -193,9 +300,31 @@ class SecurityFirewallRuleArgs:
                  services: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None):
         """
         :param pulumi.Input[str] ip: CIDR address: IP address with CIDR notation (e.g. 10.56.72.0/24)
-        :param pulumi.Input[str] description: Naming descripton e.g. 'Default'
-        :param pulumi.Input[Sequence[pulumi.Input[int]]] ports: Custom ports between 0 - 65554
-        :param pulumi.Input[Sequence[pulumi.Input[str]]] services: Pre-defined services 'AMQP', 'AMQPS', 'HTTPS', 'MQTT', 'MQTTS', 'STOMP', 'STOMPS', 'STREAM', 'STREAM_SSL'
+        :param pulumi.Input[str] description: Description name of the rule. e.g. Default.
+               
+               Pre-defined services for RabbitMQ:
+               
+               | Service name | Port  |
+               |--------------|-------|
+               | AMQP         | 5672  |
+               | AMQPS        | 5671  |
+               | HTTPS        | 443   |
+               | MQTT         | 1883  |
+               | MQTTS        | 8883  |
+               | STOMP        | 61613 |
+               | STOMPS       | 61614 |
+               | STREAM       | 5552  |
+               | STREAM_SSL   | 5551  |
+               
+               Pre-defined services for LavinMQ:
+               
+               | Service name | Port  |
+               |--------------|-------|
+               | AMQP         | 5672  |
+               | AMQPS        | 5671  |
+               | HTTPS        | 443   |
+        :param pulumi.Input[Sequence[pulumi.Input[int]]] ports: Custom ports to be opened
+        :param pulumi.Input[Sequence[pulumi.Input[str]]] services: Pre-defined service ports, see table below
         """
         pulumi.set(__self__, "ip", ip)
         if description is not None:
@@ -221,7 +350,29 @@ class SecurityFirewallRuleArgs:
     @pulumi.getter
     def description(self) -> Optional[pulumi.Input[str]]:
         """
-        Naming descripton e.g. 'Default'
+        Description name of the rule. e.g. Default.
+
+        Pre-defined services for RabbitMQ:
+
+        | Service name | Port  |
+        |--------------|-------|
+        | AMQP         | 5672  |
+        | AMQPS        | 5671  |
+        | HTTPS        | 443   |
+        | MQTT         | 1883  |
+        | MQTTS        | 8883  |
+        | STOMP        | 61613 |
+        | STOMPS       | 61614 |
+        | STREAM       | 5552  |
+        | STREAM_SSL   | 5551  |
+
+        Pre-defined services for LavinMQ:
+
+        | Service name | Port  |
+        |--------------|-------|
+        | AMQP         | 5672  |
+        | AMQPS        | 5671  |
+        | HTTPS        | 443   |
         """
         return pulumi.get(self, "description")
 
@@ -233,7 +384,7 @@ class SecurityFirewallRuleArgs:
     @pulumi.getter
     def ports(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[int]]]]:
         """
-        Custom ports between 0 - 65554
+        Custom ports to be opened
         """
         return pulumi.get(self, "ports")
 
@@ -245,7 +396,7 @@ class SecurityFirewallRuleArgs:
     @pulumi.getter
     def services(self) -> Optional[pulumi.Input[Sequence[pulumi.Input[str]]]]:
         """
-        Pre-defined services 'AMQP', 'AMQPS', 'HTTPS', 'MQTT', 'MQTTS', 'STOMP', 'STOMPS', 'STREAM', 'STREAM_SSL'
+        Pre-defined service ports, see table below
         """
         return pulumi.get(self, "services")
 

{pulumi_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/pulumi_cloudamqp/_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_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/pulumi_cloudamqp/account_action.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__ = ['AccountActionArgs', 'AccountAction']

{pulumi_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/pulumi_cloudamqp/alarm.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__ = ['AlarmArgs', 'Alarm']
@@ -409,68 +414,6 @@ class Alarm(pulumi.CustomResource):
                  vhost_regex: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
-        This resource allows you to create and manage alarms to trigger based on a set of conditions. Once triggerd a notification will be sent to the assigned recipients. When creating a new instance, there will also be a set of default alarms (cpu, memory and disk) created. All default alarms uses the default recipient for notifications.
-
-        By setting `no_default_alarms` to *true* in `Instance`. This will create the instance without default alarms and avoid the need to import them to get full control.
-
-        Available for all subscription plans, but `lemur`and `tiger`are limited to fewer alarm types. The limited types supported can be seen in the table below in Alarm Type Reference.
-
-        ## Example Usage
-
-        ```python
-        import pulumi
-        import pulumi_cloudamqp as cloudamqp
-
-        # New recipient
-        recipient01 = cloudamqp.Notification("recipient01",
-            instance_id=cloudamqp_instance["instance"]["id"],
-            type="email",
-            value="alarm@example.com")
-        # New cpu alarm
-        cpu_alarm = cloudamqp.Alarm("cpuAlarm",
-            instance_id=cloudamqp_instance["instance"]["id"],
-            type="cpu",
-            enabled=True,
-            reminder_interval=600,
-            value_threshold=95,
-            time_threshold=600,
-            recipients=[recipient01.id])
-        # New memory alarm
-        memory_alarm = cloudamqp.Alarm("memoryAlarm",
-            instance_id=cloudamqp_instance["instance"]["id"],
-            type="memory",
-            enabled=True,
-            reminder_interval=600,
-            value_threshold=95,
-            time_threshold=600,
-            recipients=[recipient01.id])
-        ```
-        ## Alarm Type reference
-
-        Supported alarm types: `cpu, memory, disk, queue, connection, flow, consumer, netsplit, server_unreachable, notice`
-
-        Required arguments for all alarms: `instance_id, type, enabled`<br>
-        Optional argument for all alarms: `tags, queue_regex, vhost_regex`
-
-        | Name | Type | Shared | Dedicated | Required arguments |
-        | ---- | ---- | ---- | ---- | ---- |
-        | CPU | cpu | - | &#10004; | time_threshold, value_threshold |
-        | Memory | memory | - | &#10004;  | time_threshold, value_threshold |
-        | Disk space | disk | - | &#10004;  | time_threshold, value_threshold |
-        | Queue | queue | &#10004;  | &#10004; | time_threshold, value_threshold, queue_regex, vhost_regex, message_type |
-        | Connection | connection | &#10004; | &#10004; | time_threshold, value_threshold |
-        | Connection flow | flow | &#10004; | &#10004; | time_threshold, value_threshold |
-        | Consumer | consumer | &#10004; | &#10004; | time_threshold, value_threshold, queue, vhost |
-        | Netsplit | netsplit | - | &#10004; | time_threshold |
-        | Server unreachable | server_unreachable  | - | &#10004;  | time_threshold |
-        | Notice | notice | &#10004; | &#10004; | |
-
-        > Notice alarm is manadatory! Only one can exists and cannot be deleted. Setting `no_default_alarm` to true, will still create this alarm.
-
-        ## Dependency
-
-        This resource depends on CloudAMQP instance identifier, `cloudamqp_instance.instance.id`.
-
         ## Import
 
         `cloudamqp_alarm` can be imported using CloudAMQP internal identifier of the alarm together (CSV separated) with the instance identifier. To retrieve the alarm identifier, use [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html#list-alarms)
@@ -504,68 +447,6 @@ class Alarm(pulumi.CustomResource):
                  args: AlarmArgs,
                  opts: Optional[pulumi.ResourceOptions] = None):
         """
-        This resource allows you to create and manage alarms to trigger based on a set of conditions. Once triggerd a notification will be sent to the assigned recipients. When creating a new instance, there will also be a set of default alarms (cpu, memory and disk) created. All default alarms uses the default recipient for notifications.
-
-        By setting `no_default_alarms` to *true* in `Instance`. This will create the instance without default alarms and avoid the need to import them to get full control.
-
-        Available for all subscription plans, but `lemur`and `tiger`are limited to fewer alarm types. The limited types supported can be seen in the table below in Alarm Type Reference.
-
-        ## Example Usage
-
-        ```python
-        import pulumi
-        import pulumi_cloudamqp as cloudamqp
-
-        # New recipient
-        recipient01 = cloudamqp.Notification("recipient01",
-            instance_id=cloudamqp_instance["instance"]["id"],
-            type="email",
-            value="alarm@example.com")
-        # New cpu alarm
-        cpu_alarm = cloudamqp.Alarm("cpuAlarm",
-            instance_id=cloudamqp_instance["instance"]["id"],
-            type="cpu",
-            enabled=True,
-            reminder_interval=600,
-            value_threshold=95,
-            time_threshold=600,
-            recipients=[recipient01.id])
-        # New memory alarm
-        memory_alarm = cloudamqp.Alarm("memoryAlarm",
-            instance_id=cloudamqp_instance["instance"]["id"],
-            type="memory",
-            enabled=True,
-            reminder_interval=600,
-            value_threshold=95,
-            time_threshold=600,
-            recipients=[recipient01.id])
-        ```
-        ## Alarm Type reference
-
-        Supported alarm types: `cpu, memory, disk, queue, connection, flow, consumer, netsplit, server_unreachable, notice`
-
-        Required arguments for all alarms: `instance_id, type, enabled`<br>
-        Optional argument for all alarms: `tags, queue_regex, vhost_regex`
-
-        | Name | Type | Shared | Dedicated | Required arguments |
-        | ---- | ---- | ---- | ---- | ---- |
-        | CPU | cpu | - | &#10004; | time_threshold, value_threshold |
-        | Memory | memory | - | &#10004;  | time_threshold, value_threshold |
-        | Disk space | disk | - | &#10004;  | time_threshold, value_threshold |
-        | Queue | queue | &#10004;  | &#10004; | time_threshold, value_threshold, queue_regex, vhost_regex, message_type |
-        | Connection | connection | &#10004; | &#10004; | time_threshold, value_threshold |
-        | Connection flow | flow | &#10004; | &#10004; | time_threshold, value_threshold |
-        | Consumer | consumer | &#10004; | &#10004; | time_threshold, value_threshold, queue, vhost |
-        | Netsplit | netsplit | - | &#10004; | time_threshold |
-        | Server unreachable | server_unreachable  | - | &#10004;  | time_threshold |
-        | Notice | notice | &#10004; | &#10004; | |
-
-        > Notice alarm is manadatory! Only one can exists and cannot be deleted. Setting `no_default_alarm` to true, will still create this alarm.
-
-        ## Dependency
-
-        This resource depends on CloudAMQP instance identifier, `cloudamqp_instance.instance.id`.
-
         ## Import
 
         `cloudamqp_alarm` can be imported using CloudAMQP internal identifier of the alarm together (CSV separated) with the instance identifier. To retrieve the alarm identifier, use [CloudAMQP API](https://docs.cloudamqp.com/cloudamqp_api.html#list-alarms)

{pulumi_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/pulumi_cloudamqp/config/__init__.pyi

@@ -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
 
 apikey: Optional[str]

{pulumi_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/pulumi_cloudamqp/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
 
 import types

{pulumi_cloudamqp-3.18.0a1709359306 → pulumi_cloudamqp-3.21.0a1736832130}/pulumi_cloudamqp/custom_domain.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__ = ['CustomDomainArgs', 'CustomDomain']
@@ -115,9 +120,10 @@ class CustomDomain(pulumi.CustomResource):
         import pulumi_cloudamqp as cloudamqp
 
         settings = cloudamqp.CustomDomain("settings",
-            instance_id=cloudamqp_instance["instance"]["id"],
+            instance_id=instance["id"],
             hostname="myname.mydomain")
         ```
+
         ## Depedency
 
         This resource depends on CloudAMQP instance identifier, `cloudamqp_instance.instance.id`.
@@ -161,9 +167,10 @@ class CustomDomain(pulumi.CustomResource):
         import pulumi_cloudamqp as cloudamqp
 
         settings = cloudamqp.CustomDomain("settings",
-            instance_id=cloudamqp_instance["instance"]["id"],
+            instance_id=instance["id"],
             hostname="myname.mydomain")
         ```
+
         ## Depedency
 
         This resource depends on CloudAMQP instance identifier, `cloudamqp_instance.instance.id`.