holidays 0.80__py3-none-any.whl → 0.82__py3-none-any.whl

holidays/countries/south_africa.py

@@ -20,15 +20,18 @@ class SouthAfrica(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
 
     References:
         * <https://web.archive.org/web/20250424073852/https://www.gov.za/about-sa/public-holidays>
+        * [Act No. 36, 1994](https://web.archive.org/web/20250914045710/https://www.gov.za/sites/default/files/gcis_document/201409/act36of1994.pdf)
+        * <https://web.archive.org/web/20250914050022/https://www.ancestors.co.za/origins-of-public-holidays-in-south-africa/>
         * <https://en.wikipedia.org/wiki/Public_holidays_in_South_Africa>
         * <https://web.archive.org/web/20240715110800/https://www.gov.za/speeches/president-cyril-ramaphosa-progress-economic-recovery-30-oct-2023-0000>
         * <https://web.archive.org/web/20250427184315/https://www.gov.za/documents/notices/public-holidays-act-declaration-29-may-2024-public-holiday-23-feb-2024>
     """
 
     country = "ZA"
+    # %s (observed).
     observed_label = "%s (observed)"
-    # Observed since 1910, with a few name changes
-    start_year = 1910
+    # Public Holidays Act (No. 3 of 1910) came in effect on January 1st, 1911.
+    start_year = 1911
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -39,75 +42,113 @@ class SouthAfrica(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        # New Year's Day.
         self._add_observed(self._add_new_years_day("New Year's Day"))
 
+        if 1980 <= self._year <= 1994:
+            # Founder's Day.
+            self._add_holiday_apr_6("Founder's Day")
+        elif 1952 <= self._year <= 1973:
+            # Van Riebeeck's Day.
+            self._add_holiday_apr_6("Van Riebeeck's Day")
+
+        # Good Friday.
         self._add_good_friday("Good Friday")
 
-        self._add_easter_monday("Family Day" if self._year >= 1980 else "Easter Monday")
+        if self._year <= 1979:
+            # Easter Monday.
+            self._add_easter_monday("Easter Monday")
 
-        if self._year <= 1951:
-            name = "Dingaan's Day"
-        elif self._year <= 1979:
-            name = "Day of the Covenant"
-        elif self._year <= 1994:
-            name = "Day of the Vow"
-        else:
-            name = "Day of Reconciliation"
-        self._add_observed(self._add_holiday_dec_16(name))
+        # Family Day.
+        name = "Family Day"
+        if self._year >= 1980:
+            self._add_easter_monday(name)
+        elif 1961 <= self._year <= 1973:
+            self._add_holiday_jul_10(name)
 
-        self._add_christmas_day("Christmas Day")
-
-        self._add_observed(
-            self._add_christmas_day_two("Day of Goodwill" if self._year >= 1980 else "Boxing Day")
-        )
+        # Workers' Day.
+        name = "Workers' Day"
+        if self._year >= 1995:
+            self._add_observed(self._add_labor_day(name))
+        elif 1987 <= self._year <= 1989:
+            self._add_holiday_1st_fri_of_may(name)
 
         if self._year >= 1995:
+            # Human Rights Day.
             self._add_observed(self._add_holiday_mar_21("Human Rights Day"))
 
+            # Freedom Day.
             self._add_observed(self._add_holiday_apr_27("Freedom Day"))
 
-            self._add_observed(self._add_labor_day("Workers' Day"))
-
+            # Youth Day.
             self._add_observed(self._add_holiday_jun_16("Youth Day"))
 
+            # National Women's Day.
             self._add_observed(self._add_holiday_aug_9("National Women's Day"))
 
+            # Heritage Day.
             self._add_observed(self._add_holiday_sep_24("Heritage Day"))
-
-        # Historic public holidays no longer observed
-        if 1952 <= self._year <= 1973:
-            self._add_holiday_apr_6("Van Riebeeck's Day")
-        elif 1980 <= self._year <= 1994:
-            self._add_holiday_apr_6("Founder's Day")
-
-        if 1987 <= self._year <= 1989:
-            self._add_holiday_1st_fri_of_may("Workers' Day")
-
-        if self._year <= 1993:
+        elif self._year <= 1993:
+            self._add_holiday_may_31(
+                # Republic Day.
+                "Republic Day"
+                if self._year >= 1961
+                # Union Day.
+                else "Union Day"
+            )
+
+            # Ascension Day.
             self._add_ascension_thursday("Ascension Day")
 
-        if self._year <= 1951:
-            self._add_holiday_may_24("Empire Day")
+            if self._year >= 1952:
+                # Kruger Day.
+                self._add_holiday_oct_10("Kruger Day")
 
-        if self._year <= 1960:
-            self._add_holiday_may_31("Union Day")
-        elif self._year <= 1993:
-            self._add_holiday_may_31("Republic Day")
+        if self._year >= 1952:
+            if self._year <= 1960:
+                # Queen's Birthday.
+                self._add_holiday_2nd_mon_of_jul("Queen's Birthday")
 
-        if 1952 <= self._year <= 1960:
-            self._add_holiday_2nd_mon_of_jul("Queen's Birthday")
+            if self._year <= 1979:
+                # Settlers' Day.
+                self._add_holiday_1st_mon_of_sep("Settlers' Day")
+        else:
+            # According to our sources, Act No. 3 of 1910 supposedly uses the term "Victoria Day"
+            # but as we can't find the original document and that Empire Day was supposed
+            # instituted empire-wide circa 1904 - we'll stick with its latter name for now.
 
-        if 1961 <= self._year <= 1973:
-            self._add_holiday_jul_10("Family Day")
+            # Empire Day.
+            self._add_holiday_may_24("Empire Day")
 
-        if self._year <= 1951:
+            # King's Birthday.
             self._add_holiday_1st_mon_of_aug("King's Birthday")
 
-        if 1952 <= self._year <= 1979:
-            self._add_holiday_1st_mon_of_sep("Settlers' Day")
+        if self._year >= 1995:
+            # Day of Reconciliation.
+            name = "Day of Reconciliation"
+        elif self._year >= 1980:
+            # Day of the Vow.
+            name = "Day of the Vow"
+        elif self._year >= 1952:
+            # Day of the Covenant.
+            name = "Day of the Covenant"
+        else:
+            # Dingaan's Day.
+            name = "Dingaan's Day"
+        self._add_observed(self._add_holiday_dec_16(name))
+
+        # Christmas Day.
+        self._add_christmas_day("Christmas Day")
 
-        if 1952 <= self._year <= 1993:
-            self._add_holiday_oct_10("Kruger Day")
+        self._add_observed(
+            self._add_christmas_day_two(
+                # Day of Goodwill.
+                "Day of Goodwill"
+                if self._year >= 1980
+                # Boxing Day.
+                else "Boxing Day"
+            )
+        )
 
 
 class ZA(SouthAfrica):
@@ -119,11 +160,14 @@ class ZAF(SouthAfrica):
 
 
 class SouthAfricaStaticHolidays:
-    local_elections = "Local government elections"
-    municipal_elections = "Municipal elections"
-    national_and_provincial_elections = "National and provincial government elections"
-    presidential_decree_holiday = "Public holiday by presidential decree"
-    y2k_changeover = "Y2K changeover"
+    # Local Government Elections.
+    local_elections = "Local Government Elections"
+    # National and Provincial Government Elections.
+    national_and_provincial_elections = "National and Provincial Government Elections"
+    # Public Holiday by Presidential Decree.
+    presidential_decree_holiday = "Public Holiday by Presidential Decree"
+    # Y2K Changeover.
+    y2k_changeover = "Y2K Changeover"
     special_public_holidays = {
         1999: (
             (JUN, 2, national_and_provincial_elections),
@@ -144,13 +188,12 @@ class SouthAfricaStaticHolidays:
             (DEC, 27, presidential_decree_holiday),
         ),
         2019: (MAY, 8, national_and_provincial_elections),
-        2021: (NOV, 1, municipal_elections),
+        # Municipal elections.
+        2021: (NOV, 1, "Municipal elections"),
         2022: (DEC, 27, presidential_decree_holiday),
-        # Winning the 2023 Rugby World Cup
         2023: (DEC, 15, presidential_decree_holiday),
         2024: (MAY, 29, national_and_provincial_elections),
     }
-
     special_public_holidays_observed = {
         # https://web.archive.org/web/20120328122217/http://www.info.gov.za/speeches/1999/991028409p1002.htm
         2000: (JAN, 3, y2k_changeover),

holidays/countries/south_korea.py

@@ -10,9 +10,11 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from __future__ import annotations
+
 import warnings
-from datetime import date
 from gettext import gettext as tr
+from typing import TYPE_CHECKING
 
 from holidays.calendars.chinese import KOREAN_CALENDAR
 from holidays.calendars.gregorian import (
@@ -43,6 +45,9 @@ from holidays.observed_holiday_base import (
     SUN_TO_NEXT_WORKDAY,
 )
 
+if TYPE_CHECKING:
+    from datetime import date
+
 
 class SouthKorea(
     ObservedHolidayBase,
@@ -81,6 +86,10 @@ class SouthKorea(
     country = "KR"
     supported_categories = (BANK, PUBLIC)
     default_language = "ko"
+    # %s (estimated).
+    estimated_label = tr("%s (추정)")
+    # Alternative holiday for %s (estimated).
+    observed_estimated_label = tr("%s 대체 휴일 (추정)")
     # Alternative holiday for %s.
     observed_label = tr("%s 대체 휴일")
     supported_languages = ("en_US", "ko", "th")

holidays/countries/spain.py

@@ -47,6 +47,25 @@ class Spain(
         * [2024](https://web.archive.org/web/20240401192304/https://www.boe.es/buscar/doc.php?id=BOE-A-2023-22014)
         * [2025](https://web.archive.org/web/20241226214918/https://www.boe.es/buscar/doc.php?id=BOE-A-2024-21316)
 
+    Subdivisions Holidays References:
+        * Navarra:
+            * [2010](https://web.archive.org/web/20250903095706/https://www.lexnavarra.navarra.es/detalle.asp?r=8402)
+            * [2011](https://web.archive.org/web/20250903095217/https://www.lexnavarra.navarra.es/detalle.asp?r=8403)
+            * [2012](https://web.archive.org/web/20250903095133/https://www.lexnavarra.navarra.es/detalle.asp?r=12993)
+            * [2013](https://web.archive.org/web/20250903095136/https://www.lexnavarra.navarra.es/detalle.asp?r=26226)
+            * [2014](https://web.archive.org/web/20250903095123/https://www.lexnavarra.navarra.es/detalle.asp?r=32382)
+            * [2015](https://web.archive.org/web/20250903095257/https://www.lexnavarra.navarra.es/detalle.asp?r=34276)
+            * [2016](https://web.archive.org/web/20250903095302/https://www.lexnavarra.navarra.es/detalle.asp?r=36141)
+            * [2017](https://web.archive.org/web/20250903095306/https://www.lexnavarra.navarra.es/detalle.asp?r=37665)
+            * [2018](https://web.archive.org/web/20170728130845/https://www.lexnavarra.navarra.es/detalle.asp?r=38904)
+            * [2019](https://web.archive.org/web/20250903095819/https://www.lexnavarra.navarra.es/detalle.asp?r=50305)
+            * [2020](https://web.archive.org/web/20250623005808/https://www.lexnavarra.navarra.es/detalle.asp?r=52229)
+            * [2021](https://web.archive.org/web/20250623010750/https://www.lexnavarra.navarra.es/detalle.asp?r=52748)
+            * [2022](https://web.archive.org/web/20250623000851/https://www.lexnavarra.navarra.es/detalle.asp?r=53763)
+            * [2023](https://web.archive.org/web/20250623010106/https://www.lexnavarra.navarra.es/detalle.asp?r=55481)
+            * [2024](https://web.archive.org/web/20250623001355/https://www.lexnavarra.navarra.es/detalle.asp?r=56116)
+            * [2025](https://web.archive.org/web/20250622235218/https://www.lexnavarra.navarra.es/detalle.asp?r=57122)
+
     Holidays checked with official sources for 2010-2025 only.
     """
 
@@ -102,7 +121,7 @@ class Spain(
         "La Rioja": "RI",
         "Valenciana": "VC",
     }
-    supported_languages = ("en_US", "es", "uk")
+    supported_languages = ("ca", "en_US", "es", "uk")
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
         """
@@ -167,7 +186,7 @@ class Spain(
             self._move_holiday(self._add_epiphany_day(tr("Epifanía del Señor")))
 
         # Andalusia Day.
-        self._move_holiday(self._add_holiday_feb_28(tr("Día de Andalucia")))
+        self._move_holiday(self._add_holiday_feb_28(tr("Día de Andalucía")))
 
         # Maundy Thursday.
         self._add_holy_thursday(tr("Jueves Santo"))
@@ -241,7 +260,7 @@ class Spain(
         if self._year in {2010, 2021}:
             self._move_holiday(self._add_assumption_of_mary_day(tr("Asunción de la Virgen")))
 
-        # Asturia Day.
+        # Asturias Day.
         self._move_holiday(self._add_holiday_sep_8(tr("Día de Asturias")))
 
         if self._year in {2014, 2025}:
@@ -282,7 +301,7 @@ class Spain(
             self._add_holiday_jul_28(tr("Día de las Instituciones de Cantabria"))
 
         if self._year not in {2013, 2019, 2024}:
-            # Our Lady of the Bien Aparecida.
+            # Our Lady of Bien Aparecida.
             self._add_holiday_sep_15(tr("La Bien Aparecida"))
 
         if self._year == 2015:
@@ -641,6 +660,9 @@ class Spain(
         if self._year in {2011, 2013, 2015, 2016, 2017} or self._year >= 2022:
             self._add_saint_james_day(tr("Santiago Apóstol"))
 
+        # Saint Francis Xavier's Day.
+        self._move_holiday(self._add_holiday_dec_3(tr("San Francisco Javier")))
+
         if self._year == 2020:
             self._move_holiday(self._add_holiday_dec_6(tr("Día de la Constitución Española")))
 

holidays/countries/sudan.py

@@ -0,0 +1,118 @@
+#  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 <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/vacanza/holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from gettext import gettext as tr
+
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import JAN, MAY, JUL, AUG, SEP, FRI, SAT
+from holidays.calendars.julian import JULIAN_CALENDAR
+from holidays.groups import ChristianHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Sudan(HolidayBase, ChristianHolidays, IslamicHolidays):
+    """Sudan holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Sudan>
+        * <https://web.archive.org/web/20250820070831/https://www.sudanembassy.org.uk/public-holidays/>
+        * [Christian Holidays 2011-2018](https://web.archive.org/web/20250827155208/https://evangelicalfocus.com/world/5014/christmas-celebrations-mark-progress-of-religious-freedom-in-sudan)
+    """
+
+    country = "SD"
+    default_language = "ar_SD"
+    # %s (estimated).
+    estimated_label = tr("%s (المقدرة)")
+    supported_languages = ("ar_SD", "en_US")
+    start_year = 1985
+    weekend = {FRI, SAT}
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        ChristianHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=SudanIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        super().__init__(*args, **kwargs)
+
+    def _get_weekend(self, dt: date) -> set[int]:
+        # The resting days are Friday and Saturday since January 26th, 2008.
+        # https://sudantribune.com/article25544/
+        return {FRI, SAT} if dt >= date(2008, JAN, 26) else {FRI}
+
+    def _populate_public_holidays(self):
+        # Independence Day.
+        self._add_holiday_jan_1(tr("عيد الإستقلال"))
+
+        # Christian public holidays were suspended 2011–2018 and reinstated in 2019.
+        if self._year <= 2010 or self._year >= 2019:
+            # Coptic Christmas Day.
+            self._add_christmas_day(tr("عيد الميلاد المجيد"), calendar=JULIAN_CALENDAR)
+
+            # Coptic Easter.
+            self._add_easter_sunday(tr("عيد الفصح القبطي"), calendar=JULIAN_CALENDAR)
+
+            # Christmas Day.
+            self._add_christmas_day(tr("عيد الميلاد"))
+
+        # Islamic New Year.
+        self._add_islamic_new_year_day(tr("رأس السنة الهجرية"))
+
+        # Prophet's Birthday.
+        self._add_mawlid_day(tr("المولد النبوي الشريف"))
+
+        # Eid al-Fitr.
+        name = tr("عيد الفطر المبارك")
+        self._add_eid_al_fitr_day(name)
+        self._add_eid_al_fitr_day_two(name)
+        self._add_eid_al_fitr_day_three(name)
+
+        if self._year >= 2020:
+            self._add_eid_al_fitr_day_four(name)
+
+        # Eid al-Adha.
+        name = tr("عيد الأضحى المبارك")
+        self._add_arafah_day(name)
+        self._add_eid_al_adha_day(name)
+        self._add_eid_al_adha_day_two(name)
+        self._add_eid_al_adha_day_three(name)
+        self._add_eid_al_adha_day_four(name)
+
+
+class SD(Sudan):
+    pass
+
+
+class SDN(Sudan):
+    pass
+
+
+class SudanIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2020, 2025)
+    EID_AL_ADHA_DATES = {
+        2022: (JUL, 10),
+    }
+
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2020, 2025)
+    EID_AL_FITR_DATES = {
+        2022: (MAY, 1),
+    }
+
+    HIJRI_NEW_YEAR_DATES_CONFIRMED_YEARS = (2020, 2025)
+    HIJRI_NEW_YEAR_DATES = {
+        2021: (AUG, 11),
+    }
+
+    MAWLID_DATES_CONFIRMED_YEARS = (2020, 2025)
+    MAWLID_DATES = {
+        2023: (SEP, 28),
+    }