holidays 0.78__py3-none-any.whl → 0.80__py3-none-any.whl

holidays/holiday_base.py

@@ -1135,6 +1135,20 @@ class HolidayBase(dict[date, str]):
         days = (dt2 - dt1).days + 1
         return sum(self.is_working_day(_timedelta(dt1, n)) for n in range(days))
 
+    def is_weekend(self, key: DateLike) -> bool:
+        """Check if the given date's week day is a weekend day.
+
+        Args:
+            key:
+                The date to check.
+
+        Returns:
+            True if the date's week day is a weekend day, False otherwise.
+        """
+        # To prioritize performance we avoid reusing the internal
+        # `HolidayBase._is_weekend` method and perform the check directly instead.
+        return self.__keytransform__(key).weekday() in self.weekend
+
     def is_working_day(self, key: DateLike) -> bool:
         """Check if the given date is considered a working day.
 

holidays/registry.py

@@ -13,7 +13,7 @@
 import importlib
 from collections.abc import Iterable
 from threading import RLock
-from typing import Any, Optional, Union
+from typing import Any, Optional
 
 from holidays.holiday_base import HolidayBase
 
@@ -44,6 +44,7 @@ COUNTRIES: RegistryDict = {
     "belize": ("Belize", "BZ", "BLZ"),
     "benin": ("Benin", "BJ", "BEN"),
     "bermuda": ("Bermuda", "BM", "BMU"),
+    "bhutan": ("Bhutan", "BT", "BTN"),
     "bolivia": ("Bolivia", "BO", "BOL"),
     "bonaire_sint_eustatius_and_saba": ("BonaireSintEustatiusAndSaba", "BQ", "BES"),
     "bosnia_and_herzegovina": ("BosniaAndHerzegovina", "BA", "BIH"),
@@ -66,6 +67,7 @@ COUNTRIES: RegistryDict = {
     "christmas_island": ("ChristmasIsland", "CX", "CXR"),
     "cocos_islands": ("CocosIslands", "CC", "CCK"),
     "colombia": ("Colombia", "CO", "COL"),
+    "comoros": ("Comoros", "KM", "COM"),
     "congo": ("Congo", "CG", "COG"),
     "cook_islands": ("CookIslands", "CK", "COK"),
     "costa_rica": ("CostaRica", "CR", "CRI"),
@@ -84,6 +86,7 @@ COUNTRIES: RegistryDict = {
     "jordan": ("Jordan", "JO", "JOR"),
     "el_salvador": ("ElSalvador", "SV", "SLV"),
     "equatorial_guinea": ("EquatorialGuinea", "GQ", "GNQ"),
+    "eritrea": ("Eritrea", "ER", "ERI"),
     "estonia": ("Estonia", "EE", "EST"),
     "eswatini": ("Eswatini", "SZ", "SZW", "Swaziland"),
     "ethiopia": ("Ethiopia", "ET", "ETH"),
@@ -96,6 +99,7 @@ COUNTRIES: RegistryDict = {
     "french_polynesia": ("FrenchPolynesia", "PF", "PYF", "HolidaysPF"),
     "french_southern_territories": ("FrenchSouthernTerritories", "TF", "ATF", "HolidaysTF"),
     "gabon": ("Gabon", "GA", "GAB"),
+    "gambia": ("Gambia", "GM", "GMB"),
     "georgia": ("Georgia", "GE", "GEO"),
     "germany": ("Germany", "DE", "DEU"),
     "ghana": ("Ghana", "GH", "GHA"),
@@ -108,6 +112,7 @@ COUNTRIES: RegistryDict = {
     "guatemala": ("Guatemala", "GT", "GUA"),
     "guernsey": ("Guernsey", "GG", "GGY"),
     "guinea": ("Guinea", "GN", "GIN"),
+    "guinea_bissau": ("GuineaBissau", "GW", "GNB"),
     "guyana": ("Guyana", "GY", "GUY"),
     "haiti": ("Haiti", "HT", "HTI"),
     "honduras": ("Honduras", "HN", "HND"),
@@ -117,6 +122,7 @@ COUNTRIES: RegistryDict = {
     "india": ("India", "IN", "IND"),
     "indonesia": ("Indonesia", "ID", "IDN"),
     "iran": ("Iran", "IR", "IRN"),
+    "iraq": ("Iraq", "IQ", "IRQ"),
     "ireland": ("Ireland", "IE", "IRL"),
     "isle_of_man": ("IsleOfMan", "IM", "IMN"),
     "israel": ("Israel", "IL", "ISR"),
@@ -127,12 +133,14 @@ COUNTRIES: RegistryDict = {
     "jersey": ("Jersey", "JE", "JEY"),
     "kazakhstan": ("Kazakhstan", "KZ", "KAZ"),
     "kenya": ("Kenya", "KE", "KEN"),
+    "kiribati": ("Kiribati", "KI", "KIR"),
     "kuwait": ("Kuwait", "KW", "KWT"),
     "kyrgyzstan": ("Kyrgyzstan", "KG", "KGZ"),
     "laos": ("Laos", "LA", "LAO"),
     "latvia": ("Latvia", "LV", "LVA"),
     "lebanon": ("Lebanon", "LB", "LBN"),
     "lesotho": ("Lesotho", "LS", "LSO"),
+    "liberia": ("Liberia", "LR", "LBR"),
     "libya": ("Libya", "LY", "LBY"),
     "liechtenstein": ("Liechtenstein", "LI", "LIE"),
     "lithuania": ("Lithuania", "LT", "LTU"),
@@ -189,6 +197,7 @@ COUNTRIES: RegistryDict = {
     "reunion": ("Reunion", "RE", "REU", "HolidaysRE"),
     "romania": ("Romania", "RO", "ROU"),
     "russia": ("Russia", "RU", "RUS"),
+    "rwanda": ("Rwanda", "RW", "RWA"),
     "saint_barthelemy": ("SaintBarthelemy", "BL", "BLM", "HolidaysBL"),
     "saint_kitts_and_nevis": ("SaintKittsAndNevis", "KN", "KNA"),
     "saint_lucia": ("SaintLucia", "LC", "LCA"),
@@ -208,15 +217,24 @@ COUNTRIES: RegistryDict = {
     "slovakia": ("Slovakia", "SK", "SVK"),
     "slovenia": ("Slovenia", "SI", "SVN"),
     "solomon_islands": ("SolomonIslands", "SB", "SLB"),
+    "somalia": ("Somalia", "SO", "SOM"),
     "south_africa": ("SouthAfrica", "ZA", "ZAF"),
+    "south_georgia_and_the_south_sandwich_islands": (
+        "SouthGeorgiaAndTheSouthSandwichIslands",
+        "GS",
+        "SGS",
+    ),
     "south_korea": ("SouthKorea", "KR", "KOR", "Korea"),
+    "south_sudan": ("SouthSudan", "SS", "SSD"),
     "spain": ("Spain", "ES", "ESP"),
     "sri_lanka": ("SriLanka", "LK", "LKA"),
     "suriname": ("Suriname", "SR", "SUR"),
     "svalbard_and_jan_mayen": ("SvalbardAndJanMayen", "SJ", "SJM", "HolidaysSJ"),
     "sweden": ("Sweden", "SE", "SWE"),
     "switzerland": ("Switzerland", "CH", "CHE"),
+    "syrian_arab_republic": ("SyrianArabRepublic", "SY", "SYR"),
     "taiwan": ("Taiwan", "TW", "TWN"),
+    "tajikistan": ("Tajikistan", "TJ", "TJK"),
     "tanzania": ("Tanzania", "TZ", "TZA"),
     "thailand": ("Thailand", "TH", "THA"),
     "timor_leste": ("TimorLeste", "TL", "TLS"),
@@ -226,8 +244,10 @@ COUNTRIES: RegistryDict = {
     "trinidad_and_tobago": ("TrinidadAndTobago", "TT", "TTO"),
     "tunisia": ("Tunisia", "TN", "TUN"),
     "turkey": ("Turkey", "TR", "TUR"),
+    "turkmenistan": ("Turkmenistan", "TM", "TKM"),
     "turks_and_caicos_islands": ("TurksAndCaicosIslands", "TC", "TCA"),
     "tuvalu": ("Tuvalu", "TV", "TUV"),
+    "uganda": ("Uganda", "UG", "UGA"),
     "ukraine": ("Ukraine", "UA", "UKR"),
     "united_arab_emirates": ("UnitedArabEmirates", "AE", "ARE"),
     "united_kingdom": ("UnitedKingdom", "GB", "GBR", "UK"),
@@ -252,10 +272,11 @@ COUNTRIES: RegistryDict = {
 }
 
 FINANCIAL: RegistryDict = {
+    "brasil_bolsa_balcao": ("BrasilBolsaBalcao", "BVMF", "B3"),
     "european_central_bank": ("EuropeanCentralBank", "XECB", "ECB", "TAR"),
     "ice_futures_europe": ("ICEFuturesEurope", "IFEU"),
+    "national_stock_exchange_of_india": ("NationalStockExchangeOfIndia", "XNSE", "NSE"),
     "ny_stock_exchange": ("NewYorkStockExchange", "XNYS", "NYSE"),
-    "brasil_bolsa_balcao": ("BrasilBolsaBalcao", "BVMF", "B3"),
 }
 
 # A re-entrant lock. Once a thread has acquired a re-entrant lock,
@@ -318,35 +339,46 @@ class EntityLoader:
     @staticmethod
     def _get_entity_codes(
         container: RegistryDict,
-        entity_length: Union[int, Iterable[int]],
         include_aliases: bool = True,
+        max_code_length: int = 3,
+        min_code_length: int = 2,
     ) -> Iterable[str]:
-        entity_length = {entity_length} if isinstance(entity_length, int) else set(entity_length)
         for entities in container.values():
-            for entity in entities:
-                if len(entity) in entity_length:
-                    yield entity
-                    # Assuming that the alpha-2 code goes first.
-                    if not include_aliases:
-                        break
+            for code in entities[1:]:
+                if min_code_length <= len(code) <= max_code_length:
+                    yield code
+
+                # Stop after the first matching code if aliases are not requested.
+                # Assuming that the alpha-2 code goes first.
+                if not include_aliases:
+                    break
 
     @staticmethod
     def get_country_codes(include_aliases: bool = True) -> Iterable[str]:
         """Get supported country codes.
 
         :param include_aliases:
-            Whether to include entity aliases (e.g. UK for GB).
+            Whether to include entity aliases (e.g. GBR and UK for GB,
+            UKR for UA, USA for US, etc).
         """
-        return EntityLoader._get_entity_codes(COUNTRIES, 2, include_aliases)
+        return EntityLoader._get_entity_codes(
+            COUNTRIES,
+            include_aliases=include_aliases,
+        )
 
     @staticmethod
     def get_financial_codes(include_aliases: bool = True) -> Iterable[str]:
         """Get supported financial codes.
 
         :param include_aliases:
-            Whether to include entity aliases(e.g. TAR for ECB, XNYS for NYSE).
+            Whether to include entity aliases (e.g. B3 for BVMF,
+            TAR for ECB, NYSE for XNYS, etc).
         """
-        return EntityLoader._get_entity_codes(FINANCIAL, (3, 4), include_aliases)
+        return EntityLoader._get_entity_codes(
+            FINANCIAL,
+            include_aliases=include_aliases,
+            max_code_length=4,
+        )
 
     @staticmethod
     def load(prefix: str, scope: dict) -> None:

holidays/version.py

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

{holidays-0.78.dist-info → holidays-0.80.dist-info}/METADATA

@@ -1,14 +1,14 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.78
+Version: 0.80
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
 License-Expression: MIT
+Project-URL: Changelog, https://github.com/vacanza/holidays/releases/
 Project-URL: Documentation, https://holidays.readthedocs.io/en/latest/
 Project-URL: Repository, https://github.com/vacanza/holidays/
-Project-URL: Changelog, https://github.com/vacanza/holidays/releases/
-Keywords: holidays,calendar,l10n,worldwide,vacation
+Keywords: calendar,holidays,l10n,vacation,worldwide
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
 Classifier: Intended Audience :: Education
@@ -46,7 +46,7 @@ specific date is a holiday as fast and flexible as possible.
   <tr>
     <td>PyPI</td>
     <td>
-      <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/dm/holidays?color=41B5BE&style=flat" alt="PyPI downloads"></a>&nbsp;<a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat" alt="PyPI version"></a>&nbsp;<a href="https://github.com/vacanza/holidays/releases"><img src="https://img.shields.io/github/release-date/vacanza/holidays?color=41B5BE&style=flat" alt="PyPI release date"></a>
+      <a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/badge/dynamic/yaml?url=https%3A%2F%2Fraw.githubusercontent.com%2Fvacanza%2Faux%2Frefs%2Fheads%2Fmain%2Fbadges%2Fdownloads%2Fpepy.tech.yaml&query=%24.previous_month_downloads_human&suffix=%2Fmonth&style=flat&label=downloads&color=41B5BE&cacheSeconds=86400" alt="PyPI monthly downloads"></a>&nbsp;<a href="https://pypi.org/project/holidays"><img src="https://img.shields.io/pypi/v/holidays?color=41B5BE&label=version&style=flat" alt="PyPI version"></a>&nbsp;<a href="https://github.com/vacanza/holidays/releases"><img src="https://img.shields.io/github/release-date/vacanza/holidays?color=41B5BE&style=flat" alt="Latest release date"></a>
     </td>
   </tr>
   <tr>
@@ -142,7 +142,7 @@ and detailed information.
 
 ## Available Countries
 
-We currently support 224 country codes. The standard way to refer to a country is by using its [ISO
+We currently support 240 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
 code](https://en.wikipedia.org/wiki/ISO_3166-2). Some countries have common or foreign names or
@@ -352,6 +352,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Bhutan</td>
+<td>BT</td>
+<td>Administrative Subdivisions: 11 (Paro), 12 (Chhukha), 13 (Haa), 14 (Samtse), 15 (Thimphu), 21 (Tsirang), 22 (Dagana), 23 (Punakha), 24 (Wangdue Phodrang), 31 (Sarpang), 32 (Trongsa), 33 (Bumthang), 34 (Zhemgang), 41 (Trashigang), 42 (Monggar), 43 (Pema Gatshel), 44 (Lhuentse), 45 (Samdrup Jongkhar), GA (Gasa), TY (Trashi Yangtse)</td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Bolivia</td>
 <td>BO</td>
 <td>Departments: B (El Beni), C (Cochabamba), H (Chuquisaca), L (La Paz), N (Pando), O (Oruro), P (Potosí), S (Santa Cruz), T (Tarija)</td>
@@ -418,7 +425,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Burundi</td>
 <td>BI</td>
 <td></td>
-<td></td>
+<td>en_US, <strong>fr_BI</strong></td>
 <td></td>
 </tr>
 <tr>
@@ -506,6 +513,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Comoros</td>
+<td>KM</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Congo</td>
 <td>CG</td>
 <td></td>
@@ -625,6 +639,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Eritrea</td>
+<td>ER</td>
+<td></td>
+<td></td>
+<td>GOVERNMENT</td>
+</tr>
+<tr>
 <td>Estonia</td>
 <td>EE</td>
 <td></td>
@@ -709,11 +730,18 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Gambia</td>
+<td>GM</td>
+<td></td>
+<td><strong>en_GM</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Georgia</td>
 <td>GE</td>
 <td></td>
 <td>en_US, <strong>ka</strong>, uk</td>
-<td>GOVERNMENT</td>
+<td></td>
 </tr>
 <tr>
 <td>Germany</td>
@@ -793,6 +821,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Guinea-Bissau</td>
+<td>GW</td>
+<td></td>
+<td>en_US, <strong>pt_GW</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Guyana</td>
 <td>GY</td>
 <td></td>
@@ -856,6 +891,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Iraq</td>
+<td>IQ</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td>CHRISTIAN, HEBREW, SABIAN, YAZIDI</td>
+</tr>
+<tr>
 <td>Ireland</td>
 <td>IE</td>
 <td></td>
@@ -933,6 +975,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HINDU, ISLAMIC</td>
 </tr>
 <tr>
+<td>Kiribati</td>
+<td>KI</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Kuwait</td>
 <td>KW</td>
 <td></td>
@@ -975,6 +1024,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Liberia</td>
+<td>LR</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Libya</td>
 <td>LY</td>
 <td></td>
@@ -1007,7 +1063,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>MO</td>
 <td>Historical municipalities: I (Concelho das Ilhas, 海島市, 海岛市), M (Concelho de Macau, 澳門市, 澳门市)</td>
 <td>en_MO, en_US, pt_MO, th, zh_CN, <strong>zh_MO</strong></td>
-<td>GOVERNMENT, MANDATORY</td>
+<td>GOVERNMENT, OPTIONAL</td>
 </tr>
 <tr>
 <td>Madagascar</td>
@@ -1209,7 +1265,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Nigeria</td>
 <td>NG</td>
 <td></td>
-<td></td>
+<td><strong>en_NG</strong>, en_US</td>
 <td></td>
 </tr>
 <tr>
@@ -1367,6 +1423,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Rwanda</td>
+<td>RW</td>
+<td></td>
+<td>en_US, fr, <strong>rw</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Saint Barthélemy</td>
 <td>BL</td>
 <td>Can also be loaded as country FR, subdivision BL</td>
@@ -1500,6 +1563,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Somalia</td>
+<td>SO</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>South Africa</td>
 <td>ZA</td>
 <td></td>
@@ -1507,6 +1577,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>South Georgia and the South Sandwich Islands</td>
+<td>GS</td>
+<td></td>
+<td><strong>en_GS</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>South Korea</td>
 <td>KR</td>
 <td></td>
@@ -1514,6 +1591,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>BANK</td>
 </tr>
 <tr>
+<td>South Sudan</td>
+<td>SS</td>
+<td></td>
+<td></td>
+<td>ISLAMIC</td>
+</tr>
+<tr>
 <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>
@@ -1556,6 +1640,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HALF_DAY, OPTIONAL</td>
 </tr>
 <tr>
+<td>Syrian Arab Republic</td>
+<td>SY</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Taiwan</td>
 <td>TW</td>
 <td></td>
@@ -1563,6 +1654,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>GOVERNMENT, OPTIONAL, SCHOOL, WORKDAY</td>
 </tr>
 <tr>
+<td>Tajikistan</td>
+<td>TJ</td>
+<td></td>
+<td>en_US, ru, <strong>tg</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Tanzania</td>
 <td>TZ</td>
 <td></td>
@@ -1626,6 +1724,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HALF_DAY</td>
 </tr>
 <tr>
+<td>Turkmenistan</td>
+<td>TM</td>
+<td></td>
+<td>en_US, ru, <strong>tk</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Turks and Caicos Islands</td>
 <td>TC</td>
 <td></td>
@@ -1640,6 +1745,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Uganda</td>
+<td>UG</td>
+<td></td>
+<td></td>
+<td></td>
+</tr>
+<tr>
 <td>Ukraine</td>
 <td>UA</td>
 <td></td>
@@ -1802,6 +1914,12 @@ code when available. The following financial markets are available:
 <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>
+</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>