ห้องสมุดนี้จะโหลดรายการวันหยุดธนาคารอย่างเป็นทางการในสหราชอาณาจักรซึ่งจัดทำโดย 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 แสดงรายการเหล่านี้สำหรับ 3 "แผนก":
... และหลายวิธีในไลบรารีนี้ใช้พารามิเตอร์ 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
tuple ใน govuk_bank_holidays/__init__.py
python scripts/messages.py compile; python -m build; twine upload dist/*
ในเครื่อง BankHolidays
มีค่าคงที่ ALL_DIVISIONS
ใหม่ลิขสิทธิ์ (C) 2023 HM Government (กระทรวงยุติธรรมดิจิทัลและเทคโนโลยี) ดู LICENSE.txt สำหรับรายละเอียดเพิ่มเติม