holidays 0.42__py3-none-any.whl → 0.44__py3-none-any.whl

holidays/__init__.py

@@ -16,7 +16,7 @@ from holidays.holiday_base import *
 from holidays.registry import EntityLoader
 from holidays.utils import *
 
-__version__ = "0.42"
+__version__ = "0.44"
 
 
 EntityLoader.load("countries", globals())

holidays/constants.py

@@ -44,6 +44,7 @@ HALF_DAY = "half_day"
 OPTIONAL = "optional"
 PUBLIC = "public"
 SCHOOL = "school"
+UNOFFICIAL = "unofficial"
 WORKDAY = "workday"
 
 CHINESE = "chinese"

holidays/countries/american_samoa.py

@@ -9,6 +9,7 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
@@ -18,12 +19,17 @@ class HolidaysAS(US):
     # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
 
     country = "AS"
+    supported_categories = (PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "AS"
         super()._populate_public_holidays()
 
+    def _populate_unofficial_holidays(self) -> None:
+        self.subdiv = "AS"
+        super()._populate_unofficial_holidays()
+
 
 class AS(HolidaysAS):
     pass

holidays/countries/austria.py

@@ -21,16 +21,48 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
     default_language = "de"
     supported_categories = (BANK, PUBLIC)
     supported_languages = ("de", "en_US", "uk")
-    subdivisions = ("1", "2", "3", "4", "5", "6", "7", "8", "9")
+    subdivisions = (
+        "1",  # Burgenland.
+        "2",  # Kärnten.
+        "3",  # Niederösterreich.
+        "4",  # Oberösterreich.
+        "5",  # Salzburg.
+        "6",  # Steiermark.
+        "7",  # Tirol.
+        "8",  # Vorarlberg.
+        "9",  # Wien.
+    )
+    subdivisions_aliases = {
+        "Burgenland": "1",
+        "Bgld": "1",
+        "B": "1",
+        "Kärnten": "2",
+        "Ktn": "2",
+        "K": "2",
+        "Niederösterreich": "3",
+        "NÖ": "3",
+        "N": "3",
+        "Oberösterreich": "4",
+        "OÖ": "4",
+        "O": "4",
+        "Salzburg": "5",
+        "Sbg": "5",
+        "S": "5",
+        "Steiermark": "6",
+        "Stmk": "6",
+        "St": "6",
+        "Tirol": "7",
+        "T": "7",
+        "Vorarlberg": "8",
+        "Vbg": "8",
+        "V": "8",
+        "Wien": "9",
+        "W": "9",
+    }
 
     def __init__(self, *args, **kwargs) -> None:
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
-
-        # Set the default subdivision.
-        if not kwargs.get("subdiv", kwargs.get("state")):
-            kwargs["subdiv"] = "9"
-
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
@@ -58,11 +90,12 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Assumption Day.
         self._add_assumption_of_mary_day(tr("Mariä Himmelfahrt"))
 
+        # National Day.
+        national_day = tr("Nationalfeiertag")
         if 1919 <= self._year <= 1934:
-            # National Day.
-            self._add_holiday_nov_12(tr("Nationalfeiertag"))
+            self._add_holiday_nov_12(national_day)
         if self._year >= 1967:
-            self._add_holiday_oct_26(tr("Nationalfeiertag"))
+            self._add_holiday_oct_26(national_day)
 
         # All Saints' Day.
         self._add_all_saints_day(tr("Allerheiligen"))
@@ -86,6 +119,46 @@ class Austria(HolidayBase, ChristianHolidays, InternationalHolidays):
         # New Year's Eve.
         self._add_new_years_eve(tr("Silvester"))
 
+    def _populate_subdiv_1_bank_holidays(self):
+        # St. Martin's Day.
+        self._add_holiday_nov_11(tr("Hl. Martin"))
+
+    def _populate_subdiv_2_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+        # 1920 Carinthian plebiscite.
+        self._add_holiday_oct_10(tr("Tag der Volksabstimmung"))
+
+    def _populate_subdiv_3_bank_holidays(self):
+        # St. Leopold's Day.
+        self._add_holiday_nov_15(tr("Hl. Leopold"))
+
+    def _populate_subdiv_4_bank_holidays(self):
+        if self._year >= 2004:
+            # St. Florian's Day.
+            self._add_holiday_may_4(tr("Hl. Florian"))
+
+    def _populate_subdiv_5_bank_holidays(self):
+        # St. Rupert's Day.
+        self._add_holiday_sep_24(tr("Hl. Rupert"))
+
+    def _populate_subdiv_6_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_7_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_8_bank_holidays(self):
+        # St. Joseph's Day.
+        self._add_saint_josephs_day(tr("Hl. Josef"))
+
+    def _populate_subdiv_9_bank_holidays(self):
+        # St. Leopold's Day.
+        self._add_holiday_nov_15(tr("Hl. Leopold"))
+
 
 class AT(Austria):
     pass

holidays/countries/ethiopia.py

@@ -12,13 +12,19 @@
 from calendar import isleap
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import SEP
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import JAN, APR, MAY, JUN, JUL, AUG, SEP, OCT, NOV
 from holidays.calendars.julian import JULIAN_CALENDAR
 from holidays.groups import ChristianHolidays, InternationalHolidays, IslamicHolidays
 from holidays.holiday_base import HolidayBase
 
 
 class Ethiopia(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHolidays):
+    """
+    References:
+        - https://en.wikipedia.org/wiki/Public_holidays_in_Ethiopia
+    """
+
     country = "ET"
     default_language = "am"
     # %s (estimated).
@@ -27,80 +33,71 @@ class Ethiopia(HolidayBase, ChristianHolidays, InternationalHolidays, IslamicHol
 
     def _is_leap_year(self):
         """
-        Ethiopian leap years are coincident with leap years in the Gregorian
-        calendar until the end of February 2100. It starts earlier from new
-        year of western calendar.
-        Ethiopian leap year starts on Sep 11, so it has an effect on
-        holidays between Sep 11 and Jan 1. Therefore, here on the following
-        function we intentionally add 1 to the leap year to offset the
-        difference.
+        Ethiopian leap years are coincident with leap years in the Gregorian calendar until
+        the end of February 2100. It starts earlier from new year of western calendar.
+        Ethiopian leap year starts on Sep 11, so it has an effect on holidays between
+        Sep 11 and Jan 1. Therefore, here on the following function we intentionally add 1
+        to the leap year to offset the difference.
         """
         return isleap(self._year + 1)
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self, JULIAN_CALENDAR)
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self)
+        IslamicHolidays.__init__(self, EthiopiaIslamicHolidays)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        # New Year's Day
-        # The Ethiopian New Year is called Kudus Yohannes in Ge'ez and
-        # Tigrinya, while in Amharic,
-        # the official language of Ethiopia it is called Enkutatash.
-        # It occurs on September 11 in the Gregorian Calendar;
-        # except for the year preceding a leap year, when it occurs on
-        # September 12.
-
-        # Ethiopian New Year.
-        self._add_holiday(tr("አዲስ ዓመት እንቁጣጣሽ"), SEP, 12 if self._is_leap_year() else 11)
-
-        # Finding of True Cross.
-        self._add_holiday(tr("መስቀል"), SEP, 28 if self._is_leap_year() else 27)
+        if self._year <= 1897:
+            return None
 
-        # Orthodox Christmas Day.
+        # Christmas Day.
         self._add_christmas_day(tr("ገና"))
 
-        # Orthodox Epiphany.
-        self._add_epiphany_day(tr("ጥምቀት"))
+        # Epiphany.
+        self._add_holiday(tr("ጥምቀት"), JAN, 20 if super()._is_leap_year() else 19)
 
-        # Orthodox Good Friday.
+        # Adwa Victory Day.
+        self._add_holiday_mar_2(tr("አድዋ"))
+
+        # Good Friday.
         self._add_good_friday(tr("ስቅለት"))
 
-        # Orthodox Easter Sunday.
+        # Easter Sunday.
         self._add_easter_sunday(tr("ፋሲካ"))
 
-        if self._year > 1896:
-            # Adwa Victory Day.
-            self._add_holiday_mar_2(tr("አድዋ"))
-
-        # Labor Day.
+        # Workers' Day.
         self._add_labor_day(tr("የሰራተኞች ቀን"))
 
-        if self._year > 1941:
-            # Patriots Day.
+        if self._year >= 1942:
+            # Patriots' Day.
             self._add_holiday_may_5(tr("የአርበኞች ቀን"))
 
-        if self._year > 1991:
+        if self._year >= 1992:
             # Downfall of Dergue Regime Day.
             self._add_holiday_may_28(tr("ደርግ የወደቀበት ቀን"))
 
-        if self._year < 1991 and self._year > 1974:
-            # Downfall of King Haile Selassie.
-            self._add_holiday(tr("ደርግ የመጣበት ቀን"), SEP, 13 if self._is_leap_year() else 12)
+        # Ethiopian New Year.
+        self._add_holiday(tr("እንቁጣጣሽ"), SEP, 12 if self._is_leap_year() else 11)
+
+        # Finding of True Cross.
+        self._add_holiday(tr("መስቀል"), SEP, 28 if self._is_leap_year() else 27)
+
+        if 1975 <= self._year <= 1990:
+            # Revolution Day.
+            self._add_holiday(tr("የአብዮት ቀን"), SEP, 13 if self._is_leap_year() else 12)
+
+            # October Revolution Day.
+            self._add_holiday_nov_7(tr("የጥቅምት አብዮት ቀን"))
 
         # Eid al-Fitr.
         self._add_eid_al_fitr_day(tr("ኢድ አልፈጥር"))
 
         # 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(tr("አረፋ"))
 
         # Prophet's Birthday.
-        name = tr("መውሊድ")
-        self._add_mawlid_day(name)
-        self._add_mawlid_day_two(name)
+        self._add_mawlid_day(tr("መውሊድ"))
 
 
 class ET(Ethiopia):
@@ -109,3 +106,32 @@ class ET(Ethiopia):
 
 class ETH(Ethiopia):
     pass
+
+
+class EthiopiaIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES = {
+        2018: (AUG, 22),
+        2019: (AUG, 11),
+        2020: (JUL, 31),
+        2021: (JUL, 20),
+        2022: (JUL, 9),
+        2023: (JUN, 28),
+    }
+
+    EID_AL_FITR_DATES = {
+        2018: (JUN, 15),
+        2019: (JUN, 4),
+        2020: (MAY, 24),
+        2021: (MAY, 13),
+        2022: (MAY, 2),
+        2023: (APR, 21),
+    }
+
+    MAWLID_DATES = {
+        2018: (NOV, 21),
+        2019: (NOV, 10),
+        2020: (OCT, 29),
+        2021: (OCT, 18),
+        2022: (OCT, 8),
+        2023: (SEP, 27),
+    }

holidays/countries/guam.py

@@ -9,6 +9,7 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
@@ -18,12 +19,17 @@ class HolidaysGU(US):
     # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
 
     country = "GU"
+    supported_categories = (PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "GU"
         super()._populate_public_holidays()
 
+    def _populate_unofficial_holidays(self) -> None:
+        self.subdiv = "GU"
+        super()._populate_unofficial_holidays()
+
 
 class GU(HolidaysGU):
     pass

holidays/countries/ireland.py

@@ -9,35 +9,33 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
-from holidays.calendars.gregorian import FEB, MAR
+from holidays.calendars.gregorian import FEB, MAR, SEP, DEC
 from holidays.groups import ChristianHolidays, InternationalHolidays, StaticHolidays
-from holidays.observed_holiday_base import (
-    ObservedHolidayBase,
-    SAT_SUN_TO_NEXT_MON,
-    SAT_SUN_TO_NEXT_MON_TUE,
-)
+from holidays.holiday_base import HolidayBase
 
 
-class Ireland(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
+class Ireland(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
     """
-    Official holidays in Ireland, as declared in the Citizen's Information
-    bulletin:
-    https://www.citizensinformation.ie/en/employment/employment_rights_and_conditions/leave_and_holidays/public_holidays_in_ireland.html
+    References:
+        - https://en.wikipedia.org/wiki/Public_holidays_in_the_Republic_of_Ireland
+        - https://www.citizensinformation.ie/en/employment/employment_rights_and_conditions/leave_and_holidays/public_holidays_in_ireland.html  # noqa: E501
     """
 
     country = "IE"
-    observed_label = "%s (observed)"
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
         InternationalHolidays.__init__(self)
         StaticHolidays.__init__(self, IrelandStaticHolidays)
-        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
+        if self._year <= 1871:
+            return None
+
         # New Year's Day.
-        self._add_new_years_day("New Year's Day")
+        if self._year >= 1975:
+            self._add_new_years_day("New Year's Day")
 
         # St. Brigid's Day.
         if self._year >= 2023:
@@ -48,35 +46,39 @@ class Ireland(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, Sta
                 self._add_holiday_1st_mon_from_feb_1(name)
 
         # St. Patrick's Day.
-        self._add_observed(self._add_holiday_mar_17("St. Patrick's Day"))
+        if self._year >= 1903:
+            self._add_holiday_mar_17("St. Patrick's Day")
 
         # Easter Monday.
         self._add_easter_monday("Easter Monday")
 
         # May Day.
-        if self._year >= 1978:
+        if self._year >= 1994:
             name = "May Day"
             if self._year == 1995:
                 self._add_holiday_may_8(name)
             else:
                 self._add_holiday_1st_mon_of_may(name)
 
-        # June Bank holiday.
-        self._add_holiday_1st_mon_of_jun("June Bank Holiday")
+        if self._year >= 1973:
+            # June Bank Holiday.
+            self._add_holiday_1st_mon_of_jun("June Bank Holiday")
+        else:
+            # Whit Monday.
+            self._add_whit_monday("Whit Monday")
 
-        # Summer Bank holiday.
+        # August Bank Holiday.
         self._add_holiday_1st_mon_of_aug("August Bank Holiday")
 
         # October Bank Holiday.
-        self._add_holiday_last_mon_of_oct("October Bank Holiday")
+        if self._year >= 1977:
+            self._add_holiday_last_mon_of_oct("October Bank Holiday")
 
         # Christmas Day.
-        self._add_observed(self._add_christmas_day("Christmas Day"))
+        self._add_christmas_day("Christmas Day")
 
         # St. Stephen's Day.
-        self._add_observed(
-            self._add_christmas_day_two("St. Stephen's Day"), rule=SAT_SUN_TO_NEXT_MON_TUE
-        )
+        self._add_christmas_day_two("St. Stephen's Day")
 
 
 class IE(Ireland):
@@ -89,5 +91,7 @@ class IRL(Ireland):
 
 class IrelandStaticHolidays:
     special_public_holidays = {
+        1999: (DEC, 31, "Millennium Celebrations"),
+        2011: (SEP, 14, "National Day of Mourning"),
         2022: (MAR, 18, "Day of Remembrance and Recognition"),
     }

holidays/countries/northern_mariana_islands.py

@@ -9,6 +9,7 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
@@ -18,12 +19,17 @@ class HolidaysMP(US):
     # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
 
     country = "MP"
+    supported_categories = (PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "MP"
         super()._populate_public_holidays()
 
+    def _populate_unofficial_holidays(self) -> None:
+        self.subdiv = "MP"
+        super()._populate_unofficial_holidays()
+
 
 class MP(HolidaysMP):
     pass

holidays/countries/portugal.py

@@ -145,7 +145,7 @@ class Portugal(HolidayBase, ChristianHolidays, InternationalHolidays):
         # - get Holidays that occur on Thursday and add Friday (+1 day)
 
         # Carnival.
-        self._add_carnival_monday(tr("Carnaval"))
+        self._add_carnival_tuesday(tr("Carnaval"))
 
         # St. Anthony's Day.
         self._add_holiday_jun_13(tr("Dia de Santo António"))

holidays/countries/puerto_rico.py

@@ -9,6 +9,7 @@
 #  Website: https://github.com/dr-prodigy/python-holidays
 #  License: MIT (see LICENSE file)
 
+from holidays.constants import PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
@@ -18,12 +19,17 @@ class HolidaysPR(US):
     # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
 
     country = "PR"
+    supported_categories = (PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "PR"
         super()._populate_public_holidays()
 
+    def _populate_unofficial_holidays(self) -> None:
+        self.subdiv = "PR"
+        super()._populate_unofficial_holidays()
+
 
 class PR(HolidaysPR):
     pass