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

holidays/countries/portugal.py

@@ -129,15 +129,14 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
         if self._year >= 1911:
             if 1933 <= self._year <= 1973:
                 # Day of Camões, Portugal, and the Portuguese Race.
-                self._add_holiday_jun_10(tr("Dia de Camões, de Portugal e da Raça"))
+                name = tr("Dia de Camões, de Portugal e da Raça")
             elif self._year >= 1978:
-                self._add_holiday_jun_10(
-                    # Day of Portugal, Camões, and the Portuguese Communities.
-                    tr("Dia de Portugal, de Camões e das Comunidades Portuguesas")
-                )
+                # Day of Portugal, Camões, and the Portuguese Communities.
+                name = tr("Dia de Portugal, de Camões e das Comunidades Portuguesas")
             else:
                 # Portugal Day.
-                self._add_holiday_jun_10(tr("Dia de Portugal"))
+                name = tr("Dia de Portugal")
+            self._add_holiday_jun_10(name)
 
         # Assumption Day.
         self._add_assumption_of_mary_day(tr("Assunção de Nossa Senhora"))

holidays/countries/qatar.py

@@ -10,6 +10,7 @@
 #  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
@@ -36,6 +37,7 @@ class Qatar(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays)
     start_year = 1971
     supported_categories = (BANK, PUBLIC)
     supported_languages = ("ar_QA", "en_US")
+    weekend = {FRI, SAT}
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
         """
@@ -51,10 +53,11 @@ class Qatar(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays)
         StaticHolidays.__init__(self, QatarStaticHolidays)
         super().__init__(*args, **kwargs)
 
-    def _populate_public_holidays(self):
+    def _get_weekend(self, dt: date) -> set[int]:
         # Qatar switches from THU-FRI to FRI-SAT on Aug 1, 2003.
-        self.weekend = {THU, FRI} if self._year <= 2003 else {FRI, SAT}
+        return {FRI, SAT} if dt >= date(2003, AUG, 1) else {THU, FRI}
 
+    def _populate_public_holidays(self):
         if self._year >= 2012:
             # National Sports Day.
             self._add_holiday_2nd_tue_of_feb(tr("اليوم الوطني للرياضة"))

holidays/countries/rwanda.py

@@ -10,8 +10,10 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import date
+from __future__ import annotations
+
 from gettext import gettext as tr
+from typing import TYPE_CHECKING
 
 from holidays.calendars import _CustomIslamicHolidays
 from holidays.calendars.gregorian import MAR, JUN, JUL, AUG
@@ -22,6 +24,9 @@ from holidays.observed_holiday_base import (
     SAT_SUN_TO_NEXT_WORKDAY,
 )
 
+if TYPE_CHECKING:
+    from datetime import date
+
 
 class Rwanda(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays):
     """Rwanda holidays.

holidays/countries/saudi_arabia.py

@@ -14,7 +14,7 @@ from datetime import date
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
-from holidays.calendars.gregorian import SEP, NOV, THU, FRI, SAT, _timedelta
+from holidays.calendars.gregorian import JUN, SEP, NOV, THU, FRI, SAT, _timedelta
 from holidays.groups import IslamicHolidays, StaticHolidays
 from holidays.observed_holiday_base import (
     ObservedHolidayBase,
@@ -46,6 +46,7 @@ class SaudiArabia(ObservedHolidayBase, IslamicHolidays, StaticHolidays):
     # %s (observed, estimated).
     observed_estimated_label = tr("%s (المقدرة، ملاحظة)")
     supported_languages = ("ar", "en_US")
+    weekend = {FRI, SAT}
 
     def __init__(self, *args, islamic_show_estimated: bool = False, **kwargs):
         """Saudi Arabia has traditionally used the Umm al-Qura calendar
@@ -71,16 +72,16 @@ class SaudiArabia(ObservedHolidayBase, IslamicHolidays, StaticHolidays):
         for i in range(4):
             self._add_observed(_timedelta(dt, -i), name=self[dt], rule=observed_rule)
 
-    def _populate_public_holidays(self):
+    def _get_weekend(self, dt: date) -> set[int]:
         # Weekend used to be THU, FRI before June 28th, 2013.
-        # On that year both Eids were after that date, and Founding day
-        # holiday started at 2022; so what below works.
+        return {FRI, SAT} if dt >= date(2013, JUN, 28) else {THU, FRI}
+
+    def _populate_public_holidays(self):
         self._observed_rule = (
             THU_TO_PREV_WED + FRI_TO_NEXT_SAT
             if self._year <= 2012
             else FRI_TO_PREV_THU + SAT_TO_NEXT_SUN
         )
-        self.weekend = {THU, FRI} if self._year <= 2012 else {FRI, SAT}
 
         # Eid al-Fitr Holiday.
         eid_al_fitr_name = tr("عطلة عيد الفطر")

holidays/countries/serbia.py

@@ -28,6 +28,8 @@ class Serbia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
     default_language = "sr"
     # %s (observed).
     observed_label = tr("%s (слободан дан)")
+    # Independence Restored on June 5th, 2006.
+    start_year = 2007
     supported_languages = ("en_US", "sr")
 
     def __init__(self, *args, **kwargs):
@@ -64,10 +66,13 @@ class Serbia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
 
         # Good Friday.
         self._add_good_friday(tr("Велики петак"))
+
         # Holy Saturday.
         self._add_holy_saturday(tr("Велика субота"))
+
         # Easter Sunday.
         self._add_easter_sunday(tr("Васкрс"))
+
         # Easter Monday.
         self._add_easter_monday(tr("Други дан Васкрса"))
 

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,

holidays/countries/spain.py

@@ -121,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):
         """
@@ -186,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"))
@@ -260,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}:
@@ -301,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:

holidays/countries/sudan.py

@@ -10,10 +10,11 @@
 #  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 MAY, JUL, AUG, SEP, FRI, SAT
+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
@@ -34,6 +35,7 @@ class Sudan(HolidayBase, ChristianHolidays, IslamicHolidays):
     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)
@@ -42,11 +44,12 @@ class Sudan(HolidayBase, ChristianHolidays, IslamicHolidays):
         )
         super().__init__(*args, **kwargs)
 
-    def _populate_public_holidays(self):
+    def _get_weekend(self, dt: date) -> set[int]:
         # The resting days are Friday and Saturday since January 26th, 2008.
         # https://sudantribune.com/article25544/
-        self.weekend = {FRI, SAT} if self._year >= 2008 else {FRI}
+        return {FRI, SAT} if dt >= date(2008, JAN, 26) else {FRI}
 
+    def _populate_public_holidays(self):
         # Independence Day.
         self._add_holiday_jan_1(tr("عيد الإستقلال"))