holidays 0.26__py3-none-any.whl → 0.27__py3-none-any.whl

holidays/groups/international.py

@@ -0,0 +1,157 @@
+#  python-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: dr-prodigy <maurizio.montel@gmail.com> (c) 2017-2022
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+
+from holidays.constants import JAN, MAR, MAY, JUN, OCT, NOV, DEC
+
+
+class InternationalHolidays:
+    """
+    International holidays.
+    """
+
+    def _add_africa_day(self, name):
+        """
+        Add Africa Day (May 25th)
+
+        Africa Day (formerly African Freedom Day and African Liberation Day)
+        is the annual commemoration of the foundation of the Organisation
+        of African Unity on 25 May 1963.
+        https://en.wikipedia.org/wiki/Africa_Day
+        """
+        return self._add_holiday(name, MAY, 25)
+
+    def _add_childrens_day(self, name, variation="JUN"):
+        """
+        Add International Children's Day (June 1).
+
+        In 1925, International Children's Day was first proclaimed in Geneva
+        during the World Conference on Child Welfare. Since 1950, it is
+        celebrated on June 1 in many countries.
+
+        As such, this entry currently defaults to June 1, though this also
+        supports another internationally adopted variant, November 20th.
+        https://en.wikipedia.org/wiki/Children's_Day
+        """
+        if variation == "JUN":
+            return self._add_holiday(name, JUN, 1)
+        elif variation == "NOV":
+            return self._add_holiday(name, NOV, 20)
+        else:
+            raise ValueError(
+                f"Unknown variaton name: {variation}. "
+                "This entry currently supports `JUN` and `NOV` variation only."
+            )
+
+    def _add_columbus_day(self, name):
+        """
+        Add Columbus Day (October 12th)
+
+        Columbus Day is a national holiday which officially celebrates the
+        anniversary of Christopher Columbus's arrival in the Americas.
+        https://en.wikipedia.org/wiki/Columbus_Day
+        """
+        return self._add_holiday(name, OCT, 12)
+
+    def _add_labor_day(self, name):
+        """
+        Add International Workers' Day (May 1st)
+
+        International Workers' Day, also known as Labour Day, is a celebration
+        of labourers and the working classes that is promoted by the
+        international labour movement.
+        https://en.wikipedia.org/wiki/International_Workers%27_Day
+        """
+        return self._add_holiday(name, MAY, 1)
+
+    def _add_new_years_day(self, name) -> date:
+        """
+        Add New Year's Day (January 1st).
+
+        New Year's Day is a festival observed in most of the world on
+        1 January, the first day of the year in the modern Gregorian calendar.
+        https://en.wikipedia.org/wiki/New_Year%27s_Day
+        """
+        return self._add_holiday(name, JAN, 1)
+
+    def _add_new_years_day_two(self, name) -> date:
+        """
+        Add New Year's Day Two (January 2nd).
+
+        New Year's Day is a festival observed in most of the world on
+        1 January, the first day of the year in the modern Gregorian calendar.
+        https://en.wikipedia.org/wiki/New_Year%27s_Day
+        """
+        return self._add_holiday(name, JAN, 2)
+
+    def _add_new_years_day_three(self, name) -> date:
+        """
+        Add New Year's Day Three (January 3rd).
+
+        New Year's Day is a festival observed in most of the world on
+        1 January, the first day of the year in the modern Gregorian calendar.
+        https://en.wikipedia.org/wiki/New_Year%27s_Day
+        """
+        return self._add_holiday(name, JAN, 3)
+
+    def _add_new_years_day_four(self, name) -> date:
+        """
+        Add New Year's Day Four (January 4th).
+
+        New Year's Day is a festival observed in most of the world on
+        1 January, the first day of the year in the modern Gregorian calendar.
+        https://en.wikipedia.org/wiki/New_Year%27s_Day
+        """
+        return self._add_holiday(name, JAN, 4)
+
+    def _add_remembrance_day(self, name):
+        """
+        Add Remembrance Day / Armistice Day (Nov 11th)
+
+        It's a memorial day since the end of the First World War in 1919
+        to honour armed forces members who have died in the line of duty.
+        https://en.wikipedia.org/wiki/Remembrance_Day
+        """
+        return self._add_holiday(name, NOV, 11)
+
+    def _add_new_years_eve(self, name) -> date:
+        """
+        Add New Year's Eve (December 31st).
+
+        In the Gregorian calendar, New Year's Eve, also known as Old Year's
+        Day or Saint Sylvester's Day in many countries, is the evening or the
+        entire day of the last day of the year, on 31 December.
+        https://en.wikipedia.org/wiki/New_Year%27s_Eve
+        """
+        return self._add_holiday(name, DEC, 31)
+
+    def _add_womens_day(self, name):
+        """
+        Add International Women's Day (March 8th).
+
+        International Women's Day is a global holiday celebrated as a focal
+        point in the women's rights movement, bringing attention to issues
+        such as gender equality, reproductive rights, and violence and abuse
+        against women.
+        https://en.wikipedia.org/wiki/International_Women%27s_Day
+        """
+        return self._add_holiday(name, MAR, 8)
+
+    def _add_world_war_two_victory_day(self, name):
+        """
+        Add Victory Day (May 9th)
+
+        Victory Day is a holiday that commemorates the victory over Nazi
+        Germany in 1945.
+        https://en.wikipedia.org/wiki/Victory_Day_(9_May)
+        """
+        return self._add_holiday(name, MAY, 9)

holidays/groups/islamic.py

@@ -0,0 +1,288 @@
+#  python-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: dr-prodigy <maurizio.montel@gmail.com> (c) 2017-2022
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from datetime import timedelta as td
+from typing import Iterable, Set, Tuple
+
+from holidays.calendars import _IslamicLunar
+
+
+class IslamicHolidays:
+    """
+    Islamic holidays.
+
+    The Hijri calendar also known as Islamic calendar, is a lunar
+    calendar consisting of 12 lunar months in a year of 354 or 355 days.
+    """
+
+    def __init__(self, calendar=_IslamicLunar()) -> None:
+        self._islamic_calendar = calendar
+
+    def _add_arafah_day(self, name) -> Set[date]:
+        """
+        Add Day of Arafah (9th day of 12th month).
+
+        At dawn of this day, Muslim pilgrims will make their way from Mina
+        to a nearby hillside and plain called Mount Arafat and the Plain of
+        Arafat.
+        https://en.wikipedia.org/wiki/Day_of_Arafah
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.eid_al_adha_dates(self._year),
+            days_delta=-1,
+        )
+
+    def _add_ashura_day(self, name) -> Set[date]:
+        """
+        Add Ashura Day (10th day of 1st month).
+
+        Ashura is a day of commemoration in Islam. It occurs annually on the
+        10th of Muharram, the first month of the Islamic calendar.
+        https://en.wikipedia.org/wiki/Ashura
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.ashura_dates(self._year),
+        )
+
+    def _add_ashura_eve(self, name) -> Set[date]:
+        """
+        Add Ashura Eve (Day before the 10th day of 1st month).
+
+        Ashura is a day of commemoration in Islam. It occurs annually on the
+        10th of Muharram, the first month of the Islamic calendar.
+        https://en.wikipedia.org/wiki/Ashura
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.ashura_dates(self._year),
+            days_delta=-1,
+        )
+
+    def _add_eid_al_adha_day(self, name) -> Set[date]:
+        """
+        Add Eid al-Adha Day (10th day of the 12th month of Islamic calendar).
+
+        Feast of the Sacrifice. It honours the willingness of Ibrahim
+        (Abraham) to sacrifice his son Ismail (Ishmael) as an act of obedience
+        to Allah's command.
+        https://en.wikipedia.org/wiki/Eid_al-Adha
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.eid_al_adha_dates(self._year),
+        )
+
+    def _add_eid_al_adha_day_two(self, name) -> Set[date]:
+        """
+        Add Eid al-Adha Day Two.
+
+        https://en.wikipedia.org/wiki/Eid_al-Adha
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.eid_al_adha_dates(self._year),
+            days_delta=+1,
+        )
+
+    def _add_eid_al_adha_day_three(self, name) -> Set[date]:
+        """
+        Add Eid al-Adha Day Three.
+
+        https://en.wikipedia.org/wiki/Eid_al-Adha
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.eid_al_adha_dates(self._year),
+            days_delta=+2,
+        )
+
+    def _add_eid_al_adha_day_four(self, name) -> Set[date]:
+        """
+        Add Eid al-Adha Day Four.
+
+        https://en.wikipedia.org/wiki/Eid_al-Adha
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.eid_al_adha_dates(self._year),
+            days_delta=+3,
+        )
+
+    def _add_eid_al_fitr_day(self, name) -> Set[date]:
+        """
+        Add Eid al-Fitr Day (1st day of 10th month of Islamic calendar).
+
+        Holiday of Breaking the Fast. The religious holiday is celebrated
+        by Muslims worldwide because it marks the end of the month-long
+        dawn-to-sunset fasting of Ramadan.
+        https://en.wikipedia.org/wiki/Eid_al-Fitr
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.eid_al_fitr_dates(self._year),
+        )
+
+    def _add_eid_al_fitr_day_two(self, name) -> Set[date]:
+        """
+        Add Eid al-Fitr Day Two.
+
+        https://en.wikipedia.org/wiki/Eid_al-Fitr
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.eid_al_fitr_dates(self._year),
+            days_delta=+1,
+        )
+
+    def _add_eid_al_fitr_day_three(self, name) -> Set[date]:
+        """
+        Add Eid al-Fitr Day Three.
+
+        https://en.wikipedia.org/wiki/Eid_al-Fitr
+        """
+        return self._add_islamic_calendar_holiday(
+            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(
+            name,
+            self._islamic_calendar.eid_al_fitr_dates(self._year),
+            days_delta=+3,
+        )
+
+    def _add_hari_hol_johor(self, name) -> Set[date]:
+        """
+        Hari Hol Johor.
+
+        https://publicholidays.com.my/hari-hol-almarhum-sultan-iskandar/
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.hari_hol_johor_dates(self._year),
+        )
+
+    def _add_islamic_calendar_holiday(
+        self,
+        name: str,
+        dates: Iterable[Tuple[date, bool]],
+        days_delta: int = 0,
+    ) -> Set[date]:
+        """
+        Add lunar calendar holiday.
+
+        Appends customizable estimation label at the end of holiday name if
+        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 += td(days=days_delta)
+
+            dt = self._add_holiday(
+                self.tr(estimated_label) % self.tr(name) if is_estimated else name,
+                dt,
+            )
+            if dt:
+                added_dates.add(dt)
+
+        return added_dates
+
+    def _add_islamic_new_year_day(self, name) -> Set[date]:
+        """
+        Add Islamic New Year Day (last day of Dhu al-Hijjah).
+
+        The Islamic New Year, also called the Hijri New Year, is the day that
+        marks the beginning of a new lunar Hijri year, and is the day on which
+        the year count is incremented. The first day of the Islamic year is
+        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(
+            name,
+            self._islamic_calendar.hijri_new_year_dates(self._year),
+        )
+
+    def _add_isra_and_miraj_day(self, name):
+        """
+        Add Isra' and Mi'raj Day (27th day of 7th month).
+
+        https://en.wikipedia.org/wiki/Isra%27_and_Mi%27raj
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.isra_and_miraj_dates(self._year),
+        )
+
+    def _add_mawlid_day(self, name) -> Set[date]:
+        """
+        Add Mawlid Day (12th day of 3rd month).
+
+        Mawlid is the observance of the birthday of the Islamic prophet
+        Muhammad.
+        https://en.wikipedia.org/wiki/Mawlid
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.mawlid_dates(self._year),
+        )
+
+    def _add_mawlid_day_two(self, name) -> Set[date]:
+        """
+        Add Mawlid Day Two.
+
+        Mawlid is the observance of the birthday of the Islamic prophet
+        Muhammad.
+        https://en.wikipedia.org/wiki/Mawlid
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.mawlid_dates(self._year),
+            days_delta=+1,
+        )
+
+    def _add_nuzul_al_quran_day(self, name) -> Set[date]:
+        """
+        Add Nuzul Al Quran (17th day of 9th month).
+
+        Nuzul Al Quran is a Muslim festival to remember the day when Prophet
+        Muhammad received his first revelation of Islam's sacred book,
+        the holy Quran.
+        https://zamzam.com/blog/nuzul-al-quran/
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.nuzul_al_quran_dates(self._year),
+        )
+
+    def _add_ramadan_beginning_day(self, name) -> Set[date]:
+        """
+        Add First Day of Ramadan (1st day of 9th month).
+
+        Ramadan is the ninth month of the Islamic calendar, observed by Muslims
+        worldwide as a month of fasting, prayer, reflection, and community
+        https://en.wikipedia.org/wiki/Ramadan
+        """
+        return self._add_islamic_calendar_holiday(
+            name,
+            self._islamic_calendar.ramadan_beginning_dates(self._year),
+        )

holidays/groups/thai.py

@@ -0,0 +1,157 @@
+#  python-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: dr-prodigy <maurizio.montel@gmail.com> (c) 2017-2022
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+from datetime import date
+from typing import Optional
+
+from holidays.calendars import _ThaiLunisolar, THAI_CALENDAR
+
+
+class ThaiCalendarHolidays:
+    """
+    Thai lunisolar calendar holidays.
+
+    For more info, see class `_ThaiLunisolar`.
+    Calendar-type checking are done by `_ThaiLunisolar`.
+    """
+
+    def __init__(self, calendar=THAI_CALENDAR) -> None:
+        self.__calendar = calendar
+        self._thai_calendar = _ThaiLunisolar(calendar)
+
+    def _add_asarnha_bucha(self, name, calendar=None) -> Optional[date]:
+        """
+        Add Asarnha Bucha.
+
+        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
+        """
+        calendar = calendar or self.__calendar
+
+        return self._add_thai_calendar_holiday(
+            name, self._thai_calendar.asarnha_bucha_date(self._year, calendar)
+        )
+
+    def _add_khao_phansa(self, name, calendar=None) -> Optional[date]:
+        """
+        Add Khao Phansa.
+
+        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
+        """
+        calendar = calendar or self.__calendar
+
+        return self._add_thai_calendar_holiday(
+            name, self._thai_calendar.khao_phansa_date(self._year, calendar)
+        )
+
+    def _add_loy_krathong(self, name) -> Optional[date]:
+        """
+        Add Loy Krathong.
+
+        Also known as "Boun That Louang" and "Bon Om Touk".
+        This concides with the 15th Waxing Day (Full Moon) of Month 12
+        in Thai Lunar Calendar.
+
+        https://en.wikipedia.org/wiki/Loy_Krathong
+        https://en.wikipedia.org/wiki/Bon_Om_Touk
+        """
+
+        return self._add_thai_calendar_holiday(
+            name, self._thai_calendar.loy_krathong_date(self._year)
+        )
+
+    def _add_makha_bucha(self, name, calendar=None) -> Optional[date]:
+        """
+        Add Makha Bucha.
+
+        Māgha Pūjā (also written as Makha Bucha Day) is a Buddhist festival
+        celebrated on the 15th Waxing Day (Full Moon) of Month 3.
+
+        Khmer variant: always fall on Month 3.
+        Thai variant:  will use Month 4 instead for Athikamat years.
+
+        https://en.wikipedia.org/wiki/M%C4%81gha_P%C5%ABj%C4%81
+        """
+        calendar = calendar or self.__calendar
+
+        return self._add_thai_calendar_holiday(
+            name, self._thai_calendar.makha_bucha_date(self._year, calendar)
+        )
+
+    def _add_pchum_ben(self, name) -> Optional[date]:
+        """
+        Add Pchum Ben.
+
+        Also known as "Prachum Bandar".
+        This concides with the 15th Waning Day (New Moon) of Month 10 in
+        Thai Lunar Calendar.
+
+        https://en.wikipedia.org/wiki/Pchum_Ben
+        """
+
+        return self._add_thai_calendar_holiday(
+            name, self._thai_calendar.pchum_ben_date(self._year)
+        )
+
+    def _add_preah_neangkoal(self, name) -> Optional[date]:
+        """
+        Add Preah Reach Pithi Chrat Preah Neangkoal.
+
+        Also known as "Cambodian Royal Ploughing Ceremony". This always
+        concides with the 4th Waning Day of Month 6 in Khmer Lunar Calendar.
+
+        https://en.wikipedia.org/wiki/Royal_Ploughing_Ceremony
+        """
+
+        return self._add_thai_calendar_holiday(
+            name, self._thai_calendar.preah_neangkoal_date(self._year)
+        )
+
+    def _add_thai_calendar_holiday(self, name, dt) -> Optional[date]:
+        """
+        Add Thai calendar holiday.
+
+        If the result from `_ThaiLunisolar` is none then no holidays added.
+        """
+        if dt is None:
+            return None
+
+        return self._add_holiday(name, dt)
+
+    def _add_visakha_bucha(self, name, calendar=None) -> Optional[date]:
+        """
+        Add Visakha Bucha.
+
+        Vesak(also written as Makha Bucha Day and Meak Bochea Day) is a
+        Buddhist festival celebrated on the 15th Waxing Day (Full Moon)
+        of Month 6.
+
+        Khmer variant: always fall on Month 6.
+        Thai variant:  will use Month 7 instead for Athikamat years.
+
+        https://en.wikipedia.org/wiki/M%C4%81gha_P%C5%ABj%C4%81
+        """
+        calendar = calendar or self.__calendar
+
+        return self._add_thai_calendar_holiday(
+            name, self._thai_calendar.visakha_bucha_date(self._year, calendar)
+        )

holidays/helpers.py

@@ -0,0 +1,20 @@
+#  python-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: dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/dr-prodigy/python-holidays
+#  License: MIT (see LICENSE file)
+
+
+def _normalize_tuple(data):
+    """Normalize tuple.
+
+    :return:
+        An unchanged object for tuple of tuples, e.g., ((JAN, 10), (DEC, 31)).
+        An object put into a tuple otherwise, e.g., ((JAN, 10),).
+    """
+    return data if not data or type(data[0]) == tuple else (data,)