pyVisualCrossing 0.1.0__py3-none-any.whl

pyVisualCrossing/__init__.py

@@ -0,0 +1,10 @@
+"""Python Wrapper for Visual Crossing Weather API."""
+from __future__ import annotations
+
+from pyVisualCrossing.api import VisualCrossing
+from pyVisualCrossing.data import ForecastData, ForecastDailyData, ForecastHourlyData
+
+__title__ = "pyVisualCrossing"
+__version__ = "0.1.0"
+__author__ = "briis"
+__license__ = "MIT"

pyVisualCrossing/api.py

@@ -0,0 +1,275 @@
+"""
+This module contains the code to get weather data from
+Visual Crossing API.
+See: https://www.visualcrossing.com/
+"""
+from __future__ import annotations
+
+import abc
+import datetime
+import json
+import logging
+
+from typing import List, Any, Dict
+from urllib.request import urlopen
+
+import aiohttp
+
+from .const import SUPPORTED_LANGUAGES, VISUALCROSSING_BASE_URL
+from .data import ForecastData, ForecastDailyData, ForecastHourlyData
+
+UTC = datetime.timezone.utc
+
+_LOGGER = logging.getLogger(__name__)
+
+class VisualCrossingException(Exception):
+    """Exception thrown if failing to access API."""
+
+
+class VisualCrossingAPIBase:
+    """
+    Baseclass to use as dependency injection pattern for easier
+    automatic testing
+    """
+
+    @abc.abstractmethod
+    def fetch_data(self, api_key: str, latitude: float, longitude: float, days: int, language: str) -> Dict[str, Any]:
+        """Override this"""
+        raise NotImplementedError(
+            "users must define fetch_data to use this base class"
+        )
+
+    @abc.abstractmethod
+    async def async_fetch_data(
+        api_key: str, latitude: float, longitude: float, days: int, language: str
+    ) -> Dict[str, Any]:
+        """Override this"""
+        raise NotImplementedError(
+            "users must define fetch_data to use this base class"
+        )
+
+class VisualCrossingAPI(VisualCrossingAPIBase):
+    """Default implementation for WeatherFlow api"""
+
+    def __init__(self) -> None:
+        """Init the API with or without session"""
+        self.session = None
+
+    def fetch_data(self, api_key: str, latitude: float, longitude: float, days: int, language: str) -> Dict[str, Any]:
+        """Get data from API."""
+        api_url =f"{VISUALCROSSING_BASE_URL}{latitude},{longitude}/today/next{days}days?unitGroup=metric&key={api_key}&contentType=json&iconSet=icons2&lang={language}"
+        _LOGGER.debug("URL: %s", api_url)
+
+        response = urlopen(api_url)
+        data = response.read().decode("utf-8")
+        json_data = json.loads(data)
+
+        return json_data
+
+    async def async_fetch_data(self, api_key: str, latitude: float, longitude: float, days: int, language: str) -> Dict[str, Any]:
+        """Get data from API."""
+        api_url =f"{VISUALCROSSING_BASE_URL}{latitude},{longitude}/today/next{days}days?unitGroup=metric&key={api_key}&contentType=json&iconSet=icons2&lang={language}"
+
+        is_new_session = False
+        if self.session is None:
+            self.session = aiohttp.ClientSession()
+            is_new_session = True
+
+        async with self.session.get(api_url) as response:
+            if response.status != 200:
+                if is_new_session:
+                    await self.session.close()
+                raise VisualCrossingException(
+                    f"Failed to access Visual Crossing API with status code {response.status}"
+                )
+            data = await response.text()
+            if is_new_session:
+                await self.session.close()
+            return json.loads(data)
+
+class VisualCrossing:
+    """
+    Class that uses the weather API from Visual Crossing
+    to retreive Weather Data for supplied Latitude and
+    longitude location
+    """
+
+    def __init__(
+        self,
+        api_key: str,
+        latitude: float,
+        longitude: float,
+        days: int = 14,
+        language: str = "en",
+        session: aiohttp.ClientSession = None,
+        api: VisualCrossingAPIBase =VisualCrossingAPI(),
+    ) -> None:
+        self._api_key = api_key
+        self._latitude = latitude
+        self._longitude = longitude
+        self._days = days
+        self._language = language
+        self._api = api
+        self._json_data = None
+
+        if days > 14:
+            self._days = 14
+
+        if session:
+            self._api.session = session
+
+        if language not in SUPPORTED_LANGUAGES:
+            self._language = "en"
+
+    def fetch_data(self) -> List[ForecastData]:
+        """Returns a list of weather data."""
+
+        if self._json_data is None:
+            self._json_data = self._api.fetch_data(self._api_key, self._latitude, self._longitude, self._days, self._language)
+
+        return _fetch_data(self._json_data)
+
+    async def async_fetch_data(self) -> List[ForecastData]:
+        """Returns a list of weather data."""
+
+        if self._json_data is None:
+            self._json_data = await self._api.async_fetch_data(self._api_key, self._latitude, self._longitude, self._days, self._language)
+
+        return _fetch_data(self._json_data)
+
+def _fetch_data(api_result: dict) -> List[ForecastData]:
+    """Converts result from API to ForecastData List."""
+
+    # Add Current Condition Data
+    weather_data: ForecastData = _get_current_data(api_result)
+
+    forecast_daily = []
+    forecast_hourly = []
+
+    # Loop Through Records and add Daily and Hourly Forecast Data
+    for item in api_result["days"]:
+        valid_time = datetime.datetime.utcfromtimestamp(item["datetimeEpoch"]).replace(tzinfo=UTC)
+        condition = item.get("conditions", None)
+        cloudcover = item.get("cloudcover", None)
+        icon = item.get("icon", None)
+        temperature = item.get("tempmax", None)
+        temp_low = item.get("tempmin", None)
+        dew_point = item.get("dew", None)
+        apparent_temperature = item.get("feelslike", None)
+        precipitation = item.get("precip", None)
+        precipitation_probability = item.get("precipprob", None)
+        humidity = item.get("humidity", None)
+        pressure = item.get("pressure", None)
+        uv_index = item.get("uvindex", None)
+        wind_speed = item.get("windspeed", None)
+        wind_gust_speed = item.get("windgust", None)
+        wind_bearing = item.get("winddir", None)
+
+        day_data = ForecastDailyData(
+            valid_time,
+            temperature,
+            temp_low,
+            apparent_temperature,
+            condition,
+            icon,
+            cloudcover,
+            dew_point,
+            humidity,
+            precipitation_probability,
+            precipitation,
+            pressure,
+            wind_bearing,
+            wind_speed,
+            wind_gust_speed,
+            uv_index,
+        )
+        forecast_daily.append(day_data)
+
+        # Add Hourly data for this day
+        for row in item["hours"]:
+            valid_time = datetime.datetime.utcfromtimestamp(row["datetimeEpoch"]).replace(tzinfo=UTC)
+            condition = row.get("conditions", None)
+            cloudcover = row.get("cloudcover", None)
+            icon = row.get("icon", None)
+            temperature = row.get("temp", None)
+            dew_point = row.get("dew", None)
+            apparent_temperature = row.get("feelslike", None)
+            precipitation = row.get("precip", None)
+            precipitation_probability = row.get("precipprob", None)
+            humidity = row.get("humidity", None)
+            pressure = row.get("pressure", None)
+            uv_index = row.get("uvindex", None)
+            wind_speed = row.get("windspeed", None)
+            wind_gust_speed = row.get("windgust", None)
+            wind_bearing = row.get("winddir", None)
+
+            hour_data = ForecastHourlyData(
+                valid_time,
+                temperature,
+                apparent_temperature,
+                condition,
+                cloudcover,
+                icon,
+                dew_point,
+                humidity,
+                precipitation,
+                precipitation_probability,
+                pressure,
+                wind_bearing,
+                wind_gust_speed,
+                wind_speed,
+                uv_index,
+            )
+            forecast_hourly.append(hour_data)
+
+    weather_data.forecast_daily = forecast_daily
+    weather_data.forecast_hourly = forecast_hourly
+
+    return weather_data
+
+# pylint: disable=R0914, R0912, W0212, R0915
+def _get_current_data(api_result: dict) -> List[ForecastData]:
+    """Converts results from API to WeatherFlowForecast list"""
+
+    item = api_result["currentConditions"]
+
+    valid_time = datetime.datetime.utcfromtimestamp(item["datetimeEpoch"]).replace(tzinfo=UTC)
+    condition = item.get("conditions", None)
+    cloudcover = item.get("cloudcover", None)
+    icon = item.get("icon", None)
+    temperature = item.get("temp", None)
+    dew_point = item.get("dew", None)
+    apparent_temperature = item.get("feelslike", None)
+    precipitation = item.get("precip", None)
+    precipitation_probability = item.get("precipprob", None)
+    humidity = item.get("humidity", None)
+    solarradiation = item.get("solarradiation", None)
+    visibility = item.get("visibility", None)
+    pressure = item.get("pressure", None)
+    uv_index = item.get("uvindex", None)
+    wind_speed = item.get("windspeed", None)
+    wind_gust_speed = item.get("windgust", None)
+    wind_bearing = item.get("winddir", None)
+
+    current_condition = ForecastData(
+        valid_time,
+        apparent_temperature,
+        condition,
+        cloudcover,
+        dew_point,
+        humidity,
+        icon,
+        precipitation,
+        precipitation_probability,
+        pressure,
+        solarradiation,
+        temperature,
+        visibility,
+        uv_index,
+        wind_bearing,
+        wind_gust_speed,
+        wind_speed,
+    )
+
+    return current_condition
+

pyVisualCrossing/const.py

@@ -0,0 +1,5 @@
+"""System Wide constants for Visual Crossing Weather Wrapper."""
+from __future__ import annotations
+
+SUPPORTED_LANGUAGES = ["ar", "bg", "cs", "da", "de", "el", "en", "es", "fa", "fi", "fr", "he", "hu", "it", "ja", "ko", "nl", "pl", "pt", "sr", "sv", "tr", "uk", "vi", "zh"]
+VISUALCROSSING_BASE_URL = "https://weather.visualcrossing.com/VisualCrossingWebServices/rest/services/timeline/"

pyVisualCrossing/data.py

@@ -0,0 +1,392 @@
+"""Holds the Data Classes for Visual Crossing Wrapper"""
+
+from __future__ import annotations
+from datetime import datetime
+from typing import List
+
+class ForecastData:
+    """Class to hold forecast data."""
+        # pylint: disable=R0913, R0902, R0914
+    def __init__(
+        self,
+        datetime: datetime,
+        apparent_temperature: float,
+        condition: str,
+        cloud_cover: int,
+        dew_point: float,
+        humidity: int,
+        icon: str,
+        precipitation: float,
+        precipitation_probability: int,
+        pressure: float,
+        solarradiation: float,
+        temperature: float,
+        visibility: int,
+        uv_index: int,
+        wind_bearing: int,
+        wind_gust_speed: float,
+        wind_speed: float,
+        forecast_daily: ForecastDailyData = None,
+        forecast_hourly: ForecastHourlyData = None,
+    ) -> None:
+        """Constructor"""
+        self._datetime = datetime
+        self._apparent_temperature = apparent_temperature
+        self._condition = condition
+        self._cloud_cover = cloud_cover
+        self._dew_point = dew_point
+        self._humidity = humidity
+        self._icon = icon
+        self._precipitation = precipitation
+        self._precipitation_probability = precipitation_probability
+        self._pressure = pressure
+        self._solarradiation = solarradiation
+        self._visibility = visibility
+        self._temperature = temperature
+        self._uv_index = uv_index
+        self._wind_bearing = wind_bearing
+        self._wind_gust_speed = wind_gust_speed
+        self._wind_speed = wind_speed
+        self._forecast_daily = forecast_daily
+        self._forecast_hourly = forecast_hourly
+
+
+    @property
+    def temperature(self) -> float:
+        """Air temperature (Celcius)"""
+        return self._temperature
+
+    @property
+    def dew_point(self) -> float:
+        """Dew Point (Celcius)"""
+        return self._dew_point
+
+    @property
+    def condition(self) -> str:
+        """Weather condition text."""
+        return self._condition
+
+    @property
+    def cloud_cover(self) -> int:
+        """Cloud Coverage."""
+        return self._cloud_cover
+
+    @property
+    def icon(self) -> str:
+        """Weather condition symbol."""
+        return self._icon
+
+    @property
+    def humidity(self) -> int:
+        """Humidity (%)."""
+        return self._humidity
+
+    @property
+    def apparent_temperature(self) -> float:
+        """Feels like temperature (Celcius)."""
+        return self._apparent_temperature
+
+    @property
+    def precipitation(self) -> float:
+        """Precipitation (mm)."""
+        return self._precipitation
+
+    @property
+    def precipitation_probability (self) -> int:
+        """Posobility of Precipiation (%)."""
+        return self._precipitation_probability
+
+    @property
+    def pressure(self) -> float:
+        """Sea Level Pressure (MB)"""
+        return self._pressure
+
+    @property
+    def solarradiation(self) -> float:
+        """Solar Radiation (w/m2)"""
+        return self._solarradiation
+
+    @property
+    def visibility(self) -> int:
+        """Visibility (km)"""
+        return self._visibility
+
+
+    @property
+    def wind_bearing(self) -> float:
+        """Wind bearing (degrees)"""
+        return self._wind_bearing
+
+    @property
+    def wind_gust_speed(self) -> float:
+        """Wind gust (m/s)"""
+        return self._wind_gust_speed
+
+    @property
+    def wind_speed(self) -> float:
+        """Wind speed (m/s)"""
+        return self._wind_speed
+
+    @property
+    def uv_index(self) -> float:
+        """UV Index"""
+        return self._uv_index
+
+    @property
+    def datetime(self) -> datetime:
+        """Valid time"""
+        return self._datetime
+
+    @property
+    def forecast_daily(self) -> ForecastDailyData:
+        """Forecast List"""
+        return self._forecast_daily
+
+    @forecast_daily.setter
+    def forecast_daily(self, new_forecast):
+        """Sets a new Value for forecast daily"""
+        self._forecast_daily = new_forecast
+
+    @property
+    def forecast_hourly(self) -> ForecastHourlyData:
+        """Forecast List"""
+        return self._forecast_hourly
+
+    @forecast_hourly.setter
+    def forecast_hourly(self, new_forecast):
+        """Sets a new Value for forecast hourly"""
+        self._forecast_hourly = new_forecast
+
+class ForecastDailyData:
+    """Class to hold daily forecast data."""
+        # pylint: disable=R0913, R0902, R0914
+    def __init__(
+        self,
+        datetime: datetime,
+        temperature: float,
+        temp_low: float,
+        apparent_temperature: float,
+        condition: str,
+        icon: str,
+        cloud_cover: int,
+        dew_point: float,
+        humidity: int,
+        precipitation_probability: int,
+        precipitation: float,
+        pressure: float,
+        wind_bearing: int,
+        wind_speed: float,
+        wind_gust: float,
+        uv_index: int,
+    ) -> None:
+        """Constructor"""
+        self._datetime = datetime
+        self._temperature = temperature
+        self._temp_low = temp_low
+        self._apparent_temperature = apparent_temperature
+        self._condition = condition
+        self._cloud_cover = cloud_cover
+        self._dew_point = dew_point
+        self._humidity = humidity
+        self._icon = icon
+        self._precipitation_probability = precipitation_probability
+        self._precipitation = precipitation
+        self._pressure = pressure
+        self._wind_bearing = wind_bearing
+        self._wind_gust = wind_gust
+        self._wind_speed = wind_speed
+        self._uv_index = uv_index
+
+    @property
+    def datetime(self) -> datetime:
+        """Valid time"""
+        return self._datetime
+
+    @property
+    def temperature(self) -> float:
+        """Air temperature (Celcius)"""
+        return self._temperature
+
+    @property
+    def temp_low(self) -> float:
+        """Air temperature min during the day (Celcius)"""
+        return self._temp_low
+
+    @property
+    def apparent_temperature(self) -> float:
+        """Feels like temperature (Celcius)."""
+        return self._apparent_temperature
+
+    @property
+    def condition(self) -> str:
+        """Weather condition text."""
+        return self._condition
+
+    @property
+    def cloud_cover(self) -> int:
+        """Cloud Coverage."""
+        return self._cloud_cover
+
+    @property
+    def dew_point(self) -> float:
+        """Dew Point (Celcius)"""
+        return self._dew_point
+
+    @property
+    def humidity(self) -> int:
+        """Humidity (%)."""
+        return self._humidity
+
+    @property
+    def icon(self) -> str:
+        """Weather condition symbol."""
+        return self._icon
+
+    @property
+    def precipitation_probability (self) -> int:
+        """Posobility of Precipiation (%)."""
+        return self._precipitation_probability
+
+    @property
+    def precipitation(self) -> float:
+        """Precipitation (mm)."""
+        return self._precipitation
+
+    @property
+    def pressure(self) -> float:
+        """Sea Level Pressure (MB)"""
+        return self._pressure
+
+    @property
+    def uv_index(self) -> float:
+        """UV Index"""
+        return self._uv_index
+
+    @property
+    def wind_bearing(self) -> float:
+        """Wind bearing (degrees)"""
+        return self._wind_bearing
+
+    @property
+    def wind_gust(self) -> float:
+        """Wind Gust speed (m/s)"""
+        return self._wind_gust
+
+    @property
+    def wind_speed(self) -> float:
+        """Wind speed (m/s)"""
+        return self._wind_speed
+
+
+class ForecastHourlyData:
+    """Class to hold hourly forecast data."""
+        # pylint: disable=R0913, R0902, R0914
+    def __init__(
+        self,
+        datetime: datetime,
+        temperature: float,
+        apparent_temperature: float,
+        condition: str,
+        cloud_cover: int,
+        icon: str,
+        dew_point: float,
+        humidity: int,
+        precipitation: float,
+        precipitation_probability: int,
+        pressure: float,
+        wind_bearing: float,
+        wind_gust_speed: int,
+        wind_speed: int,
+        uv_index: float,
+    ) -> None:
+        """Constructor"""
+        self._datetime = datetime
+        self._temperature = temperature
+        self._apparent_temperature = apparent_temperature
+        self._condition = condition
+        self._cloud_cover = cloud_cover
+        self._icon = icon
+        self._dew_point = dew_point
+        self._humidity = humidity
+        self._precipitation = precipitation
+        self._precipitation_probability = precipitation_probability
+        self._pressure = pressure
+        self._wind_bearing = wind_bearing
+        self._wind_gust_speed = wind_gust_speed
+        self._wind_speed = wind_speed
+        self._uv_index = uv_index
+
+    @property
+    def temperature(self) -> float:
+        """Air temperature (Celcius)"""
+        return self._temperature
+
+    @property
+    def condition(self) -> str:
+        """Weather condition text."""
+        return self._condition
+
+    @property
+    def cloud_cover(self) -> int:
+        """Cloud Coverage."""
+        return self._cloud_cover
+
+    @property
+    def dew_point(self) -> float:
+        """Dew Point (Celcius)"""
+        return self._dew_point
+
+    @property
+    def icon(self) -> str:
+        """Weather condition symbol."""
+        return self._icon
+
+    @property
+    def humidity(self) -> int:
+        """Humidity (%)."""
+        return self._humidity
+
+    @property
+    def apparent_temperature(self) -> float:
+        """Feels like temperature (Celcius)."""
+        return self._apparent_temperature
+
+    @property
+    def precipitation(self) -> float:
+        """Precipitation (mm)."""
+        return self._precipitation
+
+    @property
+    def precipitation_probability (self) -> int:
+        """Posobility of Precipiation (%)."""
+        return self._precipitation_probability
+
+    @property
+    def pressure(self) -> float:
+        """Sea Level Pressure (MB)"""
+        return self._pressure
+
+    @property
+    def wind_bearing(self) -> float:
+        """Wind bearing (degrees)"""
+        return self._wind_bearing
+
+    @property
+    def wind_gust_speed(self) -> float:
+        """Wind gust (m/s)"""
+        return self._wind_gust_speed
+
+    @property
+    def wind_speed(self) -> float:
+        """Wind speed (m/s)"""
+        return self._wind_speed
+
+    @property
+    def uv_index(self) -> float:
+        """UV Index"""
+        return self._uv_index
+
+    @property
+    def datetime(self) -> datetime:
+        """Valid time"""
+        return self._datetime

pyVisualCrossing-0.1.0.dist-info/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Bjarne Riis
+
+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.

pyVisualCrossing-0.1.0.dist-info/METADATA

@@ -0,0 +1,83 @@
+Metadata-Version: 2.1
+Name: pyVisualCrossing
+Version: 0.1.0
+Summary: Gets the weather data from Visual Crossing
+Home-page: https://github.com/briis/pyVisualCrossing
+Author: briis
+Author-email: bjarne@briis.com
+License: MIT
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Development Status :: 4 - Beta
+Description-Content-Type: text/markdown
+License-File: LICENSE
+
+# Python Wrapper for Visual Crossing Weather API
+
+This Python Wrapper retrives data from the [Visual Crossing](https://www.visualcrossing.com/) API. Visual Crossing has an extensive Weather API for both historical and forecast weather data, and they have a Free Tier API Key which enables up to 1000 calls per day.
+
+In order to get started you must create an Account with Visual Crossing and then create an API Key. You do this by accessing [this website](https://www.visualcrossing.com/weather-data-editions) and clicking on the **Free** plan. Then follow the instructions to create and account and store your key in a safe place.
+
+## Usage
+
+Install the module by using this command in a terminal: `pip install pyVisualCrossing`
+
+And then see `test_module.py` and `async_test_module.py` in the `samples` directory for usage examples, both standard and async.
+
+## Parameters
+
+```python
+# Initialise the module
+vcapi = VisualCrossing(
+    api_key,
+    latitude,
+    longitude,
+    days=7,
+    language="da"
+)
+````
+
+| Parameter | Required | Default | Description |
+| --------- | -------- | ------- | ----------- |
+| `api_key` | Yes      | `None`  | This is the API Key you signed up for from Visual Crossing. See above for instructions |
+| `latitude` | Yes     | `None`  | Latitude for the location position |
+| `longitude` | Yes     | `None`  | Longitude for the location position |
+| `days` | No     | `14`  | Numbers of days to retrieve forecast for. 14 days means today plus the next 14 days. On the Free plan, this is the maximum number of days |
+| `language` | No     | `en`  | The language in which text strings should be returned. Se below for list of valid languages. |
+| `session` | No     | `None`  | A session variable. Only used when using the async function. |
+
+
+
+For an in-depth description of the Visual Crossing API, go [here](https://www.visualcrossing.com/resources/documentation/weather-api/timeline-weather-api/)
+
+## Languages
+Available languages include: ar (Arabic), bg (Bulgiarian), cs (Czech), da (Danish), de (German), el (Greek Modern), en (English), es (Spanish), fa (Farsi), fi (Finnish), fr (French), he (Hebrew), hu, (Hungarian), it (Italian), ja (Japanese), ko (Korean), nl (Dutch), pl (Polish), pt (Portuguese), ru (Russian),, sr (Serbian), sv (Swedish), tr (Turkish), uk (Ukranian), vi (Vietnamese) and zh (Chinese).
+
+## Icons
+We use the Iconset *icons2*, which gives a more detailed description of the conditions.
+
+| Icon id	            | Weather Conditions |
+| --------------------  | ---------------------------- |
+| snow	                | Amount of snow is greater than zero |
+| snow-showers-day	    | Periods of snow during the day |
+| snow-showers-night    | Periods of snow during the night |
+| thunder-rain	        | Thunderstorms throughout the day or night |
+| thunder-showers-day   | Possible thunderstorms throughout the day |
+| thunder-showers-night | Possible thunderstorms throughout the night |
+| rain                  | Amount of rainfall is greater than zero |
+| showers-day           | Rain showers during the day |
+| showers-night         | Rain showers during the night |
+| fog                   | Visibility is low (lower than one kilometer or mile) |
+| wind                  | Wind speed is high (greater than 30 kph or mph) |
+| cloudy                | Cloud cover is greater than 90% cover |
+| partly-cloudy-day     | Cloud cover is greater than 20% cover during day time. |
+| partly-cloudy-night   | Cloud cover is greater than 20% cover during night time. |
+| clear-day             | Cloud cover is less than 20% cover during day time |
+| clear-night           | Cloud cover is less than 20% cover during night time |
+
+## TODO
+
+- Add all available items to the Data Structure
+- Create `async_test_module.py` in the samples directory
+- More detailed error handling.

pyVisualCrossing-0.1.0.dist-info/RECORD

@@ -0,0 +1,9 @@
+pyVisualCrossing/__init__.py,sha256=gDdseMKZlvecfdCpAtaSL1jP-Stxh-pkviKcFpJk0NM,319
+pyVisualCrossing/api.py,sha256=stl4kk8Ov8UUHjfU_r2tV4JVHijunVhRf5a8cPtbHeg,9261
+pyVisualCrossing/const.py,sha256=8vhxvLIguiPPDB8h93z1j7OVpzHFjyrpvtgjSUZD4go,387
+pyVisualCrossing/data.py,sha256=45uZ15AxefuyUrkEZ2bmihXQIsNfKM3CYG4vpwIwl6A,10500
+pyVisualCrossing-0.1.0.dist-info/LICENSE,sha256=Z_3SNSdtSUo8UsGZ7hnBOXjDSTvFWEbUxNJxdRjaxLk,1068
+pyVisualCrossing-0.1.0.dist-info/METADATA,sha256=sjaslhNN7NDC6zmahmKBpLE1oSLycM4bKSwyC_MBl2A,4298
+pyVisualCrossing-0.1.0.dist-info/WHEEL,sha256=yQN5g4mg4AybRjkgi-9yy4iQEFibGQmlz78Pik5Or-A,92
+pyVisualCrossing-0.1.0.dist-info/top_level.txt,sha256=hw0rVTorvfSv7hOAv0z8xq49056RxL4slkUaklJ0mOU,17
+pyVisualCrossing-0.1.0.dist-info/RECORD,,

pyVisualCrossing-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.41.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

pyVisualCrossing-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+pyVisualCrossing