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

holidays/countries/pitcairn_islands.py

@@ -0,0 +1,85 @@
+#  holidays
+#  --------
+#  A fast, efficient Python library for generating country, province and state
+#  specific sets of holidays on the fly. It aims to make determining whether a
+#  specific date is a holiday as fast and flexible as possible.
+#
+#  Authors: Vacanza Team and individual contributors (see CONTRIBUTORS file)
+#           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
+#           ryanss <ryanssdev@icloud.com> (c) 2014-2017
+#  Website: https://github.com/vacanza/holidays
+#  License: MIT (see LICENSE file)
+
+from holidays.constants import GOVERNMENT, PUBLIC, WORKDAY
+from holidays.groups import ChristianHolidays, InternationalHolidays
+from holidays.holiday_base import HolidayBase
+
+
+class PitcairnIslands(HolidayBase, ChristianHolidays, InternationalHolidays):
+    """Pitcairn Islands holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Pitcairn_Islands>
+        * [Public Holidays & Commemoration Days (2016)](https://web.archive.org/web/20161112174923/https://www.government.pn/policies/GPI%20-%20Approved%20Public%20Holidays%20&%20Commemoration%20Days.pdf)
+        * [Public Holidays & Commemoration Days (2024)](https://web.archive.org/web/20250517050245/https://static1.squarespace.com/static/6526ff6fef608a3828c13d05/t/6673d53b1c0e2f660cc31848/1718867262145/GPI_Policy_Public_Holidays_&_Commemoration_Days_June_2024.pdf)
+        * [The Laws of Pitcairn, Henderson, Ducie and Oeno Islands - Volume I](https://web.archive.org/web/20240418043000/https://static1.squarespace.com/static/6526ff6fef608a3828c13d05/t/65585fca2ce3972fb3bc8da3/1700290563094/Revised+Laws+of+Pitcairn,+Henderson,+Ducie+and+Oeno+Islands,+2017+Rev.+Ed.+-+Volume+1.pdf)
+        * [CIA The World Factbook](https://web.archive.org/web/20211217233431/https://www.cia.gov/the-world-factbook/countries/pitcairn-islands/)
+    """
+
+    country = "PN"
+    supported_categories = (GOVERNMENT, PUBLIC, WORKDAY)
+    # First available online source.
+    start_year = 2016
+
+    def __init__(self, *args, **kwargs):
+        ChristianHolidays.__init__(self)
+        InternationalHolidays.__init__(self)
+        super().__init__(*args, **kwargs)
+
+    def _populate_public_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day("New Year's Day")
+
+        # Bounty Day.
+        self._add_holiday_jan_23("Bounty Day")
+
+        # Good Friday.
+        self._add_good_friday("Good Friday")
+
+        # Easter Monday.
+        self._add_easter_monday("Easter Monday")
+
+        if self._year >= 2023:
+            # King's Birthday.
+            self._add_holiday_1st_mon_of_jun("King's Birthday")
+        else:
+            # Queen's Birthday.
+            self._add_holiday_2nd_sat_of_jun("Queen's Birthday")
+
+        # Pitcairn Day.
+        self._add_holiday_jul_2("Pitcairn Day")
+
+        # Christmas Day.
+        self._add_christmas_day("Christmas Day")
+
+        # Boxing Day.
+        self._add_christmas_day_two("Boxing Day")
+
+    def _populate_government_holidays(self):
+        # New Year's Day.
+        self._add_new_years_day_two("New Year's Day")
+
+    def _populate_workday_holidays(self):
+        # ANZAC Day.
+        self._add_anzac_day("ANZAC Day")
+
+        # Remembrance Day.
+        self._add_remembrance_day("Remembrance Day")
+
+
+class PN(PitcairnIslands):
+    pass
+
+
+class PCN(PitcairnIslands):
+    pass

holidays/countries/saudi_arabia.py

@@ -13,7 +13,8 @@
 from datetime import date
 from gettext import gettext as tr
 
-from holidays.calendars.gregorian import JAN, FEB, SEP, NOV, THU, FRI, SAT, _timedelta
+from holidays.calendars import _CustomIslamicHolidays
+from holidays.calendars.gregorian import SEP, NOV, THU, FRI, SAT, _timedelta
 from holidays.groups import IslamicHolidays, StaticHolidays
 from holidays.observed_holiday_base import (
     ObservedHolidayBase,
@@ -30,9 +31,10 @@ class SaudiArabia(ObservedHolidayBase, IslamicHolidays, StaticHolidays):
     """Saudi Arabia holidays.
 
     References:
-        * <https://laboreducation.hrsd.gov.sa/en/gallery/274>
+        * <https://ar.wikipedia.org/wiki/قائمة_العطل_الرسمية_في_السعودية>
         * <https://web.archive.org/web/20240610223551/http://laboreducation.hrsd.gov.sa/en/labor-education/322>
         * <https://web.archive.org/web/20250329052253/https://english.alarabiya.net/News/gulf/2022/01/27/Saudi-Arabia-to-commemorate-Founding-Day-on-Feb-22-annually-Royal-order>
+        * [2015 (1436 AH) Dhu al-Hijjah begin on September 15](https://web.archive.org/web/20250430191246/https://qna.org.qa/en/news/news-details?id=saudi-arabia-eid-aladha-to-start-on-september-24&date=14/09/2015)
     """
 
     country = "SA"
@@ -45,26 +47,29 @@ class SaudiArabia(ObservedHolidayBase, IslamicHolidays, StaticHolidays):
     observed_estimated_label = tr("%s (المقدرة، ملاحظة)")
     supported_languages = ("ar", "en_US")
 
-    def __init__(self, *args, islamic_show_estimated: bool = True, **kwargs):
-        """
+    def __init__(self, *args, islamic_show_estimated: bool = False, **kwargs):
+        """Saudi Arabia has traditionally used the Umm al-Qura calendar
+            for administrative purposes.
+
         Args:
             islamic_show_estimated:
                 Whether to add "estimated" label to Islamic holidays name
                 if holiday date is estimated.
         """
-        IslamicHolidays.__init__(self, show_estimated=islamic_show_estimated)
+        IslamicHolidays.__init__(
+            self, cls=SaudiArabiaIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, SaudiArabiaStaticHolidays)
         kwargs.setdefault("observed_rule", FRI_TO_PREV_THU + SAT_TO_NEXT_SUN)
         super().__init__(*args, **kwargs)
 
-    def _add_islamic_observed(self, dts: set[date]) -> None:
+    def _add_islamic_observed(self, dt: date) -> None:
         # Observed days are added to make up for any days falling on a weekend.
         if not self.observed:
             return None
         observed_rule = THU_FRI_TO_NEXT_WORKDAY if self._year <= 2012 else FRI_SAT_TO_NEXT_WORKDAY
-        for dt in dts:
-            for i in range(4):
-                self._add_observed(_timedelta(dt, -i), name=self[dt], rule=observed_rule)
+        for i in range(4):
+            self._add_observed(_timedelta(dt, -i), name=self[dt], rule=observed_rule)
 
     def _populate_public_holidays(self):
         # Weekend used to be THU, FRI before June 28th, 2013.
@@ -77,36 +82,38 @@ class SaudiArabia(ObservedHolidayBase, IslamicHolidays, StaticHolidays):
         )
         self.weekend = {THU, FRI} if self._year <= 2012 else {FRI, SAT}
 
-        # Eid al-Fitr Holiday
+        # Eid al-Fitr Holiday.
         eid_al_fitr_name = tr("عطلة عيد الفطر")
-        self._add_eid_al_fitr_day(eid_al_fitr_name)
+        eid_al_fitr_dates = self._add_eid_al_fitr_day(eid_al_fitr_name)
         self._add_eid_al_fitr_day_two(eid_al_fitr_name)
         self._add_eid_al_fitr_day_three(eid_al_fitr_name)
-        self._add_islamic_observed(self._add_eid_al_fitr_day_four(eid_al_fitr_name))
 
-        # Arafat Day
+        for dt in eid_al_fitr_dates:
+            if self._islamic_calendar._is_long_ramadan(dt):
+                # Add 30 Ramadan.
+                self._add_holiday(eid_al_fitr_name, _timedelta(dt, -1))
+                self._add_islamic_observed(_timedelta(dt, +2))
+            else:
+                # Add 4 Shawwal.
+                self._add_islamic_observed(self._add_holiday(eid_al_fitr_name, _timedelta(dt, +3)))
+
+        # Arafat Day.
         self._add_arafah_day(tr("يوم عرفة"))
-        # Eid al-Adha Holiday
+
+        # Eid al-Adha Holiday.
         name = tr("عطلة عيد الأضحى")
         self._add_eid_al_adha_day(name)
         self._add_eid_al_adha_day_two(name)
-        self._add_islamic_observed(self._add_eid_al_adha_day_three(name))
-
-        # If National Day happens within the Eid al-Fitr Holiday or
-        # Eid al-Adha Holiday, there is no extra holidays given for it.
-        if self._year >= 2005:
-            dt = date(self._year, SEP, 23)
-            if dt not in self:
-                # National Day Holiday
-                self._add_observed(self._add_holiday(tr("اليوم الوطني"), dt))
+        for dt in self._add_eid_al_adha_day_three(name):
+            self._add_islamic_observed(dt)
 
-        # If Founding Day happens within the Eid al-Fitr Holiday or
-        # Eid al-Adha Holiday, there is no extra holidays given for it.
         if self._year >= 2022:
-            dt = date(self._year, FEB, 22)
-            if dt not in self:
-                # Founding Day
-                self._add_observed(self._add_holiday(tr("يوم التأسيسي"), dt))
+            # Founding Day.
+            self._add_observed(self._add_holiday_feb_22(tr("يوم التأسيسي")))
+
+        if self._year >= 2005:
+            # National Day.
+            self._add_observed(self._add_holiday_sep_23(tr("اليوم الوطني")))
 
 
 class SA(SaudiArabia):
@@ -117,13 +124,14 @@ class SAU(SaudiArabia):
     pass
 
 
+class SaudiArabiaIslamicHolidays(_CustomIslamicHolidays):
+    EID_AL_ADHA_DATES = {
+        2015: (SEP, 24),
+    }
+
+
 class SaudiArabiaStaticHolidays:
     special_public_holidays = {
-        # Celebrate the country's win against Argentina in the World Cup
+        # Celebrate the country's win against Argentina in the World Cup.
         2022: (NOV, 23, tr("يوم وطني")),
     }
-
-    special_public_holidays_observed = {
-        # Eid al-Fitr Holiday
-        2001: (JAN, 1, tr("عطلة عيد الفطر")),
-    }

holidays/groups/islamic.py

@@ -182,16 +182,6 @@ class IslamicHolidays(EasternCalendarHolidays):
             name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+2
         )
 
-    def _add_eid_al_fitr_day_four(self, name) -> set[date]:
-        """
-        Add Eid al-Fitr Day Four.
-
-        https://en.wikipedia.org/wiki/Eid_al-Fitr
-        """
-        return self._add_islamic_calendar_holiday(
-            name, self._islamic_calendar.eid_al_fitr_dates(self._year), days_delta=+3
-        )
-
     def _add_eid_al_fitr_eve(self, name) -> set[date]:
         """
         Add Eid al-Fitr Eve (last day of 9th month of Islamic calendar).

holidays/holiday_base.py

@@ -55,57 +55,32 @@ YearArg = Union[int, Iterable[int]]
 
 
 class HolidayBase(dict[date, str]):
-    """
-    A `dict`-like object containing the holidays for a specific country (and
-    province or state if so initiated); inherits the `dict` class (so behaves
-    similarly to a `dict`). Dates without a key in the Holiday object are not
-    holidays.
-
-    The key of the object is the date of the holiday and the value is the name
-    of the holiday itself. When passing the date as a key, the date can be
-    expressed as one of the following formats:
-
-    * `datetime.datetime` type;
-    * `datetime.date` types;
-    * a `float` representing a Unix timestamp;
-    * or a string of any format (recognized by `dateutil.parser.parse()`).
-
-    The key is always returned as a `datetime.date` object.
-
-    To maximize speed, the list of holidays is built as needed on the fly, one
-    calendar year at a time. When you instantiate the object, it is empty, but
-    the moment a key is accessed it will build that entire year's list of
-    holidays. To pre-populate holidays, instantiate the class with the years
-    argument:
-
-        us_holidays = holidays.US(years=2020)
+    """Represent a dictionary-like collection of holidays for a specific country or region.
 
-    It is generally instantiated using the
-    [country_holidays()][holidays.utils.country_holidays] function.
+    This class inherits from `dict` and maps holiday dates to their names. It supports
+    customization by country and, optionally, by province or state (subdivision). A date
+    not present as a key is not considered a holiday (or, if `observed` is `False`, not
+    considered an observed holiday).
 
-    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).
+    Keys are holiday dates, and values are corresponding holiday names. When accessing or
+    assigning holidays by date, the following input formats are accepted:
 
-    When passing the `date` as a key, the `date` can be expressed in one of the
-    following types:
+    * `datetime.date`
+    * `datetime.datetime`
+    * `float` or `int` (Unix timestamp)
+    * `str` of any format recognized by `dateutil.parser.parse()`
 
-    * `datetime.date`,
-    * `datetime.datetime`,
-    * a `str` of any format recognized by `dateutil.parser.parse()`,
-    * or a `float` or `int` representing a POSIX timestamp.
+    Keys are always returned as `datetime.date` objects.
 
-    The key is always returned as a `datetime.date` object.
+    To maximize performance, the holiday list is lazily populated one year at a time.
+    On instantiation, the object is empty. Once a date is accessed, the full calendar
+    year for that date is generated, unless `expand` is set to `False`. To pre-populate
+    holidays, instantiate the class with the `years` argument:
 
-    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
-    year's list of holidays and set the keys with them.
+        us_holidays = holidays.US(years=2020)
 
-    If you need to list the holidays as opposed to querying individual dates,
-    instantiate the class with the **years** parameter.
+    It is recommended to use the
+    [country_holidays()][holidays.utils.country_holidays] function for instantiation.
 
     Example usage:
 
@@ -163,14 +138,13 @@ class HolidayBase(dict[date, str]):
         >>> assert '2018-01-06' not in us_holidays
         >>> assert '2018-01-06' in us_pr_holidays
 
-    Append custom holiday dates by passing one of:
+    Append custom holiday dates by passing one of the following:
 
-    * a `dict` with date/name key/value pairs (e.g.
-      `{'2010-07-10': 'My birthday!'}`),
-    * a list of dates (as a `datetime.date`, `datetime.datetime`,
-      `str`, `int`, or `float`); `'Holiday'` will be used as a description,
-    * or a single date item (of one of the types above); `'Holiday'` will be
-      used as a description:
+    * A dict mapping date values to holiday names (e.g. `{'2010-07-10': 'My birthday!'}`).
+    * A list of date values (`datetime.date`, `datetime.datetime`, `str`, `int`, or `float`);
+      each will be added with 'Holiday' as the default name.
+    * A single date value of any of the supported types above; 'Holiday' will be used as
+      the default name.
 
     ```python
     >>> custom_holidays = country_holidays('US', years=2015)
@@ -325,7 +299,7 @@ class HolidayBase(dict[date, str]):
                 Requested holiday categories.
 
         Returns:
-            A `HolidayBase` object matching the **country** or **market**.
+            A `HolidayBase` object matching the `country` or `market`.
         """
         super().__init__()
 
@@ -436,10 +410,10 @@ class HolidayBase(dict[date, str]):
 
         The method supports the following input types:
 
-        * `datetime.date`,
-        * `datetime.datetime`,
-        * a `str` of any format recognized by `dateutil.parser.parse()`,
-        * or a `float` or `int` representing a POSIX timestamp.
+        * `datetime.date`
+        * `datetime.datetime`
+        * `float` or `int` (Unix timestamp)
+        * `str` of any format recognized by `dateutil.parser.parse()`
 
         Args:
             key:
@@ -617,10 +591,11 @@ class HolidayBase(dict[date, str]):
         """Convert various date-like formats to `datetime.date`.
 
         The method supports the following input types:
-        * `datetime.date`,
-        * `datetime.datetime`,
-        * a `str` of any format recognized by `dateutil.parser.parse()`,
-        * or a `float` or `int` representing a POSIX timestamp
+
+        * `datetime.date`
+        * `datetime.datetime`
+        * `float` or `int` (Unix timestamp)
+        * `str` of any format recognized by `dateutil.parser.parse()`
 
         Args:
             key:
@@ -816,9 +791,7 @@ class HolidayBase(dict[date, str]):
             self.tr = gettext
 
     def _is_leap_year(self) -> bool:
-        """
-        Returns True if the year is leap. Returns False otherwise.
-        """
+        """Returns True if the year is leap. Returns False otherwise."""
         return isleap(self._year)
 
     def _add_holiday(self, name: str, *args) -> Optional[date]:
@@ -899,12 +872,13 @@ class HolidayBase(dict[date, str]):
         return dt.weekday() in self.weekend
 
     def _populate(self, year: int) -> None:
-        """This is a private class that populates (generates and adds) holidays
+        """This is a private method that populates (generates and adds) holidays
         for a given year. To keep things fast, it assumes that no holidays for
         the year have already been populated. It is required to be called
-        internally by any country populate() method, while should not be called
+        internally by any country `populate()` method, while should not be called
         directly from outside.
-        To add holidays to an object, use the update() method.
+        To add holidays to an object, use the [update()][holidays.holiday_base.HolidayBase.update]
+        method.
 
         Args:
             year: The year to populate with holidays.
@@ -980,10 +954,10 @@ class HolidayBase(dict[date, str]):
             key:
                 The date expressed in one of the following types:
 
-                * `datetime.date`,
-                * `datetime.datetime`,
-                * a `str` of any format recognized by `dateutil.parser.parse()`,
-                * or a `float` or `int` representing a POSIX timestamp.
+                * `datetime.date`
+                * `datetime.datetime`
+                * `float` or `int` (Unix timestamp)
+                * `str` of any format recognized by `dateutil.parser.parse()`
 
             default:
                 The default value to return if no value is found.
@@ -1001,10 +975,10 @@ class HolidayBase(dict[date, str]):
             key:
                 The date expressed in one of the following types:
 
-                * `datetime.date`,
-                * `datetime.datetime`,
-                * a `str` of any format recognized by `dateutil.parser.parse()`,
-                * or a `float` or `int` representing a POSIX timestamp.
+                * `datetime.date`
+                * `datetime.datetime`
+                * `float` or `int` (Unix timestamp)
+                * `str` of any format recognized by `dateutil.parser.parse()`
 
         Returns:
             A list of holiday names if the date is a holiday, otherwise an empty list.
@@ -1116,6 +1090,7 @@ class HolidayBase(dict[date, str]):
         """Find the n-th working day from a given date.
 
         Moves forward if n is positive, or backward if n is negative.
+        If n is 0, returns the given date if it is a working day; otherwise the next working day.
 
         Args:
             key:
@@ -1128,10 +1103,11 @@ class HolidayBase(dict[date, str]):
         Returns:
             The calculated working day after shifting by n working days.
         """
-        direction = +1 if n > 0 else -1
+        direction = +1 if n >= 0 else -1
         dt = self.__keytransform__(key)
-        for _ in range(abs(n)):
-            dt = _timedelta(dt, direction)
+        for _ in range(abs(n) or 1):
+            if n:
+                dt = _timedelta(dt, direction)
             while not self.is_working_day(dt):
                 dt = _timedelta(dt, direction)
         return dt
@@ -1183,10 +1159,10 @@ class HolidayBase(dict[date, str]):
             key:
                 The date expressed in one of the following types:
 
-                * `datetime.date`,
-                * `datetime.datetime`,
-                * a `str` of any format recognized by `dateutil.parser.parse()`,
-                * or a `float` or `int` representing a POSIX timestamp.
+                * `datetime.date`
+                * `datetime.datetime`
+                * `float` or `int` (Unix timestamp)
+                * `str` of any format recognized by `dateutil.parser.parse()`
 
             default:
                 The default value to return if no match is found.
@@ -1290,10 +1266,10 @@ class HolidayBase(dict[date, str]):
 
                 Dates can be expressed in one or more of the following types:
 
-                * `datetime.date`,
-                * `datetime.datetime`,
-                * a `str` of any format recognized by `dateutil.parser.parse()`,
-                * or a `float` or `int` representing a POSIX timestamp.
+                * `datetime.date`
+                * `datetime.datetime`
+                * `float` or `int` (Unix timestamp)
+                * `str` of any format recognized by `dateutil.parser.parse()`
         """
         for arg in args:
             if isinstance(arg, dict):
@@ -1308,12 +1284,17 @@ class HolidayBase(dict[date, str]):
 
 class HolidaySum(HolidayBase):
     """
-    Returns a `dict`-like object resulting from the addition of two or
-    more individual dictionaries of public holidays. The original dictionaries
-    are available as a `list` in the attribute `holidays,` and
-    `country` and `subdiv` attributes are added
-    together and could become `list` s. Holiday names, when different,
-    are merged. All years are calculated (expanded) for all operands.
+    Combine multiple holiday collections into a single dictionary-like object.
+
+    This class represents the sum of two or more `HolidayBase` instances.
+    The resulting object behaves like a dictionary mapping dates to holiday
+    names, with the following behaviors:
+
+    * The `holidays` attribute stores the original holiday collections as a list.
+    * The `country` and `subdiv` attributes are combined from all operands and
+      may become lists.
+    * If multiple holidays fall on the same date, their names are merged.
+    * Holidays are generated (expanded) for all years included in the operands.
     """
 
     country: Union[str, list[str]]  # type: ignore[assignment]

holidays/registry.py

@@ -181,6 +181,7 @@ COUNTRIES: RegistryDict = {
     "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"),

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