이 라이브러리는 GOV.UK에서 제공하는 영국의 공식 공휴일 목록을 로드합니다. GOV.UK는 향후 1~2년 동안만 이 목록을 제공하는 경향이 있습니다.
자주 업데이트되지는 않지만 알려진 은행 휴일의 캐시된 백업 목록이 이 패키지에 저장됩니다. 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 .
python scripts/update-cache.py
사용하여 GOV.UK에서 캐시된 은행 휴일을 업데이트하세요.
예를 들어 i18n 모듈을 업데이트하거나 새 언어를 추가할 때 python scripts/messages.py update
사용하여 번역 파일을 업데이트하세요. python scripts/messages.py compile
사용하여 컴파일합니다. 이는 테스트 및 배포 전에 필요합니다 . 번역 파일을 업데이트하고 컴파일하려면 gettext 시스템 패키지를 설치해야 합니다.
모든 테스트를 로컬에서 실행하려면 python -m tests
사용하세요. 또는 Python 버전이 여러 개인 경우 tox
사용할 수 있습니다.
[GitHub 팀 구성원에게만 해당] 다음을 통해 PyPI에 새 버전을 배포합니다.
govuk_bank_holidays/__init__.py
에서 VERSION
튜플 업데이트python scripts/messages.py compile; python -m build; twine upload dist/*
로컬로 BankHolidays
클래스에는 새로운 ALL_DIVISIONS
상수가 있습니다.Copyright (C) 2023 HM Government(법무부 디지털 기술부). 자세한 내용은 LICENSE.txt를 참조하세요.