holidays 0.55__py3-none-any.whl → 0.56__py3-none-any.whl

holidays/countries/italy.py

@@ -141,8 +141,119 @@ class Italy(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHoliday
         "Trani",
         "Urbino",
     )
-
-    _deprecated_subdivisions = ("Forlì",)
+    subdivisions_aliases = {
+        # Provinces.
+        "Agrigento": "AG",
+        "Alessandria": "AL",
+        "Ancona": "AN",
+        "Aosta": "AO",
+        "Ascoli Piceno": "AP",
+        "L'Aquila": "AQ",
+        "Arezzo": "AR",
+        "Asti": "AT",
+        "Avellino": "AV",
+        "Bari": "BA",
+        "Bergamo": "BG",
+        "Biella": "BI",
+        "Belluno": "BL",
+        "Benevento": "BN",
+        "Bologna": "BO",
+        "Brindisi": "BR",
+        "Brescia": "BS",
+        "Barletta-Andria-Trani": "BT",
+        "Bolzano": "BZ",
+        "Cagliari": "CA",
+        "Campobasso": "CB",
+        "Caserta": "CE",
+        "Chieti": "CH",
+        "Caltanissetta": "CL",
+        "Cuneo": "CN",
+        "Como": "CO",
+        "Cremona": "CR",
+        "Cosenza": "CS",
+        "Catania": "CT",
+        "Catanzaro": "CZ",
+        "Enna": "EN",
+        "Forli-Cesena": "FC",
+        "Forlì-Cesena": "FC",
+        "Ferrara": "FE",
+        "Foggia": "FG",
+        "Firenze": "FI",
+        "Fermo": "FM",
+        "Frosinone": "FR",
+        "Genova": "GE",
+        "Gorizia": "GO",
+        "Grosseto": "GR",
+        "Imperia": "IM",
+        "Isernia": "IS",
+        "Crotone": "KR",
+        "Lecco": "LC",
+        "Lecce": "LE",
+        "Livorno": "LI",
+        "Lodi": "LO",
+        "Latina": "LT",
+        "Lucca": "LU",
+        "Monza e Brianza": "MB",
+        "Macerata": "MC",
+        "Messina": "ME",
+        "Milano": "MI",
+        "Mantova": "MN",
+        "Modena": "MO",
+        "Massa-Carrara": "MS",
+        "Matera": "MT",
+        "Napoli": "NA",
+        "Novara": "NO",
+        "Nuoro": "NU",
+        "Oristano": "OR",
+        "Palermo": "PA",
+        "Piacenza": "PC",
+        "Padova": "PD",
+        "Pescara": "PE",
+        "Perugia": "PG",
+        "Pisa": "PI",
+        "Pordenone": "PN",
+        "Prato": "PO",
+        "Parma": "PR",
+        "Pistoia": "PT",
+        "Pesaro e Urbino": "PU",
+        "Pavia": "PV",
+        "Potenza": "PZ",
+        "Ravenna": "RA",
+        "Reggio Calabria": "RC",
+        "Reggio Emilia": "RE",
+        "Ragusa": "RG",
+        "Rieti": "RI",
+        "Roma": "RM",
+        "Rimini": "RN",
+        "Rovigo": "RO",
+        "Salerno": "SA",
+        "Siena": "SI",
+        "Sondrio": "SO",
+        "La Spezia": "SP",
+        "Siracusa": "SR",
+        "Sassari": "SS",
+        "Sud Sardegna": "SU",
+        "Savona": "SV",
+        "Taranto": "TA",
+        "Teramo": "TE",
+        "Trento": "TN",
+        "Torino": "TO",
+        "Trapani": "TP",
+        "Terni": "TR",
+        "Trieste": "TS",
+        "Treviso": "TV",
+        "Udine": "UD",
+        "Varese": "VA",
+        "Verbano-Cusio-Ossola": "VB",
+        "Vercelli": "VC",
+        "Venezia": "VE",
+        "Vicenza": "VI",
+        "Verona": "VR",
+        "Viterbo": "VT",
+        "Vibo Valentia": "VV",
+        # Cities.
+        "Forlì": "Forli",
+    }
 
     def __init__(self, *args, **kwargs):
         ChristianHolidays.__init__(self)
@@ -208,9 +319,6 @@ class Italy(HolidayBase, ChristianHolidays, InternationalHolidays, StaticHoliday
             # Saint Stephen's Day.
             self._add_christmas_day_two("Santo Stefano")
 
-        if self.subdiv == "Forlì":
-            self._populate_subdiv_forli_public_holidays()
-
     def _populate_subdiv_ag_public_holidays(self):
         self._add_holiday_feb_25("San Gerlando")
 

holidays/countries/laos.py

@@ -12,18 +12,11 @@
 
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import JAN, MAR, APR, MAY, JUL, OCT, DEC
+from holidays.calendars.gregorian import JAN, APR, JUL
 from holidays.calendars.thai import KHMER_CALENDAR
 from holidays.constants import BANK, PUBLIC, SCHOOL, WORKDAY
 from holidays.groups import InternationalHolidays, ThaiCalendarHolidays, StaticHolidays
-from holidays.observed_holiday_base import (
-    ObservedHolidayBase,
-    THU_FRI_TO_NEXT_MON,
-    FRI_TO_NEXT_TUE,
-    SAT_TO_NEXT_TUE,
-    SAT_SUN_TO_NEXT_MON,
-    SAT_SUN_TO_NEXT_WED,
-)
+from holidays.observed_holiday_base import ObservedHolidayBase, SAT_SUN_TO_NEXT_WORKDAY
 
 
 class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalendarHolidays):
@@ -40,7 +33,8 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
                     https://asean.org/wp-content/uploads/2022/12/ASEAN-Public-Holidays-2023.pdf
                     https://www.timeanddate.com/holidays/laos/
                     https://www.bcel.com.la/bcel/bcel-calendar.html?y=2022
-                    https://www.bcel.com.la/bcel/bcel-calendar.html?year=2023
+                    https://www.bcel.com.la/bcel/bcel-calendar.html?y=2023
+                    https://www.bcel.com.la/bcel/bcel-calendar.html?y=2024
                     http://www.lsx.com.la/cal/getStockCalendar.do?lang=lo (from 2011 onwards)
 
         !!! If Public Holiday falls on weekends, (in lieu) on workday !!!
@@ -51,6 +45,8 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
         - Saturdays and Sundays shall be restdays each week.
         - In-Lieu holidays shall be given if it fall on the weekends.
 
+        Although in-lieus has been de facto observed since at least 2012.
+
     Limitations:
 
     - Laotian holidays only works from 1976 onwards, and are only 100% accurate from 2018 onwards.
@@ -75,8 +71,8 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
         InternationalHolidays.__init__(self)
         ThaiCalendarHolidays.__init__(self, KHMER_CALENDAR)
         StaticHolidays.__init__(self, cls=LaosStaticHolidays)
-        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_MON)
-        kwargs.setdefault("observed_since", 2018)
+        kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_WORKDAY)
+        kwargs.setdefault("observed_since", 2012)
         super().__init__(*args, **kwargs)
 
     def _populate_bank_holidays(self):
@@ -126,27 +122,31 @@ class Laos(ObservedHolidayBase, InternationalHolidays, StaticHolidays, ThaiCalen
         # ວັນແມ່ຍິງສາກົນ
         # Status: In-Use.
         # Only acts as day off for Women.
+        # No in-lieus are observed in 2014.
 
         # International Women's Rights Day.
-        self._add_observed(self._add_womens_day(tr("ວັນແມ່ຍິງສາກົນ")))
+        womens_day = self._add_womens_day(tr("ວັນແມ່ຍິງສາກົນ"))
+        if self._year != 2014:
+            self._add_observed(womens_day)
 
         # ບຸນປີໃໝ່ລາວ
         # Status: In-Use.
         # Celebrated for 3 days from 14-16 April annualy.
         # Observed dates prior to 2018 are assigned manually.
-        #   - CASE 1: THU-FRI-SAT -> in lieu on MON.
-        #   - CASE 2: FRI-SAT-SUN -> in lieu on MON-TUE.
-        #   - CASE 3: SAT-SUN-MON -> in lieu on TUE-WED.
-        #   - CASE 4: SUN-MON-TUE -> in lieu on WED.
 
         # Lao New Year's Day.
         name = tr("ບຸນປີໃໝ່ລາວ")
-        dt = self._add_holiday_apr_14(name)
-        self._add_holiday_apr_15(name)
-        self._add_holiday_apr_16(name)
-
-        self._add_observed(dt, rule=THU_FRI_TO_NEXT_MON + SAT_TO_NEXT_TUE)
-        self._add_observed(dt, rule=FRI_TO_NEXT_TUE + SAT_SUN_TO_NEXT_WED)
+        songkran_years_apr_13_15 = {2012, 2017}
+        songkran_years_apr_13_16 = {2016, 2020, 2024}
+        dts_observed = set()
+        if self._year in songkran_years_apr_13_15.union(songkran_years_apr_13_16):
+            dts_observed.add(self._add_holiday_apr_13(name))
+        dts_observed.add(self._add_holiday_apr_14(name))
+        dts_observed.add(self._add_holiday_apr_15(name))
+        if self._year not in songkran_years_apr_13_15:
+            dts_observed.add(self._add_holiday_apr_16(name))
+        for dt in dts_observed:
+            self._add_observed(dt)
 
         # ວັນກຳມະກອນສາກົນ
         # Status: In-Use.
@@ -377,9 +377,6 @@ class LaosStaticHolidays:
     # Special Bank Holiday.
     special_bank_day_off = tr("ມື້ປິດການໃຫ້ບໍລິການຂອງທະນາຄານຕົວແທນ")
 
-    # New Year's Day.
-    new_year_day = tr("ວັນປີໃໝ່ສາກົນ")
-
     # International Women's Rights Day.
     international_womens_rights_day = tr("ວັນແມ່ຍິງສາກົນ")
 
@@ -389,55 +386,20 @@ class LaosStaticHolidays:
     # Lao New Year's Day (Special).
     lao_new_year_special = tr("ພັກບຸນປີໃໝ່ລາວ")
 
-    # International Labor Day.
-    international_labor_day = tr("ວັນກຳມະກອນສາກົນ")
-
     # Establishment Day of the Lao Women's Union.
     lao_womens_union = tr("ວັນສ້າງຕັ້ງສະຫະພັນແມ່ຍິງລາວ")
 
-    # Establishment Day of the BOL.
-    establishment_day_of_bol = tr("ວັນສ້າງຕັ້ງທະນາຄານແຫ່ງ ສປປ ລາວ")
-
-    # Lao National Day.
-    lao_national_day = tr("ວັນຊາດ")
-
     special_bank_holidays = {
         2015: (JAN, 2, special_bank_day_off),
     }
 
-    special_bank_holidays_observed = {
-        2017: (OCT, 9, establishment_day_of_bol),
-    }
-
     special_public_holidays = {
         2015: (APR, 17, lao_new_year_special),
-        2016: (
-            (APR, 13, lao_new_year_special),
-            (APR, 18, lao_new_year_special),
-        ),
-        2020: (
-            (APR, 13, lao_new_year_special),
-            (APR, 17, lao_new_year_special),
-        ),
     }
 
     special_public_holidays_observed = {
         2011: (APR, 13, lao_new_year),
-        2012: (
-            (JAN, 2, new_year_day),
-            (APR, 13, lao_new_year),
-            (APR, 17, lao_new_year),
-            (DEC, 3, lao_national_day),
-        ),
-        2013: (APR, 17, lao_new_year),
-        2015: (MAR, 9, international_womens_rights_day),
-        2016: (MAY, 2, international_labor_day),
-        2017: (
-            (JAN, 2, new_year_day),
-            (APR, 13, lao_new_year),
-            (APR, 17, lao_new_year),
-            (DEC, 4, lao_national_day),
-        ),
+        2020: (APR, 17, lao_new_year),
     }
 
     special_workday_holidays_observed = {

holidays/countries/liechtenstein.py

@@ -84,7 +84,7 @@ class Liechtenstein(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Christmas Day.
         self._add_christmas_day(tr("Weihnachten"))
 
-        # St. Stephen's Day.
+        # Saint Stephen's Day.
         self._add_christmas_day_two(tr("Stephanstag"))
 
     def _populate_bank_holidays(self):

holidays/countries/luxembourg.py

@@ -62,7 +62,7 @@ class Luxembourg(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Christmas Day.
         self._add_christmas_day(tr("Chrëschtdag"))
 
-        # St. Stephen's Day.
+        # Saint Stephen's Day.
         self._add_christmas_day_two(tr("Stiefesdag"))
 
 

holidays/countries/malaysia.py

@@ -87,41 +87,39 @@ class Malaysia(
         "15",
         "16",
     )
-    _deprecated_subdivisions = (
-        "JHR",
-        "KDH",
-        "KTN",
-        "KUL",
-        "LBN",
-        "MLK",
-        "NSN",
-        "PHG",
-        "PJY",
-        "PLS",
-        "PNG",
-        "PRK",
-        "SBH",
-        "SGR",
-        "SWK",
-        "TRG",
-    )
     subdivisions_aliases = {
         "Johor": "01",
+        "JHR": "01",
         "Kedah": "02",
+        "KDH": "02",
         "Kelantan": "03",
+        "KTN": "03",
         "Melaka": "04",
+        "MLK": "04",
         "Negeri Sembilan": "05",
+        "NSN": "05",
         "Pahang": "06",
+        "PHG": "06",
         "Pulau Pinang": "07",
+        "PNG": "07",
         "Perak": "08",
+        "PRK": "08",
         "Perlis": "09",
+        "PLS": "09",
         "Selangor": "10",
+        "SGR": "10",
         "Terengganu": "11",
+        "TRG": "11",
         "Sabah": "12",
+        "SBH": "12",
         "Sarawak": "13",
+        "SWK": "13",
         "WP Kuala Lumpur": "14",
+        "KUL": "14",
         "WP Labuan": "15",
+        "LBN": "15",
         "WP Putrajaya": "16",
+        "PJY": "16",
     }
     supported_languages = ("en_US", "ms_MY")
 
@@ -216,26 +214,6 @@ class Malaysia(
         if self._year <= 1951:
             return None
 
-        deprecated_mapping = {
-            "JHR": "01",
-            "KDH": "02",
-            "KTN": "03",
-            "KUL": "14",
-            "LBN": "15",
-            "MLK": "04",
-            "NSN": "05",
-            "PHG": "06",
-            "PJY": "16",
-            "PLS": "09",
-            "PNG": "07",
-            "PRK": "08",
-            "SBH": "12",
-            "SGR": "10",
-            "SWK": "13",
-            "TRG": "11",
-        }
-        self.subdiv = deprecated_mapping.get(self.subdiv, self.subdiv)
-
         if self.subdiv and self.subdiv not in {"13", "15"}:
             # Deepavali.
             self.dts_observed.add(self._add_diwali(tr("Hari Deepavali")))

holidays/countries/malta.py

@@ -62,7 +62,7 @@ class Malta(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Started in 1987 via Act LX of 1987.
 
         if self._year >= 1987:
-            # Feast of St. Paul's Shipwreck.
+            # Feast of Saint Paul's Shipwreck.
             self._add_holiday_feb_10(tr("Il-Festa tan-Nawfraġju ta' San Pawl"))
 
         # Il-Festa ta' San Ġużepp
@@ -70,7 +70,7 @@ class Malta(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Started in 1987 via Act LX of 1987.
 
         if self._year >= 1987:
-            # Feast of St. Joseph.
+            # Feast of Saint Joseph.
             self._add_saint_josephs_day(tr("Il-Festa ta' San Ġużepp"))
 
         # Jum il-Ħelsien
@@ -107,7 +107,7 @@ class Malta(HolidayBase, ChristianHolidays, InternationalHolidays):
         # Started in 1987 via Act LX of 1987.
 
         if self._year >= 1987:
-            # Feast of St. Peter and St. Paul.
+            # Feast of Saint Peter and Saint Paul.
             self._add_saints_peter_and_paul_day(tr("Il-Festa ta' San Pietru u San Pawl"))
 
         # Il-Festa ta' Santa Marija

holidays/countries/new_zealand.py

@@ -27,6 +27,7 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
     country = "NZ"
     observed_label = "%s (observed)"
     subdivisions = (
+        # ISO 3166-2: Regions and Special Island Authorities.
         # https://en.wikipedia.org/wiki/ISO_3166-2:NZ
         "AUK",  # Auckland / Tāmaki-makaurau
         "BOP",  # Bay of Plenty / Toi Moana
@@ -35,7 +36,7 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         "GIS",  # Gisborne / Te Tairāwhiti
         "HKB",  # Hawke's Bay / Te Matau a Māui
         "MBH",  # Marlborough
-        "MWT",  # Manawatū Whanganui
+        "MWT",  # Manawatū-Whanganui / Manawatū Whanganui
         "NSN",  # Nelson / Whakatū
         "NTL",  # Northland / Te Tai tokerau
         "OTA",  # Otago / Ō Tākou
@@ -45,27 +46,71 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         "WGN",  # Greater Wellington / Te Pane Matua Taiao
         "WKO",  # Waikato
         "WTC",  # West Coast / Te Tai o Poutini
+        # Subregions:
+        # https://www.govt.nz/browse/work/public-holidays-and-work/public-holidays-and-anniversary-dates/
+        "South Canterbury",
     )
-
+    subdivisions_aliases = {
+        # Fullnames in English and Maori, as well as HASC.
+        "Auckland": "AUK",
+        "Tāmaki-Makaurau": "AUK",
+        "AU": "AUK",
+        "Bay of Plenty": "BOP",
+        "Toi Moana": "BOP",
+        "BP": "BOP",
+        "Canterbury": "CAN",
+        "Waitaha": "CAN",
+        "CA": "CAN",
+        "Chatham Islands Territory": "CIT",
+        "Chatham Islands": "CIT",  # 1901-1994, as County
+        "Wharekauri": "CIT",
+        "CI": "CIT",
+        "Gisborne": "GIS",
+        "Te Tairāwhiti": "GIS",
+        "GI": "GIS",
+        "Hawke's Bay": "HKB",
+        "Te Matau-a-Māui": "HKB",
+        "HB": "HKB",
+        "Marlborough": "MBH",
+        "MA": "MBH",
+        "Manawatū Whanganui": "MWT",
+        "Manawatū-Whanganui": "MWT",
+        "MW": "MWT",
+        "Nelson": "NSN",
+        "Whakatū": "NSN",
+        "NE": "NSN",
+        "Northland": "NTL",
+        "Te Taitokerau": "NTL",
+        "NO": "NTL",
+        "Otago": "OTA",
+        "Ō Tākou": "OTA",
+        "OT": "OTA",
+        "Southland": "STL",
+        "Te Taiao Tonga": "STL",
+        "SO": "STL",
+        "Tasman": "TAS",
+        "Te tai o Aorere": "TAS",
+        "TS": "TAS",
+        "Taranaki": "TKI",
+        "TK": "TKI",
+        "Greater Wellington": "WGN",
+        "Te Pane Matua Taiao": "WGN",
+        "Wellington": "WGN",  # Prev. ISO code from 2010-2015.
+        "Te Whanganui-a-Tara": "WGN",  # Prev. ISO code from 2010-2015.
+        "WG": "WGN",
+        "Waikato": "WKO",
+        "WK": "WKO",
+        "West Coast": "WTC",
+        "Te Tai o Poutini": "WTC",
+        "WC": "WTC",
+    }
     _deprecated_subdivisions = (
-        "Auckland",
-        "Canterbury",
-        "Chatham Islands",
-        "Hawke's Bay",
-        "Marlborough",
-        "Nelson",
-        "New Plymouth",
-        "Northland",
-        "Otago",
-        "South Canterbury",
-        "STC",
-        "Southland",
-        "Taranaki",
-        "Waitangi",
-        "Wellington",
-        "West Coast",
-        "Westland",  # Correct name is West Coast
-        "WTL",  # Correct code is WTC
+        # Pre-1893 Naming in Previous Implementations.
+        "New Plymouth",  # 1853-1859, Now Taranaki.
+        "Westland",  # 1873-1876, Now West Coast.
+        # Unofficial Code.
+        "STC",  # For 'South Canterbury' Subregional Holidays.
+        "WTL",  # Westland, Correct code is WTC (for West Coast).
     )
 
     def __init__(self, *args, **kwargs):
@@ -186,31 +231,11 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
         # Boxing Day
         self._add_observed(self._add_christmas_day_two("Boxing Day"), rule=SAT_SUN_TO_NEXT_MON_TUE)
 
-        if self.subdiv == "Auckland":
-            self._populate_subdiv_auk_public_holidays()
-        elif self.subdiv == "Canterbury":
-            self._populate_subdiv_can_public_holidays()
-        elif self.subdiv == "Chatham Islands":
-            self._populate_subdiv_cit_public_holidays()
-        elif self.subdiv == "Hawke's Bay":
-            self._populate_subdiv_hkb_public_holidays()
-        elif self.subdiv == "Marlborough":
-            self._populate_subdiv_mbh_public_holidays()
-        elif self.subdiv == "Nelson":
-            self._populate_subdiv_nsn_public_holidays()
-        elif self.subdiv == "Northland":
-            self._populate_subdiv_ntl_public_holidays()
-        elif self.subdiv == "Otago":
-            self._populate_subdiv_ota_public_holidays()
-        elif self.subdiv in {"New Plymouth", "Taranaki"}:
+        if self.subdiv == "New Plymouth":
             self._populate_subdiv_tki_public_holidays()
         elif self.subdiv == "South Canterbury":
             self._populate_subdiv_stc_public_holidays()
-        elif self.subdiv == "Southland":
-            self._populate_subdiv_stl_public_holidays()
-        elif self.subdiv == "Wellington":
-            self._populate_subdiv_wgn_public_holidays()
-        elif self.subdiv in {"West Coast", "WTL", "Westland"}:
+        elif self.subdiv in {"WTL", "Westland"}:
             self._populate_subdiv_wtc_public_holidays()
 
     def _populate_subdiv_auk_public_holidays(self):
@@ -253,7 +278,7 @@ class NewZealand(ObservedHolidayBase, ChristianHolidays, InternationalHolidays,
     def _populate_subdiv_stl_public_holidays(self):
         name = "Southland Anniversary Day"
         if self._year >= 2012:
-            self._add_holiday_2_days_past_easter(name)
+            self._add_easter_tuesday(name)
         else:
             self._add_holiday(name, self._get_nearest_monday(JAN, 17))