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

holidays/mixins/child_entity.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 typing import Optional
+
+from holidays.holiday_base import HolidayBase
+
+
+class ChildEntity:
+    """A mixin for child entities that inherit from a parent entity."""
+
+    parent_entity: type[HolidayBase]
+    """The parent entity class."""
+
+    parent_entity_subdivision_code: Optional[str] = None
+    """The parent entity's corresponding ISO 3166-2 subdivision code."""
+
+    subdivisions: tuple[str, ...] = ()
+    """Override parent subdivisions."""
+
+    subdivisions_aliases: dict[str, str] = {}
+    """Override parent subdivisions aliases."""
+
+    def __init__(self, *args, **kwargs):
+        """Initialize the child entity using its country code.
+
+        A child entity always has its own country code that is different from
+        the parent entity's country code but (in majority of cases) is a
+        subdivision of the parent entity. For setting specific subdivision code
+        value use `parent_entity_subdivision_code`.
+        """
+        kwargs["subdiv"] = self.parent_entity_subdivision_code or self.country
+        super().__init__(*args, **kwargs)

holidays/observed_holiday_base.py

@@ -58,6 +58,7 @@ SAT_TO_NEXT_SUN = ObservedRule({SAT: +1})
 SAT_TO_NEXT_WORKDAY = ObservedRule({SAT: +7})
 SAT_TO_NONE = ObservedRule({SAT: None})
 
+SUN_TO_PREV_SAT = ObservedRule({SUN: -1})
 SUN_TO_NEXT_MON = ObservedRule({SUN: +1})
 SUN_TO_NEXT_TUE = ObservedRule({SUN: +2})
 SUN_TO_NEXT_WED = ObservedRule({SUN: +3})
@@ -150,7 +151,9 @@ class ObservedHolidayBase(HolidayBase):
         if dt is None:
             return False, None
 
-        dt = dt if isinstance(dt, date) else date(self._year, *dt)
+        # Use as is if already a date.
+        # Convert to date: (m, d) → use self._year; (y, m, d) → use directly.
+        dt = dt if isinstance(dt, date) else date(self._year, *dt) if len(dt) == 2 else date(*dt)
 
         if not self.observed or not self._is_observed(dt):
             return False, dt

holidays/registry.py

@@ -45,6 +45,7 @@ COUNTRIES: RegistryDict = {
     "benin": ("Benin", "BJ", "BEN"),
     "bermuda": ("Bermuda", "BM", "BMU"),
     "bolivia": ("Bolivia", "BO", "BOL"),
+    "bonaire_sint_eustatius_and_saba": ("BonaireSintEustatiusAndSaba", "BQ", "BES"),
     "bosnia_and_herzegovina": ("BosniaAndHerzegovina", "BA", "BIH"),
     "botswana": ("Botswana", "BW", "BWA"),
     "brazil": ("Brazil", "BR", "BRA"),
@@ -53,12 +54,16 @@ COUNTRIES: RegistryDict = {
     "bulgaria": ("Bulgaria", "BG", "BLG"),
     "burkina_faso": ("BurkinaFaso", "BF", "BFA"),
     "burundi": ("Burundi", "BI", "BDI"),
+    "cabo_verde": ("CaboVerde", "CV", "CPV"),
     "cambodia": ("Cambodia", "KH", "KHM"),
     "cameroon": ("Cameroon", "CM", "CMR"),
     "canada": ("Canada", "CA", "CAN"),
+    "cayman_islands": ("CaymanIslands", "KY", "CYM"),
+    "central_african_republic": ("CentralAfricanRepublic", "CF", "CAF"),
     "chad": ("Chad", "TD", "TCD"),
     "chile": ("Chile", "CL", "CHL"),
     "china": ("China", "CN", "CHN"),
+    "christmas_island": ("ChristmasIsland", "CX", "CXR"),
     "cocos_islands": ("CocosIslands", "CC", "CCK"),
     "colombia": ("Colombia", "CO", "COL"),
     "congo": ("Congo", "CG", "COG"),
@@ -73,6 +78,7 @@ COUNTRIES: RegistryDict = {
     "djibouti": ("Djibouti", "DJ", "DJI"),
     "dominica": ("Dominica", "DM", "DMA"),
     "dominican_republic": ("DominicanRepublic", "DO", "DOM"),
+    "dr_congo": ("DRCongo", "CD", "COD"),
     "ecuador": ("Ecuador", "EC", "ECU"),
     "egypt": ("Egypt", "EG", "EGY"),
     "jordan": ("Jordan", "JO", "JOR"),
@@ -81,17 +87,23 @@ COUNTRIES: RegistryDict = {
     "estonia": ("Estonia", "EE", "EST"),
     "eswatini": ("Eswatini", "SZ", "SZW", "Swaziland"),
     "ethiopia": ("Ethiopia", "ET", "ETH"),
+    "falkland_islands": ("FalklandIslands", "FK", "FLK"),
+    "faroe_islands": ("FaroeIslands", "FO", "FRO"),
     "fiji": ("Fiji", "FJ", "FJI"),
     "finland": ("Finland", "FI", "FIN"),
     "france": ("France", "FR", "FRA"),
+    "french_guiana": ("FrenchGuiana", "GF", "GUF", "HolidaysGF"),
+    "french_polynesia": ("FrenchPolynesia", "PF", "PYF", "HolidaysPF"),
     "french_southern_territories": ("FrenchSouthernTerritories", "TF", "ATF", "HolidaysTF"),
     "gabon": ("Gabon", "GA", "GAB"),
     "georgia": ("Georgia", "GE", "GEO"),
     "germany": ("Germany", "DE", "DEU"),
     "ghana": ("Ghana", "GH", "GHA"),
+    "gibraltar": ("Gibraltar", "GI", "GIB"),
     "greece": ("Greece", "GR", "GRC"),
     "greenland": ("Greenland", "GL", "GRL"),
     "grenada": ("Grenada", "GD", "GRD"),
+    "guadeloupe": ("Guadeloupe", "GP", "GLP", "HolidaysGP"),
     "guam": ("Guam", "GU", "GUM", "HolidaysGU"),
     "guatemala": ("Guatemala", "GT", "GUA"),
     "guernsey": ("Guernsey", "GG", "GGY"),
@@ -119,7 +131,9 @@ COUNTRIES: RegistryDict = {
     "kyrgyzstan": ("Kyrgyzstan", "KG", "KGZ"),
     "laos": ("Laos", "LA", "LAO"),
     "latvia": ("Latvia", "LV", "LVA"),
+    "lebanon": ("Lebanon", "LB", "LBN"),
     "lesotho": ("Lesotho", "LS", "LSO"),
+    "libya": ("Libya", "LY", "LBY"),
     "liechtenstein": ("Liechtenstein", "LI", "LIE"),
     "lithuania": ("Lithuania", "LT", "LTU"),
     "luxembourg": ("Luxembourg", "LU", "LUX"),
@@ -128,30 +142,40 @@ COUNTRIES: RegistryDict = {
     "malawi": ("Malawi", "MW", "MWI"),
     "malaysia": ("Malaysia", "MY", "MYS"),
     "maldives": ("Maldives", "MV", "MDV"),
+    "mali": ("Mali", "ML", "MLI"),
     "malta": ("Malta", "MT", "MLT"),
     "marshall_islands": ("MarshallIslands", "MH", "MHL", "HolidaysMH"),
+    "martinique": ("Martinique", "MQ", "MTQ", "HolidaysMQ"),
     "mauritania": ("Mauritania", "MR", "MRT"),
+    "mauritius": ("Mauritius", "MU", "MUS"),
+    "mayotte": ("Mayotte", "YT", "MYT", "HolidaysYT"),
     "mexico": ("Mexico", "MX", "MEX"),
     "micronesia": ("Micronesia", "FM", "FSM"),
     "moldova": ("Moldova", "MD", "MDA"),
     "monaco": ("Monaco", "MC", "MCO"),
+    "mongolia": ("Mongolia", "MN", "MNG"),
     "montenegro": ("Montenegro", "ME", "MNE"),
+    "montserrat": ("Montserrat", "MS", "MSR"),
     "morocco": ("Morocco", "MA", "MOR"),
     "mozambique": ("Mozambique", "MZ", "MOZ"),
     "namibia": ("Namibia", "NA", "NAM"),
     "nauru": ("Nauru", "NR", "NRU"),
     "nepal": ("Nepal", "NP", "NPL"),
     "netherlands": ("Netherlands", "NL", "NLD"),
+    "new_caledonia": ("NewCaledonia", "NC", "NCL", "HolidaysNC"),
     "new_zealand": ("NewZealand", "NZ", "NZL"),
     "nicaragua": ("Nicaragua", "NI", "NIC"),
     "niger": ("Niger", "NE", "NER"),
     "nigeria": ("Nigeria", "NG", "NGA"),
+    "niue": ("Niue", "NU", "NIU"),
+    "norfolk_island": ("NorfolkIsland", "NF", "NFK"),
     "north_macedonia": ("NorthMacedonia", "MK", "MKD"),
     "northern_mariana_islands": ("NorthernMarianaIslands", "MP", "MNP", "HolidaysMP"),
     "norway": ("Norway", "NO", "NOR"),
     "oman": ("Oman", "OM", "OMN"),
     "pakistan": ("Pakistan", "PK", "PAK"),
     "palau": ("Palau", "PW", "PLW"),
+    "palestine": ("Palestine", "PS", "PSE"),
     "panama": ("Panama", "PA", "PAN"),
     "papua_new_guinea": ("PapuaNewGuinea", "PG", "PNG"),
     "paraguay": ("Paraguay", "PY", "PRY"),
@@ -161,10 +185,15 @@ COUNTRIES: RegistryDict = {
     "portugal": ("Portugal", "PT", "PRT"),
     "puerto_rico": ("PuertoRico", "PR", "PRI", "HolidaysPR"),
     "qatar": ("Qatar", "QA", "QAT"),
+    "reunion": ("Reunion", "RE", "REU", "HolidaysRE"),
     "romania": ("Romania", "RO", "ROU"),
     "russia": ("Russia", "RU", "RUS"),
+    "saint_barthelemy": ("SaintBarthelemy", "BL", "BLM", "HolidaysBL"),
     "saint_kitts_and_nevis": ("SaintKittsAndNevis", "KN", "KNA"),
     "saint_lucia": ("SaintLucia", "LC", "LCA"),
+    "saint_martin": ("SaintMartin", "MF", "MAF", "HolidaysMF"),
+    "saint_pierre_and_miquelon": ("SaintPierreAndMiquelon", "PM", "SPM", "HolidaysPM"),
+    "saint_vincent_and_the_grenadines": ("SaintVincentAndTheGrenadines", "VC", "VCT"),
     "samoa": ("Samoa", "WS", "WSM"),
     "san_marino": ("SanMarino", "SM", "SMR"),
     "sao_tome_and_principe": ("SaoTomeAndPrincipe", "ST", "STP"),
@@ -174,6 +203,7 @@ COUNTRIES: RegistryDict = {
     "seychelles": ("Seychelles", "SC", "SYC"),
     "sierra_leone": ("SierraLeone", "SL", "SLE"),
     "singapore": ("Singapore", "SG", "SGP"),
+    "sint_maarten": ("SintMaarten", "SX", "SXM"),
     "slovakia": ("Slovakia", "SK", "SVK"),
     "slovenia": ("Slovenia", "SI", "SVN"),
     "solomon_islands": ("SolomonIslands", "SB", "SLB"),
@@ -190,6 +220,7 @@ COUNTRIES: RegistryDict = {
     "thailand": ("Thailand", "TH", "THA"),
     "timor_leste": ("TimorLeste", "TL", "TLS"),
     "togo": ("Togo", "TG", "TGO"),
+    "tokelau": ("Tokelau", "TK", "TKL"),
     "tonga": ("Tonga", "TO", "TON"),
     "trinidad_and_tobago": ("TrinidadAndTobago", "TT", "TTO"),
     "tunisia": ("Tunisia", "TN", "TUN"),
@@ -213,6 +244,7 @@ COUNTRIES: RegistryDict = {
     "vatican_city": ("VaticanCity", "VA", "VAT"),
     "venezuela": ("Venezuela", "VE", "VEN"),
     "vietnam": ("Vietnam", "VN", "VNM"),
+    "wallis_and_futuna": ("WallisAndFutuna", "WF", "WLF", "HolidaysWF"),
     "yemen": ("Yemen", "YE", "YEM"),
     "zambia": ("Zambia", "ZM", "ZMB"),
     "zimbabwe": ("Zimbabwe", "ZW", "ZWE"),

holidays/version.py

@@ -10,4 +10,4 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-__version__ = "0.75"
+__version__ = "0.77"