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?

Инструмент использует библиотеку кликов, поэтому передача параметра –help везде должна дать некоторые рекомендации по использованию. Подсказка: сначала вам нужно инициализировать.

Честно говоря, я не ожидаю, что многие будут этим пользоваться, поэтому документации немного… не хватает. Как и все великие программисты, я считаю, что этот инструмент имеет смысл сразу после установки. Вы можете написать мне, если что-то застрянет — в конечном итоге это сформирует документацию.

Почему бы просто не использовать одну из множества библиотек Prayer Time, доступных на PyPi?

Короче говоря, потому что они не будут печатать London Unified Prayer Times.

Большинство библиотек времени молитв (Python или другие) либо напрямую используют потрясающую работу Хамида Зарраби-Заде, представленную на 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, по-видимому, заключается в том, чтобы сделать строки времени доступными для приложений пользовательского интерфейса мечети. Что-то вроде Home Assistant требует немного более «машинных» данных, например, время в формате UTC или эпохальное время. И опять же, если мы все равно собираемся преобразовать данные веб-сайта LUPT, тогда имеет смысл обратиться к источнику.

Почему это написано на Python?

Хотя эта библиотека не является моим первым выбором языка, она в первую очередь была написана для использования с Home Assistant, который сам написан на Python. Поскольку эта библиотека на самом деле не так много делает, имело смысл оставить ее как можно более нативной.

Пожалуйста, извините за анти-Python-шаблоны — пиар приветствуется. Хотя, пожалуйста, без комментариев по поводу отсутствия занятий, это нарочно.

Ты помолишься за меня?

Конечно! Но, пожалуйста, имейте в виду, что я не несу ответственности за то, что вы пропустили Фаджр.

Кредиты

Этот пакет был создан с помощью Cookiecutter и шаблона проекта audreyr/cookiecutter-pypackage.