python-weather 2.0.6__tar.gz → 2.1.0__tar.gz

{python_weather-2.0.6 → python_weather-2.1.0}/LICENSE

@@ -1,6 +1,6 @@
 The MIT License (MIT)
 
-Copyright (c) 2021-2024 null8626
+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

{python_weather-2.0.6/python_weather.egg-info → python_weather-2.1.0}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-weather
-Version: 2.0.6
+Version: 2.1.0
 Summary: A free and asynchronous weather API wrapper made in Python, for Python.
 Author: null8626
 License: MIT
@@ -26,16 +26,16 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp>=3.10.10
+Requires-Dist: aiohttp>=3.12.4
+Dynamic: license-file
 
 # [python-weather][pypi-url] [![pypi][pypi-image]][pypi-url] [![downloads][downloads-image]][pypi-url] [![codacy-badge][codacy-url]][codacy-image] [![ko-fi][ko-fi-brief-image]][ko-fi-url]
 
@@ -50,10 +50,12 @@ Requires-Dist: aiohttp>=3.10.10
 
 A free and asynchronous weather Python API wrapper made in Python, for Python.
 
-## Installation
+## Getting started
+
+Run the following command in your terminal:
 
 ```console
-pip install python-weather
+$ pip install python-weather
 ```
 
 ## Example
@@ -61,36 +63,40 @@ pip install python-weather
 For more information, please read the [documentation](https://python-weather.readthedocs.io/en/latest/).
 
 ```py
-# import the module
+# Import the module.
 import python_weather
 
 import asyncio
 import os
 
-async def getweather() -> None:
-  # declare the client. the measuring unit used defaults to the metric system (celcius, km/h, etc.)
+
+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
+    
+    # Fetch a weather forecast from a city.
     weather = await client.get('New York')
     
-    # returns the current day's forecast temperature (int)
+    # Fetch the temperature for today.
     print(weather.temperature)
     
-    # get the weather forecast for a few days
+    # Fetch weather forecast for upcoming days.
     for daily in weather:
       print(daily)
-      
-      # hourly forecasts
+    
+      # Each daily forecast has their own hourly forecasts.
       for hourly in daily:
         print(f' --> {hourly!r}')
 
 if __name__ == '__main__':
-  # see https://stackoverflow.com/questions/45600579/asyncio-event-loop-is-closed-when-getting-loop
-  # for more details
+  
+  # See https://stackoverflow.com/questions/45600579/asyncio-event-loop-is-closed-when-getting-loop
+  # for more details.
   if os.name == 'nt':
     asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
   
-  asyncio.run(getweather())
+  asyncio.run(main())
 ```
 
 ## Data source

{python_weather-2.0.6 → python_weather-2.1.0}/README.md

@@ -11,10 +11,12 @@
 
 A free and asynchronous weather Python API wrapper made in Python, for Python.
 
-## Installation
+## Getting started
+
+Run the following command in your terminal:
 
 ```console
-pip install python-weather
+$ pip install python-weather
 ```
 
 ## Example
@@ -22,36 +24,40 @@ pip install python-weather
 For more information, please read the [documentation](https://python-weather.readthedocs.io/en/latest/).
 
 ```py
-# import the module
+# Import the module.
 import python_weather
 
 import asyncio
 import os
 
-async def getweather() -> None:
-  # declare the client. the measuring unit used defaults to the metric system (celcius, km/h, etc.)
+
+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
+    
+    # Fetch a weather forecast from a city.
     weather = await client.get('New York')
     
-    # returns the current day's forecast temperature (int)
+    # Fetch the temperature for today.
     print(weather.temperature)
     
-    # get the weather forecast for a few days
+    # Fetch weather forecast for upcoming days.
     for daily in weather:
       print(daily)
-      
-      # hourly forecasts
+    
+      # Each daily forecast has their own hourly forecasts.
       for hourly in daily:
         print(f' --> {hourly!r}')
 
 if __name__ == '__main__':
-  # see https://stackoverflow.com/questions/45600579/asyncio-event-loop-is-closed-when-getting-loop
-  # for more details
+  
+  # See https://stackoverflow.com/questions/45600579/asyncio-event-loop-is-closed-when-getting-loop
+  # for more details.
   if os.name == 'nt':
     asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
   
-  asyncio.run(getweather())
+  asyncio.run(main())
 ```
 
 ## Data source

{python_weather-2.0.6 → python_weather-2.1.0}/pyproject.toml

@@ -3,13 +3,13 @@ requires = ["setuptools"]
 
 [project]
 name = "python-weather"
-version = "2.0.6"
+version = "2.1.0"
 description = "A free and asynchronous weather API wrapper made in Python, for Python."
 readme = "README.md"
 license = { text = "MIT" }
 authors = [{ name = "null8626" }]
 keywords = ["weather", "forecast", "weather-api", "weather-forecast"]
-dependencies = ["aiohttp>=3.10.10"]
+dependencies = ["aiohttp>=3.12.4"]
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Education",
@@ -27,14 +27,13 @@ classifiers = [
   "Programming Language :: Python",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
-  "Programming Language :: Python :: 3.8",
   "Programming Language :: Python :: 3.9",
   "Programming Language :: Python :: 3.10",
   "Programming Language :: Python :: 3.11",
   "Programming Language :: Python :: 3.12",
   "Programming Language :: Python :: 3.13"
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.9"
 
 [project.urls]
 Documentation = "https://python-weather.readthedocs.io/en/latest/"

{python_weather-2.0.6 → python_weather-2.1.0}/python_weather/__init__.py

@@ -1,7 +1,7 @@
 """
 The MIT License (MIT)
 
-Copyright (c) 2021-2024 null8626
+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
@@ -25,13 +25,15 @@ SOFTWARE.
 from .enums import HeatIndex, Kind, Locale, Phase, UltraViolet, WindDirection
 from .constants import METRIC, IMPERIAL
 from .errors import Error, RequestError
+from .version import VERSION
 from .client import Client
 
+
 __title__ = 'python-weather'
 __author__ = 'null8626'
 __license__ = 'MIT'
-__copyright__ = 'Copyright (c) 2021-2024 null8626'
-__version__ = '2.0.6'
+__copyright__ = 'Copyright (c) 2021-2025 null8626'
+__version__ = VERSION
 __all__ = (
   'METRIC',
   'IMPERIAL',
@@ -43,5 +45,6 @@ __all__ = (
   'Locale',
   'Phase',
   'UltraViolet',
+  'VERSION',
   'WindDirection',
 )

{python_weather-2.0.6 → python_weather-2.1.0}/python_weather/base.py

@@ -1,7 +1,7 @@
 """
 The MIT License (MIT)
 
-Copyright (c) 2021-2024 null8626
+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
@@ -22,15 +22,13 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 """
 
-from typing import Tuple
-
-from .errors import Error
 from .enums import WindDirection, Kind, Locale, UltraViolet
 from .constants import _Unit
+from .errors import Error
 
 
 class CustomizableBase:
-  __slots__: Tuple[str, ...] = ('__unit', '__locale')
+  __slots__: tuple[str, ...] = ('__unit', '__locale')
 
   def __init__(self, unit: _Unit, locale: Locale):
     self.unit = unit
@@ -38,17 +36,18 @@ class CustomizableBase:
 
   @property
   def unit(self) -> _Unit:
-    """The measuring unit used to display information in this object."""
+    """The measuring unit used."""
 
     return self.__unit
 
   @unit.setter
   def unit(self, to: _Unit) -> None:
     """
-    Sets the default measuring unit used to display information in this object.
+    Sets the default measuring unit used.
 
-    :param to: The new default measuring unit to be used to display information in this object. Must be either ``METRIC`` or ``IMPERIAL``.
-    :exception Error: If the ``to`` argument is not either ``METRIC`` or ``IMPERIAL``.
+    :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):
@@ -58,18 +57,19 @@ class CustomizableBase:
 
   @property
   def locale(self) -> Locale:
-    """The localization used to display information in this object."""
+    """The localization used."""
 
     return self.__locale
 
   @locale.setter
   def locale(self, to: Locale) -> None:
     """
-    Sets the default localization used to display information in this object.
+    Sets the default localization used.
+
+    :param to: The new :class:`.Locale` to be used.
+    :type to: :class:`.Locale`
 
-    :param to: The new :class:`~python_weather.enums.Locale` to be used to display information in this object.
-    :type to: Locale
-    :exception Error: If the ``to`` argument is not a part of the :class:`~python_weather.enums.Locale` enum.
+    :exception Error: ``to`` is not a part of the :class:`.Locale` enum.
     """
 
     if not isinstance(to, Locale):
@@ -79,7 +79,7 @@ class CustomizableBase:
 
 
 class BaseForecast:
-  __slots__: Tuple[str, ...] = (
+  __slots__: tuple[str, ...] = (
     'ultraviolet',
     'humidity',
     'wind_direction',
@@ -94,7 +94,7 @@ class BaseForecast:
   )
 
   ultraviolet: UltraViolet
-  """The ultra-violet (UV) index."""
+  """The ultra-violet index."""
 
   humidity: int
   """The humidity value in percent."""
@@ -106,10 +106,10 @@ class BaseForecast:
   """The kind of the forecast."""
 
   feels_like: int
-  """What it felt like, in celcius or fahrenheit."""
+  """What it felt like in either celcius or fahrenheit."""
 
   temperature: int
-  """The temperature in either celcius or Fahrenheit."""
+  """The temperature in either celcius or fahrenheit."""
 
   precipitation: float
   """The precipitation in either millimeters or inches."""
@@ -124,7 +124,7 @@ class BaseForecast:
   """The wind speeds in either kilometers/hour or miles/hour."""
 
   description: str
-  """The description regarding the forecast. This can be localized in different languages depending on the localization used."""
+  """The description regarding the forecast depending on the localization used."""
 
   def __init__(self, json: dict, unit: _Unit, locale: Locale):
     description = (

{python_weather-2.0.6 → python_weather-2.1.0}/python_weather/client.py

@@ -1,7 +1,7 @@
 """
 The MIT License (MIT)
 
-Copyright (c) 2021-2024 null8626
+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
@@ -22,35 +22,36 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 """
 
-from aiohttp import ClientSession, ClientTimeout, TCPConnector
-from typing import Optional, Tuple, Self
+from aiohttp import ClientSession, ClientTimeout, ClientResponseError, TCPConnector
 from urllib.parse import quote_plus
+from typing import Optional
 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):
   """
-  The class that lets you interact with the API.
+  Interact with the API's endpoints.
 
-  :param unit: Whether to use the metric or imperial/customary system (``IMPERIAL``). Defaults to ``METRIC``.
-  :type unit: _Unit
-  :param locale: Whether to use a different locale/language as the description for the returned forecast. Defaults to ``Locale.ENGLISH``.
-  :type locale: Locale
-  :param session: Whether to use an existing aiohttp client session for requesting or not. Defaults to ``None`` (creates a new one instead).
+  :param unit: Whether to use the metric or imperial/customary system (:data:`~.constants.IMPERIAL`). Defaults to :data:`~.constants.METRIC`.
+  :type unit: ``_Unit``
+  :param locale: Whether to use a different locale/language as the description for the returned forecast. Defaults to :attr:`.Locale.ENGLISH`.
+  :type locale: :class:`.Locale`
+  :param session: Whether to use an existing :class:`~aiohttp.ClientSession` for requesting or not. Defaults to :py:obj:`None` (creates a new one instead).
   :type session: Optional[:class:`~aiohttp.ClientSession`]
-  :param max_retries: Maximum amount of retries upon receiving HTTP request failure before raising a :class:`~python_weather.errors.RequestError`. To have infinite retries, use ``-1`` (NOT recommended). Defaults to ``None`` (or 3 retries).
+  :param max_retries: Maximum amount of retries upon request failure before raising a :class:`.RequestError`. Use ``-1`` to disable (NOT recommended). Defaults to 3 retries.
   :type max_retries: Optional[:class:`int`]
 
-  :raises Error: If ``unit`` is not ``METRIC`` or ``IMPERIAL``, or if ``locale`` is not ``None`` and not a part of the :class:`~python_weather.enums.Locale` enum.
+  :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')
 
   def __init__(
     self,
@@ -82,24 +83,26 @@ class Client(CustomizableBase):
     """
     Fetches a weather forecast for a specific location.
 
-    :param location: The requested location name for said weather forecast.
-    :type location: str
-    :param unit: Overrides the unit used by this object. Defaults to the one used by this object.
+    :param location: The requested location.
+    :type location: :py:class:`str`
+    :param unit: Overrides the unit used.
     :type unit: Optional[``_Unit``]
-    :param locale: Overrides the locale used by this object. Defaults to the one used by this object.
-    :type locale: Optional[:class:`~python_weather.enums.Locale`]
+    :param locale: Overrides the locale used.
+    :type locale: Optional[:class:`.Locale`]
 
-    :exception Error: If the aiohttp client session used by the :class:`~python_weather.client.Client` object is already closed, if the ``unit`` argument is not ``None`` and it's also not ``METRIC`` or ``IMPERIAL``, if the ``locale`` argument is not ``None`` and it's also not a part of the :class:`~python_weather.enums.Locale` enum.
-    :exception RequestError: If the :class:`~python_weather.client.Client` can't send a web request to the web server.
+    :exception TypeError: ``location`` is not a :py:class:`str` or 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 (not isinstance(location, str)) or (not location):
-      raise Error(f'Expected a proper location str, got {location!r}')
-    elif self.__session.closed:
-      raise Error('Client is already closed')
+    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}')
 
     if not isinstance(unit, _Unit):
       unit = self._CustomizableBase__unit
@@ -108,32 +111,36 @@ class Client(CustomizableBase):
       locale = self._CustomizableBase__locale
 
     subdomain = f'{locale.value}.' if locale != Locale.ENGLISH else ''
-    delay = 0.5
     attempts = 0
+    status = None
 
     while True:
       try:
         async with self.__session.get(
-          f'https://{subdomain}wttr.in/{quote_plus(location)}?format=j1'
+          f'https://{subdomain}wttr.in/{quote_plus(location)}?format=j1',
+          headers={
+            'Content-Type': 'application/json',
+            'User-Agent': f'python_weather (https://github.com/null8626/python-weather {VERSION}) Python/',
+          },
         ) as resp:
+          status = resp.status
           resp.raise_for_status()
 
           return Forecast(await resp.json(), unit, locale)
-      except Exception as err:
+      except ClientResponseError:
         if attempts == self.__max_retries:
-          raise RequestError(err)
+          raise RequestError(status) from None
 
-        await sleep(delay)
+        await sleep(0.5 * (2**attempts))
         attempts += 1
-        delay *= 2
 
   async def close(self) -> None:
-    """Closes the :class:`~python_weather.client.Client` object. Nothing will happen if the client uses a pre-existing :class:`~aiohttp.ClientSession` or if the session is already closed."""
+    """Closes the :class:`.Client` object. Nothing will happen if the client uses a pre-existing :class:`~aiohttp.ClientSession` or if the session is already closed."""
 
     if self.__own_session and not self.__session.closed:
       await self.__session.close()
 
-  async def __aenter__(self) -> Self:
+  async def __aenter__(self) -> 'Client':
     return self
 
   async def __aexit__(self, *_, **__) -> None:

{python_weather-2.0.6 → python_weather-2.1.0}/python_weather/constants.py

@@ -1,7 +1,7 @@
 """
 The MIT License (MIT)
 
-Copyright (c) 2021-2024 null8626
+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
@@ -22,12 +22,12 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 """
 
-from typing import Union, Tuple
+from typing import Union
 import re
 
 
 class _Unit:
-  __slots__: Tuple[str, ...] = (
+  __slots__: tuple[str, ...] = (
     'temperature',
     'velocity',
     'pressure',
@@ -43,7 +43,7 @@ class _Unit:
     pressure: str,
     precipitation: str,
     visibility: str,
-    cm_divisor: Union[int, float],
+    cm_divisor: Union[float, int],
   ):
     self.temperature = temperature
     self.velocity = velocity

{python_weather-2.0.6 → python_weather-2.1.0}/python_weather/enums.py

@@ -1,7 +1,7 @@
 """
 The MIT License (MIT)
 
-Copyright (c) 2021-2024 null8626
+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
@@ -22,14 +22,14 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 """
 
+from typing import Union
 from enum import Enum
-from typing import Union, Tuple, Self
 
 from .constants import WIND_DIRECTION_EMOJIS
 
 
 class BasicEnum(Enum):
-  __slots__: Tuple[str, ...] = ()
+  __slots__: tuple[str, ...] = ()
 
   def __repr__(self) -> str:
     return f'{self.__class__.__name__}.{self.name}'
@@ -39,19 +39,25 @@ class BasicEnum(Enum):
 
 
 class IndexedEnum(Enum):
-  __slots__: Tuple[str, ...] = ('index',)
+  __slots__: tuple[str, ...] = ('index',)
 
   index: int
   """The index value."""
 
-  def __lt__(self, other: Union['IndexedEnum', int, float]) -> bool:
-    return self.index < getattr(other, 'index', other)
+  def __lt__(self, other: Union['IndexedEnum', float, int]) -> bool:
+    return float(self.index) < float(other)
 
-  def __eq__(self, other: Union['IndexedEnum', int, float]) -> bool:
-    return self.index == getattr(other, 'index', other)
+  def __le__(self, other: Union['IndexedEnum', float, int]) -> bool:
+    return float(self.index) <= float(other)
 
-  def __gt__(self, other: Union['IndexedEnum', int, float]) -> bool:
-    return self.index > getattr(other, 'index', other)
+  def __eq__(self, other: Union['IndexedEnum', float, int]) -> bool:
+    return float(self.index) == float(other)
+
+  def __gt__(self, other: Union['IndexedEnum', float, int]) -> bool:
+    return float(self.index) > float(other)
+
+  def __ge__(self, other: Union['IndexedEnum', float, int]) -> bool:
+    return float(self.index) >= float(other)
 
   def __hash__(self) -> int:
     return self.index
@@ -59,25 +65,28 @@ class IndexedEnum(Enum):
   def __int__(self) -> int:
     return self.index
 
+  def __float__(self) -> float:
+    return float(self.index)
+
 
 class HeatIndex(IndexedEnum):
-  """Represents a heat index."""
+  """A heat index."""
 
-  __slots__: Tuple[str, ...] = ()
+  __slots__: tuple[str, ...] = ()
 
   CAUTION = None
   EXTREME_CAUTION = None
   DANGER = None
   EXTREME_DANGER = None
 
-  def _new(celcius_index: int, true_index: int) -> Self:
+  def _new(celcius_index: int, true_index: int) -> 'HeatIndex':
     enum = HeatIndex(celcius_index)
     enum.index = true_index
 
     return enum
 
   @classmethod
-  def _missing_(self, celcius_index: int) -> Self:
+  def _missing_(self, celcius_index: int) -> 'HeatIndex':
     if celcius_index <= 32:
       return self.CAUTION
     elif celcius_index <= 39:
@@ -89,9 +98,9 @@ class HeatIndex(IndexedEnum):
 
 
 class UltraViolet(BasicEnum, IndexedEnum):
-  """Represents ultra-violet (UV) index."""
+  """An ultra-violet (UV) index."""
 
-  __slots__: Tuple[str, ...] = ()
+  __slots__: tuple[str, ...] = ()
 
   LOW = None
   MODERATE = None
@@ -99,14 +108,14 @@ class UltraViolet(BasicEnum, IndexedEnum):
   VERY_HIGH = None
   EXTREME = None
 
-  def _new(index: int) -> Self:
+  def _new(index: int) -> 'UltraViolet':
     enum = UltraViolet(index)
     enum.index = index
 
     return enum
 
   @classmethod
-  def _missing_(self, index: int) -> Self:
+  def _missing_(self, index: int) -> 'UltraViolet':
     if index <= 2:
       return self.LOW
     elif index <= 5:
@@ -120,9 +129,9 @@ class UltraViolet(BasicEnum, IndexedEnum):
 
 
 class WindDirection(BasicEnum):
-  """Represents a wind direction."""
+  """A wind direction."""
 
-  __slots__: Tuple[str, ...] = ('degrees',)
+  __slots__: tuple[str, ...] = ('degrees',)
 
   NORTH = 'N'
   NORTH_NORTHEAST = 'NNE'
@@ -144,14 +153,14 @@ class WindDirection(BasicEnum):
   degrees: float
   """The wind direction's value in degrees."""
 
-  def _new(value: str, degrees: float) -> Self:
+  def _new(value: str, degrees: float) -> 'WindDirection':
     enum = WindDirection(value)
     enum.degrees = degrees
 
     return enum
 
   def __contains__(self, other: Union['WindDirection', float, int]) -> bool:
-    other = getattr(other, 'degrees', other)
+    other = float(other)
 
     if self is self.NORTH:
       return other > 348.75 or other <= 11.25
@@ -194,15 +203,15 @@ class WindDirection(BasicEnum):
 
   @property
   def emoji(self) -> str:
-    """The emoji representing this enum."""
+    """Emoji representation."""
 
     return WIND_DIRECTION_EMOJIS[int(((self.degrees + 22.5) % 360) / 45.0)]
 
 
 class Locale(Enum):
-  """Represents the list of supported locales/languages by this library."""
+  """Supported locales/languages."""
 
-  __slots__: Tuple[str, ...] = ()
+  __slots__: tuple[str, ...] = ()
 
   AFRIKAANS = 'af'
   AMHARIC = 'am'
@@ -286,9 +295,9 @@ class Locale(Enum):
 
 
 class Kind(BasicEnum):
-  """Represents a weather forecast kind."""
+  """A weather forecast kind."""
 
-  __slots__: Tuple[str, ...] = ()
+  __slots__: tuple[str, ...] = ()
 
   SUNNY = 113
   PARTLY_CLOUDY = 116
@@ -310,7 +319,7 @@ class Kind(BasicEnum):
   THUNDERY_SNOW_SHOWERS = 392
 
   @classmethod
-  def _missing_(self, value: int) -> Self:
+  def _missing_(self, value: int) -> 'Kind':
     if value in (248, 260):
       return self.FOG
     elif value in (263, 353):
@@ -338,7 +347,7 @@ class Kind(BasicEnum):
 
   @property
   def emoji(self) -> str:
-    """The emoji representing this enum."""
+    """Emoji representation."""
 
     if self is self.CLOUDY:
       return '☁️'
@@ -381,9 +390,9 @@ class Kind(BasicEnum):
 
 
 class Phase(BasicEnum):
-  """Represents a moon phase."""
+  """A moon phase."""
 
-  __slots__: Tuple[str, ...] = ()
+  __slots__: tuple[str, ...] = ()
 
   NEW_MOON = 'New Moon'
   WAXING_CRESCENT = 'Waxing Crescent'
@@ -396,7 +405,7 @@ class Phase(BasicEnum):
 
   @property
   def emoji(self) -> str:
-    """The stylized name for this enum."""
+    """Emoji representation."""
 
     if self is self.NEW_MOON:
       return '🌑'

{python_weather-2.0.6 → python_weather-2.1.0}/python_weather/errors.py

@@ -1,7 +1,7 @@
 """
 The MIT License (MIT)
 
-Copyright (c) 2021-2024 null8626
+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
@@ -22,24 +22,27 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 """
 
-from typing import Tuple
+from typing import Optional
 
 
 class Error(Exception):
-  """Represents a ``python_weather`` error class. Extends :py:class:`Exception`."""
+  """The base error class. Extends :py:class:`Exception`."""
 
-  __slots__: Tuple[str, ...] = ()
+  __slots__: tuple[str, ...] = ()
 
 
 class RequestError(Error):
-  """Thrown upon HTTP request failure. Extends :class:`~python_weather.errors.Error`."""
+  """Thrown upon HTTP request failure. Extends :class:`.Error`."""
 
-  __slots__: Tuple[str, ...] = ('source',)
+  __slots__: tuple[str, ...] = ('status',)
 
-  source: Exception
-  """The :py:class:`Exception` instance causing this exception."""
+  status: Optional[int]
+  """The status code returned from the API."""
 
-  def __init__(self, source: Exception):
-    self.source = source
+  def __init__(self, status: Optional[int]):
+    self.status = status
 
     super().__init__()
+
+  def __repr__(self) -> str:
+    return f'<{__class__.__name__} status={self.status}>'

{python_weather-2.0.6 → python_weather-2.1.0}/python_weather/forecast.py

@@ -1,7 +1,7 @@
 """
 The MIT License (MIT)
 
-Copyright (c) 2021-2024 null8626
+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
@@ -22,18 +22,19 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
 """
 
-from typing import Iterable, Optional, Tuple, List
 from datetime import datetime, date, time
+from collections.abc import Iterable
+from typing import Optional
 
-from .base import BaseForecast
 from .enums import Phase, Locale, HeatIndex
 from .constants import _Unit, LATLON_REGEX
+from .base import BaseForecast
 
 
 class HourlyForecast(BaseForecast):
-  """Represents a weather forecast of a specific hour."""
+  """A weather forecast for a specific hour."""
 
-  __slots__: Tuple[str, ...] = (
+  __slots__: tuple[str, ...] = (
     'chances_of_fog',
     'chances_of_frost',
     'chances_of_high_temperature',
@@ -101,9 +102,10 @@ class HourlyForecast(BaseForecast):
   """The wind gust value in either kilometers/hour or miles/hour."""
 
   def __init__(self, json: dict, unit: _Unit, locale: Locale):
-    # for inheritance purposes
+    # For inheritance purposes.
     if 'temp_C' not in json:
       json['temp_C'] = json.pop('tempC')
+
     if 'temp_F' not in json:
       json['temp_F'] = json.pop('tempF')
 
@@ -133,11 +135,13 @@ class HourlyForecast(BaseForecast):
     super().__init__(json, unit, locale)
 
   def __repr__(self) -> str:
-    return f'<{__class__.__name__} time={self.time!r} temperature={self.temperature!r} description={self.description!r} kind={self.kind!r}>'
+    return f'<{__class__.__name__} time={self.time!r} temperature={self.temperature} description={self.description!r} kind={self.kind!r}>'
 
 
 class DailyForecast:
-  __slots__: Tuple[str, ...] = (
+  """A weather forecast for a specific day."""
+
+  __slots__: tuple[str, ...] = (
     'moon_illumination',
     'moon_phase',
     'moonrise',
@@ -160,16 +164,16 @@ class DailyForecast:
   """The moon's phase."""
 
   moonrise: Optional[time]
-  """The local time when the moon rises. This can be ``None``."""
+  """The local time when the moon rises."""
 
   moonset: Optional[time]
-  """The local time when the moon sets. This can be ``None``."""
+  """The local time when the moon sets."""
 
   sunrise: Optional[time]
-  """The local time when the sun rises. This can be ``None``."""
+  """The local time when the sun rises."""
 
   sunset: Optional[time]
-  """The local time when the sun sets. This can be ``None``."""
+  """The local time when the sun sets."""
 
   date: 'date'
   """The local date of this forecast."""
@@ -189,7 +193,7 @@ class DailyForecast:
   snowfall: float
   """Total snowfall in either centimeters or inches."""
 
-  hourly_forecasts: List[HourlyForecast]
+  hourly_forecasts: list[HourlyForecast]
   """The hourly forecasts of this day."""
 
   def __init__(self, json: dict, unit: _Unit, locale: Locale):
@@ -201,7 +205,7 @@ class DailyForecast:
     self.moonset = __class__.__parse_time(astronomy['moonset'])
     self.sunrise = __class__.__parse_time(astronomy['sunrise'])
     self.sunset = __class__.__parse_time(astronomy['sunset'])
-    self.date = datetime.strptime(json['date'], '%Y-%m-%d').date()
+    self.date = date.fromisoformat(json['date'])
     self.sunlight = float(json['sunHour'])
     self.lowest_temperature = int(json[f'mintemp{unit.temperature}'])
     self.highest_temperature = int(json[f'maxtemp{unit.temperature}'])
@@ -219,7 +223,7 @@ class DailyForecast:
       ...
 
   def __repr__(self) -> str:
-    return f'<{__class__.__name__} date={self.date!r} temperature={self.temperature!r}>'
+    return f'<{__class__.__name__} date={self.date!r} temperature={self.temperature}>'
 
   def __len__(self) -> int:
     return len(self.hourly_forecasts)
@@ -229,9 +233,9 @@ class DailyForecast:
 
 
 class Forecast(BaseForecast):
-  """Represents today's weather forecast, alongside daily and hourly weather forecasts."""
+  """A set of weather forecasts for a certain location."""
 
-  __slots__: Tuple[str, ...] = (
+  __slots__: tuple[str, ...] = (
     'local_population',
     'region',
     'location',
@@ -256,10 +260,10 @@ class Forecast(BaseForecast):
   datetime: 'datetime'
   """The local date and time of this weather forecast."""
 
-  coordinates: Tuple[float, float]
-  """A tuple of this forecast's latitude and longitude."""
+  coordinates: tuple[float, float]
+  """This forecast's latitude and longitude."""
 
-  daily_forecasts: List[DailyForecast]
+  daily_forecasts: list[DailyForecast]
   """Daily weather forecasts in this location."""
 
   def __init__(self, json: dict, unit: _Unit, locale: Locale):
@@ -277,7 +281,7 @@ class Forecast(BaseForecast):
       match = LATLON_REGEX.match(req['query'])
 
       self.coordinates = (float(match[1]), float(match[2]))
-    except:
+    except (KeyError, IndexError, StopIteration):
       self.coordinates = (float(nearest['latitude']), float(nearest['longitude']))
 
     self.daily_forecasts = [
@@ -287,7 +291,7 @@ class Forecast(BaseForecast):
     super().__init__(current, unit, locale)
 
   def __repr__(self) -> str:
-    return f'<{__class__.__name__} location={self.location!r} datetime={self.datetime!r} temperature={self.temperature!r}>'
+    return f'<{__class__.__name__} location={self.location!r} datetime={self.datetime!r} temperature={self.temperature}>'
 
   def __len__(self) -> int:
     return len(self.daily_forecasts)

python_weather-2.1.0/python_weather/version.py

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

{python_weather-2.0.6 → python_weather-2.1.0/python_weather.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
-Metadata-Version: 2.1
+Metadata-Version: 2.4
 Name: python-weather
-Version: 2.0.6
+Version: 2.1.0
 Summary: A free and asynchronous weather API wrapper made in Python, for Python.
 Author: null8626
 License: MIT
@@ -26,16 +26,16 @@ Classifier: License :: OSI Approved :: MIT License
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.8
 Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
-Requires-Python: >=3.8
+Requires-Python: >=3.9
 Description-Content-Type: text/markdown
 License-File: LICENSE
-Requires-Dist: aiohttp>=3.10.10
+Requires-Dist: aiohttp>=3.12.4
+Dynamic: license-file
 
 # [python-weather][pypi-url] [![pypi][pypi-image]][pypi-url] [![downloads][downloads-image]][pypi-url] [![codacy-badge][codacy-url]][codacy-image] [![ko-fi][ko-fi-brief-image]][ko-fi-url]
 
@@ -50,10 +50,12 @@ Requires-Dist: aiohttp>=3.10.10
 
 A free and asynchronous weather Python API wrapper made in Python, for Python.
 
-## Installation
+## Getting started
+
+Run the following command in your terminal:
 
 ```console
-pip install python-weather
+$ pip install python-weather
 ```
 
 ## Example
@@ -61,36 +63,40 @@ pip install python-weather
 For more information, please read the [documentation](https://python-weather.readthedocs.io/en/latest/).
 
 ```py
-# import the module
+# Import the module.
 import python_weather
 
 import asyncio
 import os
 
-async def getweather() -> None:
-  # declare the client. the measuring unit used defaults to the metric system (celcius, km/h, etc.)
+
+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
+    
+    # Fetch a weather forecast from a city.
     weather = await client.get('New York')
     
-    # returns the current day's forecast temperature (int)
+    # Fetch the temperature for today.
     print(weather.temperature)
     
-    # get the weather forecast for a few days
+    # Fetch weather forecast for upcoming days.
     for daily in weather:
       print(daily)
-      
-      # hourly forecasts
+    
+      # Each daily forecast has their own hourly forecasts.
       for hourly in daily:
         print(f' --> {hourly!r}')
 
 if __name__ == '__main__':
-  # see https://stackoverflow.com/questions/45600579/asyncio-event-loop-is-closed-when-getting-loop
-  # for more details
+  
+  # See https://stackoverflow.com/questions/45600579/asyncio-event-loop-is-closed-when-getting-loop
+  # for more details.
   if os.name == 'nt':
     asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
   
-  asyncio.run(getweather())
+  asyncio.run(main())
 ```
 
 ## Data source

{python_weather-2.0.6 → python_weather-2.1.0}/python_weather.egg-info/SOURCES.txt

@@ -9,6 +9,7 @@ python_weather/constants.py
 python_weather/enums.py
 python_weather/errors.py
 python_weather/forecast.py
+python_weather/version.py
 python_weather.egg-info/PKG-INFO
 python_weather.egg-info/SOURCES.txt
 python_weather.egg-info/dependency_links.txt

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

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

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

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