langwatch 0.2.11__tar.gz → 0.2.13__tar.gz

{langwatch-0.2.11 → langwatch-0.2.13}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: langwatch
-Version: 0.2.11
+Version: 0.2.13
 Summary: LangWatch Python SDK, for monitoring your LLMs
 Author-email: Langwatch Engineers <engineering@langwatch.ai>
 License: MIT
@@ -12,8 +12,9 @@ Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: <3.13,>=3.10
+Requires-Python: <3.14,>=3.10
 Requires-Dist: coolname>=2.2.0
 Requires-Dist: deprecated>=1.2.18
 Requires-Dist: dspy-ai<3.0.0,>=2.5.2

{langwatch-0.2.11 → langwatch-0.2.13}/examples/prompt_management_fastapi.py

@@ -53,11 +53,13 @@ def example():
 
     # 2. Get and use the prompt
     print("2. Retrieving the prompt...")
-    retrieved_prompt = langwatch.prompts.get(prompt.handle)
-    print(f"Retrieved prompt: {retrieved_prompt.handle}")
+    retrieved_prompt_specific_version = langwatch.prompts.get(
+        prompt.handle, version_number=prompt.version_number
+    )
+    print(f"Retrieved prompt: {retrieved_prompt_specific_version.version_number}")
 
     # Use the prompt (example usage)
-    print("Using the prompt...")
+    print("Using the created prompt...")
 
     # Compile the prompt with variables
     compiled_prompt = retrieved_prompt.compile(

{langwatch-0.2.11 → langwatch-0.2.13}/pyproject.toml

@@ -1,9 +1,9 @@
 [project]
 name = "langwatch"
-version = "0.2.11" # remember to also update it in src/langwatch/__version__.py
+version = "0.2.13" # remember to also update it in src/langwatch/__version__.py
 description = "LangWatch Python SDK, for monitoring your LLMs"
 authors = [{ name = "Langwatch Engineers", email = "engineering@langwatch.ai" }]
-requires-python = ">=3.10,<3.13"
+requires-python = ">=3.10,<3.14"
 license = { text = "MIT" }
 readme = "README.md"
 classifiers = [
@@ -16,6 +16,7 @@ classifiers = [
     "Programming Language :: Python :: 3.10",
     "Programming Language :: Python :: 3.11",
     "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
     "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 

{langwatch-0.2.11 → langwatch-0.2.13}/src/langwatch/__version__.py

@@ -1,3 +1,3 @@
 """Version information for LangWatch."""
 
-__version__ = "0.2.11"
+__version__ = "0.2.13"

{langwatch-0.2.11 → langwatch-0.2.13}/src/langwatch/prompts/decorators/prompt_service_tracing.py

@@ -1,6 +1,6 @@
 from functools import wraps
 from opentelemetry import trace
-from typing import TYPE_CHECKING, TypeVar, Callable, Any
+from typing import TYPE_CHECKING, Optional, TypeVar, Callable, Any
 import json
 
 from langwatch.attributes import AttributeKey
@@ -10,16 +10,26 @@ if TYPE_CHECKING:
 
 T = TypeVar("T")
 
+# Type alias for the get method with named parameters
+PromptGetMethod = Callable[[T, str, Optional[int]], "Prompt"]
+
 
 class PromptServiceTracing:
     """Namespace for PromptService method tracing decorators"""
 
     @staticmethod
-    def get(func: Callable[[T, str], "Prompt"]) -> Callable[[T, str], "Prompt"]:
-        """Type-safe decorator for PromptService.get method with OpenTelemetry tracing"""
+    def get(func: PromptGetMethod[T]) -> PromptGetMethod[T]:
+        """
+        Type-safe decorator for PromptService.get method with OpenTelemetry tracing
+
+        Expected function signature:
+        def get(self: T, *, prompt_id: str, version_number: Optional[int] = None) -> Prompt
+        """
 
         @wraps(func)
-        def wrapper(self: T, prompt_id: str) -> "Prompt":
+        def wrapper(
+            self: T, prompt_id: str, version_number: Optional[int] = None
+        ) -> "Prompt":
             with trace.get_tracer(__name__).start_as_current_span(
                 PromptServiceTracing._create_span_name("get")
             ) as span:
@@ -34,7 +44,7 @@ class PromptServiceTracing:
                     ),
                 )
                 try:
-                    result = func(self, prompt_id)
+                    result = func(self, prompt_id, version_number)
 
                     span.set_attributes(
                         {

{langwatch-0.2.11 → langwatch-0.2.13}/src/langwatch/prompts/service.py

@@ -99,17 +99,23 @@ class PromptService:
         return cls(instance.rest_api_client)
 
     @prompt_service_tracing.get
-    def get(self, prompt_id: str) -> Prompt:
-        """Retrieve a prompt by its ID."""
-        resp = get_api_prompts_by_id.sync_detailed(id=prompt_id, client=self._client)
+    def get(self, prompt_id: str, version_number: Optional[int] = None) -> Prompt:
+        """Retrieve a prompt by its ID. You can optionally specify a version number to get a specific version of the prompt."""
+        resp = get_api_prompts_by_id.sync_detailed(
+            id=prompt_id,
+            client=self._client,
+            version=version_number if version_number is not None else UNSET,
+        )
         ok = unwrap_response(
             resp,
             ok_type=GetApiPromptsByIdResponse200,
-            subject=f'id="{prompt_id}"',
+            subject=f'handle_or_id="{prompt_id}"',
             op="fetch",
         )
         if ok is None:
-            raise RuntimeError(f"Failed to fetch prompt with id={prompt_id}")
+            raise RuntimeError(
+                f"Failed to fetch prompt with handle_or_id={prompt_id} version={version_number if version_number is not None else 'latest'}"
+            )
         return Prompt(ok)
 
     def create(