Merge branch 'dev' into dev

Signed-off-by: Harshil Gupta <[email protected]>

Author: Harshil-Gupta

CHANGES.md

@@ -1,3 +1,31 @@
+# Version 0.76
+
+Released July 7, 2025
+
+- Add Bonaire, Sint Eustatius and Saba holidays (#2651 by @Prateekshit73, @arkid15r)
+- Add Falkland Islands holidays (#2697 by @Abheelash-Mishra)
+- Add Libya holidays (#2671 by @kritibirda26)
+- Add Mauritius holidays (#2643 by @kritibirda26)
+- Add Mongolia holidays (#2601 by @ankushhKapoor, @arkid15r)
+- Add Sint Maarten holidays (#2631 by @psupra22, @arkid15r)
+- Add working day tests for countries with substituted holidays (#2695 by @KJhellico)
+- Fix iCal exporter tests (#2689 by @KJhellico)
+- Update Aruba, Curaçao, Netherlands holidays: general code refactor (#2677 by @PPsyrius)
+- Update Cocos Islands holidays: fix 2023 Eid al-Fitr date (#2683 by @KJhellico)
+- Update France holidays: refactors, add `th` l10n (#2642 by @PPsyrius)
+- Update San Marino holidays, add l10n support (#2684 by @KJhellico)
+- Update Svalbard and Jan Mayen holidays: remove l10n overrides (#2649 by @PPsyrius)
+- Update Taiwan holidays (#2653 by @KJhellico)
+- Update United States holidays: add `th` l10n (#2678 by @PPsyrius)
+- Update Uzbekistan holidays: add 2024-2025 exact dates (#2679 by @KJhellico)
+- Update l10n for RTL languages (#2676 by @KJhellico)
+- Update l10n helper script (#2699 by @KJhellico)
+- Update pytest configuration (#2640 by @KJhellico)
+- Archive a link for Turks and Caicos holidays (#2688 by @kritibirda26)
+- Reformat .po files (#2673 by @KJhellico)
+- Show test coverage details by default (#2686 by @arkid15r)
+- Simplify parent-based entity handling (#2685 by @arkid15r)
+
 # Version 0.75
 
 Released June 16, 2025

README.md

@@ -427,6 +427,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HALF_DAY</td>
 </tr>
 <tr>
+<td>Christmas Island</td>
+<td>CX</td>
+<td></td>
+<td><strong>en_CX</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Cocos Islands</td>
 <td>CC</td>
 <td></td>
@@ -1148,6 +1155,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>ARMED_FORCES, HALF_DAY</td>
 </tr>
 <tr>
+<td>Palestine</td>
+<td>PS</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td>CATHOLIC, ORTHODOX</td>
+</tr>
+<tr>
 <td>Panama</td>
 <td>PA</td>
 <td></td>
@@ -1273,6 +1287,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Saint Vincent and the Grenadines</td>
+<td>VC</td>
+<td></td>
+<td>en_US, <strong>en_VC</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Samoa</td>
 <td>WS</td>
 <td></td>

SECURITY.md

@@ -4,8 +4,8 @@
 
 | Version | Supported          |
 |---------| ------------------ |
-| 0.75    | :white_check_mark: |
-| < 0.75  | :x:                |
+| 0.76    | :white_check_mark: |
+| < 0.76  | :x:                |
 
 ## Reporting a Vulnerability
 

holidays/countries/__init__.py

@@ -52,6 +52,7 @@
 from holidays.countries.chad import Chad, TD, TCD
 from holidays.countries.chile import Chile, CL, CHL
 from holidays.countries.china import China, CN, CHN
+from holidays.countries.christmas_island import ChristmasIsland, CX, CXR
 from holidays.countries.cocos_islands import CocosIslands, CC, CCK
 from holidays.countries.colombia import Colombia, CO, COL
 from holidays.countries.congo import Congo, CG, COG
@@ -160,6 +161,7 @@
 from holidays.countries.oman import Oman, OM, OMN
 from holidays.countries.pakistan import Pakistan, PK, PAK
 from holidays.countries.palau import Palau, PW, PLW
+from holidays.countries.palestine import Palestine, PS, PSE
 from holidays.countries.panama import Panama, PA, PAN
 from holidays.countries.papua_new_guinea import PapuaNewGuinea, PG, PNG
 from holidays.countries.paraguay import Paraguay, PY, PRY
@@ -183,6 +185,11 @@
     SPM,
     HolidaysPM,
 )
+from holidays.countries.saint_vincent_and_the_grenadines import (
+    SaintVincentAndTheGrenadines,
+    VC,
+    VCT,
+)
 from holidays.countries.samoa import Samoa, WS, WSM
 from holidays.countries.san_marino import SanMarino, SM, SMR
 from holidays.countries.sao_tome_and_principe import SaoTomeAndPrincipe, ST, STP

holidays/countries/australia.py

@@ -529,8 +529,8 @@ def _populate_subdiv_qld_public_holidays(self):
         }
         # The Royal Queensland Show.
         name = tr("The Royal Queensland Show")
-        if self._year in ekka_dates:
-            self._add_holiday(name, ekka_dates[self._year])
+        if dt := ekka_dates.get(self._year):
+            self._add_holiday(name, dt)
         else:
             # [1st FRI after Aug 5] + 5 days = [1st WED after Aug 10]
             self._add_holiday_1st_wed_from_aug_10(name)
@@ -839,8 +839,8 @@ def _populate_subdiv_vic_public_holidays(self):
             }
             # Grand Final Day.
             name = tr("Grand Final Day")
-            if self._year in grand_final_dates:
-                self._add_holiday(name, grand_final_dates[self._year])
+            if dt := grand_final_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_holiday_1_day_prior_last_sat_of_sep(name)
 
@@ -937,10 +937,8 @@ def _populate_subdiv_wa_public_holidays(self):
                     2012: (OCT, 1),
                     2024: (SEP, 23),
                 }
-                if self._year in sovereign_birthday_dates:
-                    self._add_holiday(
-                        self.sovereign_birthday, sovereign_birthday_dates[self._year]
-                    )
+                if dt := sovereign_birthday_dates.get(self._year):
+                    self._add_holiday(self.sovereign_birthday, dt)
                 else:
                     self._add_holiday_last_mon_of_sep(self.sovereign_birthday)
             else:

holidays/countries/british_virgin_islands.py

@@ -89,8 +89,8 @@ def _populate_public_holidays(self):
                 2019: (JUN, 7),
                 2023: (JUN, 16),
             }
-            if self._year in sovereign_birthday_dates:
-                self._add_holiday(name, sovereign_birthday_dates[self._year])
+            if dt := sovereign_birthday_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_holiday_2nd_fri_of_jun(name)
         else:
@@ -110,8 +110,8 @@ def _populate_public_holidays(self):
             2015: (JUN, 29),
             2020: (JUN, 29),
         }
-        if self._year in territory_day_dates:
-            self._add_holiday(name, territory_day_dates[self._year])
+        if dt := territory_day_dates.get(self._year):
+            self._add_holiday(name, dt)
         else:
             if self._year >= 2021:
                 self._add_holiday_1st_mon_of_jul(name)
@@ -151,8 +151,8 @@ def _populate_public_holidays(self):
                 2015: (OCT, 19),
                 2020: (OCT, 23),
             }
-            if self._year in saint_ursula_dates:
-                self._add_holiday(name, saint_ursula_dates[self._year])
+            if dt := saint_ursula_dates.get(self._year):
+                self._add_holiday(name, dt)
             else:
                 self._add_observed(
                     self._add_holiday_oct_21(name), rule=SAT_TO_PREV_FRI + SUN_TO_NEXT_MON

holidays/countries/christmas_island.py

@@ -0,0 +1,215 @@
+#  holidays
+#  --------
+#  A fast, efficient Python library for generating country, province and state
+#  specific sets of holidays on the fly. It aims to make determining whether a
+#  specific date is a holiday as fast and flexible as possible.
+#
+#  Authors: Vacanza Team and individual contributors (see CONTRIBUTORS file)
+#           dr-prodigy <[email protected]> (c) 2017-2023
+#           ryanss <[email protected]> (c) 2014-2017
+#  Website: https://github.com/vacanza/holidays
+#  License: MIT (see LICENSE file)
+
+from gettext import gettext as tr
+
+from holidays.calendars import _CustomChineseHolidays, _CustomIslamicHolidays
+from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
+from holidays.groups import (
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+    StaticHolidays,
+)
+from holidays.observed_holiday_base import (
+    ObservedHolidayBase,
+    MON_TO_NEXT_TUE,
+    SAT_SUN_TO_NEXT_MON,
+    SAT_SUN_TO_NEXT_MON_TUE,
+)
+
+
+class ChristmasIsland(
+    ObservedHolidayBase,
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+    StaticHolidays,
+):
+    """Christmas Island holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Christmas_Island>
+        * [2007](https://web.archive.org/web/20250612072036/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2006/01-2006_Public_Holidays_2007_CI.doc)
+        * [2008](https://web.archive.org/web/20240224131231/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2007/05-2007_Public_Holidays_CI.pdf)
+        * [2008 Hari Raya Puasa](https://web.archive.org/web/20240331104649/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2008/03_2008_Observance_of_Hari_Raya_Puasa_2008.pdf)
+        * [2009](https://web.archive.org/web/20231211180406/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2008/02-2008_2009_public_holiday_CI_gazette.pdf)
+        * [2010](https://web.archive.org/web/20250612051603/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2009/2009-Gazette_5-2009-CI-Proclamation_of_2010_Special_Public_and_Bank_Holidays.pdf)
+        * [2013](https://web.archive.org/web/20240805060802/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2012/2012-Gazette_7-2012-CI-Proclamation_of_2013_Public_Holidays_for_Christmas_Island.pdf)
+        * [2014](https://web.archive.org/web/20240718175750/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2013/2013-Gazette_2-2013-Christmas_Island_2014_Public_Holidays.pdf)
+        * [2016 Hari Raya Puasa](https://web.archive.org/web/20240222235345/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2016/2016-Gazette_4-2016-CI-Proclamation_Special_Public_and_Bank_Holidays_2016.pdf)
+        * [2017](https://web.archive.org/web/20240226014639/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_gazette/files/2016/2016-Gazette_1-2016-CI-Proclamation_Special_Public_and_Bank_Holidays_2017.pdf)
+        * [2019](https://web.archive.org/web/20250517064053/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_bulletins/2018/files/A37-2018.pdf)
+        * [2020](https://web.archive.org/web/20240830230128/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_bulletins/2019/files/A52-2019.pdf)
+        * [2021](https://web.archive.org/web/20240713155232/https://www.infrastructure.gov.au/sites/default/files/migrated/territories/indian_ocean/iot_bulletins/2020/files/a40-ci-public-holidays-2021-proclamation.pdf)
+        * [2022](https://web.archive.org/web/20240626092850/https://www.infrastructure.gov.au/sites/default/files/documents/a32-2021-2022-public-holidays-christmas-island.pdf)
+        * [2023](https://web.archive.org/web/20250612044842/https://www.infrastructure.gov.au/sites/default/files/documents/A06-2022-notice-proclamation-special-public-bank-holidays-2023-ci.pdf)
+        * [2023 Hari Raya Haji](https://web.archive.org/web/20240804112114/https://www.infrastructure.gov.au/sites/default/files/documents/a06-2023_community_bulletin_-_change_of_public_holiday_date_for_hari_raya_haji_2023.pdf)
+        * [2024](https://web.archive.org/web/20240519034837/https://www.infrastructure.gov.au/sites/default/files/documents/a11-2023-2024-public-holidays-christmas-island.pdf)
+        * [2025](https://web.archive.org/web/20250610185153/https://www.infrastructure.gov.au/sites/default/files/documents/a20-2024-administrator-community-bulletin-ci-public-holidays-2025.pdf)
+    """
+
+    country = "CX"
+    default_language = "en_CX"
+    # %s (observed).
+    observed_label = tr("%s (observed)")
+    # %s (estimated).
+    estimated_label = tr("%s (estimated)")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s (observed, estimated)")
+    supported_languages = ("en_CX", "en_US")
+    start_year = 2007
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        ChineseCalendarHolidays.__init__(self, cls=ChristmasIslandChineseHolidays)
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=ChristmasIslandIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        StaticHolidays.__init__(self, ChristmasIslandStaticHolidays)
+        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_observed(self._add_new_years_day(tr("New Year's Day")))
+
+        # Australia Day.
+        self._add_observed(self._add_holiday_jan_26(tr("Australia Day")))
+
+        # Chinese New Year.
+        name = tr("Chinese New Year")
+        if self._year != 2020:
+            self._add_observed(self._add_chinese_new_years_day(name), rule=SAT_SUN_TO_NEXT_MON_TUE)
+            self._add_observed(
+                self._add_chinese_new_years_day_two(name), rule=SAT_SUN_TO_NEXT_MON_TUE
+            )
+
+        # Labor Day.
+        name = tr("Labour Day")
+        if self._year in {2009, 2010, 2014, 2021, 2025}:
+            self._add_holiday_4th_mon_of_mar(name)
+        else:
+            self._add_holiday_3rd_mon_of_mar(name)
+
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # ANZAC Day.
+        self._add_observed(self._add_anzac_day(tr("ANZAC Day")))
+
+        # Territory Day.
+        self._add_holiday_1st_mon_of_oct(tr("Territory Day"))
+
+        self._add_observed(
+            # Boxing Day.
+            self._add_christmas_day_two(tr("Boxing Day")),
+            rule=SAT_SUN_TO_NEXT_MON_TUE + MON_TO_NEXT_TUE,
+        )
+
+        # Christmas Day.
+        self._add_observed(self._add_christmas_day(tr("Christmas Day")))
+
+        # Eid al-Fitr.
+        for dt in self._add_eid_al_fitr_day(tr("Hari Raya Puasa")):
+            self._add_observed(dt)
+
+        # Eid al-Adha.
+        for dt in self._add_eid_al_adha_day(tr("Hari Raya Haji")):
+            if self._year not in {2014, 2025}:
+                self._add_observed(dt)
+
+
+class ChristmasIslandChineseHolidays(_CustomChineseHolidays):
+    LUNAR_NEW_YEAR_DATES = {
+        2007: (FEB, 19),
+        2009: (JAN, 27),
+        2010: (FEB, 15),
+        2023: (JAN, 23),
+    }
+
+
+class ChristmasIslandIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES = {
+        2007: (DEC, 20),
+        2008: (DEC, 8),
+        2009: (NOV, 30),
+        2010: (NOV, 16),
+        2013: (OCT, 15),
+        2014: (OCT, 5),
+        2016: (SEP, 13),
+        2017: (SEP, 1),
+        2019: (AUG, 11),
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 28),
+        2024: (JUN, 17),
+        2025: (JUN, 7),
+    }
+
+    EID_AL_FITR_DATES = {
+        2007: (OCT, 15),
+        2008: (OCT, 1),
+        2009: (SEP, 21),
+        2010: (SEP, 10),
+        2013: (AUG, 8),
+        2014: (JUL, 28),
+        2016: (JUL, 6),
+        2017: (JUN, 24),
+        2019: (JUN, 5),
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 2),
+        2023: (APR, 22),
+        2024: (APR, 10),
+        2025: (MAR, 31),
+    }
+
+
+class CX(ChristmasIsland):
+    pass
+
+
+class CXR(ChristmasIsland):
+    pass
+
+
+class ChristmasIslandStaticHolidays:
+    """Christmas Island special holidays.
+
+    References:
+        * [National Day of Mourning 2022](https://web.archive.org/web/20240712013008/https://www.infrastructure.gov.au/sites/default/files/documents/03-2022-proclamation-ci-day-of-mourning.pdf)
+    """
+
+    # Chinese New Year.
+    chinese_new_year = tr("Chinese New Year")
+
+    # Eid al-Adha.
+    eid_al_adha = tr("Hari Raya Haji")
+
+    special_public_holidays = {
+        # National Day of Mourning for Queen Elizabeth II.
+        2022: (SEP, 22, tr("National Day of Mourning for Queen Elizabeth II")),
+    }
+
+    special_public_holidays_observed = {
+        2014: (OCT, 7, eid_al_adha),
+        2020: (
+            (JAN, 28, chinese_new_year),
+            (JAN, 29, chinese_new_year),
+        ),
+        2025: (JUN, 6, eid_al_adha),
+    }