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

{python_weather-2.0.7 → python_weather-2.1.1}/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.7 → python_weather-2.1.1}/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.0.7/python_weather.egg-info → python_weather-2.1.1}/PKG-INFO

@@ -1,104 +1,104 @@
-Metadata-Version: 2.1
-Name: python-weather
-Version: 2.0.7
-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.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
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: aiohttp>=3.10.10
-
-# [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.
-
-## Installation
-
-```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 getweather() -> 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')
-    
-    # returns the current day's forecast temperature (int)
-    print(weather.temperature)
-    
-    # get the weather forecast for a few days
-    for daily in weather:
-      print(daily)
-      
-      # 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(getweather())
-```
-
-## 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.1
+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.2
+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.0.7 → python_weather-2.1.1}/README.md

@@ -1,17 +1,21 @@
-# [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.
 
-## Installation
+## Getting started
+
+Run the following command in your terminal:
 
 ```console
 pip install python-weather
@@ -22,36 +26,33 @@ 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
-  if os.name == 'nt':
-    asyncio.set_event_loop_policy(asyncio.WindowsSelectorEventLoopPolicy())
-  
-  asyncio.run(getweather())
+  asyncio.run(main())
 ```
 
 ## Data source

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

@@ -3,13 +3,13 @@ requires = ["setuptools"]
 
 [project]
 name = "python-weather"
-version = "2.0.7"
+version = "2.1.1"
 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"]
+keywords = ["weather", "forecast", "weather-forecast"]
+dependencies = ["aiohttp>=3.13.2"]
 classifiers = [
   "Development Status :: 5 - Production/Stable",
   "Intended Audience :: Education",
@@ -23,18 +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.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"
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14"
 ]
-requires-python = ">=3.8"
+requires-python = ">=3.10"
 
 [project.urls]
 Documentation = "https://python-weather.readthedocs.io/en/latest/"
@@ -42,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.0.7 → python_weather-2.1.1}/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,23 +25,31 @@ SOFTWARE.
 from .enums import HeatIndex, Kind, Locale, Phase, UltraViolet, WindDirection
 from .constants import METRIC, IMPERIAL
 from .errors import Error, RequestError
+from .forecast import Forecast
+from .version import VERSION
 from .client import Client
 
+
 __title__ = 'python-weather'
 __author__ = 'null8626'
+__credits__ = (__author__,)
+__maintainer__ = __author__
+__status__ = 'Production'
 __license__ = 'MIT'
-__copyright__ = 'Copyright (c) 2021-2024 null8626'
-__version__ = '2.0.7'
+__copyright__ = 'Copyright (c) 2021-2025 null8626'
+__version__ = VERSION
 __all__ = (
   'METRIC',
   'IMPERIAL',
   'Client',
   'Error',
+  'Forecast',
   'RequestError',
   'HeatIndex',
   'Kind',
   'Locale',
   'Phase',
   'UltraViolet',
+  'VERSION',
   'WindDirection',
 )

{python_weather-2.0.7 → python_weather-2.1.1}/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,16 @@ 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'
+
+  _unit: _Unit
+  _locale: Locale
 
   def __init__(self, unit: _Unit, locale: Locale):
     self.unit = unit
@@ -38,48 +39,51 @@ class CustomizableBase:
 
   @property
   def unit(self) -> _Unit:
-    """The measuring unit used to display information in this object."""
+    """The measuring unit used."""
 
-    return self.__unit
+    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):
       raise Error('Invalid measuring unit specified!')
 
-    self.__unit = to
+    self._unit = to
 
   @property
   def locale(self) -> Locale:
-    """The localization used to display information in this object."""
+    """The localization used."""
 
-    return self.__locale
+    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):
       raise Error(f'Expected {to!r} to be a Locale enum')
 
-    self.__locale = to
+    self._locale = to
 
 
 class BaseForecast:
-  __slots__: Tuple[str, ...] = (
+  __slots__: tuple[str, ...] = (
+    'cloud_cover',
     'ultraviolet',
     'humidity',
     'wind_direction',
@@ -93,8 +97,11 @@ class BaseForecast:
     'description',
   )
 
+  cloud_cover: int
+  """The cloud cover value in percent."""
+
   ultraviolet: UltraViolet
-  """The ultra-violet (UV) index."""
+  """The ultra-violet index."""
 
   humidity: int
   """The humidity value in percent."""
@@ -106,10 +113,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 +131,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 = (
@@ -133,6 +140,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(