ai-prompter 0.2.1__tar.gz → 0.2.3__tar.gz

{ai_prompter-0.2.1 → ai_prompter-0.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ai-prompter
-Version: 0.2.1
+Version: 0.2.3
 Summary: A prompt management library using Jinja2 templates to build complex prompts easily.
 Author-email: LUIS NOVO <lfnovo@gmail.com>
 License: MIT

{ai_prompter-0.2.1 → ai_prompter-0.2.3}/notebooks/prompter_usage.ipynb

@@ -77,7 +77,7 @@
     {
      "data": {
       "text/plain": [
-       "'Write an article about AI.'"
+       "'/Users/luisnovo/dev/projetos/ai-prompter/notebooks/prompts/article.jinja'"
       ]
      },
      "execution_count": 3,
@@ -85,6 +85,27 @@
      "output_type": "execute_result"
     }
    ],
+   "source": [
+    "prompter = Prompter(prompt_template=\"article\") #will look for article.jinja in the prompts directory\n",
+    "prompter.template_location(\"article\")"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 4,
+   "metadata": {},
+   "outputs": [
+    {
+     "data": {
+      "text/plain": [
+       "'Write an article about AI.'"
+      ]
+     },
+     "execution_count": 4,
+     "metadata": {},
+     "output_type": "execute_result"
+    }
+   ],
    "source": [
     "prompter = Prompter(prompt_template=\"article\") #will look for article.jinja in the prompts directory\n",
     "\n",
@@ -103,7 +124,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 4,
+   "execution_count": 5,
    "metadata": {},
    "outputs": [
     {
@@ -112,7 +133,7 @@
        "'This is the outer file \\n\\nThis is the inner file\\n\\nValue: a\\n\\n\\n    You selected A\\n\\n\\nThis is the end of the outer file'"
       ]
      },
-     "execution_count": 4,
+     "execution_count": 5,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -136,7 +157,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 5,
+   "execution_count": 6,
    "metadata": {},
    "outputs": [
     {
@@ -145,7 +166,7 @@
        "ChatPromptTemplate(input_variables=['topic'], input_types={}, partial_variables={}, messages=[HumanMessagePromptTemplate(prompt=PromptTemplate(input_variables=['topic'], input_types={}, partial_variables={}, template='Write an article about {{topic}}.', template_format='jinja2'), additional_kwargs={})])"
       ]
      },
-     "execution_count": 5,
+     "execution_count": 6,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -162,7 +183,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 6,
+   "execution_count": 7,
    "metadata": {},
    "outputs": [
     {
@@ -171,7 +192,7 @@
        "ChatPromptTemplate(input_variables=['type'], input_types={}, partial_variables={}, messages=[HumanMessagePromptTemplate(prompt=PromptTemplate(input_variables=['type'], input_types={}, partial_variables={}, template=\"This is the outer file \\n\\nThis is the inner file\\n\\nValue: {{ type }}\\n\\n{% if type == 'a' %}\\n    You selected A\\n{% else %}\\n    You didn't select A\\n{% endif %}\\n\\n\\nThis is the end of the outer file\\n\", template_format='jinja2'), additional_kwargs={})])"
       ]
      },
-     "execution_count": 6,
+     "execution_count": 7,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -184,7 +205,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 7,
+   "execution_count": 8,
    "metadata": {},
    "outputs": [
     {
@@ -193,7 +214,7 @@
        "ChatPromptValue(messages=[HumanMessage(content='This is the outer file \\n\\nThis is the inner file\\n\\nValue: a\\n\\n\\n    You selected A\\n\\n\\n\\nThis is the end of the outer file', additional_kwargs={}, response_metadata={})])"
       ]
      },
-     "execution_count": 7,
+     "execution_count": 8,
      "metadata": {},
      "output_type": "execute_result"
     }

{ai_prompter-0.2.1 → ai_prompter-0.2.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ai-prompter"
-version = "0.2.1"
+version = "0.2.3"
 description = "A prompt management library using Jinja2 templates to build complex prompts easily."
 readme = "README.md"
 homepage = "https://github.com/lfnovo/ai-prompter"

{ai_prompter-0.2.1 → ai_prompter-0.2.3}/src/ai_prompter/__init__.py

@@ -5,7 +5,7 @@ A prompt management module using Jinja to generate complex prompts with simple t
 import os
 from dataclasses import dataclass
 from datetime import datetime
-from typing import Any, Dict, Optional, Union
+from typing import Any, Dict, List, Optional, Union, Callable
 
 from jinja2 import Environment, FileSystemLoader, Template
 from pydantic import BaseModel
@@ -36,27 +36,43 @@ class Prompter:
     template: Optional[Union[str, Template]] = None
     template_text: Optional[str] = None
     parser: Optional[Any] = None
+    text_templates: Optional[Dict[str, str]] = None
+    prompt_folders: Optional[List[str]] = None
 
     def __init__(
         self,
-        prompt_template: Optional[str] = None,
-        model: Optional[Union[str, Any]] = None,
-        template_text: Optional[str] = None,
-        prompt_dir: Optional[str] = None,
+        prompt_template: str | None = None,
+        model: str | Any | None = None,
+        prompt_variation: str = "default",
+        prompt_dir: str | None = None,
+        template_text: str | None = None,
+        parser: Callable[[str], dict[str, Any]] | None = None,
+        *args,
+        **kwargs,
     ) -> None:
         """Initialize the Prompter with a template name, model, and optional custom directory.
 
         Args:
             prompt_template (str, optional): The name of the prompt template (without .jinja extension).
             model (Union[str, Any], optional): The model to use for generation.
-            template_text (str, optional): The raw text of the template.
+            prompt_variation (str, optional): The variation of the prompt template.
             prompt_dir (str, optional): Custom directory to search for templates.
+            template_text (str, optional): The raw text of the template.
+            parser (Callable[[str], dict[str, Any]], optional): The parser to use for generation.
         """
+        if template_text is not None and prompt_template is not None:
+            raise ValueError(
+                "Cannot provide both template_text and prompt_template. Choose one or the other."
+            )
         self.prompt_template = prompt_template
-        self.template = None
+        self.prompt_variation = prompt_variation
+        self.prompt_dir = prompt_dir
         self.template_text = template_text
+        self.parser = parser
+        self.template: Template | None = None
         self.model = model or os.getenv("OPENAI_MODEL", "gpt-4-turbo")
-        self.prompt_dir = prompt_dir
+        self.text_templates = {}
+        self.prompt_folders = []
         self._setup_template(template_text, prompt_dir)
 
     def _setup_template(
@@ -88,9 +104,11 @@ class Prompter:
                 prompt_dirs.append(prompt_path_default)
             env = Environment(loader=FileSystemLoader(prompt_dirs))
             self.template = env.get_template(f"{self.prompt_template}.jinja")
+            self.prompt_folders = prompt_dirs
         else:
             self.template_text = template_text
             self.template = Template(template_text)
+            self.text_templates[self.prompt_template] = template_text
 
     def to_langchain(self):
         # Support for both text-based and file-based templates with LangChain
@@ -175,6 +193,28 @@ class Prompter:
                 "Either prompt_template with a valid template or template_text must be provided for LangChain conversion"
             )
 
+    def template_location(self, template_name: str) -> str:
+        """
+        Returns the location of the template used for the given template name.
+        If the template is a text template (not a file), returns 'text'.
+        If the template is not found, returns 'not found'.
+        
+        Args:
+            template_name (str): The name of the template to check.
+        
+        Returns:
+            str: The file path of the template, or 'text' if it's a text template, or 'not found' if the template doesn't exist.
+        """
+        if template_name in self.text_templates:
+            return 'text'
+        
+        for folder in self.prompt_folders:
+            template_file = os.path.join(folder, f"{template_name}.jinja")
+            if os.path.exists(template_file):
+                return template_file
+        
+        return 'not found'
+
     @classmethod
     def from_text(
         cls, text: str, model: Optional[Union[str, Any]] = None

{ai_prompter-0.2.1 → ai_prompter-0.2.3}/tests/test_prompter.py

@@ -17,10 +17,15 @@ def test_raw_text_template():
 
 
 def test_missing_both_raises():
-    with pytest.raises(ValueError):
+    with pytest.raises(ValueError, match="Either prompt_template or template_text must be provided"):
         Prompter()
 
 
+def test_both_parameters_raises():
+    with pytest.raises(ValueError, match="Cannot provide both"):
+        Prompter(template_text="Hello", prompt_template="template")
+
+
 def test_base_model_data():
     class DataModel(BaseModel):
         foo: str

{ai_prompter-0.2.1 → ai_prompter-0.2.3}/uv.lock

@@ -8,7 +8,7 @@ resolution-markers = [
 
 [[package]]
 name = "ai-prompter"
-version = "0.2.1"
+version = "0.2.3"
 source = { editable = "." }
 dependencies = [
     { name = "jinja2" },