Vigilance Météo
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.
Classes descritpion
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.
DepartmentWeatherAlert
class
Public attributes from 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
DepartmentWeatherAlert
class
Public methods from 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'
VigilanceMeteoFranceProxy
class
Public attributes from 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
)
VigilanceMeteoFranceProxy
class
Public Methods from 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.
Examples
>>>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'
Installation
You can use the official release using the pyPi package. Install it with the command:
pip install vigilancemeteo
Contribute
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.
References
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.
License
This software is under the MIT License.