跳转到主要内容

python API,用于从http://vigilance.meteofrance.com/获取活动气象警报

项目描述

Vigilance Météo

Build Status codecov PyPI version License: MIT

Vigilance Météo提供了一个Python API,可以从Météo France(http://vigilance.meteofrance.com)网站获取法国或安道尔的气象警报。

类描述

VigilanceMeteoFranceProxy类管理与源网站的通信。算法仅在需要时请求校验和小的文件以下载和更新XML源。

DepartmentWeatherAlert类允许获取法国部门或安道尔的全部气象警报。每个DepartmentWeatherAlert实例可以有自己的代理,但你应该在你的程序中使用一个代理来避免在源网站上产生过多的HTTP请求。

DepartmentWeatherAlert类的公共属性

  • department_color:返回部门的总体严重性颜色
  • additional_info_URL:返回访问MétéoFrance网站获取更多关于部门气象警报信息的URL
  • bulletin_date:返回最新的公告更新日期和时间及时区
  • department:获取或设置对应于监视区域的部门编号
  • alerts_list:返回所有警报类型的列表
  • proxy:返回对象使用的客户端(VigilanceMeteoFranceProxy实例)

DepartmentWeatherAlert类的公共方法

  • update_department_status():通过从MétéoFrance预报获取最新信息来更新警报列表。
  • summary_message(format):返回一个包含部门中活动警报文本摘要的字符串。根据'format'参数的值,字符串返回会发生变化:'text'(默认)或'html'。

VigilanceMeteoFranceProxy类的公共属性

  • xml_tree = 天气警报公告的XML表示
  • bulletin_date = 公告日期(含时区)
  • checksum = 天气警报公告的校验和
  • status = 代理当前状态(可能值见 constant.py

VigilanceMeteoFranceProxy 类的公共方法

  • update_date():检查是否有新信息可用,如有则下载。
  • get_alert_list(department):返回指定部门的警报列表。

示例

>>>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'

安装

您可以使用官方版本,通过 PyPi 包。使用以下命令安装:pip install vigilancemeteo

贡献

如果您想为开发贡献力量

  • 首先克隆此仓库。
  • 设置虚拟环境
  • 以编辑模式安装Python包:pip install -e .
  • 为您的功能创建分支
  • 使用 tox 测试您的更改
  • 准备就绪后发送PR。

参考文献

感谢 Lunarok 展示了在 Jeedom 中的 PHP 实现示例 (见此处)。第一版Python实现受到很多启发。

自3.0.0版本起,Python实现采用了 Météo France 在 www.data.gouv.fr 上提出的建议

许可协议

本软件采用 MIT 许可证。

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解有关 安装包 的更多信息。

源分布

vigilancemeteo-3.0.1.tar.gz(11.5 KB 查看哈希

上传时间:

构建分布

vigilancemeteo-3.0.1-py3-none-any.whl(10.8 KB 查看哈希

上传时间: Python 3

支持者:

AWS AWS 云计算和安全赞助商 Datadog Datadog 监控 Fastly Fastly CDN Google Google 下载分析 Microsoft Microsoft PSF赞助商 Pingdom Pingdom 监控 Sentry Sentry 错误日志 StatusPage StatusPage 状态页面