holidays 0.68__py3-none-any.whl → 0.70__py3-none-any.whl

holidays/countries/united_states.py

@@ -4,7 +4,7 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -13,7 +13,7 @@
 from typing import Union
 
 from holidays.calendars.gregorian import MON, TUE, WED, THU, FRI, SAT, SUN
-from holidays.constants import PUBLIC, UNOFFICIAL
+from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
 from holidays.groups import ChristianHolidays, InternationalHolidays
 from holidays.observed_holiday_base import (
     ObservedHolidayBase,
@@ -32,60 +32,59 @@ GA_IN_WASHINGTON_BIRTHDAY = ObservedRule(
 
 
 class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    https://en.wikipedia.org/wiki/Public_holidays_in_the_United_States
-
-    For Northern Mariana Islands (subdivision MP):
-    - https://governor.gov.mp/archived-news/executive-actions-archive/memorandum-2022-legal-holidays/
-    - https://webcache.googleusercontent.com/search?q=cache:C17_7FBgPtQJ:https://governor.gov.mp/archived-news/executive-actions-archive/memorandum-2022-legal-holidays/&hl=en&gl=sg&strip=1&vwsrc=0
-
-    Columbus Day / Indigenous Peoples' Day history:
-    - https://www.pewresearch.org/short-reads/2023/10/05/working-on-columbus-day-or-indigenous-peoples-day-it-depends-on-where-your-job-is/
-    - https://www.officeholidays.com/holidays/usa/columbus-day-state-guide
-    - https://en.wikipedia.org/wiki/Indigenous_Peoples%27_Day_(United_States)
-    - https://www.sos.ri.gov/divisions/civics-and-education/reference-desk/ri-state-holidays
-    - https://web.archive.org/web/20080831103521/http://www.dpa.ca.gov/personnel-policies/holidays.htm
-
-    Frances Xavier Cabrini Day:
-        - https://leg.colorado.gov/sites/default/files/2020a_1031_signed.pdf
-
-    Washington's Birthday:
-        - AK: https://doa.alaska.gov/calendar/
-        - AL: https://admincode.legislature.state.al.us/administrative-code/670-X-12-.01
-        - AR: https://arkleg.state.ar.us/Home/FTPDocument?path=/ACTS/2001/Public/ACT304.pdf
-        - AZ: https://www.azleg.gov/ars/1/00301.htm
-        - CA: https://www.sos.ca.gov/state-holidays
-        - CO: https://leg.colorado.gov/sites/default/files/images/olls/crs2023-title-24.pdf
-        - GA: https://www.gasupreme.us/court-information/holidays-2/
-        - HI: https://www.capitol.hawaii.gov/hrscurrent/Vol01_Ch0001-0042F/HRS0008/HRS_0008-0001.htm
-        - ID: https://idaho.gov/government/state-holidays/
-        - IN: https://digital.statelib.lib.in.us/infoexpress/holidays.aspx
-              https://www.in.gov/spd/benefits/state-holidays/
-        - MD: https://msa.maryland.gov/msa/mdmanual/01glance/html/holidayl.html
-        - MN: https://www.revisor.mn.gov/statutes/cite/645.44
-        - MT: https://archive.legmt.gov/bills/mca/title_0010/chapter_0010/part_0020/section_0160/0010-0010-0020-0160.html
-        - NJ: https://nj.gov/nj/about/facts/holidays/
-        - OH: https://codes.ohio.gov/ohio-revised-code/section-1.14
-        - OK: https://oklahoma.gov/omes/divisions/human-capital-management/employee-benefits/leave-holidays/holidays.html
-        - OR: https://www.oregonlegislature.gov/bills_laws/ors/ors187.html
-        - PA: https://www.legis.state.pa.us/WU01/LI/LI/US/PDF/1893/0/0138..PDF
-        - PR: https://en.wikipedia.org/wiki/Public_holidays_in_Puerto_Rico
-        - SC: https://www.scstatehouse.gov/code/t53c005.php
-        - TN: https://www.tn.gov/about-tn/state-holidays.html
-        - TX: https://www.tsl.texas.gov/ref/abouttx/holidays
-        - UT: https://le.utah.gov/xcode/Title63G/Chapter1/63G-1-S301.html
-        - VA: https://law.lis.virginia.gov/vacode/title2.2/chapter33/section2.2-3300/
-        - VT: https://legislature.vermont.gov/statutes/section/01/007/00371
-        - WA: https://app.leg.wa.gov/rcw/default.aspx?cite=1.16.050
-        - WV: https://code.wvlegislature.gov/2-2-1/
-        - WY: https://ai.wyo.gov/about-us/state-holidays-and-office-closures
-
-    American Samoa holidays:
-        - https://asbar.org/code-annotated/1-0501-public-holidays/
+    """United States of America (the) holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_the_United_States>
+        * [Federal holidays](https://www.opm.gov/policy-data-oversight/pay-leave/federal-holidays/)
+        * Washington's Birthday:
+            * [AK](https://doa.alaska.gov/calendar/)
+            * [AL](https://admincode.legislature.state.al.us/administrative-code/670-X-12-.01)
+            * [AR](https://arkleg.state.ar.us/Home/FTPDocument?path=/ACTS/2001/Public/ACT304.pdf)
+            * [AZ](https://www.azleg.gov/ars/1/00301.htm)
+            * [CA](https://www.sos.ca.gov/state-holidays)
+            * [CO](https://leg.colorado.gov/sites/default/files/images/olls/crs2023-title-24.pdf)
+            * [GA](https://www.gasupreme.us/court-information/holidays-2/)
+            * [HI](https://www.capitol.hawaii.gov/hrscurrent/Vol01_Ch0001-0042F/HRS0008/HRS_0008-0001.htm)
+            * [ID](https://idaho.gov/government/state-holidays/)
+            * IN:
+                * <https://digital.statelib.lib.in.us/infoexpress/holidays.aspx>
+                * <https://www.in.gov/spd/benefits/state-holidays/>
+            * [MD](https://msa.maryland.gov/msa/mdmanual/01glance/html/holidayl.html)
+            * [MI](https://www.michigan.gov/som/government/state-holidays)
+            * [MN](https://www.revisor.mn.gov/statutes/cite/645.44)
+            * [MT](https://archive.legmt.gov/bills/mca/title_0010/chapter_0010/part_0020/section_0160/0010-0010-0020-0160.html)
+            * [NJ](https://nj.gov/nj/about/facts/holidays/)
+            * [OH](https://codes.ohio.gov/ohio-revised-code/section-1.14)
+            * [OK](https://oklahoma.gov/omes/divisions/human-capital-management/employee-benefits/leave-holidays/holidays.html)
+            * [OR](https://www.oregonlegislature.gov/bills_laws/ors/ors187.html)
+            * [PA](https://www.legis.state.pa.us/WU01/LI/LI/US/PDF/1893/0/0138..PDF)
+            * [PR](https://en.wikipedia.org/wiki/Public_holidays_in_Puerto_Rico)
+            * [SC](https://www.scstatehouse.gov/code/t53c005.php)
+            * [TN](https://www.tn.gov/about-tn/state-holidays.html)
+            * [TX](https://www.tsl.texas.gov/ref/abouttx/holidays)
+            * [UT](https://le.utah.gov/xcode/Title63G/Chapter1/63G-1-S301.html)
+            * [VA](https://law.lis.virginia.gov/vacode/title2.2/chapter33/section2.2-3300/)
+            * [VT](https://legislature.vermont.gov/statutes/section/01/007/00371)
+            * [WA](https://app.leg.wa.gov/rcw/default.aspx?cite=1.16.050)
+            * [WV](https://code.wvlegislature.gov/2-2-1/)
+            * [WY](https://ai.wyo.gov/about-us/state-holidays-and-office-closures)
+        * Columbus Day / Indigenous Peoples' Day history:
+            * <https://www.pewresearch.org/short-reads/2023/10/05/working-on-columbus-day-or-indigenous-peoples-day-it-depends-on-where-your-job-is/>
+            * <https://www.officeholidays.com/holidays/usa/columbus-day-state-guide>
+            * <https://en.wikipedia.org/wiki/Indigenous_Peoples%27_Day_(United_States)>
+            * <https://www.sos.ri.gov/divisions/civics-and-education/reference-desk/ri-state-holidays>
+            * <https://web.archive.org/web/20080831103521/http://www.dpa.ca.gov/personnel-policies/holidays.htm>
+        * [Frances Xavier Cabrini Day](https://leg.colorado.gov/sites/default/files/2020a_1031_signed.pdf)
+        * Northern Mariana Islands (subdivision MP):
+            * <https://governor.gov.mp/archived-news/executive-actions-archive/memorandum-2022-legal-holidays/>
+            * <https://webcache.googleusercontent.com/search?q=cache:C17_7FBgPtQJ:https://governor.gov.mp/archived-news/executive-actions-archive/memorandum-2022-legal-holidays/&hl=en&gl=sg&strip=1&vwsrc=0>
+        * American Samoa:
+            * <https://asbar.org/code-annotated/1-0501-public-holidays/>
     """
 
     country = "US"
-    supported_categories = (PUBLIC, UNOFFICIAL)
+    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
     observed_label = "%s (observed)"
     subdivisions: Union[tuple[()], tuple[str, ...]] = (
         "AK",  # Alaska.
@@ -160,20 +159,35 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         kwargs.setdefault("observed_rule", SAT_TO_PREV_FRI + SUN_TO_NEXT_MON)
         super().__init__(*args, **kwargs)
 
-    def _populate_public_holidays(self):
+    def _populate_common(self, include_federal: bool = False):
+        """
+        Populates common US holidays.
+
+        :param include_federal:
+            Whether to include federal-specific holidays.
+        """
         # New Year's Day
         if self._year >= 1871:
             name = "New Year's Day"
             self._add_observed(self._add_new_years_day(name))
             self._add_observed(self._next_year_new_years_day, name=name)
 
+        if include_federal:
+            # Birthday of Martin Luther King, Jr.
+            if self._year >= 1986:
+                self._add_holiday_3rd_mon_of_jan("Birthday of Martin Luther King, Jr.")
+
+            # Washington's Birthday
+            if self._year >= 1879:
+                name = "Washington's Birthday"
+                if self._year >= 1971:
+                    self._add_holiday_3rd_mon_of_feb(name)
+                else:
+                    self._add_holiday_feb_22(name)
+
         # Memorial Day
-        if self._year >= 1888:
-            name = "Memorial Day"
-            if self._year >= 1971:
-                self._add_holiday_last_mon_of_may(name)
-            else:
-                self._add_holiday_may_30(name)
+        if self._year >= 1971:
+            self._add_holiday_last_mon_of_may("Memorial Day")
 
         # Juneteenth Day
         if self._year >= 2021:
@@ -187,6 +201,11 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         if self._year >= 1894:
             self._add_holiday_1st_mon_of_sep("Labor Day")
 
+        if include_federal:
+            # Columbus Day
+            if self._year >= 1971:
+                self._add_holiday_2nd_mon_of_oct("Columbus Day")
+
         # Veterans Day
         if self._year >= 1938:
             name = "Veterans Day" if self._year >= 1954 else "Armistice Day"
@@ -195,14 +214,21 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             else:
                 self._add_observed(self._add_remembrance_day(name))
 
-        # Thanksgiving
+        # Thanksgiving Day
         if self._year >= 1871:
-            self._add_holiday_4th_thu_of_nov("Thanksgiving")
+            self._add_holiday_4th_thu_of_nov("Thanksgiving Day")
 
         # Christmas Day
         if self._year >= 1871:
             self._add_observed(self._add_christmas_day("Christmas Day"))
 
+    def _populate_public_holidays(self):
+        self._populate_common()
+
+        # Memorial Day
+        if 1888 <= self._year <= 1970:
+            self._add_holiday_may_30("Memorial Day")
+
     def _add_christmas_eve_holiday(self):
         # Christmas Eve
         # If on Friday, observed on Thursday
@@ -324,11 +350,12 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_holiday_3rd_mon_of_jan("Martin Luther King, Jr & Robert E. Lee's Birthday")
 
         # Washington's Birthday
-        name = "George Washington & Thomas Jefferson's Birthday"
-        if self._year >= 1971:
-            self._add_holiday_3rd_mon_of_feb(name)
-        else:
-            self._add_holiday_feb_22(name)
+        if self._year >= 1879:
+            name = "George Washington & Thomas Jefferson's Birthday"
+            if self._year >= 1971:
+                self._add_holiday_3rd_mon_of_feb(name)
+            else:
+                self._add_holiday_feb_22(name)
 
         # Confederate Memorial Day
         if self._year >= 1866:
@@ -356,11 +383,12 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             )
 
         # Washington's Birthday
-        name = "George Washington's Birthday and Daisy Gatson Bates Day"
-        if self._year >= 1971:
-            self._add_holiday_3rd_mon_of_feb(name)
-        else:
-            self._add_holiday_feb_22(name)
+        if self._year >= 1879:
+            name = "George Washington's Birthday and Daisy Gatson Bates Day"
+            if self._year >= 1971:
+                self._add_holiday_3rd_mon_of_feb(name)
+            else:
+                self._add_holiday_feb_22(name)
 
     def _populate_subdiv_as_public_holidays(self):
         # American Samoa Flag Day
@@ -493,10 +521,11 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             )
 
         # Washington's Birthday
-        self._add_holiday(
-            "Washington's Birthday",
-            self._get_observed_date(self._christmas_day, rule=GA_IN_WASHINGTON_BIRTHDAY),
-        )
+        if self._year >= 1879:
+            self._add_holiday(
+                "Washington's Birthday",
+                self._get_observed_date(self._christmas_day, rule=GA_IN_WASHINGTON_BIRTHDAY),
+            )
 
     def _populate_subdiv_gu_public_holidays(self):
         # Guam Discovery Day
@@ -587,10 +616,11 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             self._add_holiday_1_day_past_4th_thu_of_nov("Lincoln's Birthday")
 
         # Washington's Birthday
-        self._add_holiday(
-            "Washington's Birthday",
-            self._get_observed_date(self._christmas_day, rule=GA_IN_WASHINGTON_BIRTHDAY),
-        )
+        if self._year >= 1879:
+            self._add_holiday(
+                "Washington's Birthday",
+                self._get_observed_date(self._christmas_day, rule=GA_IN_WASHINGTON_BIRTHDAY),
+            )
 
     def _populate_subdiv_ks_public_holidays(self):
         # Christmas Eve
@@ -684,6 +714,14 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
             # New Year's Eve
             self._add_observed(self._add_new_years_eve("New Year's Eve"))
 
+        # Election Day
+        if self._year >= 2008 and self._year % 2 == 0:
+            self._add_holiday_1_day_past_1st_mon_of_nov("Election Day")
+
+        # Day after Thanksgiving
+        if self._year >= 2017:
+            self._add_holiday_1_day_past_4th_thu_of_nov("Day After Thanksgiving")
+
     def _populate_subdiv_mn_public_holidays(self):
         # Washington's Birthday
         if self._year >= 1971:
@@ -872,7 +910,8 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         self._add_epiphany_day("Epiphany")
 
         # Washington's Birthday
-        self._add_holiday_3rd_mon_of_feb("Presidents' Day")
+        if self._year >= 1971:
+            self._add_holiday_3rd_mon_of_feb("Presidents' Day")
 
         # Emancipation Day
         self._add_observed(self._add_holiday_mar_22("Emancipation Day"), rule=SUN_TO_NEXT_MON)
@@ -1015,11 +1054,12 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         self._add_epiphany_day("Three Kings Day")
 
         # Washington's Birthday
-        name = "Presidents' Day"
-        if self._year >= 1971:
-            self._add_holiday_3rd_mon_of_feb(name)
-        else:
-            self._add_holiday_feb_22(name)
+        if self._year >= 1879:
+            name = "Presidents' Day"
+            if self._year >= 1971:
+                self._add_holiday_3rd_mon_of_feb(name)
+            else:
+                self._add_holiday_feb_22(name)
 
         # Transfer Day
         self._add_holiday_mar_31("Transfer Day")
@@ -1102,6 +1142,10 @@ class UnitedStates(ObservedHolidayBase, ChristianHolidays, InternationalHolidays
         if self._year >= 1971:
             self._add_holiday_3rd_mon_of_feb("President's Day")
 
+    def _populate_government_holidays(self):
+        # Federal holidays in the United States.
+        self._populate_common(include_federal=True)
+
     def _populate_unofficial_holidays(self):
         # Very common celebrated cultural days, but no official observance.
         # Due to its nature, no in-lieus are observed.

holidays/countries/united_states_minor_outlying_islands.py

@@ -4,29 +4,35 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md 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 PUBLIC, UNOFFICIAL
+from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
 class HolidaysUM(US):
-    # Alias of a US subdivision that is also officially assigned its own
-    # country code in ISO 3166-1.  See
-    # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
+    """United States Minor Outlying Islands holidays.
+
+    Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
+    See <https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1>
+    """
 
     country = "UM"
-    supported_categories = (PUBLIC, UNOFFICIAL)
+    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "UM"
         super()._populate_public_holidays()
 
+    def _populate_government_holidays(self) -> None:
+        self.subdiv = "UM"
+        super()._populate_government_holidays()
+
     def _populate_unofficial_holidays(self) -> None:
         self.subdiv = "UM"
         super()._populate_unofficial_holidays()

holidays/countries/united_states_virgin_islands.py

@@ -4,29 +4,35 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md 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 PUBLIC, UNOFFICIAL
+from holidays.constants import GOVERNMENT, PUBLIC, UNOFFICIAL
 from holidays.countries.united_states import US
 
 
 class HolidaysVI(US):
-    # Alias of a US subdivision that is also officially assigned its own
-    # country code in ISO 3166-1.  See
-    # https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1
+    """United States Virgin Islands (the) holidays.
+
+    Alias of a US subdivision that is also officially assigned its own country code in ISO 3166-1.
+    See <https://en.wikipedia.org/wiki/ISO_3166-2:US#Subdivisions_included_in_ISO_3166-1>
+    """
 
     country = "VI"
-    supported_categories = (PUBLIC, UNOFFICIAL)
+    supported_categories = (GOVERNMENT, PUBLIC, UNOFFICIAL)
     subdivisions = ()  # Override US subdivisions.
 
     def _populate_public_holidays(self) -> None:
         self.subdiv = "VI"
         super()._populate_public_holidays()
 
+    def _populate_government_holidays(self) -> None:
+        self.subdiv = "VI"
+        super()._populate_government_holidays()
+
     def _populate_unofficial_holidays(self) -> None:
         self.subdiv = "VI"
         super()._populate_unofficial_holidays()

holidays/countries/uruguay.py

@@ -4,7 +4,7 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -24,15 +24,16 @@ from holidays.observed_holiday_base import (
 
 
 class Uruguay(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
-    """
+    """Uruguay holidays.
+
     References:
-    - https://en.wikipedia.org/wiki/Public_holidays_in_Uruguay
-    - [Law #6997] https://www.impo.com.uy/diariooficial/1919/10/25/2
-    - [Decree Law #9000] https://www.impo.com.uy/bases/decretos-ley/9000-1933
-    - [Decree Law #14977] https://www.impo.com.uy/bases/decretos-ley/14977-1979
-    - [Decree Law #15535] https://www.impo.com.uy/bases/decretos-ley/15535-1984
-    - [Law #16805] http://www.parlamento.gub.uy/leyes/AccesoTextoLey.asp?Ley=16805
-    - [Law #17414] http://www.parlamento.gub.uy/leyes/AccesoTextoLey.asp?Ley=17414
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Uruguay>
+        * [Law #6997](https://www.impo.com.uy/diariooficial/1919/10/25/2)
+        * [Decree Law #9000](https://www.impo.com.uy/bases/decretos-ley/9000-1933)
+        * [Decree Law #14977](https://www.impo.com.uy/bases/decretos-ley/14977-1979)
+        * [Decree Law #15535](https://www.impo.com.uy/bases/decretos-ley/15535-1984)
+        * [Law #16805](http://www.parlamento.gub.uy/leyes/AccesoTextoLey.asp?Ley=16805)
+        * [Law #17414](http://www.parlamento.gub.uy/leyes/AccesoTextoLey.asp?Ley=17414)
     """
 
     country = "UY"

holidays/countries/uzbekistan.py

@@ -4,7 +4,7 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -20,11 +20,12 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SAT_SUN_TO_NEXT_
 
 
 class Uzbekistan(ObservedHolidayBase, InternationalHolidays, IslamicHolidays, StaticHolidays):
-    """
+    """Uzbekistan holidays.
+
     References:
-        - https://en.wikipedia.org/wiki/Public_holidays_in_Uzbekistan
-        - `Labor Code 21.12.1995 <https://lex.uz/docs/-142859>`_
-        - `Labor Code 28.10.2022 <https://lex.uz/docs/-6257288>`_
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Uzbekistan>
+        * [Labor Code 21.12.1995](https://lex.uz/docs/-142859)
+        * [Labor Code 28.10.2022](https://lex.uz/docs/-6257288)
     """
 
     country = "UZ"
@@ -38,9 +39,17 @@ class Uzbekistan(ObservedHolidayBase, InternationalHolidays, IslamicHolidays, St
     supported_languages = ("en_US", "uk", "uz")
     start_year = 1992
 
-    def __init__(self, *args, **kwargs):
+    def __init__(self, islamic_show_estimated: bool = True, *args, **kwargs):
+        """
+        Args:
+            islamic_show_estimated:
+                Whether to add "estimated" label to Islamic holidays name
+                if holiday date is estimated.
+        """
         InternationalHolidays.__init__(self)
-        IslamicHolidays.__init__(self, UzbekistanIslamicHolidays)
+        IslamicHolidays.__init__(
+            self, cls=UzbekistanIslamicHolidays, show_estimated=islamic_show_estimated
+        )
         StaticHolidays.__init__(self, UzbekistanStaticHolidays)
         kwargs.setdefault("observed_rule", SAT_SUN_TO_NEXT_WORKDAY)
         super().__init__(*args, **kwargs)

holidays/countries/vanuatu.py

@@ -4,7 +4,7 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -16,10 +16,12 @@ from holidays.observed_holiday_base import ObservedHolidayBase, SUN_TO_NEXT_MON,
 
 
 class Vanuatu(ObservedHolidayBase, ChristianHolidays, InternationalHolidays, StaticHolidays):
-    """
-    https://en.wikipedia.org/wiki/Public_holidays_in_Vanuatu
-    https://www.timeanddate.com/holidays/vanuatu/
-    https://www.gov.vu/index.php/events/holidays
+    """Vanuatu holidays.
+
+    References:
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Vanuatu>
+        * <https://www.timeanddate.com/holidays/vanuatu/>
+        * <https://www.gov.vu/index.php/events/holidays>
     """
 
     country = "VU"

holidays/countries/vatican_city.py

@@ -4,7 +4,7 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -17,23 +17,24 @@ from holidays.holiday_base import HolidayBase
 
 
 class VaticanCity(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
+    """Vatican City holidays.
+
     References:
-      - https://www.vatican.va/roman_curia/labour_office/docs/documents/ulsa_b18_7_it.html
-      - https://cdn.restorethe54.com/media/pdf/1917-code-of-canon-law-english.pdf
-      - https://www.vatican.va/archive/cod-iuris-canonici/eng/documents/cic_lib4-cann1244-1253_en.html
-      - https://en.wikipedia.org/wiki/Public_holidays_in_Vatican_City
-      - https://en.wikipedia.org/wiki/Holy_day_of_obligation
-      - https://www.ewtn.com/catholicism/library/solemnity-of-mary-mother-of-god-5826
-      - https://www.franciscanmedia.org/saint-of-the-day/saint-joseph-the-worker/
+        * <https://www.vatican.va/roman_curia/labour_office/docs/documents/ulsa_b18_7_it.html>
+        * <https://cdn.restorethe54.com/media/pdf/1917-code-of-canon-law-english.pdf>
+        * <https://www.vatican.va/archive/cod-iuris-canonici/eng/documents/cic_lib4-cann1244-1253_en.html>
+        * <https://en.wikipedia.org/wiki/Public_holidays_in_Vatican_City>
+        * <https://en.wikipedia.org/wiki/Holy_day_of_obligation>
+        * <https://www.ewtn.com/catholicism/library/solemnity-of-mary-mother-of-god-5826>
+        * <https://www.franciscanmedia.org/saint-of-the-day/saint-joseph-the-worker/>
 
     Cross-checked With:
-        - https://www.vaticanstate.va/images/pdf/CALENDARIO_2020.pdf
-        - https://www.farmaciavaticana.va/images/pdf/calendario_2021.pdf
-        - https://www.farmaciavaticana.va/images/pdf/calendario_2022.pdf
-        - https://www.farmaciavaticana.va/images/pdf/calendario_2023.pdf
-        - https://www.farmaciavaticana.va/media/attachments/2024/01/02/calendario_2024.pdf
-        - https://www.farmaciavaticana.va/media/attachments/2025/01/02/calendario-2025.pdf
+        * <https://www.vaticanstate.va/images/pdf/CALENDARIO_2020.pdf>
+        * <https://www.farmaciavaticana.va/images/pdf/calendario_2021.pdf>
+        * <https://www.farmaciavaticana.va/images/pdf/calendario_2022.pdf>
+        * <https://www.farmaciavaticana.va/images/pdf/calendario_2023.pdf>
+        * <https://www.farmaciavaticana.va/media/attachments/2024/01/02/calendario_2024.pdf>
+        * <https://www.farmaciavaticana.va/media/attachments/2025/01/02/calendario-2025.pdf>
     """
 
     country = "VA"

holidays/countries/venezuela.py

@@ -4,7 +4,7 @@
 #  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 AUTHORS file)
+#  Authors: Vacanza Team and individual contributors (see AUTHORS.md file)
 #           dr-prodigy <dr.prodigy.github@gmail.com> (c) 2017-2023
 #           ryanss <ryanssdev@icloud.com> (c) 2014-2017
 #  Website: https://github.com/vacanza/holidays
@@ -17,8 +17,16 @@ from holidays.holiday_base import HolidayBase
 
 
 class Venezuela(HolidayBase, ChristianHolidays, InternationalHolidays):
-    """
-    https://dias-festivos.eu/dias-festivos/venezuela/#
+    """Venezuela holidays.
+
+    References:
+        * <https://dias-festivos.eu/dias-festivos/venezuela/#>
+        * [1909 Aug 5](https://www.guao.org/sites/default/files/efemerides/69.Ley%20fiestas%20nacionales%201909.pdf)
+        * [1918 May 19](https://www.guao.org/sites/default/files/efemerides/70.%20Ley%20de%20fiestas%20nacionales%201918.pdf)
+        * [1921 Jun 11](https://guao.org/sites/default/files/efemerides/37.LEYES_Y_DECRETOS_1921_Di%cc%81a_de_la_raza.PDF)
+        * [1971 Jun 22](https://www.ilo.org/dyn/travail/docs/2030/Law%20No.29.541.pdf)
+        * [2002 Oct 10](https://www.acnur.org/fileadmin/Documentos/BDL/2008/6635.pdf)
+        * [2012 May 7](https://oig.cepal.org/sites/default/files/2012_leyorgtrabajo_ven.pdf)
     """
 
     country = "VE"
@@ -32,17 +40,6 @@ class Venezuela(HolidayBase, ChristianHolidays, InternationalHolidays):
         super().__init__(*args, **kwargs)
 
     def _populate_public_holidays(self):
-        """
-        Overview: https://dias-festivos.eu/dias-festivos/venezuela/#
-        Various decrees about holidays:
-          1909 (AUG 5): https://bit.ly/3J0mWKQ
-          1918 (MAY 19): https://bit.ly/3B8O1Jz
-          1921 (JUN 11): https://bit.ly/3aUE2gz
-          1971 (JUN 22): https://bit.ly/3yZaUN9
-          2002 (OCT 10): https://bit.ly/3B7nRqC
-          2012 (MAY 7): https://bit.ly/2MT5x97
-        """
-
         # New Year's Day.
         self._add_new_years_day(tr("Año Nuevo"))