python-weather 2.1.1__tar.gz → 2.2.0__tar.gz

{python_weather-2.1.1 → python_weather-2.2.0}/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2021-2025 null8626
+Copyright (c) 2021-2026 null8626
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

{python_weather-2.1.1/python_weather.egg-info → python_weather-2.2.0}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: python-weather
-Version: 2.1.1
+Version: 2.2.0
 Summary: A free and asynchronous weather API wrapper made in Python, for Python.
 Author: null8626
-License: MIT
+License-Expression: MIT
 Project-URL: Documentation, https://python-weather.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/null8626/python-weather
 Project-URL: Changelog, https://python-weather.readthedocs.io/en/latest/changelog.html
@@ -33,7 +33,7 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp>=3.13.2
+Requires-Dist: aiohttp>=3.13.5
 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]

{python_weather-2.1.1 → python_weather-2.2.0}/pyproject.toml

@@ -3,13 +3,13 @@ requires = ["setuptools"]
 
 [project]
 name = "python-weather"
-version = "2.1.1"
+version = "2.2.0"
 description = "A free and asynchronous weather API wrapper made in Python, for Python."
 readme = "README.md"
-license = { text = "MIT" }
+license = "MIT"
 authors = [{ name = "null8626" }]
 keywords = ["weather", "forecast", "weather-forecast"]
-dependencies = ["aiohttp>=3.13.2"]
+dependencies = ["aiohttp>=3.13.5"]
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Education",

python_weather-2.2.0/python_weather/__init__.py

@@ -0,0 +1,34 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021-2026 null8626
+
+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'
+__credits__ = (__author__,)
+__maintainer__ = __author__
+__status__ = 'Production'
+__license__ = 'MIT'
+__copyright__ = 'Copyright (c) 2021-2026 null8626'
+__version__ = VERSION
+__all__ = (
+  'METRIC',
+  'IMPERIAL',
+  'Client',
+  'Error',
+  'Forecast',
+  'RequestError',
+  'HeatIndex',
+  'Kind',
+  'Locale',
+  'Phase',
+  'UltraViolet',
+  'VERSION',
+  'WindDirection',
+)

python_weather-2.2.0/python_weather/base.py

@@ -0,0 +1,82 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021-2026 null8626
+
+from .enums import WindDirection, Kind, Locale, UltraViolet
+from .constants import _Unit
+
+
+class BaseForecast:
+  """A base weather forecast."""
+
+  __slots__: tuple[str, ...] = (
+    'cloud_cover',
+    'ultraviolet',
+    'humidity',
+    'wind_direction',
+    'kind',
+    'feels_like',
+    'temperature',
+    'precipitation',
+    'pressure',
+    'visibility',
+    'wind_speed',
+    'description',
+  )
+
+  cloud_cover: int
+  """The cloud cover value in percent."""
+
+  ultraviolet: UltraViolet
+  """The ultra-violet index."""
+
+  humidity: int
+  """The humidity value in percent."""
+
+  wind_direction: WindDirection
+  """The wind direction."""
+
+  kind: Kind
+  """The kind of the forecast."""
+
+  feels_like: int
+  """What it felt like in either celcius or fahrenheit."""
+
+  temperature: int
+  """The temperature in either celcius or fahrenheit."""
+
+  precipitation: float
+  """The precipitation in either millimeters or inches."""
+
+  pressure: float
+  """The pressure in either pascal or inches."""
+
+  visibility: int
+  """The visibility distance in either kilometers or miles."""
+
+  wind_speed: int
+  """The wind speeds in either kilometers/hour or miles/hour."""
+
+  description: str
+  """The description regarding the forecast depending on the localization used."""
+
+  def __init__(self, json: dict, unit: _Unit, locale: Locale):
+    description = (
+      json['weatherDesc'][0]['value']
+      if locale is Locale.ENGLISH
+      else json[f'lang_{locale.value}'][0]['value']
+    )
+
+    self.cloud_cover = int(json['cloudcover'])
+    self.ultraviolet = UltraViolet._new(int(json['uvIndex']))
+    self.humidity = int(json['humidity'])
+    self.wind_direction = WindDirection._new(
+      json['winddir16Point'], int(json['winddirDegree'])
+    )
+    self.kind = Kind(int(json['weatherCode']))
+    self.feels_like = int(json[f'FeelsLike{unit.temperature}'])
+    self.temperature = int(json[f'temp_{unit.temperature}'])
+    self.precipitation = float(json[f'precip{unit.precipitation}'])
+    self.pressure = float(json[f'pressure{unit.pressure}'])
+    self.visibility = int(json[f'visibility{unit.visibility}'])
+    self.wind_speed = int(json[f'windspeed{unit.velocity}'])
+    self.description = description.strip()

{python_weather-2.1.1 → python_weather-2.2.0}/python_weather/client.py

@@ -1,26 +1,5 @@
-"""
-The MIT License (MIT)
-
-Copyright (c) 2021-2025 null8626
-
-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.
-"""
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021-2026 null8626
 
 from aiohttp import ClientSession, ClientTimeout, ClientResponseError, TCPConnector
 from urllib.parse import quote_plus
@@ -28,13 +7,12 @@ from asyncio import sleep
 
 from .errors import Error, RequestError
 from .constants import _Unit, METRIC
-from .base import CustomizableBase
 from .forecast import Forecast
 from .version import VERSION
 from .enums import Locale
 
 
-class Client(CustomizableBase):
+class Client:
   """
   Interact with the API's endpoints.
 
@@ -66,11 +44,19 @@ class Client(CustomizableBase):
   :exception Error: ``unit`` is not :data:`~.constants.METRIC` or :data:`~.constants.IMPERIAL` or ``locale`` is not a part of the :class:`.Locale` enum.
   """
 
-  __slots__: tuple[str, ...] = '__own_session', '__session', '_max_retries'
+  __slots__: tuple[str, ...] = (
+    '__own_session',
+    '__session',
+    '_max_retries',
+    '_unit',
+    '_locale',
+  )
 
   __own_session: bool
   __session: ClientSession
   _max_retries: int
+  _unit: _Unit
+  _locale: Locale
 
   def __init__(
     self,
@@ -80,18 +66,58 @@ class Client(CustomizableBase):
     session: ClientSession | None = None,
     max_retries: int | None = None,
   ):
-    super().__init__(unit, locale)
-
     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.unit = unit
+    self.locale = locale
 
   def __repr__(self) -> str:
+    """The client's debug string representation."""
     return f'<{__class__.__module__}.{__class__.__name__} {self.__session!r}>'
 
+  @property
+  def unit(self) -> _Unit:
+    """The measuring unit used."""
+    return self._unit
+
+  @unit.setter
+  def unit(self, to: _Unit) -> None:
+    """
+    Sets the default measuring unit used.
+
+    :param to: The new default measuring unit to be used.
+
+    :exception Error: ``to`` is not either :data:`~.constants.METRIC` or :data:`~.constants.IMPERIAL`.
+    """
+    if not isinstance(to, _Unit):
+      raise Error('Invalid measuring unit specified!')
+
+    self._unit = to
+
+  @property
+  def locale(self) -> Locale:
+    """The localization used."""
+    return self._locale
+
+  @locale.setter
+  def locale(self, to: Locale) -> None:
+    """
+    Sets the default localization used.
+
+    :param to: The new :class:`.Locale` to be used.
+    :type to: :class:`.Locale`
+
+    :exception Error: ``to`` is not a part of the :class:`.Locale` enum.
+    """
+    if not isinstance(to, Locale):
+      raise Error(f'Expected {to!r} to be a Locale enum')
+
+    self._locale = to
+
   async def get(
     self,
     location: str,
@@ -115,19 +141,20 @@ class Client(CustomizableBase):
     :param locale: Overrides the locale used.
     :type locale: :class:`.Locale` | :py:obj:`None`
 
-    :exception TypeError: ``location`` is not a :py:class:`str` or is empty.
+    :exception TypeError: The specified location is not a string.
+    :exception ValueError: The specified location is empty.
     :exception Error: The client is already closed.
     :exception RequestError: The client received a non-favorable response from the API.
 
     :returns: The requested weather forecast.
     :rtype: Forecast
     """
-
     if self.__session.closed:
       raise Error('Client session is already closed.')
-
-    elif not isinstance(location, str) or not location:
-      raise TypeError(f'Expected a proper location str, got {location!r}')
+    elif not isinstance(location, str):
+      raise TypeError('The specified location must be a string.')
+    elif not location:
+      raise ValueError('The specified location must not be empty.')
 
     if not isinstance(unit, _Unit):
       unit = self._unit
@@ -155,7 +182,9 @@ class Client(CustomizableBase):
 
           resp.raise_for_status()
 
-          return Forecast(await resp.json(), unit, locale)
+          return Forecast(
+            await resp.json(content_type='application/text'), unit, locale
+          )
       except ClientResponseError:
         if attempts == self._max_retries:
           raise RequestError(status, reason) from None
@@ -165,7 +194,7 @@ class Client(CustomizableBase):
 
   async def close(self) -> None:
     """
-    Closes the :class:`.Client` object.
+    Closes the client.
 
     Example:
 
@@ -173,12 +202,13 @@ class Client(CustomizableBase):
 
       await client.close()
     """
-
     if self.__own_session and not self.__session.closed:
       await self.__session.close()
 
   async def __aenter__(self) -> 'Client':
+    """Starts using the client. This method is no-op and just returns itself."""
     return self
 
   async def __aexit__(self, *_, **__) -> None:
+    """Closes the client."""
     await self.close()

python_weather-2.2.0/python_weather/constants.py

@@ -0,0 +1,72 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021-2026 null8626
+
+import re
+
+
+class _Unit:
+  """A supported measurement unit."""
+
+  __slots__: tuple[str, ...] = (
+    'temperature',
+    'velocity',
+    'pressure',
+    'precipitation',
+    'visibility',
+    'cm_divisor',
+  )
+
+  temperature: str
+  velocity: str
+  pressure: str
+  precipitation: str
+  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}]>'
+
+
+METRIC = _Unit('C', 'Kmph', '', 'MM', '', 1)
+IMPERIAL = _Unit('F', 'Miles', 'Inches', 'Inches', 'Miles', 2.54)
+
+LATLON_REGEX = re.compile(r'^Lat (\-?[\d\.]+) and Lon (\-?[\d\.]+)$')
+
+KIND_EMOJIS = (
+  '☀️',
+  '⛅️',
+  '☁️',
+  '☁️',
+  '🌫',
+  '🌦',
+  '🌧',
+  '🌧',
+  '⛈',
+  '🌨',
+  '❄️',
+  '🌦',
+  '🌧',
+  '🌧',
+  '🌨',
+  '❄️',
+  '🌩',
+  '⛈',
+)
+WIND_DIRECTION_EMOJIS = '↑', '↖', '←', '↙', '↓', '↘', '→', '↗'

{python_weather-2.1.1 → python_weather-2.2.0}/python_weather/enums.py

@@ -1,73 +1,70 @@
-"""
-The MIT License (MIT)
-
-Copyright (c) 2021-2025 null8626
-
-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.
-"""
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021-2026 null8626
 
 from enum import Enum
 
-from .constants import WIND_DIRECTION_EMOJIS
+from .constants import KIND_EMOJIS, WIND_DIRECTION_EMOJIS
 
 
 class BasicEnum(Enum):
+  """An ordinary enum."""
+
   __slots__: tuple[str, ...] = ()
 
   def __repr__(self) -> str:
+    """The enum's debug string representation."""
     return f'{self.__class__.__name__}.{self.name}'
 
   def __str__(self) -> str:
+    """The enum's friendly name."""
     return self.name.replace('_', ' ').title()
 
+  @property
+  def _index(self) -> int:
+    return next(filter(lambda kind: self is kind[1], enumerate(self.__class__)))[0]
+
 
 class IndexedEnum(Enum):
+  """An enum that carries an index value."""
+
   __slots__: tuple[str, ...] = ('index',)
 
   index: int
   """The index value."""
 
   def __lt__(self, other: 'IndexedEnum | float | int') -> bool:
+    """Checks if the enum's index value is less than the other."""
     return float(self.index) < float(other)
 
   def __le__(self, other: 'IndexedEnum | float | int') -> bool:
+    """Checks if the enum's index value is less than or equal to the other."""
     return float(self.index) <= float(other)
 
   def __eq__(self, other: object) -> bool:
+    """Checks if the enum's index value is equal to the other."""
     if other_float := getattr(other, '__float__', None):
       return float(self.index) == other_float()
 
     return False  # pragma: nocover
 
   def __gt__(self, other: 'IndexedEnum | float | int') -> bool:
+    """Checks if the enum's index value is greater than the other."""
     return float(self.index) > float(other)
 
   def __ge__(self, other: 'IndexedEnum | float | int') -> bool:
+    """Checks if the enum's index value is greater than or equal to the other."""
     return float(self.index) >= float(other)
 
   def __hash__(self) -> int:
+    """The enum's index value."""
     return self.index
 
   def __int__(self) -> int:
+    """The enum's index value."""
     return self.index
 
   def __float__(self) -> float:
+    """The floating point representation of the enum's index value."""
     return float(self.index)
 
 
@@ -157,7 +154,7 @@ class WindDirection(BasicEnum):
   NORTH_NORTHWEST = 'NNW'
 
   degrees: float
-  """The wind direction's value in degrees."""
+  """The wind direction's angle in degrees."""
 
   @staticmethod
   def _new(value: str, degrees: float) -> 'WindDirection':
@@ -167,56 +164,27 @@ class WindDirection(BasicEnum):
     return enum
 
   def __contains__(self, other: 'WindDirection | float | int') -> bool:
-    other = float(other)
-
-    if self is self.NORTH:
-      return other > 348.75 or other <= 11.25
-    elif self is self.NORTH_NORTHEAST:
-      return 11.25 < other <= 33.75
-    elif self is self.NORTHEAST:
-      return 33.75 < other <= 56.25
-    elif self is self.EAST_NORTHEAST:
-      return 56.25 < other <= 78.75
-    elif self is self.EAST:
-      return 78.75 < other <= 101.25
-    elif self is self.EAST_SOUTHEAST:
-      return 101.25 < other <= 123.75
-    elif self is self.SOUTHEAST:
-      return 123.75 < other <= 146.25
-    elif self is self.SOUTH_SOUTHEAST:
-      return 146.25 < other <= 168.75
-    elif self is self.SOUTH:
-      return 168.75 < other <= 191.25
-    elif self is self.SOUTH_SOUTHWEST:
-      return 191.25 < other <= 213.75
-    elif self is self.SOUTHWEST:
-      return 213.75 < other <= 236.25
-    elif self is self.WEST_SOUTHWEST:
-      return 236.25 < other <= 258.75
-    elif self is self.WEST:
-      return 258.75 < other <= 281.25
-    elif self is self.WEST_NORTHWEST:
-      return 281.25 < other <= 303.75
-    elif self is self.NORTHWEST:
-      return 303.75 < other <= 326.25
-    else:
-      return 326.25 < other <= 348.75
+    """Checks if the other's angle is within the enum's wind direction."""
+    members = list(self.__class__)
+
+    return self is members[int(((float(other) % 360) + 11.25) // 22.5) % len(members)]
 
   def __int__(self) -> int:
+    """The integer representation of the wind direction's angle."""
     return int(self.degrees)
 
   def __float__(self) -> float:
+    """The wind direction's angle."""
     return self.degrees
 
   @property
   def emoji(self) -> str:
-    """Emoji representation."""
-
-    return WIND_DIRECTION_EMOJIS[int(((self.degrees + 22.5) % 360) / 45.0)]
+    """The wind direction's emoji representation."""
+    return WIND_DIRECTION_EMOJIS[int(((self.degrees + 22.5) % 360) // 45)]
 
 
 class Locale(Enum):
-  """Supported locales/languages."""
+  """A supported locale."""
 
   __slots__: tuple[str, ...] = ()
 
@@ -294,9 +262,11 @@ class Locale(Enum):
   ZULU = 'zu'
 
   def __repr__(self) -> str:
+    """The locale's debug string representation."""
     return f'{__class__.__name__}.{self.name}'
 
   def __str__(self) -> str:
+    """The locale's friendly name."""
     arr = self.name.title().split('_')
 
     return f'{" ".join(arr[:-1])} ({arr[-1]})' if len(arr) != 1 else arr[0]
@@ -355,44 +325,8 @@ class Kind(BasicEnum):
 
   @property
   def emoji(self) -> str:
-    """Emoji representation."""
-
-    if self is self.CLOUDY:
-      return '☁️'
-    elif self is self.FOG:
-      return '🌫'
-    elif self is self.HEAVY_RAIN:
-      return '🌧'
-    elif self is self.HEAVY_SHOWERS:
-      return '🌧'
-    elif self is self.HEAVY_SNOW:
-      return '❄️'
-    elif self is self.HEAVY_SNOW_SHOWERS:
-      return '❄️'
-    elif self is self.LIGHT_RAIN:
-      return '🌦'
-    elif self is self.LIGHT_SHOWERS:
-      return '🌦'
-    elif self is self.LIGHT_SLEET:
-      return '🌧'
-    elif self is self.LIGHT_SLEET_SHOWERS:
-      return '🌧'
-    elif self is self.LIGHT_SNOW:
-      return '🌨'
-    elif self is self.LIGHT_SNOW_SHOWERS:
-      return '🌨'
-    elif self is self.PARTLY_CLOUDY:
-      return '⛅️'
-    elif self is self.SUNNY:
-      return '☀️'
-    elif self is self.THUNDERY_HEAVY_RAIN:
-      return '🌩'
-    elif self is self.THUNDERY_SHOWERS:
-      return '⛈'
-    elif self is self.THUNDERY_SNOW_SHOWERS:
-      return '⛈'
-    else:
-      return '☁️'
+    """The weather forecast kind's emoji representation."""
+    return KIND_EMOJIS[self._index]
 
 
 class Phase(BasicEnum):
@@ -411,21 +345,5 @@ class Phase(BasicEnum):
 
   @property
   def emoji(self) -> str:
-    """Emoji representation."""
-
-    if self is self.NEW_MOON:
-      return '🌑'
-    elif self is self.WAXING_CRESCENT:
-      return '🌒'
-    elif self is self.FIRST_QUARTER:
-      return '🌓'
-    elif self is self.WAXING_GIBBOUS:
-      return '🌔'
-    elif self is self.FULL_MOON:
-      return '🌕'
-    elif self is self.WANING_GIBBOUS:
-      return '🌖'
-    elif self is self.LAST_QUARTER:
-      return '🌗'
-    else:
-      return '🌘'
+    """The moon phase's emoji representation."""
+    return chr(0x1F311 + self._index)

python_weather-2.2.0/python_weather/errors.py

@@ -0,0 +1,30 @@
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021-2026 null8626
+
+
+class Error(Exception):
+  """The base error class. Extends :py:class:`Exception`."""
+
+  __slots__: tuple[str, ...] = ()
+
+
+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 __repr__(self) -> str:  # pragma: nocover
+    """The error's debug string representation."""
+    return f'<{__class__.__module__}.{__class__.__name__} status={self.status} reason={self.reason!r}>'

{python_weather-2.1.1 → python_weather-2.2.0}/python_weather/forecast.py

@@ -1,26 +1,5 @@
-"""
-The MIT License (MIT)
-
-Copyright (c) 2021-2025 null8626
-
-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.
-"""
+# SPDX-License-Identifier: MIT
+# SPDX-FileCopyrightText: 2021-2026 null8626
 
 from datetime import datetime, date, time
 from collections.abc import Iterator
@@ -134,6 +113,7 @@ class HourlyForecast(BaseForecast):
     super().__init__(json, unit, locale)
 
   def __repr__(self) -> str:
+    """The forecast's debug string representation."""
     return f'<{__class__.__module__}.{__class__.__name__} time={self.time!r} temperature={self.temperature} kind={self.kind!r}>'
 
 
@@ -222,12 +202,15 @@ class DailyForecast:
       ...
 
   def __repr__(self) -> str:
+    """The forecast's debug string representation."""
     return f'<{__class__.__module__}.{__class__.__name__} date={self.date!r} temperature={self.temperature}>'
 
   def __len__(self) -> int:
+    """The amount of hourly forecasts."""
     return len(self.hourly_forecasts)
 
   def __iter__(self) -> Iterator[HourlyForecast]:
+    """Iterates through the hourly forecasts."""
     return iter(self.hourly_forecasts)
 
 
@@ -293,10 +276,13 @@ class Forecast(BaseForecast):
     super().__init__(current, unit, locale)
 
   def __repr__(self) -> str:
+    """The forecast's debug string representation."""
     return f'<{__class__.__module__}.{__class__.__name__} location={self.location!r} datetime={self.datetime!r} temperature={self.temperature}>'
 
   def __len__(self) -> int:
+    """The amount of daily forecasts."""
     return len(self.daily_forecasts)
 
   def __iter__(self) -> Iterator[DailyForecast]:
+    """Iterates through the daily forecasts."""
     return iter(self.daily_forecasts)

python_weather-2.2.0/python_weather/version.py

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

{python_weather-2.1.1 → python_weather-2.2.0/python_weather.egg-info}/PKG-INFO

@@ -1,9 +1,9 @@
 Metadata-Version: 2.4
 Name: python-weather
-Version: 2.1.1
+Version: 2.2.0
 Summary: A free and asynchronous weather API wrapper made in Python, for Python.
 Author: null8626
-License: MIT
+License-Expression: MIT
 Project-URL: Documentation, https://python-weather.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/null8626/python-weather
 Project-URL: Changelog, https://python-weather.readthedocs.io/en/latest/changelog.html
@@ -33,7 +33,7 @@ Classifier: Programming Language :: Python :: 3.14
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp>=3.13.2
+Requires-Dist: aiohttp>=3.13.5
 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]

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

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

python_weather-2.1.1/python_weather/__init__.py

@@ -1,55 +0,0 @@
-"""
-The MIT License (MIT)
-
-Copyright (c) 2021-2025 null8626
-
-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.
-"""
-
-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'
-__credits__ = (__author__,)
-__maintainer__ = __author__
-__status__ = 'Production'
-__license__ = 'MIT'
-__copyright__ = 'Copyright (c) 2021-2025 null8626'
-__version__ = VERSION
-__all__ = (
-  'METRIC',
-  'IMPERIAL',
-  'Client',
-  'Error',
-  'Forecast',
-  'RequestError',
-  'HeatIndex',
-  'Kind',
-  'Locale',
-  'Phase',
-  'UltraViolet',
-  'VERSION',
-  'WindDirection',
-)

python_weather-2.1.1/python_weather/base.py

@@ -1,156 +0,0 @@
-"""
-The MIT License (MIT)
-
-Copyright (c) 2021-2025 null8626
-
-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.
-"""
-
-from .enums import WindDirection, Kind, Locale, UltraViolet
-from .constants import _Unit
-from .errors import Error
-
-
-class CustomizableBase:
-  __slots__: tuple[str, ...] = '_unit', '_locale'
-
-  _unit: _Unit
-  _locale: Locale
-
-  def __init__(self, unit: _Unit, locale: Locale):
-    self.unit = unit
-    self.locale = locale
-
-  @property
-  def unit(self) -> _Unit:
-    """The measuring unit used."""
-
-    return self._unit
-
-  @unit.setter
-  def unit(self, to: _Unit) -> None:
-    """
-    Sets the default measuring unit used.
-
-    :param to: The new default measuring unit to be used.
-
-    :exception Error: ``to`` is not either :data:`~.constants.METRIC` or :data:`~.constants.IMPERIAL`.
-    """
-
-    if not isinstance(to, _Unit):
-      raise Error('Invalid measuring unit specified!')
-
-    self._unit = to
-
-  @property
-  def locale(self) -> Locale:
-    """The localization used."""
-
-    return self._locale
-
-  @locale.setter
-  def locale(self, to: Locale) -> None:
-    """
-    Sets the default localization used.
-
-    :param to: The new :class:`.Locale` to be used.
-    :type to: :class:`.Locale`
-
-    :exception Error: ``to`` is not a part of the :class:`.Locale` enum.
-    """
-
-    if not isinstance(to, Locale):
-      raise Error(f'Expected {to!r} to be a Locale enum')
-
-    self._locale = to
-
-
-class BaseForecast:
-  __slots__: tuple[str, ...] = (
-    'cloud_cover',
-    'ultraviolet',
-    'humidity',
-    'wind_direction',
-    'kind',
-    'feels_like',
-    'temperature',
-    'precipitation',
-    'pressure',
-    'visibility',
-    'wind_speed',
-    'description',
-  )
-
-  cloud_cover: int
-  """The cloud cover value in percent."""
-
-  ultraviolet: UltraViolet
-  """The ultra-violet index."""
-
-  humidity: int
-  """The humidity value in percent."""
-
-  wind_direction: WindDirection
-  """The wind direction."""
-
-  kind: Kind
-  """The kind of the forecast."""
-
-  feels_like: int
-  """What it felt like in either celcius or fahrenheit."""
-
-  temperature: int
-  """The temperature in either celcius or fahrenheit."""
-
-  precipitation: float
-  """The precipitation in either millimeters or inches."""
-
-  pressure: float
-  """The pressure in either pascal or inches."""
-
-  visibility: int
-  """The visibility distance in either kilometers or miles."""
-
-  wind_speed: int
-  """The wind speeds in either kilometers/hour or miles/hour."""
-
-  description: str
-  """The description regarding the forecast depending on the localization used."""
-
-  def __init__(self, json: dict, unit: _Unit, locale: Locale):
-    description = (
-      json['weatherDesc'][0]['value']
-      if locale is Locale.ENGLISH
-      else json[f'lang_{locale.value}'][0]['value']
-    )
-
-    self.cloud_cover = int(json['cloudcover'])
-    self.ultraviolet = UltraViolet._new(int(json['uvIndex']))
-    self.humidity = int(json['humidity'])
-    self.wind_direction = WindDirection._new(
-      json['winddir16Point'], int(json['winddirDegree'])
-    )
-    self.kind = Kind(int(json['weatherCode']))
-    self.feels_like = int(json[f'FeelsLike{unit.temperature}'])
-    self.temperature = int(json[f'temp_{unit.temperature}'])
-    self.precipitation = float(json[f'precip{unit.precipitation}'])
-    self.pressure = float(json[f'pressure{unit.pressure}'])
-    self.visibility = int(json[f'visibility{unit.visibility}'])
-    self.wind_speed = int(json[f'windspeed{unit.velocity}'])
-    self.description = description.strip()

python_weather-2.1.1/python_weather/constants.py

@@ -1,69 +0,0 @@
-"""
-The MIT License (MIT)
-
-Copyright (c) 2021-2025 null8626
-
-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.
-"""
-
-import re
-
-
-class _Unit:
-  __slots__: tuple[str, ...] = (
-    'temperature',
-    'velocity',
-    'pressure',
-    'precipitation',
-    'visibility',
-    'cm_divisor',
-  )
-
-  temperature: str
-  velocity: str
-  pressure: str
-  precipitation: str
-  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:
-    return f'<Unit [{self.temperature}, {self.velocity}]>'
-
-
-METRIC = _Unit('C', 'Kmph', '', 'MM', '', 1)
-IMPERIAL = _Unit('F', 'Miles', 'Inches', 'Inches', 'Miles', 2.54)
-
-WIND_DIRECTION_EMOJIS = '↓', '↙', '←', '↖', '↑', '↗', '→', '↘'
-LATLON_REGEX = re.compile(r'^Lat (\-?[\d\.]+) and Lon (\-?[\d\.]+)$')

python_weather-2.1.1/python_weather/errors.py

@@ -1,50 +0,0 @@
-"""
-The MIT License (MIT)
-
-Copyright (c) 2021-2025 null8626
-
-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.
-"""
-
-
-class Error(Exception):
-  """The base error class. Extends :py:class:`Exception`."""
-
-  __slots__: tuple[str, ...] = ()
-
-
-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 __repr__(self) -> str:  # pragma: nocover
-    return f'<{__class__.__module__}.{__class__.__name__} status={self.status} reason={self.reason!r}>'

python_weather-2.1.1/python_weather/version.py

@@ -1 +0,0 @@
-VERSION = '3.0.0'

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

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