govuk bank holidays

Jours fériés GOV.UK

Cette bibliothèque charge la liste officielle des jours fériés au Royaume-Uni telle que fournie par GOV.UK. GOV.UK a tendance à fournir cette liste seulement un an ou deux dans le futur.

Une liste de sauvegarde en cache des jours fériés connus est stockée dans ce package bien qu'elle ne soit pas souvent mise à jour. GOV.UK ne propose plus de jours fériés pour certaines des années les plus anciennes faisant toujours partie de cette liste de sauvegarde.

Usage

Installez en utilisant pip install govuk-bank-holidays . Exemple d'utilisation :

 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 )

Les jours fériés diffèrent au Royaume-Uni. La source GOV.UK les répertorie actuellement pour 3 « divisions » :

• Angleterre et Pays de Galles
• Écosse
• Irlande du Nord

… et de nombreuses méthodes de cette bibliothèque prennent un paramètre division (voir constantes définies sur la classe BankHolidays ).

NB : Si aucune division n'est précisée, seuls les jours fériés communs à toutes les divisions sont renvoyés donc certains jours fériés locaux peuvent ne pas être répertoriés. Il est donc recommandé de spécifier une division.

Bien que la localisation soit fournie en anglais (par défaut avec le code local « en ») et en gallois (code local « cy »), veuillez noter que la version galloise peut contenir des erreurs.

Développement

Veuillez signaler les bugs et ouvrir les demandes d'extraction sur GitHub.

Pour travailler sur les modifications apportées à cette bibliothèque, il est recommandé de l'installer en mode modifiable dans un environnement virtuel, c'est-à-dire pip install --editable .

Mettez à jour les jours fériés mis en cache depuis GOV.UK à l'aide de python scripts/update-cache.py .

Mettez à jour les fichiers de traduction à l'aide python scripts/messages.py update , par exemple lors de la mise à jour du module i18n ou lors de l'ajout de nouvelles langues. Compilez-les en utilisant python scripts/messages.py compile ; ceci est requis avant les tests et la distribution. La mise à jour et la compilation des fichiers de traduction nécessitent l'installation du package système gettext.

Utilisez python -m tests pour exécuter tous les tests localement. Alternativement, vous pouvez utiliser tox si vous disposez de plusieurs versions de Python.

[Uniquement pour les membres de l'équipe GitHub] Distribuez une nouvelle version sur PyPI en :

• mise à jour du tuple VERSION dans govuk_bank_holidays/__init__.py
• ajouter une note à l'historique
• publier une version sur GitHub qui déclenche un téléchargement vers PyPI ; Vous pouvez également exécuter python scripts/messages.py compile; python -m build; twine upload dist/* localement

Histoire

0,15

Mise à jour du fichier des jours fériés mis en cache pour inclure les derniers jours fériés publiés par GOV.UK.

0,14

Migration des processus de test, de construction et de publication des commandes obsolètes de setuptools. Les fichiers de traduction sont mis à jour et compilés via des scripts qui ne sont pas inclus dans la distribution. La classe BankHolidays a une nouvelle constante ALL_DIVISIONS .

0,13

La bibliothèque ne diffère pas de 0.12.

0,12

Suppression de la prise en charge des versions Python antérieures à 3.7. Mise à jour du fichier des jours fériés mis en cache pour inclure les derniers jours fériés publiés par GOV.UK. Déplacement du style de code du test unitaire vers l'action github. Ajout de la commande setup.py pour mettre à jour les jours fériés mis en cache depuis GOV.UK.

0,11

Mise à jour du fichier des jours fériés mis en cache pour inclure les derniers jours fériés publiés par GOV.UK. Ajout de python 3.10 à la matrice de test.

0,10

Ajout de méthodes pour générer des séries de jours fériés et de jours ouvrables avant/après à partir d'une date donnée.

0,9

Ajout de méthodes pour rechercher les jours fériés/jours ouvrables précédents, reflétant les méthodes existantes. Suppression de la prise en charge des versions de Python antérieures à 3.6. Ajout de Python 3.9 à la matrice de test.

0,8

La bibliothèque ne diffère pas de 0,7. Cette version est la première à utiliser GitHub Actions pour publier automatiquement sur PyPI.

0,7

Mise à jour mineure de la documentation.

0,6

Mise à jour du fichier des jours fériés mis en cache pour inclure les derniers jours fériés publiés par GOV.UK. Ajout de python 3.8 à la matrice de test. Mise à jour mineure de la documentation.

0,5

Mise à jour du fichier des jours fériés mis en cache pour inclure les derniers jours fériés publiés par GOV.UK.

0,4

Mise à jour du fichier des jours fériés mis en cache pour inclure les derniers jours fériés publiés par GOV.UK. Ajout de python 3.7 à la matrice de test. Documentation améliorée.

0,3

Tests améliorés. Bibliothèque inchangée.

0,2

Mise à jour du fichier des jours fériés mis en cache pour inclure les derniers jours fériés publiés par GOV.UK. Ajout d'une option pour forcer l'utilisation du fichier mis en cache. Ajout du calcul du prochain jour ouvrable.

0,1

Version initiale.

Droit d'auteur

Copyright (C) 2023 Gouvernement HM (Ministère de la Justice, Numérique et Technologie). Voir LICENSE.txt pour plus de détails.