textprompts 0.0.2__tar.gz → 0.0.3__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: textprompts
-Version: 0.0.2
+Version: 0.0.3
 Summary: Minimal text-based prompt-loader with TOML front-matter
 Keywords: prompts,toml,frontmatter,template
 Author: Jan Siml
@@ -24,6 +24,13 @@ 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**? 
@@ -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,6 +80,8 @@ import textprompts
 
 # Just load it - works with or without metadata
 prompt = textprompts.load_prompt("greeting.txt")
+# Or simply
+alt = textprompts.Prompt("greeting.txt")
 
 # Use it safely - all placeholders must be provided
 message = prompt.prompt.format(
@@ -220,7 +228,6 @@ title = "Product Search Tool"
 version = "2.1.0"
 description = "Search our product catalog"
 ---
-
 {
     "type": "function",
     "function": {
@@ -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.
@@ -320,6 +326,10 @@ Choose the right level of strictness for your use case:
 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-0.0.2 → textprompts-0.0.3}/README.md

@@ -1,5 +1,12 @@
 # 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**? 
@@ -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,6 +56,8 @@ import textprompts
 
 # Just load it - works with or without metadata
 prompt = textprompts.load_prompt("greeting.txt")
+# Or simply
+alt = textprompts.Prompt("greeting.txt")
 
 # Use it safely - all placeholders must be provided
 message = prompt.prompt.format(
@@ -196,7 +204,6 @@ title = "Product Search Tool"
 version = "2.1.0"
 description = "Search our product catalog"
 ---
-
 {
     "type": "function",
     "function": {
@@ -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.
@@ -296,6 +302,10 @@ Choose the right level of strictness for your use case:
 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-0.0.2 → textprompts-0.0.3}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "textprompts"
-version = "0.0.2"
+version = "0.0.3"
 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"]

{textprompts-0.0.2 → textprompts-0.0.3}/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.3}/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.3}/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,23 @@ class Prompt(BaseModel):
     meta: Union[PromptMeta, None]
     prompt: PromptString
 
+    def __init__(
+        self,
+        path: Union[str, Path],
+        meta: Union[PromptMeta, MetadataMode, str, None] = None,
+        prompt: Union[str, PromptString, None] = None,
+    ) -> None:
+        """Initialize Prompt from fields or load from file."""
+        if prompt is None:
+            from .loaders import load_prompt
+
+            loaded = load_prompt(path, meta=meta)
+            super().__init__(**loaded.model_dump())
+        else:
+            if isinstance(prompt, str):
+                prompt = PromptString(prompt)
+            super().__init__(path=Path(path), meta=meta, prompt=prompt)
+
     @field_validator("prompt")
     @classmethod
     def prompt_not_empty(cls, v: str) -> PromptString: