Vigilance Météo provides a python API to fetch weather alerts in France or Andorre from Météo France (http://vigilance.meteofrance.com) website.
VigilanceMeteoFranceProxy
class manages the communication with the source website. The
algorithm request a cheksum tiny file to download and update the XML source only when
needed.
DepartmentWeatherAlert
class allows to fetch all weather alerts for a french department or Andorre. Each DepartmenWeatherAlert
instance can have its own proxy, but you should use
only one proxy for all DepartmenWeatherAlert
instances in your program to avoid too much HTTP request on source website.
department_color
: return the overall criticity color for the departmentadditional_info_URL
: return the URL to access more information about department weather alerts from the MétéoFrance websitebulletin_date
: return the latest bulletin update date & time with timezonedepartment
: get or set the department number corresponding to the area watchedalerts_list
: return the list of all alert typesproxy
: return the client (aVigilanceMeteoFranceProxy
instance) used by the object
update_department_status()
: update alerts list by feching latest info from MétéoFrance forcast.summary_message(format)
: return a string with textual synthesis of the active alerts in department. According to value of 'format' parameter, the string return change: 'text' (default) or 'html'
xml_tree
= XML representation of the weather alert bulletinbulletin_date
= Date of the bulletin (with timezone)checksum
= Checksum of the weather alert bulletinstatus
= current status of the proxy (possible value inconstant.py
)
update_date()
: Check if new information are available and download them if any.get_alert_list(department)
: of a given department return the list of the alerts.
>>>import vigilancemeteo
>>>zone = vigilancemeteo.DepartmentWeatherAlert('92')
>>>zone.department_color
'Jaune'
>>>zone.additional_info_URL
'http://vigilance.meteofrance.com/Bulletin_sans.html?a=dept75&b=1&c='
>>>zone.summary_message('text')
'Alerte météo Jaune en cours :\n - Vent violent: Jaune'
You can use the official release using the pyPi package. Install it with the command:
pip install vigilancemeteo
If you want to contribute to the development:
- Start by cloning this repository.
- Setup a virtual environment
- Install the python package in edition mode:
pip install -e .
- Create a branch for your feature
- Test your change using
tox
- Send a PR when ready.
Thank you to Lunarok to show an implementation example in PHP for Jeedom. Lot of inspiration for the first python implementation.
Since release 3.0.0, the python implementation use the the recommendation made by Météo France on www.data.gouv.fr.
This software is under the MIT License.