london_unified_prayer_times

伦敦统一祈祷时间

用于从伦敦统一祈祷时间表检索数据的库。

• 自由软件：GNU 通用公共许可证 v3
• 文档：https://london-unified-prayer-times.readthedocs.io。

这是什么？

主要是一个 Python 库，用于检索、存储和更新伦敦地区的本地祈祷时间表，使用的格式正好提供给 https://www.eastlondonmosque.org.uk。

还提供了一个命令行实用程序来管理和查询时间表。

特征

图书馆可以：

• 检索和管理伦敦统一祈祷时间表的本地副本
• 查询本地时刻表副本

初始化后，cli 可以：

• 显示一天的时间
• 以日历格式显示一个月的时间
• 以相对格式显示当前和下一次祈祷时间

安装中

pip install london-unified-prayer-times

或者，Arch 用户可以通过 AUR 安装：https://aur.archlinux.org/packages/python-london-unified-prayer-times/

常问问题

这不行！为什么要求提供 URL？

该库旨在下载以 HTML 格式保存并可通过 URL 访问的时间表数据。由图书馆的用户提供该 URL。公共域中至少有一个这样的 URL，但此处未提供该地址。

是的，这从技术上来说意味着任何人都可以制作自定义时间的在线数据集并可以通过该库访问它。如果你愿意，我很想听听。

如何使用 CLI 工具？

该工具使用 click 库，因此在各处传递 –help 应该会提供一些使用指导。提示：您必须先初始化。

老实说，我不希望很多人使用这个，所以文档有点……缺乏。与所有伟大的程序员一样，我相信这个工具开箱即用。如果你遇到困难，可以给我写信——最终这将形成文档。

为什么不直接使用 PyPi 上提供的众多 Prayer Time 库中的一个呢？

简而言之，因为他们不会输出伦敦统一祈祷时间。

大多数祈祷时间库（Python 或其他）要么直接使用 Hamid Zarrabi-Zadeh 在 http://praytimes.org/calculation 上提出的令人惊叹的作品，要么通过包装 https://aladhan.com/ 间接使用。另一方面，ELM 为整个伦敦地区制定了一个精心策划的时间表，不幸的是，该时间表无法计算（有关更多信息，请参阅：https://www.eastlondonmosque.org.uk/prayer-times-and -日历-解释）。

虽然可以说更正确（因为它们使用您的精确位置作为输入），但依赖计算的库将与 ELM 数据集不匹配。 ELM 时间表与伦敦中央清真寺共享，伦敦各地许多清真寺也都认同。因此，如果您希望您的申请能够与当地伦敦清真寺的时间表相匹配，那么这个图书馆可能适合您。

大多数现有的 PyPi 库也选择包装 https://aladhan.com/，这意味着它们需要在线连接才能操作（虽然方便，但对于可以轻松在本地执行的计算来说似乎有点复杂）。该库的目标是通过维护本地的祈祷时间存储来尽可能地离线运行。

为什么不直接使用 https://www.londonprayertimes.com 呢？

有以下几个原因：

1. LUPT 网站并不是此数据的黄金来源。它由出色的志愿者运行，他们似乎从其他地方（可能是 ELM 的网站）手动上传转换后的数据。由于该库特意设计为制作本地可用的副本，因此直接访问该数据源可能是更好的主意。
2. LUPT 网站的主要作用似乎是为清真寺 UI 应用程序提供时间字符串。像 Home Assistant 这样的东西需要更“机器友好”的数据，比如 UTC 时间或纪元时间。再说一遍，如果我们无论如何都要转换 LUPT 网站数据，那么寻找来源更有意义。

为什么这是用Python写的？

虽然不是我的首选语言，但该库主要是为与 Home Assistant 一起使用而编写的，而 Home Assistant 本身是用 Python 编写的。由于这个库实际上并没有做那么多，所以尽可能保持它的原生是有意义的。

请原谅反 Python 模式 - 欢迎 PR。尽管请不要对缺少课程发表评论，但这是故意的。

你会为我祈祷吗？

当然！但请注意，我不会为您错过晨礼负责。

制作人员

该包是使用 Cookiecutter 和 audreyr/cookiecutter-pypackage 项目模板创建的。