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

{python_weather-2.1.0 → python_weather-2.1.2}/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.0 → python_weather-2.1.2}/MANIFEST.in

@@ -1,10 +1,17 @@
+prune .pytest_cache
 prune .ruff_cache
 prune .github
+prune tests
 prune docs
 exclude .gitattributes
 exclude .gitignore
 exclude .readthedocs.yml
+exclude .coverage
 exclude ruff.toml
 exclude LICENSE
 exclude changelog.yml
-exclude test.py
+exclude codacy-coverage
+exclude codecov*
+exclude coverage.xml
+exclude junit.xml
+global-exclude __pycache__/*

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

@@ -1,110 +1,104 @@
-Metadata-Version: 2.4
-Name: python-weather
-Version: 2.1.0
-Summary: A free and asynchronous weather API wrapper made in Python, for Python.
-Author: null8626
-License: 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
-Project-URL: Donate via GitHub Sponsors, https://github.com/sponsors/null8626
-Project-URL: Donate via Ko-fi, https://ko-fi.com/null8626
-Keywords: weather,forecast,weather-api,weather-forecast
-Classifier: Development Status :: 5 - Production/Stable
-Classifier: Intended Audience :: Education
-Classifier: Intended Audience :: Developers
-Classifier: Intended Audience :: Information Technology
-Classifier: Natural Language :: English
-Classifier: Operating System :: OS Independent
-Classifier: Topic :: Education
-Classifier: Topic :: Internet
-Classifier: Topic :: Scientific/Engineering
-Classifier: Topic :: Scientific/Engineering :: Astronomy
-Classifier: Topic :: Software Development
-Classifier: Topic :: Software Development :: Libraries
-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.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.9
-Description-Content-Type: text/markdown
-License-File: LICENSE
-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]
-
-[pypi-image]: https://img.shields.io/pypi/v/python-weather.svg?style=flat-square
-[pypi-url]: https://pypi.org/project/python-weather/
-[downloads-image]: https://img.shields.io/pypi/dm/python-weather?style=flat-square
-[ko-fi-brief-image]: https://img.shields.io/badge/donations-ko--fi-red?color=ff5e5b&style=flat-square
-[codacy-url]: https://app.codacy.com/project/badge/Grade/0f7721b7e4314a748c75a04f0a7e0ce3
-[codacy-image]: https://app.codacy.com/gh/null8626/python-weather/dashboard
-[ko-fi-image]: https://ko-fi.com/img/githubbutton_sm.svg
-[ko-fi-url]: https://ko-fi.com/null8626
-
-A free and asynchronous weather Python API wrapper made in Python, for Python.
-
-## Getting started
-
-Run the following command in your terminal:
-
-```console
-$ pip install python-weather
-```
-
-## Example
-
-For more information, please read the [documentation](https://python-weather.readthedocs.io/en/latest/).
-
-```py
-# Import the module.
-import python_weather
-
-import asyncio
-import os
-
-
-async def main() -> None:
-  
-  # Declare the client. The measuring unit used defaults to the metric system (celcius, km/h, etc.)
-  async with python_weather.Client(unit=python_weather.IMPERIAL) as client:
-    
-    # Fetch a weather forecast from a city.
-    weather = await client.get('New York')
-    
-    # Fetch the temperature for today.
-    print(weather.temperature)
-    
-    # Fetch weather forecast for upcoming days.
-    for daily in weather:
-      print(daily)
-    
-      # Each daily forecast has their own hourly forecasts.
-      for hourly in daily:
-        print(f' --> {hourly!r}')
-
-if __name__ == '__main__':
-  
-  # 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(main())
-```
-
-## Data source
-
-This library depends on [`wttr.in`](https://github.com/chubin/wttr.in), which uses data from the [World Weather Online API](https://www.worldweatheronline.com/weather-api/).
-
-## Donations
-
-If you want to support this project, consider donating! ❤
-
-[![ko-fi][ko-fi-image]][ko-fi-url]
+Metadata-Version: 2.4
+Name: python-weather
+Version: 2.1.2
+Summary: A free and asynchronous weather API wrapper made in Python, for Python.
+Author: null8626
+License: 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
+Project-URL: Donate via GitHub Sponsors, https://github.com/sponsors/null8626
+Project-URL: Donate via Ko-fi, https://ko-fi.com/null8626
+Keywords: weather,forecast,weather-forecast
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Education
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Information Technology
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Education
+Classifier: Topic :: Internet
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Scientific/Engineering :: Astronomy
+Classifier: Topic :: Software Development
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: aiohttp>=3.13.3
+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]
+
+[pypi-url]: https://pypi.org/project/python-weather/
+[pypi-image]: https://img.shields.io/pypi/v/python-weather.svg?style=flat-square
+[pypi-downloads-image]: https://img.shields.io/pypi/dm/python-weather?style=flat-square
+[codacy-url]: https://app.codacy.com/gh/null8626/python-weather/dashboard
+[codacy-image]: https://app.codacy.com/project/badge/Grade/0f7721b7e4314a748c75a04f0a7e0ce3
+[codecov-url]: https://codecov.io/gh/null8626/python-weather
+[codecov-image]: https://codecov.io/gh/null8626/python-weather/graph/badge.svg
+[ko-fi-url]: https://ko-fi.com/null8626
+[ko-fi-image]: https://ko-fi.com/img/githubbutton_sm.svg
+[ko-fi-brief-image]: https://img.shields.io/badge/donations-ko--fi-red?color=ff5e5b&style=flat-square
+
+A free and asynchronous weather Python API wrapper made in Python, for Python.
+
+## Getting started
+
+Run the following command in your terminal:
+
+```console
+pip install python-weather
+```
+
+## Example
+
+For more information, please read the [documentation](https://python-weather.readthedocs.io/en/latest/).
+
+```py
+# Import the module.
+import python_weather
+
+import asyncio
+
+
+async def main() -> None:
+  
+  # Declare the client. The measuring unit used defaults to the metric system (celcius, km/h, etc.)
+  async with python_weather.Client(unit=python_weather.IMPERIAL) as client:
+    
+    # Fetch a weather forecast from a city.
+    weather = await client.get('New York')
+    
+    # Fetch the temperature for today.
+    print(weather.temperature)
+    
+    # Fetch weather forecast for upcoming days.
+    for daily in weather:
+      print(daily)
+    
+      # Each daily forecast has their own hourly forecasts.
+      for hourly in daily:
+        print(f' --> {hourly!r}')
+
+if __name__ == '__main__':
+  asyncio.run(main())
+```
+
+## Data source
+
+This library depends on [`wttr.in`](https://github.com/chubin/wttr.in), which uses data from the [World Weather Online API](https://www.worldweatheronline.com/weather-api/).
+
+## Donations
+
+If you want to support this project, consider donating! ❤
+
+[![ko-fi][ko-fi-image]][ko-fi-url]

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

@@ -1,13 +1,15 @@
-# [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]
+# [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]
 
-[pypi-image]: https://img.shields.io/pypi/v/python-weather.svg?style=flat-square
 [pypi-url]: https://pypi.org/project/python-weather/
-[downloads-image]: https://img.shields.io/pypi/dm/python-weather?style=flat-square
-[ko-fi-brief-image]: https://img.shields.io/badge/donations-ko--fi-red?color=ff5e5b&style=flat-square
-[codacy-url]: https://app.codacy.com/project/badge/Grade/0f7721b7e4314a748c75a04f0a7e0ce3
-[codacy-image]: https://app.codacy.com/gh/null8626/python-weather/dashboard
-[ko-fi-image]: https://ko-fi.com/img/githubbutton_sm.svg
+[pypi-image]: https://img.shields.io/pypi/v/python-weather.svg?style=flat-square
+[pypi-downloads-image]: https://img.shields.io/pypi/dm/python-weather?style=flat-square
+[codacy-url]: https://app.codacy.com/gh/null8626/python-weather/dashboard
+[codacy-image]: https://app.codacy.com/project/badge/Grade/0f7721b7e4314a748c75a04f0a7e0ce3
+[codecov-url]: https://codecov.io/gh/null8626/python-weather
+[codecov-image]: https://codecov.io/gh/null8626/python-weather/graph/badge.svg
 [ko-fi-url]: https://ko-fi.com/null8626
+[ko-fi-image]: https://ko-fi.com/img/githubbutton_sm.svg
+[ko-fi-brief-image]: https://img.shields.io/badge/donations-ko--fi-red?color=ff5e5b&style=flat-square
 
 A free and asynchronous weather Python API wrapper made in Python, for Python.
 
@@ -16,7 +18,7 @@ A free and asynchronous weather Python API wrapper made in Python, for Python.
 Run the following command in your terminal:
 
 ```console
-$ pip install python-weather
+pip install python-weather
 ```
 
 ## Example
@@ -28,7 +30,6 @@ For more information, please read the [documentation](https://python-weather.rea
 import python_weather
 
 import asyncio
-import os
 
 
 async def main() -> None:
@@ -51,12 +52,6 @@ async def main() -> None:
         print(f' --> {hourly!r}')
 
 if __name__ == '__main__':
-  
-  # 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(main())
 ```
 

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

@@ -3,13 +3,13 @@ requires = ["setuptools"]
 
 [project]
 name = "python-weather"
-version = "2.1.0"
+version = "2.1.2"
 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.12.4"]
+keywords = ["weather", "forecast", "weather-forecast"]
+dependencies = ["aiohttp>=3.13.3"]
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Education",
@@ -23,17 +23,16 @@ classifiers = [
   "Topic :: Scientific/Engineering :: Astronomy",
   "Topic :: Software Development",
   "Topic :: Software Development :: Libraries",
-  "License :: OSI Approved :: MIT License",
   "Programming Language :: Python",
   "Programming Language :: Python :: 3",
   "Programming Language :: Python :: 3 :: Only",
-  "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"
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14"
 ]
-requires-python = ">=3.9"
+requires-python = ">=3.10"
 
 [project.urls]
 Documentation = "https://python-weather.readthedocs.io/en/latest/"
@@ -41,3 +40,14 @@ Repository = "https://github.com/null8626/python-weather"
 Changelog = "https://python-weather.readthedocs.io/en/latest/changelog.html"
 "Donate via GitHub Sponsors" = "https://github.com/sponsors/null8626"
 "Donate via Ko-fi" = "https://ko-fi.com/null8626"
+
+[tool.pytest.ini_options]
+minversion = "8.0"
+testpaths = ["tests"]
+
+[tool.coverage.report]
+exclude_lines = [
+  "^\\s*async def __a\\w+__\\(",
+  "# pragma: nocover",
+  "TYPE_CHECKING:$"
+]

python_weather-2.1.2/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.1.0 → python_weather-2.1.2}/python_weather/base.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 .enums import WindDirection, Kind, Locale, UltraViolet
 from .constants import _Unit
@@ -28,7 +7,10 @@ from .errors import Error
 
 
 class CustomizableBase:
-  __slots__: tuple[str, ...] = ('__unit', '__locale')
+  __slots__: tuple[str, ...] = '_unit', '_locale'
+
+  _unit: _Unit
+  _locale: Locale
 
   def __init__(self, unit: _Unit, locale: Locale):
     self.unit = unit
@@ -38,7 +20,7 @@ class CustomizableBase:
   def unit(self) -> _Unit:
     """The measuring unit used."""
 
-    return self.__unit
+    return self._unit
 
   @unit.setter
   def unit(self, to: _Unit) -> None:
@@ -53,13 +35,13 @@ class CustomizableBase:
     if not isinstance(to, _Unit):
       raise Error('Invalid measuring unit specified!')
 
-    self.__unit = to
+    self._unit = to
 
   @property
   def locale(self) -> Locale:
     """The localization used."""
 
-    return self.__locale
+    return self._locale
 
   @locale.setter
   def locale(self, to: Locale) -> None:
@@ -75,11 +57,12 @@ class CustomizableBase:
     if not isinstance(to, Locale):
       raise Error(f'Expected {to!r} to be a Locale enum')
 
-    self.__locale = to
+    self._locale = to
 
 
 class BaseForecast:
   __slots__: tuple[str, ...] = (
+    'cloud_cover',
     'ultraviolet',
     'humidity',
     'wind_direction',
@@ -93,6 +76,9 @@ class BaseForecast:
     'description',
   )
 
+  cloud_cover: int
+  """The cloud cover value in percent."""
+
   ultraviolet: UltraViolet
   """The ultra-violet index."""
 
@@ -133,6 +119,7 @@ class BaseForecast:
       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(

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

@@ -1,30 +1,8 @@
-"""
-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
-from typing import Optional
 from asyncio import sleep
 
 from .errors import Error, RequestError
@@ -39,56 +17,82 @@ class Client(CustomizableBase):
   """
   Interact with the API's endpoints.
 
+  Examples:
+
+  .. code-block:: python
+
+    # Explicit cleanup
+    client = python_weather.Client(unit=python_weather.IMPERIAL)
+
+    # ...
+
+    await client.close()
+
+    # Implicit cleanup
+    async with python_weather.Client(unit=python_weather.IMPERIAL) as client:
+      # ...
+
   :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 request failure before raising a :class:`.RequestError`. Use ``-1`` to disable (NOT recommended). Defaults to 3 retries.
-  :type max_retries: Optional[:class:`int`]
+  :type session: :class:`~aiohttp.ClientSession` | :py:obj:`None`
+  :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: :class:`int` | :py:obj:`None`
 
   :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'
+
+  __own_session: bool
+  __session: ClientSession
+  _max_retries: int
 
   def __init__(
     self,
     *,
     unit: _Unit = METRIC,
     locale: Locale = Locale.ENGLISH,
-    session: Optional[ClientSession] = None,
-    max_retries: Optional[int] = None,
+    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(verify_ssl=False),
+      connector=TCPConnector(ssl=False),
     )
-    self.__max_retries = max_retries or 3
+    self._max_retries = max_retries or 3
 
   def __repr__(self) -> str:
-    return f'<{__class__.__name__} {self.__session!r}>'
+    return f'<{__class__.__module__}.{__class__.__name__} {self.__session!r}>'
 
   async def get(
     self,
     location: str,
     *,
-    unit: Optional[_Unit] = None,
-    locale: Optional[Locale] = None,
+    unit: _Unit | None = None,
+    locale: Locale | None = None,
   ) -> Forecast:
     """
     Fetches a weather forecast for a specific location.
 
+    Example:
+
+    .. code-block:: python
+
+      weather = await client.get('New York')
+
     :param location: The requested location.
     :type location: :py:class:`str`
     :param unit: Overrides the unit used.
-    :type unit: Optional[``_Unit``]
+    :type unit: ``_Unit`` | :py:obj:`None`
     :param locale: Overrides the locale used.
-    :type locale: Optional[:class:`.Locale`]
+    :type locale: :class:`.Locale` | :py:obj:`None`
 
     :exception TypeError: ``location`` is not a :py:class:`str` or is empty.
     :exception Error: The client is already closed.
@@ -105,14 +109,16 @@ class Client(CustomizableBase):
       raise TypeError(f'Expected a proper location str, got {location!r}')
 
     if not isinstance(unit, _Unit):
-      unit = self._CustomizableBase__unit
+      unit = self._unit
 
     if not isinstance(locale, Locale):
-      locale = self._CustomizableBase__locale
+      locale = self._locale
 
     subdomain = f'{locale.value}.' if locale != Locale.ENGLISH else ''
     attempts = 0
+
     status = None
+    reason = None
 
     while True:
       try:
@@ -124,18 +130,28 @@ class Client(CustomizableBase):
           },
         ) as resp:
           status = resp.status
+          reason = resp.reason
+
           resp.raise_for_status()
 
           return Forecast(await resp.json(), unit, locale)
       except ClientResponseError:
-        if attempts == self.__max_retries:
-          raise RequestError(status) from None
+        if attempts == self._max_retries:
+          raise RequestError(status, reason) from None
 
         await sleep(0.5 * (2**attempts))
         attempts += 1
 
   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."""
+    """
+    Closes the :class:`.Client` object.
+
+    Example:
+
+    .. code-block:: python
+
+      await client.close()
+    """
 
     if self.__own_session and not self.__session.closed:
       await self.__session.close()