some new features

.venv/lib/python3.12/site-packages/holidays/mixins/child_entity.py

@@ -0,0 +1,43 @@
+#  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 typing import Optional
+
+from holidays.holiday_base import HolidayBase
+
+
+class ChildEntity:
+    """A mixin for child entities that inherit from a parent entity."""
+
+    parent_entity: type[HolidayBase]
+    """The parent entity class."""
+
+    parent_entity_subdivision_code: Optional[str] = None
+    """The parent entity's corresponding ISO 3166-2 subdivision code."""
+
+    subdivisions: tuple[str, ...] = ()
+    """Override parent subdivisions."""
+
+    subdivisions_aliases: dict[str, str] = {}
+    """Override parent subdivisions aliases."""
+
+    def __init__(self, *args, **kwargs):
+        """Initialize the child entity using its country code.
+
+        A child entity always has its own country code that is different from
+        the parent entity's country code but (in majority of cases) is a
+        subdivision of the parent entity. For setting specific subdivision code
+        value use `parent_entity_subdivision_code`.
+        """
+        kwargs["subdiv"] = self.parent_entity_subdivision_code or self.country
+        super().__init__(*args, **kwargs)