python-by-example/projects/04_weather_cli

🌤️ Project 04: Real-time Weather CLI

Difficulty: 🚀 Professional

Description

Build a professional command-line weather application that fetches real-time weather data from the Open-Meteo API (free, no API key needed!) and displays it beautifully in the terminal. This project combines API consumption, decorators, type hinting, error handling, and testing.

Requirements

1. Fetch current weather data for any city using the Open-Meteo geocoding + weather API
2. Display temperature, humidity, wind speed, and weather condition
3. Support multiple cities in a single query
4. Cache API responses using a decorator to avoid repeated requests
5. Use type hints throughout the codebase
6. Handle network errors and invalid city names gracefully
7. Display weather data in a formatted, visually appealing way

Concepts You'll Practice

• HTTP Requests (urllib — no external dependencies!)
• Decorators (caching)
• Type Hinting
• Error Handling (network, API, data)
• JSON parsing
• String formatting and CLI design

Example Output

🌤️  WEATHER CLI
===============

Enter city name: Gaza

╔══════════════════════════════════════╗
║  📍 Gaza, Palestinian Territory     ║
╠══════════════════════════════════════╣
║  🌡️  Temperature:  28.3°C           ║
║  💧 Humidity:      65%              ║
║  💨 Wind Speed:    12.5 km/h        ║
║  ☀️  Condition:     Clear sky        ║
╚══════════════════════════════════════╝

How to Run

cd projects/04_weather_cli
python solution.py

Note: This project uses the free Open-Meteo API — no API key or sign-up required!

Bonus Challenges

• Add 5-day forecast display
• Add temperature unit conversion (°C / °F)
• Save favorite cities to a config file