textprompts 0.0.2__tar.gz → 0.0.4__tar.gz

{textprompts-0.0.2 → textprompts-0.0.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: textprompts
-Version: 0.0.2
+Version: 0.0.4
 Summary: Minimal text-based prompt-loader with TOML front-matter
 Keywords: prompts,toml,frontmatter,template
 Author: Jan Siml
@@ -24,9 +24,16 @@ Description-Content-Type: text/markdown
 
 # textprompts
 
+[![PyPI version](https://img.shields.io/pypi/v/textprompts.svg)](https://pypi.org/project/textprompts/)
+[![Python versions](https://img.shields.io/pypi/pyversions/textprompts.svg)](https://pypi.org/project/textprompts/)
+[![CI status](https://github.com/svilupp/textprompts/workflows/CI/badge.svg)](https://github.com/svilupp/textprompts/actions)
+[![Coverage](https://img.shields.io/codecov/c/github/svilupp/textprompts)](https://codecov.io/gh/svilupp/textprompts)
+[![License](https://img.shields.io/pypi/l/textprompts.svg)](https://github.com/svilupp/textprompts/blob/main/LICENSE)
+
+
 > **So simple, it's not even worth vibing about coding yet it just makes so much sense.**
 
-Are you tired of vendors trying to sell you fancy UIs for prompt management that just make your system more confusing and harder to debug? Isn't it nice to just have your prompts **next to your code**? 
+Are you tired of vendors trying to sell you fancy UIs for prompt management that just make your system more confusing and harder to debug? Isn't it nice to just have your prompts **next to your code**?
 
 But then you worry: *Did my formatter change my prompt? Are those spaces at the beginning actually part of the prompt or just indentation?*
 
@@ -35,7 +42,7 @@ But then you worry: *Did my formatter change my prompt? Are those spaces at the
 ## Why textprompts?
 
 - ✅ **Prompts live next to your code** - no external systems to manage
-- ✅ **Git is your version control** - diff, branch, and experiment with ease  
+- ✅ **Git is your version control** - diff, branch, and experiment with ease
 - ✅ **No formatter headaches** - your prompts stay exactly as you wrote them
 - ✅ **Minimal markup** - just TOML front-matter when you need metadata (or no metadata if you prefer!)
 - ✅ **Zero dependencies** - well, almost (just Pydantic)
@@ -59,7 +66,6 @@ title = "Customer Greeting"
 version = "1.0.0"
 description = "Friendly greeting for customer support"
 ---
-
 Hello {customer_name}!
 
 Welcome to {company_name}. We're here to help you with {issue_type}.
@@ -74,11 +80,13 @@ import textprompts
 
 # Just load it - works with or without metadata
 prompt = textprompts.load_prompt("greeting.txt")
+# Or simply
+alt = textprompts.Prompt.from_path("greeting.txt")
 
 # Use it safely - all placeholders must be provided
 message = prompt.prompt.format(
     customer_name="Alice",
-    company_name="ACME Corp", 
+    company_name="ACME Corp",
     issue_type="billing question",
     agent_name="Sarah"
 )
@@ -161,7 +169,7 @@ prompt = textprompts.load_prompt("prompt.txt")  # No metadata parsing
 print(prompt.meta.title)  # "prompt" (from filename)
 
 # 2. ALLOW: Load metadata if present, don't worry if it's incomplete
-textprompts.set_metadata("allow")  # Flexible metadata loading  
+textprompts.set_metadata("allow")  # Flexible metadata loading
 prompt = textprompts.load_prompt("prompt.txt")  # Loads any metadata found
 
 # 3. STRICT: Require complete metadata for production use
@@ -174,7 +182,7 @@ prompt = textprompts.load_prompt("prompt.txt", meta="strict")
 
 **Why this design?**
 - **Default = Simple**: No configuration needed, just load files
-- **Flexible**: Add metadata when you want structure  
+- **Flexible**: Add metadata when you want structure
 - **Production-Safe**: Use strict mode to catch missing metadata before deployment
 
 ## Real-World Examples
@@ -199,7 +207,7 @@ response = openai.chat.completions.create(
             )
         },
         {
-            "role": "user", 
+            "role": "user",
             "content": user_prompt.prompt.format(
                 query="How do I return an item?",
                 customer_tier="premium"
@@ -220,7 +228,6 @@ title = "Product Search Tool"
 version = "2.1.0"
 description = "Search our product catalog"
 ---
-
 {
     "type": "function",
     "function": {
@@ -234,7 +241,7 @@ description = "Search our product catalog"
                     "description": "Search query for products"
                 },
                 "category": {
-                    "type": "string", 
+                    "type": "string",
                     "enum": ["electronics", "clothing", "books"],
                     "description": "Product category to search within"
                 },
@@ -306,7 +313,6 @@ description = "What this prompt does"
 created = "2024-01-15"
 tags = ["customer-support", "greeting"]
 ---
-
 Your prompt content goes here.
 
 Use {variables} for templating.
@@ -317,13 +323,17 @@ Use {variables} for templating.
 Choose the right level of strictness for your use case:
 
 1. **IGNORE** (default) - Simple text file loading, filename becomes title
-2. **ALLOW** - Load metadata if present, don't worry about completeness  
+2. **ALLOW** - Load metadata if present, don't worry about completeness
 3. **STRICT** - Require complete metadata (title, description, version) for production safety
 
+You can also set the environment variable `TEXTPROMPTS_METADATA_MODE` to one of
+`strict`, `allow`, or `ignore` before importing the library to configure the
+default mode.
+
 ```python
 # Set globally
 textprompts.set_metadata("ignore")   # Default: simple file loading
-textprompts.set_metadata("allow")    # Flexible: load any metadata  
+textprompts.set_metadata("allow")    # Flexible: load any metadata
 textprompts.set_metadata("strict")   # Production: require complete metadata
 
 # Or override per prompt
@@ -401,7 +411,7 @@ template = PromptString("Hello {name}, you are {role}")
 result = template.format(name="Alice", role="admin")  # ✅ Works
 result = template.format(name="Alice")  # ❌ Raises ValueError
 
-# Partial formatting - replace only available placeholders  
+# Partial formatting - replace only available placeholders
 partial = template.format(name="Alice", skip_validation=True)  # ✅ "Hello Alice, you are {role}"
 
 # Access placeholder information
@@ -493,4 +503,4 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ---
 
-**textprompts** - Because your prompts deserve better than being buried in code strings. 🚀
+**textprompts** - Because your prompts deserve better than being buried in code strings. 🚀

{textprompts-0.0.2 → textprompts-0.0.4}/README.md

@@ -1,8 +1,15 @@
 # textprompts
 
+[![PyPI version](https://img.shields.io/pypi/v/textprompts.svg)](https://pypi.org/project/textprompts/)
+[![Python versions](https://img.shields.io/pypi/pyversions/textprompts.svg)](https://pypi.org/project/textprompts/)
+[![CI status](https://github.com/svilupp/textprompts/workflows/CI/badge.svg)](https://github.com/svilupp/textprompts/actions)
+[![Coverage](https://img.shields.io/codecov/c/github/svilupp/textprompts)](https://codecov.io/gh/svilupp/textprompts)
+[![License](https://img.shields.io/pypi/l/textprompts.svg)](https://github.com/svilupp/textprompts/blob/main/LICENSE)
+
+
 > **So simple, it's not even worth vibing about coding yet it just makes so much sense.**
 
-Are you tired of vendors trying to sell you fancy UIs for prompt management that just make your system more confusing and harder to debug? Isn't it nice to just have your prompts **next to your code**? 
+Are you tired of vendors trying to sell you fancy UIs for prompt management that just make your system more confusing and harder to debug? Isn't it nice to just have your prompts **next to your code**?
 
 But then you worry: *Did my formatter change my prompt? Are those spaces at the beginning actually part of the prompt or just indentation?*
 
@@ -11,7 +18,7 @@ But then you worry: *Did my formatter change my prompt? Are those spaces at the
 ## Why textprompts?
 
 - ✅ **Prompts live next to your code** - no external systems to manage
-- ✅ **Git is your version control** - diff, branch, and experiment with ease  
+- ✅ **Git is your version control** - diff, branch, and experiment with ease
 - ✅ **No formatter headaches** - your prompts stay exactly as you wrote them
 - ✅ **Minimal markup** - just TOML front-matter when you need metadata (or no metadata if you prefer!)
 - ✅ **Zero dependencies** - well, almost (just Pydantic)
@@ -35,7 +42,6 @@ title = "Customer Greeting"
 version = "1.0.0"
 description = "Friendly greeting for customer support"
 ---
-
 Hello {customer_name}!
 
 Welcome to {company_name}. We're here to help you with {issue_type}.
@@ -50,11 +56,13 @@ import textprompts
 
 # Just load it - works with or without metadata
 prompt = textprompts.load_prompt("greeting.txt")
+# Or simply
+alt = textprompts.Prompt.from_path("greeting.txt")
 
 # Use it safely - all placeholders must be provided
 message = prompt.prompt.format(
     customer_name="Alice",
-    company_name="ACME Corp", 
+    company_name="ACME Corp",
     issue_type="billing question",
     agent_name="Sarah"
 )
@@ -137,7 +145,7 @@ prompt = textprompts.load_prompt("prompt.txt")  # No metadata parsing
 print(prompt.meta.title)  # "prompt" (from filename)
 
 # 2. ALLOW: Load metadata if present, don't worry if it's incomplete
-textprompts.set_metadata("allow")  # Flexible metadata loading  
+textprompts.set_metadata("allow")  # Flexible metadata loading
 prompt = textprompts.load_prompt("prompt.txt")  # Loads any metadata found
 
 # 3. STRICT: Require complete metadata for production use
@@ -150,7 +158,7 @@ prompt = textprompts.load_prompt("prompt.txt", meta="strict")
 
 **Why this design?**
 - **Default = Simple**: No configuration needed, just load files
-- **Flexible**: Add metadata when you want structure  
+- **Flexible**: Add metadata when you want structure
 - **Production-Safe**: Use strict mode to catch missing metadata before deployment
 
 ## Real-World Examples
@@ -175,7 +183,7 @@ response = openai.chat.completions.create(
             )
         },
         {
-            "role": "user", 
+            "role": "user",
             "content": user_prompt.prompt.format(
                 query="How do I return an item?",
                 customer_tier="premium"
@@ -196,7 +204,6 @@ title = "Product Search Tool"
 version = "2.1.0"
 description = "Search our product catalog"
 ---
-
 {
     "type": "function",
     "function": {
@@ -210,7 +217,7 @@ description = "Search our product catalog"
                     "description": "Search query for products"
                 },
                 "category": {
-                    "type": "string", 
+                    "type": "string",
                     "enum": ["electronics", "clothing", "books"],
                     "description": "Product category to search within"
                 },
@@ -282,7 +289,6 @@ description = "What this prompt does"
 created = "2024-01-15"
 tags = ["customer-support", "greeting"]
 ---
-
 Your prompt content goes here.
 
 Use {variables} for templating.
@@ -293,13 +299,17 @@ Use {variables} for templating.
 Choose the right level of strictness for your use case:
 
 1. **IGNORE** (default) - Simple text file loading, filename becomes title
-2. **ALLOW** - Load metadata if present, don't worry about completeness  
+2. **ALLOW** - Load metadata if present, don't worry about completeness
 3. **STRICT** - Require complete metadata (title, description, version) for production safety
 
+You can also set the environment variable `TEXTPROMPTS_METADATA_MODE` to one of
+`strict`, `allow`, or `ignore` before importing the library to configure the
+default mode.
+
 ```python
 # Set globally
 textprompts.set_metadata("ignore")   # Default: simple file loading
-textprompts.set_metadata("allow")    # Flexible: load any metadata  
+textprompts.set_metadata("allow")    # Flexible: load any metadata
 textprompts.set_metadata("strict")   # Production: require complete metadata
 
 # Or override per prompt
@@ -377,7 +387,7 @@ template = PromptString("Hello {name}, you are {role}")
 result = template.format(name="Alice", role="admin")  # ✅ Works
 result = template.format(name="Alice")  # ❌ Raises ValueError
 
-# Partial formatting - replace only available placeholders  
+# Partial formatting - replace only available placeholders
 partial = template.format(name="Alice", skip_validation=True)  # ✅ "Hello Alice, you are {role}"
 
 # Access placeholder information
@@ -469,4 +479,4 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ---
 
-**textprompts** - Because your prompts deserve better than being buried in code strings. 🚀
+**textprompts** - Because your prompts deserve better than being buried in code strings. 🚀

{textprompts-0.0.2 → textprompts-0.0.4}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "textprompts"
-version = "0.0.2"
+version = "0.0.4"
 description = "Minimal text-based prompt-loader with TOML front-matter"
 readme = "README.md"
 license = "MIT"
@@ -38,6 +38,9 @@ dev = [
     "ruff>=0.12.2",
     "pre-commit>=3.0.0",
 ]
+test = [
+    "pydantic-ai>=0.4.5",
+]
 
 [build-system]
 requires = ["uv_build>=0.7.19,<0.8.0"]
@@ -57,6 +60,7 @@ ignore = ["E501"]  # Ignore line length
 [tool.mypy]
 python_version = "3.11"
 strict = true
+mypy_path = "src"
 
 [tool.pytest.ini_options]
 testpaths = ["tests"]

{textprompts-0.0.2 → textprompts-0.0.4}/src/textprompts/_parser.py

@@ -71,8 +71,12 @@ def parse_file(path: Path, *, metadata_mode: MetadataMode) -> Prompt:
                 stacklevel=2,
             )
         ignore_meta = PromptMeta(title=path.stem)
-        return Prompt(
-            path=path, meta=ignore_meta, prompt=PromptString(textwrap.dedent(raw))
+        return Prompt.model_validate(
+            {
+                "path": path,
+                "meta": ignore_meta,
+                "prompt": PromptString(textwrap.dedent(raw)),
+            }
         )
 
     # For STRICT and ALLOW modes, try to parse front matter
@@ -149,4 +153,10 @@ def parse_file(path: Path, *, metadata_mode: MetadataMode) -> Prompt:
     if meta.title is None:
         meta.title = path.stem
 
-    return Prompt(path=path, meta=meta, prompt=PromptString(textwrap.dedent(body)))
+    return Prompt.model_validate(
+        {
+            "path": path,
+            "meta": meta,
+            "prompt": PromptString(textwrap.dedent(body)),
+        }
+    )

{textprompts-0.0.2 → textprompts-0.0.4}/src/textprompts/config.py

@@ -2,6 +2,7 @@
 Global configuration for textprompts metadata handling.
 """
 
+import os
 from enum import Enum
 from typing import Union
 
@@ -29,7 +30,13 @@ class MetadataMode(Enum):
 
 
 # Global configuration variable
-_METADATA_MODE: MetadataMode = MetadataMode.IGNORE
+_env_mode = os.getenv("TEXTPROMPTS_METADATA_MODE")
+try:
+    _METADATA_MODE: MetadataMode = (
+        MetadataMode(_env_mode.lower()) if _env_mode else MetadataMode.IGNORE
+    )
+except ValueError:
+    _METADATA_MODE = MetadataMode.IGNORE
 _WARN_ON_IGNORED_META: bool = True
 
 

{textprompts-0.0.2 → textprompts-0.0.4}/src/textprompts/models.py

@@ -4,6 +4,7 @@ from typing import Any, Union
 
 from pydantic import BaseModel, Field, field_validator
 
+from .config import MetadataMode
 from .prompt_string import PromptString
 
 
@@ -20,6 +21,15 @@ class Prompt(BaseModel):
     meta: Union[PromptMeta, None]
     prompt: PromptString
 
+    @classmethod
+    def from_path(
+        cls, path: Union[str, Path], *, meta: Union[MetadataMode, str, None] = None
+    ) -> "Prompt":
+        """Load a Prompt from ``path`` using ``load_prompt``."""
+        from .loaders import load_prompt
+
+        return load_prompt(path, meta=meta)
+
     @field_validator("prompt")
     @classmethod
     def prompt_not_empty(cls, v: str) -> PromptString: