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

holidays/registry.py

@@ -54,12 +54,16 @@ COUNTRIES: RegistryDict = {
     "bulgaria": ("Bulgaria", "BG", "BLG"),
     "burkina_faso": ("BurkinaFaso", "BF", "BFA"),
     "burundi": ("Burundi", "BI", "BDI"),
+    "cabo_verde": ("CaboVerde", "CV", "CPV"),
     "cambodia": ("Cambodia", "KH", "KHM"),
     "cameroon": ("Cameroon", "CM", "CMR"),
     "canada": ("Canada", "CA", "CAN"),
+    "cayman_islands": ("CaymanIslands", "KY", "CYM"),
+    "central_african_republic": ("CentralAfricanRepublic", "CF", "CAF"),
     "chad": ("Chad", "TD", "TCD"),
     "chile": ("Chile", "CL", "CHL"),
     "china": ("China", "CN", "CHN"),
+    "christmas_island": ("ChristmasIsland", "CX", "CXR"),
     "cocos_islands": ("CocosIslands", "CC", "CCK"),
     "colombia": ("Colombia", "CO", "COL"),
     "congo": ("Congo", "CG", "COG"),
@@ -74,6 +78,7 @@ COUNTRIES: RegistryDict = {
     "djibouti": ("Djibouti", "DJ", "DJI"),
     "dominica": ("Dominica", "DM", "DMA"),
     "dominican_republic": ("DominicanRepublic", "DO", "DOM"),
+    "dr_congo": ("DRCongo", "CD", "COD"),
     "ecuador": ("Ecuador", "EC", "ECU"),
     "egypt": ("Egypt", "EG", "EGY"),
     "jordan": ("Jordan", "JO", "JOR"),
@@ -83,6 +88,7 @@ COUNTRIES: RegistryDict = {
     "eswatini": ("Eswatini", "SZ", "SZW", "Swaziland"),
     "ethiopia": ("Ethiopia", "ET", "ETH"),
     "falkland_islands": ("FalklandIslands", "FK", "FLK"),
+    "faroe_islands": ("FaroeIslands", "FO", "FRO"),
     "fiji": ("Fiji", "FJ", "FJI"),
     "finland": ("Finland", "FI", "FIN"),
     "france": ("France", "FR", "FRA"),
@@ -93,6 +99,7 @@ COUNTRIES: RegistryDict = {
     "georgia": ("Georgia", "GE", "GEO"),
     "germany": ("Germany", "DE", "DEU"),
     "ghana": ("Ghana", "GH", "GHA"),
+    "gibraltar": ("Gibraltar", "GI", "GIB"),
     "greece": ("Greece", "GR", "GRC"),
     "greenland": ("Greenland", "GL", "GRL"),
     "grenada": ("Grenada", "GD", "GRD"),
@@ -124,6 +131,7 @@ COUNTRIES: RegistryDict = {
     "kyrgyzstan": ("Kyrgyzstan", "KG", "KGZ"),
     "laos": ("Laos", "LA", "LAO"),
     "latvia": ("Latvia", "LV", "LVA"),
+    "lebanon": ("Lebanon", "LB", "LBN"),
     "lesotho": ("Lesotho", "LS", "LSO"),
     "libya": ("Libya", "LY", "LBY"),
     "liechtenstein": ("Liechtenstein", "LI", "LIE"),
@@ -134,6 +142,7 @@ COUNTRIES: RegistryDict = {
     "malawi": ("Malawi", "MW", "MWI"),
     "malaysia": ("Malaysia", "MY", "MYS"),
     "maldives": ("Maldives", "MV", "MDV"),
+    "mali": ("Mali", "ML", "MLI"),
     "malta": ("Malta", "MT", "MLT"),
     "marshall_islands": ("MarshallIslands", "MH", "MHL", "HolidaysMH"),
     "martinique": ("Martinique", "MQ", "MTQ", "HolidaysMQ"),
@@ -146,6 +155,7 @@ COUNTRIES: RegistryDict = {
     "monaco": ("Monaco", "MC", "MCO"),
     "mongolia": ("Mongolia", "MN", "MNG"),
     "montenegro": ("Montenegro", "ME", "MNE"),
+    "montserrat": ("Montserrat", "MS", "MSR"),
     "morocco": ("Morocco", "MA", "MOR"),
     "mozambique": ("Mozambique", "MZ", "MOZ"),
     "namibia": ("Namibia", "NA", "NAM"),
@@ -157,17 +167,21 @@ COUNTRIES: RegistryDict = {
     "nicaragua": ("Nicaragua", "NI", "NIC"),
     "niger": ("Niger", "NE", "NER"),
     "nigeria": ("Nigeria", "NG", "NGA"),
+    "niue": ("Niue", "NU", "NIU"),
+    "norfolk_island": ("NorfolkIsland", "NF", "NFK"),
     "north_macedonia": ("NorthMacedonia", "MK", "MKD"),
     "northern_mariana_islands": ("NorthernMarianaIslands", "MP", "MNP", "HolidaysMP"),
     "norway": ("Norway", "NO", "NOR"),
     "oman": ("Oman", "OM", "OMN"),
     "pakistan": ("Pakistan", "PK", "PAK"),
     "palau": ("Palau", "PW", "PLW"),
+    "palestine": ("Palestine", "PS", "PSE"),
     "panama": ("Panama", "PA", "PAN"),
     "papua_new_guinea": ("PapuaNewGuinea", "PG", "PNG"),
     "paraguay": ("Paraguay", "PY", "PRY"),
     "peru": ("Peru", "PE", "PER"),
     "philippines": ("Philippines", "PH", "PHL"),
+    "pitcairn_islands": ("PitcairnIslands", "PN", "PCN"),
     "poland": ("Poland", "PL", "POL"),
     "portugal": ("Portugal", "PT", "PRT"),
     "puerto_rico": ("PuertoRico", "PR", "PRI", "HolidaysPR"),
@@ -180,6 +194,7 @@ COUNTRIES: RegistryDict = {
     "saint_lucia": ("SaintLucia", "LC", "LCA"),
     "saint_martin": ("SaintMartin", "MF", "MAF", "HolidaysMF"),
     "saint_pierre_and_miquelon": ("SaintPierreAndMiquelon", "PM", "SPM", "HolidaysPM"),
+    "saint_vincent_and_the_grenadines": ("SaintVincentAndTheGrenadines", "VC", "VCT"),
     "samoa": ("Samoa", "WS", "WSM"),
     "san_marino": ("SanMarino", "SM", "SMR"),
     "sao_tome_and_principe": ("SaoTomeAndPrincipe", "ST", "STP"),
@@ -206,6 +221,7 @@ COUNTRIES: RegistryDict = {
     "thailand": ("Thailand", "TH", "THA"),
     "timor_leste": ("TimorLeste", "TL", "TLS"),
     "togo": ("Togo", "TG", "TGO"),
+    "tokelau": ("Tokelau", "TK", "TKL"),
     "tonga": ("Tonga", "TO", "TON"),
     "trinidad_and_tobago": ("TrinidadAndTobago", "TT", "TTO"),
     "tunisia": ("Tunisia", "TN", "TUN"),

holidays/utils.py

@@ -40,9 +40,9 @@ def country_holidays(
     language: Optional[str] = None,
     categories: Optional[CategoryArg] = None,
 ) -> HolidayBase:
-    """
-    Returns a new dictionary-like `HolidayBase` object for the public
-    holidays of the country matching **country** and other keyword arguments.
+    """Return a new dictionary-like [HolidayBase][holidays.holiday_base.HolidayBase] object.
+
+    Include public holidays for the country matching `country` and other keyword arguments.
 
     Args:
         country:
@@ -60,9 +60,9 @@ def country_holidays(
             is requested.
 
         observed:
-            Whether to include the dates of when public holiday are observed
+            Whether to include the dates of when public holidays are observed
             (e.g. a holiday falling on a Sunday being observed the following
-            Monday). False may not work for all countries.
+            Monday). `False` may not work for all countries.
 
         prov:
             *deprecated* use `subdiv` instead.
@@ -106,12 +106,12 @@ def country_holidays(
             Requested holiday categories.
 
     Returns:
-        A `HolidayBase` object matching the **country**.
+        A `HolidayBase` object matching the `country`.
 
     The key of the `dict`-like `HolidayBase` object is the
     `date` of the holiday, and the value is the name of the holiday itself.
     Dates where a key is not present are not public holidays (or, if
-    **observed** is False, days when a public holiday is observed).
+    `observed` is `False`, days when a public holiday is observed).
 
     When passing the `date` as a key, the `date` can be expressed in one of the
     following types:
@@ -125,12 +125,12 @@ def country_holidays(
 
     To maximize speed, the list of public holidays is built on the fly as
     needed, one calendar year at a time. When the object is instantiated
-    without a **years** parameter, it is empty, but, unless **expand** is set
-    to False, as soon as a key is accessed the class will calculate that entire
+    without a `years` parameter, it is empty, but, unless `expand` is set
+    to `False`, as soon as a key is accessed the class will calculate that entire
     year's list of holidays and set the keys with them.
 
     If you need to list the holidays as opposed to querying individual dates,
-    instantiate the class with the **years** parameter.
+    instantiate the class with the `years` parameter.
 
     Example usage:
 
@@ -236,14 +236,14 @@ def financial_holidays(
     observed: bool = True,
     language: Optional[str] = None,
 ) -> HolidayBase:
-    """
-    Returns a new dictionary-like :py:class:`HolidayBase` object for the public
-    holidays of the financial market matching **market** and other keyword
+    """Return a new dictionary-like [HolidayBase][holidays.holiday_base.HolidayBase] object.
+
+    Include public holidays for the financial market matching `market` and other keyword
     arguments.
 
     Args:
         market:
-            An ISO 3166-1 Alpha-2 market code.
+            An ISO 10383 MIC code.
 
         subdiv:
             Currently not implemented for markets (see documentation).
@@ -256,9 +256,9 @@ def financial_holidays(
             is requested.
 
         observed:
-            Whether to include the dates of when public holiday are observed
+            Whether to include the dates of when public holidays are observed
             (e.g. a holiday falling on a Sunday being observed the following
-            Monday). False may not work for all countries.
+            Monday). `False` may not work for all markets.
 
         language:
             Specifies the language in which holiday names are returned.
@@ -293,7 +293,7 @@ def financial_holidays(
             This behavior will be updated and formalized in v1.
 
     Returns:
-        A `HolidayBase` object matching the **market**.
+        A `HolidayBase` object matching the `market`.
 
     Example usage:
 
@@ -428,7 +428,7 @@ def list_supported_financial(include_aliases: bool = True) -> dict[str, list[str
 
     Args:
         include_aliases:
-            Whether to include entity aliases (e.g. TAR for ECB, XNYS for NYSE).
+            Whether to include entity aliases (e.g. NYSE for XNYS, TAR for XECB).
 
     Returns:
         A dictionary where key is a market code and value is a list of supported

holidays/version.py

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

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: holidays
-Version: 0.76
+Version: 0.78
 Summary: Open World Holidays Framework
 Author: Vacanza Team
 Maintainer: Arkadii Yakovets, Panpakorn Siripanich, Serhii Murza
@@ -142,7 +142,7 @@ and detailed information.
 
 ## Available Countries
 
-We currently support 208 country codes. The standard way to refer to a country is by using its [ISO
+We currently support 224 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
@@ -422,6 +422,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Cabo Verde</td>
+<td>CV</td>
+<td>Municipalities: BR (Brava), BV (Boa Vista), CA (Santa Catarina), CF (Santa Catarina do Fogo), CR (Santa Cruz), MA (Maio), MO (Mosteiros), PA (Paul), PN (Porto Novo), PR (Praia), RB (Ribeira Brava), RG (Ribeira Grande), RS (Ribeira Grande de Santiago), SD (São Domingos), SF (São Filipe), SL (Sal), SM (São Miguel), SO (São Lourenço dos Órgãos), SS (São Salvador do Mundo), SV (São Vicente), TA (Tarrafal), TS (Tarrafal de São Nicolau)</td>
+<td>de, en_US, es, fr, <strong>pt_CV</strong></td>
+<td>OPTIONAL</td>
+</tr>
+<tr>
 <td>Cambodia</td>
 <td>KH</td>
 <td></td>
@@ -443,6 +450,20 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>GOVERNMENT, OPTIONAL</td>
 </tr>
 <tr>
+<td>Cayman Islands</td>
+<td>KY</td>
+<td></td>
+<td><strong>en_GB</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
+<td>Central African Republic</td>
+<td>CF</td>
+<td></td>
+<td>en_US, <strong>fr</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Chad</td>
 <td>TD</td>
 <td></td>
@@ -464,6 +485,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>HALF_DAY</td>
 </tr>
 <tr>
+<td>Christmas Island</td>
+<td>CX</td>
+<td></td>
+<td><strong>en_CX</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Cocos Islands</td>
 <td>CC</td>
 <td></td>
@@ -562,6 +590,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>DR Congo</td>
+<td>CD</td>
+<td></td>
+<td>en_US, <strong>fr</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Ecuador</td>
 <td>EC</td>
 <td></td>
@@ -572,8 +607,8 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>Egypt</td>
 <td>EG</td>
 <td></td>
-<td><strong>ar</strong>, en_US</td>
-<td></td>
+<td><strong>ar_EG</strong>, en_US, fr</td>
+<td>GOVERNMENT, SCHOOL</td>
 </tr>
 <tr>
 <td>El Salvador</td>
@@ -618,6 +653,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>GOVERNMENT, WORKDAY</td>
 </tr>
 <tr>
+<td>Faroe Islands</td>
+<td>FO</td>
+<td></td>
+<td>da, en_US, <strong>fo</strong>, is, no, sv</td>
+<td>HALF_DAY</td>
+</tr>
+<tr>
 <td>Fiji</td>
 <td>FJ</td>
 <td></td>
@@ -676,7 +718,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <tr>
 <td>Germany</td>
 <td>DE</td>
-<td>Lands: BB (Brandenburg), BE (Berlin), BW (Baden-Württemberg), BY (Bayern), HB (Bremen), HE (Hessen), HH (Hamburg), MV (Mecklenburg-Vorpommern), NI (Niedersachsen), NW (Nordrhein-Westfalen), RP (Rheinland-Pfalz), SH (Schleswig-Holstein), SL (Saarland), SN (Sachsen), ST (Sachsen-Anhalt), TH (Thüringen)</td>
+<td>States: BB (Brandenburg), BE (Berlin), BW (Baden-Württemberg), BY (Bayern), HB (Bremen), HE (Hessen), HH (Hamburg), MV (Mecklenburg-Vorpommern), NI (Niedersachsen), NW (Nordrhein-Westfalen), RP (Rheinland-Pfalz), SH (Schleswig-Holstein), SL (Saarland), SN (Sachsen), ST (Sachsen-Anhalt), TH (Thüringen); cities: Augsburg</td>
 <td><strong>de</strong>, en_US, th, uk</td>
 <td>CATHOLIC</td>
 </tr>
@@ -688,6 +730,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Gibraltar</td>
+<td>GI</td>
+<td></td>
+<td><strong>en_GB</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Greece</td>
 <td>GR</td>
 <td></td>
@@ -912,6 +961,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Lebanon</td>
+<td>LB</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td>BANK, GOVERNMENT</td>
+</tr>
+<tr>
 <td>Lesotho</td>
 <td>LS</td>
 <td></td>
@@ -944,7 +1000,7 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>LU</td>
 <td></td>
 <td>de, en_US, fr, <strong>lb</strong>, uk</td>
-<td></td>
+<td>BANK</td>
 </tr>
 <tr>
 <td>Macau</td>
@@ -982,6 +1038,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Mali</td>
+<td>ML</td>
+<td></td>
+<td>en_US, <strong>fr</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Malta</td>
 <td>MT</td>
 <td></td>
@@ -1066,6 +1129,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>CATHOLIC, HEBREW, ISLAMIC, ORTHODOX, WORKDAY</td>
 </tr>
 <tr>
+<td>Montserrat</td>
+<td>MS</td>
+<td></td>
+<td><strong>en_MS</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Morocco</td>
 <td>MA</td>
 <td></td>
@@ -1143,6 +1213,20 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Niue</td>
+<td>NU</td>
+<td></td>
+<td><strong>en_NU</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
+<td>Norfolk Island</td>
+<td>NF</td>
+<td></td>
+<td><strong>en_NF</strong>, en_US</td>
+<td></td>
+</tr>
+<tr>
 <td>Northern Mariana Islands (the)</td>
 <td>MP</td>
 <td>Can also be loaded as country US, subdivision MP</td>
@@ -1185,6 +1269,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>ARMED_FORCES, HALF_DAY</td>
 </tr>
 <tr>
+<td>Palestine</td>
+<td>PS</td>
+<td></td>
+<td><strong>ar</strong>, en_US</td>
+<td>CATHOLIC, ORTHODOX</td>
+</tr>
+<tr>
 <td>Panama</td>
 <td>PA</td>
 <td></td>
@@ -1220,6 +1311,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>WORKDAY</td>
 </tr>
 <tr>
+<td>Pitcairn Islands</td>
+<td>PN</td>
+<td></td>
+<td></td>
+<td>GOVERNMENT, WORKDAY</td>
+</tr>
+<tr>
 <td>Poland</td>
 <td>PL</td>
 <td></td>
@@ -1304,6 +1402,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td></td>
 </tr>
 <tr>
+<td>Saint Vincent and the Grenadines</td>
+<td>VC</td>
+<td></td>
+<td>en_US, <strong>en_VC</strong></td>
+<td></td>
+</tr>
+<tr>
 <td>Samoa</td>
 <td>WS</td>
 <td></td>
@@ -1486,6 +1591,13 @@ any) in brackets, available languages and additional holiday categories. All cou
 <td>WORKDAY</td>
 </tr>
 <tr>
+<td>Tokelau</td>
+<td>TK</td>
+<td></td>
+<td><strong>en_TK</strong>, en_US, tkl</td>
+<td></td>
+</tr>
+<tr>
 <td>Tonga</td>
 <td>TO</td>
 <td></td>