From 770adbc673c96815f7fc033ac910f929f939d846 Mon Sep 17 00:00:00 2001
From: Abbas Asad <168946441+Abbas-Asad@users.noreply.github.com>
Date: Thu, 14 Aug 2025 22:51:22 +0500
Subject: [PATCH] Docs: Add missing docstring to get_weather function

## Summary

Added a missing docstring to the `get_weather` function in the tools example to improve code documentation and tool description.

## Problem

The `get_weather` function (tool) was missing a docstring, which is important for:
- Function documentation and code clarity
- Tool description that the LLM uses to understand when to call the tool
- Following Python best practices for function documentation

## Changes Made

Just added a clear and concise docstring to the `get_weather` function:
```python
@function_tool
def get_weather(city: str) -> Weather:
    """Get the current weather information for a specified city."""
    print("[debug] get_weather called")
    return Weather(city=city, temperature_range="14-20C", conditions="Sunny with wind.")
```

This docstring provides a clear description of the function's purpose and helps both developers and LLMs understand when and how to use this tool.
---
 examples/basic/tools.py | 1 +
 1 file changed, 1 insertion(+)

diff --git a/examples/basic/tools.py b/examples/basic/tools.py
index 8936065a5..65d0c753a 100644
--- a/examples/basic/tools.py
+++ b/examples/basic/tools.py
@@ -13,6 +13,7 @@ class Weather(BaseModel):
 
 @function_tool
 def get_weather(city: str) -> Weather:
+    """Get the current weather information for a specified city."""
     print("[debug] get_weather called")
     return Weather(city=city, temperature_range="14-20C", conditions="Sunny with wind.")