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

holidays/countries/iraq.py

@@ -0,0 +1,276 @@
+#  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 gettext import gettext as tr
+
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import JAN, MAR, JUN, JUL, AUG, SEP, OCT, NOV, DEC, FRI, SAT
+from holidays.constants import CHRISTIAN, HEBREW, PUBLIC, SABIAN, YAZIDI
+from holidays.groups import (
+    ChristianHolidays,
+    HebrewCalendarHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+    MandaeanHolidays,
+)
+from holidays.holiday_base import HolidayBase
+
+
+class Iraq(
+    HolidayBase,
+    ChristianHolidays,
+    HebrewCalendarHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+    MandaeanHolidays,
+):
+    """Iraq holidays.
+
+    References:
+        - [Law No. 10 of 1963](https://web.archive.org/web/20200220135833/http://wiki.dorar-aliraq.net:80/iraqilaws/law/1447.html)
+        - [1968 Amendment to Law No. 10 of 1963](https://web.archive.org/web/20250730075454/https://wiki.dorar-aliraq.net/iraqilaws/law/18741.html)
+        - [Law No. 110 of 1972](https://web.archive.org/web/20240820010527/https://wiki.dorar-aliraq.net/iraqilaws/law/5663.html)
+        - [1973 Amendment to Law No. 110 of 1972](https://web.archive.org/web/20250730080337/https://wiki.dorar-aliraq.net/iraqilaws/law/6165.html)
+        - [Official Holiday Law 2024](https://web.archive.org/web/20250629123214/https://natlex.ilo.org/dyn/natlex2/natlex2/files/download/116577/قانون%20العطل%20الرسمية%20-%20Copy%20-%20Copy_396.pdf)
+    """
+
+    country = "IQ"
+    default_language = "ar"
+    # %s (estimated).
+    estimated_label = tr("%s (المقدرة)")
+    start_year = 1964
+    supported_categories = (CHRISTIAN, HEBREW, PUBLIC, SABIAN, YAZIDI)
+    supported_languages = ("ar", "en_US")
+    weekend = {FRI, SAT}
+
+    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.
+        """
+        ChristianHolidays.__init__(self)
+        HebrewCalendarHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=IraqIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        MandaeanHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        if self._year >= 1973:
+            # New Year's Day.
+            self._add_new_years_day(tr("رأس السنة الميلادية"))
+
+        # Army Day.
+        self._add_holiday_jan_6(tr("عيد الجيش"))
+
+        if self._year <= 2024:
+            # February 8 Revolution.
+            self._add_holiday_feb_8(tr("ثورة 8 شباط"))
+
+        if self._year >= 2025:
+            # Commemoration of the Saddam Baath crimes against the Iraqi people.
+            self._add_holiday_mar_16(tr("ذكرى جرائم البعث والأنفال والهجوم على حلبجة"))
+
+        if self._year >= 1969:
+            # Nowruz.
+            self._add_holiday_mar_21(tr("عيد نوروز"))
+
+        # Labor Day.
+        self._add_labor_day(tr("عيد العمال العالمي"))
+
+        if self._year <= 2023:
+            # July 14 Revolution.
+            self._add_holiday_jul_14(tr("ثورة 14 تموز"))
+
+        if 1969 <= self._year <= 2023:
+            # July 17 Revolution.
+            self._add_holiday_jul_17(tr("ثورة 17 تموز"))
+
+        # Islamic New Year.
+        self._add_islamic_new_year_day(tr("رأس السنة الهجرية"))
+
+        # Ashura.
+        self._add_ashura_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)
+
+        # Day of Arafah.
+        self._add_arafah_day(tr("يوم عرفة"))
+
+        # Eid al-Adha.
+        name = tr("عيد الأضحى")
+        self._add_eid_al_adha_day(name)
+        self._add_eid_al_adha_day_two(name)
+        self._add_eid_al_adha_day_three(name)
+
+        if self._year >= 2024:
+            # Eid al-Ghadir.
+            self._add_eid_al_ghadir_day(tr("عيد الغدير"))
+
+    def _populate_christian_holidays(self):
+        if self._year <= 1972:
+            # New Year's Day.
+            self._add_new_years_day(tr("رأس السنة الميلادية"))
+
+        # Easter Sunday.
+        self._add_easter_sunday(tr("أحد الفصح"))
+
+        # Easter Monday.
+        self._add_easter_monday(tr("إثنين الفصح"))
+
+        # Christmas Day.
+        self._add_christmas_day(tr("عيد الميلاد"))
+
+    def _populate_hebrew_holidays(self):
+        if self._year <= 2023:
+            # Pesach.
+            self._add_passover(tr("عيد الفصح"), range(2))
+
+            # Yom Kippur.
+            self._add_yom_kippur(tr("يوم الكفارة"))
+
+            # Sukkot.
+            self._add_sukkot(tr("عيد المظلة"), range(2))
+
+    def _populate_sabian_holidays(self):
+        if self._year <= 1972:
+            return None
+
+        # Great Feast.
+        name = tr("يوما عيد البنجة")
+        self._add_great_feast_day(name)
+        self._add_great_feast_day_two(name)
+        if self._year >= 2024:
+            self._add_great_feast_day_three(name)
+            self._add_great_feast_day_four(name)
+
+        # Feast of Creation.
+        name = tr("عيد الخليقة")
+        self._add_parwanaya_day(name)
+        self._add_parwanaya_day_two(name)
+        if self._year >= 2024:
+            self._add_parwanaya_day_three(name)
+            self._add_parwanaya_day_four(name)
+            self._add_parwanaya_day_five(name)
+
+        # Little Feast.
+        name = tr("عيد الصغير")
+        self._add_dehwa_hanina_day(name)
+        if self._year >= 2024:
+            self._add_dehwa_hanina_day_two(name)
+
+        # Prophet Yahya's Birthday.
+        self._add_dehwa_daimana_day(tr("مولد النبي يحيى عليه السلام"))
+
+    def _populate_yazidi_holidays(self):
+        # Yazidi New Year.
+        self._add_holiday_1st_wed_from_apr_14(tr("رأس السنة الإيزيدية"))
+
+        # Yazidi Summer Festival.
+        name = tr("مهرجان الصيف اليزيدي")
+        if self._year <= 2023:
+            self._add_holiday_jul_31(name)
+            self._add_holiday_aug_1(name)
+        self._add_holiday_aug_2(name)
+        self._add_holiday_aug_3(name)
+
+        # Feast of the Assembly.
+        name = tr("عيد الجمعية")
+        self._add_holiday_oct_6(name)
+        self._add_holiday_oct_7(name)
+        self._add_holiday_oct_8(name)
+        self._add_holiday_oct_9(name)
+        self._add_holiday_oct_10(name)
+        self._add_holiday_oct_11(name)
+        self._add_holiday_oct_12(name)
+        self._add_holiday_oct_13(name)
+
+        # Feast of Êzî.
+        self._add_holiday_1st_fri_from_dec_14(tr("عيد إيزي"))
+
+
+class IQ(Iraq):
+    pass
+
+
+class IRQ(Iraq):
+    pass
+
+
+class IraqIslamicHolidays(_CustomIslamicHolidays):
+    # https://web.archive.org/web/20240908214306/https://www.timeanddate.com/holidays/iraq/ashura
+    ASHURA_DATES_CONFIRMED_YEARS = (2013, 2025)
+    ASHURA_DATES = {
+        2013: (NOV, 14),
+        2015: (OCT, 24),
+        2016: (OCT, 12),
+        2017: (OCT, 1),
+        2019: (SEP, 10),
+        2020: (AUG, 30),
+        2021: (AUG, 19),
+        2023: (JUL, 29),
+    }
+
+    # https://web.archive.org/web/20250524093010/https://www.timeanddate.com/holidays/iraq/eid-al-adha
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2013, 2025)
+    EID_AL_ADHA_DATES = {
+        2015: (SEP, 24),
+        2016: (SEP, 13),
+        2017: (SEP, 2),
+        2018: (AUG, 22),
+        2019: (AUG, 12),
+    }
+
+    # https://web.archive.org/web/20250514061230/https://www.timeanddate.com/holidays/iraq/eid-al-fitr
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2013, 2025)
+    EID_AL_FITR_DATES = {
+        2015: (JUL, 18),
+        2016: (JUL, 7),
+        2017: (JUN, 26),
+        2025: (MAR, 31),
+    }
+
+    # https://web.archive.org/web/20241009070642/https://www.timeanddate.com/holidays/iraq/eid-al-ghadeer
+    EID_AL_GHADIR_DATES_CONFIRMED_YEARS = (2024, 2025)
+    EID_AL_GHADIR_DATES = {
+        2025: (JUN, 15),
+    }
+
+    # https://web.archive.org/web/20240720191242/https://www.timeanddate.com/holidays/iraq/islamic-new-year
+    HIJRI_NEW_YEAR_DATES_CONFIRMED_YEARS = (2013, 2025)
+    HIJRI_NEW_YEAR_DATES = {
+        2013: (NOV, 5),
+        2015: (OCT, 15),
+        2016: (OCT, 3),
+        2017: (SEP, 22),
+        2020: (AUG, 21),
+    }
+
+    # https://web.archive.org/web/20240918050148/https://www.timeanddate.com/holidays/iraq/prophet-birthday
+    MAWLID_DATES_CONFIRMED_YEARS = (2013, 2025)
+    MAWLID_DATES = {
+        2014: (JAN, 14),
+        2016: (DEC, 12),
+        2017: (DEC, 1),
+        2018: (NOV, 21),
+    }

holidays/countries/kazakhstan.py

@@ -13,7 +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
+from holidays.calendars.gregorian import JAN, MAR, APR, MAY, JUL, AUG, SEP, OCT, DEC
 from holidays.calendars.julian import JULIAN_CALENDAR
 from holidays.groups import (
     ChristianHolidays,
@@ -146,27 +146,11 @@ class KAZ(Kazakhstan):
 
 
 class KazakhstanIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2006, 2025)
     EID_AL_ADHA_DATES = {
         2006: (JAN, 10),
-        2007: (DEC, 20),
-        2008: (DEC, 8),
-        2009: (NOV, 27),
-        2010: (NOV, 16),
-        2011: (NOV, 6),
-        2012: (OCT, 26),
-        2013: (OCT, 15),
-        2014: (OCT, 4),
         2015: (SEP, 24),
         2016: (SEP, 12),
-        2017: (SEP, 1),
-        2018: (AUG, 21),
-        2019: (AUG, 11),
-        2020: (JUL, 31),
-        2021: (JUL, 20),
-        2022: (JUL, 9),
-        2023: (JUN, 28),
-        2024: (JUN, 16),
-        2025: (JUN, 6),
     }
 
 

holidays/countries/kenya.py

@@ -174,32 +174,26 @@ class KenyaHinduHolidays(_CustomHinduHolidays):
 
 
 class KenyaIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2014, 2024)
     EID_AL_ADHA_DATES = {
         2014: (OCT, 6),
         2015: (SEP, 24),
         2016: (SEP, 12),
-        2017: (SEP, 1),
-        2018: (AUG, 21),
         2019: (AUG, 12),
-        2020: (JUL, 31),
-        2021: (JUL, 20),
         2022: (JUL, 11),
-        2023: (JUN, 28),
         2024: (JUN, 17),
     }
 
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2014, 2024)
     EID_AL_FITR_DATES = {
         2014: (JUL, 29),
         2015: (JUL, 18),
         2016: (JUL, 7),
         2017: (JUN, 26),
-        2018: (JUN, 15),
         2019: (JUN, 5),
         2020: (MAY, 25),
         2021: (MAY, 14),
         2022: (MAY, 3),
-        2023: (APR, 21),
-        2024: (APR, 10),
     }
 
 

holidays/countries/kiribati.py

@@ -0,0 +1,124 @@
+#  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.observed_holiday_base import (
+    ObservedHolidayBase,
+    SAT_SUN_TO_NEXT_MON,
+    SAT_SUN_TO_NEXT_MON_TUE,
+)
+
+
+class Kiribati(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
+    """Kiribati holidays.
+
+    References:
+        * [Public Holidays Ordinance](https://web.archive.org/web/20250130150749/https://www.paclii.org/ki/legis/consol_act/pho216/)
+        * [Public Holidays (Amendment) Act 2002](https://web.archive.org/web/20250130161614/https://www.paclii.org/ki/legis/num_act/pha2002243/)
+        * [Public Holidays Act Consolidated](https://web.archive.org/web/20250404213705/https://www.paclii.org/ki/legis/consol_act/pho216.pdf)
+
+    Note:
+        The 2025 holidays list for Kiribati
+        (http://web.archive.org/web/20250808191339/https://www.pso.gov.ki/kiribati-national-public-holidays-2025/)
+        mentions the following holidays even though they do not appear in the law:
+        Labor Day, National Culture and Senior Citizens Day, National Police Day, and World
+        Teachers' Day.
+
+        Additionally, the list shows that traditional holidays (International Women's Day,
+        Labor Day, Gospel Day, and Human Rights and Peace Day) were celebrated on different
+        dates than usual, seemingly shifting Thursday/Saturday holidays to the adjacent Friday.
+        No legal provision or start year was cited for this adjustment.
+    """
+
+    country = "KI"
+    observed_label = "%s (observed)"
+    start_year = 1980
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        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("New Year's Day"))
+
+        if self._year >= 2003:
+            # International Women's Day.
+            self._add_observed(self._add_womens_day("International Women's Day"))
+
+        # Good Friday.
+        self._add_good_friday("Good Friday")
+
+        if self._year <= 2002:
+            # Holy Saturday.
+            self._add_holy_saturday("Holy Saturday")
+
+        # Easter Monday.
+        self._add_easter_monday("Easter Monday")
+
+        if self._year >= 2003:
+            # National Health Day.
+            self._add_observed(self._add_holiday_apr_19("National Health Day"))
+
+        if 1993 <= self._year <= 2002:
+            # Public Holiday.
+            self._add_observed(self._add_holiday_may_9("Public Holiday"))
+
+        if self._year >= 2002:
+            # Gospel Day.
+            self._add_holiday_jul_11("Gospel Day")
+
+        if self._year >= 1993:
+            # National Day - Independence Anniversary.
+            self._add_observed(self._add_holiday_jul_12("National Day - Independence Anniversary"))
+
+        if self._year >= 2002:
+            # National Day (in honor of Unimwane).
+            self._add_holiday_jul_15("National Day (in honor of Unimwane)")
+            # National Day (in honor of Unaine).
+            self._add_observed(self._add_holiday_jul_16("National Day (in honor of Unaine)"))
+
+        if self._year <= 2002:
+            # Public Holiday.
+            self._add_holiday_1st_mon_of_aug("Public Holiday")
+        else:
+            # Youth Day.
+            self._add_observed(self._add_holiday_aug_5("Youth Day"))
+
+        if self._year <= 1992:
+            # Public Holiday.
+            self._add_observed(self._add_holiday_nov_10("Public Holiday"))
+
+        if self._year >= 1993:
+            # Human Rights and Peace Day.
+            name = "Human Rights and Peace Day"
+            self._add_observed(
+                self._add_holiday_dec_9(name)
+                if self._year >= 2003
+                else self._add_holiday_dec_10(name)
+            )
+
+        # Christmas Day.
+        self._add_observed(self._add_christmas_day("Christmas Day"), rule=SAT_SUN_TO_NEXT_MON_TUE)
+
+        # Boxing Day.
+        self._add_observed(self._add_christmas_day_two("Boxing Day"), rule=SAT_SUN_TO_NEXT_MON_TUE)
+
+
+class KI(Kiribati):
+    pass
+
+
+class KIR(Kiribati):
+    pass

holidays/countries/kyrgyzstan.py

@@ -23,6 +23,8 @@ class Kyrgyzstan(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicH
     """
 
     country = "KG"
+    # %s (estimated).
+    estimated_label = "%s (estimated)"
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
         """