govuk bank holidays

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タプルを更新しています
• 履歴にメモを追加する
• GitHub でリリースを公開し、PyPI へのアップロードをトリガーします。あるいは、 python scripts/messages.py compile; python -m build; twine upload dist/*ローカルにpython scripts/messages.py compile; python -m build; twine upload dist/*

歴史

0.15

GOV.UK が公開した最新の祝日を含めるように、キャッシュされた銀行祝日ファイルを更新しました。

0.14

テスト、ビルド、リリースのプロセスを非推奨の setuptools コマンドから移行しました。翻訳ファイルは、配布物には含まれていないスクリプトを通じて更新およびコンパイルされます。 BankHolidaysクラスには、新しいALL_DIVISIONS定数があります。

0.13

ライブラリは0.12と変わりません。

0.12

3.7 より古い Python バージョンのサポートを削除しました。 GOV.UK が公開した最新の祝日を含めるように、キャッシュされた銀行祝日ファイルを更新しました。コード スタイルの lint を単体テストから github アクションに移動しました。 GOV.UK からキャッシュされた祝日を更新するための setup.py コマンドを追加しました。

0.11

GOV.UK が公開した最新の祝日を含めるように、キャッシュされた銀行祝日ファイルを更新しました。 Python 3.10 をテスト マトリックスに追加しました。

0.10

指定された日付から開始する前後に一連の休日と稼働日を生成するメソッドを追加しました。

0.9

既存のメソッドを反映して、以前の銀行休業日/営業日を検索するメソッドを追加しました。 3.6 より古い Python バージョンのサポートを削除しました。 Python 3.9 をテスト マトリックスに追加しました。

0.8

ライブラリは0.7と変わりません。このリリースは、GitHub Actions を使用して PyPI に自動的に公開する最初のリリースです。

0.7

ドキュメントのマイナーな更新。

0.6

GOV.UK が公開した最新の祝日を含めるように、キャッシュされた銀行祝日ファイルを更新しました。 Python 3.8 をテスト マトリックスに追加しました。ドキュメントのマイナーな更新。

0.5

GOV.UK が公開した最新の祝日を含めるように、キャッシュされた銀行祝日ファイルを更新しました。

0.4

GOV.UK が公開した最新の祝日を含めるように、キャッシュされた銀行祝日ファイルを更新しました。 Python 3.7 をテスト マトリックスに追加しました。ドキュメントが改善されました。

0.3

テストの改善。ライブラリは変更なし。

0.2

GOV.UK が公開した最新の祝日を含めるように、キャッシュされた銀行祝日ファイルを更新しました。キャッシュされたファイルの使用を強制するオプションを追加しました。翌営業日の計算を追加しました。

0.1

初期リリース。

著作権

Copyright (C) 2023 HM Government (法務省デジタル＆テクノロジー)。詳細については、LICENSE.txt を参照してください。