Diese Bibliothek lädt die offizielle Liste der Feiertage im Vereinigten Königreich, bereitgestellt von GOV.UK. GOV.UK stellt diese Liste in der Regel nur für ein oder zwei Jahre in der Zukunft bereit.
In diesem Paket wird eine zwischengespeicherte Sicherungsliste bekannter Feiertage gespeichert, die jedoch nicht oft aktualisiert wird. GOV.UK bietet für einige der älteren Jahre, die noch auf dieser Ersatzliste stehen, keine Feiertage mehr an.
Installieren Sie mit pip install govuk-bank-holidays
. Beispielverwendung:
from govuk_bank_holidays . bank_holidays import BankHolidays
bank_holidays = BankHolidays ()
for bank_holiday in bank_holidays . get_holidays ():
print ( bank_holiday [ 'title' ], 'is on' , bank_holiday [ 'date' ])
print ( bank_holidays . get_next_holiday ())
# see govuk_bank_holidays/bank_holidays.py source file for more methods and argument details…
# choose a different locale for holiday titles and notes
bank_holidays = BankHolidays ( locale = 'cy' )
# use cached holidays if internet connection is not desired
bank_holidays = BankHolidays ( use_cached_holidays = True )
In ganz Großbritannien gibt es unterschiedliche Feiertage. Die GOV.UK-Quelle listet diese derzeit für drei „Abteilungen“ auf:
… und viele Methoden in dieser Bibliothek akzeptieren einen division
(siehe in der BankHolidays
Klasse definierte Konstanten).
Hinweis: Wenn keine Abteilung angegeben ist, werden nur Feiertage zurückgegeben, die allen Abteilungen gemeinsam sind, sodass einige lokale Feiertage möglicherweise nicht aufgeführt werden. Daher empfiehlt sich die Angabe einer Sparte.
Während die Lokalisierung auf Englisch (Standardeinstellung mit Gebietsschemacode „en“) und Walisisch (Gebietsschemacode „cy“) bereitgestellt wird, beachten Sie bitte, dass die walisische Version Fehler enthalten kann.
Bitte melden Sie Fehler und öffnen Sie Pull-Anfragen auf GitHub.
Um Änderungen an dieser Bibliothek zu bearbeiten, wird empfohlen, sie im bearbeitbaren Modus in einer virtuellen Umgebung zu installieren, z. B. pip install --editable .
Aktualisieren Sie zwischengespeicherte Feiertage von GOV.UK mithilfe von python scripts/update-cache.py
.
Aktualisieren Sie Übersetzungsdateien mit python scripts/messages.py update
, z. B. beim Aktualisieren des i18n-Moduls oder beim Hinzufügen neuer Sprachen. Kompilieren Sie sie mit python scripts/messages.py compile
; Dies ist vor dem Testen und Verteilen erforderlich . Zum Aktualisieren und Kompilieren von Übersetzungsdateien muss das gettext-Systempaket installiert sein.
Verwenden Sie python -m tests
um alle Tests lokal auszuführen. Alternativ können Sie tox
verwenden, wenn Sie mehrere Python-Versionen haben.
[Nur für GitHub-Teammitglieder] Verteilen Sie eine neue Version an PyPI durch:
VERSION
Tupels in govuk_bank_holidays/__init__.py
python scripts/messages.py compile; python -m build; twine upload dist/*
lokal BankHolidays
-Klasse verfügt über eine neue ALL_DIVISIONS
Konstante.Copyright (C) 2023 HM Government (Ministerium für Justiz, Digital und Technologie). Weitere Einzelheiten finden Sie in LICENSE.txt.