تقوم هذه المكتبة بتحميل القائمة الرسمية للعطلات الرسمية في المملكة المتحدة كما تم توفيرها من قبل GOV.UK. تميل GOV.UK إلى تقديم هذه القائمة لمدة عام أو عامين فقط في المستقبل.
يتم تخزين قائمة احتياطية مخبأة للعطلات الرسمية المعروفة في هذه الحزمة على الرغم من عدم تحديثها كثيرًا. لم تعد GOV.UK توفر العطلات الرسمية لبعض السنوات الأقدم والتي لا تزال جزءًا من هذه القائمة الاحتياطية.
التثبيت باستخدام pip install govuk-bank-holidays
. استخدام العينة:
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 )
تختلف العطلات الرسمية في جميع أنحاء المملكة المتحدة. يسرد مصدر GOV.UK حاليًا هذه الأقسام الثلاثة:
... والعديد من الطرق في هذه المكتبة تأخذ معلمة division
(راجع الثوابت المحددة في فئة BankHolidays
).
ملحوظة: إذا لم يتم تحديد أي قسم، فسيتم إرجاع أيام العطل المشتركة لجميع الأقسام فقط، لذلك قد لا يتم إدراج بعض أيام العطل الرسمية للبنوك المحلية. لذلك يوصى بتحديد التقسيم.
على الرغم من أن الترجمة متوفرة باللغة الإنجليزية (اللغة الافتراضية مع رمز اللغة 'en') والويلزية (رمز اللغة 'cy')، يرجى ملاحظة أن الإصدار الويلزي قد يحتوي على أخطاء.
الرجاء الإبلاغ عن الأخطاء وفتح طلبات السحب على GitHub.
للعمل على إجراء تغييرات على هذه المكتبة، يوصى بتثبيتها في الوضع القابل للتحرير في بيئة افتراضية، على سبيل المثال pip install --editable .
قم بتحديث العطلات الرسمية المخزنة مؤقتًا من GOV.UK باستخدام python scripts/update-cache.py
.
قم بتحديث ملفات الترجمة باستخدام python scripts/messages.py update
، على سبيل المثال عند تحديث وحدة i18n أو عند إضافة لغات جديدة. قم بتجميعها باستخدام python scripts/messages.py compile
؛ وهذا مطلوب قبل الاختبار والتوزيع. يتطلب تحديث ملفات الترجمة وتجميعها تثبيت حزمة نظام gettext.
استخدم python -m tests
لتشغيل جميع الاختبارات محليًا. بدلا من ذلك، يمكنك استخدام tox
إذا كان لديك إصدارات متعددة من بايثون.
[فقط لأعضاء فريق GitHub] قم بتوزيع إصدار جديد على PyPI عن طريق:
VERSION
في govuk_bank_holidays/__init__.py
python scripts/messages.py compile; python -m build; twine upload dist/*
محليًا BankHolidays
على ثابت ALL_DIVISIONS
جديد.حقوق الطبع والنشر (C) 2023 محفوظة لحكومة صاحبة الجلالة (وزارة العدل الرقمية والتكنولوجيا). راجع LICENSE.txt لمزيد من التفاصيل.