python-weather 2.2.1__tar.gz → 2.2.3__tar.gz

{python_weather-2.2.1/python_weather.egg-info → python_weather-2.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-weather
-Version: 2.2.1
+Version: 2.2.3
 Summary: A free and asynchronous weather API wrapper made in Python, for Python.
 Author: null8626
 License-Expression: MIT
@@ -33,7 +33,14 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp>=3.13.5
+Requires-Dist: aiohttp>=3.14.3
+Provides-Extra: dev
+Requires-Dist: mock>=5.2.0; extra == "dev"
+Requires-Dist: pytest>=9.1.1; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=7.1.0; extra == "dev"
+Requires-Dist: multidict>=6.7.1; extra == "dev"
+Requires-Dist: yarl>=1.24.5; extra == "dev"
 Dynamic: license-file
 
 # [python-weather][pypi-url] [![pypi][pypi-image]][pypi-url] [![pypi downloads][pypi-downloads-image]][pypi-url] [![codacy-badge][codacy-image]][codacy-url] [![codecov-badge][codecov-image]][codecov-url] [![ko-fi][ko-fi-brief-image]][ko-fi-url]
@@ -71,24 +78,24 @@ import asyncio
 
 
 async def main() -> None:
-  
+
   # Declare the client. The measuring unit used defaults to the metric system (celcius, km/h, etc.)
   async with python_weather.Client(unit=python_weather.IMPERIAL) as client:
-    
     # Fetch a weather forecast from a city.
     weather = await client.get('New York')
-    
+
     # Fetch the temperature for today.
     print(weather.temperature)
-    
+
     # Fetch weather forecast for upcoming days.
     for daily in weather:
       print(daily)
-    
+
       # Each daily forecast has their own hourly forecasts.
       for hourly in daily:
         print(f' --> {hourly!r}')
 
+
 if __name__ == '__main__':
   asyncio.run(main())
 ```

{python_weather-2.2.1 → python_weather-2.2.3}/README.md

@@ -33,24 +33,24 @@ import asyncio
 
 
 async def main() -> None:
-  
+
   # Declare the client. The measuring unit used defaults to the metric system (celcius, km/h, etc.)
   async with python_weather.Client(unit=python_weather.IMPERIAL) as client:
-    
     # Fetch a weather forecast from a city.
     weather = await client.get('New York')
-    
+
     # Fetch the temperature for today.
     print(weather.temperature)
-    
+
     # Fetch weather forecast for upcoming days.
     for daily in weather:
       print(daily)
-    
+
       # Each daily forecast has their own hourly forecasts.
       for hourly in daily:
         print(f' --> {hourly!r}')
 
+
 if __name__ == '__main__':
   asyncio.run(main())
 ```

{python_weather-2.2.1 → python_weather-2.2.3}/pyproject.toml

@@ -3,13 +3,13 @@ requires = ["setuptools"]
 
 [project]
 name = "python-weather"
-version = "2.2.1"
+version = "2.2.3"
 description = "A free and asynchronous weather API wrapper made in Python, for Python."
 readme = "README.md"
 license = "MIT"
 authors = [{ name = "null8626" }]
 keywords = ["weather", "forecast", "weather-forecast"]
-dependencies = ["aiohttp>=3.13.5"]
+dependencies = ["aiohttp>=3.14.3"]
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Education",
@@ -34,6 +34,9 @@ classifiers = [
 ]
 requires-python = ">=3.10"
 
+[project.optional-dependencies]
+dev = ["mock>=5.2.0", "pytest>=9.1.1", "pytest-asyncio>=1.4.0", "pytest-cov>=7.1.0", "multidict>=6.7.1", "yarl>=1.24.5"]
+
 [project.urls]
 Documentation = "https://python-weather.readthedocs.io/en/latest/"
 Repository = "https://github.com/null8626/python-weather"

{python_weather-2.2.1 → python_weather-2.2.3}/python_weather/__init__.py

@@ -1,13 +1,12 @@
 # SPDX-License-Identifier: MIT
 # SPDX-FileCopyrightText: 2021-2026 null8626
 
+from .client import Client
+from .constants import IMPERIAL, METRIC
 from .enums import HeatIndex, Kind, Locale, Phase, UltraViolet, WindDirection
-from .constants import METRIC, IMPERIAL
 from .errors import Error, RequestError
 from .forecast import Forecast
 from .version import VERSION
-from .client import Client
-
 
 __title__ = 'python-weather'
 __author__ = 'null8626'
@@ -18,17 +17,17 @@ __license__ = 'MIT'
 __copyright__ = 'Copyright (c) 2021-2026 null8626'
 __version__ = VERSION
 __all__ = (
-  'METRIC',
   'IMPERIAL',
+  'METRIC',
+  'VERSION',
   'Client',
   'Error',
   'Forecast',
-  'RequestError',
   'HeatIndex',
   'Kind',
   'Locale',
   'Phase',
+  'RequestError',
   'UltraViolet',
-  'VERSION',
   'WindDirection',
 )

{python_weather-2.2.1 → python_weather-2.2.3}/python_weather/base.py

@@ -1,8 +1,12 @@
 # SPDX-License-Identifier: MIT
 # SPDX-FileCopyrightText: 2021-2026 null8626
 
-from .enums import WindDirection, Kind, Locale, UltraViolet
-from .constants import _Unit
+from typing import TYPE_CHECKING
+
+from .enums import Kind, Locale, UltraViolet, WindDirection
+
+if TYPE_CHECKING:
+  from .constants import _Unit
 
 
 class BaseForecast:
@@ -10,17 +14,17 @@ class BaseForecast:
 
   __slots__: tuple[str, ...] = (
     'cloud_cover',
-    'ultraviolet',
+    'description',
+    'feels_like',
     'humidity',
-    'wind_direction',
     'kind',
-    'feels_like',
-    'temperature',
     'precipitation',
     'pressure',
+    'temperature',
+    'ultraviolet',
     'visibility',
+    'wind_direction',
     'wind_speed',
-    'description',
   )
 
   cloud_cover: int
@@ -59,7 +63,7 @@ class BaseForecast:
   description: str
   """The description regarding the forecast depending on the localization used."""
 
-  def __init__(self, json: dict, unit: _Unit, locale: Locale):
+  def __init__(self, json: dict, unit: '_Unit', locale: Locale):
     description = (
       json['weatherDesc'][0]['value']
       if locale is Locale.ENGLISH

{python_weather-2.2.1 → python_weather-2.2.3}/python_weather/client.py

@@ -1,15 +1,16 @@
 # SPDX-License-Identifier: MIT
 # SPDX-FileCopyrightText: 2021-2026 null8626
 
-from aiohttp import ClientSession, ClientTimeout, ClientResponseError, TCPConnector
-from urllib.parse import quote_plus
 from asyncio import sleep
+from urllib.parse import quote_plus
 
+from aiohttp import ClientResponseError, ClientSession, ClientTimeout, TCPConnector
+
+from .constants import METRIC, _Unit
+from .enums import Locale
 from .errors import Error, RequestError
-from .constants import _Unit, METRIC
 from .forecast import Forecast
 from .version import VERSION
-from .enums import Locale
 
 
 class Client:
@@ -47,9 +48,9 @@ class Client:
   __slots__: tuple[str, ...] = (
     '__own_session',
     '__session',
+    '_locale',
     '_max_retries',
     '_unit',
-    '_locale',
   )
 
   __own_session: bool
@@ -64,14 +65,14 @@ class Client:
     unit: _Unit = METRIC,
     locale: Locale = Locale.ENGLISH,
     session: ClientSession | None = None,
-    max_retries: int | None = None,
+    max_retries: int = 3,
   ):
     self.__own_session = session is None
     self.__session = session or ClientSession(
       timeout=ClientTimeout(total=5000.0),
       connector=TCPConnector(ssl=False),
     )
-    self._max_retries = max_retries or 3
+    self._max_retries = max_retries
     self.unit = unit
     self.locale = locale
 

{python_weather-2.2.1 → python_weather-2.2.3}/python_weather/constants.py

@@ -2,20 +2,13 @@
 # SPDX-FileCopyrightText: 2021-2026 null8626
 
 import re
+from dataclasses import dataclass
 
 
+@dataclass(frozen=True, repr=False, slots=True)
 class _Unit:
   """A supported measurement unit."""
 
-  __slots__: tuple[str, ...] = (
-    'temperature',
-    'velocity',
-    'pressure',
-    'precipitation',
-    'visibility',
-    'cm_divisor',
-  )
-
   temperature: str
   velocity: str
   pressure: str
@@ -23,22 +16,6 @@ class _Unit:
   visibility: str
   cm_divisor: float | int
 
-  def __init__(
-    self,
-    temperature: str,
-    velocity: str,
-    pressure: str,
-    precipitation: str,
-    visibility: str,
-    cm_divisor: float | int,
-  ):
-    self.temperature = temperature
-    self.velocity = velocity
-    self.pressure = pressure
-    self.precipitation = precipitation
-    self.visibility = visibility
-    self.cm_divisor = cm_divisor
-
   def __repr__(self) -> str:
     """The unit's debug string representation."""
     return f'<Unit [{self.temperature}, {self.velocity}]>'
@@ -68,5 +45,6 @@ KIND_EMOJIS = (
   '❄️',
   '🌩',
   '⛈',
+  '🌫',
 )
 WIND_DIRECTION_EMOJIS = '↑', '↖', '←', '↙', '↓', '↘', '→', '↗'

{python_weather-2.2.1 → python_weather-2.2.3}/python_weather/enums.py

@@ -295,6 +295,7 @@ class Kind(BasicEnum):
   HEAVY_SNOW_SHOWERS = 335
   THUNDERY_HEAVY_RAIN = 389
   THUNDERY_SNOW_SHOWERS = 392
+  SMOKY_HAZE = 149
 
   @classmethod
   def _missing_(cls, value: object) -> 'Kind | None':

{python_weather-2.2.1 → python_weather-2.2.3}/python_weather/errors.py

@@ -2,28 +2,27 @@
 # SPDX-FileCopyrightText: 2021-2026 null8626
 
 
+from dataclasses import dataclass
+
+
 class Error(Exception):
   """The base error class. Extends :py:class:`Exception`."""
 
   __slots__: tuple[str, ...] = ()
 
 
+@dataclass(frozen=True, repr=False, slots=True)
 class RequestError(Error):
   """Thrown upon HTTP request failure. Extends :class:`.Error`."""
 
-  __slots__: tuple[str, ...] = 'status', 'reason'
-
   status: int | None
   """The status code."""
 
   reason: str | None
   """The reason for this status code."""
 
-  def __init__(self, status: int | None, reason: str | None):
-    self.status = status
-    self.reason = reason
-
-    super().__init__(f'{status}: {reason}')
+  def __post_init__(self) -> None:
+    super(Error, self).__init__(f'{self.status}: {self.reason}')
 
   def __repr__(self) -> str:  # pragma: nocover
     """The error's debug string representation."""

{python_weather-2.2.1 → python_weather-2.2.3}/python_weather/forecast.py

@@ -1,15 +1,16 @@
 # SPDX-License-Identifier: MIT
 # SPDX-FileCopyrightText: 2021-2026 null8626
 
-from datetime import datetime, date, time
-from collections.abc import Iterator
+from datetime import date, datetime, time
 from typing import TYPE_CHECKING
 
-from .enums import Phase, HeatIndex
-from .constants import LATLON_REGEX
 from .base import BaseForecast
+from .constants import LATLON_REGEX
+from .enums import HeatIndex, Phase
 
 if TYPE_CHECKING:
+  from collections.abc import Iterator
+
   from .constants import _Unit
   from .enums import Locale
 
@@ -28,9 +29,9 @@ class HourlyForecast(BaseForecast):
     'chances_of_sunshine',
     'chances_of_thunder',
     'chances_of_windy',
-    'time',
     'dew_point',
     'heat_index',
+    'time',
     'wind_chill',
     'wind_gust',
   )
@@ -121,19 +122,19 @@ class DailyForecast:
   """A weather forecast for a specific day."""
 
   __slots__: tuple[str, ...] = (
+    'date',
+    'highest_temperature',
+    'hourly_forecasts',
+    'lowest_temperature',
     'moon_illumination',
     'moon_phase',
     'moonrise',
     'moonset',
+    'snowfall',
+    'sunlight',
     'sunrise',
     'sunset',
-    'date',
-    'sunlight',
-    'lowest_temperature',
-    'highest_temperature',
     'temperature',
-    'snowfall',
-    'hourly_forecasts',
   )
 
   moon_illumination: int
@@ -209,7 +210,7 @@ class DailyForecast:
     """The amount of hourly forecasts."""
     return len(self.hourly_forecasts)
 
-  def __iter__(self) -> Iterator[HourlyForecast]:
+  def __iter__(self) -> 'Iterator[HourlyForecast]':
     """Iterates through the hourly forecasts."""
     return iter(self.hourly_forecasts)
 
@@ -218,13 +219,13 @@ class Forecast(BaseForecast):
   """A set of weather forecasts for a certain location."""
 
   __slots__: tuple[str, ...] = (
-    'local_population',
-    'region',
-    'location',
-    'country',
-    'datetime',
     'coordinates',
+    'country',
     'daily_forecasts',
+    'datetime',
+    'local_population',
+    'location',
+    'region',
   )
 
   local_population: int
@@ -256,7 +257,10 @@ class Forecast(BaseForecast):
     self.region = nearest['region'][0]['value']
     self.location = nearest['areaName'][0]['value']
     self.country = nearest['country'][0]['value']
-    self.datetime = datetime.strptime(current['localObsDateTime'], '%Y-%m-%d %I:%M %p')
+    self.datetime = datetime.combine(
+      datetime.today(),
+      datetime.strptime(current['observation_time'], '%I:%M %p').time(),
+    )
 
     try:
       req = next(filter(lambda x: x['type'] == 'LatLon', json['request']))
@@ -283,6 +287,6 @@ class Forecast(BaseForecast):
     """The amount of daily forecasts."""
     return len(self.daily_forecasts)
 
-  def __iter__(self) -> Iterator[DailyForecast]:
+  def __iter__(self) -> 'Iterator[DailyForecast]':
     """Iterates through the daily forecasts."""
     return iter(self.daily_forecasts)

{python_weather-2.2.1 → python_weather-2.2.3}/python_weather/version.py

@@ -1,4 +1,4 @@
 # SPDX-License-Identifier: MIT
 # SPDX-FileCopyrightText: 2021-2026 null8626
 
-VERSION = '2.2.1'
+VERSION = '2.2.3'

{python_weather-2.2.1 → python_weather-2.2.3/python_weather.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-weather
-Version: 2.2.1
+Version: 2.2.3
 Summary: A free and asynchronous weather API wrapper made in Python, for Python.
 Author: null8626
 License-Expression: MIT
@@ -33,7 +33,14 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp>=3.13.5
+Requires-Dist: aiohttp>=3.14.3
+Provides-Extra: dev
+Requires-Dist: mock>=5.2.0; extra == "dev"
+Requires-Dist: pytest>=9.1.1; extra == "dev"
+Requires-Dist: pytest-asyncio>=1.4.0; extra == "dev"
+Requires-Dist: pytest-cov>=7.1.0; extra == "dev"
+Requires-Dist: multidict>=6.7.1; extra == "dev"
+Requires-Dist: yarl>=1.24.5; extra == "dev"
 Dynamic: license-file
 
 # [python-weather][pypi-url] [![pypi][pypi-image]][pypi-url] [![pypi downloads][pypi-downloads-image]][pypi-url] [![codacy-badge][codacy-image]][codacy-url] [![codecov-badge][codecov-image]][codecov-url] [![ko-fi][ko-fi-brief-image]][ko-fi-url]
@@ -71,24 +78,24 @@ import asyncio
 
 
 async def main() -> None:
-  
+
   # Declare the client. The measuring unit used defaults to the metric system (celcius, km/h, etc.)
   async with python_weather.Client(unit=python_weather.IMPERIAL) as client:
-    
     # Fetch a weather forecast from a city.
     weather = await client.get('New York')
-    
+
     # Fetch the temperature for today.
     print(weather.temperature)
-    
+
     # Fetch weather forecast for upcoming days.
     for daily in weather:
       print(daily)
-    
+
       # Each daily forecast has their own hourly forecasts.
       for hourly in daily:
         print(f' --> {hourly!r}')
 
+
 if __name__ == '__main__':
   asyncio.run(main())
 ```

python_weather-2.2.3/python_weather.egg-info/requires.txt

@@ -0,0 +1,9 @@
+aiohttp>=3.14.3
+
+[dev]
+mock>=5.2.0
+pytest>=9.1.1
+pytest-asyncio>=1.4.0
+pytest-cov>=7.1.0
+multidict>=6.7.1
+yarl>=1.24.5

python_weather-2.2.1/python_weather.egg-info/requires.txt

@@ -1 +0,0 @@
-aiohttp>=3.13.5