holidays 0.75__py3-none-any.whl → 0.77__py3-none-any.whl

holidays/countries/palestine.py

@@ -0,0 +1,177 @@
+#  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 CONTRIBUTORS 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 gettext import gettext as tr
+
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import GREGORIAN_CALENDAR, SEP
+from holidays.calendars.julian import JULIAN_CALENDAR
+from holidays.constants import CATHOLIC, ORTHODOX, PUBLIC
+from holidays.groups import ChristianHolidays, InternationalHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Palestine(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays):
+    """Palestine holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Palestine>
+        * <https://web.archive.org/web/20250705114216/https://info.wafa.ps/pages/details/29601>
+        * [Declaration of Palestine independence](https://en.wikipedia.org/wiki/Palestine#Uprising,_declaration_and_peace_treaty)
+    """
+
+    country = "PS"
+    default_language = "ar"
+    # %s (estimated).
+    estimated_label = tr("%s (المقدرة)")
+    # State of Palestine declared in November 1988.
+    start_year = 1989
+    supported_categories = (CATHOLIC, ORTHODOX, PUBLIC)
+    supported_languages = ("ar", "en_US")
+
+    def __init__(self, *args, islamic_show_estimated: bool = False, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
+        ChristianHolidays.__init__(self, calendar=JULIAN_CALENDAR)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=PalestineIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day(tr("رأس السنة الميلادي"))
+
+        # Orthodox Christmas Day.
+        self._add_christmas_day(tr("عيد الميلاد المجيد الشرقي"))
+
+        # International Women's Day.
+        self._add_womens_day(tr("يوم المراة العالمي"))
+
+        # Easter.
+        self._add_easter_sunday(tr("عيد الفصح المجيد"), GREGORIAN_CALENDAR)
+
+        # Easter.
+        self._add_easter_sunday(tr("عيد الفصح المجيد"))
+
+        # Labor Day.
+        self._add_labor_day(tr("عيد العمال"))
+
+        # Independence Day.
+        self._add_holiday_nov_15(tr("عيد الإستقلال"))
+
+        # Catholic Christmas Day.
+        self._add_christmas_day(tr("عيد الميلاد المجيد الغربي"), GREGORIAN_CALENDAR)
+
+        # Hijri New Year.
+        self._add_islamic_new_year_day(tr("رأس السنة الهجرية"))
+
+        # Prophet's Birthday.
+        self._add_mawlid_day(tr("ذكرى المولد النبوي الشريف"))
+
+        # Isra' and Mi'raj.
+        self._add_isra_and_miraj_day(tr("ذكرى الإسراء والمعراج"))
+
+        # Eid al-Fitr.
+        name = tr("عيد الفطر السعيد")
+        self._add_eid_al_fitr_day(name)
+        self._add_eid_al_fitr_day_two(name)
+        self._add_eid_al_fitr_day_three(name)
+
+        # Eid al-Adha.
+        name = tr("عيد الأضحى المبارك")
+        self._add_eid_al_adha_day(name)
+        self._add_eid_al_adha_day_two(name)
+        self._add_eid_al_adha_day_three(name)
+        self._add_eid_al_adha_day_four(name)
+
+    def _populate_catholic_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day(tr("رأس السنة الميلادي"))
+
+        # Epiphany.
+        self._add_epiphany_day(tr("عيد الغطاس"), GREGORIAN_CALENDAR)
+
+        # Palm Sunday.
+        self._add_palm_sunday(tr("أحد الشعانين"), GREGORIAN_CALENDAR)
+
+        # Holy Thursday.
+        self._add_holy_thursday(tr("خميس الغسل"), GREGORIAN_CALENDAR)
+
+        # Good Friday.
+        self._add_good_friday(tr("الجمعة العظيمة"), GREGORIAN_CALENDAR)
+
+        # Holy Saturday.
+        self._add_holy_saturday(tr("سبت النور"), GREGORIAN_CALENDAR)
+
+        # Easter.
+        self._add_easter_monday(tr("عيد الفصح المجيد"), GREGORIAN_CALENDAR)
+
+        # Ascension Day.
+        self._add_ascension_thursday(tr("خميس الصعود"), GREGORIAN_CALENDAR)
+
+        # Pentecost.
+        self._add_whit_sunday(tr("أحد العنصرة"), GREGORIAN_CALENDAR)
+
+        # Catholic Christmas Day.
+        self._add_christmas_day_two(tr("عيد الميلاد المجيد الغربي"), GREGORIAN_CALENDAR)
+
+    def _populate_orthodox_holidays(self):
+        # Orthodox New Year's Day.
+        self._add_holiday_jan_14(tr("عيد رأس السنة الشرقي"))
+
+        # Orthodox Christmas Day.
+        self._add_christmas_day_two(tr("عيد الميلاد المجيد الشرقي"))
+
+        # Epiphany.
+        self._add_epiphany_day(tr("عيد الغطاس"))
+
+        # Palm Sunday.
+        self._add_palm_sunday(tr("أحد الشعانين"))
+
+        # Holy Thursday.
+        self._add_holy_thursday(tr("خميس الغسل"))
+
+        # Good Friday.
+        self._add_good_friday(tr("الجمعة العظيمة"))
+
+        # Holy Saturday.
+        self._add_holy_saturday(tr("سبت النور"))
+
+        # Easter.
+        self._add_easter_monday(tr("عيد الفصح المجيد"))
+
+        # Ascension Day.
+        self._add_ascension_thursday(tr("خميس الصعود"))
+
+        # Pentecost.
+        self._add_whit_sunday(tr("أحد العنصرة"))
+
+
+class PS(Palestine):
+    pass
+
+
+class PSE(Palestine):
+    pass
+
+
+class PalestineIslamicHolidays(_CustomIslamicHolidays):
+    # All other dates follow Umm al-Qura calendar.
+    MAWLID_DATES = {
+        2023: (SEP, 27),
+    }

holidays/countries/peru.py

@@ -22,6 +22,8 @@ class Peru(HolidayBase, ChristianHolidays, InternationalHolidays):
     References:
         * <https://web.archive.org/web/20250414165243/https://www.gob.pe/feriados/>
         * <https://es.wikipedia.org/wiki/Anexo:Días_feriados_en_el_Perú>
+        * [Ley N° 31788](https://web.archive.org/web/20250716164223/https://img.lpderecho.pe/wp-content/uploads/2023/06/Ley-31788-LPDerecho.pdf)
+        * [Ley N° 31822](https://web.archive.org/web/20250716164455/https://img.lpderecho.pe/wp-content/uploads/2023/07/Ley-31822-LPDerecho.pdf)
     """
 
     country = "PE"
@@ -49,9 +51,19 @@ class Peru(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Labor Day.
         self._add_labor_day(tr("Día del Trabajo"))
 
+        # Added via Ley N° 31788 on June 15th, 2023.
+        if self._year >= 2024:
+            # Battle of Arica and Flag Day.
+            self._add_holiday_jun_7(tr("Batalla de Arica y Día de la Bandera"))
+
         # Saint Peter and Saint Paul's Day.
         self._add_saints_peter_and_paul_day(tr("San Pedro y San Pablo"))
 
+        # Added via Ley N° 31822 on July 8th, 2023.
+        if self._year >= 2023:
+            # Peruvian Air Force Day.
+            self._add_holiday_jul_23(tr("Día de la Fuerza Aérea del Perú"))
+
         # Independence Day.
         self._add_holiday_jul_28(tr("Día de la Independencia"))
 

holidays/countries/puerto_rico.py

@@ -10,11 +10,11 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
-from holidays.countries.united_states import US
+from holidays.countries.united_states import UnitedStates
+from holidays.mixins.child_entity import ChildEntity
 
 
-class HolidaysPR(US):
+class HolidaysPR(ChildEntity, UnitedStates):
     """Puerto Rico holidays.
 
     Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
@@ -22,21 +22,13 @@ class HolidaysPR(US):
     """
 
     country = "PR"
-    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
-    subdivisions = ()  # Override US subdivisions.
-    subdivisions_aliases = {}  # Override US subdivisions aliases.
+    parent_entity = UnitedStates
+    # Became a U.S. Territory on April 11th, 1899.
+    start_year = 1900
 
-    def _populate_public_holidays(self) -> None:
-        self.subdiv = "PR"
-        super()._populate_public_holidays()
 
-    def _populate_government_holidays(self) -> None:
-        self.subdiv = "PR"
-        super()._populate_government_holidays()
-
-    def _populate_unofficial_holidays(self) -> None:
-        self.subdiv = "PR"
-        super()._populate_unofficial_holidays()
+class PuertoRico(HolidaysPR):
+    pass
 
 
 class PR(HolidaysPR):
@@ -45,7 +37,3 @@ class PR(HolidaysPR):
 
 class PRI(HolidaysPR):
     pass
-
-
-class PuertoRico(HolidaysPR):
-    pass

holidays/countries/reunion.py

@@ -0,0 +1,44 @@
+#  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 CONTRIBUTORS 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 holidays.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysRE(ChildEntity, France):
+    """Réunion holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Réunion>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "RE"
+    parent_entity = France
+    parent_entity_subdivision_code = "974"
+    # Cession from the UK on May 30th, 1814.
+    start_year = 1815
+
+
+class Reunion(HolidaysRE):
+    pass
+
+
+class RE(HolidaysRE):
+    pass
+
+
+class REU(HolidaysRE):
+    pass

holidays/countries/saint_barthelemy.py

@@ -0,0 +1,43 @@
+#  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 CONTRIBUTORS 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 holidays.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysBL(ChildEntity, France):
+    """Saint Barthélemy holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Saint_Barthélemy>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "BL"
+    parent_entity = France
+    # Cession from Guadeloupe on July 15th, 2007.
+    start_year = 2008
+
+
+class SaintBarthelemy(HolidaysBL):
+    pass
+
+
+class BL(HolidaysBL):
+    pass
+
+
+class BLM(HolidaysBL):
+    pass

holidays/countries/saint_martin.py

@@ -0,0 +1,43 @@
+#  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 CONTRIBUTORS 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 holidays.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysMF(ChildEntity, France):
+    """Saint Martin holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Collectivity_of_Saint_Martin>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "MF"
+    parent_entity = France
+    # Cession from Guadeloupe on July 15th, 2007.
+    start_year = 2008
+
+
+class SaintMartin(HolidaysMF):
+    pass
+
+
+class MF(HolidaysMF):
+    pass
+
+
+class MAF(HolidaysMF):
+    pass

holidays/countries/saint_pierre_and_miquelon.py

@@ -0,0 +1,43 @@
+#  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 CONTRIBUTORS 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 holidays.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysPM(ChildEntity, France):
+    """Saint Pierre and Miquelon holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Saint_Pierre_and_Miquelon>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "PM"
+    parent_entity = France
+    # Cession from the UK on May 30th, 1814.
+    start_year = 1815
+
+
+class SaintPierreAndMiquelon(HolidaysPM):
+    pass
+
+
+class PM(HolidaysPM):
+    pass
+
+
+class SPM(HolidaysPM):
+    pass

holidays/countries/saint_vincent_and_the_grenadines.py

@@ -0,0 +1,130 @@
+#  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 CONTRIBUTORS 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 gettext import gettext as tr
+
+from holidays.calendars.gregorian import JAN, JUL, AUG, SEP, _timedelta
+from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
+from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON, SUN_TO_NEXT_TUE
+
+
+class SaintVincentAndTheGrenadines(
+    ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays
+):
+    """Saint Vincent and the Grenadines holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Saint_Vincent_and_the_Grenadines>
+        * [2013](https://web.archive.org/web/20240225145904/https://www.bosvg.com/wp-content/uploads/2021/10/bosvg_calendar2013-9x12_ver2-2.pdf)
+        * [2014](https://web.archive.org/web/20250610053913/https://www.bosvg.com/wp-content/uploads/2021/10/BOSVG-Calendar-2014-5th-draft.pdf)
+        * [2015](https://web.archive.org/web/20240225145904/https://www.bosvg.com/wp-content/uploads/2021/10/BOSVG-Bklet-Calendar-2015_21_11-3.pdf)
+        * [2016](https://web.archive.org/web/20240225145903/https://www.bosvg.com/wp-content/uploads/2021/10/BOSVG-2016_pgs_sm_fin.pdf)
+        * [2022](https://web.archive.org/web/20230426000952/https://www.bosvg.com/wp-content/uploads/2022/05/Tent-Calendar.pdf)
+        * [2023](https://web.archive.org/web/20240225145904/https://www.bosvg.com/wp-content/uploads/2023/03/BOSVG-CALENDAR-TENT_F_REPRINT_TENT-EXCLUDED-FINAL.pdf)
+        * [2019-2025](https://web.archive.org/web/20250214232128/https://pmoffice.gov.vc/pmoffice/index.php/public-holidays)
+        * [2020 Carnival Monday](https://web.archive.org/web/20250607111242/https://www.stvincenttimes.com/august-3rd-and-4th-2020-declared-public-holidays-in-svg/)
+        * [2025 National Spiritual Baptist Day](https://web.archive.org/web/20250513011200/https://www.gov.vc/images/pdf_documents/VINCENTIANS-PREPARE-FOR-MAY-21--SPIRITUAL-BAPTIST-LIBERATION-DAY-NATIONAL-HOLIDAY.pdf)
+    """
+
+    country = "VC"
+    default_language = "en_VC"
+    # %s (observed).
+    observed_label = tr("%s (observed)")
+    supported_languages = ("en_US", "en_VC")
+    start_year = 1979
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        StaticHolidays.__init__(self, cls=SaintVincentAndTheGrenadinesStaticHolidays)
+        kwargs.setdefault("observed_rule", SUN_TO_NEXT_MON)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_observed(self._add_new_years_day(tr("New Year's Day")))
+
+        # National Heroes' Day.
+        self._add_observed(self._add_holiday_mar_14(tr("National Heroes' Day")))
+
+        # Good Friday.
+        self._add_good_friday(tr("Good Friday"))
+
+        # Easter Monday.
+        self._add_easter_monday(tr("Easter Monday"))
+
+        # National Workers' Day.
+        self._add_observed(self._add_labor_day(tr("National Workers' Day")))
+
+        if self._year >= 2025:
+            # National Spiritual Baptist Day.
+            self._add_holiday_may_21(tr("National Spiritual Baptist Day"))
+
+        # Whit Monday.
+        self._add_whit_monday(tr("Whit Monday"))
+
+        # Carnival Monday.
+        name = tr("Carnival Monday")
+        carnival_monday_dates = {
+            2013: (JUL, 8),
+            2018: (JUL, 9),
+            2019: (JUL, 8),
+            2020: (AUG, 3),
+            2021: (SEP, 6),
+            2023: (JUL, 10),
+            2024: (JUL, 8),
+        }
+        dt = (
+            self._add_holiday(name, dt)
+            if (dt := carnival_monday_dates.get(self._year))
+            else self._add_holiday_1st_mon_of_jul(name)
+        )
+
+        # Carnival Tuesday.
+        self._add_holiday(tr("Carnival Tuesday"), _timedelta(dt, +1))
+
+        # Emancipation Day.
+        self._add_observed(self._add_holiday_aug_1(tr("Emancipation Day")))
+
+        # Independence Day.
+        self._add_observed(self._add_holiday_oct_27(tr("Independence Day")))
+
+        # Christmas Day.
+        self._add_observed(self._add_christmas_day(tr("Christmas Day")), rule=SUN_TO_NEXT_TUE)
+
+        # Boxing Day.
+        self._add_observed(self._add_christmas_day_two(tr("Boxing Day")))
+
+
+class VC(SaintVincentAndTheGrenadines):
+    pass
+
+
+class VCT(SaintVincentAndTheGrenadines):
+    pass
+
+
+class SaintVincentAndTheGrenadinesStaticHolidays:
+    """Saint Vincent and the Grenadines special holidays.
+
+    References:
+        * [Statutory Rules and Orders 2021 No.1](https://web.archive.org/web/20250613051716/https://pmoffice.gov.vc/pmoffice/images/PDF/Gazettes/No_1_Proclamation_Delcaring_Friday_the_22nd_and_Monday_25th_day_of_January_2021_to_be_Public_Holidays_in_Saint_Vincent_and_the_Grenadines_19th_January_2021.pdf)
+    """
+
+    # Public Health Holiday.
+    name = tr("Public Health Holiday")
+    special_public_holidays = {
+        2021: (
+            (JAN, 22, name),
+            (JAN, 25, name),
+        ),
+    }