pyopenweathermap 0.0.2__tar.gz

pyopenweathermap-0.0.2/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Evgeny
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pyopenweathermap-0.0.2/PKG-INFO

@@ -0,0 +1,20 @@
+Metadata-Version: 2.1
+Name: pyopenweathermap
+Version: 0.0.2
+Summary: lib for OpenWeatherMap for Home Assistant
+License: MIT
+Keywords: homeassistant,owm,openweathermap
+Author: Evgeny
+Author-email: iam@freekode.org
+Requires-Python: >=3.11,<4.0
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Requires-Dist: aiohttp (>=3.9.5,<4.0.0)
+Requires-Dist: pydantic (>=2.7.1,<3.0.0)
+Description-Content-Type: text/markdown
+
+# pyopenweathermap
+
+Python library for OpenWeatherMap API for Home Assistant
+

pyopenweathermap-0.0.2/README.md

@@ -0,0 +1,3 @@
+# pyopenweathermap
+
+Python library for OpenWeatherMap API for Home Assistant

pyopenweathermap-0.0.2/pyproject.toml

@@ -0,0 +1,25 @@
+[tool.poetry]
+name = "pyopenweathermap"
+version = "0.0.2"
+description = "lib for OpenWeatherMap for Home Assistant"
+authors = ["Evgeny <iam@freekode.org>"]
+license = "MIT"
+readme = "README.md"
+keywords = ["homeassistant", "owm", "openweathermap"]
+packages = [
+    { include = "pyopenweathermap", from = "src" },
+]
+
+[tool.poetry.dependencies]
+python = "^3.11"
+aiohttp = "^3.9.5"
+pydantic = "^2.7.1"
+
+
+[tool.poetry.group.dev.dependencies]
+pytest = "^8.1.1"
+pytest-asyncio = "^0.23.6"
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

pyopenweathermap-0.0.2/src/pyopenweathermap/__init__.py

@@ -0,0 +1,9 @@
+from .exception import (
+    RequestError,
+    UnauthorizedError,
+    TooManyRequestsError
+)
+from .owm_client import OWMClient
+from .weather import (
+    CurrentWeather, HourlyWeatherForecast, DailyWeatherForecast, WeatherReport,
+)

pyopenweathermap-0.0.2/src/pyopenweathermap/exception.py

@@ -0,0 +1,10 @@
+class RequestError(Exception):
+    pass
+
+
+class UnauthorizedError(RequestError):
+    pass
+
+
+class TooManyRequestsError(RequestError):
+    pass

pyopenweathermap-0.0.2/src/pyopenweathermap/owm_client.py

@@ -0,0 +1,71 @@
+from aiohttp import ClientSession
+
+from .exception import RequestError, UnauthorizedError, TooManyRequestsError
+from .weather import WeatherReport, CurrentWeather, HourlyWeatherForecast, DailyWeatherForecast
+
+API_URL = 'https://api.openweathermap.org/data/3.0/onecall'
+WEATHER_TYPES = {'current', 'minutely', 'hourly', 'daily', 'alerts'}
+
+
+class OWMClient:
+    session: ClientSession | None = None
+    request_timeout: int = 10
+
+    def __init__(self, api_key, units="metric", lang='en'):
+        self.api_key = api_key
+        self.units = units
+        self.lang = lang
+
+    async def get_weather(self, lat, lon, weather_types=None) -> WeatherReport:
+        if weather_types is None:
+            exclude_weather_types = {}
+        else:
+            exclude_weather_types = WEATHER_TYPES - set(weather_types)
+
+        url = self._get_url(lat, lon, exclude_weather_types)
+        json_response = await self._request(url)
+
+        current, hourly, daily = None, None, None
+        if json_response.get('current') is not None:
+            current = CurrentWeather(**json_response['current'])
+        if json_response.get('hourly') is not None:
+            hourly = [HourlyWeatherForecast(**item) for item in json_response['hourly']]
+        if json_response.get('daily') is not None:
+            daily = [DailyWeatherForecast(**item) for item in json_response['daily']]
+
+        return WeatherReport(current, hourly, daily)
+
+    async def validate_key(self) -> bool:
+        url = self._get_url(50.06, 14.44, WEATHER_TYPES)
+        try:
+            await self._request(url)
+            return True
+        except UnauthorizedError:
+            return False
+
+    async def _request(self, url):
+        print(url)
+        async with ClientSession() as session:
+            try:
+                async with session.get(url=url, timeout=self.request_timeout) as response:
+                    if response.status == 200:
+                        return await response.json()
+                    elif response.status == 401:
+                        raise UnauthorizedError
+                    elif response.status == 404:
+                        raise RequestError("Not Found")
+                    elif response.status == 429:
+                        raise TooManyRequestsError
+                    else:
+                        raise RequestError("Unknown Error")
+            except TimeoutError:
+                raise RequestError("Request timeout")
+
+    def _get_url(self, lat, lon, exclude):
+        return (f"{API_URL}?"
+                f"lat={lat}&"
+                f"lon={lon}&"
+                f"exclude={','.join(exclude)}&"
+                f"appid={self.api_key}&"
+                f"units={self.units}&"
+                f"lang={self.lang}")

pyopenweathermap-0.0.2/src/pyopenweathermap/weather.py

@@ -0,0 +1,93 @@
+import decimal
+from dataclasses import dataclass
+from datetime import datetime
+
+from pydantic import BaseModel, Field
+
+
+class DailyTemperature(BaseModel):
+    day: decimal.Decimal
+    min: decimal.Decimal = None
+    max: decimal.Decimal = None
+    night: decimal.Decimal
+    evening: decimal.Decimal = Field(alias='eve')
+    morning: decimal.Decimal = Field(alias='morn')
+
+
+class WeatherCondition(BaseModel):
+    id: int
+    main: str
+    description: str
+    icon: str
+
+
+class CurrentWeather(BaseModel):
+    date_time: datetime = Field(alias='dt')
+    temperature: decimal.Decimal = Field(alias='temp')
+    feels_like: decimal.Decimal
+    pressure: int
+    humidity: int
+    dew_point: decimal.Decimal
+    uv_index: decimal.Decimal = Field(alias='uvi')
+    clouds: int
+    visibility: int
+    wind_speed: decimal.Decimal
+    wind_gust: decimal.Decimal = None
+    wind_deg: int
+    rain: dict = {}
+    snow: dict = {}
+    condition: list[WeatherCondition] = Field(alias='weather')
+
+    def get_weather(self):
+        return self.condition[0]
+
+
+class HourlyWeatherForecast(BaseModel):
+    date_time: datetime = Field(alias='dt')
+    temperature: decimal.Decimal = Field(alias='temp')
+    feels_like: decimal.Decimal
+    pressure: int
+    humidity: int
+    dew_point: decimal.Decimal
+    uv_index: decimal.Decimal = Field(alias='uvi')
+    clouds: int
+    visibility: int
+    wind_speed: decimal.Decimal
+    wind_gust: decimal.Decimal = None
+    wind_deg: int
+    precipitation_probability: decimal.Decimal = Field(alias='pop', default=0)
+    rain: dict = {}
+    snow: dict = {}
+    condition: list[WeatherCondition] = Field(alias='weather')
+
+    def get_weather(self):
+        return self.condition[0]
+
+
+class DailyWeatherForecast(BaseModel):
+    date_time: datetime = Field(alias='dt')
+    summary: str
+    temperature: DailyTemperature = Field(alias='temp')
+    feels_like: DailyTemperature
+    pressure: int
+    humidity: int
+    dew_point: decimal.Decimal
+    uv_index: decimal.Decimal = Field(alias='uvi')
+    clouds: int
+    wind_speed: decimal.Decimal
+    wind_gust: decimal.Decimal = None
+    wind_deg: int
+    precipitation_probability: decimal.Decimal = Field(alias='pop', default=0)
+    rain: decimal.Decimal = 0
+    snow: decimal.Decimal = 0
+    condition: list[WeatherCondition] = Field(alias='weather')
+
+    def get_weather(self):
+        return self.condition[0]
+
+
+@dataclass
+class WeatherReport:
+    current: CurrentWeather
+    hourly_forecast: list[HourlyWeatherForecast]
+    daily_forecast: list[DailyWeatherForecast]