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

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,26 @@ 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/تعطیلات_پاکستان>
+    """
+
     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 +47,45 @@ 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"))
 
         # 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 +120,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 +145,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
@@ -170,4 +192,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),
     }
 
 

holidays/countries/poland.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,11 +18,12 @@ from holidays.holiday_base import HolidayBase
 
 
 class Poland(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
-    """
+    """Poland holidays.
+
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Poland
-        - https://pl.wikipedia.org/wiki/Dni_wolne_od_pracy_w_Polsce
-        - https://isap.sejm.gov.pl/isap.nsf/DocDetails.xsp?id=WDU20240001965
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Poland>
+        * <https://pl.wikipedia.org/wiki/Dni_wolne_od_pracy_w_Polsce>
+        * <https://isap.sejm.gov.pl/isap.nsf/DocDetails.xsp?id=WDU20240001965>
     """
 
     country = "PL"

holidays/countries/portugal.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,22 +18,20 @@ from holidays.holiday_base import HolidayBase
 
 
 class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    A subclass of :py:class:`HolidayBase` representing public holidays
-    in Portugal.
+    """Portugal holidays.
 
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Portugal
-        - `Labour Day <https://www.e-konomista.pt/dia-do-trabalhador/>`_
-        - Portugal Day - Decreto 17.171
-        - Restoration of Independence Day - Gazeta de Lisboa, 8 de Dezembro
-          de 1823 (n.º 290), pp. 1789 e 1790
-        - Azores
-            - https://files.dre.pt/1s/1980/08/19200/23052305.pdf
-        - Madeira
-            - https://files.dre.pt/1s/1979/11/25900/28782878.pdf
-            - https://files.dre.pt/1s/1989/02/02800/04360436.pdf
-            - https://files.dre.pt/1s/2002/11/258a00/71837183.pdf
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Portugal>
+        * [Labour Day](https://www.e-konomista.pt/dia-do-trabalhador/)
+        * Portugal Day - Decreto 17.171
+        * Restoration of Independence Day - Gazeta de Lisboa, 8 de Dezembro
+            de 1823 (n.º 290), pp. 1789 e 1790
+        * Azores:
+            * <https://files.dre.pt/1s/1980/08/19200/23052305.pdf>
+        * Madeira:
+            * <https://files.dre.pt/1s/1979/11/25900/28782878.pdf>
+            * <https://files.dre.pt/1s/1989/02/02800/04360436.pdf>
+            * <https://files.dre.pt/1s/2002/11/258a00/71837183.pdf>
     """
 
     country = "PT"

holidays/countries/puerto_rico.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
@@ -15,9 +15,11 @@ from holidays.countries.united_states import US
 
 
 class HolidaysPR(US):
-    # Alias of a US subdivision that is also officially assigned its own
-    # country code in ISO 3166-1.  See
-    # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
+    """Puerto Rico holidays.
+
+    Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
+    See <https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1>
+    """
 
     country = "PR"
     supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)