holidays 0.82__py3-none-any.whl → 0.84__py3-none-any.whl

holidays/mixins/child_entity.py

@@ -11,8 +11,6 @@
 #  License: MIT (see LICENSE file)
 
 
-from typing import Optional
-
 from holidays.holiday_base import HolidayBase
 
 
@@ -22,7 +20,7 @@ class ChildEntity:
     parent_entity: type[HolidayBase]
     """The parent entity class."""
 
-    parent_entity_subdivision_code: Optional[str] = None
+    parent_entity_subdivision_code: str | None = None
     """The parent entity's corresponding ISO 3166-2 subdivision code."""
 
     subdivisions: tuple[str, ...] = ()

holidays/observed_holiday_base.py

@@ -11,13 +11,12 @@
 #  License: MIT (see LICENSE file)
 
 from datetime import date
-from typing import Optional
 
 from holidays.calendars.gregorian import MON, TUE, WED, THU, FRI, SAT, SUN, _timedelta
 from holidays.holiday_base import DateArg, HolidayBase
 
 
-class ObservedRule(dict[int, Optional[int]]):
+class ObservedRule(dict[int, int | None]):
     __slots__ = ()
 
     def __add__(self, other):
@@ -106,8 +105,8 @@ class ObservedHolidayBase(HolidayBase):
 
     def __init__(
         self,
-        observed_rule: Optional[ObservedRule] = None,
-        observed_since: Optional[int] = None,
+        observed_rule: ObservedRule | None = None,
+        observed_since: int | None = None,
         *args,
         **kwargs,
     ):
@@ -127,7 +126,7 @@ class ObservedHolidayBase(HolidayBase):
                 return dt_work
         return dt
 
-    def _get_observed_date(self, dt: date, rule: ObservedRule) -> Optional[date]:
+    def _get_observed_date(self, dt: date, rule: ObservedRule) -> date | None:
         delta = rule.get(dt.weekday(), 0)
         if delta:
             return (
@@ -143,11 +142,13 @@ class ObservedHolidayBase(HolidayBase):
 
     def _add_observed(
         self,
-        dt: Optional[DateArg] = None,
-        name: Optional[str] = None,
-        rule: Optional[ObservedRule] = None,
+        dt: DateArg | None = None,
+        name: str | None = None,
+        *,
+        rule: ObservedRule | None = None,
+        force_observed: bool = False,
         show_observed_label: bool = True,
-    ) -> tuple[bool, Optional[date]]:
+    ) -> tuple[bool, date | None]:
         if dt is None:
             return False, None
 
@@ -155,7 +156,7 @@ class ObservedHolidayBase(HolidayBase):
         # 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):
+        if not (force_observed or (self.observed and self._is_observed(dt))):
             return False, dt
 
         dt_observed = self._get_observed_date(dt, rule or self._observed_rule)
@@ -196,16 +197,26 @@ class ObservedHolidayBase(HolidayBase):
         return True, dt_observed
 
     def _move_holiday(
-        self, dt: date, rule: Optional[ObservedRule] = None, show_observed_label: bool = True
-    ) -> tuple[bool, Optional[date]]:
+        self,
+        dt: date,
+        *,
+        rule: ObservedRule | None = None,
+        force_observed: bool = False,
+        show_observed_label: bool = True,
+    ) -> tuple[bool, date | None]:
         is_observed, dt_observed = self._add_observed(
-            dt, rule=rule, show_observed_label=show_observed_label
+            dt, rule=rule, force_observed=force_observed, show_observed_label=show_observed_label
         )
         if is_observed:
             self.pop(dt)
         return is_observed, dt_observed if is_observed else dt
 
-    def _populate_observed(self, dts: set[date], multiple: bool = False) -> None:
+    def _move_holiday_forced(
+        self, dt: date, rule: ObservedRule | None = None
+    ) -> tuple[bool, date | None]:
+        return self._move_holiday(dt, rule=rule, force_observed=True, show_observed_label=False)
+
+    def _populate_observed(self, dts: set[date], *, multiple: bool = False) -> None:
         """
         When multiple is True, each holiday from a given date has its own observed date.
         """

holidays/registry.py

@@ -13,7 +13,7 @@
 import importlib
 from collections.abc import Iterable
 from threading import RLock
-from typing import Any, Optional
+from typing import Any
 
 from holidays.holiday_base import HolidayBase
 
@@ -278,6 +278,7 @@ COUNTRIES: RegistryDict = {
     "venezuela": ("Venezuela", "VE", "VEN"),
     "vietnam": ("Vietnam", "VN", "VNM"),
     "wallis_and_futuna": ("WallisAndFutuna", "WF", "WLF", "HolidaysWF"),
+    "western_sahara": ("WesternSahara", "EH", "ESH"),
     "yemen": ("Yemen", "YE", "YEM"),
     "zambia": ("Zambia", "ZM", "ZMB"),
     "zimbabwe": ("Zimbabwe", "ZW", "ZWE"),
@@ -326,7 +327,7 @@ class EntityLoader:
         cls = self.get_entity()
         return cls(*args, **kwargs)  # type: ignore[misc, operator]
 
-    def __getattr__(self, name: str) -> Optional[Any]:
+    def __getattr__(self, name: str) -> Any | None:
         """Return attribute of a lazy-loaded entity."""
         cls = self.get_entity()
         return getattr(cls, name)
@@ -338,7 +339,7 @@ class EntityLoader:
             f"use the '{self.module_name}.{self.entity_name}' class directly."
         )
 
-    def get_entity(self) -> Optional[HolidayBase]:
+    def get_entity(self) -> HolidayBase | None:
         """Return lazy-loaded entity."""
         if self.entity is None:
             # Avoid deadlock due to importlib.import_module not being thread-safe by caching all
@@ -351,6 +352,7 @@ class EntityLoader:
     @staticmethod
     def _get_entity_codes(
         container: RegistryDict,
+        *,
         include_aliases: bool = True,
         max_code_length: int = 3,
         min_code_length: int = 2,

holidays/utils.py

@@ -23,7 +23,6 @@ __all__ = (
 import warnings
 from collections.abc import Iterable
 from functools import cache
-from typing import Optional, Union
 
 from holidays.holiday_base import CategoryArg, HolidayBase
 from holidays.registry import EntityLoader
@@ -31,14 +30,14 @@ from holidays.registry import EntityLoader
 
 def country_holidays(
     country: str,
-    subdiv: Optional[str] = None,
-    years: Optional[Union[int, Iterable[int]]] = None,
+    subdiv: str | None = None,
+    years: int | Iterable[int] | None = None,
     expand: bool = True,
     observed: bool = True,
-    prov: Optional[str] = None,
-    state: Optional[str] = None,
-    language: Optional[str] = None,
-    categories: Optional[CategoryArg] = None,
+    prov: str | None = None,
+    state: str | None = None,
+    language: str | None = None,
+    categories: CategoryArg | None = None,
 ) -> HolidayBase:
     """Return a new dictionary-like [HolidayBase][holidays.holiday_base.HolidayBase] object.
 
@@ -230,11 +229,11 @@ def country_holidays(
 
 def financial_holidays(
     market: str,
-    subdiv: Optional[str] = None,
-    years: Optional[Union[int, Iterable[int]]] = None,
+    subdiv: str | None = None,
+    years: int | Iterable[int] | None = None,
     expand: bool = True,
     observed: bool = True,
-    language: Optional[str] = None,
+    language: str | None = None,
 ) -> HolidayBase:
     """Return a new dictionary-like [HolidayBase][holidays.holiday_base.HolidayBase] object.
 
@@ -315,12 +314,12 @@ def financial_holidays(
 
 def CountryHoliday(  # noqa: N802
     country: str,
-    subdiv: Optional[str] = None,
-    years: Optional[Union[int, Iterable[int]]] = None,
+    subdiv: str | None = None,
+    years: int | Iterable[int] | None = None,
     expand: bool = True,
     observed: bool = True,
-    prov: Optional[str] = None,
-    state: Optional[str] = None,
+    prov: str | None = None,
+    state: str | None = None,
 ) -> HolidayBase:
     """
     Note:

holidays/version.py

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

{holidays-0.82.dist-info → holidays-0.84.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.82
+Version: 0.84
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -17,18 +17,18 @@ Classifier: Intended Audience :: Financial and Insurance Industry
 Classifier: Intended Audience :: Information Technology
 Classifier: Operating System :: OS Independent
 Classifier: Programming Language :: Python :: 3 :: Only
-Classifier: Programming Language :: Python :: 3.9
 Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Topic :: File Formats :: JSON
 Classifier: Topic :: Office/Business :: Financial :: Accounting
 Classifier: Topic :: Office/Business :: Financial :: Investment
 Classifier: Topic :: Office/Business :: Scheduling
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
-Requires-Python: >=3.9
+Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: CONTRIBUTORS
 License-File: LICENSE
@@ -52,7 +52,7 @@ specific date is a holiday as fast and flexible as possible.
   <tr>
     <td>CI/CD</td>
     <td>
-      <a href="https://github.com/vacanza/holidays/actions/workflows/ci-cd.yml?query=branch%3Adev"><img src="https://img.shields.io/github/actions/workflow/status/vacanza/holidays/ci-cd.yml?branch=dev&color=41BE4A&style=flat" alt="CI/CD status"></a>&nbsp;<a href="https://holidays.readthedocs.io/en/latest/?badge=latest"><img src="https://img.shields.io/readthedocs/holidays?color=41BE4A&style=flat" alt="Documentation status"></a>
+      <a href="https://github.com/vacanza/holidays/actions/workflows/ci-cd.yml?query=branch%3Adev"><img src="https://img.shields.io/github/actions/workflow/status/vacanza/holidays/ci-cd.yml?branch=dev&color=41B5BE&style=flat" alt="CI/CD status"></a>&nbsp;<a href="https://holidays.readthedocs.io/en/latest/?badge=latest"><img src="https://img.shields.io/readthedocs/holidays?color=41B5BE&style=flat" alt="Documentation status"></a>&nbsp;<a href="https://snyk.io/advisor/python/holidays/"><img alt="Open World Holidays Package Health Score" src="https://img.shields.io/badge/dynamic/regex?url=https%3A%2F%2Fsnyk.io%2Fadvisor%2Fpython%2Fholidays%2Fbadge.svg&search=%5Cd%7B1%2C3%7D%2F%5Cd%7B1%2C3%7D&style=flat&label=snyk&color=41B5BE"></a>
     </td>
   </tr>
   <tr>
@@ -64,7 +64,7 @@ specific date is a holiday as fast and flexible as possible.
   <tr>
     <td>GitHub</td>
     <td>
-      <a href="https://github.com/vacanza/holidays/stargazers"><img src="https://img.shields.io/github/stars/vacanza/holidays?color=41BE4A&style=flat" alt="GitHub stars"></a>&nbsp;<a href="https://github.com/vacanza/holidays/forks"><img src="https://img.shields.io/github/forks/vacanza/holidays?color=41BE4A&style=flat" alt="GitHub forks"></a>&nbsp;<a href="https://github.com/vacanza/holidays/graphs/contributors"><img src="https://img.shields.io/github/contributors/vacanza/holidays?color=41BE4A&style=flat" alt="GitHub contributors"></a>&nbsp;<a href="https://github.com/vacanza/holidays/commits/dev"><img src="https://img.shields.io/github/last-commit/vacanza/holidays/dev?color=41BE4A&style=flat" alt="GitHub last commit"></a>
+      <a href="https://github.com/vacanza/holidays/stargazers"><img src="https://img.shields.io/github/stars/vacanza/holidays?color=41B5BE&style=flat" alt="GitHub stars"></a>&nbsp;<a href="https://github.com/vacanza/holidays/forks"><img src="https://img.shields.io/github/forks/vacanza/holidays?color=41B5BE&style=flat" alt="GitHub forks"></a>&nbsp;<a href="https://github.com/vacanza/holidays/graphs/contributors"><img src="https://img.shields.io/github/contributors/vacanza/holidays?color=41B5BE&style=flat" alt="GitHub contributors"></a>&nbsp;<a href="https://github.com/vacanza/holidays/commits/dev"><img src="https://img.shields.io/github/last-commit/vacanza/holidays/dev?color=41B5BE&style=flat" alt="GitHub last commit"></a>
     </td>
   </tr>
   <tr>
@@ -73,12 +73,6 @@ specific date is a holiday as fast and flexible as possible.
       <a href="https://doi.org/10.5281/zenodo.14884702"><img src="https://img.shields.io/badge/DOI-10.5281/zenodo.14884702-41B5BE?style=flat" alt="Open World Holidays Framework DOI"></a>
     </td>
   </tr>
-  <tr>
-    <td>Snyk</td>
-    <td>
-      <a href="https://snyk.io/advisor/python/holidays/"><img src="https://snyk.io/advisor/python/holidays/badge.svg" alt="Open World Holidays Package Health Score"></a>
-    </td>
-  </tr>
 </table>
 
 ## Install
@@ -100,7 +94,7 @@ version upgrades.
 
 ## Documentation
 
-The documentation is hosted on [Read the Docs](https://holidays.readthedocs.io/).
+The documentation is hosted on [Read the Docs](https://holidays.readthedocs.io).
 
 ## Quick Start
 
@@ -142,9 +136,9 @@ and detailed information.
 
 ## Available Countries
 
-We currently support 248 country codes. The standard way to refer to a country is by using its [ISO
-3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes), the same used
-for domain names, and for a subdivision its [ISO 3166-2
+We currently support 249 country codes and are fully compatible with [ISO 3166-1](https://www.iso.org/iso-3166-country-codes.html).
+The standard way to refer to a country is by using its [ISO 3166-1 alpha-2 code](https://en.wikipedia.org/wiki/List_of_ISO_3166_country_codes),
+the same used for domain names, and for a subdivision its [ISO 3166-2
 code](https://en.wikipedia.org/wiki/ISO_3166-2). Some countries have common or foreign names or
 abbreviations as aliases for their subdivisions. These are defined in the (optional)
 `subdivisions_aliases` attribute. Some of the countries support more than one language for holiday
@@ -600,7 +594,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Denmark</td>
 <td>DK</td>
 <td></td>
-<td><strong>da</strong>, en_US, uk</td>
+<td><strong>da</strong>, en_US, th, uk</td>
 <td>OPTIONAL</td>
 </tr>
 <tr>
@@ -1265,7 +1259,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Netherlands</td>
 <td>NL</td>
 <td></td>
-<td>en_US, fy, <strong>nl</strong>, uk</td>
+<td>en_US, fy, <strong>nl</strong>, th, uk</td>
 <td>OPTIONAL</td>
 </tr>
 <tr>
@@ -1650,7 +1644,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Spain</td>
 <td>ES</td>
 <td>Autonomous communities: AN (Andalucía), AR (Aragón), AS (Asturias), CB (Cantabria), CE (Ceuta), CL (Castilla y León), CM (Castilla-La Mancha), CN (Canarias), CT (Cataluña, Catalunya), EX (Extremadura), GA (Galicia), IB (Islas Baleares, Illes Balears), MC (Murcia), MD (Madrid), ML (Melilla), NC (Navarra), PV (País Vasco), RI (La Rioja), VC (Valenciana)</td>
-<td>ca, en_US, <strong>es</strong>, uk</td>
+<td>ca, en_US, <strong>es</strong>, th, uk</td>
 <td></td>
 </tr>
 <tr>
@@ -1692,7 +1686,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Switzerland</td>
 <td>CH</td>
 <td>Cantons: AG (Aargau), AI (Appenzell Innerrhoden), AR (Appenzell Ausserrhoden), BE (Bern, Berne), BL (Basel-Landschaft), BS (Basel-Stadt), FR (Freiburg, Fribourg), GE (Genève), GL (Glarus), GR (Graubünden, Grigioni, Grischun), JU (Jura), LU (Luzern), NE (Neuchâtel), NW (Nidwalden), OW (Obwalden), SG (Sankt Gallen), SH (Schaffhausen), SO (Solothurn), SZ (Schwyz), TG (Thurgau), TI (Ticino), UR (Uri), VD (Vaud), VS (Valais, Wallis), ZG (Zug), ZH (Zürich)</td>
-<td><strong>de</strong>, en_US, fr, it, uk</td>
+<td><strong>de</strong>, en_US, fr, it, th, uk</td>
 <td>HALF_DAY, OPTIONAL</td>
 </tr>
 <tr>
@@ -1906,6 +1900,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Western Sahara</td>
+<td>EH</td>
+<td></td>
+<td><strong>ar</strong>, en_US, es, fr</td>
+<td></td>
+</tr>
+<tr>
 <td>Yemen</td>
 <td>YE</td>
 <td></td>