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

holidays/groups/hebrew.py

@@ -12,10 +12,10 @@
 
 from collections.abc import Iterable
 from datetime import date
-from typing import Optional, Union
+from typing import Union
 
-from holidays.calendars import _HebrewLunisolar
 from holidays.calendars.gregorian import _timedelta
+from holidays.calendars.hebrew import _HebrewLunisolar
 
 
 class HebrewCalendarHolidays:
@@ -29,15 +29,16 @@ class HebrewCalendarHolidays:
     def _add_hebrew_calendar_holiday(
         self, name: str, holiday_date: date, days_delta: Union[int, Iterable[int]] = 0
     ) -> set[date]:
-        added_dates = set()
-        for delta in (days_delta,) if isinstance(days_delta, int) else days_delta:
-            if dt := self._add_holiday(name, _timedelta(holiday_date, delta)):
-                added_dates.add(dt)
-        return added_dates
+        """
+        Add Hebrew calendar holiday.
+        """
+        return {
+            dt
+            for delta in ((days_delta,) if isinstance(days_delta, int) else days_delta)
+            if (dt := self._add_holiday(name, _timedelta(holiday_date, delta)))
+        }
 
-    def _add_hanukkah(
-        self, name: str, days_delta: Union[int, Iterable[int]] = 0
-    ) -> set[Optional[date]]:
+    def _add_hanukkah(self, name: str, days_delta: Union[int, Iterable[int]] = 0) -> set[date]:
         """
         Add Hanukkah.
         In some Gregorian years, there may be two Hanukkah dates.
@@ -46,10 +47,11 @@ class HebrewCalendarHolidays:
         and subsequent rededication of the Second Temple.
         https://en.wikipedia.org/wiki/Hanukkah
         """
-        dts = self._hebrew_calendar.hanukkah_date(self._year)
-        for dt in dts:
-            self._add_hebrew_calendar_holiday(name, dt, days_delta)  # type: ignore[arg-type]
-        return dts
+        return {
+            dt
+            for hanukkah_dt in self._hebrew_calendar.hanukkah_date(self._year)
+            for dt in self._add_hebrew_calendar_holiday(name, hanukkah_dt, days_delta)
+        }
 
     def _add_lag_baomer(self, name: str, days_delta: Union[int, Iterable[int]] = 0) -> set[date]:
         """

holidays/groups/hindu.py

@@ -14,7 +14,7 @@ from collections.abc import Iterable
 from datetime import date
 from typing import Optional
 
-from holidays.calendars import _HinduLunisolar
+from holidays.calendars.hindu import _HinduLunisolar
 from holidays.groups.eastern import EasternCalendarHolidays
 
 
@@ -50,14 +50,9 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
         Adds customizable estimation label to holiday name if holiday date
         is an estimation.
         """
-        added_dates = set()
-        for dt_estimated in dts_estimated:
-            if dt := self._add_eastern_calendar_holiday(
-                name, dt_estimated, self._hindu_calendar_show_estimated, days_delta=days_delta
-            ):
-                added_dates.add(dt)
-
-        return added_dates
+        return self._add_eastern_calendar_holiday_set(
+            name, dts_estimated, self._hindu_calendar_show_estimated, days_delta
+        )
 
     def _add_bhai_dooj(self, name) -> Optional[date]:
         """
@@ -162,11 +157,18 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
 
     def _add_gudi_padwa(self, name) -> Optional[date]:
         """
-        Add Gudi Padwa.
+        Add Gudi Padwa / Ugadi.
+
+        Gudi Padwa is the traditional New Year festival celebrated in
+        Maharashtra. On the same day, the festival is also observed as
+        Ugadi in Karnataka, Telangana, and Andhra Pradesh.
+
+        It falls on the first day of Chaitra (March–April) according to
+        the Hindu lunisolar calendar.
 
-        Gudi Padwa is the traditional New Year festival for Maharashtrians.
-        It falls on the first day of Chaitra (March-April).
-        https://en.wikipedia.org/wiki/Gudi_Padwa
+        References:
+            * https://en.wikipedia.org/wiki/Gudi_Padwa
+            * https://en.wikipedia.org/wiki/Ugadi
         """
         return self._add_hindu_calendar_holiday(
             name, self._hindu_calendar.gudi_padwa_date(self._year)

holidays/groups/islamic.py

@@ -13,7 +13,7 @@
 from collections.abc import Iterable
 from datetime import date
 
-from holidays.calendars import _IslamicLunar
+from holidays.calendars.islamic import _IslamicLunar
 from holidays.groups.eastern import EasternCalendarHolidays
 
 
@@ -35,7 +35,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Ali_al-Rida
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.ali_al_rida_death_dates(self._year)
         )
 
@@ -45,7 +45,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Ali
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.ali_birthday_dates(self._year)
         )
 
@@ -55,7 +55,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Ali
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.ali_death_dates(self._year)
         )
 
@@ -65,7 +65,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Arbaeen
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.arbaeen_dates(self._year)
         )
 
@@ -78,7 +78,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         Arafat.
         https://en.wikipedia.org/wiki/Day_of_Arafah
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_adha_dates(self._year), days_delta=-1
         )
 
@@ -90,7 +90,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         10th of Muharram, the first month of the Islamic calendar.
         https://en.wikipedia.org/wiki/Ashura
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.ashura_dates(self._year)
         )
 
@@ -102,7 +102,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         10th of Muharram, the first month of the Islamic calendar.
         https://en.wikipedia.org/wiki/Ashura
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.ashura_dates(self._year), days_delta=-1
         )
 
@@ -115,7 +115,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         to Allah's command.
         https://en.wikipedia.org/wiki/Eid_al-Adha
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_adha_dates(self._year)
         )
 
@@ -125,7 +125,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Eid_al-Adha
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_adha_dates(self._year), days_delta=+1
         )
 
@@ -135,7 +135,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Eid_al-Adha
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_adha_dates(self._year), days_delta=+2
         )
 
@@ -145,7 +145,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Eid_al-Adha
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_adha_dates(self._year), days_delta=+3
         )
 
@@ -158,7 +158,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         dawn-to-sunset fasting of Ramadan.
         https://en.wikipedia.org/wiki/Eid_al-Fitr
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_fitr_dates(self._year)
         )
 
@@ -168,7 +168,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Eid_al-Fitr
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+1
         )
 
@@ -178,17 +178,27 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Eid_al-Fitr
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+2
         )
 
+    def _add_eid_al_fitr_day_four(self, name) -> set[date]:
+        """
+        Add Eid al-Fitr Day Four.
+
+        https://en.wikipedia.org/wiki/Eid_al-Fitr
+        """
+        return self._add_islamic_calendar_holiday_set(
+            name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+3
+        )
+
     def _add_eid_al_fitr_eve(self, name) -> set[date]:
         """
         Add Eid al-Fitr Eve (last day of 9th month of Islamic calendar).
 
         https://en.wikipedia.org/wiki/Eid_al-Fitr
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=-1
         )
 
@@ -198,7 +208,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Eid_al-Ghadeer
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.eid_al_ghadir_dates(self._year)
         )
 
@@ -208,7 +218,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Fatima
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.fatima_death_dates(self._year)
         )
 
@@ -218,7 +228,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Grand_Magal_of_Touba
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.grand_magal_of_touba_dates(self._year)
         )
 
@@ -228,7 +238,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://web.archive.org/web/20241202170507/https://publicholidays.com.my/hari-hol-almarhum-sultan-iskandar/
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.hari_hol_johor_dates(self._year)
         )
 
@@ -238,7 +248,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Hasan_al-Askari
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.hasan_al_askari_death_dates(self._year)
         )
 
@@ -248,7 +258,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://web.archive.org/web/20250323065556/https://decree.om/2022/rd20220088/
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.ramadan_beginning_dates(self._year), days_delta=+28
         )
 
@@ -258,12 +268,12 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Muhammad_al-Mahdi
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.imam_mahdi_birthday_dates(self._year)
         )
 
-    def _add_islamic_calendar_holiday(
-        self, name: str, dates: Iterable[tuple[date, bool]], days_delta: int = 0
+    def _add_islamic_calendar_holiday_set(
+        self, name: str, dts_estimated: Iterable[tuple[date, bool]], days_delta: int = 0
     ) -> set[date]:
         """
         Add lunar calendar holiday.
@@ -271,14 +281,9 @@ class IslamicHolidays(EasternCalendarHolidays):
         Appends customizable estimation label at the end of holiday name if
         holiday date is an estimation.
         """
-        added_dates = set()
-        for dts in dates:
-            if dt := self._add_eastern_calendar_holiday(
-                name, dts, self._islamic_calendar_show_estimated, days_delta
-            ):
-                added_dates.add(dt)
-
-        return added_dates
+        return self._add_eastern_calendar_holiday_set(
+            name, dts_estimated, self._islamic_calendar_show_estimated, days_delta
+        )
 
     def _add_islamic_new_year_day(self, name) -> set[date]:
         """
@@ -290,7 +295,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         observed by most Muslims on the first day of the month of Muharram.
         https://en.wikipedia.org/wiki/Islamic_New_Year
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.hijri_new_year_dates(self._year)
         )
 
@@ -301,7 +306,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         The Prophet's Ascension.
         https://en.wikipedia.org/wiki/Isra'_and_Mi'raj
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.isra_and_miraj_dates(self._year)
         )
 
@@ -312,7 +317,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         The Night of Power.
         https://en.wikipedia.org/wiki/Night_of_Power
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.laylat_al_qadr_dates(self._year)
         )
 
@@ -322,7 +327,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Islam_in_Maldives
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.maldives_embraced_islam_day_dates(self._year)
         )
 
@@ -334,7 +339,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         Muhammad.
         https://en.wikipedia.org/wiki/Mawlid
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.mawlid_dates(self._year)
         )
 
@@ -346,7 +351,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         Muhammad.
         https://en.wikipedia.org/wiki/Mawlid
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.mawlid_dates(self._year), days_delta=+1
         )
 
@@ -359,7 +364,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         the holy Quran.
         https://web.archive.org/web/20241012115752/https://zamzam.com/blog/nuzul-al-quran/
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.nuzul_al_quran_dates(self._year)
         )
 
@@ -376,7 +381,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         ritual akin to Christian baptism.
         https://web.archive.org/web/20240722052111/https://www.officeholidays.com/holidays/mali/prophets-baptism
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.mawlid_dates(self._year), days_delta=+7
         )
 
@@ -386,7 +391,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Hasan_ibn_Ali
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.prophet_death_dates(self._year)
         )
 
@@ -396,7 +401,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Qaumee_Dhuvas_(Maldives_National_Day)
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.quamee_dhuvas_dates(self._year)
         )
 
@@ -408,7 +413,7 @@ class IslamicHolidays(EasternCalendarHolidays):
         worldwide as a month of fasting, prayer, reflection, and community
         https://en.wikipedia.org/wiki/Ramadan
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.ramadan_beginning_dates(self._year)
         )
 
@@ -418,7 +423,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Ja'far_al-Sadiq
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.sadiq_birthday_dates(self._year)
         )
 
@@ -428,7 +433,7 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Ja'far_al-Sadiq
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.sadiq_death_dates(self._year)
         )
 
@@ -438,6 +443,6 @@ class IslamicHolidays(EasternCalendarHolidays):
 
         https://en.wikipedia.org/wiki/Tasua
         """
-        return self._add_islamic_calendar_holiday(
+        return self._add_islamic_calendar_holiday_set(
             name, self._islamic_calendar.tasua_dates(self._year)
         )

holidays/groups/mongolian.py

@@ -13,7 +13,7 @@
 from datetime import date
 from typing import Optional
 
-from holidays.calendars import _MongolianLunisolar
+from holidays.calendars.mongolian import _MongolianLunisolar
 from holidays.groups.eastern import EasternCalendarHolidays
 
 

holidays/groups/sinhala.py

@@ -14,7 +14,7 @@ from collections.abc import Iterable
 from datetime import date
 from typing import Optional
 
-from holidays.calendars import _SinhalaLunar
+from holidays.calendars.sinhala import _SinhalaLunar
 from holidays.groups.eastern import EasternCalendarHolidays
 
 
@@ -58,14 +58,9 @@ class SinhalaCalendarHolidays(EasternCalendarHolidays):
         Adds customizable estimation label to holiday name if holiday date
         is an estimation.
         """
-        added_dates = set()
-        for dt_estimated in dts_estimated:
-            if dt := self._add_eastern_calendar_holiday(
-                name, dt_estimated, self._sinhala_calendar_show_estimated, days_delta=days_delta
-            ):
-                added_dates.add(dt)
-
-        return added_dates
+        return self._add_eastern_calendar_holiday_set(
+            name, dts_estimated, self._sinhala_calendar_show_estimated, days_delta
+        )
 
     def _add_bak_poya(self, name) -> Optional[date]:
         """

holidays/groups/tibetan.py

@@ -13,7 +13,7 @@
 from datetime import date
 from typing import Optional
 
-from holidays.calendars import _TibetanLunisolar
+from holidays.calendars.tibetan import _TibetanLunisolar
 from holidays.groups.eastern import EasternCalendarHolidays
 
 
@@ -103,14 +103,13 @@ class TibetanCalendarHolidays(EasternCalendarHolidays):
             name, self._tibetan_calendar.losar_date(self._year)
         )
 
-    def _add_losar_day_two(self, name) -> set[date]:
+    def _add_losar_day_two(self, name) -> Optional[date]:
         """
         Add Losar Day Two.
         """
-        dt = self._add_tibetan_calendar_holiday(
+        return self._add_tibetan_calendar_holiday(
             name, self._tibetan_calendar.losar_date(self._year), days_delta=+1
         )
-        return {dt} if dt is not None else set()
 
     def _add_thimphu_drubchen_day(self, name) -> Optional[date]:
         """

holidays/holiday_base.py

@@ -841,6 +841,9 @@ class HolidayBase(dict[date, str]):
         dt = dt if isinstance(dt, date) else date(self._year, *dt)
         return dt.weekday() == weekday
 
+    def _get_weekend(self, dt: date) -> set[int]:
+        return self.weekend
+
     def _is_monday(self, *args) -> bool:
         return self._check_weekday(MON, *args)
 
@@ -869,7 +872,7 @@ class HolidayBase(dict[date, str]):
         """
         dt = args if len(args) > 1 else args[0]
         dt = dt if isinstance(dt, date) else date(self._year, *dt)
-        return dt.weekday() in self.weekend
+        return dt.weekday() in self._get_weekend(dt)
 
     def _populate(self, year: int) -> None:
         """This is a private method that populates (generates and adds) holidays
@@ -1145,9 +1148,7 @@ class HolidayBase(dict[date, str]):
         Returns:
             True if the date's week day is a weekend day, False otherwise.
         """
-        # To prioritize performance we avoid reusing the internal
-        # `HolidayBase._is_weekend` method and perform the check directly instead.
-        return self.__keytransform__(key).weekday() in self.weekend
+        return self._is_weekend(self.__keytransform__(key))
 
     def is_working_day(self, key: DateLike) -> bool:
         """Check if the given date is considered a working day.

holidays/ical.py

@@ -12,9 +12,10 @@
 
 import re
 import uuid
-from datetime import date, datetime, timedelta, timezone
+from datetime import date, datetime, timezone
 from typing import Union
 
+from holidays.calendars.gregorian import _timedelta
 from holidays.holiday_base import HolidayBase
 from holidays.version import __version__
 
@@ -185,16 +186,17 @@ class ICalExporter:
 
         sorted_dates = sorted(self.holidays.keys())
         # Merged continuous holiday with the same name and use `DURATION` instead.
+        n = len(sorted_dates)
         i = 0
-        while i < len(sorted_dates):
+        while i < n:
             dt = sorted_dates[i]
             names = self.holidays.get_list(dt)
 
             for name in names:
                 days = 1
                 while (
-                    i + days < len(sorted_dates)
-                    and sorted_dates[i + days] == sorted_dates[i] + timedelta(days=days)
+                    i + days < n
+                    and sorted_dates[i + days] == _timedelta(sorted_dates[i], days)
                     and name in self.holidays.get_list(sorted_dates[i + days])
                 ):
                     days += 1