Optimized safe logic

filter_plugins/safe.py

@@ -0,0 +1,55 @@
+from jinja2 import Undefined
+
+
+def safe_placeholders(template: str, mapping: dict = None) -> str:
+    """
+    Format a template like "{url}/logo.png".
+    If mapping is provided (not None) and ANY placeholder is missing or maps to None/empty string, the function will raise KeyError.
+    If mapping is None, missing placeholders or invalid templates return empty string.
+    Numerical zero or False are considered valid values.
+    Any other formatting errors return an empty string.
+    """
+    # Non-string templates yield empty
+    if not isinstance(template, str):
+        return ''
+
+    class SafeDict(dict):
+        def __getitem__(self, key):
+            val = super().get(key, None)
+            # Treat None or empty string as missing
+            if val is None or (isinstance(val, str) and val == ''):
+                raise KeyError(key)
+            return val
+        def __missing__(self, key):
+            raise KeyError(key)
+
+    silent = mapping is None
+    data = mapping or {}
+    try:
+        return template.format_map(SafeDict(data))
+    except KeyError:
+        if silent:
+            return ''
+        raise
+    except Exception:
+        return ''
+
+def safe_var(value):
+    """
+    Ansible filter: returns the value unchanged unless it's Undefined or None,
+    in which case returns an empty string.
+    Catches all exceptions and yields ''.
+    """
+    try:
+        if isinstance(value, Undefined) or value is None:
+            return ''
+        return value
+    except Exception:
+        return ''
+
+class FilterModule(object):
+    def filters(self):
+        return {
+            'safe_var': safe_var,
+            'safe_placeholders': safe_placeholders,
+        }

filter_plugins/safe_var.py

@@ -1,27 +0,0 @@
-# file: filter_plugins/safe_var.py
-
-from jinja2 import Undefined
-
-def safe_var(value):
-    """
-    Returns the original value unless it is None or Jinja2‐Undefined.
-    Catches all exceptions and returns an empty string on error.
-    """
-    try:
-        # If the value is an Undefined from Jinja2, treat it as missing
-        if isinstance(value, Undefined):
-            return ''
-        # Treat None as missing as well
-        if value is None:
-            return ''
-        # Otherwise return the actual value
-        return value
-    except Exception:
-        # Catch any other errors and return empty string
-        return ''
-
-class FilterModule(object):
-    def filters(self):
-        return {
-            'safe_var': safe_var
-        }