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

holidays/countries/lebanon.py

@@ -190,10 +190,10 @@ class LBN(Lebanon):
 
 class LebanonIslamicHolidays(_CustomIslamicHolidays):
     # https://web.archive.org/web/20250426220233/https://www.timeanddate.com/holidays/lebanon/first-day-ashura
+    ASHURA_DATES_CONFIRMED_YEARS = (1978, 2024)
     ASHURA_DATES = {
         1978: (DEC, 11),
         1979: (NOV, 30),
-        1980: (NOV, 18),
         1981: (NOV, 8),
         1982: (OCT, 28),
         1983: (OCT, 17),
@@ -206,28 +206,15 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         1990: (AUG, 2),
         1991: (JUL, 22),
         1992: (JUL, 11),
-        1993: (JUN, 30),
-        1994: (JUN, 19),
         1995: (JUN, 9),
         1996: (MAY, 28),
         1997: (MAY, 18),
         1998: (MAY, 7),
-        1999: (APR, 26),
-        2000: (APR, 15),
-        2001: (APR, 4),
-        2002: (MAR, 24),
         2003: (MAR, 14),
         2004: (MAR, 2),
-        2005: (FEB, 19),
-        2006: (FEB, 9),
-        2007: (JAN, 29),
-        2008: (JAN, 19),
-        2009: ((JAN, 7), (DEC, 27)),
         2010: (DEC, 17),
         2011: (DEC, 6),
-        2012: (NOV, 24),
         2013: (NOV, 14),
-        2014: (NOV, 3),
         2015: (OCT, 24),
         2016: (OCT, 12),
         2017: (OCT, 1),
@@ -236,11 +223,10 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         2020: (AUG, 30),
         2021: (AUG, 19),
         2022: (AUG, 9),
-        2023: (JUL, 28),
-        2024: (JUL, 16),
     }
 
     # https://web.archive.org/web/20250316072400/https://www.timeanddate.com/holidays/lebanon/eid-al-adha
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (1978, 2025)
     EID_AL_ADHA_DATES = {
         1978: (NOV, 11),
         1979: (NOV, 1),
@@ -256,7 +242,6 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         1989: (JUL, 14),
         1990: (JUL, 4),
         1991: (JUN, 23),
-        1992: (JUN, 11),
         1993: (JUN, 1),
         1994: (MAY, 21),
         1995: (MAY, 10),
@@ -264,35 +249,24 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         1997: (APR, 18),
         1998: (APR, 8),
         1999: (MAR, 28),
-        2000: (MAR, 16),
         2001: (MAR, 6),
         2002: (FEB, 23),
         2003: (FEB, 12),
         2004: (FEB, 2),
-        2005: (JAN, 21),
-        2006: ((JAN, 10), (DEC, 31)),
-        2007: (DEC, 20),
         2008: (DEC, 9),
         2009: (NOV, 28),
         2010: (NOV, 17),
         2011: (NOV, 7),
-        2012: (OCT, 26),
-        2013: (OCT, 15),
         2014: (OCT, 5),
         2015: (SEP, 24),
         2016: (SEP, 13),
         2017: (SEP, 2),
         2018: (AUG, 22),
         2019: (AUG, 12),
-        2020: (JUL, 31),
-        2021: (JUL, 20),
-        2022: (JUL, 9),
-        2023: (JUN, 28),
-        2024: (JUN, 16),
-        2025: (JUN, 6),
     }
 
     # https://web.archive.org/web/20250216042303/https://www.timeanddate.com/holidays/lebanon/eid-al-fitr
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (1978, 2025)
     EID_AL_FITR_DATES = {
         1978: (SEP, 4),
         1979: (AUG, 25),
@@ -300,7 +274,6 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         1981: (AUG, 2),
         1982: (JUL, 23),
         1983: (JUL, 12),
-        1984: (JUN, 30),
         1985: (JUN, 20),
         1986: (JUN, 9),
         1987: (MAY, 30),
@@ -308,7 +281,6 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         1989: (MAY, 7),
         1990: (APR, 27),
         1991: (APR, 16),
-        1992: (APR, 4),
         1993: (MAR, 25),
         1994: (MAR, 14),
         1995: (MAR, 3),
@@ -320,35 +292,21 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         2001: (DEC, 17),
         2002: (DEC, 6),
         2003: (NOV, 26),
-        2004: (NOV, 14),
         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, 29),
-        2015: (JUL, 17),
         2016: (JUL, 7),
         2017: (JUN, 26),
-        2018: (JUN, 15),
-        2019: (JUN, 4),
-        2020: (MAY, 24),
-        2021: (MAY, 13),
-        2022: (MAY, 2),
-        2023: (APR, 21),
-        2024: (APR, 10),
-        2025: (MAR, 30),
     }
 
     # https://web.archive.org/web/20250428034326/https://www.timeanddate.com/holidays/lebanon/muharram
+    HIJRI_NEW_YEAR_DATES_CONFIRMED_YEARS = (1978, 2025)
     HIJRI_NEW_YEAR_DATES = {
         1978: (DEC, 2),
         1979: (NOV, 21),
-        1980: (NOV, 9),
         1981: (OCT, 30),
         1982: (OCT, 19),
         1983: (OCT, 8),
@@ -361,47 +319,24 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         1990: (JUL, 24),
         1991: (JUL, 13),
         1992: (JUL, 2),
-        1993: (JUN, 21),
-        1994: (JUN, 10),
         1995: (MAY, 31),
         1996: (MAY, 19),
         1997: (MAY, 9),
         1998: (APR, 28),
-        1999: (APR, 17),
-        2000: (APR, 6),
-        2001: (MAR, 26),
-        2002: (MAR, 15),
         2003: (MAR, 5),
         2004: (FEB, 22),
-        2005: (FEB, 10),
-        2006: (JAN, 31),
-        2007: (JAN, 20),
-        2008: ((JAN, 10), (DEC, 29)),
-        2009: (DEC, 18),
         2010: (DEC, 8),
         2011: (NOV, 27),
-        2012: (NOV, 15),
         2013: (NOV, 5),
-        2014: (OCT, 25),
-        2015: (OCT, 14),
         2016: (OCT, 3),
         2017: (SEP, 22),
-        2018: (SEP, 11),
-        2019: (AUG, 31),
-        2020: (AUG, 20),
-        2021: (AUG, 9),
-        2022: (JUL, 30),
-        2023: (JUL, 19),
-        2024: (JUL, 7),
-        2025: (JUN, 26),
     }
 
     # https://web.archive.org/web/20240908071444/https://www.timeanddate.com/holidays/lebanon/prophet-birthday
+    MAWLID_DATES_CONFIRMED_YEARS = (1978, 2024)
     MAWLID_DATES = {
         1978: (FEB, 20),
         1979: (FEB, 10),
-        1980: (JAN, 30),
-        1981: (JAN, 18),
         1982: ((JAN, 8), (DEC, 28)),
         1983: (DEC, 17),
         1984: (DEC, 6),
@@ -414,35 +349,18 @@ class LebanonIslamicHolidays(_CustomIslamicHolidays):
         1991: (SEP, 21),
         1992: (SEP, 10),
         1993: (AUG, 30),
-        1994: (AUG, 19),
         1995: (AUG, 9),
         1996: (JUL, 28),
         1997: (JUL, 18),
         1998: (JUL, 7),
-        1999: (JUN, 26),
         2000: (JUN, 15),
-        2001: (JUN, 4),
-        2002: (MAY, 24),
         2003: (MAY, 14),
         2004: (MAY, 2),
-        2005: (APR, 21),
         2006: (APR, 11),
-        2007: (MAR, 31),
-        2008: (MAR, 20),
-        2009: (MAR, 9),
-        2010: (FEB, 26),
         2011: (FEB, 16),
         2012: (FEB, 5),
-        2013: (JAN, 24),
         2014: (JAN, 14),
         2015: ((JAN, 3), (DEC, 24)),
         2016: (DEC, 12),
         2017: (DEC, 1),
-        2018: (NOV, 20),
-        2019: (NOV, 9),
-        2020: (OCT, 29),
-        2021: (OCT, 18),
-        2022: (OCT, 8),
-        2023: (SEP, 27),
-        2024: (SEP, 15),
     }

holidays/countries/liberia.py

@@ -0,0 +1,80 @@
+#  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 ChristianHolidays, InternationalHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Liberia(HolidayBase, ChristianHolidays, InternationalHolidays):
+    """Liberia holidays.
+
+    References:
+        * [Patriotic and Cultural Observances Law 1956](http://www.liberlii.org/lr/legis/codes/pacolt25lcolr654/)
+
+    Inauguration Day is celebrated on the first Monday of January in the year after the
+    Presidential elections.
+    """
+
+    country = "LR"
+    start_year = 1957
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+
+        if self._year in {1960, 1964, 1968, 1972, 1976, 1986, 1998, 2006, 2012, 2018, 2024}:
+            # Inauguration Day.
+            self._add_holiday_1st_mon_of_jan("Inauguration Day")
+
+        # Armed Forces Day.
+        self._add_holiday_feb_11("Armed Forces Day")
+
+        # Decoration Day.
+        self._add_holiday_2nd_wed_of_mar("Decoration Day")
+
+        # J. J. Roberts Memorial Birthday.
+        self._add_holiday_mar_15("J. J. Roberts Memorial Birthday")
+
+        # Fasting and Prayer Day.
+        self._add_holiday_2nd_fri_of_apr("Fasting and Prayer Day")
+
+        if self._year >= 1960:
+            # National Unification and Integration Day.
+            self._add_holiday_may_14("National Unification and Integration Day")
+
+        # Independence Day.
+        self._add_holiday_jul_26("Independence Day")
+
+        # National Flag Day.
+        self._add_holiday_aug_24("National Flag Day")
+
+        # Thanksgiving Day.
+        self._add_holiday_1st_thu_of_nov("Thanksgiving Day")
+
+        # Tubman Administration Goodwill Day.
+        self._add_holiday_nov_29("Tubman Administration Goodwill Day")
+
+        # Christmas Day.
+        self._add_christmas_day("Christmas Day")
+
+
+class LR(Liberia):
+    pass
+
+
+class LBR(Liberia):
+    pass

holidays/countries/libya.py

@@ -13,7 +13,7 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomIslamicHolidays
-from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
+from holidays.calendars.gregorian import JAN, FEB, MAR, JUN, JUL, AUG, SEP, OCT, NOV, DEC
 from holidays.constants import PUBLIC, WORKDAY
 from holidays.groups import InternationalHolidays, IslamicHolidays, StaticHolidays
 from holidays.holiday_base import HolidayBase
@@ -142,75 +142,43 @@ class LBY(Libya):
 class LibyaIslamicHolidays(_CustomIslamicHolidays):
     # https://web.archive.org/web/20240908234803/https://www.timeanddate.com/holidays/libya/eid-al-adha
     # https://web.archive.org/web/20250629084537/https://lawsociety.ly/legislation/قرار-رقم-773-لسنة-2017-م-بشأن-تحديد-عطلة-عيد-ال/
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2012, 2025)
     EID_AL_ADHA_DATES = {
-        2012: (OCT, 26),
-        2013: (OCT, 15),
         2014: (OCT, 5),
-        2015: (SEP, 23),
-        2016: (SEP, 11),
-        2017: (SEP, 1),
         2018: (AUG, 22),
-        2019: (AUG, 11),
-        2020: (JUL, 31),
-        2021: (JUL, 20),
-        2022: (JUL, 9),
-        2023: (JUN, 28),
-        2024: (JUN, 16),
-        2025: (JUN, 6),
     }
 
     # https://web.archive.org/web/20241012125707/https://www.timeanddate.com/holidays/libya/eid-al-fitr
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2012, 2025)
     EID_AL_FITR_DATES = {
-        2012: (AUG, 19),
-        2013: (AUG, 8),
         2014: (JUL, 29),
         2015: (JUL, 18),
         2016: (JUL, 7),
         2017: (JUN, 26),
-        2018: (JUN, 15),
-        2019: (JUN, 4),
-        2020: (MAY, 24),
-        2021: (MAY, 13),
-        2022: (MAY, 2),
-        2023: (APR, 21),
-        2024: (APR, 10),
         2025: (MAR, 31),
     }
 
     # https://web.archive.org/web/20250418094505/https://www.timeanddate.com/holidays/libya/muharram-new-year
+    HIJRI_NEW_YEAR_DATES_CONFIRMED_YEARS = (2012, 2025)
     HIJRI_NEW_YEAR_DATES = {
-        2012: (NOV, 15),
         2013: (NOV, 5),
-        2014: (OCT, 25),
         2015: (OCT, 15),
         2016: (OCT, 3),
         2017: (SEP, 22),
         2018: (SEP, 12),
-        2019: (AUG, 31),
-        2020: (AUG, 20),
         2021: (AUG, 10),
-        2022: (JUL, 30),
-        2023: (JUL, 19),
-        2024: (JUL, 7),
-        2025: (JUN, 26),
     }
 
     # https://web.archive.org/web/20241213175353/https://www.timeanddate.com/holidays/libya/prophet-birthday
     # https://web.archive.org/web/20250629084607/https://lawsociety.ly/legislation/قرار-رقم-1299-لسنة-2019-م-بشأن-عطلة-ذكرى-المولد/
+    MAWLID_DATES_CONFIRMED_YEARS = (2012, 2024)
     MAWLID_DATES = {
         2012: (FEB, 5),
-        2013: (JAN, 24),
         2014: (JAN, 14),
-        2015: ((JAN, 3), (DEC, 23)),
         2016: (DEC, 12),
         2017: (DEC, 1),
         2018: (NOV, 21),
-        2019: (NOV, 9),
-        2020: (OCT, 29),
         2021: (OCT, 19),
-        2022: (OCT, 8),
-        2023: (SEP, 27),
-        2024: (SEP, 15),
     }
 
 

holidays/countries/macau.py

@@ -13,7 +13,7 @@
 from gettext import gettext as tr
 
 from holidays.calendars.gregorian import FEB, SEP, OCT, DEC
-from holidays.constants import GOVERNMENT, MANDATORY, PUBLIC
+from holidays.constants import GOVERNMENT, OPTIONAL, PUBLIC
 from holidays.groups import (
     ChineseCalendarHolidays,
     ChristianHolidays,
@@ -77,7 +77,7 @@ class Macau(
         "澳門市": "M",
         "澳门市": "M",
     }
-    supported_categories = (GOVERNMENT, MANDATORY, PUBLIC)
+    supported_categories = (GOVERNMENT, OPTIONAL, PUBLIC)
     supported_languages = ("en_MO", "en_US", "pt_MO", "th", "zh_CN", "zh_MO")
 
     def __init__(self, *args, **kwargs):
@@ -91,6 +91,63 @@ class Macau(
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        """Macau Mandatory (Statutory) Holidays.
+
+        Decreto-Lei n.º 101/84/M - Earliest Available Version Online.
+        Decreto-Lei n.º 24/89/M - Added Ching Ming Festival.
+        Lei n.º 8/2000 - Removed Day of Portugal
+                       - Added Macao S.A.R. Establishment Day.
+                       - Moved Mid-Autumn to Day following Mid-Autumn to match Public Holidays.
+        Lei n.º 7/2008 - Consolidated with other laws, reaffirming 2000 Amendment list.
+        """
+        if self._year <= 1984:
+            return None
+
+        # New Year's Day.
+        self._add_new_years_day(tr("元旦"))
+
+        # Chinese New Year's Day.
+        self._add_chinese_new_years_day(tr("農曆正月初一"))
+
+        # The second day of Chinese New Year.
+        self._add_chinese_new_years_day_two(tr("農曆正月初二"))
+
+        # The third day of Chinese New Year.
+        self._add_chinese_new_years_day_three(tr("農曆正月初三"))
+
+        # Labor Day.
+        self._add_labor_day(tr("勞動節"))
+
+        # Double Ninth Festival.
+        self._add_double_ninth_festival(tr("重陽節"))
+
+        # National Day of the People's Republic of China.
+        self._add_holiday_oct_1(tr("中華人民共和國國慶日"))
+
+        # Decreto-Lei n.º 24/89/M - Adds Ching Ming as a Mandatory Holiday.
+        if self._year >= 1989:
+            # Tomb-Sweeping Day.
+            self._add_qingming_festival(tr("清明節"))
+
+        # Lei n.º 8/2000 - Removed Day of Portugal as a Mandatory Holiday.
+        #                - Changed observance from Mid-Autumn to the following day.
+        #                - Adds Macao S.A.R. Establishment Day as a Mandatory Holiday.
+        if self._year <= 1999:
+            # Day of Portugal, Camões, and the Portuguese Communities.
+            self._add_holiday_jun_10(tr("葡國日、賈梅士日暨葡僑日"))
+
+            # Mid-Autumn Festival.
+            self._add_mid_autumn_festival(tr("中秋節"))
+
+        else:
+            # The Day following Mid-Autumn Festival.
+            self._add_mid_autumn_festival_day_two(tr("中秋節翌日"))
+
+            # Macao S.A.R. Establishment Day.
+            self._add_holiday_dec_20(tr("澳門特別行政區成立紀念日"))
+
+    def _populate_optional_holidays(self):
+        """Macau General Holidays."""
         # New Year's Day.
         self._add_new_years_day(tr("元旦"))
 
@@ -223,61 +280,6 @@ class Macau(
             # Macao S.A.R. Establishment Day.
             self._add_holiday_dec_20(tr("澳門特別行政區成立紀念日"))
 
-    def _populate_mandatory_holidays(self):
-        """
-        Decreto-Lei n.º 101/84/M - Earliest Available Version Online.
-        Decreto-Lei n.º 24/89/M - Added Ching Ming Festival.
-        Lei n.º 8/2000 - Removed Day of Portugal
-                       - Added Macao S.A.R. Establishment Day.
-                       - Moved Mid-Autumn to Day following Mid-Autumn to match Public Holidays.
-        Lei n.º 7/2008 - Consolidated with other laws, reaffirming 2000 Amendment list.
-        """
-        if self._year <= 1984:
-            return None
-
-        # New Year's Day.
-        self._add_new_years_day(tr("元旦"))
-
-        # Chinese New Year's Day.
-        self._add_chinese_new_years_day(tr("農曆正月初一"))
-
-        # The second day of Chinese New Year.
-        self._add_chinese_new_years_day_two(tr("農曆正月初二"))
-
-        # The third day of Chinese New Year.
-        self._add_chinese_new_years_day_three(tr("農曆正月初三"))
-
-        # Labor Day.
-        self._add_labor_day(tr("勞動節"))
-
-        # Double Ninth Festival.
-        self._add_double_ninth_festival(tr("重陽節"))
-
-        # National Day of the People's Republic of China.
-        self._add_holiday_oct_1(tr("中華人民共和國國慶日"))
-
-        # Decreto-Lei n.º 24/89/M - Adds Ching Ming as a Mandatory Holiday.
-        if self._year >= 1989:
-            # Tomb-Sweeping Day.
-            self._add_qingming_festival(tr("清明節"))
-
-        # Lei n.º 8/2000 - Removed Day of Portugal as a Mandatory Holiday.
-        #                - Changed observance from Mid-Autumn to the following day.
-        #                - Adds Macao S.A.R. Establishment Day as a Mandatory Holiday.
-        if self._year <= 1999:
-            # Day of Portugal, Camões, and the Portuguese Communities.
-            self._add_holiday_jun_10(tr("葡國日、賈梅士日暨葡僑日"))
-
-            # Mid-Autumn Festival.
-            self._add_mid_autumn_festival(tr("中秋節"))
-
-        else:
-            # The Day following Mid-Autumn Festival.
-            self._add_mid_autumn_festival_day_two(tr("中秋節翌日"))
-
-            # Macao S.A.R. Establishment Day.
-            self._add_holiday_dec_20(tr("澳門特別行政區成立紀念日"))
-
     def _populate_government_holidays(self):
         # While Cross-Checking References are available for from 2005-2025,
         # SUN in-lieus starts in 2011; SAT-SUN in-lieus starts in 2012.
@@ -378,7 +380,7 @@ class Macau(
             )
             self._populate_observed(dts_observed, multiple=True)
 
-    def _populate_subdiv_i_public_holidays(self):
+    def _populate_subdiv_i_optional_holidays(self):
         # Decreto-Lei n.º 15/93/M - Moved Day of the Municipality of Ilhas from JUL 13 to NOV 30.
         # Regulamento Administrativo n.º 4/1999 - Removed as a Public Holiday.
         if self._year <= 1999:
@@ -389,7 +391,7 @@ class Macau(
             else:
                 self._add_holiday_jul_13(name)
 
-    def _populate_subdiv_m_public_holidays(self):
+    def _populate_subdiv_m_optional_holidays(self):
         # Regulamento Administrativo n.º 4/1999 - Removed Macau City Day as a Public Holiday.
         if self._year <= 1999:
             # Macau City Day.
@@ -407,10 +409,10 @@ class MAC(Macau):
 class MacauStaticHolidays:
     """Macau special holidays.
 
-    Special Public and Government Holidays:
+    Special General and Government Holidays:
         * <https://web.archive.org/web/20240421052702/https://www.io.gov.mo/pt/legis/rec/111020>
 
-    Special Mandatory Holidays:
+    Special Mandatory (Statutory) Holidays:
         * <https://web.archive.org/web/20250421090753/https://www.dsal.gov.mo/pt/standard/holiday_table.html>
 
     Cross-Checking:
@@ -457,10 +459,10 @@ class MacauStaticHolidays:
         2014: (OCT, 3, name_double_ninth_festival_national_day_2_overlap),
         2020: (OCT, 5, name_mid_autumn_festival_day_2_national_day_2_overlap),
     }
-    special_mandatory_holidays = {
+    special_public_holidays = {
         2015: (SEP, 3, name_70th_war_of_resistance),
     }
-    special_public_holidays = {
+    special_optional_holidays = {
         1998: (
             (DEC, 23, name_fullday),
             (DEC, 31, name_halfday),