promptev 0.0.1__tar.gz

promptev-0.0.1/LICENSE

@@ -0,0 +1,20 @@
+Promptev SDK License
+
+Copyright © 2025 Promptev Inc.
+
+This software is proprietary and protected under applicable copyright laws.
+By using this software, you agree to the following:
+
+1. You may use this SDK:
+   - Free of charge on the Free Tier of Promptev services
+   - For evaluation or development purposes
+   - In production only with an active Promptev subscription
+
+2. Restrictions:
+   - You may NOT sublicense, distribute, or reverse-engineer this software
+   - You may NOT modify or resell this SDK or derivative works
+   - You may NOT use this SDK outside the Promptev API without a license
+
+3. The SDK is provided “AS IS” without warranties. Promptev Inc. shall not be held liable for any damages.
+
+By using this software, you accept these terms. For licensing inquiries or enterprise use, contact support@promptev.ai.

promptev-0.0.1/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: promptev
+Version: 0.0.1
+Summary: Promptev SDK for accessing Promptev API
+Author-email: Promptev Inc <support@promptev.ai>
+License: Promptev SDK License
+        
+        Copyright © 2025 Promptev Inc.
+        
+        This software is proprietary and protected under applicable copyright laws.
+        By using this software, you agree to the following:
+        
+        1. You may use this SDK:
+           - Free of charge on the Free Tier of Promptev services
+           - For evaluation or development purposes
+           - In production only with an active Promptev subscription
+        
+        2. Restrictions:
+           - You may NOT sublicense, distribute, or reverse-engineer this software
+           - You may NOT modify or resell this SDK or derivative works
+           - You may NOT use this SDK outside the Promptev API without a license
+        
+        3. The SDK is provided “AS IS” without warranties. Promptev Inc. shall not be held liable for any damages.
+        
+        By using this software, you accept these terms. For licensing inquiries or enterprise use, contact support@promptev.ai.
+        
+Project-URL: Homepage, https://promptev.ai
+Keywords: Promptev,promptev,prompts,api,client,sdk,ai,promptDev,promptdev,promptops,python
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Provides-Extra: cache
+Requires-Dist: cachetools>=5.3.0; extra == "cache"
+Dynamic: license-file
+
+# promptev-client
+
+A lightweight Python SDK to securely fetch and format prompts from [Promptev.ai](https://promptev.ai) using your project API key.
+
+---
+
+## Installation
+
+```bash
+pip install promptev
+```
+
+> Optional (recommended for production caching and background refresh):
+```bash
+pip install cachetools
+```
+
+---
+
+## What is Promptev?
+
+[Promptev](https://promptev.ai) helps teams manage, version, and collaborate on AI prompts at scale — with variables, live context packs, histories, cost estimation, and SDK access.
+
+---
+
+## Usage
+
+### 1. Initialize the client
+
+```python
+from promptev import PromptevClient
+
+client = PromptevClient(project_key="pv_sk_abc123yourkey")
+```
+
+---
+
+### 2. Fetch a prompt with variables
+
+```python
+output = client.get_prompt("onboarding-email", {
+    "name": "Ava",
+    "product": "Promptev"
+})
+
+print(output)
+# Output: "Subject: Welcome, Ava! Hey Ava, Thanks for joining Promptev..."
+```
+
+---
+
+### 3. Fetch a prompt without variables
+
+```python
+output = client.get_prompt("static-welcome")
+print(output)
+# Output: "You are a helpful AI assistant ready to support the user."
+```
+
+> ⚠️ If the prompt has no variables, you can omit the second argument.
+
+---
+
+### 4. Async Usage (e.g. in FastAPI or notebooks)
+
+```python
+import asyncio
+
+async def run():
+    prompt = await client.aget_prompt("faq-response", {
+        "question": "How do I reset my password?"
+    })
+    print(prompt)
+
+asyncio.run(run())
+```
+
+---
+
+## Example: Use with LLM APIs
+
+### OpenAI
+
+```python
+from openai import OpenAI
+
+client = OpenAI(api_key="sk-...")
+
+prompt = promptev_client.get_prompt("explain-topic", {
+    "topic": "Prompt Engineering"
+})
+
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": prompt}]
+)
+
+print(response.choices[0].message.content)
+```
+
+---
+
+## Features
+
+- ✅ Supports prompts with or without variables
+- 🔁 Smart caching (via `dict` or `TTLCache`)
+- 🧠 Built-in variable formatting & validation
+- ⚡ Sync + Async compatible
+- 🔐 Works with any LLM (OpenAI, Claude, Gemini, etc.)
+- 🔌 BYOK + airgapped environment ready
+
+---
+
+## Error Handling
+
+```python
+# ❌ Missing required variable
+client.get_prompt("onboarding-email", { "name": "Leo" })
+# ➜ ValueError: Missing required variables: product
+```
+
+---
+
+## Prompt Template Example
+
+```text
+Subject: Welcome, {{ name }}!
+
+Hey {{ name }},
+
+Thanks for joining {{ product }}. We're thrilled to have you on board!
+```
+
+---
+
+## License
+
+This SDK is **commercial software** by Promptev Inc.
+
+By using this package, you agree to the terms in [`LICENSE.txt`](./LICENSE.txt).
+
+- ✅ Free tier use allowed
+- 🚫 Production usage requires a subscription
+
+---
+
+## Contact
+
+- 🌐 [https://promptev.ai](https://promptev.ai)
+- 📧 support@promptev.ai

promptev-0.0.1/README.md

@@ -0,0 +1,150 @@
+# promptev-client
+
+A lightweight Python SDK to securely fetch and format prompts from [Promptev.ai](https://promptev.ai) using your project API key.
+
+---
+
+## Installation
+
+```bash
+pip install promptev
+```
+
+> Optional (recommended for production caching and background refresh):
+```bash
+pip install cachetools
+```
+
+---
+
+## What is Promptev?
+
+[Promptev](https://promptev.ai) helps teams manage, version, and collaborate on AI prompts at scale — with variables, live context packs, histories, cost estimation, and SDK access.
+
+---
+
+## Usage
+
+### 1. Initialize the client
+
+```python
+from promptev import PromptevClient
+
+client = PromptevClient(project_key="pv_sk_abc123yourkey")
+```
+
+---
+
+### 2. Fetch a prompt with variables
+
+```python
+output = client.get_prompt("onboarding-email", {
+    "name": "Ava",
+    "product": "Promptev"
+})
+
+print(output)
+# Output: "Subject: Welcome, Ava! Hey Ava, Thanks for joining Promptev..."
+```
+
+---
+
+### 3. Fetch a prompt without variables
+
+```python
+output = client.get_prompt("static-welcome")
+print(output)
+# Output: "You are a helpful AI assistant ready to support the user."
+```
+
+> ⚠️ If the prompt has no variables, you can omit the second argument.
+
+---
+
+### 4. Async Usage (e.g. in FastAPI or notebooks)
+
+```python
+import asyncio
+
+async def run():
+    prompt = await client.aget_prompt("faq-response", {
+        "question": "How do I reset my password?"
+    })
+    print(prompt)
+
+asyncio.run(run())
+```
+
+---
+
+## Example: Use with LLM APIs
+
+### OpenAI
+
+```python
+from openai import OpenAI
+
+client = OpenAI(api_key="sk-...")
+
+prompt = promptev_client.get_prompt("explain-topic", {
+    "topic": "Prompt Engineering"
+})
+
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": prompt}]
+)
+
+print(response.choices[0].message.content)
+```
+
+---
+
+## Features
+
+- ✅ Supports prompts with or without variables
+- 🔁 Smart caching (via `dict` or `TTLCache`)
+- 🧠 Built-in variable formatting & validation
+- ⚡ Sync + Async compatible
+- 🔐 Works with any LLM (OpenAI, Claude, Gemini, etc.)
+- 🔌 BYOK + airgapped environment ready
+
+---
+
+## Error Handling
+
+```python
+# ❌ Missing required variable
+client.get_prompt("onboarding-email", { "name": "Leo" })
+# ➜ ValueError: Missing required variables: product
+```
+
+---
+
+## Prompt Template Example
+
+```text
+Subject: Welcome, {{ name }}!
+
+Hey {{ name }},
+
+Thanks for joining {{ product }}. We're thrilled to have you on board!
+```
+
+---
+
+## License
+
+This SDK is **commercial software** by Promptev Inc.
+
+By using this package, you agree to the terms in [`LICENSE.txt`](./LICENSE.txt).
+
+- ✅ Free tier use allowed
+- 🚫 Production usage requires a subscription
+
+---
+
+## Contact
+
+- 🌐 [https://promptev.ai](https://promptev.ai)
+- 📧 support@promptev.ai

promptev-0.0.1/pyproject.toml

@@ -0,0 +1,43 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "promptev"
+version = "0.0.1"
+description = "Promptev SDK for accessing Promptev API"
+readme = "README.md"
+license = { file = "LICENSE" }
+authors = [
+  { name = "Promptev Inc", email = "support@promptev.ai" }
+]
+"keywords" = [
+    "Promptev",
+    "promptev",
+    "prompts",
+    "api",
+    "client",
+    "sdk",
+    "ai",
+    "promptDev",
+    "promptdev",
+    "promptops",
+    "python"
+  ]
+requires-python = ">=3.7"
+
+dependencies = [
+  "httpx",
+]
+
+[project.optional-dependencies]
+cache = ["cachetools>=5.3.0"]
+
+[project.urls]
+Homepage = "https://promptev.ai"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

promptev-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

promptev-0.0.1/src/promptev/__init__.py

@@ -0,0 +1 @@
+from .client import PromptevClient

promptev-0.0.1/src/promptev/client.py

@@ -0,0 +1,111 @@
+from typing import Dict, Optional, List
+from dataclasses import dataclass
+import threading
+import time
+import httpx
+
+try:
+    from cachetools import TTLCache
+except ImportError:
+    TTLCache = None
+
+
+@dataclass
+class Prompt:
+    prompt: str
+    variables: List[str]
+
+    def format(self, values: Optional[Dict[str, str]] = None) -> str:
+        formatted = self.prompt
+        if values is None:
+            values = {}
+
+        required = self.variables or []
+        if not required:
+            return formatted
+
+        missing = [v for v in required if v not in values]
+        if missing:
+            raise ValueError(f"Missing required variables: {', '.join(missing)}")
+
+        for key, val in values.items():
+            formatted = formatted.replace(f"{{{{{key}}}}}", str(val))
+
+        return formatted
+
+
+class PromptevClient:
+    def __init__(
+        self,
+        project_key: str,
+        base_url: str = "https://api.promptev.ai",
+        refresh_interval: int = 30
+    ):
+        self.project_key = project_key
+        self.base_url = base_url.rstrip("/")
+        self.refresh_interval = refresh_interval
+        self.is_ready = False
+        self._stop_event = threading.Event()
+        self._thread: Optional[threading.Thread] = None
+
+        self.prompt_cache: Dict[str, Prompt] = {}
+        if TTLCache:
+            self.prompt_cache = TTLCache(maxsize=1000, ttl=3600)
+
+        self._start_background_refresh()
+        self.is_ready = True
+
+    def _start_background_refresh(self):
+        def _loop():
+            while not self._stop_event.is_set():
+                time.sleep(self.refresh_interval)
+                # Future: Add cache refresh logic
+        self._thread = threading.Thread(target=_loop, daemon=True)
+        self._thread.start()
+
+    def dispose(self):
+        self._stop_event.set()
+        if self._thread:
+            self._thread.join()
+        if hasattr(self.prompt_cache, "clear"):
+            self.prompt_cache.clear()
+
+    def _fetch_prompt_sync(self, prompt_key: str) -> Prompt:
+        url = f"{self.base_url}/api/sdk/v1/prompt/client/{self.project_key}/{prompt_key}"
+        with httpx.Client() as client:
+            response = client.get(url)
+            response.raise_for_status()
+            data = response.json()
+
+        variables = data.get("variables", [])
+        if isinstance(variables, str):
+            variables = [v.strip() for v in variables.split(",") if v.strip()]
+        return Prompt(prompt=data["prompt"], variables=variables)
+
+    def get_prompt(self, prompt_key: str, values: Optional[Dict[str, str]] = None) -> str:
+        if prompt_key in self.prompt_cache:
+            prompt = self.prompt_cache[prompt_key]
+            return prompt.format(values) if prompt.variables else prompt.prompt
+
+        prompt = self._fetch_prompt_sync(prompt_key)
+        self.prompt_cache[prompt_key] = prompt
+        return prompt.format(values) if prompt.variables else prompt.prompt
+
+    async def aget_prompt(self, prompt_key: str, values: Optional[Dict[str, str]] = None) -> str:
+        if prompt_key in self.prompt_cache:
+            prompt = self.prompt_cache[prompt_key]
+            return prompt.format(values) if prompt.variables else prompt.prompt
+
+        url = f"{self.base_url}/api/sdk/v1/prompt/client/{self.project_key}/{prompt_key}"
+        async with httpx.AsyncClient() as client:
+            response = await client.get(url)
+            response.raise_for_status()
+            data = response.json()
+
+        variables = data.get("variables", [])
+        if isinstance(variables, str):
+            variables = [v.strip() for v in variables.split(",") if v.strip()]
+        prompt = Prompt(prompt=data["prompt"], variables=variables)
+        self.prompt_cache[prompt_key] = prompt
+        return prompt.format(values) if prompt.variables else prompt.prompt
+

promptev-0.0.1/src/promptev.egg-info/PKG-INFO

@@ -0,0 +1,186 @@
+Metadata-Version: 2.4
+Name: promptev
+Version: 0.0.1
+Summary: Promptev SDK for accessing Promptev API
+Author-email: Promptev Inc <support@promptev.ai>
+License: Promptev SDK License
+        
+        Copyright © 2025 Promptev Inc.
+        
+        This software is proprietary and protected under applicable copyright laws.
+        By using this software, you agree to the following:
+        
+        1. You may use this SDK:
+           - Free of charge on the Free Tier of Promptev services
+           - For evaluation or development purposes
+           - In production only with an active Promptev subscription
+        
+        2. Restrictions:
+           - You may NOT sublicense, distribute, or reverse-engineer this software
+           - You may NOT modify or resell this SDK or derivative works
+           - You may NOT use this SDK outside the Promptev API without a license
+        
+        3. The SDK is provided “AS IS” without warranties. Promptev Inc. shall not be held liable for any damages.
+        
+        By using this software, you accept these terms. For licensing inquiries or enterprise use, contact support@promptev.ai.
+        
+Project-URL: Homepage, https://promptev.ai
+Keywords: Promptev,promptev,prompts,api,client,sdk,ai,promptDev,promptdev,promptops,python
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx
+Provides-Extra: cache
+Requires-Dist: cachetools>=5.3.0; extra == "cache"
+Dynamic: license-file
+
+# promptev-client
+
+A lightweight Python SDK to securely fetch and format prompts from [Promptev.ai](https://promptev.ai) using your project API key.
+
+---
+
+## Installation
+
+```bash
+pip install promptev
+```
+
+> Optional (recommended for production caching and background refresh):
+```bash
+pip install cachetools
+```
+
+---
+
+## What is Promptev?
+
+[Promptev](https://promptev.ai) helps teams manage, version, and collaborate on AI prompts at scale — with variables, live context packs, histories, cost estimation, and SDK access.
+
+---
+
+## Usage
+
+### 1. Initialize the client
+
+```python
+from promptev import PromptevClient
+
+client = PromptevClient(project_key="pv_sk_abc123yourkey")
+```
+
+---
+
+### 2. Fetch a prompt with variables
+
+```python
+output = client.get_prompt("onboarding-email", {
+    "name": "Ava",
+    "product": "Promptev"
+})
+
+print(output)
+# Output: "Subject: Welcome, Ava! Hey Ava, Thanks for joining Promptev..."
+```
+
+---
+
+### 3. Fetch a prompt without variables
+
+```python
+output = client.get_prompt("static-welcome")
+print(output)
+# Output: "You are a helpful AI assistant ready to support the user."
+```
+
+> ⚠️ If the prompt has no variables, you can omit the second argument.
+
+---
+
+### 4. Async Usage (e.g. in FastAPI or notebooks)
+
+```python
+import asyncio
+
+async def run():
+    prompt = await client.aget_prompt("faq-response", {
+        "question": "How do I reset my password?"
+    })
+    print(prompt)
+
+asyncio.run(run())
+```
+
+---
+
+## Example: Use with LLM APIs
+
+### OpenAI
+
+```python
+from openai import OpenAI
+
+client = OpenAI(api_key="sk-...")
+
+prompt = promptev_client.get_prompt("explain-topic", {
+    "topic": "Prompt Engineering"
+})
+
+response = client.chat.completions.create(
+    model="gpt-4",
+    messages=[{"role": "user", "content": prompt}]
+)
+
+print(response.choices[0].message.content)
+```
+
+---
+
+## Features
+
+- ✅ Supports prompts with or without variables
+- 🔁 Smart caching (via `dict` or `TTLCache`)
+- 🧠 Built-in variable formatting & validation
+- ⚡ Sync + Async compatible
+- 🔐 Works with any LLM (OpenAI, Claude, Gemini, etc.)
+- 🔌 BYOK + airgapped environment ready
+
+---
+
+## Error Handling
+
+```python
+# ❌ Missing required variable
+client.get_prompt("onboarding-email", { "name": "Leo" })
+# ➜ ValueError: Missing required variables: product
+```
+
+---
+
+## Prompt Template Example
+
+```text
+Subject: Welcome, {{ name }}!
+
+Hey {{ name }},
+
+Thanks for joining {{ product }}. We're thrilled to have you on board!
+```
+
+---
+
+## License
+
+This SDK is **commercial software** by Promptev Inc.
+
+By using this package, you agree to the terms in [`LICENSE.txt`](./LICENSE.txt).
+
+- ✅ Free tier use allowed
+- 🚫 Production usage requires a subscription
+
+---
+
+## Contact
+
+- 🌐 [https://promptev.ai](https://promptev.ai)
+- 📧 support@promptev.ai

promptev-0.0.1/src/promptev.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+pyproject.toml
+src/promptev/__init__.py
+src/promptev/client.py
+src/promptev.egg-info/PKG-INFO
+src/promptev.egg-info/SOURCES.txt
+src/promptev.egg-info/dependency_links.txt
+src/promptev.egg-info/requires.txt
+src/promptev.egg-info/top_level.txt
+test/test_promptev.py

promptev-0.0.1/src/promptev.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

promptev-0.0.1/src/promptev.egg-info/requires.txt

@@ -0,0 +1,4 @@
+httpx
+
+[cache]
+cachetools>=5.3.0

promptev-0.0.1/src/promptev.egg-info/top_level.txt

@@ -0,0 +1 @@
+promptev

promptev-0.0.1/test/test_promptev.py

@@ -0,0 +1,17 @@
+from promptev import PromptevClient
+
+client = PromptevClient(
+    project_key="pl_sk_bkcAkOf4pS_zdCrOeSmz8msunT4IOj_6",  # Replace with your real or test key
+    base_url="http://localhost:8003",       # Pointing to your local server
+    refresh_interval=10                     # Optional: faster refresh during test
+)
+
+# Test a prompt without variables
+# output = client.get_prompt("test-static-prompt")
+# print("Static prompt:", output)
+
+# Test a prompt with variables
+output = client.get_prompt("review-user-prompt", {
+    "user_prompt_text": "How to improve LLM reasoning?"
+})
+print("Formatted prompt:", output)