Perpustakaan ini memuat daftar resmi hari libur bank di Inggris yang disediakan oleh GOV.UK. GOV.UK cenderung menyediakan daftar ini hanya untuk satu atau dua tahun ke depan.
Daftar cadangan hari libur bank yang diketahui dalam cache disimpan dalam paket ini meskipun tidak sering diperbarui. GOV.UK tidak lagi menyediakan hari libur bank untuk beberapa tahun yang lebih tua yang masih menjadi bagian dari daftar cadangan ini.
Instal menggunakan pip install govuk-bank-holidays
. Contoh penggunaan:
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 )
Hari libur bank berbeda-beda di seluruh Inggris. Sumber GOV.UK saat ini mencantumkan ini untuk 3 "divisi":
… dan banyak metode di perpustakaan ini menggunakan parameter division
(lihat konstanta yang ditentukan di kelas BankHolidays
).
Catatan: Jika tidak ada divisi yang ditentukan, hanya hari libur umum untuk semua divisi yang dikembalikan sehingga beberapa hari libur bank lokal mungkin tidak dicantumkan. Oleh karena itu disarankan untuk menentukan divisi.
Meskipun pelokalan disediakan dalam bahasa Inggris (default dengan kode lokal 'en') dan Welsh (kode lokal 'cy'), harap dicatat bahwa versi Welsh mungkin mengandung kesalahan.
Silakan laporkan bug dan buka permintaan penarikan di GitHub.
Untuk mengerjakan perubahan pada perpustakaan ini, disarankan untuk menginstalnya dalam mode yang dapat diedit ke dalam lingkungan virtual, yaitu pip install --editable .
Perbarui hari libur bank yang di-cache dari GOV.UK menggunakan python scripts/update-cache.py
.
Perbarui file terjemahan menggunakan python scripts/messages.py update
, misalnya saat memperbarui modul i18n atau saat menambahkan bahasa baru. Kompilasi menggunakan python scripts/messages.py compile
; ini diperlukan sebelum pengujian dan distribusi. Memperbarui dan mengkompilasi file terjemahan memerlukan instalasi paket sistem gettext.
Gunakan python -m tests
untuk menjalankan semua tes secara lokal. Alternatifnya, Anda dapat menggunakan tox
jika Anda memiliki beberapa versi python.
[Hanya untuk anggota tim GitHub] Distribusikan versi baru ke PyPI dengan:
VERSION
di govuk_bank_holidays/__init__.py
python scripts/messages.py compile; python -m build; twine upload dist/*
secara lokal BankHolidays
memiliki konstanta ALL_DIVISIONS
baru.Hak Cipta (C) 2023 HM Government (Kementerian Kehakiman Digital & Teknologi). Lihat LICENSE.txt untuk rincian lebih lanjut.