🌤️ 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

Fetch current weather data for any city using the Open-Meteo geocoding + weather API
Display temperature, humidity, wind speed, and weather condition
Support multiple cities in a single query
Cache API responses using a decorator to avoid repeated requests
Use type hints throughout the codebase
Handle network errors and invalid city names gracefully
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

2.0 KiB Raw Permalink Blame History