holidays 0.68__py3-none-any.whl → 0.70__py3-none-any.whl

holidays/groups/hindu.py

@@ -4,12 +4,13 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md 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 collections.abc import Iterable
 from datetime import date
 from typing import Optional
 
@@ -35,10 +36,54 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
         Adds customizable estimation label to holiday name if holiday date
         is an estimation.
         """
+
         return self._add_eastern_calendar_holiday(
             name, dt_estimated, self._hindu_calendar_show_estimated
         )
 
+    def _add_hindu_calendar_holiday_set(
+        self, name: str, dts_estimated: Iterable[tuple[date, bool]], days_delta: int = 0
+    ) -> set[date]:
+        """
+        Add Hindu calendar holidays.
+
+        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
+
+    def _add_buddha_purnima(self, name) -> Optional[date]:
+        """
+        Add Buddha Purnima.
+
+        Buddha Purnima, also known as Vesak, commemorates the birth, enlightenment,
+        and passing of Gautama Buddha. It falls on the full moon day of the
+        Hindu month of Vaisakha (April-May).
+        https://en.wikipedia.org/wiki/Vesak
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.buddha_purnima_date(self._year)
+        )
+
+    def _add_chhath_puja(self, name) -> Optional[date]:
+        """
+        Add Chhath Puja.
+
+        Chhath Puja is a Hindu festival dedicated to the Sun God (Surya).
+        It is observed six days after Diwali in the month of Kartika (October-November).
+        https://en.wikipedia.org/wiki/Chhath
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.chhath_puja_date(self._year)
+        )
+
     def _add_diwali(self, name) -> Optional[date]:
         """
         Add Diwali Festival.
@@ -51,6 +96,204 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
         """
         return self._add_hindu_calendar_holiday(name, self._hindu_calendar.diwali_date(self._year))
 
+    def _add_diwali_india(self, name) -> Optional[date]:
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.diwali_india_date(self._year)
+        )
+
+    def _add_dussehra(self, name) -> Optional[date]:
+        """
+        Add Dussehra Festival.
+
+        Dussehra (Vijayadashami) is a major Hindu festival that marks the end
+        of Navratri. It is celebrated on the 10th day of the Hindu lunisolar
+        month of Ashvin (September-October).
+        https://en.wikipedia.org/wiki/Vijayadashami
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.dussehra_date(self._year)
+        )
+
+    def _add_ganesh_chaturthi(self, name) -> Optional[date]:
+        """
+        Add Ganesh Chaturthi.
+
+        Ganesh Chaturthi is a Hindu festival celebrating the birth of Lord Ganesha.
+        It falls on the fourth day of the Hindu month of Bhadrapada (August/September).
+        https://en.wikipedia.org/wiki/Ganesh_Chaturthi
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.ganesh_chaturthi_date(self._year)
+        )
+
+    def _add_govardhan_puja(self, name) -> Optional[date]:
+        """
+        Add Govardhan Puja.
+
+        Govardhan Puja, also known as Annakut, is celebrated the day after Diwali
+        to honor Lord Krishna. It falls on the first lunar day of the Hindu month of Kartika.
+        https://en.wikipedia.org/wiki/Govardhan_Puja
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.govardhan_puja_date(self._year)
+        )
+
+    def _add_gudi_padwa(self, name) -> Optional[date]:
+        """
+        Add Gudi Padwa.
+
+        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
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.gudi_padwa_date(self._year)
+        )
+
+    def _add_guru_gobind_singh_jayanti(self, name) -> set[date]:
+        """
+        Add Guru Gobind Singh Jayanti.
+
+        Guru Gobind Singh Jayanti commemorates the birth anniversary of
+        Guru Gobind Singh, the tenth Sikh Guru. It follows the Nanakshahi calendar.
+        https://en.wikipedia.org/wiki/Guru_Gobind_Singh
+        """
+        return self._add_hindu_calendar_holiday_set(
+            name, self._hindu_calendar.guru_gobind_singh_jayanti_date(self._year)
+        )
+
+    def _add_guru_nanak_jayanti(self, name) -> Optional[date]:
+        """
+        Add Guru Nanak Jayanti.
+
+        Guru Nanak Jayanti celebrates the birth anniversary of Guru Nanak,
+        the founder of Sikhism. It is observed on the full moon day of
+        Kartik (October-November).
+        https://en.wikipedia.org/wiki/Guru_Nanak_Gurpurab
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.guru_nanak_jayanti_date(self._year)
+        )
+
+    def _add_holi(self, name) -> Optional[date]:
+        """
+        Add Holi Festival.
+
+        Holi, known as the Festival of Colors, is a Hindu festival that marks
+        the arrival of spring. It is celebrated on the full moon day of the
+        Hindu month of Phalguna (February/March).
+        https://en.wikipedia.org/wiki/Holi
+        """
+        return self._add_hindu_calendar_holiday(name, self._hindu_calendar.holi_date(self._year))
+
+    def _add_janmashtami(self, name) -> Optional[date]:
+        """
+        Add Janmashtami.
+
+        Janmashtami is a Hindu festival that celebrates the birth of Lord Krishna.
+        It falls on the eighth day of the Hindu month of Bhadrapada (August/September).
+        https://en.wikipedia.org/wiki/Krishna_Janmashtami
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.janmashtami_date(self._year)
+        )
+
+    def _add_maha_navami(self, name) -> Optional[date]:
+        """
+        Add Maha Navami.
+
+        Maha Navami is the ninth day of Navratri, dedicated to Goddess Durga.
+        It is observed in Ashvin (September-October).
+        https://en.wikipedia.org/wiki/Navaratri
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.maha_navami_date(self._year)
+        )
+
+    def _add_maha_shivaratri(self, name) -> Optional[date]:
+        """
+        Add Maha Shivaratri.
+
+        Maha Shivaratri is a Hindu festival dedicated to Lord Shiva. It is celebrated
+        on the 14th night of the Hindu month of Phalguna (February/March).
+        https://en.wikipedia.org/wiki/Maha_Shivaratri
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.maha_shivaratri_date(self._year)
+        )
+
+    def _add_mahavir_jayanti(self, name) -> Optional[date]:
+        """
+        Add Mahavir Jayanti.
+
+        Mahavir Jayanti celebrates the birth of Lord Mahavira, the 24th
+        Tirthankara of Jainism. It falls on the 13th day of Chaitra (March-April).
+        https://en.wikipedia.org/wiki/Mahavir_Jayanti
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.mahavir_jayanti_date(self._year)
+        )
+
+    def _add_makar_sankranti(self, name) -> Optional[date]:
+        """
+        Add Makar Sankranti.
+
+        Makar Sankranti is a Hindu festival that marks the transition of the Sun
+        into Capricorn (Makar). It is celebrated on January 14th or 15th every year.
+        https://en.wikipedia.org/wiki/Makar_Sankranti
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.makar_sankranti_date(self._year)
+        )
+
+    def _add_onam(self, name) -> Optional[date]:
+        """
+        Add Onam.
+
+        Onam is a major festival in Kerala, celebrating the homecoming of
+        King Mahabali. It falls in the month of Chingam (August-September).
+        https://en.wikipedia.org/wiki/Onam
+        """
+        return self._add_hindu_calendar_holiday(name, self._hindu_calendar.onam_date(self._year))
+
+    def _add_raksha_bandhan(self, name) -> Optional[date]:
+        """
+        Add Raksha Bandhan.
+
+        Raksha Bandhan is a Hindu festival that celebrates the bond between
+        brothers and sisters. It falls on the full moon day of the Hindu month
+        of Shravana (July/August).
+        https://en.wikipedia.org/wiki/Raksha_Bandhan
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.raksha_bandhan_date(self._year)
+        )
+
+    def _add_ram_navami(self, name) -> Optional[date]:
+        """
+        Add Ram Navami.
+
+        Ram Navami is a Hindu festival celebrating the birth of Lord Rama.
+        It is observed on the ninth day of the Hindu month of Chaitra (March/April).
+        https://en.wikipedia.org/wiki/Rama_Navami
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.ram_navami_date(self._year)
+        )
+
+    def _add_sharad_navratri(self, name) -> Optional[date]:
+        """
+        Add Navratri / Sharad Navratri.
+
+        Navratri is a Hindu festival dedicated to the worship of Goddess Durga.
+        It is celebrated over nine nights and occurs in the lunar month of Ashvin
+        (September/October).
+        https://en.wikipedia.org/wiki/Navratri
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.sharad_navratri_date(self._year)
+        )
+
     def _add_thaipusam(self, name) -> Optional[date]:
         """
         Add Thaipusam.
@@ -62,3 +305,15 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
         return self._add_hindu_calendar_holiday(
             name, self._hindu_calendar.thaipusam_date(self._year)
         )
+
+    def _add_vaisakhi(self, name) -> Optional[date]:
+        """
+        Add Vaisakhi.
+
+        Vaisakhi is a major Sikh festival marking the Sikh New Year and the
+        founding of the Khalsa. It falls on April 13 or 14.
+        https://en.wikipedia.org/wiki/Vaisakhi
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.vaisakhi_date(self._year)
+        )

holidays/groups/international.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays

holidays/groups/islamic.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -25,8 +25,9 @@ class IslamicHolidays(EasternCalendarHolidays):
     calendar consisting of 12 lunar months in a year of 354 or 355 days.
     """
 
-    def __init__(self, cls=None) -> None:
+    def __init__(self, cls=None, show_estimated=True) -> None:
         self._islamic_calendar = cls() if cls else _IslamicLunar()
+        self._islamic_calendar_show_estimated = show_estimated
 
     def _add_ali_al_rida_death_day(self, name) -> set[date]:
         """
@@ -262,7 +263,9 @@ class IslamicHolidays(EasternCalendarHolidays):
         """
         added_dates = set()
         for dts in dates:
-            if dt := self._add_eastern_calendar_holiday(name, dts, days_delta=days_delta):
+            if dt := self._add_eastern_calendar_holiday(
+                name, dts, self._islamic_calendar_show_estimated, days_delta
+            ):
                 added_dates.add(dt)
 
         return added_dates
@@ -292,6 +295,17 @@ class IslamicHolidays(EasternCalendarHolidays):
             name, self._islamic_calendar.isra_and_miraj_dates(self._year)
         )
 
+    def _add_laylat_al_qadr_day(self, name):
+        """
+        Add Laylat al-Qadr Day (27th day of 9th month).
+
+        The Night of Power.
+        https://en.wikipedia.org/wiki/Night_of_Power
+        """
+        return self._add_islamic_calendar_holiday(
+            name, self._islamic_calendar.laylat_al_qadr_dates(self._year)
+        )
+
     def _add_maldives_embraced_islam_day(self, name) -> set[date]:
         """
         Add Maldives Embraced Islam Day (1st day of 4th month).

holidays/groups/persian.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays

holidays/groups/sinhala.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays

holidays/groups/thai.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -35,9 +35,6 @@ class ThaiCalendarHolidays:
         Asalha Pūjā (also written as Asarnha Bucha Day) is a Buddhist festival
         celebrated on the 15th Waxing Day (Full Moon) of Month 8.
 
-        Khmer variant: always fall on Month 8.
-        Thai variant:  will use Month 8.8 instead for Athikamat years.
-
         https://en.wikipedia.org/wiki/Asalha_Puja
         """
 
@@ -94,9 +91,6 @@ class ThaiCalendarHolidays:
         Start of Buddhist Lent (also written as Khao Phansa Day) is a Buddhist
         festival celebrated on the 1st Waning Day of Month 8.
 
-        Khmer variant: always fall on Month 8.
-        Thai variant:  will use Month 8.8 instead for Athikamat years.
-
         https://en.wikipedia.org/wiki/Vassa
         """
 

holidays/helpers.py

@@ -4,7 +4,7 @@
 #  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)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays