holidays 0.79__py3-none-any.whl → 0.80__py3-none-any.whl

holidays/countries/somalia.py

@@ -0,0 +1,79 @@
+#  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 holidays.groups import InternationalHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Somalia(HolidayBase, InternationalHolidays, IslamicHolidays):
+    """Somalia holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Somalia>
+        * <https://web.archive.org/web/20250522034818/https://usa.mfa.gov.so/about-somalia/>
+    """
+
+    country = "SO"
+    # %s (estimated).
+    estimated_label = "%s (estimated)"
+    # Unification of Somaliland and Italian Somaliland into the Somali Republic on July 1st, 1960.
+    start_year = 1961
+
+    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, show_estimated=islamic_show_estimated)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+
+        # Labor Day.
+        self._add_labor_day("Labour Day")
+
+        # Independence Day.
+        self._add_holiday_jun_26("Independence Day")
+
+        # Republic Day.
+        self._add_holiday_jul_1("Republic Day")
+
+        # Islamic New Year.
+        self._add_islamic_new_year_day("Islamic New Year")
+
+        # Ashura.
+        self._add_ashura_day("Ashura")
+
+        # Prophet's Birthday.
+        self._add_mawlid_day("Prophet's Birthday")
+
+        # Isra' and Mi'raj.
+        self._add_isra_and_miraj_day("Isra' and Mi'raj")
+
+        # Eid al-Fitr.
+        self._add_eid_al_fitr_day("Eid al-Fitr")
+
+        # Eid al-Adha.
+        self._add_eid_al_adha_day("Eid al-Adha")
+
+
+class SO(Somalia):
+    pass
+
+
+class SOM(Somalia):
+    pass

holidays/countries/south_sudan.py

@@ -0,0 +1,133 @@
+#  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 holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import MAR, MAY, JUN, JUL, AUG
+from holidays.constants import ISLAMIC, PUBLIC
+from holidays.groups import ChristianHolidays, InternationalHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class SouthSudan(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays):
+    """South Sudan holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_South_Sudan>
+        * [Guidelines for Opening Schools in South Sudan for the Academic Year, 2024](https://web.archive.org/web/20250716011243/https://mogei.gov.ss/super/assets/documents/calendar/2024_MoGEI_Academic%20calendar%20and%20implemention%20guidelines_%20South%20Sudan_A5_final_Approved%20and%20signed%20-%203.pdf)
+        * <https://web.archive.org/web/20241211222746/http://www.doitinafrica.com/south-sudan/events/public-holidays.htm>
+        * [2016](https://web.archive.org/web/20250825141310/https://docs.southsudanngoforum.org/sites/default/files/2016-11/2016%20ANNUAL%20HOLIDAYS%20CALENDAR%20.pdf)
+        * [2018](https://web.archive.org/web/20250825141312/https://docs.southsudanngoforum.org/sites/default/files/2018-01/Annual%20Holidays%20for%202018.pdf)
+        * [2020](https://web.archive.org/web/20250825141316/https://docs.southsudanngoforum.org/sites/default/files/2020-01/South_Sudan_Annual_Holidays_for_2020.pdf)
+        * [2021](https://web.archive.org/web/20250514045013/https://docs.southsudanngoforum.org/sites/default/files/2021-02/Public%20Holidays%20Calendar%202021.pdf)
+        * [2022](https://web.archive.org/web/20250430165748/https://docs.southsudanngoforum.org/sites/default/files/2022-03/HRPublic%20Holidays%202022HR.pdf)
+        * [2025](https://web.archive.org/web/20250426232710/https://www.netherlandsandyou.nl/web/south-sudan/about-us/closing-days)
+    """
+
+    country = "SS"
+    # %s (estimated).
+    estimated_label = "%s (estimated)"
+    # South Sudan became independent on 9 July 2011.
+    start_year = 2012
+    supported_categories = (ISLAMIC, PUBLIC)
+
+    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.
+        """
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        IslamicHolidays.__init__(
+            self, cls=SouthSudanIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+
+        # Peace Agreement Day.
+        self._add_holiday_jan_9("Peace Agreement Day")
+
+        # Good Friday.
+        self._add_good_friday("Good Friday")
+
+        # Holy Saturday.
+        self._add_holy_saturday("Holy Saturday")
+
+        # Easter Sunday.
+        self._add_easter_sunday("Easter Sunday")
+
+        # Easter Monday.
+        self._add_easter_monday("Easter Monday")
+
+        # International Labour Day.
+        self._add_labor_day("International Labour Day")
+
+        # SPLA Day.
+        self._add_holiday_may_16("SPLA Day")
+
+        # Independence Day.
+        self._add_holiday_jul_9("Independence Day")
+
+        # Martyrs' Day.
+        self._add_holiday_jul_30("Martyrs' Day")
+
+        # Christmas Eve.
+        self._add_christmas_eve("Christmas Eve")
+
+        # Christmas Day.
+        self._add_christmas_day("Christmas Day")
+
+        # Second Day of Christmas.
+        self._add_christmas_day_two("Second Day of Christmas")
+
+        # Eid al-Fitr.
+        self._add_eid_al_fitr_day("Eid al-Fitr")
+
+        # Eid al-Adha.
+        self._add_eid_al_adha_day("Eid al-Adha")
+
+    def _populate_islamic_holidays(self):
+        # Eid al-Fitr Holiday.
+        self._add_eid_al_fitr_day_two("Eid al-Fitr Holiday")
+
+        # Eid al-Adha Holiday.
+        self._add_eid_al_adha_day_two("Eid al-Adha Holiday")
+
+
+class SS(SouthSudan):
+    pass
+
+
+class SSD(SouthSudan):
+    pass
+
+
+class SouthSudanIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES = {
+        2018: (AUG, 21),
+        2020: (JUL, 31),
+        2021: (JUL, 18),
+        2022: (JUL, 9),
+        2025: (JUN, 6),
+    }
+
+    EID_AL_FITR_DATES = {
+        2018: (JUN, 14),
+        2020: (MAY, 22),
+        2021: (MAY, 13),
+        2022: (MAY, 3),
+        2025: (MAR, 31),
+    }

holidays/countries/spain.py

@@ -52,6 +52,10 @@ class Spain(
 
     country = "ES"
     default_language = "es"
+    # %s (estimated).
+    estimated_label = tr("%s (estimado)")
+    # Monday following %s (estimated).
+    observed_estimated_label = tr("Lunes siguiente a %s (estimado)")
     # Monday following %s.
     observed_label = tr("Lunes siguiente a %s")
     subdivisions = (

holidays/countries/tajikistan.py

@@ -0,0 +1,116 @@
+#  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 APR
+from holidays.groups import InternationalHolidays, IslamicHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Tajikistan(HolidayBase, InternationalHolidays, IslamicHolidays):
+    """Tajikistan holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Tajikistan>
+        * [Law #3 from Nov 3, 1995](https://web.archive.org/web/20250823162418/http://www.portali-huquqi.tj/publicadliya/view_qonunhoview.php?showdetail=&asosi_id=155&language=tj)
+        * [Law #753 from Aug 2, 2011](https://web.archive.org/web/20250823162543/http://www.portali-huquqi.tj/publicadliya/view_qonunhoview.php?showdetail=&asosi_id=12997&language=tj)
+        * [Independence Day](https://web.archive.org/web/20250324203223/https://tnu.tj/index.php/en/9-september-independence-day-of-the-republic-of-tajikistan/)
+    """
+
+    country = "TJ"
+    default_language = "tg"
+    # %s (estimated).
+    estimated_label = tr("%s (таҳминан)")
+    start_year = 1992
+    supported_languages = ("en_US", "ru", "tg")
+
+    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=TajikistanIslamicHolidays, show_estimated=islamic_show_estimated
+        )
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day(tr("Соли Нав"))
+
+        # Mother's Day.
+        self._add_holiday_mar_8(tr("Рӯзи Модар"))
+
+        # International Nowruz Day.
+        name = tr("Иди байналмилалии Наврӯз")
+        self._add_holiday_mar_21(name)
+        self._add_holiday_mar_22(name)
+
+        # Established by Law #13 from May 3, 2002.
+        if self._year >= 2003:
+            self._add_holiday_mar_23(name)
+
+        # Established by Law #146 from Dec 28, 2005.
+        if self._year >= 2006:
+            self._add_holiday_mar_24(name)
+
+        # Abolished by Law #1390 from Feb 24, 2017.
+        if self._year <= 2016:
+            # International Workers' Solidarity Day.
+            self._add_labor_day(tr("Рӯзи байналхалқии якдилии меҳнаткашон"))
+
+        self._add_world_war_two_victory_day(
+            # Victory Day.
+            tr("Рӯзи Ғалаба дар Ҷанги Бузурги Ватанӣ"),
+            is_western=False,
+        )
+
+        # Established by Law #628 from May 22, 1998.
+        if self._year >= 1998:
+            # Day of National Unity.
+            self._add_holiday_jun_27(tr("Рӯзи Ваҳдати миллӣ"))
+
+        # Independence Day.
+        self._add_holiday_sep_9(tr("Рӯзи Истиқлолияти давлатии Ҷумҳурии Тоҷикистон"))
+
+        if self._year >= 1994:
+            # Constitution Day.
+            self._add_holiday_nov_6(tr("Рӯзи Конститутсияи Ҷумҳурии Тоҷикистон"))
+
+        # Eid al-Fitr.
+        self._add_eid_al_fitr_day(tr("Рӯзи иди Рамазон"))
+
+        # Eid al-Adha.
+        self._add_eid_al_adha_day(tr("Рӯзи иди Қурбон"))
+
+
+class TJ(Tajikistan):
+    pass
+
+
+class TJK(Tajikistan):
+    pass
+
+
+class TajikistanIslamicHolidays(_CustomIslamicHolidays):
+    # https://www.timeanddate.com/holidays/tajikistan/eid-al-fitr
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (1992, 2025)
+    EID_AL_FITR_DATES = {
+        2023: (APR, 22),
+    }
+
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (1992, 2025)