def __init__(self, api_key, default_location, locale="en_US"):
"""
:param api_key: OpenWeatherMap API key.
:param default_location: Default location for which to fetch the
weather when none is provided.
:param tts: Optionally, a Text-to-Speech for speaking the weather
results. Such a service should expose a `speak(phrase)`
method.
"""
self.api_key = api_key
self.default_location = default_location
self.locale = locale
self.provider = OWMWeatherProvider(api_key)
class SnipsOWM:
""" OpenWeatherMap skill for Snips. """
def __init__(self, api_key, default_location, locale="en_US"):
"""
:param api_key: OpenWeatherMap API key.
:param default_location: Default location for which to fetch the
weather when none is provided.
:param tts: Optionally, a Text-to-Speech for speaking the weather
results. Such a service should expose a `speak(phrase)`
method.
"""
self.api_key = api_key
self.default_location = default_location
self.locale = locale
self.provider = OWMWeatherProvider(api_key)
def speak_temperature(self, locality, date, granularity=0):
""" Tell the temperature at a given locality and datetime.
:param locality: The locality of the forecast, e.g. 'Paris,fr' or
'Eiffel Tower'
:type locality: string
:param date: Time of the forecast, in ISO 8601 format, e.g.
"2017-07-21T10:35:29+00:00"
:type date: datetime
:return: The temperature at a given locality and datetime.
"""
sentence_generator = TemperatureQuerySentenceGenerator(
locale=self.locale)
if locality is None:
locality = self.default_location
try:
actual_condition, temperature = self.provider.get_weather(
locality, datetime=date)
generated_sentence = sentence_generator.generate_temperature_sentence(
temperature=temperature,
date=date,
granularity=0,
Locality=locality)
except (WeatherProviderError, WeatherProviderConnectivityError):
generated_sentence = sentence_generator.generate_error_sentence()
except WeatherProviderInvalidAPIKey:
generated_sentence = sentence_generator.generate_api_key_error_sentence(
)
except SentenceGenerationLocaleException:
generated_sentence = sentence_generator.generate_error_locale_sentence(
)
actual_condition_group = weather_condition.OWMToWeatherConditionMapper(
actual_condition).resolve()
return generated_sentence, to_led(temperature, actual_condition_group)
def speak_condition(self,
assumed_condition,
date,
POI=None,
Locality=None,
Region=None,
Country=None,
granularity=0):
""" Speak a response for a given weather condition
at a specified locality and datetime.
If the locality is not specified, use the default location.
:param assumed_condition: A SnipsWeatherCondition value string
corresponding to a weather condition extracted from the slots.
e.g 'HUMID', 'SUNNY', etc ...
Can be none, if there is no assumption.
:type assumed_condition: basestring
:param date: datetime of the forecast
:type date: datetime.datetime
:param POI: Slot value from Snips
:type POI: basestring
:param Locality: Slot value from Snips
:type Locality: basestring
:param Region: Slot value from Snips
:type Region: basestring
:param Country: Slot value from Snips
:type Country: basestring
:param granularity: Precision with which the date should be described.
:type granularity: int
:return: A random response for a given weather condition
at a specified locality and datetime.
"""
# Checking the parameters values
if (POI or Locality or Region or Country):
localities = filter(lambda x: x is not None,
[POI, Locality, Region, Country])
locality = localities[0]
else:
locality = self.default_location
Locality = self.default_location
# Initializing variables
assumed_condition_group = weather_condition.WeatherConditionDescriptor(
weather_condition.WeatherConditions.UNKNOWN)
tone = AnswerSentenceGenerator.SentenceTone.NEUTRAL
# We retrieve the condition and the temperature from our weather provider
actual_condition_group = weather_condition.WeatherConditionDescriptor(
weather_condition.WeatherConditions.UNKNOWN)
temperature = 0
actual_condition = None
sentence_generator = ConditionQuerySentenceGenerator(
locale=self.locale)
try:
actual_condition, temperature = self.provider.get_weather(
locality, date)
# We retrieve the weather from our weather provider
actual_condition_group = weather_condition.OWMToWeatherConditionMapper(
actual_condition).resolve()
if assumed_condition:
# We find the category (group) of the received weather description
assumed_condition_group = weather_condition.SnipsToWeatherConditionMapper(
).fuzzy_matching(self.locale, assumed_condition).resolve()
# We check if their is a positive/negative tone to add to the answer
if assumed_condition_group.value != weather_condition.WeatherConditions.UNKNOWN:
tone = AnswerSentenceGenerator.SentenceTone.NEGATIVE if assumed_condition_group.value != actual_condition_group.value else AnswerSentenceGenerator.SentenceTone.POSITIVE
else:
tone = AnswerSentenceGenerator.SentenceTone.NEUTRAL
# We compose the sentence
generated_sentence = sentence_generator.generate_condition_sentence(
tone=tone,
date=date,
granularity=granularity,
condition_description=actual_condition_group.describe(
self.locale),
POI=POI,
Locality=Locality,
Region=Region,
Country=Country)
# And finally send it to the TTS if provided
except (WeatherProviderError, WeatherProviderConnectivityError):
generated_sentence = sentence_generator.generate_error_sentence()
except SentenceGenerationLocaleException:
generated_sentence = sentence_generator.generate_error_locale_sentence(
)
except WeatherProviderInvalidAPIKey:
generated_sentence = sentence_generator.generate_api_key_error_sentence(
)
return generated_sentence, to_led(temperature, actual_condition_group)
def speak_item(self,
item_name,
date,
POI=None,
Locality=None,
Region=None,
Country=None,
granularity=0):
""" Speak a response for a given a item
at a specified locality and datetime.
If the locality is not specified, use the default location.
:param item_name: A SnipsWeatherCondition value string
corresponding to a weather condition extracted from the slots.
e.g 'HUMID', 'SUNNY', etc ...
Can be none, if there is no assumption.
:type item_name: basestring
:param date: datetime of the forecast
:type date: datetime.datetime
:param POI: Slot value from Snips
:type POI: basestring
:param Locality: Slot value from Snips
:type Locality: basestring
:param Region: Slot value from Snips
:type Region: basestring
:param Country: Slot value from Snips
:type Country: basestring
:param granularity: Precision with which the date should be described.
:type granularity: int
:return: A random response for a given weather condition
at a specified locality and datetime.
"""
# Checking the parameters values
if (POI or Locality or Region or Country):
localities = filter(lambda x: x is not None,
[POI, Locality, Region, Country])
locality = localities[0]
else:
locality = self.default_location
Locality = self.default_location
# Initializing variables
assumed_condition_group = weather_condition.WeatherConditionDescriptor(
weather_condition.WeatherConditions.UNKNOWN)
tone = AnswerSentenceGenerator.SentenceTone.NEUTRAL
# We retrieve the condition and the temperature from our weather provider
actual_condition_group = weather_condition.WeatherConditionDescriptor(
weather_condition.WeatherConditions.UNKNOWN)
sentence_generator = ConditionQuerySentenceGenerator(
locale=self.locale)
try:
actual_condition, temperature = self.provider.get_weather(
locality, date)
# We retrieve the weather from our weather provider
actual_condition_group = weather_condition.OWMToWeatherConditionMapper(
actual_condition).resolve()
if item_name:
# We find the category (group) of the received weather description
assumed_condition_group = weather_condition.SnipsToWeatherConditionMapper(
).fuzzy_matching(self.locale, item_name).resolve()
# We check if their is a positive/negative tone to add to the answer
if assumed_condition_group.value != weather_condition.WeatherConditions.UNKNOWN:
tone = AnswerSentenceGenerator.SentenceTone.NEGATIVE if assumed_condition_group.value != actual_condition_group.value else AnswerSentenceGenerator.SentenceTone.POSITIVE
else:
tone = AnswerSentenceGenerator.SentenceTone.NEUTRAL
# We compose the sentence
generated_sentence = sentence_generator.generate_condition_sentence(
tone=tone,
date=date,
granularity=granularity,
condition_description=actual_condition_group.describe(
self.locale),
POI=POI,
Locality=Locality,
Region=Region,
Country=Country)
# And finally send it to the TTS if provided
except (WeatherProviderError, WeatherProviderConnectivityError):
generated_sentence = sentence_generator.generate_error_sentence()
except SentenceGenerationLocaleException:
generated_sentence = sentence_generator.generate_error_locale_sentence(
)
except WeatherProviderInvalidAPIKey:
generated_sentence = sentence_generator.generate_api_key_error_sentence(
)
return generated_sentence, to_led(temperature, actual_condition_group)