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

{python_weather-2.1.2/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.2
+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.3
+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.2 → python_weather-2.2.0}/pyproject.toml

@@ -3,13 +3,13 @@ requires = ["setuptools"]
 
 [project]
 name = "python-weather"
-version = "2.1.2"
+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.3"]
+dependencies = ["aiohttp>=3.13.5"]
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Education",

{python_weather-2.1.2 → python_weather-2.2.0}/python_weather/base.py

@@ -3,64 +3,11 @@
 
 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:
+  """A base weather forecast."""
+
   __slots__: tuple[str, ...] = (
     'cloud_cover',
     'ultraviolet',

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

@@ -7,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.
 
@@ -45,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,
@@ -59,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,
@@ -94,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
@@ -134,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
@@ -144,7 +194,7 @@ class Client(CustomizableBase):
 
   async def close(self) -> None:
     """
-    Closes the :class:`.Client` object.
+    Closes the client.
 
     Example:
 
@@ -152,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.1.2 → python_weather-2.2.0}/python_weather/constants.py

@@ -5,6 +5,8 @@ import re
 
 
 class _Unit:
+  """A supported measurement unit."""
+
   __slots__: tuple[str, ...] = (
     'temperature',
     'velocity',
@@ -38,6 +40,7 @@ class _Unit:
     self.cm_divisor = cm_divisor
 
   def __repr__(self) -> str:
+    """The unit's debug string representation."""
     return f'<Unit [{self.temperature}, {self.velocity}]>'
 
 

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

@@ -7,12 +7,16 @@ 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
@@ -21,36 +25,46 @@ class BasicEnum(Enum):
 
 
 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)
 
 
@@ -140,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':
@@ -150,25 +164,27 @@ class WindDirection(BasicEnum):
     return enum
 
   def __contains__(self, other: 'WindDirection | float | int') -> bool:
+    """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."""
-
+    """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, ...] = ()
 
@@ -246,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]
@@ -307,8 +325,7 @@ class Kind(BasicEnum):
 
   @property
   def emoji(self) -> str:
-    """Emoji representation."""
-
+    """The weather forecast kind's emoji representation."""
     return KIND_EMOJIS[self._index]
 
 
@@ -328,6 +345,5 @@ class Phase(BasicEnum):
 
   @property
   def emoji(self) -> str:
-    """Emoji representation."""
-
+    """The moon phase's emoji representation."""
     return chr(0x1F311 + self._index)

{python_weather-2.1.2 → python_weather-2.2.0}/python_weather/errors.py

@@ -26,4 +26,5 @@ class RequestError(Error):
     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.2 → python_weather-2.2.0}/python_weather/forecast.py

@@ -113,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}>'
 
 
@@ -201,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)
 
 
@@ -272,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.1.2 → python_weather-2.2.0}/python_weather/version.py

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

{python_weather-2.1.2 → 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.2
+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.3
+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.2/python_weather.egg-info/requires.txt

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