ParsWeather 0.2.0

A Python package for getting Iran's weather data, including temperature and RealFeel.

ParsWeather – Iran's Ultimate Weather Package 🇮🇷

📡 Get the most accurate weather information for Iran with a single Python package!
🌦️ Temperature, Air Quality, Radar Images, Sunrise & Sunset Times, and much more! 🌍

---

📥 Quick Installation

Install ParsWeather via pip in no time:

pip install ParsWeather

💡 Requirements:

• Python 3.7+
• Internet connection to fetch the latest weather data

---

🚀 How to Use – It's Easy and Fun!

No need for complex setups – just a few lines of code and you're good to go! Here's an example:

from ParsWeather import WeatherForecast as wf  

city = "تهران"  # 📍 Replace with the city you want to check

print(f"🌡️ Current Temperature: {wf.get_temperature(city)}°C")  
print(f"🤔 Real Feel Temperature: {wf.get_realfeel(city)}°C")  
print(f"🍃 Air Quality: {wf.get_air_quality(city)}")  
print(f"📊 Air Quality Index (AQI): {wf.get_air_quality_aqi(city)}")  
print(f"🏜️ Dust & Allergen Levels: {wf.get_dust_dander_data(city)}")  
print(f"🌦️ Full Weather Forecast: {wf.get_weather_forecast(city)}")  
print(f"🛰️ Radar Image Link: {wf.get_radar_image_link(city)}")  
print(f"🌅 Sunrise & Sunset Times: {wf.get_sun_times(city)}")  
print(f"🔎 Detailed Weather Forecast: {wf.get_forecast_details(city)}")  
print(f"📍 Supported Cities List: {wf.get_supported_cities()}")  
print(f"🌍 Combined Weather & AQI: {wf.get_weather_forecast_air_aqi(city)}")  
print(f"🛰️ Radar GIF Link:{wf.download_specific_image()}")

pollutant_data = wf.get_pollutant_info(city)
if isinstance(pollutant_data, dict):
    for pollutant, info in pollutant_data.items():
        print(f"آلاینده: {pollutant}")
        print(f"میزان: {info['concentration']}")
        print(f"توضیحات: {info['statement']}")
        print('-' * 50)
else:
    print(pollutant_data)

🎯 Just plug in your city name and get precise, real-time weather updates! It's that simple!

---

🔥 Why Choose ParsWeather?

✅ Up-to-Date & Reliable Data – Get the latest weather insights with absolute accuracy.
✅ User-Friendly – Just a few lines of code to pull comprehensive data!
✅ Comprehensive – Covers everything from temperature and air quality to radar images and sun times!
✅ Tailored for Iran – Designed with Iranian cities in mind, it's the only weather tool you'll need for Iran 🇮🇷.

---

📍 Key Features:

🌡️ Current Temperature – Check the temperature in real-time!
🤔 Real Feel Temperature – How does it really feel outside?
🍃 Air Quality – Find out how fresh the air is!
📊 Air Quality Index (AQI) – Know how polluted the air is.
🏜️ Dust & Allergen Levels – Prepare for allergies or dusty days.
🌦️ Full Weather Forecast – Hour-by-hour or daily forecast.
🛰️ Radar Images – See weather systems moving in!
🌅 Sunrise & Sunset Times – Never miss a sunrise or sunset again.
🔎 Detailed Forecast – Get an in-depth look at the upcoming weather.
📍 Supported Cities – Check if your city is covered.
🌍 Combined Weather & AQI – Get the full picture of both weather and air quality.

---

💡 Possible Use Cases

🚗 Travel & Navigation Apps – Never get caught in a rainstorm again!
📱 Smart Assistants and Bots – Show your users the weather with ease.
🏫 School/Office Systems – Announce closures due to bad air quality or extreme weather.
🏕️ Outdoor Adventures – Check the weather before you hit the trails or mountains.

---

🏆 Why is ParsWeather the Best Choice?

Feature	ParsWeather	Other Methods
⚡ Speed	✅ Lightning fast	❌ Slow updates
🎯 Accuracy	✅ Super precise	❌ Hit or miss
🌎 Iran Coverage	✅ Complete list of cities	❌ Missing major cities
🚀 Easy to Use	✅ Just a few lines	❌ Complex API integrations
📡 Satellite & Radar Images	✅ Yes	❌ No radar images

✨ ParsWeather is the only package specifically built for accurate, up-to-date weather information for Iranian cities!

---

📚 Want More Info?

🔗 GitHub: Check it out on GitHub
🔗 Website: Visit the website

📌 Start using ParsWeather today and say goodbye to unpredictable weather surprises! 🌪️🌈

---

✅ What do you think of this documentation? Any other features or suggestions? Drop your feedback! 🤔

Here’s a more complete footer for the ParsWeather package documentation, including copyright and developer information:

---

Developed by Ali Ayati Qaffari

© 2025 ParsWeather – All rights reserved.

This project is developed and maintained by Ali Ayati Qaffari. Unauthorized use, distribution, or reproduction of any part of this package without explicit permission is prohibited.