| |
|
|
| """ |
| Condensed API Converter Examples (Safe, No API Keys) |
| |
| This module provides: |
| - A quick, low-cost smoke test that builds and inspects a toolkit (no network calls) |
| - A single real call extracted from real_world_api_example.py (executes only if OPENWEATHER_API_KEY is set) |
| |
| It mirrors the structure and style of other example modules in examples/tools. |
| """ |
|
|
| from typing import Dict, Any |
| import os |
| from dotenv import load_dotenv |
|
|
| from evoagentx.tools.api_converter import ( |
| create_rapidapi_toolkit, |
| ) |
|
|
| load_dotenv() |
|
|
|
|
|
|
| weather_api_spec = { |
| "openapi": "3.0.0", |
| "info": { |
| "title": "Open Weather13 API", |
| "version": "2.0", |
| "description": "Complete weather data API via RapidAPI with 3 endpoints" |
| }, |
| "servers": [ |
| {"url": "https://open-weather13.p.rapidapi.com"} |
| ], |
| "paths": { |
| "/city": { |
| "get": { |
| "operationId": "getCityWeather", |
| "summary": "Get weather by city name", |
| "description": "Get current weather data by city name", |
| "parameters": [ |
| { |
| "name": "city", |
| "in": "query", |
| "required": True, |
| "schema": {"type": "string"}, |
| "description": "City name, e.g.: new york, beijing, tokyo" |
| }, |
| { |
| "name": "lang", |
| "in": "query", |
| "required": False, |
| "schema": { |
| "type": "string", |
| "enum": ["AF", "AL", "AR", "AZ", "BG", "CA", "CZ", "DA", "DE", "EL", "EN", "EU", "FA", "FI", "FR", "GL", "HE", "HI", "HR", "HU", "ID", "IT", "JA", "KR", "LA", "LT", "MK", "NO", "NL", "PL", "PT", "PT_BR", "RO", "RU", "SE", "SK", "SL", "SP", "ES", "SR", "TH", "TR", "UK", "VI", "ZH_CN", "ZH_TW", "ZU"], |
| "default": "EN" |
| }, |
| "description": "Language code, supports Simplified Chinese (ZH_CN), Traditional Chinese (ZH_TW), and many other languages" |
| } |
| ], |
| "responses": { |
| "200": { |
| "description": "City weather data response", |
| "content": { |
| "application/json": { |
| "schema": { |
| "type": "object", |
| "properties": { |
| "coord": { |
| "type": "object", |
| "properties": { |
| "lon": {"type": "number"}, |
| "lat": {"type": "number"} |
| } |
| }, |
| "weather": { |
| "type": "array", |
| "items": { |
| "type": "object", |
| "properties": { |
| "id": {"type": "integer"}, |
| "main": {"type": "string"}, |
| "description": {"type": "string"}, |
| "icon": {"type": "string"} |
| } |
| } |
| }, |
| "main": { |
| "type": "object", |
| "properties": { |
| "temp": {"type": "number"}, |
| "feels_like": {"type": "number"}, |
| "temp_min": {"type": "number"}, |
| "temp_max": {"type": "number"}, |
| "pressure": {"type": "number"}, |
| "humidity": {"type": "number"}, |
| "sea_level": {"type": "number"}, |
| "grnd_level": {"type": "number"} |
| } |
| }, |
| "visibility": {"type": "number"}, |
| "wind": { |
| "type": "object", |
| "properties": { |
| "speed": {"type": "number"}, |
| "deg": {"type": "number"} |
| } |
| }, |
| "clouds": { |
| "type": "object", |
| "properties": { |
| "all": {"type": "number"} |
| } |
| }, |
| "name": {"type": "string"}, |
| "sys": { |
| "type": "object", |
| "properties": { |
| "type": {"type": "integer"}, |
| "id": {"type": "integer"}, |
| "country": {"type": "string"}, |
| "sunrise": {"type": "integer"}, |
| "sunset": {"type": "integer"} |
| } |
| }, |
| "timezone": {"type": "integer"}, |
| "id": {"type": "integer"}, |
| "cod": {"type": "integer"}, |
| "dt": {"type": "integer"}, |
| "base": {"type": "string"} |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
| }, |
| "/latlon": { |
| "get": { |
| "operationId": "getWeatherByCoordinates", |
| "summary": "Get weather by coordinates", |
| "description": "Get current weather data using latitude and longitude", |
| "parameters": [ |
| { |
| "name": "latitude", |
| "in": "query", |
| "required": True, |
| "schema": {"type": "string"}, |
| "description": "Latitude, e.g.: 40.730610" |
| }, |
| { |
| "name": "longitude", |
| "in": "query", |
| "required": True, |
| "schema": {"type": "string"}, |
| "description": "Longitude, e.g.: -73.935242" |
| }, |
| { |
| "name": "lang", |
| "in": "query", |
| "required": False, |
| "schema": { |
| "type": "string", |
| "enum": ["AF", "AL", "AR", "AZ", "BG", "CA", "CZ", "DA", "DE", "EL", "EN", "EU", "FA", "FI", "FR", "GL", "HE", "HI", "HR", "HU", "ID", "IT", "JA", "KR", "LA", "LT", "MK", "NO", "NL", "PL", "PT", "PT_BR", "RO", "RU", "SE", "SK", "SL", "SP", "ES", "SR", "TH", "TR", "UK", "VI", "ZH_CN", "ZH_TW", "ZU"], |
| "default": "EN" |
| }, |
| "description": "Language code" |
| } |
| ], |
| "responses": { |
| "200": { |
| "description": "Coordinate weather data response", |
| "content": { |
| "application/json": { |
| "schema": { |
| "type": "object", |
| "properties": { |
| "coord": { |
| "type": "object", |
| "properties": { |
| "lon": {"type": "number"}, |
| "lat": {"type": "number"} |
| } |
| }, |
| "weather": { |
| "type": "array", |
| "items": { |
| "type": "object", |
| "properties": { |
| "id": {"type": "integer"}, |
| "main": {"type": "string"}, |
| "description": {"type": "string"}, |
| "icon": {"type": "string"} |
| } |
| } |
| }, |
| "main": { |
| "type": "object", |
| "properties": { |
| "temp": {"type": "number"}, |
| "feels_like": {"type": "number"}, |
| "temp_min": {"type": "number"}, |
| "temp_max": {"type": "number"}, |
| "pressure": {"type": "number"}, |
| "humidity": {"type": "number"}, |
| "sea_level": {"type": "number"}, |
| "grnd_level": {"type": "number"} |
| } |
| }, |
| "visibility": {"type": "number"}, |
| "wind": { |
| "type": "object", |
| "properties": { |
| "speed": {"type": "number"}, |
| "deg": {"type": "number"} |
| } |
| }, |
| "clouds": { |
| "type": "object", |
| "properties": { |
| "all": {"type": "number"} |
| } |
| }, |
| "name": {"type": "string"}, |
| "sys": { |
| "type": "object", |
| "properties": { |
| "type": {"type": "integer"}, |
| "id": {"type": "integer"}, |
| "country": {"type": "string"}, |
| "sunrise": {"type": "integer"}, |
| "sunset": {"type": "integer"} |
| } |
| }, |
| "timezone": {"type": "integer"}, |
| "id": {"type": "integer"}, |
| "cod": {"type": "integer"}, |
| "dt": {"type": "integer"}, |
| "base": {"type": "string"} |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
| }, |
| "/fivedaysforcast": { |
| "get": { |
| "operationId": "getFiveDayForecast", |
| "summary": "Get 5-day weather forecast", |
| "description": "Get 5-day weather forecast using latitude and longitude", |
| "parameters": [ |
| { |
| "name": "latitude", |
| "in": "query", |
| "required": True, |
| "schema": {"type": "string"}, |
| "description": "Latitude, e.g.: 40.730610" |
| }, |
| { |
| "name": "longitude", |
| "in": "query", |
| "required": True, |
| "schema": {"type": "string"}, |
| "description": "Longitude, e.g.: -73.935242" |
| }, |
| { |
| "name": "lang", |
| "in": "query", |
| "required": False, |
| "schema": { |
| "type": "string", |
| "enum": ["AF", "AL", "AR", "AZ", "BG", "CA", "CZ", "DA", "DE", "EL", "EN", "EU", "FA", "FI", "FR", "GL", "HE", "HI", "HR", "HU", "ID", "IT", "JA", "KR", "LA", "LT", "MK", "NO", "NL", "PL", "PT", "PT_BR", "RO", "RU", "SE", "SK", "SL", "SP", "ES", "SR", "TH", "TR", "UK", "VI", "ZH_CN", "ZH_TW", "ZU"], |
| "default": "EN" |
| }, |
| "description": "Language code" |
| } |
| ], |
| "responses": { |
| "200": { |
| "description": "5-day forecast data response", |
| "content": { |
| "application/json": { |
| "schema": { |
| "type": "object", |
| "properties": { |
| "cod": {"type": "string"}, |
| "message": {"type": "number"}, |
| "cnt": {"type": "integer"}, |
| "list": { |
| "type": "array", |
| "items": { |
| "type": "object", |
| "properties": { |
| "dt": {"type": "integer"}, |
| "main": { |
| "type": "object", |
| "properties": { |
| "temp": {"type": "number"}, |
| "feels_like": {"type": "number"}, |
| "temp_min": {"type": "number"}, |
| "temp_max": {"type": "number"}, |
| "pressure": {"type": "number"}, |
| "sea_level": {"type": "number"}, |
| "grnd_level": {"type": "number"}, |
| "humidity": {"type": "number"}, |
| "temp_kf": {"type": "number"} |
| } |
| }, |
| "weather": { |
| "type": "array", |
| "items": { |
| "type": "object", |
| "properties": { |
| "id": {"type": "integer"}, |
| "main": {"type": "string"}, |
| "description": {"type": "string"}, |
| "icon": {"type": "string"} |
| } |
| } |
| }, |
| "clouds": { |
| "type": "object", |
| "properties": { |
| "all": {"type": "number"} |
| } |
| }, |
| "wind": { |
| "type": "object", |
| "properties": { |
| "speed": {"type": "number"}, |
| "deg": {"type": "number"}, |
| "gust": {"type": "number"} |
| } |
| }, |
| "visibility": {"type": "number"}, |
| "pop": {"type": "number"}, |
| "rain": { |
| "type": "object", |
| "properties": { |
| "3h": {"type": "number"} |
| } |
| }, |
| "sys": { |
| "type": "object", |
| "properties": { |
| "pod": {"type": "string"} |
| } |
| }, |
| "dt_txt": {"type": "string"} |
| } |
| } |
| }, |
| "city": { |
| "type": "object", |
| "properties": { |
| "id": {"type": "integer"}, |
| "name": {"type": "string"}, |
| "coord": { |
| "type": "object", |
| "properties": { |
| "lat": {"type": "number"}, |
| "lon": {"type": "number"} |
| } |
| }, |
| "country": {"type": "string"}, |
| "population": {"type": "integer"}, |
| "timezone": {"type": "integer"}, |
| "sunrise": {"type": "integer"}, |
| "sunset": {"type": "integer"} |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
| } |
|
|
|
|
|
|
| def rapidapi_test() -> None: |
| print("\n===== SINGLE REAL CALL: OpenWeatherMap (extracted) =====\n") |
|
|
| api_key = os.getenv("RAPIDAPI_KEY") |
| if not api_key or api_key.strip().lower() in {"", "your-api-key"}: |
| print("Skipping real call: set RAPIDAPI_KEY to run this test.") |
| return |
|
|
| |
| rapidapi_host = "open-weather13.p.rapidapi.com" |
| toolkit = create_rapidapi_toolkit( |
| schema_path_or_dict=weather_api_spec, |
| rapidapi_key=api_key, |
| rapidapi_host=rapidapi_host, |
| service_name="Open Weather13" |
| ) |
|
|
| |
| print("____________ Executing city weather querying ____________") |
| city_weather_tool = toolkit.get_tools()[0] |
| example_query = {"city": "new york"} |
| print("Qeury inputs: \n", example_query) |
| result = city_weather_tool(**example_query) |
| print("Query result: \n", result) |
| |
|
|
| def main() -> None: |
| """Main function to run condensed converter examples""" |
| print("===== API CONVERTER EXAMPLES (CONDENSED) =====") |
| |
| rapidapi_test() |
| print("\n===== ALL CONDENSED CONVERTER TESTS COMPLETED =====") |
|
|
|
|
| if __name__ == "__main__": |
| main() |
