A simple and professional Weather API Wrapper built with FastAPI, SQLite, and httpx. This project fetches weather data from the free Open-Meteo API and stores query history locally.

• Fetch current weather by city 🌍
• Fetch current weather by GPS coordinates 📍
• Fetch 5-day forecast for a city 📅
• Store weather history in SQLite 🗄️
• Retrieve all history records 📖
• Delete history records ❌
• List all unique cities queried 🏙️

• FastAPI – Web framework
• httpx – Async HTTP client for API calls
• SQLite + SQLAlchemy – Database & ORM
• Pydantic – Data validation

# Clone repo git clone https://github.com/your-username/weather-api-wrapper.git cd weather-api-wrapper # Create virtual environment python -m venv venv source venv/bin/activate # Linux/Mac venv\Scripts\activate # Windows # Install dependencies pip install -r requirements.txt # Run server uvicorn main:app --reload

GET /ping

✅ Response:

{ "message": "pong" }

GET /weather/{city}

✅ Example:

GET /weather/Lagos

Response:

{ "id": 1, "city": "Lagos", "temperature": 29.5, "description": "Partly cloudy", "timestamp": "2025-09-05T17:50:23" }

GET /weather/coordinates?lat={lat}&lon={lon}

✅ Example:

GET /weather/coordinates?lat=6.5244&lon=3.3792

Response:

{ "id": 2, "city": "(6.5244,3.3792)", "temperature": 29.0, "description": "Clear sky", "timestamp": "2025-09-05T17:55:42" }

GET /forecast/{city}?days=5

✅ Example:

GET /forecast/London?days=5

Response:

{ "city": "London", "daily": { "temperature_2m_max": [23.5, 22.1, 21.7, 24.0, 25.3], "temperature_2m_min": [15.2, 14.8, 14.5, 15.0, 16.3] } }

GET /history

✅ Response:

[ { "id": 1, "city": "Lagos", "temperature": 29.5, "description": "Partly cloudy", "timestamp": "2025-09-05T17:50:23" }, { "id": 2, "city": "(6.5244,3.3792)", "temperature": 29.0, "description": "Clear sky", "timestamp": "2025-09-05T17:55:42" } ]

DELETE /history/{id}

✅ Example:

DELETE /history/2

Response:

{ "message": "Record 2 deleted" }

GET /cities

✅ Response:

{ "cities": ["Lagos", "London", "(6.5244,3.3792)"] }

• Import the endpoints above into Postman

• Start the server with:

  uvicorn main:app --reload

• Test endpoints like:

  • http://127.0.0.1:8000/weather/Lagos
  • http://127.0.0.1:8000/forecast/London?days=3

• Add caching with Redis for faster repeated lookups
• Add user authentication with JWT tokens
• Build a React frontend for visualizing weather

MIT License. Free to use and modify.

Ipaye Babatunde

• 🌍 Lagos, Nigeria
• 📧 b.tunde.ipaye@gmail.com
• 🔗 LinkedIn
• 💻 GitHub