holidays 0.86__py3-none-any.whl → 0.88__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

@@ -775,7 +775,8 @@ class HolidayBase(dict[date, str]):
             if parent_entity := self.parent_entity:
                 entity_translation.add_fallback(
                     translation(
-                        parent_entity.country or parent_entity.market,
+                        getattr(parent_entity, "country", None)
+                        or getattr(parent_entity, "market", None),  # type: ignore[arg-type]
                         fallback=fallback,
                         languages=languages,
                         localedir=locale_directory,

holidays/registry.py

@@ -285,6 +285,7 @@ COUNTRIES: RegistryDict = {
 }
 
 FINANCIAL: RegistryDict = {
+    "bombay_stock_exchange": ("BombayStockExchange", "XBOM", "BSE"),
     "brasil_bolsa_balcao": ("BrasilBolsaBalcao", "BVMF", "B3"),
     "european_central_bank": ("EuropeanCentralBank", "XECB", "ECB", "TAR"),
     "ice_futures_europe": ("IceFuturesEurope", "IFEU", "ICEFuturesEurope"),

holidays/utils.py

@@ -16,14 +16,17 @@ __all__ = (
     "financial_holidays",
     "list_localized_countries",
     "list_localized_financial",
+    "list_long_breaks",
     "list_supported_countries",
     "list_supported_financial",
 )
 
 import warnings
 from collections.abc import Iterable
+from datetime import date
 from functools import cache
 
+from holidays.calendars.gregorian import _timedelta
 from holidays.holiday_base import CategoryArg, HolidayBase
 from holidays.registry import EntityLoader
 
@@ -234,6 +237,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 +295,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 +313,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")
@@ -434,3 +446,52 @@ def list_supported_financial(include_aliases: bool = True) -> dict[str, list[str
         subdivision codes.
     """
     return _list_supported_entities(EntityLoader.get_financial_codes(include_aliases))
+
+
+def list_long_breaks(
+    instance: HolidayBase, *, minimum_break_length: int = 3, require_weekend_overlap: bool = True
+) -> list[list[date]]:
+    """Get consecutive holidays.
+
+    Args:
+        instance:
+            HolidayBase object containing holidays data.
+
+        minimum_break_length:
+            The minimum number of consecutive holidays required for a break period
+            to be considered a long one. Defaults to 3.
+
+        require_weekend_overlap:
+            Whether to include only consecutive holidays that overlap with a weekend.
+            Defaults to True.
+
+    Returns:
+        A list of consecutive holidays longer than or equal to the specified minimum length.
+    """
+    long_breaks = []
+    seen_dates = set()
+
+    for dt in sorted(instance.keys()):
+        if dt in seen_dates:
+            continue
+
+        previous_working_day = instance.get_nth_working_day(dt, -1)
+        next_working_day = instance.get_nth_working_day(dt, +1)
+        long_break_length = (next_working_day - previous_working_day).days - 1
+
+        if long_break_length < minimum_break_length:
+            continue
+
+        is_long_break = not require_weekend_overlap
+        long_break_dates = []
+        for delta_days in range(1, long_break_length + 1):
+            holiday = _timedelta(previous_working_day, delta_days)
+            if not is_long_break and instance._is_weekend(holiday):
+                is_long_break = True
+            long_break_dates.append(holiday)
+            seen_dates.add(holiday)
+
+        if is_long_break:
+            long_breaks.append(long_break_dates)
+
+    return long_breaks

holidays/version.py

@@ -10,4 +10,6 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-__version__ = "0.86"
+from importlib.metadata import version
+
+__version__ = version("holidays")

{holidays-0.86.dist-info → holidays-0.88.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.86
+Version: 0.88
 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
@@ -210,7 +210,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>AS</td>
 <td>Can also be loaded as country US, subdivision AS</td>
 <td><strong>en_US</strong>, th</td>
-<td>GOVERNMENT, UNOFFICIAL</td>
+<td>UNOFFICIAL</td>
 </tr>
 <tr>
 <td>Andorra</td>
@@ -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>
@@ -397,7 +397,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <tr>
 <td>Brazil</td>
 <td>BR</td>
-<td>States: AC (Acre), AL (Alagoas), AM (Amazonas), AP (Amapá), BA (Bahia), CE (Ceará), DF (Distrito Federal), ES (Espírito Santo), GO (Goiás), MA (Maranhão), MG (Minas Gerais), MS (Mato Grosso do Sul), MT (Mato Grosso), PA (Pará), PB (Paraíba), PE (Pernambuco), PI (Piauí), PR (Paraná), RJ (Rio de Janeiro), RN (Rio Grande do Norte), RO (Rondônia), RR (Roraima), RS (Rio Grande do Sul), SC (Santa Catarina), SE (Sergipe), SP (São Paulo), TO (Tocantins)</td>
+<td>States: AC (Acre), AL (Alagoas), AM (Amazonas), AP (Amapá), BA (Bahia), CE (Ceará), DF (Distrito Federal), ES (Espírito Santo), GO (Goiás), MA (Maranhão), MG (Minas Gerais), MS (Mato Grosso do Sul), MT (Mato Grosso), PA (Pará), PB (Paraíba), PE (Pernambuco), PI (Piauí), PR (Paraná), RJ (Rio de Janeiro), RN (Rio Grande do Norte), RO (Rondônia), RR (Roraima), RS (Rio Grande do Sul), SC (Santa Catarina), SE (Sergipe), SP (São Paulo), TO (Tocantins); cities: São Paulo Capital</td>
 <td>en_US, <strong>pt_BR</strong>, uk</td>
 <td>OPTIONAL</td>
 </tr>
@@ -812,7 +812,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>GU</td>
 <td>Can also be loaded as country US, subdivision GU</td>
 <td><strong>en_US</strong>, th</td>
-<td>GOVERNMENT, UNOFFICIAL</td>
+<td>UNOFFICIAL</td>
 </tr>
 <tr>
 <td>Guatemala</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>
@@ -1316,7 +1316,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>MP</td>
 <td>Can also be loaded as country US, subdivision MP</td>
 <td><strong>en_US</strong>, th</td>
-<td>GOVERNMENT, UNOFFICIAL</td>
+<td>UNOFFICIAL</td>
 </tr>
 <tr>
 <td>North Korea</td>
@@ -1428,7 +1428,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>PR</td>
 <td>Can also be loaded as country US, subdivision PR</td>
 <td><strong>en_US</strong>, th</td>
-<td>GOVERNMENT, UNOFFICIAL</td>
+<td>HALF_DAY, UNOFFICIAL</td>
 </tr>
 <tr>
 <td>Qatar</td>
@@ -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>BANK, OPTIONAL</td>
+<td>BANK, DE_FACTO, OPTIONAL</td>
 </tr>
 <tr>
 <td>Switzerland</td>
@@ -1827,14 +1827,14 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>UM</td>
 <td>Can also be loaded as country US, subdivision UM</td>
 <td><strong>en_US</strong>, th</td>
-<td>GOVERNMENT, UNOFFICIAL</td>
+<td>UNOFFICIAL</td>
 </tr>
 <tr>
 <td>United States of America (the)</td>
 <td>US</td>
 <td>States and territories: AK (Alaska), AL (Alabama), AR (Arkansas), AS (American Samoa), AZ (Arizona), CA (California), CO (Colorado), CT (Connecticut), DC (District of Columbia), DE (Delaware), FL (Florida), GA (Georgia), GU (Guam), HI (Hawaii), IA (Iowa), ID (Idaho), IL (Illinois), IN (Indiana), KS (Kansas), KY (Kentucky), LA (Louisiana), MA (Massachusetts), MD (Maryland), ME (Maine), MI (Michigan), MN (Minnesota), MO (Missouri), MP (Northern Mariana Islands), MS (Mississippi), MT (Montana), NC (North Carolina), ND (North Dakota), NE (Nebraska), NH (New Hampshire), NJ (New Jersey), NM (New Mexico), NV (Nevada), NY (New York), OH (Ohio), OK (Oklahoma), OR (Oregon), PA (Pennsylvania), PR (Puerto Rico), RI (Rhode Island), SC (South Carolina), SD (South Dakota), TN (Tennessee), TX (Texas), UM (United States Minor Outlying Islands), UT (Utah), VA (Virginia), VI (Virgin Islands, U.S.), VT (Vermont), WA (Washington), WI (Wisconsin), WV (West Virginia), WY (Wyoming)</td>
 <td><strong>en_US</strong>, th</td>
-<td>GOVERNMENT, UNOFFICIAL</td>
+<td>GOVERNMENT, HALF_DAY, UNOFFICIAL</td>
 </tr>
 <tr>
 <td>United States Virgin Islands (the)</td>
@@ -1890,7 +1890,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>VI</td>
 <td>Can also be loaded as country US, subdivision VI</td>
 <td><strong>en_US</strong>, th</td>
-<td>GOVERNMENT, UNOFFICIAL</td>
+<td>UNOFFICIAL</td>
 </tr>
 <tr>
 <td>Wallis and Futuna</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,38 +1950,51 @@ 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>
 <tr>
+<td>Bombay Stock Exchange</td>
+<td>XBOM</td>
+<td>Bombay Stock Exchange (BSE) market holidays</td>
+<td><strong>en_IN</strong>, en_US, gu, hi</td>
+<td></td>
+</tr>
+<tr>
 <td>Brasil, Bolsa, Balcão</td>
 <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><strong>en_IN</strong>, en_US, gu, 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>