holidays 0.57__py3-none-any.whl → 0.59__py3-none-any.whl

holidays/groups/chinese.py

@@ -7,17 +7,18 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from typing import Optional, Tuple
+from typing import Optional
 
 from holidays.calendars import _ChineseLunisolar
-from holidays.calendars.gregorian import APR, _timedelta
+from holidays.calendars.gregorian import APR
+from holidays.groups.eastern import EasternCalendarHolidays
 
 
-class ChineseCalendarHolidays:
+class ChineseCalendarHolidays(EasternCalendarHolidays):
     """
     Chinese lunisolar calendar holidays.
     """
@@ -48,7 +49,7 @@ class ChineseCalendarHolidays:
         return self._chinese_calendar.mid_autumn_date(self._year)[0]
 
     def _add_chinese_calendar_holiday(
-        self, name: str, dt_estimated: Tuple[date, bool], days_delta: int = 0
+        self, name: str, dt_estimated: tuple[Optional[date], bool], days_delta: int = 0
     ) -> Optional[date]:
         """
         Add Chinese calendar holiday.
@@ -56,17 +57,8 @@ class ChineseCalendarHolidays:
         Adds customizable estimation label to holiday name if holiday date
         is an estimation.
         """
-        estimated_label = getattr(self, "estimated_label", "%s (estimated)")
-        dt, is_estimated = dt_estimated
-
-        if days_delta != 0:
-            dt = _timedelta(dt, days_delta)
-
-        return self._add_holiday(
-            self.tr(estimated_label) % self.tr(name)
-            if is_estimated and self._chinese_calendar_show_estimated
-            else name,
-            dt,
+        return self._add_eastern_calendar_holiday(
+            name, dt_estimated, self._chinese_calendar_show_estimated, days_delta
         )
 
     def _add_chinese_birthday_of_buddha(self, name) -> Optional[date]:
@@ -136,16 +128,6 @@ class ChineseCalendarHolidays:
             name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+3
         )
 
-    def _add_chinese_new_years_day_five(self, name) -> Optional[date]:
-        """
-        Add Chinese New Year's Day Five.
-
-        https://en.wikipedia.org/wiki/Chinese_New_Year
-        """
-        return self._add_chinese_calendar_holiday(
-            name, self._chinese_calendar.lunar_new_year_date(self._year), days_delta=+4
-        )
-
     def _add_qingming_festival(self, name) -> date:
         """
         Add Qingming Festival (15th day after the Spring Equinox).

holidays/groups/christian.py

@@ -7,7 +7,7 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
 from datetime import date

holidays/groups/custom.py

@@ -7,7 +7,7 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
 

holidays/groups/eastern.py

@@ -0,0 +1,51 @@
+#  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 AUTHORS 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 typing import Optional
+
+from holidays.calendars.gregorian import _timedelta
+
+
+class EasternCalendarHolidays:
+    """
+    Eastern calendar holidays base class.
+    """
+
+    def _add_eastern_calendar_holiday(
+        self,
+        name: str,
+        dt_estimated: tuple[Optional[date], bool],
+        show_estimated: bool = True,
+        days_delta: int = 0,
+    ) -> Optional[date]:
+        """
+        Add Eastern (Buddhist, Chinese, Hindu, Islamic) calendar holiday.
+
+        Adds customizable estimation label to holiday name if holiday date is an estimation.
+        """
+        estimated_label = getattr(self, "estimated_label", "%s (estimated)")
+        dt, is_estimated = dt_estimated
+
+        if days_delta and dt:
+            dt = _timedelta(dt, days_delta)
+
+        return (
+            self._add_holiday(
+                self.tr(estimated_label) % self.tr(name)
+                if is_estimated and show_estimated
+                else name,
+                dt,
+            )
+            if dt
+            else None
+        )

holidays/groups/hindu.py

@@ -7,16 +7,17 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from typing import Optional, Tuple
+from typing import Optional
 
 from holidays.calendars import _HinduLunisolar
+from holidays.groups.eastern import EasternCalendarHolidays
 
 
-class HinduCalendarHolidays:
+class HinduCalendarHolidays(EasternCalendarHolidays):
     """
     Hindu lunisolar calendar holidays.
     """
@@ -26,7 +27,7 @@ class HinduCalendarHolidays:
         self._hindu_calendar_show_estimated = show_estimated
 
     def _add_hindu_calendar_holiday(
-        self, name: str, dt_estimated: Tuple[date, bool]
+        self, name: str, dt_estimated: tuple[Optional[date], bool]
     ) -> Optional[date]:
         """
         Add Hindu calendar holiday.
@@ -34,14 +35,8 @@ class HinduCalendarHolidays:
         Adds customizable estimation label to holiday name if holiday date
         is an estimation.
         """
-        estimated_label = getattr(self, "estimated_label", "%s (estimated)")
-        dt, is_estimated = dt_estimated
-
-        return self._add_holiday(
-            self.tr(estimated_label) % self.tr(name)
-            if is_estimated and self._hindu_calendar_show_estimated
-            else name,
-            dt,
+        return self._add_eastern_calendar_holiday(
+            name, dt_estimated, self._hindu_calendar_show_estimated
         )
 
     def _add_diwali(self, name) -> Optional[date]:

holidays/groups/international.py

@@ -7,7 +7,7 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
 from datetime import date
@@ -185,15 +185,18 @@ class InternationalHolidays:
         """
         return self._add_holiday_mar_8(name)
 
-    def _add_world_war_two_victory_day(self, name):
+    def _add_world_war_two_victory_day(self, name, is_western=True):
         """
-        Add Victory Day (May 9th)
+        Add Day of Victory in World War II in Europe (May 8).
+        https://en.wikipedia.org/wiki/Victory_in_Europe_Day
 
-        Victory Day is a holiday that commemorates the victory over Nazi
-        Germany in 1945.
+        Some Eastern European countries celebrate Victory Day on May 9.
         https://en.wikipedia.org/wiki/Victory_Day_(9_May)
         """
-        return self._add_holiday_may_9(name)
+        if is_western:
+            return self._add_holiday_may_8(name)
+        else:
+            return self._add_holiday_may_9(name)
 
     def _add_united_nations_day(self, name):
         """

holidays/groups/islamic.py

@@ -7,17 +7,17 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
+from collections.abc import Iterable
 from datetime import date
-from typing import Iterable, Set, Tuple
 
 from holidays.calendars import _IslamicLunar
-from holidays.calendars.gregorian import _timedelta
+from holidays.groups.eastern import EasternCalendarHolidays
 
 
-class IslamicHolidays:
+class IslamicHolidays(EasternCalendarHolidays):
     """
     Islamic holidays.
 
@@ -28,7 +28,7 @@ class IslamicHolidays:
     def __init__(self, cls=None) -> None:
         self._islamic_calendar = cls() if cls else _IslamicLunar()
 
-    def _add_ali_al_rida_death_day(self, name) -> Set[date]:
+    def _add_ali_al_rida_death_day(self, name) -> set[date]:
         """
         Add death of Ali al-Rida day (last (29th or 30th) day of 2nd month).
 
@@ -38,7 +38,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.ali_al_rida_death_dates(self._year)
         )
 
-    def _add_ali_birthday_day(self, name) -> Set[date]:
+    def _add_ali_birthday_day(self, name) -> set[date]:
         """
         Add birthday of Ali ibn Abu Talib day (13th day of 7th month).
 
@@ -48,7 +48,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.ali_birthday_dates(self._year)
         )
 
-    def _add_ali_death_day(self, name) -> Set[date]:
+    def _add_ali_death_day(self, name) -> set[date]:
         """
         Add death of Ali ibn Abu Talib day (21st day of 9th month).
 
@@ -58,7 +58,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.ali_death_dates(self._year)
         )
 
-    def _add_arbaeen_day(self, name) -> Set[date]:
+    def _add_arbaeen_day(self, name) -> set[date]:
         """
         Add Arbaeen day (20th day of 2nd month).
 
@@ -68,7 +68,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.arbaeen_dates(self._year)
         )
 
-    def _add_arafah_day(self, name) -> Set[date]:
+    def _add_arafah_day(self, name) -> set[date]:
         """
         Add Day of Arafah (9th day of 12th month).
 
@@ -81,7 +81,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_adha_dates(self._year), days_delta=-1
         )
 
-    def _add_ashura_day(self, name) -> Set[date]:
+    def _add_ashura_day(self, name) -> set[date]:
         """
         Add Ashura Day (10th day of 1st month).
 
@@ -93,7 +93,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.ashura_dates(self._year)
         )
 
-    def _add_ashura_eve(self, name) -> Set[date]:
+    def _add_ashura_eve(self, name) -> set[date]:
         """
         Add Ashura Eve (Day before the 10th day of 1st month).
 
@@ -105,7 +105,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.ashura_dates(self._year), days_delta=-1
         )
 
-    def _add_eid_al_adha_day(self, name) -> Set[date]:
+    def _add_eid_al_adha_day(self, name) -> set[date]:
         """
         Add Eid al-Adha Day (10th day of the 12th month of Islamic calendar).
 
@@ -118,7 +118,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_adha_dates(self._year)
         )
 
-    def _add_eid_al_adha_day_two(self, name) -> Set[date]:
+    def _add_eid_al_adha_day_two(self, name) -> set[date]:
         """
         Add Eid al-Adha Day Two.
 
@@ -128,7 +128,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_adha_dates(self._year), days_delta=+1
         )
 
-    def _add_eid_al_adha_day_three(self, name) -> Set[date]:
+    def _add_eid_al_adha_day_three(self, name) -> set[date]:
         """
         Add Eid al-Adha Day Three.
 
@@ -138,7 +138,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_adha_dates(self._year), days_delta=+2
         )
 
-    def _add_eid_al_adha_day_four(self, name) -> Set[date]:
+    def _add_eid_al_adha_day_four(self, name) -> set[date]:
         """
         Add Eid al-Adha Day Four.
 
@@ -148,7 +148,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_adha_dates(self._year), days_delta=+3
         )
 
-    def _add_eid_al_fitr_day(self, name) -> Set[date]:
+    def _add_eid_al_fitr_day(self, name) -> set[date]:
         """
         Add Eid al-Fitr Day (1st day of 10th month of Islamic calendar).
 
@@ -161,7 +161,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_fitr_dates(self._year)
         )
 
-    def _add_eid_al_fitr_day_two(self, name) -> Set[date]:
+    def _add_eid_al_fitr_day_two(self, name) -> set[date]:
         """
         Add Eid al-Fitr Day Two.
 
@@ -171,7 +171,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+1
         )
 
-    def _add_eid_al_fitr_day_three(self, name) -> Set[date]:
+    def _add_eid_al_fitr_day_three(self, name) -> set[date]:
         """
         Add Eid al-Fitr Day Three.
 
@@ -181,7 +181,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+2
         )
 
-    def _add_eid_al_fitr_day_four(self, name) -> Set[date]:
+    def _add_eid_al_fitr_day_four(self, name) -> set[date]:
         """
         Add Eid al-Fitr Day Four.
 
@@ -191,7 +191,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+3
         )
 
-    def _add_eid_al_fitr_eve(self, name) -> Set[date]:
+    def _add_eid_al_fitr_eve(self, name) -> set[date]:
         """
         Add Eid al-Fitr Eve (last day of 9th month of Islamic calendar).
 
@@ -201,7 +201,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=-1
         )
 
-    def _add_eid_al_ghadir_day(self, name) -> Set[date]:
+    def _add_eid_al_ghadir_day(self, name) -> set[date]:
         """
         Add Eid al-Ghadir Day (18th day of 12th month).
 
@@ -211,7 +211,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.eid_al_ghadir_dates(self._year)
         )
 
-    def _add_fatima_death_day(self, name) -> Set[date]:
+    def _add_fatima_death_day(self, name) -> set[date]:
         """
         Add death of Fatima day (3rd day of 6th month).
 
@@ -221,7 +221,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.fatima_death_dates(self._year)
         )
 
-    def _add_hari_hol_johor(self, name) -> Set[date]:
+    def _add_hari_hol_johor(self, name) -> set[date]:
         """
         Hari Hol Johor.
 
@@ -231,7 +231,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.hari_hol_johor_dates(self._year)
         )
 
-    def _add_hasan_al_askari_death_day(self, name) -> Set[date]:
+    def _add_hasan_al_askari_death_day(self, name) -> set[date]:
         """
         Add death of Hasan_al-Askari day (8th day of 3rd month).
 
@@ -241,7 +241,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.hasan_al_askari_death_dates(self._year)
         )
 
-    def _add_imam_mahdi_birthday_day(self, name) -> Set[date]:
+    def _add_imam_mahdi_birthday_day(self, name) -> set[date]:
         """
         Add birthday of Muhammad al-Mahdi day (15th day of 8th month).
 
@@ -252,8 +252,8 @@ class IslamicHolidays:
         )
 
     def _add_islamic_calendar_holiday(
-        self, name: str, dates: Iterable[Tuple[date, bool]], days_delta: int = 0
-    ) -> Set[date]:
+        self, name: str, dates: Iterable[tuple[date, bool]], days_delta: int = 0
+    ) -> set[date]:
         """
         Add lunar calendar holiday.
 
@@ -261,20 +261,13 @@ class IslamicHolidays:
         holiday date is an estimation.
         """
         added_dates = set()
-        estimated_label = getattr(self, "estimated_label", "%s (estimated)")
-        for dt, is_estimated in dates:
-            if days_delta != 0:
-                dt = _timedelta(dt, days_delta)
-
-            dt = self._add_holiday(
-                self.tr(estimated_label) % self.tr(name) if is_estimated else name, dt
-            )
-            if dt:
+        for dts in dates:
+            if dt := self._add_eastern_calendar_holiday(name, dts, days_delta=days_delta):
                 added_dates.add(dt)
 
         return added_dates
 
-    def _add_islamic_new_year_day(self, name) -> Set[date]:
+    def _add_islamic_new_year_day(self, name) -> set[date]:
         """
         Add Islamic New Year Day (last day of Dhu al-Hijjah).
 
@@ -299,7 +292,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.isra_and_miraj_dates(self._year)
         )
 
-    def _add_maldives_embraced_islam_day(self, name) -> Set[date]:
+    def _add_maldives_embraced_islam_day(self, name) -> set[date]:
         """
         Add Maldives Embraced Islam Day (1st day of 4th month).
 
@@ -309,7 +302,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.maldives_embraced_islam_day_dates(self._year)
         )
 
-    def _add_mawlid_day(self, name) -> Set[date]:
+    def _add_mawlid_day(self, name) -> set[date]:
         """
         Add Mawlid Day (12th day of 3rd month).
 
@@ -321,7 +314,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.mawlid_dates(self._year)
         )
 
-    def _add_mawlid_day_two(self, name) -> Set[date]:
+    def _add_mawlid_day_two(self, name) -> set[date]:
         """
         Add Mawlid Day Two.
 
@@ -333,7 +326,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.mawlid_dates(self._year), days_delta=+1
         )
 
-    def _add_nuzul_al_quran_day(self, name) -> Set[date]:
+    def _add_nuzul_al_quran_day(self, name) -> set[date]:
         """
         Add Nuzul Al Quran (17th day of 9th month).
 
@@ -346,7 +339,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.nuzul_al_quran_dates(self._year)
         )
 
-    def _add_prophet_death_day(self, name) -> Set[date]:
+    def _add_prophet_death_day(self, name) -> set[date]:
         """
         Add death of Prophet Muhammad and Hasan ibn Ali day (28th day of 2nd month).
 
@@ -356,7 +349,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.prophet_death_dates(self._year)
         )
 
-    def _add_quamee_dhuvas_day(self, name) -> Set[date]:
+    def _add_quamee_dhuvas_day(self, name) -> set[date]:
         """
         Add Quamee Dhuvas (1st day of 3rd month).
 
@@ -366,7 +359,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.quamee_dhuvas_dates(self._year)
         )
 
-    def _add_ramadan_beginning_day(self, name) -> Set[date]:
+    def _add_ramadan_beginning_day(self, name) -> set[date]:
         """
         Add First Day of Ramadan (1st day of 9th month).
 
@@ -378,7 +371,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.ramadan_beginning_dates(self._year)
         )
 
-    def _add_sadiq_birthday_day(self, name) -> Set[date]:
+    def _add_sadiq_birthday_day(self, name) -> set[date]:
         """
         Add birthday of Prophet Muhammad and Ja'far al-Sadiq day (17th day of 3rd month).
 
@@ -388,7 +381,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.sadiq_birthday_dates(self._year)
         )
 
-    def _add_sadiq_death_day(self, name) -> Set[date]:
+    def _add_sadiq_death_day(self, name) -> set[date]:
         """
         Add death of Ja'far al-Sadiq day (25th day of 10th month).
 
@@ -398,7 +391,7 @@ class IslamicHolidays:
             name, self._islamic_calendar.sadiq_death_dates(self._year)
         )
 
-    def _add_tasua_day(self, name) -> Set[date]:
+    def _add_tasua_day(self, name) -> set[date]:
         """
         Add Tasua day (9th day of 1st month).
 

holidays/groups/persian.py

@@ -7,7 +7,7 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
 from datetime import date

holidays/groups/thai.py

@@ -7,7 +7,7 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
 from datetime import date

holidays/helpers.py

@@ -7,7 +7,7 @@
 #  Authors: Vacanza Team and individual contributors (see AUTHORS file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
-#  Website: https://github.com/vacanza/python-holidays
+#  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)