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

holidays/financial/national_stock_exchange_of_india.py

@@ -13,13 +13,18 @@
 from gettext import gettext as tr
 
 from holidays.calendars import _CustomHinduHolidays, _CustomIslamicHolidays
-from holidays.calendars.gregorian import MAR, APR, MAY, JUN, JUL, AUG
-from holidays.groups import ChristianHolidays, HinduCalendarHolidays, IslamicHolidays
+from holidays.calendars.gregorian import JAN, FEB, MAR, APR, MAY, JUN, JUL, SEP, OCT, NOV, DEC
+from holidays.groups import (
+    ChristianHolidays,
+    HinduCalendarHolidays,
+    IslamicHolidays,
+    StaticHolidays,
+)
 from holidays.observed_holiday_base import ObservedHolidayBase, SAT_TO_NONE, SUN_TO_NONE
 
 
 class NationalStockExchangeOfIndia(
-    ObservedHolidayBase, HinduCalendarHolidays, ChristianHolidays, IslamicHolidays
+    ObservedHolidayBase, HinduCalendarHolidays, ChristianHolidays, IslamicHolidays, StaticHolidays
 ):
     """National Stock Exchange of India (NSE) holidays.
 
@@ -27,6 +32,27 @@ class NationalStockExchangeOfIndia(
         * <https://web.archive.org/web/20250821175252/https://www.nseindia.com/resources/exchange-communication-circulars>
 
     Historical data:
+        * [2001](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr2189.wri)
+        * [2002](https://archive.org/details/cmtr3058)
+        * [2003](https://web.archive.org/web/20250904042405/https://nsearchives.nseindia.com/content/circulars/cmtr3809.htm)
+        * [2004](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr4645.htm)
+        * [2005](https://web.archive.org/web/20250904043234/https://nsearchives.nseindia.com/content/circulars/cmtr5633.htm)
+        * [2006](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr6946.htm)
+        * [2007](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr8182.pdf)
+        * [2008](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr9908.htm)
+        * [2009](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr11733.htm)
+        * [2010](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr13713.pdf)
+        * [2011](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr16348.pdf)
+        * [2012](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr19539.pdf)
+        * [2013](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr22317.pdf)
+        * [2014](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr25326.pdf)
+        * [2015](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr28337.pdf)
+        * [2016](https://web.archive.org/web/20250903152854/https://nsearchives.nseindia.com/content/circulars/CMTR31297.pdf)
+        * [2017](https://web.archive.org/web/20250903152829/https://nsearchives.nseindia.com/content/circulars/CMTR33746.pdf)
+        * [2018](https://web.archive.org/web/20250903152307/https://nsearchives.nseindia.com/content/circulars/CMTR36475.pdf)
+        * [2019](https://archive.org/details/nsearchives.nseindia.comcontentcircularscmtr39612.pdf)
+        * [2020](https://web.archive.org/web/20250903152140/https://nsearchives.nseindia.com/content/circulars/CMTR42877.pdf)
+        * [2021](https://web.archive.org/web/20250903152041/https://nsearchives.nseindia.com/content/circulars/CMTR46623.pdf)
         * [2022](https://web.archive.org/web/20250821071611/https://nsearchives.nseindia.com/content/circulars/CMTR50560.pdf)
         * [2023](https://web.archive.org/web/20250821071635/https://nsearchives.nseindia.com/content/circulars/CMTR54757.pdf)
         * [2024](https://web.archive.org/web/20250821071650/https://nsearchives.nseindia.com/content/circulars/CMTR59722.pdf)
@@ -46,6 +72,9 @@ class NationalStockExchangeOfIndia(
             islamic_show_estimated:
                 Whether to add "estimated" label to Islamic holidays name
                 if holiday date is estimated.
+
+        In India, the dates of the Islamic calendar usually fall a day later than
+        the corresponding dates in the Umm al-Qura calendar.
         """
         ChristianHolidays.__init__(self)
         HinduCalendarHolidays.__init__(self, cls=NationalStockExchangeOfIndiaHinduHolidays)
@@ -53,7 +82,9 @@ class NationalStockExchangeOfIndia(
             self,
             cls=NationalStockExchangeOfIndiaIslamicHolidays,
             show_estimated=islamic_show_estimated,
+            calendar_delta_days=+1,
         )
+        StaticHolidays.__init__(self, cls=NationalStockExchangeOfIndiaStaticHolidays)
         kwargs.setdefault("observed_rule", SAT_TO_NONE + SUN_TO_NONE)
         super().__init__(*args, **kwargs)
 
@@ -64,16 +95,23 @@ class NationalStockExchangeOfIndia(
         # Good Friday.
         self._add_good_friday(tr("Good Friday"))
 
-        # Dr. Baba Saheb Ambedkar Jayanti.
+        # Dr. B. R. Ambedkar Jayanti.
         self._move_holiday(self._add_holiday_apr_14(tr("Dr. Baba Saheb Ambedkar Jayanti")))
 
-        # Maharashtra Day.
-        self._move_holiday(self._add_holiday_may_1(tr("Maharashtra Day")))
+        self._move_holiday(
+            self._add_holiday_may_1(
+                # May Day.
+                tr("May Day")
+                if 2010 <= self._year <= 2014
+                # Maharashtra Day.
+                else tr("Maharashtra Day")
+            )
+        )
 
         # Independence Day.
         self._move_holiday(self._add_holiday_aug_15(tr("Independence Day")))
 
-        # Mahatma Gandhi Jayanti.
+        # Gandhi Jayanti.
         self._move_holiday(self._add_holiday_oct_2(tr("Mahatma Gandhi Jayanti")))
 
         # Christmas Day.
@@ -81,17 +119,19 @@ class NationalStockExchangeOfIndia(
 
         # Hindu Calendar Holidays.
 
-        # Maha Shivaratri.
-        self._move_holiday(self._add_maha_shivaratri(tr("Maha Shivaratri")))
+        if self._year >= 2007:
+            # Maha Shivaratri.
+            self._move_holiday(self._add_maha_shivaratri(tr("Maha Shivaratri")))
 
         # Holi.
         self._move_holiday(self._add_holi(tr("Holi")))
 
-        # Ram Navami.
-        self._move_holiday(self._add_ram_navami(tr("Ram Navami")))
+        if self._year >= 2006:
+            # Ram Navami.
+            self._move_holiday(self._add_ram_navami(tr("Ram Navami")))
 
-        # Mahavir Jayanti.
-        self._move_holiday(self._add_mahavir_jayanti(tr("Mahavir Jayanti")))
+            # Mahavir Jayanti.
+            self._move_holiday(self._add_mahavir_jayanti(tr("Mahavir Jayanti")))
 
         # Ganesh Chaturthi.
         self._move_holiday(self._add_ganesh_chaturthi(tr("Ganesh Chaturthi")))
@@ -99,28 +139,35 @@ class NationalStockExchangeOfIndia(
         # Dussehra.
         self._move_holiday(self._add_dussehra(tr("Dussehra")))
 
-        # Diwali Laxmi Pujan.
-        self._move_holiday(self._add_gau_krida(tr("Diwali Laxmi Pujan")))
+        # Diwali Lakshmi Puja.
+        self._move_holiday(self._add_diwali_india(tr("Diwali Laxmi Pujan")))
 
-        # Diwali Balipratipada.
-        name = tr("Diwali Balipratipada")
-        # NSE's calendar adds an extra-day gap in 2022–2023
-        # between Diwali Laxmi Pujan and Diwali Balipratipada.
-        self._move_holiday(
-            self._add_bhai_dooj(name)
-            if self._year in {2022, 2023}
-            else self._add_govardhan_puja(name)
-        )
+        if self._year <= 2002 or self._year >= 2011:
+            # Diwali Balipratipada.
+            self._move_holiday(self._add_govardhan_puja(tr("Diwali Balipratipada")))
 
         # Guru Nanak Jayanti.
         self._move_holiday(self._add_guru_nanak_jayanti(tr("Guru Nanak Jayanti")))
 
+        if 2003 <= self._year <= 2010:
+            # Bhai Dooj.
+            self._move_holiday(self._add_bhai_dooj(tr("Bhau Bhij")))
+
+        if 2006 <= self._year <= 2009:
+            # Buddha Purnima.
+            self._move_holiday(self._add_buddha_purnima(tr("Buddha Purnima")))
+
         # Islamic Calendar Holidays.
 
         # Ashura.
         for dt in self._add_ashura_day(tr("Muharram")):
             self._move_holiday(dt)
 
+        if 2006 <= self._year <= 2009:
+            # Prophet's Birthday.
+            for dt in self._add_mawlid_day(tr("Id-E-Milad-Un-Nabi")):
+                self._move_holiday(dt)
+
         # Eid al-Fitr.
         for dt in self._add_eid_al_fitr_day(tr("Id-Ul-Fitr (Ramadan Eid)")):
             self._move_holiday(dt)
@@ -139,31 +186,87 @@ class NSE(NationalStockExchangeOfIndia):
 
 
 class NationalStockExchangeOfIndiaHinduHolidays(_CustomHinduHolidays):
+    BUDDHA_PURNIMA_DATES = {
+        2008: (MAY, 19),
+    }
+
+    DIWALI_INDIA_DATES = {
+        2024: (NOV, 1),
+        2025: (OCT, 21),
+    }
+
+    DUSSEHRA_DATES = {
+        2003: (OCT, 4),
+        2018: (OCT, 18),
+    }
+
+    GOVARDHAN_PUJA_DATES = {
+        2001: (NOV, 16),
+        2002: (NOV, 6),
+        2003: (OCT, 25),
+        2006: (OCT, 23),
+        2020: (NOV, 16),
+        2022: (OCT, 26),
+        2023: (NOV, 14),
+    }
+
     HOLI_DATES = {
         2023: (MAR, 7),
     }
 
+    MAHAVIR_JAYANTI_DATES = {
+        2010: (MAR, 28),
+        2016: (APR, 19),
+    }
+
+    RAM_NAVAMI_DATES = {
+        2007: (MAR, 27),
+    }
+
 
 class NationalStockExchangeOfIndiaIslamicHolidays(_CustomIslamicHolidays):
-    ASHURA_DATES_CONFIRMED_YEARS = (2022, 2025)
+    ASHURA_DATES_CONFIRMED_YEARS = (2001, 2025)
     ASHURA_DATES = {
-        2022: (AUG, 9),
-        2023: (JUL, 29),
-        2024: (JUL, 17),
-        2025: (JUL, 6),
+        2003: (MAR, 15),
+        2006: (FEB, 9),
+        2008: (JAN, 19),
+        2015: (OCT, 23),
+        2018: (SEP, 20),
     }
 
-    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2022, 2025)
+    EID_AL_ADHA_DATES_CONFIRMED_YEARS = (2001, 2025)
     EID_AL_ADHA_DATES = {
-        2022: (JUL, 10),
-        2024: (JUN, 17),
-        2025: (JUN, 7),
+        2003: (FEB, 13),
+        2005: (JAN, 21),
+        2006: (JAN, 11),
+        2007: ((JAN, 1), (DEC, 21)),
+        2009: (NOV, 27),
+        2014: (OCT, 6),
+        2015: (SEP, 25),
+        2016: (SEP, 13),
+        2023: (JUN, 28),
     }
 
-    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2022, 2025)
+    EID_AL_FITR_DATES_CONFIRMED_YEARS = (2001, 2025)
     EID_AL_FITR_DATES = {
-        2022: (MAY, 3),
-        2023: (APR, 22),
-        2024: (APR, 11),
-        2025: (MAR, 31),
+        2002: (DEC, 7),
+        2005: (NOV, 5),
+        2006: (OCT, 25),
+        2010: (SEP, 10),
+        2016: (JUL, 6),
+        2021: (MAY, 13),
+    }
+
+    MAWLID_DATES_CONFIRMED_YEARS = (2006, 2009)
+    MAWLID_DATES = {
+        2008: (MAR, 20),
+    }
+
+
+class NationalStockExchangeOfIndiaStaticHolidays:
+    """National Stock Exchange of India (NSE) special holidays."""
+
+    special_public_holidays = {
+        # New Year's Day.
+        2010: (JAN, 1, tr("New Year")),
     }

holidays/groups/__init__.py

@@ -10,8 +10,6 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-# ruff: noqa: F401
-
 from holidays.groups.balinese_saka import BalineseSakaCalendarHolidays
 from holidays.groups.buddhist import BuddhistCalendarHolidays
 from holidays.groups.burmese import BurmeseCalendarHolidays

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/mixins/__init__.py

@@ -10,8 +10,6 @@
 #  Website: https://github.com/vacanza/holidays
 #  License: MIT (see LICENSE file)
 
-# ruff: noqa: F401
-
 """Mixins for the holidays package."""
 
 from holidays.mixins.child_entity import ChildEntity

holidays/registry.py

@@ -287,7 +287,7 @@ COUNTRIES: RegistryDict = {
 FINANCIAL: RegistryDict = {
     "brasil_bolsa_balcao": ("BrasilBolsaBalcao", "BVMF", "B3"),
     "european_central_bank": ("EuropeanCentralBank", "XECB", "ECB", "TAR"),
-    "ice_futures_europe": ("ICEFuturesEurope", "IFEU"),
+    "ice_futures_europe": ("IceFuturesEurope", "IFEU", "ICEFuturesEurope"),
     "national_stock_exchange_of_india": ("NationalStockExchangeOfIndia", "XNSE", "NSE"),
     "ny_stock_exchange": ("NewYorkStockExchange", "XNYS", "NYSE"),
 }

holidays/version.py

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.84
+Version: 0.86
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -185,7 +185,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
-<td>Aland Islands</td>
+<td>Åland Islands</td>
 <td>AX</td>
 <td>Can also be loaded as country FI, subdivision 01</td>
 <td>en_US, <strong>fi</strong>, sv_FI, th, uk</td>
@@ -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>
@@ -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>