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

holidays/groups/christian.py

@@ -0,0 +1,483 @@
+#  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 dateutil.easter import EASTER_ORTHODOX, EASTER_WESTERN, easter
+
+from holidays.calendars import GREGORIAN_CALENDAR, JULIAN_CALENDAR
+from holidays.constants import JAN, FEB, MAR, APR, JUN, JUL, AUG, SEP, NOV, DEC
+
+
+class ChristianHolidays:
+    """
+    Christian holidays.
+    """
+
+    def __init__(self, calendar=GREGORIAN_CALENDAR) -> None:
+        self.__verify_calendar(calendar)
+        self.__calendar = calendar
+
+    def __get_christmas_day(self, calendar=None):
+        """
+        Get Christmas Day date.
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        return (
+            date(self._year, DEC, 25)
+            if self.__is_gregorian_calendar(calendar)
+            else date(self._year, JAN, 7)  # Orthodox.
+        )
+
+    def __get_easter_sunday(self, calendar=None):
+        """
+        Get Easter Sunday date.
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        return easter(
+            self._year,
+            method=EASTER_ORTHODOX if calendar == JULIAN_CALENDAR else EASTER_WESTERN,
+        )
+
+    @staticmethod
+    def __is_gregorian_calendar(calendar):
+        """
+        Return True if `calendar` is Gregorian calendar.
+        Return False otherwise.
+        """
+        return calendar == GREGORIAN_CALENDAR
+
+    @staticmethod
+    def __verify_calendar(calendar):
+        """
+        Verify calendar type.
+        """
+        if calendar not in {GREGORIAN_CALENDAR, JULIAN_CALENDAR}:
+            raise ValueError(
+                f"Unknown calendar name: {calendar}. "
+                "Use `GREGORIAN_CALENDAR` or `JULIAN_CALENDAR`."
+            )
+
+    @property
+    def _christmas_day(self):
+        """
+        Return Christmas Day date.
+        """
+        return self.__get_christmas_day()
+
+    @property
+    def _easter_sunday(self):
+        """
+        Return Easter Sunday date.
+        """
+        return self.__get_easter_sunday()
+
+    def _add_all_saints_day(self, name) -> date:
+        """
+        Add All Saints' Day (November 1st).
+
+        Also known as All Hallows' Day, the Feast of All Saints,
+        the Feast of All Hallows, the Solemnity of All Saints, and Hallowmas.
+        https://en.wikipedia.org/wiki/All_Saints%27_Day
+        """
+        return self._add_holiday(name, NOV, 1)
+
+    def _add_all_souls_day(self, name) -> date:
+        """
+        Add All Souls' Day (November 2nd).
+
+        All Souls' Day is a day of prayer and remembrance for the faithful
+        departed, observed by certain Christian denominations on 2 November.
+        https://en.wikipedia.org/wiki/All_Souls%27_Day
+        """
+        return self._add_holiday(name, NOV, 2)
+
+    def _add_ascension_thursday(self, name) -> date:
+        """
+        Add Ascension Thursday (39 days after the Easter Sunday).
+
+        The Solemnity of the Ascension of Jesus Christ, also called Ascension
+        Day, or sometimes Holy Thursday.
+        https://en.wikipedia.org/wiki/Feast_of_the_Ascension
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=+39),
+        )
+
+    def _add_ash_monday(self, name) -> date:
+        """
+        Add Ash Monday (48 days before Easter Sunday).
+
+        The Clean Monday, also known as Pure Monday, Monday of Lent
+        or Green Monday. The first day of Great Lent.
+        https://en.wikipedia.org/wiki/Clean_Monday
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=-48),
+        )
+
+    def _add_ash_wednesday(self, name) -> date:
+        """
+        Add Ash Wednesday (46 days before Easter Sunday).
+
+        A holy day of prayer and fasting. It marks the beginning of Lent.
+        https://en.wikipedia.org/wiki/Ash_Wednesday
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=-46),
+        )
+
+    def _add_assumption_of_mary_day(self, name) -> date:
+        """
+        Add Assumption Of Mary (August 15th).
+
+        The Feast of the Assumption of Mary, or simply The Assumption marks the
+        occasion of the Virgin Mary's bodily ascent to heaven at the end of
+        her life.
+        https://en.wikipedia.org/wiki/Assumption_of_Mary
+        """
+        return self._add_holiday(name, AUG, 15)
+
+    def _add_candlemas(self, name) -> date:
+        """
+        Add Candlemas (February 2nd).
+
+        Also known as the Feast of the Presentation of Jesus Christ,
+        the Feast of the Purification of the Blessed Virgin Mary, or the Feast
+        of the Holy Encounter, is a Christian holiday commemorating the
+        presentation of Jesus at the Temple.
+        https://en.wikipedia.org/wiki/Candlemas
+        """
+        return self._add_holiday(name, FEB, 2)
+
+    def _add_carnival_monday(self, name) -> date:
+        """
+        Add Carnival Monday (48 days before Easter Sunday).
+
+        Carnival is a Catholic Christian festive season that occurs before
+        the liturgical season of Lent.
+        https://en.wikipedia.org/wiki/Carnival
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=-48),
+        )
+
+    def _add_carnival_tuesday(self, name) -> date:
+        """
+        Add Carnival Monday (47 days before Easter Sunday).
+
+        Carnival is a Catholic Christian festive season that occurs before
+        the liturgical season of Lent.
+        https://en.wikipedia.org/wiki/Carnival
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=-47),
+        )
+
+    def _add_christmas_day(self, name, calendar=None) -> date:
+        """
+        Add Christmas Day.
+
+        Christmas is an annual festival commemorating the birth of
+        Jesus Christ.
+        https://en.wikipedia.org/wiki/Christmas
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        return self._add_holiday(
+            name,
+            self.__get_christmas_day(calendar),
+        )
+
+    def _add_christmas_day_two(self, name, calendar=None) -> date:
+        """
+        Add Christmas Day 2.
+
+        A holiday celebrated after Christmas Day, also known as Boxing Day.
+        https://en.wikipedia.org/wiki/Boxing_Day
+        https://en.wikipedia.org/wiki/Christmas
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        return self._add_holiday(
+            name,
+            self.__get_christmas_day(calendar) + td(days=+1),
+        )
+
+    def _add_christmas_day_three(self, name, calendar=None) -> date:
+        """
+        Add Christmas Day 3.
+
+        A holiday celebrated 2 days after Christmas Day (in some countries).
+        https://en.wikipedia.org/wiki/Christmas
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        return self._add_holiday(
+            name,
+            self.__get_christmas_day(calendar) + td(days=+2),
+        )
+
+    def _add_christmas_eve(self, name, calendar=None) -> date:
+        """
+        Add Christmas Eve.
+
+        Christmas Eve is the evening or entire day before Christmas Day,
+        the festival commemorating the birth of Jesus Christ.
+        https://en.wikipedia.org/wiki/Christmas_Eve
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        return self._add_holiday(
+            name,
+            self.__get_christmas_day(calendar) + td(days=-1),
+        )
+
+    def _add_corpus_christi_day(self, name) -> date:
+        """
+        Add Feast Of Corpus Christi (60 days after Easter Sunday).
+
+        The Feast of Corpus Christi, also known as the Solemnity of the Most
+        Holy Body and Blood of Christ, is a Christian liturgical solemnity
+        celebrating the Real Presence of the Body and Blood, Soul and Divinity
+        of Jesus Christ in the elements of the Eucharist.
+        https://en.wikipedia.org/wiki/Feast_of_Corpus_Christi
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=+60),
+        )
+
+    def _add_easter_monday(self, name, calendar=None) -> date:
+        """
+        Add Easter Monday (1 day after Easter Sunday).
+
+        Easter Monday refers to the day after Easter Sunday in either the
+        Eastern or Western Christian traditions. It is a public holiday in
+        some countries.
+        https://en.wikipedia.org/wiki/Easter_Monday
+        """
+        return self._add_holiday(
+            name,
+            self.__get_easter_sunday(calendar) + td(days=+1),
+        )
+
+    def _add_easter_sunday(self, name, calendar=None) -> date:
+        """
+        Add Easter Sunday.
+
+        Easter, also called Pascha or Resurrection Sunday is a Christian
+        festival and cultural holiday commemorating the resurrection of Jesus
+        from the dead.
+        https://en.wikipedia.org/wiki/Easter
+        """
+        return self._add_holiday(name, self.__get_easter_sunday(calendar))
+
+    def _add_epiphany_day(self, name, calendar=None) -> date:
+        """
+        Add Epiphany Day.
+
+        Epiphany, also known as Theophany in Eastern Christian traditions,
+        is a Christian feast day that celebrates the revelation of God
+        incarnate as Jesus Christ.
+        https://en.wikipedia.org/wiki/Epiphany_(holiday)
+        """
+        calendar = calendar or self.__calendar
+        self.__verify_calendar(calendar)
+
+        return self._add_holiday(
+            name,
+            date(self._year, JAN, 6)
+            if self.__is_gregorian_calendar(calendar)
+            else date(self._year, JAN, 19),
+        )
+
+    def _add_good_friday(self, name, calendar=None) -> date:
+        """
+        Add Good Friday (2 days before Easter Sunday).
+
+        Good Friday is a Christian holiday commemorating the crucifixion of
+        Jesus and his death at Calvary. It is also known as Holy Friday,
+        Great Friday, Great and Holy Friday.
+        https://en.wikipedia.org/wiki/Good_Friday
+        """
+        return self._add_holiday(
+            name,
+            self.__get_easter_sunday(calendar) + td(days=-2),
+        )
+
+    def _add_holy_saturday(self, name) -> date:
+        """
+        Add Holy Saturday (1 day before Easter Sunday).
+
+        Great and Holy Saturday is a day between Good Friday and Easter Sunday.
+        https://en.wikipedia.org/wiki/Holy_Saturday
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=-1),
+        )
+
+    def _add_holy_thursday(self, name) -> date:
+        """
+        Add Holy Thursday (3 days before Easter Sunday).
+
+        Holy Thursday or Maundy Thursday is the day during Holy Week that
+        commemorates the Washing of the Feet (Maundy) and Last Supper of
+        Jesus Christ with the Apostles, as described in the canonical gospels.
+        https://en.wikipedia.org/wiki/Maundy_Thursday
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=-3),
+        )
+
+    def _add_immaculate_conception_day(self, name) -> date:
+        """
+        Add Immaculate Conception Day (December 8th).
+
+        https://en.wikipedia.org/wiki/Immaculate_Conception
+        """
+        return self._add_holiday(name, DEC, 8)
+
+    def _add_nativity_of_mary_day(self, name) -> date:
+        """
+        Add Nativity Of Mary Day (September 8th).
+
+        The Nativity of the Blessed Virgin Mary, the Nativity of Mary,
+        the Marymas or the Birth of the Virgin Mary, refers to a Christian
+        feast day celebrating the birth of Mary, mother of Jesus.
+        https://en.wikipedia.org/wiki/Nativity_of_Mary
+        """
+        return self._add_holiday(name, SEP, 8)
+
+    def _add_palm_sunday(self, name) -> date:
+        """
+        Add Palm Sunday (7 days before Easter Sunday).
+
+        Palm Sunday is a Christian moveable feast that falls on the Sunday
+        before Easter. The feast commemorates Christ's triumphal entry into
+        Jerusalem, an event mentioned in each of the four canonical Gospels.
+        Palm Sunday marks the first day of Holy Week.
+        https://en.wikipedia.org/wiki/Palm_Sunday
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=-7),
+        )
+
+    def _add_rejoicing_day(self, name) -> date:
+        """
+        Add Day Of Rejoicing (9 days after Easter Sunday).
+
+        Add Day Of Rejoicing ("Radonitsa"), in the Russian Orthodox Church is
+        a commemoration of the departed observed on the second Tuesday of
+        Pascha (Easter).In Ukrainian tradition it is called Provody.
+        https://en.wikipedia.org/wiki/Radonitsa
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=+9),
+        )
+
+    def _add_saint_georges_day(self, name) -> date:
+        """
+        Add Saint George's Day (April 23th).
+
+        Saint George's Day is celebrated on 23 April, the traditionally
+        accepted date of the saint's death.
+        https://en.wikipedia.org/wiki/Saint_George%27s_Day
+        """
+        return self._add_holiday(name, APR, 23)
+
+    def _add_saint_james_day(self, name) -> date:
+        """
+        Add Saint James' Day (July 25th).
+
+        James the Great was one of the Twelve Apostles of Jesus.
+        https://en.wikipedia.org/wiki/James_the_Great#Feast
+        """
+        return self._add_holiday(name, JUL, 25)
+
+    def _add_saint_johns_day(self, name) -> date:
+        """
+        Add Saint John's Day (June 24th).
+
+        The Nativity of John the Baptist is a Christian feast day celebrating
+        the birth of John the Baptist.
+        https://en.wikipedia.org/wiki/Nativity_of_John_the_Baptist
+        """
+        return self._add_holiday(name, JUN, 24)
+
+    def _add_saint_josephs_day(self, name) -> date:
+        """
+        Add Saint Joseph's Day (March 19th).
+
+        Saint Joseph's Day, also called the Feast of Saint Joseph or the
+        Solemnity of Saint Joseph, is in Western Christianity the principal
+        feast day of Saint Joseph, husband of the Virgin Mary and legal father
+        of Jesus Christ.
+        https://en.wikipedia.org/wiki/Saint_Joseph%27s_Day
+        """
+        return self._add_holiday(name, MAR, 19)
+
+    def _add_saints_peter_and_paul_day(self, name) -> date:
+        """
+        Feast of Saints Peter and Paul (June 29th).
+
+        A liturgical feast in honor of the martyrdom in Rome of the apostles
+        Saint Peter and Saint Paul, which is observed on 29 June.
+        https://en.wikipedia.org/wiki/Feast_of_Saints_Peter_and_Paul
+        """
+        return self._add_holiday(name, JUN, 29)
+
+    def _add_whit_monday(self, name) -> date:
+        """
+        Add Whit Monday (50 days after Easter Sunday).
+
+        Whit Monday or Pentecost Monday, also known as Monday of the
+        Holy Spirit, is the holiday celebrated the day after Pentecost.
+        https://en.wikipedia.org/wiki/Pentecost
+        https://en.wikipedia.org/wiki/Whit_Monday
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=+50),
+        )
+
+    def _add_whit_sunday(self, name) -> date:
+        """
+        Add Whit Sunday (49 days after Easter Sunday).
+
+        Whit Sunday, also called Pentecost, is a holiday which commemorates
+        the descent of the Holy Spirit upon the Apostles and other followers
+        of Jesus Christ while they were in Jerusalem celebrating the
+        Feast of Weeks.
+        https://en.wikipedia.org/wiki/Pentecost
+        """
+        return self._add_holiday(
+            name,
+            self._easter_sunday + td(days=+49),
+        )

holidays/groups/hindu.py

@@ -0,0 +1,71 @@
+#  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 Tuple, Optional
+
+from holidays.calendars import _HinduLunisolar
+
+
+class HinduCalendarHolidays:
+    """
+    Hindu lunisolar calendar holidays.
+    """
+
+    def __init__(self, calendar=_HinduLunisolar(), show_estimated=False) -> None:
+        self._hindu_calendar = calendar
+        self._show_estimated = show_estimated
+
+    def _add_hindu_calendar_holiday(
+        self,
+        name: str,
+        hol_date: Tuple[date, bool],
+    ) -> Optional[date]:
+        """
+        Add Hindu 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 = hol_date
+        return self._add_holiday(
+            self.tr(estimated_label) % self.tr(name)
+            if is_estimated and self._show_estimated
+            else name,
+            dt,
+        )
+
+    def _add_diwali(self, name) -> Optional[date]:
+        """
+        Add Diwali Festival.
+
+        Diwali (Deepavali, Festival of Lights) is one of the most important
+        festivals in Indian religions. It is celebrated during the Hindu
+        lunisolar months of Ashvin and Kartika (between mid-October and
+        mid-November).
+        https://en.wikipedia.org/wiki/Diwali
+        """
+        return self._add_hindu_calendar_holiday(name, self._hindu_calendar.diwali_date(self._year))
+
+    def _add_thaipusam(self, name) -> Optional[date]:
+        """
+        Add Thaipusam.
+
+        Thaipusam is a Tamil Hindu festival celebrated on the full moon
+        of the Tamil month of Thai (January/February).
+        https://en.wikipedia.org/wiki/Thaipusam
+        """
+        return self._add_hindu_calendar_holiday(
+            name,
+            self._hindu_calendar.thaipusam_date(self._year),
+        )