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

holidays/countries/sri_lanka.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
@@ -49,30 +49,31 @@ class SriLanka(
     SinhalaCalendarHolidays,
     StaticHolidays,
 ):
-    """
+    """Sri Lanka holidays.
+
     References:
-    - http://www.commonlii.org/lk/legis/num_act/ha29o1971152/  # No. 29 of 1971 (Holidays Act)
-    - http://www.commonlii.org/lk/legis/num_act/ha21o1991232/  # No. 21 of 1991 (Amendment)
-    - https://web.archive.org/web/20110722150724/http://www.pubad.gov.lk/Holidays/holidays%202003.htm
-    - https://web.archive.org/web/20111018053717/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202004.pdf
-    - https://web.archive.org/web/20241120204015/https://documents.gov.lk/en/calendar.php
+        * [No. 29 of 1971 (Holidays Act)](http://www.commonlii.org/lk/legis/num_act/ha29o1971152)
+        * [No. 21 of 1991 (Amendment)](http://www.commonlii.org/lk/legis/num_act/ha21o1991232)
+        * <https://web.archive.org/web/20110722150724/http://www.pubad.gov.lk/Holidays/holidays%202003.htm>
+        * <https://web.archive.org/web/20111018053717/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202004.pdf>
+        * <https://web.archive.org/web/20241120204015/https://documents.gov.lk/en/calendar.php>
 
     Cross-Checked With:
-    - https://web.archive.org/web/20111018053927/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202005.pdf
-    - https://web.archive.org/web/20111018061003/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202006.pdf
-    - https://web.archive.org/web/20110722150032/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202007.pdf
-    - https://web.archive.org/web/20111018071837/http://www.pubad.gov.lk/Holidays/PublicBankHolidays2008.pdf
-    - https://web.archive.org/web/20120309065711/http://www.pubad.gov.lk/Holidays/Public&BankHolidays2009.pdf
-    - https://web.archive.org/web/20111018071247/http://www.pubad.gov.lk/Holidays/Public&BankHolidays2010.pdf
-    - https://web.archive.org/web/20110722151043/http://www.pubad.gov.lk/Holidays/Public&BankHolidays2011.pdf
-    - https://web.archive.org/web/20111125074237/http://www.pubad.gov.lk/Holidays/Public&BankHolidays2012.pdf
-    - https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2019
-    - https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2020
-    - https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2021
-    - https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2022
-    - https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2023
-    - https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2024
-    - https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2025
+        * <https://web.archive.org/web/20111018053927/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202005.pdf>
+        * <https://web.archive.org/web/20111018061003/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202006.pdf>
+        * <https://web.archive.org/web/20110722150032/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202007.pdf>
+        * <https://web.archive.org/web/20111018071837/http://www.pubad.gov.lk/Holidays/PublicBankHolidays2008.pdf>
+        * <https://web.archive.org/web/20120309065711/http://www.pubad.gov.lk/Holidays/Public&BankHolidays2009.pdf>
+        * <https://web.archive.org/web/20111018071247/http://www.pubad.gov.lk/Holidays/Public&BankHolidays2010.pdf>
+        * <https://web.archive.org/web/20110722151043/http://www.pubad.gov.lk/Holidays/Public&BankHolidays2011.pdf>
+        * <https://web.archive.org/web/20111125074237/http://www.pubad.gov.lk/Holidays/Public&BankHolidays2012.pdf>
+        * <https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2019>
+        * <https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2020>
+        * <https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2021>
+        * <https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2022>
+        * <https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2023>
+        * <https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2024>
+        * <https://www.cbsl.gov.lk/en/about/about-the-bank/bank-holidays-2025>
     """
 
     country = "LK"
@@ -89,8 +90,10 @@ class SriLanka(
 
     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.
         """
         ChristianHolidays.__init__(self)
         HinduCalendarHolidays.__init__(self, SriLankaHinduHolidays)
@@ -370,25 +373,26 @@ class SriLankaIslamicHolidays(_CustomIslamicHolidays):
 
 
 class SriLankaStaticHolidays:
-    """
+    """Sri Lanka special holdays.
+
     References:
-    - https://www.adaderana.lk/news.php?nid=13026
-    - https://www.adaderana.lk/news.php?nid=17539
-    - https://www.adaderana.lk/news.php?nid=22168
-    - https://www.adaderana.lk/news.php?nid=34870
-    - https://www.adaderana.lk/news.php?nid=55146
-    - https://www.adaderana.lk/news.php?nid=61437
-    - https://www.adaderana.lk/news.php?nid=64367
-    - https://www.adaderana.lk/news.php?nid=81686
-    - https://www.adaderana.lk/news.php?nid=82111
-    - https://www.adaderana.lk/news.php?nid=82979
-    - https://www.adaderana.lk/news.php?nid=83082
-    - https://www.adaderana.lk/news.php?nid=84035
-    - https://www.adaderana.lk/news.php?nid=98560
-    - https://www.adaderana.lk/news.php?nid=102125
-    - https://web.archive.org/web/20110722150724/http://www.pubad.gov.lk/Holidays/holidays%202003.htm
-    - https://web.archive.org/web/20111018053717/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202004.pdf
-    - https://web.archive.org/web/20241120204015/https://documents.gov.lk/en/calendar.php
+        * <https://www.adaderana.lk/news.php?nid=13026>
+        * <https://www.adaderana.lk/news.php?nid=17539>
+        * <https://www.adaderana.lk/news.php?nid=22168>
+        * <https://www.adaderana.lk/news.php?nid=34870>
+        * <https://www.adaderana.lk/news.php?nid=55146>
+        * <https://www.adaderana.lk/news.php?nid=61437>
+        * <https://www.adaderana.lk/news.php?nid=64367>
+        * <https://www.adaderana.lk/news.php?nid=81686>
+        * <https://www.adaderana.lk/news.php?nid=82111>
+        * <https://www.adaderana.lk/news.php?nid=82979>
+        * <https://www.adaderana.lk/news.php?nid=83082>
+        * <https://www.adaderana.lk/news.php?nid=84035>
+        * <https://www.adaderana.lk/news.php?nid=98560>
+        * <https://www.adaderana.lk/news.php?nid=102125>
+        * <https://web.archive.org/web/20110722150724/http://www.pubad.gov.lk/Holidays/holidays%202003.htm>
+        * <https://web.archive.org/web/20111018053717/http://www.pubad.gov.lk/Holidays/Public%20&%20Bank%20Holidays%202004.pdf>
+        * <https://web.archive.org/web/20241120204015/https://documents.gov.lk/en/calendar.php>
     """
 
     # Adhi Binara Full Moon Poya Day.

holidays/countries/suriname.py

@@ -0,0 +1,227 @@
+#  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 import HolidayBase
+from holidays.calendars import _CustomHinduHolidays, _CustomIslamicHolidays
+from holidays.calendars.gregorian import MAR, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV
+from holidays.groups import (
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    HinduCalendarHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+)
+
+
+class Suriname(
+    HolidayBase,
+    ChineseCalendarHolidays,
+    ChristianHolidays,
+    HinduCalendarHolidays,
+    InternationalHolidays,
+    IslamicHolidays,
+):
+    """Suriname holidays.
+
+    References:
+        * [Besluit Vrije Dagen 1971](https://web.archive.org/web/20250411201210/https://www.sris.sr/wp-content/uploads/2022/10/Besluit-Vrije-dagen-GB-1971-no-78.pdf)
+        * https://web.archive.org/web/20240416223555/https://gov.sr/wp-content/uploads/2022/09/arbeidswet.pdf
+        * [S.B. 2007 no. 98](https://web.archive.org/web/20250411204836/https://www.sris.sr/wp-content/uploads/2021/10/SB-2007-no-98-besluit-vrije-dagen.pdf)
+        * [S.B. 2012 no. 21](https://web.archive.org/web/20250411204754/https://www.sris.sr/wp-content/uploads/2021/10/SB-2012-no-21-besluit-vrije-dagen.pdf)
+        * [S.B. 2021 no. 27](https://web.archive.org/web/20250411210516/https://www.sris.sr/wp-content/uploads/2021/03/S.B.-2021-no.-27-houdende-nadere-wijziging-van-het-Besluit-Vrije-Dagen-1971.pdf)
+        * [S.B. 2024 no. 167](https://web.archive.org/web/20250411211129/https://www.sris.sr/wp-content/uploads/2025/01/S.B.-2024-no.-167-Algemene-termijnenwet.pdf)
+
+    Note:
+        The oldest decree available online that underpins the public holidays defined here
+        for Suriname is Besluit Vrije Dagen 1971 of April 22, 1971.
+
+        The S.B. 2024 no. 167 law only applies to prolongations of terms specified in contracts
+        and other similar legal documents, and does not apply to labor agreements (and days off).
+    """
+
+    country = "SR"
+    default_language = "nl"
+    # %s (estimated).
+    estimated_label = tr("%s (geschat)")
+    start_year = 1972
+    supported_languages = ("en_US", "nl")
+
+    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.
+        """
+        ChineseCalendarHolidays.__init__(self)
+        ChristianHolidays.__init__(self)
+        HinduCalendarHolidays.__init__(self, cls=SurinameHinduHolidays)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=SurinameIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day(tr("Nieuwjaarsdag"))
+
+        if 1981 <= self._year <= 1992 or 2012 <= self._year <= 2020:
+            # Day of Liberation and Renewal.
+            self._add_holiday_feb_25(tr("Dag van Bevrijding en Vernieuwing"))
+
+        # Good Friday.
+        self._add_good_friday(tr("Goede Vrijdag"))
+
+        # Easter Monday.
+        self._add_easter_monday(tr("Tweede Paasdag"))
+
+        if self._year <= 1975:
+            # Birthday of H.M. the Queen.
+            self._add_holiday_apr_30(tr("Verjaardag van H.M. de Koningin"))
+
+        # Labor Day.
+        self._add_labor_day(tr("Dag van de Arbeid"))
+
+        self._add_holiday_jul_1(
+            # Day of Freedoms.
+            tr("Keti Koti Dey") if 2008 <= self._year <= 2024 else tr("Dag der Vrijheden")
+        )
+
+        if self._year >= 2007:
+            # Indigenous People Day.
+            self._add_holiday_aug_9(tr("Dag der Inheemsen"))
+
+        if self._year >= 2012:
+            # Day of the Maroons.
+            self._add_holiday_oct_10(tr("Dag der Marrons"))
+
+        if self._year >= 1976:
+            name = (
+                # Independence Day.
+                tr("Onafhankelijkheidsdag")
+                if self._year >= 2008
+                # Republic Day.
+                else tr("Dag van de Republiek")
+            )
+            self._add_holiday_nov_25(name)
+
+        # Christmas Day.
+        self._add_christmas_day(tr("Eerste Kerstdag"))
+
+        # Second Day of Christmas.
+        self._add_christmas_day_two(tr("Tweede Kerstdag"))
+
+        # Holi.
+        self._add_holi(tr("Holi-Phagwa"))
+
+        if self._year >= 2012:
+            # Diwali.
+            self._add_diwali(tr("Divali"))
+
+        # Eid al-Fitr.
+        self._add_eid_al_fitr_day(tr("Ied-Ul-Fitre"))
+
+        if self._year >= 2012:
+            # Eid al-Adha.
+            self._add_eid_al_adha_day(tr("Ied-Ul-Adha"))
+
+        if self._year >= 2022:
+            # Chinese New Year.
+            self._add_chinese_new_years_day(tr("Chinees Nieuwjaar"))
+
+
+class SurinameHinduHolidays(_CustomHinduHolidays):
+    # https://www.timeanddate.com/holidays/suriname/holi-phagwa
+    HOLI_DATES = {
+        2015: (MAR, 6),
+        2016: (MAR, 23),
+        2017: (MAR, 12),
+        2018: (MAR, 2),
+        2019: (MAR, 21),
+        2020: (MAR, 9),
+        2021: (MAR, 28),
+        2022: (MAR, 18),
+        2023: (MAR, 7),
+        2024: (MAR, 25),
+        2025: (MAR, 14),
+        2026: (MAR, 3),
+        2027: (MAR, 22),
+        2028: (MAR, 11),
+        2029: (MAR, 28),
+        2030: (MAR, 19),
+    }
+
+    # https://www.timeanddate.com/holidays/suriname/diwali
+    DIWALI_DATES = {
+        2014: (OCT, 23),
+        2015: (NOV, 11),
+        2016: (OCT, 30),
+        2017: (OCT, 19),
+        2018: (NOV, 7),
+        2019: (OCT, 27),
+        2020: (NOV, 14),
+        2021: (NOV, 4),
+        2022: (OCT, 24),
+        2023: (NOV, 12),
+        2024: (OCT, 31),
+        2025: (OCT, 20),
+        2026: (NOV, 8),
+        2027: (OCT, 28),
+        2028: (OCT, 17),
+        2029: (NOV, 5),
+        2030: (OCT, 25),
+    }
+
+
+class SurinameIslamicHolidays(_CustomIslamicHolidays):
+    # https://www.timeanddate.com/holidays/suriname/eid-al-fitr
+    EID_AL_FITR_DATES = {
+        2014: (JUL, 29),
+        2015: (JUL, 18),
+        2016: (JUL, 7),
+        2017: (JUN, 26),
+        2018: (JUN, 15),
+        2019: (JUN, 5),
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 2),
+        2023: (APR, 22),
+        2024: (APR, 10),
+        2025: (MAR, 31),
+    }
+
+    # https://www.timeanddate.com/holidays/suriname/eid-al-adha
+    EID_AL_ADHA_DATES = {
+        2014: (OCT, 5),
+        2015: (SEP, 24),
+        2016: (SEP, 13),
+        2017: (SEP, 2),
+        2018: (AUG, 21),
+        2019: (AUG, 12),
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 29),
+        2024: (JUN, 16),
+        2025: (JUN, 7),
+    }
+
+
+class SR(Suriname):
+    pass
+
+
+class SUR(Suriname):
+    pass

holidays/countries/sweden.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,31 +18,32 @@ from holidays.holiday_base import HolidayBase
 
 
 class Sweden(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    Swedish holidays.
-    Note that holidays falling on a sunday are "lost",
-    it will not be moved to another day to make up for the collision.
-    In Sweden, ALL sundays are considered a holiday
-    (https://sv.wikipedia.org/wiki/Helgdagar_i_Sverige).
-    Initialize this class with include_sundays=False
-    to not include sundays as a holiday.
-
-    Primary sources:
-        - https://sv.wikipedia.org/wiki/Helgdagar_i_Sverige
-        - http://www.riksdagen.se/sv/dokument-lagar/dokument/svensk-forfattningssamling/lag-1989253-om-allmanna-helgdagar_sfs-1989-253
-        - https://sv.wikipedia.org/wiki/F%C3%B6rsta_maj
-        - https://sv.wikipedia.org/wiki/Sveriges_nationaldag
-        - https://sv.wikipedia.org/wiki/Midsommarafton
+    """Sweden holidays.
+
+    References:
+        * <https://sv.wikipedia.org/wiki/Helgdagar_i_Sverige>
+        * <http://www.riksdagen.se/sv/dokument-lagar/dokument/svensk-forfattningssamling/lag-1989253-om-allmanna-helgdagar_sfs-1989-253>
+        * <https://sv.wikipedia.org/wiki/F%C3%B6rsta_maj>
+        * <https://sv.wikipedia.org/wiki/Sveriges_nationaldag>
+        * <https://sv.wikipedia.org/wiki/Midsommarafton>
+
+
+    Note that holidays falling on a sunday is "lost", it will not be moved
+    to another day to make up for the collision.
+
+    In Sweden, ALL sundays are considered a holiday.
+    Initialize this class with `include_sundays=False` to not include sundays as a holiday.
     """
 
     country = "SE"
     default_language = "sv"
     supported_languages = ("en_US", "sv", "th", "uk")
 
-    def __init__(self, include_sundays=True, *args, **kwargs):
+    def __init__(self, include_sundays: bool = True, *args, **kwargs):
         """
-        :param include_sundays:
-            Whether to consider sundays as a holiday (which they are in Sweden)
+        Args:
+            include_sundays:
+                Whether to consider sundays as a holiday (which they are in Sweden)
         """
         self.include_sundays = include_sundays
         ChristianHolidays.__init__(self)

holidays/countries/switzerland.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,11 +19,12 @@ from holidays.observed_holiday_base import ObservedHolidayBase, MON_ONLY, TUE_TO
 
 
 class Switzerland(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """Switzerland holidays.
+
     References:
-        - https://www.bj.admin.ch/dam/bj/de/data/publiservice/service/zivilprozessrecht/kant-feiertage.pdf
-        - https://de.wikipedia.org/wiki/Feiertage_in_der_Schweiz
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Switzerland
+        * <https://www.bj.admin.ch/dam/bj/de/data/publiservice/service/zivilprozessrecht/kant-feiertage.pdf>
+        * <https://de.wikipedia.org/wiki/Feiertage_in_der_Schweiz>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Switzerland>
     """
 
     country = "CH"

holidays/countries/taiwan.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
@@ -12,6 +12,7 @@
 
 from datetime import date
 from gettext import gettext as tr
+from typing import Optional
 
 from holidays.calendars.gregorian import (
     JAN,
@@ -45,27 +46,28 @@ CHILDRENS_DAY_RULE = ObservedRule({MON: +1, TUE: -1, WED: -1, THU: +1, FRI: -1,
 
 
 class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays, StaticHolidays):
-    """
+    """Taiwan holidays.
+
+    References:
+        * <https://zh.wikipedia.org/wiki/中華民國節日與歲時列表>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Taiwan>
+
     Commemorative Day and Day Implementation Method Amendments:
-        - `Ministry of Interior (87) Order No. 8706459 <https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國87年)>`_
-        - `Ministry of Interior (88) Order No. 8897074 <https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國88年)>`_
-        - `Ministry of Interior (89) Order No. 8972185 <https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國89年2月)>`_
-        - `Ministry of Interior (89) Order No. 8962562 <https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國89年12月)>`_
-        - `Ministry of Interior Order No. 0950045320 <https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20060309&lser=001>`_
-        - `Ministry of Interior Order No. 0960110433 <https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20070711&lser=001>`_
-        - `Ministry of Interior Order No. 0960131407 <https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20070711&lser=001>`_
-        - `Ministry of Interior Order No. 0960155673 <https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20071003&lser=001>`_
-        - `Ministry of Interior Order No. 0990212117 <https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20101102&lser=001>`_
-        - `Ministry of Interior Order No. 1010307327 and 1030128812 <https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20120925&lser=001>`_
-        - `Ministry of Interior Order No. 1030182404 <https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode=D0020033>`_
-
-    Other References:
-        - https://zh.wikipedia.org/wiki/中華民國節日與歲時列表
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Taiwan
+        * [Ministry of Interior (87) Order No. 8706459](https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國87年))
+        * [Ministry of Interior (88) Order No. 8897074](https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國88年))
+        * [Ministry of Interior (89) Order No. 8972185](https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國89年2月))
+        * [Ministry of Interior (89) Order No. 8962562](https://zh.wikisource.org/wiki/紀念日及節日實施辦法_(民國89年12月))
+        * [Ministry of Interior Order No. 0950045320](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20060309&lser=001)
+        * [Ministry of Interior Order No. 0960110433](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20070711&lser=001)
+        * [Ministry of Interior Order No. 0960131407](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20070711&lser=001)
+        * [Ministry of Interior Order No. 0960155673](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20071003&lser=001)
+        * [Ministry of Interior Order No. 0990212117](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20101102&lser=001)
+        * [Ministry of Interior Order No. 1010307327 and 1030128812](https://law.moj.gov.tw/LawClass/LawOldVer.aspx?pcode=D0020033&lnndate=20120925&lser=001)
+        * [Ministry of Interior Order No. 1030182404](https://law.moj.gov.tw/LawClass/LawAll.aspx?pcode=D0020033)
 
     Checked With:
-        - `DGPA Work Calendar (1998-2025; Chinese) <https://www.dgpa.gov.tw/informationlist?uid=30>`_
-        - `DGPA Work Calendar (2001-2025; English) <https://www.dgpa.gov.tw/en/informationlist?uid=353>`_
+        * [DGPA Work Calendar (1998-2025; Chinese)](https://www.dgpa.gov.tw/informationlist?uid=30)
+        * [DGPA Work Calendar (2001-2025; English)](https://www.dgpa.gov.tw/en/informationlist?uid=353)
     """
 
     country = "TW"
@@ -85,7 +87,7 @@ class Taiwan(ObservedHolidayBase, ChineseCalendarHolidays, InternationalHolidays
         super().__init__(*args, **kwargs)
 
     def _populate_observed(
-        self, dts: set[date], rule: ObservedRule = None, since: int = 2015
+        self, dts: set[date], rule: Optional[ObservedRule] = None, since: int = 2015
     ) -> None:
         """
         Taiwan's General Observance Rule first started in 2015 as per
@@ -263,36 +265,37 @@ class TWN(Taiwan):
 
 
 class TaiwanStaticHolidays:
-    """
+    """Taiwan special holidays.
+
     DGPA, Executive Yuan Work Calendars:
-        - `1998 <https://www.dgpa.gov.tw/information?uid=30&pid=4979>`_
-        - `1999 <https://www.dgpa.gov.tw/information?uid=30&pid=4978>`_
-        - `2000 <https://www.dgpa.gov.tw/information?uid=30&pid=4977>`_
-        - `2001 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6199>`_
-        - `2002 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6198>`_
-        - `2003 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6197>`_
-        - `2004 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6196>`_
-        - `2005 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6195>`_
-        - `2006 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6192>`_
-        - `2007 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6194>`_
-        - `2008 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6191>`_
-        - `2009 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6190>`_
-        - `2010 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6189>`_
-        - `2011 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6188>`_
-        - `2012 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6187>`_
-        - `2013 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6186>`_
-        - `2014 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6183>`_
-        - `2015 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6182>`_
-        - `2016 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6180>`_
-        - `2017 <https://www.dgpa.gov.tw/en/information?uid=353&pid=6178>`_
-        - `2018 <https://www.dgpa.gov.tw/en/information?uid=353&pid=7730>`_
-        - `2019 <https://www.dgpa.gov.tw/en/information?uid=353&pid=8178>`_
-        - `2020 <https://www.dgpa.gov.tw/en/information?uid=353&pid=9724>`_
-        - `2021 <https://www.dgpa.gov.tw/en/information?uid=353&pid=10181>`_
-        - `2022 <https://www.dgpa.gov.tw/en/information?uid=353&pid=10659>`_
-        - `2023 <https://www.dgpa.gov.tw/en/information?uid=353&pid=11016>`_
-        - `2024 <https://www.dgpa.gov.tw/en/information?uid=353&pid=11402>`_
-        - `2025 <https://www.dgpa.gov.tw/en/information?uid=353&pid=11979>`_
+        * [1998](https://www.dgpa.gov.tw/information?uid=30&pid=4979)
+        * [1999](https://www.dgpa.gov.tw/information?uid=30&pid=4978)
+        * [2000](https://www.dgpa.gov.tw/information?uid=30&pid=4977)
+        * [2001](https://www.dgpa.gov.tw/en/information?uid=353&pid=6199)
+        * [2002](https://www.dgpa.gov.tw/en/information?uid=353&pid=6198)
+        * [2003](https://www.dgpa.gov.tw/en/information?uid=353&pid=6197)
+        * [2004](https://www.dgpa.gov.tw/en/information?uid=353&pid=6196)
+        * [2005](https://www.dgpa.gov.tw/en/information?uid=353&pid=6195)
+        * [2006](https://www.dgpa.gov.tw/en/information?uid=353&pid=6192)
+        * [2007](https://www.dgpa.gov.tw/en/information?uid=353&pid=6194)
+        * [2008](https://www.dgpa.gov.tw/en/information?uid=353&pid=6191)
+        * [2009](https://www.dgpa.gov.tw/en/information?uid=353&pid=6190)
+        * [2010](https://www.dgpa.gov.tw/en/information?uid=353&pid=6189)
+        * [2011](https://www.dgpa.gov.tw/en/information?uid=353&pid=6188)
+        * [2012](https://www.dgpa.gov.tw/en/information?uid=353&pid=6187)
+        * [2013](https://www.dgpa.gov.tw/en/information?uid=353&pid=6186)
+        * [2014](https://www.dgpa.gov.tw/en/information?uid=353&pid=6183)
+        * [2015](https://www.dgpa.gov.tw/en/information?uid=353&pid=6182)
+        * [2016](https://www.dgpa.gov.tw/en/information?uid=353&pid=6180)
+        * [2017](https://www.dgpa.gov.tw/en/information?uid=353&pid=6178)
+        * [2018](https://www.dgpa.gov.tw/en/information?uid=353&pid=7730)
+        * [2019](https://www.dgpa.gov.tw/en/information?uid=353&pid=8178)
+        * [2020](https://www.dgpa.gov.tw/en/information?uid=353&pid=9724)
+        * [2021](https://www.dgpa.gov.tw/en/information?uid=353&pid=10181)
+        * [2022](https://www.dgpa.gov.tw/en/information?uid=353&pid=10659)
+        * [2023](https://www.dgpa.gov.tw/en/information?uid=353&pid=11016)
+        * [2024](https://www.dgpa.gov.tw/en/information?uid=353&pid=11402)
+        * [2025](https://www.dgpa.gov.tw/en/information?uid=353&pid=11979)
     """
 
     # Date format (see strftime() Format Codes).