some new features

.venv/lib/python3.12/site-packages/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 CONTRIBUTORS file)
+#           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/vacanza/holidays
+#  License: MIT (see LICENSE file)
+
+from gettext import gettext as tr
+
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import (
+    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://web.archive.org/web/20250417141518/https://hukoomi.gov.qa/en/national-sport-day)
+        * [Qatar National Day](https://web.archive.org/web/20240522081644/https://www.qatar.qa/en/qatar/history-of-qatar-qatar-national-day-committee/)
+        * [Weekend](https://web.archive.org/web/20240930093123/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, *args, islamic_show_estimated: bool = True, **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://web.archive.org/web/20250422212912/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://web.archive.org/web/20241207022523/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://web.archive.org/web/20250119073018/https://www.expatica.com/qa/lifestyle/holidays/qatar-public-holidays-74585/)
+    """
+
+    # New Year's Holiday.
+    name = tr("عطلة رأس السنة")
+    special_public_holidays = {
+        2025: (JAN, 2, name),
+    }