python-weather 2.0.3__py3-none-any.whl → 2.0.5__py3-none-any.whl

python_weather/__init__.py

@@ -1,19 +1,43 @@
-# -*- coding: utf-8 -*-
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-2024 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 .client import Client
-from .errors import Error
 
 __title__ = 'python-weather'
 __author__ = 'null8626'
 __license__ = 'MIT'
-__version__ = '2.0.3'
+__copyright__ = 'Copyright (c) 2021-2024 null8626'
+__version__ = '2.0.5'
 __all__ = (
   'METRIC',
   'IMPERIAL',
   'Client',
   'Error',
+  'RequestError',
   'HeatIndex',
   'Kind',
   'Locale',

python_weather/base.py

@@ -1,4 +1,29 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-2024 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 enum import auto
+from typing import Tuple
 
 from .errors import Error
 from .enums import WindDirection, Kind, Locale, UltraViolet
@@ -6,7 +31,7 @@ from .constants import _Unit
 
 
 class CustomizableBase:
-  __slots__ = ('__unit', '__locale')
+  __slots__: Tuple[str, ...] = ('__unit', '__locale')
 
   def __init__(self, unit: _Unit, locale: Locale):
     self.unit = unit
@@ -19,7 +44,7 @@ class CustomizableBase:
     return self.__unit
 
   @unit.setter
-  def unit(self, to: _Unit):
+  def unit(self, to: _Unit) -> None:
     """
     Sets the default measuring unit used to display information in this object.
 
@@ -39,7 +64,7 @@ class CustomizableBase:
     return self.__locale
 
   @locale.setter
-  def locale(self, to: Locale):
+  def locale(self, to: Locale) -> None:
     """
     Sets the default localization used to display information in this object.
 
@@ -54,84 +79,71 @@ class CustomizableBase:
     self.__locale = to
 
 
-class BaseForecast(CustomizableBase):
-  __slots__ = ('__inner',)
-
-  def __init__(self, json: dict, unit: _Unit, locale: Locale):
-    self.__inner = json
-
-    super().__init__(unit, locale)
-
-  @property
-  def ultraviolet(self) -> UltraViolet:
-    """The ultra-violet (UV) index."""
-
-    return UltraViolet._new(int(self.__inner['uvIndex']))
-
-  @property
-  def feels_like(self) -> int:
-    """What it felt like, in Celcius or Fahrenheit."""
-
-    return int(self.__inner[f'FeelsLike{self._CustomizableBase__unit.temperature}'])
-
-  @property
-  def humidity(self) -> int:
-    """The humidity value in percent."""
-
-    return int(self.__inner['humidity'])
-
-  @property
-  def temperature(self) -> int:
-    """The temperature in either Celcius or Fahrenheit."""
+class BaseForecast:
+  __slots__: Tuple[str, ...] = (
+    'ultraviolet',
+    'humidity',
+    'wind_direction',
+    'kind',
+    'feels_like',
+    'temperature',
+    'precipitation',
+    'pressure',
+    'visibility',
+    'wind_speed',
+    'description',
+  )
 
-    return int(self.__inner[f'temp_{self._CustomizableBase__unit.temperature}'])
+  ultraviolet: UltraViolet
+  """The ultra-violet (UV) index."""
 
-  @property
-  def precipitation(self) -> float:
-    """The precipitation in either Millimeters or Inches."""
+  humidity: int
+  """The humidity value in percent."""
 
-    return float(self.__inner[f'precip{self._CustomizableBase__unit.precipitation}'])
+  wind_direction: WindDirection
+  """The wind direction."""
 
-  @property
-  def pressure(self) -> float:
-    """The pressure in either Pascal or Inches."""
+  kind: Kind
+  """The kind of the forecast."""
 
-    return float(self.__inner[f'pressure{self._CustomizableBase__unit.pressure}'])
+  feels_like: int
+  """What it felt like, in celcius or fahrenheit."""
 
-  @property
-  def visibility(self) -> int:
-    """The visibility distance in either Kilometers or Miles."""
+  temperature: int
+  """The temperature in either celcius or Fahrenheit."""
 
-    return int(self.__inner[f'visibility{self._CustomizableBase__unit.visibility}'])
+  precipitation: float
+  """The precipitation in either millimeters or inches."""
 
-  @property
-  def wind_speed(self) -> int:
-    """The wind speeds in either Kilometers per hour or Miles per hour."""
-
-    return int(self.__inner[f'windspeed{self._CustomizableBase__unit.velocity}'])
+  pressure: float
+  """The pressure in either pascal or inches."""
 
-  @property
-  def wind_direction(self) -> WindDirection:
-    """The wind direction."""
+  visibility: int
+  """The visibility distance in either kilometers or miles."""
 
-    return WindDirection._new(
-      self.__inner['winddir16Point'], int(self.__inner['winddirDegree'])
-    )
+  wind_speed: int
+  """The wind speeds in either kilometers/hour or miles/hour."""
 
-  @property
-  def description(self) -> str:
-    """The description regarding the forecast. This can be localized in different languages depending on the localization used."""
+  description: str
+  """The description regarding the forecast. This can be localized in different languages depending on the localization used."""
 
+  def __init__(self, json: dict, unit: _Unit, locale: Locale):
     description = (
-      self.__inner['weatherDesc'][0]['value']
-      if self._CustomizableBase__locale == Locale.ENGLISH
-      else self.__inner[f'lang_{self._CustomizableBase__locale.value}'][0]['value']
+      json['weatherDesc'][0]['value']
+      if locale is Locale.ENGLISH
+      else json[f'lang_{locale.value}'][0]['value']
     )
 
-    return description.strip()
-
-  @property
-  def kind(self) -> Kind:
-    """The kind of the forecast."""
-
-    return Kind(int(self.__inner['weatherCode']))
+    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/client.py

@@ -1,13 +1,37 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-2024 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 aiohttp import ClientSession, ClientTimeout, TCPConnector
 from urllib.parse import quote_plus
-from typing import Optional
+from typing import Optional, Tuple
 from asyncio import sleep
 from enum import auto
 
+from .errors import Error, RequestError
 from .constants import _Unit, METRIC
 from .base import CustomizableBase
 from .forecast import Forecast
-from .errors import Error
 from .enums import Locale
 
 
@@ -22,10 +46,10 @@ class Client(CustomizableBase):
   :param session: Whether to use an existing aiohttp client session for requesting or not. Defaults to ``None`` (creates a new one instead)
   :type session: Optional[:class:`aiohttp.ClientSession`]
 
-  :raises Error: If the ``unit`` argument is not ``None`` and it's also not ``METRIC`` or ``IMPERIAL``, or if the ``locale`` argument is not ``None`` and it's also not a part of the :class:`Locale` enum.
+  :raises Error: If ``unit`` is not ``METRIC`` or ``IMPERIAL``, or if ``locale`` is not ``None`` and not a part of the :class:`Locale` enum.
   """
 
-  __slots__ = ('__session',)
+  __slots__: Tuple[str, ...] = ('__own_session', '__session')
 
   def __init__(
     self,
@@ -36,13 +60,14 @@ class Client(CustomizableBase):
   ):
     super().__init__(unit, locale)
 
+    self.__own_session = session is None
     self.__session = session or ClientSession(
       timeout=ClientTimeout(total=5000.0),
       connector=TCPConnector(verify_ssl=False),
     )
 
   def __repr__(self) -> str:
-    return f'<{self.__class__.__name__} {self.__session!r}>'
+    return f'<{__class__.__name__} {self.__session!r}>'
 
   async def get(
     self,
@@ -56,9 +81,9 @@ class Client(CustomizableBase):
 
     :param location: The requested location name for said weather forecast.
     :type location: str
-    :param unit: Overrides the metric or imperial/customary system (``IMPERIAL``) used by the :class:`Client` object. Defaults to ``None`` (uses the one from the :class:`Client`).
+    :param unit: Overrides the unit used by this object. Defaults to the one used by this object.
     :type unit: Optional[:py:class:`enum.auto`]
-    :param locale: Overrides the locale/language used by the :class:`Client` object. Defaults to ``None`` (uses the one from the :class:`Client`).
+    :param locale: Overrides the locale used by this object. Defaults to the one used by this object.
     :type locale: Optional[Locale]
 
     :exception Error: If the aiohttp client session used by the :class:`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:`Locale` enum, or if the :class:`Client` cannot send a web request to the web server.
@@ -82,25 +107,27 @@ class Client(CustomizableBase):
     delay = 0.5
 
     while True:
-      async with self.__session.get(
-        f'https://{subdomain}wttr.in/{quote_plus(location)}?format=j1'
-      ) as resp:
-        try:
+      try:
+        async with self.__session.get(
+          f'https://{subdomain}wttr.in/{quote_plus(location)}?format=j1'
+        ) as resp:
+          resp.raise_for_status()
+
           return Forecast(await resp.json(), unit, locale)
-        except Exception as e:
-          if delay == 2:
-            raise e  # okay, that's too much requests - just raise the error
+      except Exception as err:
+        if delay == 4:
+          raise RequestError(err)
 
-          await sleep(delay)
-          delay *= 2
+        await sleep(delay)
+        delay *= 2
 
-  async def close(self):
-    """Closes the :class:`Client` object. Nothing will happen if it's already closed."""
+  async def close(self) -> None:
+    """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 not self.__session.closed:
+    if self.__own_session and not self.__session.closed:
       await self.__session.close()
 
-  async def __aenter__(self):
+  async def __aenter__(self) -> 'Client':
     return self
 
   async def __aexit__(self, *_, **__):

python_weather/constants.py

@@ -1,9 +1,33 @@
-from typing import Union
-from re import compile
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-2024 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 typing import Union, Tuple
+import re
 
 
 class _Unit:
-  __slots__ = (
+  __slots__: Tuple[str, ...] = (
     'temperature',
     'velocity',
     'pressure',
@@ -36,4 +60,4 @@ METRIC = _Unit('C', 'Kmph', '', 'MM', '', 1)
 IMPERIAL = _Unit('F', 'Miles', 'Inches', 'Inches', 'Miles', 2.54)
 
 WIND_DIRECTION_EMOJIS = ('↓', '↙', '←', '↖', '↑', '↗', '→', '↘')
-LATLON_REGEX = compile(r'^Lat (\-?[\d\.]+) and Lon (\-?[\d\.]+)$')
+LATLON_REGEX = re.compile(r'^Lat (\-?[\d\.]+) and Lon (\-?[\d\.]+)$')

python_weather/enums.py

@@ -1,11 +1,35 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-2024 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 enum import Enum
-from typing import Union
+from typing import Union, Tuple
 
 from .constants import WIND_DIRECTION_EMOJIS
 
 
 class BasicEnum(Enum):
-  __slots__ = ()
+  __slots__: Tuple[str, ...] = ()
 
   def __repr__(self) -> str:
     return f'{self.__class__.__name__}.{self.name}'
@@ -15,59 +39,45 @@ class BasicEnum(Enum):
 
 
 class IndexedEnum(Enum):
-  __slots__ = ('__index',)
+  __slots__: Tuple[str, ...] = ('index',)
+
+  index: int
+  """The index value."""
 
   def __lt__(self, other: Union['IndexedEnum', int, float]) -> bool:
-    if isinstance(other, self.__class__):
-      return self.__index < other.index
-    else:
-      return self.__index < other
+    return self.index < getattr(other, 'index', other)
 
   def __eq__(self, other: Union['IndexedEnum', int, float]) -> bool:
-    if isinstance(other, self.__class__):
-      return self.__index == other.index
-    else:
-      return self.__index == other
+    return self.index == getattr(other, 'index', other)
 
   def __gt__(self, other: Union['IndexedEnum', int, float]) -> bool:
-    if isinstance(other, self.__class__):
-      return self.__index > other.index
-    else:
-      return self.__index > other
+    return self.index > getattr(other, 'index', other)
 
   def __hash__(self) -> int:
-    return self.__index
+    return self.index
 
   def __int__(self) -> int:
-    return self.__index
-
-  @property
-  def index(self) -> int:
-    """The index value."""
-
-    return self.__index
-
-  @index.setter
-  def index(self, new_index: int) -> int:
-    self.__index = new_index
+    return self.index
 
 
 class HeatIndex(IndexedEnum):
   """Represents a heat index."""
 
+  __slots__: Tuple[str, ...] = ()
+
   CAUTION = None
   EXTREME_CAUTION = None
   DANGER = None
   EXTREME_DANGER = None
 
-  def _new(celcius_index: int, true_index: int):
+  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):
+  def _missing_(self, celcius_index: int) -> 'HeatIndex':
     if celcius_index <= 32:
       return self.CAUTION
     elif celcius_index <= 39:
@@ -81,20 +91,22 @@ class HeatIndex(IndexedEnum):
 class UltraViolet(BasicEnum, IndexedEnum):
   """Represents ultra-violet (UV) index."""
 
+  __slots__: Tuple[str, ...] = ()
+
   LOW = None
   MODERATE = None
   HIGH = None
   VERY_HIGH = None
   EXTREME = None
 
-  def _new(index: int):
+  def _new(index: int) -> 'UltraViolet':
     enum = UltraViolet(index)
     enum.index = index
 
     return enum
 
   @classmethod
-  def _missing_(self, index: int):
+  def _missing_(self, index: int) -> 'UltraViolet':
     if index <= 2:
       return self.LOW
     elif index <= 5:
@@ -110,7 +122,7 @@ class UltraViolet(BasicEnum, IndexedEnum):
 class WindDirection(BasicEnum):
   """Represents a wind direction."""
 
-  __slots__ = ('__degrees',)
+  __slots__: Tuple[str, ...] = ('degrees',)
 
   NORTH = 'N'
   NORTH_NORTHEAST = 'NNE'
@@ -129,15 +141,17 @@ class WindDirection(BasicEnum):
   NORTHWEST = 'NW'
   NORTH_NORTHWEST = 'NNW'
 
-  def _new(value: str, degrees: float):
+  degrees: float
+  """The wind direction's value in degrees."""
+
+  def _new(value: str, degrees: float) -> 'WindDirection':
     enum = WindDirection(value)
-    enum.__degrees = degrees
+    enum.degrees = degrees
 
     return enum
 
   def __contains__(self, other: Union['WindDirection', float, int]) -> bool:
-    if isinstance(other, self.__class__):
-      other = other.degrees
+    other = getattr(other, 'degrees', other)
 
     if self is self.NORTH:
       return other > 348.75 or other <= 11.25
@@ -175,12 +189,6 @@ class WindDirection(BasicEnum):
   def __float__(self) -> float:
     return self.__degrees
 
-  @property
-  def degrees(self) -> int:
-    """The wind direction's value in degrees."""
-
-    return self.__degrees
-
   @property
   def emoji(self) -> str:
     """The emoji representing this enum."""
@@ -191,7 +199,7 @@ class WindDirection(BasicEnum):
 class Locale(Enum):
   """Represents the list of supported locales/languages by this library."""
 
-  __slots__ = ()
+  __slots__: Tuple[str, ...] = ()
 
   AFRIKAANS = 'af'
   AMHARIC = 'am'
@@ -267,7 +275,7 @@ class Locale(Enum):
   ZULU = 'zu'
 
   def __repr__(self) -> str:
-    return f'{self.__class__.__name__}.{self.name}'
+    return f'{__class__.__name__}.{self.name}'
 
   def __str__(self) -> str:
     arr = self.name.title().split('_')
@@ -277,7 +285,7 @@ class Locale(Enum):
 class Kind(BasicEnum):
   """Represents a weather forecast kind."""
 
-  __slots__ = ()
+  __slots__: Tuple[str, ...] = ()
 
   SUNNY = 113
   PARTLY_CLOUDY = 116
@@ -299,7 +307,7 @@ class Kind(BasicEnum):
   THUNDERY_SNOW_SHOWERS = 392
 
   @classmethod
-  def _missing_(self, value: int):
+  def _missing_(self, value: int) -> 'Kind':
     if value == 248 or value == 260:
       return self.FOG
     elif value == 263 or value == 353:
@@ -381,7 +389,7 @@ class Kind(BasicEnum):
 class Phase(BasicEnum):
   """Represents a moon phase."""
 
-  __slots__ = ()
+  __slots__: Tuple[str, ...] = ()
 
   NEW_MOON = 'New Moon'
   WAXING_CRESCENT = 'Waxing Crescent'

python_weather/errors.py

@@ -1,4 +1,45 @@
+"""
+The MIT License (MIT)
+
+Copyright (c) 2021-2024 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 typing import Tuple
+
+
 class Error(Exception):
   """Represents a ``python_weather`` error class. Extends :py:class:`Exception`."""
 
-  __slots__ = ()
+  __slots__: Tuple[str, ...] = ()
+
+
+class RequestError(Error):
+  """Thrown upon HTTP request failure. Extends :class:`Error`."""
+
+  __slots__: Tuple[str, ...] = ('source',)
+
+  source: Exception
+  """The :class:`Exception` instance causing this exception."""
+
+  def __init__(self, source: Exception):
+    self.source = source
+
+    super().__init__()