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

holidays/groups/islamic.py

@@ -25,8 +25,12 @@ class IslamicHolidays(EasternCalendarHolidays):
     calendar consisting of 12 lunar months in a year of 354 or 355 days.
     """
 
-    def __init__(self, cls=None, show_estimated=True) -> None:
-        self._islamic_calendar = cls() if cls else _IslamicLunar()
+    def __init__(self, cls=None, *, show_estimated=True, calendar_delta_days=0) -> None:
+        self._islamic_calendar = (
+            cls(calendar_delta_days=calendar_delta_days)
+            if cls
+            else _IslamicLunar(calendar_delta_days=calendar_delta_days)
+        )
         self._islamic_calendar_show_estimated = show_estimated
 
     def _add_ali_al_rida_death_day(self, name) -> set[date]:
@@ -282,7 +286,10 @@ class IslamicHolidays(EasternCalendarHolidays):
         holiday date is an estimation.
         """
         return self._add_eastern_calendar_holiday_set(
-            name, dts_estimated, self._islamic_calendar_show_estimated, days_delta
+            name,
+            dts_estimated,
+            show_estimated=self._islamic_calendar_show_estimated,
+            days_delta=days_delta,
         )
 
     def _add_islamic_new_year_day(self, name) -> set[date]:

holidays/groups/mongolian.py

@@ -22,7 +22,7 @@ class MongolianCalendarHolidays(EasternCalendarHolidays):
     Mongolian lunisolar calendar holidays.
     """
 
-    def __init__(self, cls=None, show_estimated=False) -> None:
+    def __init__(self, cls=None, *, show_estimated=False) -> None:
         self._mongolian_calendar = cls() if cls else _MongolianLunisolar()
         self._mongolian_calendar_show_estimated = show_estimated
 
@@ -37,7 +37,10 @@ class MongolianCalendarHolidays(EasternCalendarHolidays):
         """
 
         return self._add_eastern_calendar_holiday(
-            name, dt_estimated, self._mongolian_calendar_show_estimated, days_delta
+            name,
+            dt_estimated,
+            show_estimated=self._mongolian_calendar_show_estimated,
+            days_delta=days_delta,
         )
 
     def _add_buddha_day(self, name) -> Optional[date]:

holidays/groups/sinhala.py

@@ -32,7 +32,7 @@ class SinhalaCalendarHolidays(EasternCalendarHolidays):
     Adhi month dates are instead hardcoded in Sri Lanka country implementation.
     """
 
-    def __init__(self, cls=None, show_estimated=False) -> None:
+    def __init__(self, cls=None, *, show_estimated=False) -> None:
         self._sinhala_calendar = cls() if cls else _SinhalaLunar()
         self._sinhala_calendar_show_estimated = show_estimated
 
@@ -46,7 +46,7 @@ class SinhalaCalendarHolidays(EasternCalendarHolidays):
         is an estimation.
         """
         return self._add_eastern_calendar_holiday(
-            name, dt_estimated, self._sinhala_calendar_show_estimated
+            name, dt_estimated, show_estimated=self._sinhala_calendar_show_estimated
         )
 
     def _add_sinhala_calendar_holiday_set(
@@ -59,7 +59,10 @@ class SinhalaCalendarHolidays(EasternCalendarHolidays):
         is an estimation.
         """
         return self._add_eastern_calendar_holiday_set(
-            name, dts_estimated, self._sinhala_calendar_show_estimated, days_delta
+            name,
+            dts_estimated,
+            show_estimated=self._sinhala_calendar_show_estimated,
+            days_delta=days_delta,
         )
 
     def _add_bak_poya(self, name) -> Optional[date]:

holidays/groups/tibetan.py

@@ -22,7 +22,7 @@ class TibetanCalendarHolidays(EasternCalendarHolidays):
     Tibetan lunisolar calendar holidays.
     """
 
-    def __init__(self, cls=None, show_estimated=False) -> None:
+    def __init__(self, cls=None, *, show_estimated=False) -> None:
         self._tibetan_calendar = cls() if cls else _TibetanLunisolar()
         self._tibetan_calendar_show_estimated = show_estimated
 
@@ -36,7 +36,10 @@ class TibetanCalendarHolidays(EasternCalendarHolidays):
         is an estimation.
         """
         return self._add_eastern_calendar_holiday(
-            name, dt_estimated, self._tibetan_calendar_show_estimated, days_delta
+            name,
+            dt_estimated,
+            show_estimated=self._tibetan_calendar_show_estimated,
+            days_delta=days_delta,
         )
 
     def _add_blessed_rainy_day(self, name) -> Optional[date]:

holidays/holiday_base.py

@@ -808,7 +808,7 @@ class HolidayBase(dict[date, str]):
         self[dt] = self.tr(name)
         return dt
 
-    def _add_special_holidays(self, mapping_names, observed=False):
+    def _add_special_holidays(self, mapping_names, *, observed=False):
         """Add special holidays."""
         for mapping_name in mapping_names:
             for data in _normalize_tuple(getattr(self, mapping_name, {}).get(self._year, ())):
@@ -865,7 +865,14 @@ class HolidayBase(dict[date, str]):
     def _is_sunday(self, *args) -> bool:
         return self._check_weekday(SUN, *args)
 
-    def _is_weekend(self, *args):
+    def _is_weekday(self, *args) -> bool:
+        """
+        Returns True if date's week day is not a weekend day.
+        Returns False otherwise.
+        """
+        return not self._is_weekend(*args)
+
+    def _is_weekend(self, *args) -> bool:
         """
         Returns True if date's week day is a weekend day.
         Returns False otherwise.
@@ -1361,11 +1368,12 @@ class HolidaySum(HolidayBase):
             else:
                 self.holidays.append(operand)
 
-        kwargs: dict[str, Any] = {}
         # Join years, expand and observed.
-        kwargs["years"] = h1.years | h2.years
-        kwargs["expand"] = h1.expand or h2.expand
-        kwargs["observed"] = h1.observed or h2.observed
+        kwargs: dict[str, Any] = {
+            "expand": h1.expand or h2.expand,
+            "observed": h1.observed or h2.observed,
+            "years": h1.years | h2.years,
+        }
         # Join country and subdivisions data.
         # TODO: this way makes no sense: joining Italy Catania (IT, CA) with
         # USA Mississippi (US, MS) and USA Michigan (US, MI) yields
@@ -1374,25 +1382,16 @@ class HolidaySum(HolidayBase):
         # and Milano, or ... you get the picture.
         # Same goes when countries and markets are being mixed (working, yet
         # still nonsensical).
+        value: Optional[Union[str, list[str]]]
         for attr in ("country", "market", "subdiv"):
-            if (
-                getattr(h1, attr, None)
-                and getattr(h2, attr, None)
-                and getattr(h1, attr) != getattr(h2, attr)
-            ):
-                a1 = (
-                    getattr(h1, attr)
-                    if isinstance(getattr(h1, attr), list)
-                    else [getattr(h1, attr)]
-                )
-                a2 = (
-                    getattr(h2, attr)
-                    if isinstance(getattr(h2, attr), list)
-                    else [getattr(h2, attr)]
-                )
+            a1 = getattr(h1, attr, None)
+            a2 = getattr(h2, attr, None)
+            if a1 and a2 and a1 != a2:
+                a1 = a1 if isinstance(a1, list) else [a1]
+                a2 = a2 if isinstance(a2, list) else [a2]
                 value = a1 + a2
             else:
-                value = getattr(h1, attr, None) or getattr(h2, attr, None)
+                value = a1 or a2
 
             if attr == "subdiv":
                 kwargs[attr] = value

holidays/observed_holiday_base.py

@@ -145,7 +145,9 @@ class ObservedHolidayBase(HolidayBase):
         self,
         dt: Optional[DateArg] = None,
         name: Optional[str] = None,
+        *,
         rule: Optional[ObservedRule] = None,
+        force_observed: bool = False,
         show_observed_label: bool = True,
     ) -> tuple[bool, Optional[date]]:
         if dt is None:
@@ -155,7 +157,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 +198,26 @@ class ObservedHolidayBase(HolidayBase):
         return True, dt_observed
 
     def _move_holiday(
-        self, dt: date, rule: Optional[ObservedRule] = None, show_observed_label: bool = True
+        self,
+        dt: date,
+        *,
+        rule: Optional[ObservedRule] = None,
+        force_observed: bool = False,
+        show_observed_label: bool = True,
     ) -> tuple[bool, Optional[date]]:
         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: Optional[ObservedRule] = None
+    ) -> tuple[bool, Optional[date]]:
+        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

@@ -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"),
@@ -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/version.py

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.82
+Version: 0.83
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -22,6 +22,7 @@ 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
@@ -52,7 +53,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 +65,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 +74,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 +95,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 +137,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 +595,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 +1260,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>
@@ -1692,7 +1687,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 +1901,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>