holidays 0.67__py3-none-any.whl → 0.69__py3-none-any.whl

holidays/countries/indonesia.py

@@ -20,6 +20,7 @@ from holidays.calendars import (
 from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
 from holidays.constants import GOVERNMENT, PUBLIC
 from holidays.groups import (
+    BalineseSakaCalendarHolidays,
     BuddhistCalendarHolidays,
     ChineseCalendarHolidays,
     ChristianHolidays,
@@ -32,6 +33,7 @@ from holidays.observed_holiday_base import ObservedHolidayBase
 
 class Indonesia(
     ObservedHolidayBase,
+    BalineseSakaCalendarHolidays,
     BuddhistCalendarHolidays,
     ChineseCalendarHolidays,
     ChristianHolidays,
@@ -44,10 +46,8 @@ class Indonesia(
     - https://en.wikipedia.org/wiki/Public_holidays_in_Indonesia
     - https://id.wikipedia.org/wiki/Hari_libur_di_Indonesia
     - https://www.liburnasional.com/sejarah/
-    - https://id.wikipedia.org/wiki/Indonesia_dalam_tahun_1963 (1963-2024)
+    - https://id.wikipedia.org/wiki/Indonesia_dalam_tahun_1963 (1963-2025)
     - https://www.timeanddate.com/holidays/indonesia
-    - https://en.wikipedia.org/wiki/Nyepi
-    - https://bali.com/bali/travel-guide/culture/nyepi-balinese-new-year/
     """
 
     country = "ID"
@@ -62,12 +62,19 @@ class Indonesia(
     supported_categories = (GOVERNMENT, PUBLIC)
     start_year = 1946
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        :param islamic_show_estimated:
+            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        """
+        BalineseSakaCalendarHolidays.__init__(self)
         BuddhistCalendarHolidays.__init__(self, cls=IndonesiaBuddhistHolidays, show_estimated=True)
         ChineseCalendarHolidays.__init__(self, cls=IndonesiaChineseHolidays, show_estimated=True)
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self, cls=IndonesiaIslamicHolidays)
+        IslamicHolidays.__init__(
+            self, cls=IndonesiaIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, cls=IndonesiaStaticHolidays)
         super().__init__(*args, **kwargs)
 
@@ -148,59 +155,8 @@ class Indonesia(
 
         # Keputusan Presiden no 3 tahun 1983. (1983-01-19; Added Nationally)
         if self._year >= 1983:
-            dates_obs = {
-                1983: (MAR, 15),
-                1984: (MAR, 4),
-                1985: (MAR, 22),
-                1986: (MAR, 12),
-                1987: (MAR, 31),
-                1988: (MAR, 19),
-                1989: (MAR, 9),
-                1990: (MAR, 27),
-                1991: (MAR, 17),
-                1992: (MAR, 5),
-                1993: (MAR, 24),
-                1994: (MAR, 12),
-                1995: (APR, 1),
-                1996: (MAR, 21),
-                1997: (APR, 9),
-                1998: (MAR, 29),
-                1999: (MAR, 18),
-                2000: (APR, 4),
-                2001: (MAR, 25),
-                2002: (APR, 13),
-                2003: (APR, 2),
-                2004: (MAR, 22),
-                2005: (MAR, 11),
-                2006: (MAR, 30),
-                2007: (MAR, 19),
-                2008: (MAR, 7),
-                2009: (MAR, 26),
-                2010: (MAR, 16),
-                2011: (MAR, 5),
-                2012: (MAR, 23),
-                2013: (MAR, 12),
-                2014: (MAR, 31),
-                2015: (MAR, 21),
-                2016: (MAR, 9),
-                2017: (MAR, 28),
-                2018: (MAR, 17),
-                2019: (MAR, 7),
-                2020: (MAR, 25),
-                2021: (MAR, 14),
-                2022: (MAR, 3),
-                2023: (MAR, 22),
-                2024: (MAR, 11),
-                2025: (MAR, 29),
-                2026: (MAR, 19),
-                2027: (MAR, 8),
-                2028: (MAR, 26),
-                2029: (MAR, 15),
-                2030: (MAR, 5),
-            }
-            if self._year in dates_obs:
-                # Day of Silence.
-                self._add_holiday(tr("Hari Suci Nyepi"), dates_obs[self._year])
+            # Day of Silence.
+            self._add_nyepi(tr("Hari Suci Nyepi"))
 
             # Vesak Day.
             self._add_vesak(tr("Hari Raya Waisak"))

holidays/countries/iran.py

@@ -50,8 +50,14 @@ class Iran(HolidayBase, IslamicHolidays, PersianCalendarHolidays):
     start_year = 1980
     weekend = {FRI}
 
-    def __init__(self, *args, **kwargs):
-        IslamicHolidays.__init__(self, IranIslamicHolidays)
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        :param islamic_show_estimated:
+            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        """
+        IslamicHolidays.__init__(
+            self, cls=IranIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         PersianCalendarHolidays.__init__(self)
         super().__init__(*args, **kwargs)
 

holidays/countries/jordan.py

@@ -30,10 +30,14 @@ class Jordan(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolid
     estimated_label = tr("(تقدير) %s")
     supported_languages = ("ar", "en_US")
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        :param islamic_show_estimated:
+            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        """
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self)
+        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):

holidays/countries/kazakhstan.py

@@ -92,10 +92,16 @@ class Kazakhstan(
     # Kazakhstan declared its sovereignty on 25 October 1990.
     start_year = 1991
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        :param islamic_show_estimated:
+            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        """
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self, KazakhstanIslamicHolidays)
+        IslamicHolidays.__init__(
+            self, cls=KazakhstanIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, KazakhstanStaticHolidays)
         kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_WORKDAY)
         kwargs.setdefault("observed_since", 2002)

holidays/countries/kenya.py

@@ -10,65 +10,140 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.calendars.gregorian import FEB, APR, AUG, SEP
-from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
-from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON, SUN_TO_NEXT_TUE
-
-
-class Kenya(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
+from gettext import gettext as tr
+
+from holidays.calendars import _CustomHinduHolidays, _CustomIslamicHolidays
+from holidays.calendars.gregorian import FEB, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV
+from holidays.constants import HINDU, ISLAMIC, PUBLIC
+from holidays.groups import (
+    ChristianHolidays,
+    HinduCalendarHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+    StaticHolidays,
+)
+from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_WORKDAY
+
+
+class Kenya(
+    ObservedHolidayBase,
+    ChristianHolidays,
+    HinduCalendarHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+    StaticHolidays,
+):
     """
-    https://en.wikipedia.org/wiki/Public_holidays_in_Kenya
-    http://kenyaembassyberlin.de/Public-Holidays-in-Kenya.48.0.html
-    https://www.officeholidays.com/holidays/kenya/moi-day
+    References:
+        - https://en.wikipedia.org/wiki/Public_holidays_in_Kenya
+        - `Public Holidays Act Cap. 110 <https://new.kenyalaw.org/akn/ke/act/1912/21/eng@2024-04-26>`_
+        - `Constitution of Kenya (Art. 9) <https://new.kenyalaw.org/akn/ke/act/2010/constitution/eng@2010-09-03#chp_Two__sec_9>`_
     """
 
     country = "KE"
-    observed_label = "%s (observed)"
-    start_year = 1963
-
-    def __init__(self, *args, **kwargs):
+    default_language = "en_KE"
+    # %s (estimated).
+    estimated_label = tr("%s (estimated)")
+    # %s (observed).
+    observed_label = tr("%s (observed)")
+    # %s (observed, estimated).
+    observed_estimated_label = tr("%s (observed, estimated)")
+    supported_categories = (HINDU, ISLAMIC, PUBLIC)
+    supported_languages = ("en_KE", "en_US", "sw")
+    # Kenya gained independence on December 12, 1963.
+    start_year = 1964
+
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        :param islamic_show_estimated:
+            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        """
         ChristianHolidays.__init__(self)
+        HinduCalendarHolidays.__init__(self, cls=KenyaHinduHolidays)
         InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=KenyaIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, cls=KenyaStaticHolidays)
-        kwargs.setdefault("observed_rule", SUN_TO_NEXT_MON)
+        kwargs.setdefault("observed_rule", SUN_TO_NEXT_WORKDAY)
+        kwargs.setdefault("observed_since", 1985)
         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"))
+        dts_observed = set()
+
+        # New Year's Day.
+        dts_observed.add(self._add_new_years_day(tr("New Year's Day")))
+
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # Easter Monday.
+        self._add_easter_monday(tr("Easter Monday"))
+
+        # Labor Day.
+        dts_observed.add(self._add_labor_day(tr("Labour Day")))
+
+        if self._year >= 2011:
+            # Madaraka Day.
+            dts_observed.add(self._add_holiday_jun_1(tr("Madaraka Day")))
+
+        if 1990 <= self._year <= 2009 or self._year >= 2018:
+            if self._year >= 2025:
+                # Mazingira Day.
+                name = tr("Mazingira Day")
+            elif self._year >= 2021:
+                # Utamaduni Day.
+                name = tr("Utamaduni Day")
+            else:
+                # Moi Day.
+                name = tr("Moi Day")
+            dts_observed.add(self._add_holiday_oct_10(name))
+
+        dts_observed.add(
+            self._add_holiday_oct_20(
+                # Mashujaa Day.
+                tr("Mashujaa Day")
+                if self._year >= 2011
+                # Kenyatta Day.
+                else tr("Kenyatta Day")
+            )
+        )
 
-        # Good Friday
-        self._add_good_friday("Good Friday")
+        dts_observed.add(
+            self._add_holiday_dec_12(
+                # Jamhuri Day.
+                tr("Jamhuri Day")
+                if self._year >= 2011
+                # Independence Day.
+                else tr("Independence Day")
+            )
+        )
 
-        # Easter Monday
-        self._add_easter_monday("Easter Monday")
+        # Christmas Day.
+        dts_observed.add(self._add_christmas_day(tr("Christmas Day")))
 
-        # Labour Day
-        self._add_observed(self._add_labor_day("Labour Day"))
+        # Boxing Day.
+        dts_observed.add(self._add_christmas_day_two(tr("Boxing Day")))
 
-        if self._year >= 2010:
-            # Mandaraka Day
-            self._add_observed(self._add_holiday_jun_1("Madaraka Day"))
+        # Eid-al-Fitr.
+        dts_observed.update(self._add_eid_al_fitr_day(tr("Idd-ul-Fitr")))
 
-        if 2002 <= self._year <= 2009 or self._year >= 2018:
-            self._add_observed(
-                # Utamaduni/Moi Day
-                self._add_holiday_oct_10("Utamaduni Day" if self._year >= 2021 else "Moi Day")
-            )
+        if self.observed:
+            self._populate_observed(dts_observed)
 
-        self._add_observed(
-            # Mashuja/Kenyatta Day
-            self._add_holiday_oct_20("Mashujaa Day" if self._year >= 2010 else "Kenyatta Day")
-        )
+    def _populate_hindu_holidays(self):
+        """Additional Hindu public holidays."""
 
-        # Jamhuri Day
-        self._add_observed(self._add_holiday_dec_12("Jamhuri Day"))
+        if self._year >= 1984:
+            # Diwali.
+            self._add_diwali(tr("Diwali"))
 
-        # Christmas Day
-        self._add_observed(self._add_christmas_day("Christmas Day"), rule=SUN_TO_NEXT_TUE)
+    def _populate_islamic_holidays(self):
+        """Additional Islamic public holidays."""
 
-        # Boxing Day
-        self._add_observed(self._add_christmas_day_two("Boxing Day"))
+        # Eid-al-Adha.
+        self._add_eid_al_adha_day(tr("Idd-ul-Azha"))
 
 
 class KE(Kenya):
@@ -79,15 +154,102 @@ class KEN(Kenya):
     pass
 
 
+class KenyaHinduHolidays(_CustomHinduHolidays):
+    DIWALI_DATES = {
+        2014: (OCT, 22),
+        2015: (NOV, 10),
+        2016: (OCT, 29),
+        2017: (OCT, 18),
+        2018: (NOV, 6),
+        2019: (OCT, 28),
+        2020: (NOV, 14),
+        2021: (NOV, 4),
+        2022: (OCT, 24),
+        2023: (NOV, 12),
+        2024: (OCT, 31),
+    }
+
+
+class KenyaIslamicHolidays(_CustomIslamicHolidays):
+    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 = {
+        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),
+    }
+
+
 class KenyaStaticHolidays:
+    """
+    References:
+        - https://new.kenyalaw.org/akn/ke/officialGazette/2015-11-24/129/eng@2015-11-24
+        - https://new.kenyalaw.org/akn/ke/officialGazette/2017-08-01/107/eng@2017-08-01
+        - https://new.kenyalaw.org/akn/ke/officialGazette/2017-10-19/156/eng@2017-10-19
+        - https://new.kenyalaw.org/akn/ke/officialGazette/2017-10-24/159/eng@2017-10-24
+        - https://new.kenyalaw.org/akn/ke/officialGazette/2017-11-23/174/eng@2017-11-23
+        - https://new.kenyalaw.org/akn/ke/officialGazette/gazette/2022-07-29/147/eng@2022-07-29
+        - https://new.kenyalaw.org/akn/ke/officialGazette/gazette/2022-09-08/182/eng@2022-09-08
+        - https://new.kenyalaw.org/akn/ke/officialGazette/gazette/2023-11-06/238/eng@2023-11-06
+        - https://new.kenyalaw.org/akn/ke/officialGazette/gazette/2024-05-08/61/eng@2024-05-08
+        - https://new.kenyalaw.org/akn/ke/officialGazette/2024-10-31/184/eng@2024-10-31
+    """
+
+    # Election Day.
+    election_day = tr("Election Day")
+
+    # Inauguration Day.
+    inauguration_day = tr("Inauguration Day")
+
+    # Day of Mourning for Queen Elizabeth II.
+    mourning_for_queen_elizabeth = tr("Day of Mourning for Queen Elizabeth II")
+
+    # National Tree Growing Day.
+    national_tree_growing_day = tr("National Tree Growing Day")
+
     special_public_holidays = {
-        2020: (FEB, 11, "President Moi Celebration of Life Day"),
+        # Visit of Pope Francis to Kenya.
+        2015: (NOV, 26, tr("Visit of Pope Francis to Kenya")),
+        2017: (
+            (AUG, 8, election_day),
+            (OCT, 25, election_day),
+            (OCT, 26, election_day),
+            (NOV, 28, inauguration_day),
+        ),
+        # President Moi Memorial Day.
+        2020: (FEB, 11, tr("President Moi Memorial Day")),
         2022: (
-            (APR, 29, "State Funeral for Former President Mwai Kibaki"),
-            (AUG, 9, "Election Day"),
-            (SEP, 10, "Day of Mourning for Queen Elizabeth II"),
-            (SEP, 11, "Day of Mourning for Queen Elizabeth II"),
-            (SEP, 12, "Day of Mourning for Queen Elizabeth II"),
-            (SEP, 13, "Inauguration Day"),
+            # State Funeral for Former President Mwai Kibaki.
+            (APR, 29, tr("State Funeral for Former President Mwai Kibaki")),
+            (AUG, 9, election_day),
+            (SEP, 10, mourning_for_queen_elizabeth),
+            (SEP, 11, mourning_for_queen_elizabeth),
+            (SEP, 12, mourning_for_queen_elizabeth),
+            (SEP, 13, inauguration_day),
+        ),
+        2023: (NOV, 13, national_tree_growing_day),
+        2024: (
+            (MAY, 10, national_tree_growing_day),
+            (NOV, 1, inauguration_day),
         ),
     }

holidays/countries/kuwait.py

@@ -31,9 +31,13 @@ class Kuwait(HolidayBase, InternationalHolidays, IslamicHolidays):
     estimated_label = tr("(تقدير) %s")
     supported_languages = ("ar", "en_US")
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        :param islamic_show_estimated:
+            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        """
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self)
+        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):

holidays/countries/kyrgyzstan.py

@@ -25,10 +25,14 @@ class Kyrgyzstan(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicH
 
     country = "KG"
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        :param islamic_show_estimated:
+            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        """
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self)
+        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):