# DMWeather 🌤️
**DMWeather** es una librería Python simple y potente para obtener información meteorológica actual y pronósticos utilizando la API gratuita de OpenWeatherMap.
## 🚀 Características
- ✅ Obtener clima actual de cualquier ciudad del mundo
- ✅ Pronóstico del clima para mañana
- ✅ Datos en español
- ✅ Manejo robusto de errores
- ✅ Fácil de usar
- ✅ Documentación completa
- ✅ Tests incluidos
## 📦 Instalación
```bash
pip install dmweather
```
## 🔑 Configuración
1. Obtén tu API key gratuita en [OpenWeatherMap](https://openweathermap.org/api)
2. Regístrate y copia tu API key
## 🛠️ Uso básico
```python
from dmweather import ClimaApp
# Inicializar la aplicación
app = ClimaApp("tu_api_key_aqui")
# Obtener clima actual
clima_actual = app.clima_hoy("Asunción", "PY")
print(f"Temperatura: {clima_actual['temperatura']}°C")
print(f"Descripción: {clima_actual['descripcion']}")
# Obtener pronóstico para mañana
clima_mañana = app.clima_mañana("Buenos Aires", "AR")
print(f"Mañana: {clima_mañana['temperatura_max']}°C máxima")
print(f"Probabilidad de lluvia: {clima_mañana['probabilidad_lluvia']}%")
```
## 📊 Datos disponibles
### `clima_hoy(ciudad, pais="")`
Retorna un diccionario con:
- `ciudad`: Nombre de la ciudad
- `pais`: Código del país
- `fecha`: Fecha y hora actual
- `temperatura`: Temperatura en Celsius
- `sensacion_termica`: Sensación térmica
- `humedad`: Porcentaje de humedad
- `presion`: Presión atmosférica en hPa
- `descripcion`: Descripción del clima en español
- `viento_velocidad`: Velocidad del viento en m/s
- `coordenadas`: Coordenadas geográficas
### `clima_mañana(ciudad, pais="")`
Retorna un diccionario con todos los datos anteriores más:
- `temperatura_min`: Temperatura mínima
- `temperatura_max`: Temperatura máxima
- `probabilidad_lluvia`: Probabilidad de lluvia (%)
## 🎯 Ejemplos avanzados
### Usando la función de utilidad para mostrar datos
```python
from dmweather import ClimaApp, mostrar_clima
app = ClimaApp("tu_api_key")
# Obtener y mostrar clima actual
clima = app.clima_hoy("Madrid", "ES")
mostrar_clima(clima, "actual")
# Obtener y mostrar pronóstico
pronostico = app.clima_mañana("São Paulo", "BR")
mostrar_clima(pronostico, "mañana")
```
### Manejo de errores
```python
from dmweather import ClimaApp, CiudadNoEncontradaError, APIError
app = ClimaApp("tu_api_key")
try:
clima = app.clima_hoy("CiudadInexistente")
except CiudadNoEncontradaError as e:
print(f"Ciudad no encontrada: {e}")
except APIError as e:
print(f"Error de API: {e}")
```
## 🧪 Tests
Para ejecutar los tests:
```bash
python -m pytest tests/
```
O usando unittest:
```bash
python -m unittest tests.test_dmweather -v
```
## 📋 Requisitos
- Python 3.7+
- requests >= 2.25.0
- API key de OpenWeatherMap (gratuita)
## 🌍 Códigos de país soportados
Usa códigos ISO 3166-1 alpha-2:
- `AR` - Argentina
- `PY` - Paraguay
- `BR` - Brasil
- `ES` - España
- `US` - Estados Unidos
- etc.
## 🤝 Contribuir
1. Aca se debe poner donde contribuir en este caso no quiero aun que se contribuya
## 📄 Licencia
Este proyecto está bajo la Licencia MIT. Ver el archivo `LICENSE` para más detalles.
## 🐛 Reportar bugs
Si encuentras algún bug, por favor crea un issue en [GitHub Issues](https://github.com/tu-usuario/dmweather/issues).
## 👨💻 Autor
**Danilo Ramon Mosqueira Cardozo** - [danilo855984@gmail.com](mailto:danilo855984@gmail.com)
---
⭐ ¡Dale una estrella si te gustó el proyecto!
"""
Raw data
{
"_id": null,
"home_page": null,
"name": "dmweather",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "weather, clima, api, openweathermap, forecast, pronostico",
"author": null,
"author_email": "Danilo Mosqueira <danilo855984@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/d1/0b/e9497e138e76700e8f11f426f78dab20966b6fd3b99a927e2411bc2ac799/dmweather-0.0.1.tar.gz",
"platform": null,
"description": "# DMWeather \ud83c\udf24\ufe0f\n\n**DMWeather** es una librer\u00eda Python simple y potente para obtener informaci\u00f3n meteorol\u00f3gica actual y pron\u00f3sticos utilizando la API gratuita de OpenWeatherMap.\n\n## \ud83d\ude80 Caracter\u00edsticas\n\n- \u2705 Obtener clima actual de cualquier ciudad del mundo\n- \u2705 Pron\u00f3stico del clima para ma\u00f1ana\n- \u2705 Datos en espa\u00f1ol\n- \u2705 Manejo robusto de errores\n- \u2705 F\u00e1cil de usar\n- \u2705 Documentaci\u00f3n completa\n- \u2705 Tests incluidos\n\n## \ud83d\udce6 Instalaci\u00f3n\n\n```bash\npip install dmweather\n```\n\n## \ud83d\udd11 Configuraci\u00f3n\n\n1. Obt\u00e9n tu API key gratuita en [OpenWeatherMap](https://openweathermap.org/api)\n2. Reg\u00edstrate y copia tu API key\n\n## \ud83d\udee0\ufe0f Uso b\u00e1sico\n\n```python\nfrom dmweather import ClimaApp\n\n# Inicializar la aplicaci\u00f3n\napp = ClimaApp(\"tu_api_key_aqui\")\n\n# Obtener clima actual\nclima_actual = app.clima_hoy(\"Asunci\u00f3n\", \"PY\")\nprint(f\"Temperatura: {clima_actual['temperatura']}\u00b0C\")\nprint(f\"Descripci\u00f3n: {clima_actual['descripcion']}\")\n\n# Obtener pron\u00f3stico para ma\u00f1ana\nclima_ma\u00f1ana = app.clima_ma\u00f1ana(\"Buenos Aires\", \"AR\")\nprint(f\"Ma\u00f1ana: {clima_ma\u00f1ana['temperatura_max']}\u00b0C m\u00e1xima\")\nprint(f\"Probabilidad de lluvia: {clima_ma\u00f1ana['probabilidad_lluvia']}%\")\n```\n\n## \ud83d\udcca Datos disponibles\n\n### `clima_hoy(ciudad, pais=\"\")`\nRetorna un diccionario con:\n- `ciudad`: Nombre de la ciudad\n- `pais`: C\u00f3digo del pa\u00eds\n- `fecha`: Fecha y hora actual\n- `temperatura`: Temperatura en Celsius\n- `sensacion_termica`: Sensaci\u00f3n t\u00e9rmica\n- `humedad`: Porcentaje de humedad\n- `presion`: Presi\u00f3n atmosf\u00e9rica en hPa\n- `descripcion`: Descripci\u00f3n del clima en espa\u00f1ol\n- `viento_velocidad`: Velocidad del viento en m/s\n- `coordenadas`: Coordenadas geogr\u00e1ficas\n\n### `clima_ma\u00f1ana(ciudad, pais=\"\")`\nRetorna un diccionario con todos los datos anteriores m\u00e1s:\n- `temperatura_min`: Temperatura m\u00ednima\n- `temperatura_max`: Temperatura m\u00e1xima\n- `probabilidad_lluvia`: Probabilidad de lluvia (%)\n\n## \ud83c\udfaf Ejemplos avanzados\n\n### Usando la funci\u00f3n de utilidad para mostrar datos\n\n```python\nfrom dmweather import ClimaApp, mostrar_clima\n\napp = ClimaApp(\"tu_api_key\")\n\n# Obtener y mostrar clima actual\nclima = app.clima_hoy(\"Madrid\", \"ES\")\nmostrar_clima(clima, \"actual\")\n\n# Obtener y mostrar pron\u00f3stico\npronostico = app.clima_ma\u00f1ana(\"S\u00e3o Paulo\", \"BR\")\nmostrar_clima(pronostico, \"ma\u00f1ana\")\n```\n\n### Manejo de errores\n\n```python\nfrom dmweather import ClimaApp, CiudadNoEncontradaError, APIError\n\napp = ClimaApp(\"tu_api_key\")\n\ntry:\n clima = app.clima_hoy(\"CiudadInexistente\")\nexcept CiudadNoEncontradaError as e:\n print(f\"Ciudad no encontrada: {e}\")\nexcept APIError as e:\n print(f\"Error de API: {e}\")\n```\n\n## \ud83e\uddea Tests\n\nPara ejecutar los tests:\n\n```bash\npython -m pytest tests/\n```\n\nO usando unittest:\n\n```bash\npython -m unittest tests.test_dmweather -v\n```\n\n## \ud83d\udccb Requisitos\n\n- Python 3.7+\n- requests >= 2.25.0\n- API key de OpenWeatherMap (gratuita)\n\n## \ud83c\udf0d C\u00f3digos de pa\u00eds soportados\n\nUsa c\u00f3digos ISO 3166-1 alpha-2:\n- `AR` - Argentina\n- `PY` - Paraguay \n- `BR` - Brasil\n- `ES` - Espa\u00f1a\n- `US` - Estados Unidos\n- etc.\n\n## \ud83e\udd1d Contribuir\n\n1. Aca se debe poner donde contribuir en este caso no quiero aun que se contribuya\n\n## \ud83d\udcc4 Licencia\n\nEste proyecto est\u00e1 bajo la Licencia MIT. Ver el archivo `LICENSE` para m\u00e1s detalles.\n\n## \ud83d\udc1b Reportar bugs\n\nSi encuentras alg\u00fan bug, por favor crea un issue en [GitHub Issues](https://github.com/tu-usuario/dmweather/issues).\n\n## \ud83d\udc68\u200d\ud83d\udcbb Autor\n\n**Danilo Ramon Mosqueira Cardozo** - [danilo855984@gmail.com](mailto:danilo855984@gmail.com)\n\n---\n\n\u2b50 \u00a1Dale una estrella si te gust\u00f3 el proyecto!\n\"\"\"\n",
"bugtrack_url": null,
"license": null,
"summary": "Librer\u00eda Python para obtener informaci\u00f3n del clima actual y pron\u00f3sticos",
"version": "0.0.1",
"project_urls": {
"Bug Tracker": "https://github.com/tu-usuario/dmweather/issues",
"Documentation": "https://github.com/tu-usuario/dmweather#readme",
"Homepage": "https://github.com/tu-usuario/dmweather"
},
"split_keywords": [
"weather",
" clima",
" api",
" openweathermap",
" forecast",
" pronostico"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "221dbc875b59e7b9e7a0cabd2de4805d88bdc5bb3bd48f6cd18a3c6805fe1d8f",
"md5": "f2d9ccfd2c60c4027004f3f1fc52d87b",
"sha256": "93ef21ab784906062e785d584aad7aa151f6e28a6b90bdb08856504faf09ff49"
},
"downloads": -1,
"filename": "dmweather-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "f2d9ccfd2c60c4027004f3f1fc52d87b",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 7156,
"upload_time": "2025-07-30T18:35:09",
"upload_time_iso_8601": "2025-07-30T18:35:09.998127Z",
"url": "https://files.pythonhosted.org/packages/22/1d/bc875b59e7b9e7a0cabd2de4805d88bdc5bb3bd48f6cd18a3c6805fe1d8f/dmweather-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "d10be9497e138e76700e8f11f426f78dab20966b6fd3b99a927e2411bc2ac799",
"md5": "eeeafd769bf5b25328137e2434e7d6fc",
"sha256": "a3f8f63ffc46b019273140338a52cb8ca3a4cbfd70af3a57d0cbaecf1b1fce9c"
},
"downloads": -1,
"filename": "dmweather-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "eeeafd769bf5b25328137e2434e7d6fc",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 8382,
"upload_time": "2025-07-30T18:35:11",
"upload_time_iso_8601": "2025-07-30T18:35:11.670570Z",
"url": "https://files.pythonhosted.org/packages/d1/0b/e9497e138e76700e8f11f426f78dab20966b6fd3b99a927e2411bc2ac799/dmweather-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-30 18:35:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "tu-usuario",
"github_project": "dmweather",
"github_not_found": true,
"lcname": "dmweather"
}
JSON
