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 或其他）要么直接使用 http://praytimes.org/calculation 上介紹的 Hamid Zarrabi-Zadeh 的驚人作品，要么通過包裝 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 專案範本建立的。