holidays 0.69__py3-none-any.whl → 0.71__py3-none-any.whl

holidays/countries/oman.py

@@ -0,0 +1,185 @@
+#  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.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 gettext import gettext as tr
+
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import (
+    JAN,
+    FEB,
+    MAR,
+    APR,
+    MAY,
+    JUN,
+    JUL,
+    AUG,
+    SEP,
+    OCT,
+    NOV,
+    THU,
+    FRI,
+    SAT,
+    _timedelta,
+)
+from holidays.groups import IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Oman(HolidayBase, IslamicHolidays):
+    """Oman holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Oman>
+        * [Independence](https://www.omaninfo.om/pages/175/show/572)
+        * [Weekend](https://abnnews.com/the-sultanate-of-oman-changes-weekend-days-from-01-may-2013/)
+        * [Decree 56/2020](https://decree.om/2020/rd20200056/)
+        * [Decree 88/2022](https://decree.om/2022/rd20220088/)
+        * [Decree 15/2025 (National day is moved)](https://decree.om/2025/rd20250015/)
+    """
+
+    country = "OM"
+    default_language = "ar"
+    # %s (estimated).
+    estimated_label = tr("%s (مُقدَّر)")
+    start_year = 1970
+    supported_languages = ("ar", "en_US")
+
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
+        IslamicHolidays.__init__(
+            self, cls=OmanIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # Oman switches from THU-FRI to FRI-SAT on May 1, 2013.
+        self.weekend = {THU, FRI} if self._year <= 2013 else {FRI, SAT}
+
+        if self._year >= 2020:
+            # Sultan's Accession Day.
+            self._add_holiday_jan_11(tr("اليوم الوطني لتولي السلطان"))
+
+        if self._year <= 2019:
+            # Renaissance Day.
+            self._add_holiday_jul_23(tr("يوم النهضة"))
+
+        if self._year >= 2020:
+            # National Day.
+            name = tr("يوم وطني")
+            if self._year <= 2024:
+                self._add_holiday_nov_18(name)
+                self._add_holiday_nov_19(name)
+            else:
+                self._add_holiday_nov_20(name)
+                self._add_holiday_nov_21(name)
+
+        # Islamic 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)
+        for dt in self._add_holiday_29_ramadan(name):
+            if _timedelta(dt, +1) not in self:
+                self._add_eid_al_fitr_eve(name)
+
+        # Eid al-Adha.
+        name = tr("عيد الأضحى")
+        self._add_arafah_day(name)
+        self._add_eid_al_adha_day(name)
+        self._add_eid_al_adha_day_two(name)
+        self._add_eid_al_adha_day_three(name)
+
+
+class OM(Oman):
+    pass
+
+
+class OMN(Oman):
+    pass
+
+
+class OmanIslamicHolidays(_CustomIslamicHolidays):
+    # https://www.timeanddate.com/holidays/oman/muharram-new-year
+    HIJRI_NEW_YEAR_DATES = {
+        2018: (SEP, 11),
+        2019: (SEP, 1),
+        2020: (AUG, 21),
+        2021: (AUG, 10),
+        2022: (JUL, 30),
+        2023: (JUL, 20),
+        2024: (JUL, 7),
+    }
+
+    # https://www.timeanddate.com/holidays/oman/prophet-birthday
+    MAWLID_DATES = {
+        2018: (NOV, 20),
+        2019: (NOV, 9),
+        2020: (OCT, 29),
+        2021: (OCT, 19),
+        2022: (OCT, 9),
+        2023: (SEP, 28),
+        2024: (SEP, 15),
+    }
+
+    # https://www.timeanddate.com/holidays/oman/isra-miraj
+    ISRA_AND_MIRAJ_DATES = {
+        2018: (APR, 13),
+        2019: (APR, 3),
+        2020: (MAR, 22),
+        2021: (MAR, 11),
+        2022: (MAR, 1),
+        2023: (FEB, 19),
+        2024: (FEB, 8),
+        2025: (JAN, 27),
+    }
+
+    # https://www.timeanddate.com/holidays/oman/eid-al-adha
+    EID_AL_ADHA_DATES = {
+        2019: (AUG, 11),
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 28),
+        2024: (JUN, 17),
+    }
+
+    # https://www.timeanddate.com/holidays/oman/eid-al-fitr
+    EID_AL_FITR_DATES = {
+        2019: (JUN, 4),
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 2),
+        2023: (APR, 22),
+        2024: (APR, 10),
+        2025: (MAR, 31),
+    }
+
+    # https://www.timeanddate.com/holidays/oman/ramadan-begins
+    RAMADAN_BEGINNING_DATES = {
+        2023: (MAR, 23),
+        2024: (MAR, 12),
+        2025: (MAR, 1),
+    }

holidays/countries/pakistan.py

@@ -4,12 +4,14 @@
 #  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 gettext import gettext as tr
+
 from holidays.calendars import _CustomIslamicHolidays
 from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
 from holidays.groups import InternationalHolidays, IslamicHolidays
@@ -17,13 +19,28 @@ from holidays.holiday_base import HolidayBase
 
 
 class Pakistan(HolidayBase, InternationalHolidays, IslamicHolidays):
+    """Pakistan holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Pakistan>
+        * <https://ur.wikipedia.org/wiki/تعطیلات_پاکستان>
+        * [Public and optional holidays](https://cabinet.gov.pk/Detail/OTE2ODBiYmItZmI0MS00NDAwLWE5NGUtYmE1MGVjYzllMzAz)
+        * [No.10-01/2024-Min-II](https://cabinet.gov.pk/SiteImage/Misc/files/Holidays/28-5-24.pdf)
+    """
+
     country = "PK"
+    default_language = "en_PK"
+    # %s (estimated).
+    estimated_label = tr("%s (estimated)")
     start_year = 1948
+    supported_languages = ("en_PK", "en_US", "ur_PK")
 
     def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
         """
-        :param islamic_show_estimated:
-            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
         """
         InternationalHolidays.__init__(self)
         IslamicHolidays.__init__(
@@ -32,41 +49,49 @@ class Pakistan(HolidayBase, InternationalHolidays, IslamicHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # Kashmir Solidarity Day.
         if self._year >= 1990:
-            self._add_holiday_feb_5("Kashmir Solidarity Day")
+            # Kashmir Solidarity Day.
+            self._add_holiday_feb_5(tr("Kashmir Solidarity Day"))
 
-        # Pakistan Day.
         if self._year >= 1956:
-            self._add_holiday_mar_23("Pakistan Day")
+            # Pakistan Day.
+            self._add_holiday_mar_23(tr("Pakistan Day"))
 
-        # Labour Day.
         if self._year >= 1972:
-            self._add_labor_day("Labour Day")
+            # Labor Day.
+            self._add_labor_day(tr("Labour Day"))
+
+        if self._year >= 2024:
+            # Youm-e-Takbeer.
+            self._add_holiday_may_28(tr("Youm-e-Takbeer"))
 
         # Independence Day.
-        self._add_holiday_aug_14("Independence Day")
+        self._add_holiday_aug_14(tr("Independence Day"))
 
-        # Iqbal Day.
         if self._year <= 2014 or self._year >= 2022:
-            self._add_holiday_nov_9("Iqbal Day")
+            # Iqbal Day.
+            self._add_holiday_nov_9(tr("Iqbal Day"))
 
         # Quaid-e-Azam Day.
-        self._add_holiday_dec_25("Quaid-e-Azam Day")
+        self._add_holiday_dec_25(tr("Quaid-e-Azam Day"))
 
-        name = "Eid-ul-Fitr"
+        # Eid al-Fitr.
+        name = tr("Eid-ul-Fitr")
         self._add_eid_al_fitr_day(name)
         self._add_eid_al_fitr_day_two(name)
         self._add_eid_al_fitr_day_three(name)
 
-        name = "Eid-ul-Adha"
+        # Eid al-Adha.
+        name = tr("Eid-ul-Adha")
         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_mawlid_day("Eid Milad-un-Nabi")
+        # Prophet's Birthday.
+        self._add_mawlid_day(tr("Eid Milad-un-Nabi"))
 
-        name = "Ashura"
+        # Ashura.
+        name = tr("Ashura")
         self._add_ashura_eve(name)
         self._add_ashura_day(name)
 
@@ -101,6 +126,8 @@ class PakistanIslamicHolidays(_CustomIslamicHolidays):
         2020: (AUG, 29),
         2021: (AUG, 18),
         2022: (AUG, 9),
+        2023: (JUL, 28),
+        2024: (JUL, 16),
     }
 
     # https://www.timeanddate.com/holidays/pakistan/eid-ul-azha
@@ -124,6 +151,7 @@ class PakistanIslamicHolidays(_CustomIslamicHolidays):
         2021: (JUL, 21),
         2022: (JUL, 10),
         2023: (JUN, 29),
+        2024: (JUN, 17),
     }
 
     # https://www.timeanddate.com/holidays/pakistan/eid-ul-fitr-1
@@ -148,6 +176,7 @@ class PakistanIslamicHolidays(_CustomIslamicHolidays):
         2022: (MAY, 3),
         2023: (APR, 22),
         2024: (APR, 10),
+        2025: (MAR, 31),
     }
 
     # https://www.timeanddate.com/holidays/pakistan/eid-milad-un-nabi
@@ -170,4 +199,6 @@ class PakistanIslamicHolidays(_CustomIslamicHolidays):
         2020: (OCT, 30),
         2021: (OCT, 19),
         2022: (OCT, 9),
+        2023: (SEP, 29),
+        2024: (SEP, 17),
     }

holidays/countries/palau.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
@@ -17,12 +17,13 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SAT_TO_PREV_FRI,
 
 
 class Palau(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """Palau holidays.
+
     References:
-    - http://www.paclii.org/pw/legis/consol_act/gpt1262/  # Chapter 7, Holidays.
-    - https://www.palaugov.pw/wp-content/uploads/2017/11/RPPL-No.-10-15-re.-Family-Day-Holiday.pdf
-    - https://www.facebook.com/PalauPresident/posts/195883107230463 # EO336 Memorial Day repealed
-    - https://www.taiwanembassy.org/pal_en/post/792.html # Earliest source for President's Day
+        * [Chapter 7, Holidays](http://www.paclii.org/pw/legis/consol_act/gpt1262/)
+        * <https://www.palaugov.pw/wp-content/uploads/2017/11/RPPL-No.-10-15-re.-Family-Day-Holiday.pdf>
+        * [EO336 Memorial Day repealed](https://www.facebook.com/PalauPresident/posts/195883107230463)
+        * [Earliest source for President's Day](https://www.taiwanembassy.org/pal_en/post/792.html)
 
     If any of the holidays enumerated in section 701 of this chapter falls on Sunday, the
     following Monday shall be observed as a holiday. If any of the holidays enumerated in
@@ -105,11 +106,12 @@ class PLW(Palau):
 
 
 class PalauStaticHolidays:
-    """
-    Sources:
-     - https://www.facebook.com/photo?fbid=1774513196034105&set=a.175933635892077
-     - https://www.facebook.com/photo/?fbid=1794692910682800&set=a.175933635892077
-     - https://www.facebook.com/photo/?fbid=1408133829338712&set=a.175933635892077
+    """Palau special holidays.
+
+    References:
+        * <https://www.facebook.com/photo?fbid=1774513196034105&set=a.175933635892077>
+        * <https://www.facebook.com/photo/?fbid=1794692910682800&set=a.175933635892077>
+        * <https://www.facebook.com/photo/?fbid=1408133829338712&set=a.175933635892077>
     """
 
     special_armed_forces_holidays = {

holidays/countries/panama.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
@@ -19,14 +19,15 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON
 
 
 class Panama(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
-    """
+    """Panama holidays.
+
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Panama
-        - `Labor Code 1947 <https://docs.panama.justia.com/federales/leyes/67-de-1947-nov-26-1947.pdf>`_
-        - `Cabinet Decree #347 of 1969 <https://docs.panama.justia.com/federales/decretos-de-gabinete/decreto-de-gabinete-347-de-1969-nov-14-1969.pdf>`_
-        - `Labor Code 1971 <https://www.mitradel.gob.pa/wp-content/uploads/2016/12/c%C3%B3digo-detrabajo.pdf>`_
-        - `Law #4 of Jun 25, 1990 <https://s3-legispan.asamblea.gob.pa/legispan/NORMAS/1990/1990/LEY/Administrador%20Legispan_21570_1990_7_2_ASAMBLEA%20LEGISLATIVA_4.pdf>`_
-        - `Law #55 of Nov 7, 2001 <https://docs.panama.justia.com/federales/leyes/55-de-2001-nov-14-2001.pdf>`_
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Panama>
+        * [Labor Code 1947](https://docs.panama.justia.com/federales/leyes/67-de-1947-nov-26-1947.pdf)
+        * [Cabinet Decree #347 of 1969](https://docs.panama.justia.com/federales/decretos-de-gabinete/decreto-de-gabinete-347-de-1969-nov-14-1969.pdf)
+        * [Labor Code 1971](https://www.mitradel.gob.pa/wp-content/uploads/2016/12/c%C3%B3digo-detrabajo.pdf)
+        * [Law #4 of Jun 25, 1990](https://s3-legispan.asamblea.gob.pa/legispan/NORMAS/1990/1990/LEY/Administrador%20Legispan_21570_1990_7_2_ASAMBLEA%20LEGISLATIVA_4.pdf)
+        * [Law #55 of Nov 7, 2001](https://docs.panama.justia.com/federales/leyes/55-de-2001-nov-14-2001.pdf)
     """
 
     country = "PA"

holidays/countries/papua_new_guinea.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
@@ -18,19 +18,21 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON,
 class PapuaNewGuinea(
     ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays
 ):
-    """
+    """Papua New Guinea holidays.
+
     References:
-      - http://www.paclii.org/pg/legis/consol_act/pha1953163.pdf # Public Holidays Act 1953
-      - https://en.wikipedia.org/wiki/Public_holidays_in_Papua_New_Guinea
-      - https://pnghausbung.com/kings-birthday-holiday-to-be-observed-on-16th-june/
+        * [Public Holidays Act 1953](http://www.paclii.org/pg/legis/consol_act/pha1953163.pdf)
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Papua_New_Guinea>
+        * <https://pnghausbung.com/kings-birthday-holiday-to-be-observed-on-16th-june/>
+
     Checked With:
-      - https://www.ipa.gov.pg/public/Holidays.aspx
-      - https://www.businessadvantagepng.com/papua-new-guinea-public-for-holidays/
-      - https://www.scribd.com/document/465334129/PNG-2019-Gazetted-Public-Holidays-pdf # 2019
-      - https://publicholidays.asia/wp-content/uploads/2020/01/PNG_PublicHolidays_2020.png # 2020
-      - https://publicholidays.asia/wp-content/uploads/2020/12/PNG_PublicHolidays_2021.pdf # 2021
-      - https://publicholidays.asia/wp-content/uploads/2022/01/PNG_PublicHolidays_2022.pdf # 2022
-      - https://publicholidays.asia/wp-content/uploads/2022/12/PNG_PublicHolidays_2023.pdf # 2023
+        * <https://www.ipa.gov.pg/public/Holidays.aspx>
+        * <https://www.businessadvantagepng.com/papua-new-guinea-public-for-holidays/>
+        * [2019](https://www.scribd.com/document/465334129/PNG-2019-Gazetted-Public-Holidays-pdf)
+        * [2020](https://publicholidays.asia/wp-content/uploads/2020/01/PNG_PublicHolidays_2020.png)
+        * [2021](https://publicholidays.asia/wp-content/uploads/2020/12/PNG_PublicHolidays_2021.pdf)
+        * [2022](https://publicholidays.asia/wp-content/uploads/2022/01/PNG_PublicHolidays_2022.pdf)
+        * [2023](https://publicholidays.asia/wp-content/uploads/2022/12/PNG_PublicHolidays_2023.pdf)
 
     Should a holiday listed, other than the Christmas Day, fall on a Sunday the next Monday
     shall, unless the Head of State, acting on advice, declares otherwise, be observed as a
@@ -130,18 +132,20 @@ class PNG(PapuaNewGuinea):
 
 
 class PapuaNewGuineaStaticHolidays:
-    """
-    Starting from 2021 afterwards all state funerals are given special public holidays, though only
-    some are day-off nationwide.
+    """Papua New Guinea special holidays.
 
     References:
-      - 2018 APEC Public Holiday*: https://www.rnz.co.nz/international/pacific-news/369989/papua-new-guinea-declares-apec-holiday
-      - 2021 Sir Mekere Morauta's Funeral: https://pnghausbung.com/friday-8th-declared-a-nation-wide-public-holiday-to-honour-late-sir-mekere/
-      - 2021 Sir Michael Somare's Day of Mourning: https://pnghausbung.com/2-weeks-mourning-period-for-late-sir-micheal-to-start-with-public-holiday-on-monday-pm/
-      - 2022 QE2's Funeral: https://www.thenational.com.pg/column-1-553/
-      - 2023 Sir Rabbie Namaliu's Funeral: https://pnghausbung.com/breaking-public-holiday-tomorrow-in-respect-of-late-sir-rabbies-state-funeral/
+        * [2018 APEC Public Holiday](https://www.rnz.co.nz/international/pacific-news/369989/papua-new-guinea-declares-apec-holiday)
+        * [2021 Sir Mekere Morauta's Funeral](https://pnghausbung.com/friday-8th-declared-a-nation-wide-public-holiday-to-honour-late-sir-mekere/)
+        * [2021 Sir Michael Somare's Day of Mourning](https://pnghausbung.com/2-weeks-mourning-period-for-late-sir-micheal-to-start-with-public-holiday-on-monday-pm/)
+        * [2022 QE2's Funeral](https://www.thenational.com.pg/column-1-553/)
+        * [2023 Sir Rabbie Namaliu's Funeral](https://pnghausbung.com/breaking-public-holiday-tomorrow-in-respect-of-late-sir-rabbies-state-funeral/)
+
+    Nov 15, 2018 is an APEC Holiday too, but for Port Moresby-only:
+    <https://www.businessadvantagepng.com/public-holidays-declared-in-port-moresby-due-to-apec-summit-says-ceo/>
 
-    * Nov 15, 2018 is an APEC Holiday too, but for Port Moresby-only: https://www.businessadvantagepng.com/public-holidays-declared-in-port-moresby-due-to-apec-summit-says-ceo/
+    Starting from 2021 afterwards all state funerals are given special public holidays, though only
+    some are day-off nationwide.
     """
 
     # National Day of Mourning for Sir Michael Somare.

holidays/countries/paraguay.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
@@ -19,15 +19,16 @@ from holidays.holiday_base import HolidayBase
 
 
 class Paraguay(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
-    """
+    """Paraguay holidays.
+
     References:
-        - `Ley 8/1990 <https://www.bacn.gov.py/leyes-paraguayas/2358/ley-n-8--por-la-cual-se-determinan-los-feriados-de-la-republica>`_
-        - `Ley 715/1995 <https://www.bacn.gov.py/leyes-paraguayas/792/ley-n-715--amplia-la-ley-no-0890->`_
-        - `Ley 1.601/2000 <https://www.bacn.gov.py/leyes-paraguayas/1677/ley-n-1601--modifica-el-articulo-1-de-la-ley-no-71595-que-amplia-la-ley-n-0890-por-la-cual-se-determinan-los-feriados-de-la-republica>`_
-        - `Ley 1.723/2001 <https://www.bacn.gov.py/leyes-paraguayas/634/ley-n-1723--autoriza-al-poder-ejecutivo-a-trasladar-los-feriados-nacionales-al-dia-lunes>`_
-        - `Ley 4.531/2011 <https://www.bacn.gov.py/leyes-paraguayas/3831/ley-n-4531-restablece-el-dia-14-de-mayo-de-cada-ano-como-feriado-nacional>`_
-        - https://es.wikipedia.org/wiki/Anexo:D%C3%ADas_festivos_en_Paraguay
-        - http://www.calendarioparaguay.com/
+        * [Ley 8/1990](https://www.bacn.gov.py/leyes-paraguayas/2358/ley-n-8--por-la-cual-se-determinan-los-feriados-de-la-republica)
+        * [Ley 715/1995](https://www.bacn.gov.py/leyes-paraguayas/792/ley-n-715--amplia-la-ley-no-0890-)
+        * [Ley 1.601/2000](https://www.bacn.gov.py/leyes-paraguayas/1677/ley-n-1601--modifica-el-articulo-1-de-la-ley-no-71595-que-amplia-la-ley-n-0890-por-la-cual-se-determinan-los-feriados-de-la-republica)
+        * [Ley 1.723/2001](https://www.bacn.gov.py/leyes-paraguayas/634/ley-n-1723--autoriza-al-poder-ejecutivo-a-trasladar-los-feriados-nacionales-al-dia-lunes)
+        * [Ley 4.531/2011](https://www.bacn.gov.py/leyes-paraguayas/3831/ley-n-4531-restablece-el-dia-14-de-mayo-de-cada-ano-como-feriado-nacional)
+        * <https://es.wikipedia.org/wiki/Anexo:D%C3%ADas_festivos_en_Paraguay>
+        * <http://www.calendarioparaguay.com/>
     """
 
     country = "PY"

holidays/countries/peru.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
@@ -17,12 +17,11 @@ from holidays.holiday_base import HolidayBase
 
 
 class Peru(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    Peru holidays.
+    """Peru holidays.
 
     References:
-    - https://www.gob.pe/feriados
-    - https://es.wikipedia.org/wiki/Anexo:Días_feriados_en_el_Perú
+        * <https://www.gob.pe/feriados>
+        * <https://es.wikipedia.org/wiki/Anexo:Días_feriados_en_el_Perú>
     """
 
     country = "PE"

holidays/countries/philippines.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
@@ -13,7 +13,7 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomChineseHolidays, _CustomIslamicHolidays
-from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
+from holidays.calendars.gregorian import JAN, FEB, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV, DEC
 from holidays.constants import PUBLIC, WORKDAY
 from holidays.groups import (
     ChineseCalendarHolidays,
@@ -33,24 +33,25 @@ class Philippines(
     IslamicHolidays,
     StaticHolidays,
 ):
-    """
-    Philippines holidays.
+    """Philippines holidays.
 
     References:
-      - https://en.wikipedia.org/wiki/Public_holidays_in_the_Philippines
-      - `Revised Administrative Code of 1987 <https://www.officialgazette.gov.ph/1987/07/25/executive-order-no-292-book-ichapter-7-regular-holidays-and-nationwide-special-days/>`_
-      - `Republic Act No. 9177 <https://www.officialgazette.gov.ph/2002/11/13/republic-act-no-9177/>`_
-      - `Republic Act No. 9256 <https://www.officialgazette.gov.ph/2004/02/25/republic-act-no-9256/>`_
-      - `Republic Act No. 9492 <https://www.officialgazette.gov.ph/2007/07/24/republic-act-no-9492/>`_
-      - `Republic Act No. 9645 <https://www.officialgazette.gov.ph/2009/06/12/republic-act-no-9645/>`_
-      - `Republic Act No. 9849 <https://www.officialgazette.gov.ph/2009/12/11/republic-act-no-9849/>`_
-      - `Republic Act No. 10966 <https://www.officialgazette.gov.ph/2017/12/28/republic-act-no-10966/>`_
-      - `Proclamation No. 944/2020` <https://www.officialgazette.gov.ph/2020/05/19/proclamation-no-944-s-2020/>`_
-      - `Proclamation No. 985/2020` <https://www.officialgazette.gov.ph/2020/07/29/proclamation-no-985-s-2020/>`_
-      - `Proclamation No. 665/2024` <https://www.officialgazette.gov.ph/2024/08/15/proclamation-no-665-s-2024/>`_
-      - `Proclamation No. 729/2024` <https://www.officialgazette.gov.ph/2024/10/30/proclamation-no-729-s-2024/>`_
-      - `Nationwide holidays 2018-2025 <https://www.officialgazette.gov.ph/nationwide-holidays/2018/>`_
-      - `2025 Eid'l Fitr and Eid'l Adha Tentative Date <https://melbournepcg.org/?page_id=9779>`_
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_the_Philippines>
+        * [Revised Administrative Code of 1987](https://www.officialgazette.gov.ph/1987/07/25/executive-order-no-292-book-ichapter-7-regular-holidays-and-nationwide-special-days/)
+        * [Republic Act No. 9177](https://www.officialgazette.gov.ph/2002/11/13/republic-act-no-9177/)
+        * [Republic Act No. 9256](https://www.officialgazette.gov.ph/2004/02/25/republic-act-no-9256/)
+        * [Republic Act No. 9492](https://www.officialgazette.gov.ph/2007/07/24/republic-act-no-9492/)
+        * [Republic Act No. 9645](https://www.officialgazette.gov.ph/2009/06/12/republic-act-no-9645/)
+        * [Republic Act No. 9849](https://www.officialgazette.gov.ph/2009/12/11/republic-act-no-9849/)
+        * [Republic Act No. 10966](https://www.officialgazette.gov.ph/2017/12/28/republic-act-no-10966/)
+        * [Proclamation No. 944/2020](https://www.officialgazette.gov.ph/2020/05/19/proclamation-no-944-s-2020/)
+        * [Proclamation No. 985/2020](https://www.officialgazette.gov.ph/2020/07/29/proclamation-no-985-s-2020/)
+        * [Proclamation No. 90/2022](https://www.officialgazette.gov.ph/2022/11/09/proclamation-no-90-s-2022/)
+        * [Proclamation No. 665/2024](https://www.officialgazette.gov.ph/2024/08/15/proclamation-no-665-s-2024/)
+        * [Proclamation No. 729/2024](https://www.officialgazette.gov.ph/2024/10/30/proclamation-no-729-s-2024/)
+        * [Nationwide holidays 2018-2025](https://www.officialgazette.gov.ph/nationwide-holidays/2018/)
+        * [2025 Eid'l Fitr and Eid'l Adha Tentative Date](https://melbournepcg.org/?page_id=9779)
+        * [Proclamation No. 839/2025](https://www.officialgazette.gov.ph/2025/03/20/proclamation-no-839-s-2025/)
     """
 
     country = "PH"
@@ -63,8 +64,10 @@ class Philippines(
 
     def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
         """
-        :param islamic_show_estimated:
-            Whether to add "estimated" label to Islamic holidays name if holiday date is estimated.
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
         """
         ChineseCalendarHolidays.__init__(self, cls=PhilippinesChineseHolidays)
         ChristianHolidays.__init__(self)
@@ -145,6 +148,7 @@ class Philippines(
         dates_obs = {
             2008: (DEC, 1),
             2010: (NOV, 29),
+            2023: (NOV, 27),
         }
         # Bonifacio Day.
         self._add_holiday(tr("Bonifacio Day"), dates_obs.get(self._year, (NOV, 30)))
@@ -258,7 +262,7 @@ class PhilippinesIslamicHolidays(_CustomIslamicHolidays):
         2022: (MAY, 3),
         2023: (APR, 21),
         2024: (APR, 10),
-        2025: (MAR, 31),
+        2025: (APR, 1),
     }