fix docstring

Author: nimarb

langfuse/model.py

@@ -309,7 +309,8 @@ def __init__(self, prompt: Prompt_Chat, is_fallback: bool = False):
     @property
     def prompt(self) -> List[Union[ChatMessageDict, ChatMessagePlaceholderDict]]:
         """Returns the prompt with placeholders substituted for their values.
-        If no placeholders are set and raw_prompt contains placeholders, returns only messages.
+        If no placeholder fill-ins are set and raw_prompt contains placeholders, returns messages and placeholders
+        with a warning.
         """
         compiled_messages = []
         has_unresolved_placeholders = False
@@ -345,8 +346,8 @@ def prompt(self) -> List[Union[ChatMessageDict, ChatMessagePlaceholderDict]]:
                 msg["name"] for msg in self.raw_prompt if msg["type"] == "placeholder"
             ]
             err_unresolved_placeholders = f"Placeholders {unresolved} have no values set. Use update() to set placeholder values."
+            # Warning because users might want to further process placeholders as well
             langfuse_logger.warning(err_unresolved_placeholders)
-            # raise ValueError(err_unresolved_placeholders)
         elif has_unresolved_placeholders:
             unresolved = [
                 msg["name"]
@@ -355,8 +356,8 @@ def prompt(self) -> List[Union[ChatMessageDict, ChatMessagePlaceholderDict]]:
                 and msg["name"] not in self.placeholder_fillins
             ]
             err_unresolved_placeholders = f"Placeholders {unresolved} have no values set. Use update() to set placeholder values."
+            # Warning because users might want to further process placeholders as well
             langfuse_logger.warning(err_unresolved_placeholders)
-            # raise ValueError(err_unresolved_placeholders)
 
         return compiled_messages
 
@@ -374,15 +375,15 @@ def prompt(
                     ChatMessageWithPlaceholdersDict_Placeholder(
                         type="placeholder",
                         name=p.name,
-                    )
+                    ),
                 )
             elif hasattr(p, "role") and hasattr(p, "content"):
                 self.raw_prompt.append(
                     ChatMessageWithPlaceholdersDict_Message(
                         type="message",
                         role=p.role,
                         content=p.content,
-                    )
+                    ),
                 )
 
         self.placeholder_fillins = {}  # Clear because user expects old placeholders not to linger