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

holidays/countries/qatar.py

@@ -13,22 +13,7 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
-from holidays.calendars.gregorian import (
-    JAN,
-    MAR,
-    APR,
-    MAY,
-    JUN,
-    JUL,
-    AUG,
-    SEP,
-    OCT,
-    NOV,
-    DEC,
-    THU,
-    FRI,
-    SAT,
-)
+from holidays.calendars.gregorian import JAN, JUL, AUG, SEP, OCT, NOV, DEC, THU, FRI, SAT
 from holidays.constants import BANK, PUBLIC
 from holidays.groups import InternationalHolidays, IslamicHolidays, StaticHolidays
 from holidays.holiday_base import HolidayBase
@@ -109,52 +94,25 @@ class QAT(Qatar):
 
 class QatarIslamicHolidays(_CustomIslamicHolidays):
     # https://web.archive.org/web/20250422212912/https://www.timeanddate.com/holidays/qatar/eid-al-adha
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2005, 2024)
     EID_AL_ADHA_DATES = {
-        2005: (JAN, 21),
-        2006: ((JAN, 10), (DEC, 31)),
-        2007: (DEC, 20),
         2008: (DEC, 9),
         2009: (NOV, 28),
         2010: (NOV, 15),
-        2011: (NOV, 6),
-        2012: (OCT, 26),
-        2013: (OCT, 15),
-        2014: (OCT, 4),
-        2015: (SEP, 23),
         2016: (SEP, 10),
         2017: (AUG, 31),
         2018: (AUG, 22),
-        2019: (AUG, 11),
-        2020: (JUL, 31),
-        2021: (JUL, 20),
-        2022: (JUL, 9),
-        2023: (JUN, 28),
-        2024: (JUN, 16),
     }
 
     # https://web.archive.org/web/20241207022523/https://www.timeanddate.com/holidays/qatar/eid-al-fitr
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2005, 2025)
     EID_AL_FITR_DATES = {
         2005: (NOV, 4),
         2006: (OCT, 24),
-        2007: (OCT, 13),
         2008: (OCT, 2),
         2009: (SEP, 21),
-        2010: (SEP, 10),
         2011: (AUG, 31),
-        2012: (AUG, 19),
-        2013: (AUG, 8),
-        2014: (JUL, 28),
         2015: (JUL, 18),
-        2016: (JUL, 6),
-        2017: (JUN, 25),
-        2018: (JUN, 15),
-        2019: (JUN, 4),
-        2020: (MAY, 24),
-        2021: (MAY, 13),
-        2022: (MAY, 2),
-        2023: (APR, 21),
-        2024: (APR, 10),
-        2025: (MAR, 30),
     }
 
 

holidays/countries/rwanda.py

@@ -0,0 +1,162 @@
+#  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 MAR, JUN, JUL, AUG
+from holidays.groups import ChristianHolidays, InternationalHolidays, IslamicHolidays
+from holidays.observed_holiday_base import (
+    ObservedHolidayBase,
+    SAT_TO_NEXT_WORKDAY,
+    SAT_SUN_TO_NEXT_WORKDAY,
+)
+
+
+class Rwanda(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays):
+    """Rwanda holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Rwanda>
+        * [Presidential Order N° 06/01 of 16/02/2011](https://web.archive.org/web/20250601161219/https://archive.gazettes.africa/archive/rw/2011/rw-government-gazette-dated-2011-03-07-no-10.pdf)
+        * [Presidential Order N° 42/03 of 30/06/2015](https://web.archive.org/web/20180417062635/http://www.igihe.com/IMG/pdf/iteka_rya_perezida_rigena_iminsi_y_ikiruhuko_rusange.pdf)
+        * [Presidential Order N° 54/01 of 24/02/2017](https://web.archive.org/web/20220626143357/https://www.ngoma.gov.rw/index.php?eID=dumpFile&t=f&f=44336&token=fc82c76109af7950f8895d40ddd3e15bd8c57e8c)
+        * [Presidential Order N° 62/01 of 19/10/2022](https://web.archive.org/web/20250815032533/https://mifotra.prod.risa.rw/index.php?eID=dumpFile&t=f&f=85230&token=bcf0bf166638c11f4bf3d2f8c629052db26d38b6)
+    """
+
+    country = "RW"
+    default_language = "rw"
+    # %s (estimated).
+    estimated_label = tr("%s (yagereranijwe)")
+    # %s (observed).
+    observed_label = tr("%s (yizihijwe)")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s (yizihijwe, yagereranijwe)")
+    supported_languages = ("en_US", "fr", "rw")
+    # Presidential Order N° 06/01 of 16/02/2011.
+    start_year = 2012
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=RwandaIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        kwargs.setdefault("observed_since", 2017)
+        super().__init__(*args, **kwargs)
+
+    def _populate_observed(self, dts: set[date], multiple: bool = False) -> None:
+        """
+        Applies `SAT_TO_NEXT_WORKDAY` instead of `SAT_SUN_TO_NEXT_WORKDAY`
+        observed_rule for Day after New Year's Day and Boxing Day.
+        """
+        special_cases = {
+            # Day after New Year's Day.
+            self.tr("Umunsi ukurikira Ubunani"),
+            # Boxing Day.
+            self.tr("Umunsi ukurikira Noheli"),
+        }
+        for dt in sorted(dts):
+            for name in self.get_list(dt):
+                self._add_observed(
+                    dt,
+                    name,
+                    SAT_TO_NEXT_WORKDAY if name in special_cases else SAT_SUN_TO_NEXT_WORKDAY,
+                )
+
+    def _populate_public_holidays(self):
+        dts_observed = set()
+
+        # New Year's Day.
+        dt = self._add_new_years_day(tr("Ubunani"))
+        if self._year >= 2018:
+            dts_observed.add(dt)
+
+        # Added via Presidential Order N° 42/03 of 30/06/2015.
+        if self._year >= 2016:
+            # Day after New Year's Day.
+            dts_observed.add(self._add_new_years_day_two(tr("Umunsi ukurikira Ubunani")))
+
+        # National Heroes' Day.
+        dts_observed.add(self._add_holiday_feb_1(tr("Umunsi w'Intwari")))
+
+        # Memorial Day of Genocide perpetrated against the Tutsi in 1994.
+        self._add_holiday_apr_7(tr("Umunsi wo Kwibuka Jenoside yakorewe Abatutsi mu 1994"))
+
+        # Good Friday.
+        self._add_good_friday(tr("Umunsi wa Gatanu Mutagatifu"))
+
+        # Added via Presidential Order N° 54/01 of 24/02/2017.
+        if self._year >= 2017:
+            # Easter Monday.
+            self._add_easter_monday(tr("Ku wa mbere wa Pasika"))
+
+        # Labor Day.
+        dts_observed.add(self._add_labor_day(tr("Umunsi Mukuru w'Umurimo")))
+
+        # Independence Day.
+        dts_observed.add(self._add_holiday_jul_1(tr("Umunsi w'Ubwigenge")))
+
+        # Liberation Day.
+        dts_observed.add(self._add_holiday_jul_4(tr("Umunsi wo Kwibohora")))
+
+        # Added via Presidential Order N° 42/03 of 30/06/2015.
+        if self._year >= 2015:
+            # Umuganura Day.
+            self._add_holiday_1st_fri_of_aug(tr("Umunsi w'Umuganura"))
+
+        # Assumption Day.
+        dts_observed.add(self._add_assumption_of_mary_day(tr("Ijyanwa mu Ijuru rya Bikiramariya")))
+
+        # Christmas Day.
+        dts_observed.add(self._add_christmas_day(tr("Noheli")))
+
+        # Boxing Day.
+        dts_observed.add(self._add_christmas_day_two(tr("Umunsi ukurikira Noheli")))
+
+        # Eid al-Fitr.
+        dts_observed.update(self._add_eid_al_fitr_day(tr("Eid El Fitr")))
+
+        # Added via Presidential Order N° 42/03 of 30/06/2015.
+        if self._year >= 2015:
+            # Eid al-Adha.
+            dts_observed.update(self._add_eid_al_adha_day(tr("Eid al-Adha")))
+
+        if self.observed:
+            self._populate_observed(dts_observed)
+
+
+class RW(Rwanda):
+    pass
+
+
+class RWA(Rwanda):
+    pass
+
+
+class RwandaIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2018, 2025)
+    EID_AL_ADHA_DATES = {
+        2018: (AUG, 22),
+        2019: (AUG, 12),
+        2022: (JUL, 11),
+    }
+
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2012, 2025)
+    EID_AL_FITR_DATES = {
+        2014: (JUL, 29),
+        2015: (JUL, 18),
+        2016: (JUL, 7),
+        2017: (JUN, 26),
+        2025: (MAR, 31),
+    }

holidays/countries/saudi_arabia.py

@@ -125,10 +125,13 @@ class SAU(SaudiArabia):
 
 
 class SaudiArabiaIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2001, 2025)
     EID_AL_ADHA_DATES = {
         2015: (SEP, 24),
     }
 
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2001, 2025)
+
 
 class SaudiArabiaStaticHolidays:
     special_public_holidays = {

holidays/countries/senegal.py

@@ -13,7 +13,7 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
-from holidays.calendars.gregorian import MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, DEC
+from holidays.calendars.gregorian import APR, MAY, JUN, JUL, AUG, SEP, OCT, DEC
 from holidays.groups import (
     ChristianHolidays,
     InternationalHolidays,
@@ -131,15 +131,13 @@ class SEN(Senegal):
 
 class SenegalIslamicHolidays(_CustomIslamicHolidays):
     # https://web.archive.org/web/20250609044648/https://www.timeanddate.com/holidays/senegal/tamkharit
+    ASHURA_DATES_CONFIRMED_YEARS = (2020, 2024)
     ASHURA_DATES = {
-        2020: (AUG, 29),
-        2021: (AUG, 18),
-        2022: (AUG, 8),
-        2023: (JUL, 28),
         2024: (JUL, 17),
     }
 
     # https://web.archive.org/web/20250609061446/https://www.timeanddate.com/holidays/senegal/grand-magal-de-touba
+    GRAND_MAGAL_OF_TOUBA_DATES_CONFIRMED_YEARS = (2020, 2024)
     GRAND_MAGAL_OF_TOUBA_DATES = {
         2020: (OCT, 6),
         2021: (SEP, 26),
@@ -149,27 +147,19 @@ class SenegalIslamicHolidays(_CustomIslamicHolidays):
     }
 
     # https://web.archive.org/web/20250609091559/https://www.timeanddate.com/holidays/senegal/maouloud
-    MAWLID_DATES = {
-        2020: (OCT, 29),
-        2021: (OCT, 18),
-        2022: (OCT, 8),
-        2023: (SEP, 27),
-        2024: (SEP, 15),
-    }
+    MAWLID_DATES_CONFIRMED_YEARS = (2020, 2024)
 
     # https://web.archive.org/web/20250609092813/https://www.timeanddate.com/holidays/senegal/korite
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2020, 2025)
     EID_AL_FITR_DATES = {
-        2020: (MAY, 24),
         2021: (MAY, 12),
         2022: (MAY, 1),
         2023: (APR, 22),
-        2024: (APR, 10),
-        2025: (MAR, 30),
     }
 
     # https://web.archive.org/web/20250609102658/https://www.timeanddate.com/holidays/senegal/tabaski
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2020, 2024)
     EID_AL_ADHA_DATES = {
-        2020: (JUL, 31),
         2021: (JUL, 21),
         2022: (JUL, 10),
         2023: (JUN, 29),

holidays/countries/sierra_leone.py

@@ -12,8 +12,8 @@
 
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV
-from holidays.calendars.islamic import _CustomIslamicHolidays
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import JUN, AUG, NOV
 from holidays.groups import ChristianHolidays, InternationalHolidays, IslamicHolidays
 from holidays.observed_holiday_base import ObservedHolidayBase, SAT_SUN_TO_NEXT_WORKDAY
 
@@ -115,35 +115,19 @@ class SierraLeoneIslamicHolidays(_CustomIslamicHolidays):
         * <https://web.archive.org/web/20250408204431/https://www.timeanddate.com/holidays/sierra-leone/>
     """
 
-    # Prophet's Birthday
+    MAWLID_DATES_CONFIRMED_YEARS = (2018, 2024)
     MAWLID_DATES = {
         2018: (NOV, 21),
         2019: (NOV, 10),
-        2020: (OCT, 29),
-        2021: (OCT, 18),
-        2022: (OCT, 8),
-        2023: (SEP, 27),
-        2024: (SEP, 15),
     }
 
-    # Eid al-Fitr
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2018, 2024)
     EID_AL_FITR_DATES = {
-        2018: (JUN, 15),
         2019: (JUN, 5),
-        2020: (MAY, 24),
-        2021: (MAY, 13),
-        2022: (MAY, 2),
-        2023: (APR, 21),
-        2024: (APR, 10),
     }
 
-    # Eid al-Adha
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2018, 2024)
     EID_AL_ADHA_DATES = {
         2018: (AUG, 22),
         2019: (AUG, 12),
-        2020: (JUL, 31),
-        2021: (JUL, 20),
-        2022: (JUL, 9),
-        2023: (JUN, 28),
-        2024: (JUN, 16),
     }

holidays/countries/singapore.py

@@ -60,7 +60,11 @@ class Singapore(
     """
 
     country = "SG"
+    # %s (estimated).
+    estimated_label = tr("%s (estimated)")
     default_language = "en_SG"
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s (observed, estimated)")
     # %s (observed).
     observed_label = tr("%s (observed)")
     supported_languages = ("en_SG", "en_US", "th")
@@ -182,33 +186,10 @@ class SingaporeBuddhistHolidays(_CustomBuddhistHolidays):
 
 
 class SingaporeChineseHolidays(_CustomChineseHolidays):
+    LUNAR_NEW_YEAR_DATES_CONFIRMED_YEARS = (2001, 2026)
     LUNAR_NEW_YEAR_DATES = {
-        2001: (JAN, 24),
-        2002: (FEB, 12),
-        2003: (FEB, 1),
-        2004: (JAN, 22),
-        2005: (FEB, 9),
         2006: (JAN, 30),
         2007: (FEB, 19),
-        2008: (FEB, 7),
-        2009: (JAN, 26),
-        2010: (FEB, 14),
-        2011: (FEB, 3),
-        2012: (JAN, 23),
-        2013: (FEB, 10),
-        2014: (JAN, 31),
-        2015: (FEB, 19),
-        2016: (FEB, 8),
-        2017: (JAN, 28),
-        2018: (FEB, 16),
-        2019: (FEB, 5),
-        2020: (JAN, 25),
-        2021: (FEB, 12),
-        2022: (FEB, 1),
-        2023: (JAN, 22),
-        2024: (FEB, 10),
-        2025: (JAN, 29),
-        2026: (FEB, 17),
     }
 
 
@@ -245,62 +226,29 @@ class SingaporeHinduHolidays(_CustomHinduHolidays):
 
 
 class SingaporeIslamicHolidays(_CustomIslamicHolidays):
-    # Hari Raya Haji
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2001, 2026)
     EID_AL_ADHA_DATES = {
         2001: (MAR, 6),
         2002: (FEB, 23),
         2003: (FEB, 12),
-        2004: (FEB, 1),
-        2005: (JAN, 21),
-        2006: ((JAN, 10), (DEC, 31)),
-        2007: (DEC, 20),
-        2008: (DEC, 8),
-        2009: (NOV, 27),
         2010: (NOV, 17),
-        2011: (NOV, 6),
-        2012: (OCT, 26),
-        2013: (OCT, 15),
         2014: (OCT, 5),
         2015: (SEP, 24),
         2016: (SEP, 12),
-        2017: (SEP, 1),
         2018: (AUG, 22),
-        2019: (AUG, 11),
-        2020: (JUL, 31),
-        2021: (JUL, 20),
         2022: (JUL, 10),
         2023: (JUN, 29),
         2024: (JUN, 17),
         2025: (JUN, 7),
-        2026: (MAY, 27),
     }
 
-    # Hari Raya Puasa
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2001, 2026)
     EID_AL_FITR_DATES = {
-        2001: (DEC, 16),
         2002: (DEC, 6),
-        2003: (NOV, 25),
-        2004: (NOV, 14),
-        2005: (NOV, 3),
         2006: (OCT, 24),
-        2007: (OCT, 13),
-        2008: (OCT, 1),
-        2009: (SEP, 20),
-        2010: (SEP, 10),
-        2011: (AUG, 30),
-        2012: (AUG, 19),
-        2013: (AUG, 8),
-        2014: (JUL, 28),
-        2015: (JUL, 17),
-        2016: (JUL, 6),
-        2017: (JUN, 25),
-        2018: (JUN, 15),
         2019: (JUN, 5),
-        2020: (MAY, 24),
-        2021: (MAY, 13),
         2022: (MAY, 3),
         2023: (APR, 22),
-        2024: (APR, 10),
         2025: (MAR, 31),
         2026: (MAR, 21),
     }

holidays/countries/somalia.py

@@ -0,0 +1,79 @@
+#  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 holidays.groups import InternationalHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Somalia(HolidayBase, InternationalHolidays, IslamicHolidays):
+    """Somalia holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Somalia>
+        * <https://web.archive.org/web/20250522034818/https://usa.mfa.gov.so/about-somalia/>
+    """
+
+    country = "SO"
+    # %s (estimated).
+    estimated_label = "%s (estimated)"
+    # Unification of Somaliland and Italian Somaliland into the Somali Republic on July 1st, 1960.
+    start_year = 1961
+
+    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+
+        # Labor Day.
+        self._add_labor_day("Labour Day")
+
+        # Independence Day.
+        self._add_holiday_jun_26("Independence Day")
+
+        # Republic Day.
+        self._add_holiday_jul_1("Republic Day")
+
+        # Islamic New Year.
+        self._add_islamic_new_year_day("Islamic New Year")
+
+        # Ashura.
+        self._add_ashura_day("Ashura")
+
+        # Prophet's Birthday.
+        self._add_mawlid_day("Prophet's Birthday")
+
+        # Isra' and Mi'raj.
+        self._add_isra_and_miraj_day("Isra' and Mi'raj")
+
+        # Eid al-Fitr.
+        self._add_eid_al_fitr_day("Eid al-Fitr")
+
+        # Eid al-Adha.
+        self._add_eid_al_adha_day("Eid al-Adha")
+
+
+class SO(Somalia):
+    pass
+
+
+class SOM(Somalia):
+    pass