holidays 0.75__py3-none-any.whl → 0.76__py3-none-any.whl

holidays/countries/mayotte.py

@@ -0,0 +1,44 @@
+#  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.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysYT(ChildEntity, France):
+    """Mayotte holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Mayotte>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "YT"
+    parent_entity = France
+    parent_entity_subdivision_code = "976"
+    # Sold to France on April 25th, 1841.
+    start_year = 1842
+
+
+class Mayotte(HolidaysYT):
+    pass
+
+
+class YT(HolidaysYT):
+    pass
+
+
+class MYT(HolidaysYT):
+    pass

holidays/countries/mongolia.py

@@ -0,0 +1,202 @@
+#  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.gregorian import _timedelta
+from holidays.constants import PUBLIC, WORKDAY
+from holidays.groups import InternationalHolidays, MongolianCalendarHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class Mongolia(HolidayBase, InternationalHolidays, MongolianCalendarHolidays):
+    """Mongolia holidays.
+
+    References:
+        * [Law on Public holidays and days of observation](https://web.archive.org/web/20250327062440/https://legalinfo.mn/mn/detail/399)
+        * [Labor Law](https://web.archive.org/web/20250421093230/https://legalinfo.mn/mn/detail?lawId=16230709635751)
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Mongolia>
+        * [Mongolian lunar calendar](https://web.archive.org/web/20230412171012/https://www.math.mcgill.ca/gantumur/cal/index_mn.html)
+        * <https://web.archive.org/web/20250613054645/https://www.timeanddate.com/holidays/mongolia/>
+        * <https://web.archive.org/web/20250429110535/https://investmongolia.gov.mn/mongolia-at-a-glance/>
+    """
+
+    country = "MN"
+    default_language = "mn"
+    start_year = 2004
+    supported_categories = (PUBLIC, WORKDAY)
+    supported_languages = ("en_US", "mn")
+
+    def __init__(self, *args, **kwargs):
+        InternationalHolidays.__init__(self)
+        MongolianCalendarHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day(tr("Шинэ жил"))
+
+        # Lunar New Year.
+        name = tr("Цагаан сар")
+        self._add_tsagaan_sar(name)
+        self._add_tsagaan_sar_day_2(name)
+        # Expanded on November 28th, 2013.
+        if self._year >= 2014:
+            self._add_tsagaan_sar_day_3(name)
+
+        # International Women's Day.
+        self._add_womens_day(tr("Олон улсын эмэгтэйчүүдийн өдөр"))
+
+        # Children's Day.
+        self._add_childrens_day(tr("Хүүхдийн баяр"))
+
+        # Established on December 20th, 2019.
+        if self._year >= 2020:
+            # The Buddha's Birthday.
+            self._add_buddha_day(tr("Бурхан багшийн Их дүйчин өдөр"))
+
+        # National Festival and People's Revolution Anniversary.
+        name = tr("Үндэсний их баяр наадам, Ардын хувьсгалын ойн баяр")
+        # Expanded to July 10 on July 7th, 2023.
+        if self._year >= 2023:
+            self._add_holiday_jul_10(name)
+        self._add_holiday_jul_11(name)
+        self._add_holiday_jul_12(name)
+        self._add_holiday_jul_13(name)
+        # Expanded to July 14-15 on July 1st, 2014.
+        if self._year >= 2014:
+            self._add_holiday_jul_14(name)
+            self._add_holiday_jul_15(name)
+
+        # Established on November 8th, 2012.
+        if self._year >= 2012:
+            # Genghis Khan's Birthday.
+            self._add_genghis_khan_day(tr("Их Эзэн Чингис хааны өдөр"))
+
+        # Repealed on November 8th, 2012.
+        # Re-established again on November 18th, 2016.
+        if self._year <= 2011 or self._year >= 2016:
+            self._add_holiday_nov_26(
+                # Republic Day.
+                tr("Бүгд Найрамдах Улс тунхагласан өдөр")
+                if self._year >= 2016
+                # Republic Holiday.
+                else tr("Бүгд Найрамдах Улс тунхагласны баяр")
+            )
+
+        # Established on August 16th, 2007.
+        # Renamed and considered a Public Holiday on December 23rd, 2011.
+        if self._year >= 2011:
+            self._add_holiday_dec_29(
+                # National Freedom and Independence Day.
+                tr("Үндэсний эрх чөлөө, тусгаар тогтнолоо сэргээсний баярын өдөр")
+            )
+
+    def _populate_workday_holidays(self):
+        """
+        NOTE:
+        The following observances are currently unimplemented
+        due to unclear week-based scheduling rules:
+
+        1. National Literary, Cultural and Book Days (Үндэсний бичиг соёл, номын өдрүүд):
+        - Observed on Saturday and Sunday of the 3rd week of May and September.
+        - Officially added on July 2nd, 2021.
+
+        2. Environmental Protection Days (Байгаль орчныг хамгаалах өдрүүд):
+        - Observed during the 4th week of September.
+
+        These are defined using "week of the month" logic, but it is unclear whether weeks start
+        from the 1st of the month or the first full week. We previously contacted
+        contact@mecc.gov.mn for clarification but received no response.
+
+        See:
+        https://github.com/vacanza/holidays/issues/2672
+        """
+
+        # Constitution Day.
+        self._add_holiday_jan_13(tr("Монгол Улсын Үндсэн хуулийн өдөр"))
+
+        # Established on December 9th, 2004.
+        if self._year >= 2005:
+            # Patriots' Day.
+            self._add_holiday_mar_1(tr("Эх орончдын өдөр"))
+
+        # Renamed on February 9th, 2011.
+        self._add_holiday_mar_18(
+            # Military Day.
+            tr("Монгол цэргийн өдөр")
+            if self._year >= 2011
+            # Armed Forces Day.
+            else tr("Зэвсэгт хүчний өдөр")
+        )
+
+        # Health Protection Day.
+        self._add_holiday_apr_7(tr("Эрүүл мэндийг хамгаалах өдөр"))
+
+        # Intellectual Property Protection Day.
+        self._add_holiday_apr_26(tr("Оюуны өмчийг хамгаалах өдөр"))
+
+        # Family Day.
+        self._add_holiday_may_15(tr("Гэр бүлийн өдөр"))
+
+        # Established on June 11th, 2009.
+        if self._year >= 2009:
+            # National Flag Day.
+            self._add_holiday_jul_10(tr("Монгол Улсын төрийн далбааны өдөр"))
+
+        # Youth Day.
+        self._add_holiday_aug_25(tr("Залуучуудын өдөр"))
+
+        if self._year >= 2007:
+            # New Harvest Days.
+            name = tr("Шинэ ургацын өдрүүд")
+            dt = self._add_holiday_sep_5(name)
+            for delta in range(1, 46):
+                self._add_holiday(name, _timedelta(dt, delta))
+
+        # Memorial Day of Political Victims.
+        self._add_holiday_sep_10(tr("Улс төрийн хэлмэгдэгсдийн дурсгалын өдөр"))
+
+        # Elders' Day.
+        self._add_holiday_oct_1(tr("Ахмадын өдөр"))
+
+        # Renamed on July 7th, 2021.
+        self._add_holiday_oct_29(
+            # Capital City Day.
+            tr("Монгол Улсын нийслэл хотын өдөр")
+            if self._year >= 2021
+            # Capital Day.
+            else tr("Монгол Улсын Нийслэлийн өдөр")
+        )
+
+        # Established on November 8th, 2012 after the old one was repealed.
+        # Made a Public Holiday again on November 8th, 2016.
+        if 2012 <= self._year <= 2015:
+            # Republic Day.
+            self._add_holiday_nov_26(tr("Бүгд Найрамдах Улс тунхагласан өдөр"))
+
+        # Democracy and Human Rights Day.
+        self._add_holiday_dec_10(tr("Ардчилал, хүний эрхийн өдөр"))
+
+        # Established on August 16th, 2007.
+        # Renamed and considered a Public Holiday on December 23rd, 2011.
+        if 2007 <= self._year <= 2010:
+            # National Freedom Day.
+            self._add_holiday_dec_29(tr("Үндэсний эрх чөлөөний өдөр"))
+
+
+class MN(Mongolia):
+    pass
+
+
+class MNG(Mongolia):
+    pass

holidays/countries/morocco.py

@@ -27,7 +27,7 @@ class Morocco(HolidayBase, InternationalHolidays, IslamicHolidays):
     country = "MA"
     default_language = "ar"
     # %s (estimated).
-    estimated_label = tr("(تقدير) %s")
+    estimated_label = tr("%s (المقدرة)")
     supported_languages = ("ar", "en_US", "fr")
 
     def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):

holidays/countries/netherlands.py

@@ -10,16 +10,14 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from datetime import date
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import APR, AUG, _timedelta
 from holidays.constants import OPTIONAL, PUBLIC
 from holidays.groups import ChristianHolidays, InternationalHolidays
-from holidays.holiday_base import HolidayBase
+from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_PREV_SAT, SUN_TO_NEXT_MON
 
 
-class Netherlands(HolidayBase, ChristianHolidays, InternationalHolidays):
+class Netherlands(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
     """Netherlands holidays.
 
     References:
@@ -37,6 +35,7 @@ class Netherlands(HolidayBase, ChristianHolidays, InternationalHolidays):
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
+        kwargs.setdefault("observed_rule", SUN_TO_NEXT_MON)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
@@ -49,7 +48,6 @@ class Netherlands(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Easter Monday.
         self._add_easter_monday(tr("Tweede paasdag"))
 
-        # King's / Queen's day
         if self._year >= 1891:
             name = (
                 # King's Day.
@@ -59,14 +57,12 @@ class Netherlands(HolidayBase, ChristianHolidays, InternationalHolidays):
                 else tr("Koninginnedag")
             )
             if self._year >= 2014:
-                dt = date(self._year, APR, 27)
+                dt = self._add_holiday_apr_27(name)
             elif self._year >= 1949:
-                dt = date(self._year, APR, 30)
+                dt = self._add_holiday_apr_30(name)
             else:
-                dt = date(self._year, AUG, 31)
-            if self._is_sunday(dt):
-                dt = _timedelta(dt, -1 if self._year >= 1980 else +1)
-            self._add_holiday(name, dt)
+                dt = self._add_holiday_aug_31(name)
+            self._move_holiday(dt, rule=SUN_TO_PREV_SAT if self._year >= 1980 else SUN_TO_NEXT_MON)
 
         if self._year >= 1950 and self._year % 5 == 0:
             # Liberation Day.

holidays/countries/new_caledonia.py

@@ -0,0 +1,43 @@
+#  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.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysNC(ChildEntity, France):
+    """New Caledonia holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/New_Caledonia>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "NC"
+    parent_entity = France
+    # France took formal possession of New Caledonia on September 24th, 1853.
+    start_year = 1854
+
+
+class NewCaledonia(HolidaysNC):
+    pass
+
+
+class NC(HolidaysNC):
+    pass
+
+
+class NCL(HolidaysNC):
+    pass

holidays/countries/northern_mariana_islands.py

@@ -10,11 +10,11 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
-from holidays.countries.united_states import US
+from holidays.countries.united_states import UnitedStates
+from holidays.mixins.child_entity import ChildEntity
 
 
-class HolidaysMP(US):
+class HolidaysMP(ChildEntity, UnitedStates):
     """Northern Mariana Islands (the) holidays.
 
     Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
@@ -22,21 +22,13 @@ class HolidaysMP(US):
     """
 
     country = "MP"
-    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
-    subdivisions = ()  # Override US subdivisions.
-    subdivisions_aliases = {}  # Override US subdivisions aliases.
+    parent_entity = UnitedStates
+    # UNSC Resolution 21 on April 2nd, 1947.
+    start_year = 1948
 
-    def _populate_public_holidays(self) -> None:
-        self.subdiv = "MP"
-        super()._populate_public_holidays()
 
-    def _populate_government_holidays(self) -> None:
-        self.subdiv = "MP"
-        super()._populate_government_holidays()
-
-    def _populate_unofficial_holidays(self) -> None:
-        self.subdiv = "MP"
-        super()._populate_unofficial_holidays()
+class NorthernMarianaIslands(HolidaysMP):
+    pass
 
 
 class MP(HolidaysMP):
@@ -45,7 +37,3 @@ class MP(HolidaysMP):
 
 class MNP(HolidaysMP):
     pass
-
-
-class NorthernMarianaIslands(HolidaysMP):
-    pass

holidays/countries/oman.py

@@ -49,7 +49,7 @@ class Oman(HolidayBase, IslamicHolidays):
     country = "OM"
     default_language = "ar"
     # %s (estimated).
-    estimated_label = tr("%s (مُقدَّر)")
+    estimated_label = tr("%s (المقدرة)")
     start_year = 1970
     supported_languages = ("ar", "en_US")
 

holidays/countries/puerto_rico.py

@@ -10,11 +10,11 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
-from holidays.countries.united_states import US
+from holidays.countries.united_states import UnitedStates
+from holidays.mixins.child_entity import ChildEntity
 
 
-class HolidaysPR(US):
+class HolidaysPR(ChildEntity, UnitedStates):
     """Puerto Rico holidays.
 
     Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
@@ -22,21 +22,13 @@ class HolidaysPR(US):
     """
 
     country = "PR"
-    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
-    subdivisions = ()  # Override US subdivisions.
-    subdivisions_aliases = {}  # Override US subdivisions aliases.
+    parent_entity = UnitedStates
+    # Became a U.S. Territory on April 11th, 1899.
+    start_year = 1900
 
-    def _populate_public_holidays(self) -> None:
-        self.subdiv = "PR"
-        super()._populate_public_holidays()
 
-    def _populate_government_holidays(self) -> None:
-        self.subdiv = "PR"
-        super()._populate_government_holidays()
-
-    def _populate_unofficial_holidays(self) -> None:
-        self.subdiv = "PR"
-        super()._populate_unofficial_holidays()
+class PuertoRico(HolidaysPR):
+    pass
 
 
 class PR(HolidaysPR):
@@ -45,7 +37,3 @@ class PR(HolidaysPR):
 
 class PRI(HolidaysPR):
     pass
-
-
-class PuertoRico(HolidaysPR):
-    pass

holidays/countries/reunion.py

@@ -0,0 +1,44 @@
+#  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.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysRE(ChildEntity, France):
+    """Réunion holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Réunion>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "RE"
+    parent_entity = France
+    parent_entity_subdivision_code = "974"
+    # Cession from the UK on May 30th, 1814.
+    start_year = 1815
+
+
+class Reunion(HolidaysRE):
+    pass
+
+
+class RE(HolidaysRE):
+    pass
+
+
+class REU(HolidaysRE):
+    pass

holidays/countries/saint_barthelemy.py

@@ -0,0 +1,43 @@
+#  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.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysBL(ChildEntity, France):
+    """Saint Barthélemy holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Saint_Barthélemy>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "BL"
+    parent_entity = France
+    # Cession from Guadeloupe on July 15th, 2007.
+    start_year = 2008
+
+
+class SaintBarthelemy(HolidaysBL):
+    pass
+
+
+class BL(HolidaysBL):
+    pass
+
+
+class BLM(HolidaysBL):
+    pass

holidays/countries/saint_martin.py

@@ -0,0 +1,43 @@
+#  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.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysMF(ChildEntity, France):
+    """Saint Martin holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Collectivity_of_Saint_Martin>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "MF"
+    parent_entity = France
+    # Cession from Guadeloupe on July 15th, 2007.
+    start_year = 2008
+
+
+class SaintMartin(HolidaysMF):
+    pass
+
+
+class MF(HolidaysMF):
+    pass
+
+
+class MAF(HolidaysMF):
+    pass

holidays/countries/saint_pierre_and_miquelon.py

@@ -0,0 +1,43 @@
+#  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.countries.france import France
+from holidays.mixins.child_entity import ChildEntity
+
+
+class HolidaysPM(ChildEntity, France):
+    """Saint Pierre and Miquelon holidays.
+
+    Alias of a French subdivision that is also officially assigned
+    its own country code in ISO 3166-1.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Saint_Pierre_and_Miquelon>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_France>
+    """
+
+    country = "PM"
+    parent_entity = France
+    # Cession from the UK on May 30th, 1814.
+    start_year = 1815
+
+
+class SaintPierreAndMiquelon(HolidaysPM):
+    pass
+
+
+class PM(HolidaysPM):
+    pass
+
+
+class SPM(HolidaysPM):
+    pass