london_unified_prayer_times

런던 통합 기도 시간

런던 통합 기도 시간표에서 데이터를 검색하기 위한 라이브러리입니다.

• 무료 소프트웨어: GNU General Public License v3
• 문서: https://london-unified-prayer-times.readthedocs.io.

이게 뭔가요?

주로 https://www.eastlondonmosque.org.uk에 제공되는 형식을 사용하여 런던 지역의 지역 기도 시간표를 검색, 저장 및 업데이트하는 Python 라이브러리입니다.

또한 시간표를 관리하고 쿼리하는 명령줄 유틸리티도 제공됩니다.

특징

도서관은 다음을 수행할 수 있습니다.

• 런던 통합 기도 시간표의 로컬 사본을 검색하고 관리합니다.
• 시간표의 로컬 복사본 쿼리

초기화되면 cli는 다음을 수행할 수 있습니다.

• 하루의 시간 표시
• 한 달의 시간을 달력 형식으로 표시
• 현재 및 다음 기도 시간을 상대 형식으로 표시

설치 중

pip install london-unified-prayer-times

또는 Arch 사용자는 https://aur.archlinux.org/packages/python-london-unified-prayer-times/에서 AUR을 통해 설치할 수 있습니다.

FAQ

이건 작동하지 않습니다! 왜 URL을 요구하나요?

이 라이브러리는 HTML 형식으로 유지되고 URL을 통해 액세스할 수 있는 시간표 데이터를 다운로드하도록 설계되었습니다. 해당 URL을 제공하는 것은 라이브러리 사용자의 몫입니다. 공개 도메인에는 그러한 URL이 하나 이상 있지만 해당 주소는 여기에 제공되지 않습니다.

그리고 그렇습니다. 이것은 기술적으로 누구나 맞춤형 시간의 온라인 데이터 세트를 만들고 이 라이브러리를 통해 액세스할 수 있다는 것을 의미합니다. 만약 그렇다면, 나는 그것에 대해 듣고 싶습니다.

CLI 도구를 어떻게 사용합니까?

이 도구는 클릭 라이브러리를 사용하므로 어디서나 –help를 전달하면 사용법에 대한 지침이 제공됩니다. 힌트: 먼저 초기화해야 합니다.

솔직히 말해서 많은 사람들이 이것을 사용할 것이라고 기대하지 않으므로 문서가 약간… 부족합니다. 모든 훌륭한 프로그래머와 마찬가지로 저는 도구가 기본적으로 이해가 된다고 믿습니다. 막히면 나에게 한 줄을 줄 수 있습니다. 결국 그것은 문서를 형성하게 될 것입니다.

PyPi에서 사용할 수 있는 많은 기도 시간 라이브러리를 사용하면 어떨까요?

간단히 말해서, 런던 통합 기도 시간을 출력하지 않기 때문입니다.

대부분의 기도 시간 라이브러리(Python 또는 기타)는 http://praytimes.org/calculation에 제시된 Hamid Zarrabi-Zadeh의 놀라운 작업을 직접 사용하거나 https://aladhan.com/을 래핑하여 간접적으로 사용합니다. 반면, ELM은 런던 지역 전체에 대해 선별된 시간표를 생성하지만 안타깝게도 계산할 수 없습니다(자세한 내용은 https://www.eastlondonmosque.org.uk/prayer-times-and 참조). -캘린더 설명).

사용자의 정확한 위치를 입력으로 사용하기 때문에 더 정확할 수는 있지만 계산에 의존하는 라이브러리는 ELM 데이터 세트와 일치하지 않습니다. ELM 시간표는 런던 센트럴 모스크(London Central Mosque)와 공유되며 런던 전역의 많은 모스크와도 공유됩니다. 따라서 귀하의 신청서가 귀하의 지역 런던 모스크의 시간표와 일치하기를 원한다면 이 라이브러리가 귀하에게 적합할 수 있습니다.

기존 PyPi 라이브러리의 대부분은 https://aladhan.com/을 래핑하기로 선택합니다. 즉, 작동하려면 온라인 연결이 필요합니다(편리하긴 하지만 로컬에서 쉽게 수행할 수 있는 계산에는 약간 복잡해 보입니다). 이 도서관의 목적은 기도 시간의 로컬 저장소를 유지함으로써 가능한 한 오프라인으로 운영될 수 있도록 하는 것입니다.

https://www.londonprayertimes.com을 사용하면 어떨까요?

몇 가지 이유가 있습니다:

1. LUPT 웹사이트는 이 데이터의 주요 소스가 아닙니다 . 다른 곳(아마도 ELM 웹사이트)에서 변환된 데이터를 수동으로 업로드하는 멋진 자원봉사자들이 운영하고 있습니다. 이 라이브러리는 의도적으로 로컬에서 사용 가능한 복사본을 만들도록 설계되었으므로 해당 데이터 소스로 직접 이동하는 것이 더 나은 아이디어일 것입니다.
2. LUPT 웹사이트의 주요 역할은 모스크 UI 앱에서 시간 문자열을 사용할 수 있도록 만드는 것으로 보입니다. 홈어시스턴트와 같은 기능에는 UTC 또는 에포크 시간과 같이 좀 더 "기계 친화적"인 데이터가 필요합니다. 그리고 다시 말하지만, 어쨌든 LUPT 웹사이트 데이터를 변환하려면 소스로 이동하는 것이 더 합리적입니다.

이게 왜 파이썬으로 쓰여졌나요?

제가 처음 선택한 언어는 아니지만 이 라이브러리는 주로 Python으로 작성된 Home Assistant와 함께 사용하도록 작성되었습니다. 이 라이브러리는 실제로 그렇게 많은 작업을 수행하지 않으므로 가능한 한 기본 라이브러리로 유지하는 것이 합리적입니다.

Python 반대 패턴에 대해 양해해 주시기 바랍니다. PR을 환영합니다. 수업이 부족하다는 의견은 삼가해 주시기 바랍니다. 그 부분은 의도적인 것입니다.

나를 위해 기도해 주시겠어요?

물론! 하지만 당신이 파즈르를 놓친 것에 대해 나는 책임을 지지 않는다는 점을 명심하시기 바랍니다.

크레딧

이 패키지는 Cookiecutter 및 audreyr/cookiecutter-pypackage 프로젝트 템플릿을 사용하여 생성되었습니다.