london_unified_prayer_times

Tiempos de oración del Unificado de Londres

Una biblioteca para recuperar datos del Horario Unificado de Oración de Londres.

• Software libre: Licencia pública general GNU v3
• Documentación: https://london-unified-prayer-times.readthedocs.io.

¿Qué es esto?

Principalmente una biblioteca de Python para recuperar, almacenar y actualizar un horario de oración local para la región de Londres utilizando un formato que alimenta https://www.eastlondonmosque.org.uk.

También se proporciona una utilidad de línea de comando para administrar y consultar el horario.

Características

La biblioteca puede:

• Recupere y administre una copia local del Horario de Oración Unificado de Londres
• Consultar la copia local del horario.

Una vez inicializado, el cli puede:

• Mostrar los tiempos de un día
• Mostrar los tiempos de un mes en formato calendario
• Mostrar el tiempo de oración actual y siguiente en formatos relativos

Instalación

pip install london-unified-prayer-times

Alternativamente, los usuarios de Arch pueden instalar a través de AUR en: https://aur.archlinux.org/packages/python-london-unified-prayer-times/

Preguntas frecuentes

¡Esto no funciona! ¿Por qué pide una URL?

Esta biblioteca está diseñada para descargar datos de horarios en formato HTML y accesibles a través de una URL. Depende del usuario de la biblioteca proporcionar esa URL. Existe al menos una URL de este tipo en el dominio público, pero esa dirección no se proporciona aquí.

Y sí, técnicamente esto significa que cualquiera puede crear un conjunto de datos en línea de tiempos personalizados y tener acceso a él con esta biblioteca. Si lo haces, me encantaría saberlo.

¿Cómo se utiliza la herramienta CLI?

La herramienta utiliza la biblioteca de clics, por lo que pasar –help en todas partes debería brindar alguna orientación sobre su uso. Sugerencia: primero debes iniciar.

Honestamente, no espero que muchos usen esto y por eso falta un poco de documentación. Como ocurre con todos los grandes programadores, creo que la herramienta tiene sentido desde el primer momento. Puedes escribirme si te quedas atascado; eventualmente eso formará la documentación.

¿Por qué no utilizar una de las muchas bibliotecas de Tiempo de oración disponibles en PyPi?

En resumen, porque no publicarán los Horarios de Oración Unificados de Londres.

La mayoría de las bibliotecas de tiempos de oración (Python o de otro tipo), utilizan directamente el increíble trabajo de Hamid Zarrabi-Zadeh presentado en http://praytimes.org/calculation o indirectamente envolviendo https://aladhan.com/. Por otro lado, ELM produce un calendario seleccionado para toda la región de Londres que, lamentablemente, no se puede calcular (para más información, consulte: https://www.eastlondonmosque.org.uk/prayer-times-and -calendario-explicado).

Si bien podría decirse que son más correctas (ya que utilizan su ubicación precisa como entrada), las bibliotecas que dependen del cálculo no coincidirán con el conjunto de datos de ELM. El horario de ELM es compartido por la Mezquita Central de Londres, al igual que muchas mezquitas de todo Londres. Entonces, si desea que su aplicación coincida con el horario de su mezquita local de Londres, esta biblioteca puede ser para usted.

La mayoría de las bibliotecas PyPi existentes también optan por empaquetar https://aladhan.com/, lo que significa que requieren una conexión en línea para funcionar (lo que, aunque conveniente, parece un poco complicado para un cálculo que podría realizarse fácilmente localmente). El objetivo de esta biblioteca es poder funcionar fuera de línea en la medida de lo posible, manteniendo un almacén local de tiempos de oración.

¿Por qué no utilizar https://www.londonprayertimes.com?

Hay algunas razones:

1. El sitio web de LUPT no es la fuente de oro para estos datos. Está dirigido por increíbles voluntarios que parecen cargar manualmente datos transformados desde otro lugar (probablemente el sitio web de ELM). Como esta biblioteca está diseñada intencionalmente para hacer una copia disponible localmente, probablemente sea una mejor idea ir directamente a una fuente de esos datos.
2. La función principal del sitio web LUPT parece ser hacer que las cadenas de tiempo estén disponibles para las aplicaciones de interfaz de usuario de las mezquitas. Algo como Home Assistant requiere datos un poco más "amigables para las máquinas", como horas en UTC o época de época. Y nuevamente, si vamos a transformar los datos del sitio web de LUPT de todos modos, entonces tiene más sentido ir a una fuente.

¿Por qué está esto escrito en Python?

Aunque no es mi primera elección de idioma, esta biblioteca se escribió principalmente para usar con Home Assistant, que a su vez está escrito en Python. Dado que esta biblioteca en realidad no hace mucho, tenía sentido mantenerla lo más nativa posible.

Disculpe los patrones anti-Python: los RP son bienvenidos. Aunque por favor, nada de comentarios sobre la falta de clases, eso es deliberado.

¿Orarás por mí?

¡Por supuesto! Pero tenga en cuenta que no seré responsable de que se haya perdido el Fajr.

Créditos

Este paquete fue creado con Cookiecutter y la plantilla de proyecto audreyr/cookiecutter-pypackage.