From 3132f8fa74560c3284ef3da0d09b911c737a1bde Mon Sep 17 00:00:00 2001
From: Jun Komoda <45822440+junkmd@users.noreply.github.com>
Date: Wed, 15 Jan 2025 00:45:20 +0900
Subject: [PATCH] Turn `RegistryEntries` into an `ABC` and create subclasses
 for frozen and non-frozen cases (part1 of #738). (#739)

* Move `RegistryEntries` docstring.

* Add the `_Entry` type alias.
---
 comtypes/server/register.py | 46 ++++++++++++++++++++-----------------
 1 file changed, 25 insertions(+), 21 deletions(-)

diff --git a/comtypes/server/register.py b/comtypes/server/register.py
index 1c4c1153..dc3de33a 100644
--- a/comtypes/server/register.py
+++ b/comtypes/server/register.py
@@ -93,6 +93,9 @@ def _explain(hkey: int) -> Union[str, int]:
     return _KEYS.get(hkey, hkey)
 
 
+_Entry = Tuple[int, str, str, str]
+
+
 class Registrar(object):
     """COM class registration.
 
@@ -251,6 +254,27 @@ def _get_serverdll(handle: Optional[int]) -> str:
 
 
 class RegistryEntries(object):
+    """Iterator of tuples containing registry entries.
+
+    The tuples must be (key, subkey, name, value).
+
+    Required entries:
+    =================
+    _reg_clsid_ - a string or GUID instance
+    _reg_clsctx_ - server type(s) to register
+
+    Optional entries:
+    =================
+    _reg_desc_ - a string
+    _reg_progid_ - a string naming the progid, typically 'MyServer.MyObject.1'
+    _reg_novers_progid_ - version independend progid, typically 'MyServer.MyObject'
+    _reg_typelib_ - an tuple (libid, majorversion, minorversion) specifying a typelib.
+    _reg_threading_ - a string specifying the threading model
+
+    Note that the first part of the progid string is typically the
+    IDL library name of the type library containing the coclass.
+    """
+
     def __init__(
         self,
         cls: Type,
@@ -275,27 +299,7 @@ def _get_pythonpath(self, cls: Type) -> str:
         dirname = os.path.dirname(sys.modules[modname].__file__)  # type: ignore
         return os.path.abspath(dirname)
 
-    def __iter__(self) -> Iterator[Tuple[int, str, str, str]]:
-        """Return a iterator of tuples containing registry entries.
-
-        The tuples must be (key, subkey, name, value).
-
-        Required entries:
-        =================
-        _reg_clsid_ - a string or GUID instance
-        _reg_clsctx_ - server type(s) to register
-
-        Optional entries:
-        =================
-        _reg_desc_ - a string
-        _reg_progid_ - a string naming the progid, typically 'MyServer.MyObject.1'
-        _reg_novers_progid_ - version independend progid, typically 'MyServer.MyObject'
-        _reg_typelib_ - an tuple (libid, majorversion, minorversion) specifying a typelib.
-        _reg_threading_ - a string specifying the threading model
-
-        Note that the first part of the progid string is typically the
-        IDL library name of the type library containing the coclass.
-        """
+    def __iter__(self) -> Iterator[_Entry]:
         cls = self._cls
         HKCR = winreg.HKEY_CLASSES_ROOT