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

holidays/countries/qatar.py

@@ -0,0 +1,172 @@
+#  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,
+    MAR,
+    APR,
+    MAY,
+    JUN,
+    JUL,
+    AUG,
+    SEP,
+    OCT,
+    NOV,
+    DEC,
+    THU,
+    FRI,
+    SAT,
+)
+from holidays.constants import BANK, PUBLIC
+from holidays.groups import InternationalHolidays, IslamicHolidays, StaticHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Qatar(HolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays):
+    """Qatar holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Qatar>
+        * [National Sports Day](https://hukoomi.gov.qa/en/national-sport-day)
+        * [Qatar National Day](https://www.qatar.qa/en/qatar/history-of-qatar-qatar-national-day-committee/)
+        * [Weekend](https://www.arabnews.com/node/234601)
+    """
+
+    country = "QA"
+    default_language = "ar_QA"
+    # %s (estimated).
+    estimated_label = tr("%s (المقدرة)")
+    start_year = 1971
+    supported_categories = (BANK, PUBLIC)
+    supported_languages = ("ar_QA", "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.
+        """
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=QatarIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        StaticHolidays.__init__(self, QatarStaticHolidays)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # Qatar switches from THU-FRI to FRI-SAT on Aug 1, 2003.
+        self.weekend = {THU, FRI} if self._year <= 2003 else {FRI, SAT}
+
+        if self._year >= 2012:
+            # National Sports Day.
+            self._add_holiday_2nd_tue_of_feb(tr("اليوم الوطني للرياضة"))
+
+        if self._year >= 2007:
+            # Qatar National Day.
+            self._add_holiday_dec_18(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)
+
+    def _populate_bank_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day(tr("رأس السنة الميلادية"))
+
+        if self._year >= 2010:
+            # March Bank Holiday.
+            self._add_holiday_1st_sun_of_mar(tr("عطلة البنك"))
+
+
+class QA(Qatar):
+    pass
+
+
+class QAT(Qatar):
+    pass
+
+
+class QatarIslamicHolidays(_CustomIslamicHolidays):
+    # https://www.timeanddate.com/holidays/qatar/eid-al-adha
+    EID_AL_ADHA_DATES = {
+        2005: (JAN, 21),
+        2006: ((JAN, 10), (DEC, 31)),
+        2007: (DEC, 20),
+        2008: (DEC, 9),
+        2009: (NOV, 28),
+        2010: (NOV, 15),
+        2011: (NOV, 6),
+        2012: (OCT, 26),
+        2013: (OCT, 15),
+        2014: (OCT, 4),
+        2015: (SEP, 23),
+        2016: (SEP, 10),
+        2017: (AUG, 31),
+        2018: (AUG, 22),
+        2019: (AUG, 11),
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 28),
+        2024: (JUN, 16),
+    }
+
+    # https://www.timeanddate.com/holidays/qatar/eid-al-fitr
+    EID_AL_FITR_DATES = {
+        2005: (NOV, 4),
+        2006: (OCT, 24),
+        2007: (OCT, 13),
+        2008: (OCT, 2),
+        2009: (SEP, 21),
+        2010: (SEP, 10),
+        2011: (AUG, 31),
+        2012: (AUG, 19),
+        2013: (AUG, 8),
+        2014: (JUL, 28),
+        2015: (JUL, 18),
+        2016: (JUL, 6),
+        2017: (JUN, 25),
+        2018: (JUN, 15),
+        2019: (JUN, 4),
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 2),
+        2023: (APR, 21),
+        2024: (APR, 10),
+        2025: (MAR, 30),
+    }
+
+
+class QatarStaticHolidays:
+    """Qatar special holidays.
+
+    References:
+        * [New Year's Holiday](https://www.expatica.com/qa/lifestyle/holidays/qatar-public-holidays-74585/)
+    """
+
+    # New Year's Holiday.
+    name = tr("عطلة رأس السنة")
+    special_public_holidays = {
+        2025: (JAN, 2, name),
+    }

holidays/countries/romania.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,9 +18,11 @@ from holidays.holiday_base import HolidayBase
 
 
 class Romania(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    https://en.wikipedia.org/wiki/Public_holidays_in_Romania
-    http://www.dreptonline.ro/legislatie/codul_muncii.php
+    """Romania holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Romania>
+        * <http://www.dreptonline.ro/legislatie/codul_muncii.php>
     """
 
     country = "RO"

holidays/countries/russia.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,9 +19,11 @@ from holidays.observed_holiday_base import ObservedHolidayBase
 
 
 class Russia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
-    """
-    https://en.wikipedia.org/wiki/Public_holidays_in_Russia
-    https://ru.wikipedia.org/wiki/Праздники_России
+    """Russia holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Russia>
+        * <https://ru.wikipedia.org/wiki/Праздники_России>
     """
 
     country = "RU"

holidays/countries/saint_kitts_and_nevis.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.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON,
 class SaintKittsAndNevis(
     ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays
 ):
-    """
+    """Saint Kitts and Nevis holidays.
+
     References:
-      - https://lawcommission.gov.kn/wp-content/documents/Revised-Acts-of-St-Kitts-and-Nevis/Revised-Acts-of-St-Kitts-and-Nevis-2009/Ch-23_23-Public-Holidays-Act.pdf
-      - https://web.archive.org/web/20220124000224/https://aglcskn.info/wp-content/documents/Act02and09TOC/Ch-23_23-Public-Holidays-Act.pdf
-      - https://en.wikipedia.org/wiki/Public_holidays_in_Saint_Kitts_and_Nevis
+        * <https://lawcommission.gov.kn/wp-content/documents/Revised-Acts-of-St-Kitts-and-Nevis/Revised-Acts-of-St-Kitts-and-Nevis-2009/Ch-23_23-Public-Holidays-Act.pdf>
+        * <https://web.archive.org/web/20220124000224/https://aglcskn.info/wp-content/documents/Act02and09TOC/Ch-23_23-Public-Holidays-Act.pdf>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Saint_Kitts_and_Nevis>
 
     Cross-Checked With:
-      - https://sknhcottawa.gov.kn/in-skn-national-public-holidays/
-      - https://www.timeanddate.com/holidays/saint-kitts-and-nevis/
+        * <https://sknhcottawa.gov.kn/in-skn-national-public-holidays/>
+        * <https://www.timeanddate.com/holidays/saint-kitts-and-nevis/>
 
     If Sovereign's Birthday, New Year's Day, Independence Day, or National Heroes Day
     fall on a Sunday the next following Monday shall be a public holiday.
@@ -121,21 +122,22 @@ class KNA(SaintKittsAndNevis):
 
 
 class SaintKittsAndNevisStaticHolidays:
-    """
-    References
-     - https://www.sknis.gov.kn/2023/07/17/state-funeral-accorded-to-sir-tapley-national-day-of-mourning-and-half-holiday-declared-for-july-20/
-     - https://www.sknis.gov.kn/2022/12/30/public-holiday-notice-request-from-the-department-of-labour/
-     - https://www.sknis.gov.kn/2022/08/06/prime-minister-drew-declares-monday-august-08-2022-as-a-public-holiday-in-st-kitts-and-nevis/
-     - https://www.sknis.gov.kn/2022/04/20/nia-announces-half-holiday/
-     - https://www.sknis.gov.kn/2021/07/26/governor-general-proclaims-tuesday-3rd-august-2021-as-a-public-holiday/
-     - https://nia.gov.kn/culturama-47-rescheduled-to-independence-holiday-weekend-in-september/
-     - https://www.sknis.gov.kn/2019/12/27/public-holidays-during-carnival-2019-2020/
-     - https://www.sknis.gov.kn/2018/12/29/proclamations-from-his-excellency-the-governor-general-re-carnival-public-holidays/
-     - https://www.sknis.gov.kn/2017/12/19/public-holiday-declared-for-nevis-today-after-the-ccms-solid-win-in-the-local-elections/
-     - https://www.sknis.gov.kn/2017/04/13/employers-must-comply-with-law-for-work-performed-on-national-holidays-says-labour-department/
-     - https://www.facebook.com/share/p/ZkpwKmyAzN4fEFP2/
-     - https://www.facebook.com/share/p/Jc1uGgzGpj6zUzqB/
-     - https://www.facebook.com/share/p/6GSgvcCWS3aenQh6/
+    """Saint Kitts and Nevis special holidays.
+
+    References:
+        * <https://www.sknis.gov.kn/2023/07/17/state-funeral-accorded-to-sir-tapley-national-day-of-mourning-and-half-holiday-declared-for-july-20/>
+        * <https://www.sknis.gov.kn/2022/12/30/public-holiday-notice-request-from-the-department-of-labour/>
+        * <https://www.sknis.gov.kn/2022/08/06/prime-minister-drew-declares-monday-august-08-2022-as-a-public-holiday-in-st-kitts-and-nevis/>
+        * <https://www.sknis.gov.kn/2022/04/20/nia-announces-half-holiday/>
+        * <https://www.sknis.gov.kn/2021/07/26/governor-general-proclaims-tuesday-3rd-august-2021-as-a-public-holiday/>
+        * <https://nia.gov.kn/culturama-47-rescheduled-to-independence-holiday-weekend-in-september/>
+        * <https://www.sknis.gov.kn/2019/12/27/public-holidays-during-carnival-2019-2020/>
+        * <https://www.sknis.gov.kn/2018/12/29/proclamations-from-his-excellency-the-governor-general-re-carnival-public-holidays/>
+        * <https://www.sknis.gov.kn/2017/12/19/public-holiday-declared-for-nevis-today-after-the-ccms-solid-win-in-the-local-elections/>
+        * <https://www.sknis.gov.kn/2017/04/13/employers-must-comply-with-law-for-work-performed-on-national-holidays-says-labour-department/>
+        * <https://www.facebook.com/share/p/ZkpwKmyAzN4fEFP2/>
+        * <https://www.facebook.com/share/p/Jc1uGgzGpj6zUzqB/>
+        * <https://www.facebook.com/share/p/6GSgvcCWS3aenQh6/>
     """
 
     # Federal Election Victory Day.

holidays/countries/saint_lucia.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,13 +17,14 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON,
 
 
 class SaintLucia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """Saint Lucia holidays.
+
     References:
-    - https://en.wikipedia.org/wiki/Public_holidays_in_Saint_Lucia
-    - https://www.timeanddate.com/holidays/saint-lucia/
-    - https://archive.stlucia.gov.lc/saint_lucia/public_holidays.htm
-    - https://archive.stlucia.gov.lc/stluciasilver/national_holidays.htm
-    - https://web.archive.org/web/20160314100648/http://www.stluciachamber.org/uploadedImages/contentImg/file/List%20of%20Holidays%20for%202015%20(1).pdf
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Saint_Lucia>
+        * <https://www.timeanddate.com/holidays/saint-lucia/>
+        * <https://archive.stlucia.gov.lc/saint_lucia/public_holidays.htm>
+        * <https://archive.stlucia.gov.lc/stluciasilver/national_holidays.htm>
+        * <https://web.archive.org/web/20160314100648/http://www.stluciachamber.org/uploadedImages/contentImg/file/List%20of%20Holidays%20for%202015%20(1).pdf>
     """
 
     country = "LC"

holidays/countries/samoa.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,12 +15,13 @@ from holidays.holiday_base import HolidayBase
 
 
 class Samoa(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """Samoa holidays.
+
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Samoa
-        - https://www.timeanddate.com/holidays/samoa/
-        - https://www.mcil.gov.ws/?attachment_id=6336
-        - https://www.paclii.org/ws/legis/consol_act_2020/pha2008163/
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Samoa>
+        * <https://www.timeanddate.com/holidays/samoa/>
+        * <https://www.mcil.gov.ws/?attachment_id=6336>
+        * <https://www.paclii.org/ws/legis/consol_act_2020/pha2008163/>
     """
 
     country = "WS"

holidays/countries/san_marino.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,10 @@ from holidays.holiday_base import HolidayBase
 
 
 class SanMarino(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """San Marino holidays.
+
     References:
-      - https://en.wikipedia.org/wiki/Public_holidays_in_San_Marino
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_San_Marino>
     """
 
     country = "SM"

holidays/countries/saudi_arabia.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
@@ -27,18 +27,12 @@ from holidays.observed_holiday_base import (
 
 
 class SaudiArabia(ObservedHolidayBase, IslamicHolidays, StaticHolidays):
-    """
-    There are only 4 official national holidays in Saudi:
-        - https://laboreducation.hrsd.gov.sa/en/gallery/274
-        - https://laboreducation.hrsd.gov.sa/en/labor-education/322
-        - https://english.alarabiya.net/News/gulf/2022/01/27/Saudi-Arabia-to-commemorate-Founding-Day-on-Feb-22-annually-Royal-order
-
-    The national day and the founding day holidays are based on the
-    Georgian calendar while the other two holidays are based on the
-    Islamic Calendar, and they are estimates as they announced each
-    year and based on moon sightings; they are:
-    - Eid al-Fitr
-    - Eid al-Adha
+    """Saudi Arabia holidays.
+
+    References:
+        * <https://laboreducation.hrsd.gov.sa/en/gallery/274>
+        * <https://laboreducation.hrsd.gov.sa/en/labor-education/322>
+        * <https://english.alarabiya.net/News/gulf/2022/01/27/Saudi-Arabia-to-commemorate-Founding-Day-on-Feb-22-annually-Royal-order>
     """
 
     country = "SA"
@@ -51,8 +45,14 @@ class SaudiArabia(ObservedHolidayBase, IslamicHolidays, StaticHolidays):
     observed_estimated_label = tr("(تقدير ملاحظة) %s")
     supported_languages = ("ar", "en_US")
 
-    def __init__(self, *args, **kwargs):
-        IslamicHolidays.__init__(self)
+    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, show_estimated=islamic_show_estimated)
         StaticHolidays.__init__(self, SaudiArabiaStaticHolidays)
         kwargs.setdefault("observed_rule", FRI_TO_PREV_THU + SAT_TO_NEXT_SUN)
         super().__init__(*args, **kwargs)

holidays/countries/serbia.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,10 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON,
 
 
 class Serbia(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    Serbia holidays.
+    """Serbia holidays.
 
     References:
-     - https://en.wikipedia.org/wiki/Public_holidays_in_Serbia
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Serbia>
     """
 
     country = "RS"

holidays/countries/seychelles.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,14 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON
 
 
 class Seychelles(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    https://www.psb.gov.sc/public-holidays
-    https://www.cbs.sc/PublicHolidays.html
-
-    [Act 19 of 1976, 1994 Amendment]
-        Oldest Seychelles Holidays Law available online in full.
-        https://seylii.org/akn/sc/act/1976/19/eng@2012-06-30
-    [Act 11 of 2014]
-        Holidays names changed.
-        https://seylii.org/akn/sc/act/2014/11/eng@2014-08-04
-    [Act 3 of 2017]
-        Added Easter Monday, repealing Liberation Day.
-        https://seylii.org/akn/sc/act/2017/3/eng@2017-04-12
+    """Seychelles holidays.
+
+    References:
+        * <https://www.psb.gov.sc/public-holidays>
+        * <https://www.cbs.sc/PublicHolidays.html>
+        * [Act 19 of 1976, 1994 Amendment (Oldest Seychelles Holidays Law available online in full)](https://seylii.org/akn/sc/act/1976/19/eng@2012-06-30)
+        * [Act 11 of 2014 (Holidays names changed)](https://seylii.org/akn/sc/act/2014/11/eng@2014-08-04)
+        * [Act 3 of 2017 (Added Easter Monday, repealing Liberation Day)](https://seylii.org/akn/sc/act/2017/3/eng@2017-04-12)
 
     Where any public holiday, except Sunday, falls on a Sunday the next following day,
     not being itself a public holiday, shall be a public holiday.
@@ -122,18 +117,19 @@ class SYC(Seychelles):
 
 
 class SeychellesStaticHolidays:
-    """
-    Sources:
-     - https://seylii.org/akn/sc/act/si/2015/58/eng@2015-12-01
-     - https://seylii.org/akn/sc/act/si/2015/59/eng@2015-12-11
-     - https://seylii.org/akn/sc/act/si/2016/58/eng@2016-09-06
-     - https://seylii.org/akn/sc/act/si/2019/10/eng@2019-03-05
-     - https://seylii.org/akn/sc/act/si/2019/61/eng@2019-10-18
-     - https://seylii.org/akn/sc/act/si/2020/134/eng@2020-09-17
-     - https://seylii.org/akn/sc/act/si/2020/154/eng@2020-10-26
-     - https://www.statehouse.gov.sc/news/1765/public-holiday-october-1
-     - https://www.egov.sc/PressRoom/DisplayPressRelease.aspx?PRLID=196
-     - https://www.nation.sc/archive/216478/saturday-may-12-2007-public-holiday
+    """Seychelles special holidays.
+
+    References:
+        * <https://seylii.org/akn/sc/act/si/2015/58/eng@2015-12-01>
+        * <https://seylii.org/akn/sc/act/si/2015/59/eng@2015-12-11>
+        * <https://seylii.org/akn/sc/act/si/2016/58/eng@2016-09-06>
+        * <https://seylii.org/akn/sc/act/si/2019/10/eng@2019-03-05>
+        * <https://seylii.org/akn/sc/act/si/2019/61/eng@2019-10-18>
+        * <https://seylii.org/akn/sc/act/si/2020/134/eng@2020-09-17>
+        * <https://seylii.org/akn/sc/act/si/2020/154/eng@2020-10-26>
+        * <https://www.statehouse.gov.sc/news/1765/public-holiday-october-1>
+        * <https://www.egov.sc/PressRoom/DisplayPressRelease.aspx?PRLID=196>
+        * <https://www.nation.sc/archive/216478/saturday-may-12-2007-public-holiday>
 
     All Election Dates usually proceed from the Outer Islands first, then the Inner Islands, and
     the main capital, Mahé, on the last day. The current implementation only uses the last day,

holidays/countries/singapore.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
@@ -41,52 +41,46 @@ class Singapore(
     IslamicHolidays,
     StaticHolidays,
 ):
+    """Singapore holidays.
+
+    References:
+        * [Wikipedia](https://en.wikipedia.org/wiki/Public_holidays_in_Singapore)
+        * [Holidays Act](https://sso.agc.gov.sg/Act/HA1998) (Act 24 of
+            1968—Holidays (Amendment) Act 1968)
+        * [Ministry of Manpower](https://www.mom.gov.sg/employment-practices/public-holidays)
+
+    Limitations:
+        * Prior to 1969: holidays are estimated.
+        * Prior to 2000: holidays may not be accurate.
+        * 2024 and later: the following four moving date holidays (whose exact
+            date is announced yearly) are estimated, and so denoted:
+            * Hari Raya Puasa
+            * Hari Raya Haji
+            * Vesak Day
+            * Deepavali
+    """
+
     country = "SG"
     default_language = "en_SG"
     # %s (observed).
     observed_label = tr("%s (observed)")
     supported_languages = ("en_SG", "en_US", "th")
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
         """
-        A subclass of :py:class:`HolidayBase` representing public holidays in
-        Singapore.
-
-        Limitations:
-
-        - Prior to 1969: holidays are estimated.
-        - Prior to 2000: holidays may not be accurate.
-        - 2024 and later: the following four moving date holidays (whose exact
-          date is announced yearly) are estimated, and so denoted:
-
-          - Hari Raya Puasa
-          - Hari Raya Haji
-          - Vesak Day
-          - Deepavali
-
-        Sources:
-
-        - `Holidays Act <https://sso.agc.gov.sg/Act/HA1998>`__ (Act 24 of
-          1968—Holidays (Amendment) Act 1968)
-        - `Ministry of Manpower
-          <https://www.mom.gov.sg/employment-practices/public-holidays>`__
-
-        References:
-
-        - `Wikipedia
-          <https://en.wikipedia.org/wiki/Public_holidays_in_Singapore>`__
-
-        Country created and maintained by: `Mike Borsetti
-        <https://github.com/mborsetti>`__
-
-        See parameters and usage in :py:class:`HolidayBase`.
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
         """
         BuddhistCalendarHolidays.__init__(self, cls=SingaporeBuddhistHolidays, show_estimated=True)
         ChineseCalendarHolidays.__init__(self, cls=SingaporeChineseHolidays, show_estimated=True)
         ChristianHolidays.__init__(self)
         HinduCalendarHolidays.__init__(self, cls=SingaporeHinduHolidays)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self, cls=SingaporeIslamicHolidays)
+        IslamicHolidays.__init__(
+            self, cls=SingaporeIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, cls=SingaporeStaticHolidays)
         # Implement Section 4(2) of the Holidays Act:
         # "if any day specified in the Schedule falls on a Sunday,
@@ -309,10 +303,11 @@ class SingaporeIslamicHolidays(_CustomIslamicHolidays):
 
 
 class SingaporeStaticHolidays:
-    """
-    References
-     - https://www.mom.gov.sg/newsroom/press-releases/2015/sg50-public-holiday-on-7-august-2015
-     - https://www.straitstimes.com/singapore/politics/singapore-presidential-election-2023-polling-day-on-sept-1-nomination-day-on-aug-22
+    """Singapore special holidays.
+
+    References:
+        * <https://www.mom.gov.sg/newsroom/press-releases/2015/sg50-public-holiday-on-7-august-2015>
+        * <https://www.straitstimes.com/singapore/politics/singapore-presidential-election-2023-polling-day-on-sept-1-nomination-day-on-aug-22>
     """
 
     # Polling Day.