holidays 0.85__py3-none-any.whl → 0.87__py3-none-any.whl

holidays/groups/chinese.py

@@ -13,7 +13,6 @@
 from datetime import date
 
 from holidays.calendars.chinese import _ChineseLunisolar, CHINESE_CALENDAR
-from holidays.calendars.gregorian import APR
 from holidays.groups.eastern import EasternCalendarHolidays
 
 
@@ -38,12 +37,9 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
     @property
     def _qingming_festival(self):
         """
-        Return Qingming Festival (15th day after the Spring Equinox) date.
+        Return Qingming Festival (5th solar term) date.
         """
-        day = 5
-        if (self._year % 4 < 1) or (self._year % 4 < 2 and self._year >= 2009):
-            day = 4
-        return date(self._year, APR, day)
+        return self._chinese_calendar.qingming_date(self._year)[0]
 
     @property
     def _mid_autumn_festival(self):
@@ -74,13 +70,6 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
         """
         return self._chinese_calendar.double_ninth_date(self._year)[0]
 
-    @property
-    def _dongzhi_festival(self):
-        """
-        Return Dongzhi Festival (Chinese Winter Solstice) date.
-        """
-        return self._chinese_calendar.winter_solstice_date(self._year)[0]
-
     def _add_chinese_calendar_holiday(
         self, name: str, dt_estimated: tuple[date | None, bool], days_delta: int = 0
     ) -> date | None:
@@ -199,14 +188,16 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
 
     def _add_dongzhi_festival(self, name) -> date | None:
         """
-        Add Dongzhi Festival (Chinese Winter Solstice).
+        Add Dongzhi Festival (22nd solar term, Winter Solstice).
 
         The Dongzhi Festival or Winter Solstice Festival is a traditional
         Chinese festival celebrated during the Dongzhi solar term
         (winter solstice), which falls between December 21 and 23.
         https://en.wikipedia.org/wiki/Dongzhi_Festival
         """
-        return self._add_holiday(name, self._dongzhi_festival)
+        return self._add_chinese_calendar_holiday(
+            name, self._chinese_calendar.winter_solstice_date(self._year)
+        )
 
     def _add_hanshi_festival(self, name) -> date | None:
         """
@@ -221,15 +212,17 @@ class ChineseCalendarHolidays(EasternCalendarHolidays):
             name, self._chinese_calendar.winter_solstice_date(self._year - 1), days_delta=+105
         )
 
-    def _add_qingming_festival(self, name) -> date:
+    def _add_qingming_festival(self, name) -> date | None:
         """
-        Add Qingming Festival (15th day after the Spring Equinox).
+        Add Qingming Festival (5th solar term of the Chinese lunisolar calendar).
 
         The Qingming festival or Ching Ming Festival, also known as
         Tomb-Sweeping Day in English, is a traditional Chinese festival.
         https://en.wikipedia.org/wiki/Qingming_Festival
         """
-        return self._add_holiday(name, self._qingming_festival)
+        return self._add_chinese_calendar_holiday(
+            name, self._chinese_calendar.qingming_date(self._year)
+        )
 
     def _add_double_ninth_festival(self, name) -> date | None:
         """

holidays/groups/hindu.py

@@ -59,6 +59,18 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
             days_delta=days_delta,
         )
 
+    def _add_bathukamma(self, name) -> date | None:
+        """
+        Add Bathukamma Festival.
+
+        Bathukamma is a floral festival celebrated predominantly in Telangana
+        and some parts of Andhra Pradesh. It starts on Mahalaya Amavasya.
+        https://en.wikipedia.org/wiki/Bathukamma
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.bathukamma_date(self._year)
+        )
+
     def _add_bhai_dooj(self, name) -> date | None:
         """
         Add Bhai Dooj.
@@ -301,6 +313,18 @@ class HinduCalendarHolidays(EasternCalendarHolidays):
             name, self._hindu_calendar.maha_shivaratri_date(self._year)
         )
 
+    def _add_maharana_pratap_jayanti(self, name) -> date | None:
+        """
+        Add Maharana Pratap Jayanti.
+
+        Maharana Pratap Jayanti celebrates the birth of the Rajput king Maharana Pratap.
+        It falls on the third day of the Shukla Paksha of the month of Jyeshtha.
+        https://en.wikipedia.org/wiki/Maharana_Pratap
+        """
+        return self._add_hindu_calendar_holiday(
+            name, self._hindu_calendar.maharana_pratap_jayanti_date(self._year)
+        )
+
     def _add_mahavir_jayanti(self, name) -> date | None:
         """
         Add Mahavir Jayanti.

holidays/holiday_base.py

@@ -46,6 +46,7 @@ from holidays.helpers import _normalize_arguments, _normalize_tuple
 CategoryArg = str | Iterable[str]
 DateArg = date | tuple[int, int] | tuple[int, int, int]
 DateLike = date | datetime | str | float | int
+NameLookup = Literal["contains", "exact", "startswith", "icontains", "iexact", "istartswith"]
 SpecialHoliday = tuple[int, int, str] | tuple[tuple[int, int, str], ...]
 SubstitutedHoliday = (
     tuple[int, int, int, int]
@@ -558,27 +559,25 @@ class HolidayBase(dict[date, str]):
 
             if key.step is None:
                 step = 1
-            elif isinstance(key.step, timedelta):
-                step = key.step.days
             elif isinstance(key.step, int):
                 step = key.step
+            elif isinstance(key.step, timedelta):
+                step = key.step.days
             else:
                 raise TypeError(f"Cannot convert type '{type(key.step)}' to int.")
 
             if step == 0:
                 raise ValueError("Step value must not be zero.")
 
-            date_diff = stop - start
-            if date_diff.days < 0 <= step or date_diff.days >= 0 > step:
-                step *= -1
-
-            days_in_range = []
-            for delta_days in range(0, date_diff.days, step):
-                day = _timedelta(start, delta_days)
-                if day in self:
-                    days_in_range.append(day)
+            diff_days = (stop - start).days
+            if diff_days < 0 <= step or diff_days >= 0 > step:
+                step = -step
 
-            return days_in_range
+            return [
+                day
+                for delta_days in range(0, diff_days, step)
+                if (day := _timedelta(start, delta_days)) in self
+            ]
 
         return dict.__getitem__(self, self.__keytransform__(key))
 
@@ -670,19 +669,14 @@ class HolidayBase(dict[date, str]):
         if self:
             return super().__repr__()
 
-        parts = []
         if hasattr(self, "market"):
-            parts.append(f"holidays.financial_holidays({self.market!r}")
-            parts.append(")")
+            return f"holidays.financial_holidays({self.market!r})"
         elif hasattr(self, "country"):
-            parts.append(f"holidays.country_holidays({self.country!r}")
             if self.subdiv:
-                parts.append(f", subdiv={self.subdiv!r}")
-            parts.append(")")
-        else:
-            parts.append("holidays.HolidayBase()")
+                return f"holidays.country_holidays({self.country!r}, subdiv={self.subdiv!r})"
+            return f"holidays.country_holidays({self.country!r})"
 
-        return "".join(parts)
+        return "holidays.HolidayBase()"
 
     def __setattr__(self, key: str, value: Any) -> None:
         dict.__setattr__(self, key, value)
@@ -809,6 +803,37 @@ class HolidayBase(dict[date, str]):
         self[dt] = self.tr(name)
         return dt
 
+    def _add_multiday_holiday(
+        self, start_date: date, duration_days: int, *, name: str | None = None
+    ) -> set[date]:
+        """Add a multi-day holiday.
+
+        Args:
+            start_date:
+                First day of the holiday.
+
+            duration_days:
+                Number of additional days to add.
+
+            name:
+                Optional holiday name; inferred from `start_date` if omitted.
+
+        Returns:
+            A set of all added holiday dates.
+
+        Raises:
+            ValueError:
+                If the holiday name cannot be inferred from `start_date`.
+        """
+        if (holiday_name := name or self.get(start_date)) is None:
+            raise ValueError(f"Cannot infer holiday name for date {start_date!r}.")
+
+        return {
+            d
+            for delta in range(1, duration_days + 1)
+            if (d := self._add_holiday(holiday_name, _timedelta(start_date, delta)))
+        }
+
     def _add_special_holidays(self, mapping_names, *, observed=False):
         """Add special holidays."""
         for mapping_name in mapping_names:
@@ -997,7 +1022,10 @@ class HolidayBase(dict[date, str]):
         return [name for name in self.get(key, "").split(HOLIDAY_NAME_DELIMITER) if name]
 
     def get_named(
-        self, holiday_name: str, lookup: str = "icontains", split_multiple_names: bool = True
+        self,
+        holiday_name: str,
+        lookup: NameLookup = "icontains",
+        split_multiple_names: bool = True,
     ) -> list[date]:
         """Find all holiday dates matching a given name.
 
@@ -1202,7 +1230,7 @@ class HolidayBase(dict[date, str]):
 
         return dict.pop(self, self.__keytransform__(key), default)
 
-    def pop_named(self, holiday_name: str, lookup: str = "icontains") -> list[date]:
+    def pop_named(self, holiday_name: str, lookup: NameLookup = "icontains") -> list[date]:
         """Remove all holidays matching the given name.
 
         This method removes all dates associated with a holiday name, so they are

holidays/utils.py

@@ -234,6 +234,7 @@ def financial_holidays(
     expand: bool = True,
     observed: bool = True,
     language: str | None = None,
+    categories: CategoryArg | None = None,
 ) -> HolidayBase:
     """Return a new dictionary-like [HolidayBase][holidays.holiday_base.HolidayBase] object.
 
@@ -291,6 +292,9 @@ def financial_holidays(
 
             This behavior will be updated and formalized in v1.
 
+        categories:
+            Requested holiday categories.
+
     Returns:
         A `HolidayBase` object matching the `market`.
 
@@ -306,7 +310,12 @@ def financial_holidays(
 
     try:
         return getattr(holidays, market)(
-            years=years, subdiv=subdiv, expand=expand, observed=observed, language=language
+            years=years,
+            subdiv=subdiv,
+            expand=expand,
+            observed=observed,
+            language=language,
+            categories=categories,
         )
     except AttributeError:
         raise NotImplementedError(f"Financial market {market} not available")

holidays/version.py

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

{holidays-0.85.dist-info → holidays-0.87.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.85
+Version: 0.87
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -32,7 +32,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: CONTRIBUTORS
 License-File: LICENSE
-Requires-Dist: python-dateutil
+Requires-Dist: python-dateutil<3,>=2.9.0.post0
 Dynamic: license-file
 
 # Holidays
@@ -307,7 +307,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Bangladesh</td>
 <td>BD</td>
 <td></td>
-<td></td>
+<td><strong>bn</strong>, en_US</td>
 <td></td>
 </tr>
 <tr>
@@ -427,7 +427,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>BG</td>
 <td></td>
 <td><strong>bg</strong>, en_US, uk</td>
-<td>SCHOOL</td>
+<td>HALF_DAY, SCHOOL</td>
 </tr>
 <tr>
 <td>Burkina Faso</td>
@@ -665,7 +665,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>EE</td>
 <td></td>
 <td>en_US, <strong>et</strong>, uk</td>
-<td></td>
+<td>HALF_DAY</td>
 </tr>
 <tr>
 <td>Eswatini</td>
@@ -895,7 +895,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>India</td>
 <td>IN</td>
 <td>States: AN (Andaman and Nicobar Islands), AP (Andhra Pradesh), AR (Arunachal Pradesh, Arunāchal Pradesh), AS (Assam), BR (Bihar, Bihār), CG (Chhattisgarh, Chhattīsgarh), CH (Chandigarh, Chandīgarh), DH (Dadra and Nagar Haveli and Daman and Diu, Dādra and Nagar Haveli and Damān and Diu), DL (Delhi), GA (Goa), GJ (Gujarat, Gujarāt), HP (Himachal Pradesh, Himāchal Pradesh), HR (Haryana, Haryāna), JH (Jharkhand, Jhārkhand), JK (Jammu and Kashmir, Jammu and Kashmīr), KA (Karnataka, Karnātaka), KL (Kerala), LA (Ladakh, Ladākh), LD (Lakshadweep), MH (Maharashtra, Mahārāshtra), ML (Meghalaya, Meghālaya), MN (Manipur), MP (Madhya Pradesh), MZ (Mizoram), NL (Nagaland, Nāgāland), OD (Odisha), PB (Punjab), PY (Puducherry), RJ (Rajasthan, Rājasthān), SK (Sikkim), TN (Tamil Nadu, Tamil Nādu), TR (Tripura), TS (Telangana, Telangāna), UK (Uttarakhand, Uttarākhand), UP (Uttar Pradesh), WB (West Bengal)</td>
-<td><strong>en_IN</strong>, en_US, hi</td>
+<td><strong>en_IN</strong>, en_US, gu, hi</td>
 <td>OPTIONAL</td>
 </tr>
 <tr>
@@ -944,7 +944,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Italy</td>
 <td>IT</td>
 <td>Provinces: AG (Agrigento), AL (Alessandria), AN (Ancona), AO (Aosta), AP (Ascoli Piceno), AQ (L'Aquila), AR (Arezzo), AT (Asti), AV (Avellino), BA (Bari), BG (Bergamo), BI (Biella), BL (Belluno), BN (Benevento), BO (Bologna), BR (Brindisi), BS (Brescia), BT (Barletta-Andria-Trani), BZ (Bolzano), CA (Cagliari), CB (Campobasso), CE (Caserta), CH (Chieti), CL (Caltanissetta), CN (Cuneo), CO (Como), CR (Cremona), CS (Cosenza), CT (Catania), CZ (Catanzaro), EN (Enna), FC (Forli-Cesena, Forlì-Cesena), FE (Ferrara), FG (Foggia), FI (Firenze), FM (Fermo), FR (Frosinone), GE (Genova), GO (Gorizia), GR (Grosseto), IM (Imperia), IS (Isernia), KR (Crotone), LC (Lecco), LE (Lecce), LI (Livorno), LO (Lodi), LT (Latina), LU (Lucca), MB (Monza e Brianza), MC (Macerata), ME (Messina), MI (Milano), MN (Mantova), MO (Modena), MS (Massa-Carrara), MT (Matera), NA (Napoli), NO (Novara), NU (Nuoro), OR (Oristano), PA (Palermo), PC (Piacenza), PD (Padova), PE (Pescara), PG (Perugia), PI (Pisa), PN (Pordenone), PO (Prato), PR (Parma), PT (Pistoia), PU (Pesaro e Urbino), PV (Pavia), PZ (Potenza), RA (Ravenna), RC (Reggio Calabria), RE (Reggio Emilia), RG (Ragusa), RI (Rieti), RM (Roma), RN (Rimini), RO (Rovigo), SA (Salerno), SI (Siena), SO (Sondrio), SP (La Spezia), SR (Siracusa), SS (Sassari), SU (Sud Sardegna), SV (Savona), TA (Taranto), TE (Teramo), TN (Trento), TO (Torino), TP (Trapani), TR (Terni), TS (Trieste), TV (Treviso), UD (Udine), VA (Varese), VB (Verbano-Cusio-Ossola), VC (Vercelli), VE (Venezia), VI (Vicenza), VR (Verona), VT (Viterbo), VV (Vibo Valentia); cities: Andria, Barletta, Cesena, Forli (Forlì), Pesaro, Trani, Urbino</td>
-<td></td>
+<td>en_US, <strong>it_IT</strong></td>
 <td></td>
 </tr>
 <tr>
@@ -1252,7 +1252,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Nepal</td>
 <td>NP</td>
 <td></td>
-<td></td>
+<td>en_US, <strong>ne</strong></td>
 <td>WORKDAY</td>
 </tr>
 <tr>
@@ -1680,7 +1680,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>SE</td>
 <td></td>
 <td>en_US, <strong>sv</strong>, th, uk</td>
-<td></td>
+<td>BANK, OPTIONAL</td>
 </tr>
 <tr>
 <td>Switzerland</td>
@@ -1940,8 +1940,9 @@ code when available. The following financial markets are available:
 <colgroup>
 <col style="width: 20.0%" />
 <col style="width: 4.0%" />
-<col style="width: 65.0%" />
-<col style="width: 15.0%" />
+<col style="width: 46.0%" />
+<col style="width: 20.0%" />
+<col style="width: 10.0%" />
 </colgroup>
 <thead>
 <tr>
@@ -1949,6 +1950,7 @@ code when available. The following financial markets are available:
 <th>Code</th>
 <th>Info</th>
 <th>Supported Languages</th>
+<th>Supported Categories</th>
 </tr>
 </thead>
 <tbody>
@@ -1957,30 +1959,35 @@ code when available. The following financial markets are available:
 <td>BVMF</td>
 <td>Brazil Stock Exchange and Over-the-Counter Market holidays (same as ANBIMA holidays)</td>
 <td>en_US, <strong>pt_BR</strong>, uk</td>
+<td></td>
 </tr>
 <tr>
 <td>European Central Bank</td>
 <td>XECB</td>
 <td>Trans-European Automated Real-time Gross Settlement (TARGET2)</td>
 <td></td>
+<td></td>
 </tr>
 <tr>
 <td>ICE Futures Europe</td>
 <td>IFEU</td>
 <td>A London-based Investment Exchange holidays</td>
 <td></td>
+<td></td>
 </tr>
 <tr>
 <td>National Stock Exchange of India</td>
 <td>XNSE</td>
 <td>National Stock Exchange of India market holidays</td>
 <td><strong>en_IN</strong>, en_US, hi</td>
+<td></td>
 </tr>
 <tr>
 <td>New York Stock Exchange</td>
 <td>XNYS</td>
 <td>NYSE market holidays (used by all other US-exchanges, including NASDAQ, etc.)</td>
 <td></td>
+<td>HALF_DAY</td>
 </tr>
 </tbody>
 </table>