[portage] fix methods in dbapi.porttree and add comments about allowlist entries

Author: Tatsh

stubs/portage/@tests/stubtest_allowlist.txt

@@ -1,5 +1,4 @@
-portage.dbapi.dbapi.aux_get
-portage.dbapi.dbapi.match
+# Don't stub the deprecated params (root, virtual; _unused_param; mydep; _unused)
 portage.dbapi.porttree.portagetree.__init__
 portage.dbapi.porttree.portdbapi.__init__
 portage.dbapi.porttree.portdbapi.xmatch

stubs/portage/portage/dbapi/__init__.pyi

@@ -1,35 +1,30 @@
 from _typeshed import Incomplete
-from typing import Literal
+from collections.abc import Sequence
+from typing import Literal, TypeAlias
+
+_MyListString: TypeAlias = Literal[
+    "DEFINED_PHASES",
+    "DEPEND",
+    "EAPI",
+    "HDEPEND",
+    "HOMEPAGE",
+    "INHERITED",
+    "IUSE",
+    "KEYWORDS",
+    "LICENSE",
+    "PDEPEND",
+    "PROPERTIES",
+    "PROVIDE",
+    "RDEPEND",
+    "REQUIRED_USE",
+    "repository",
+    "RESTRICT",
+    "SRC_URI",
+    "SLOT",
+]
 
 class dbapi:
-    def aux_get(
-        self,
-        mycpv: str,
-        mylist: list[
-            Literal[
-                "DEFINED_PHASES",
-                "DEPEND",
-                "EAPI",
-                "HDEPEND",
-                "HOMEPAGE",
-                "INHERITED",
-                "IUSE",
-                "KEYWORDS",
-                "LICENSE",
-                "PDEPEND",
-                "PROPERTIES",
-                "PROVIDE",
-                "RDEPEND",
-                "REQUIRED_USE",
-                "repository",
-                "RESTRICT",
-                "SRC_URI",
-                "SLOT",
-            ]
-        ],
-        mytree: str | None = None,
-        myrepo: str | None = None,
-    ) -> list[str]: ...
-    def match(self, mydep: str, use_cache: Literal[0, 1] = 1) -> list[str] | str: ...
+    def aux_get(self, mycpv: str, mylist: Sequence[_MyListString], myrepo: str | None = None) -> list[str]: ...
+    def match(self, origdep: str, use_cache: Literal[0, 1] = 1) -> list[str] | str: ...
 
 def __getattr__(name: str) -> Incomplete: ...  # incomplete module

stubs/portage/portage/dbapi/porttree.pyi

@@ -2,7 +2,7 @@ from _typeshed import Incomplete
 from collections.abc import Sequence
 from typing import Literal
 
-from portage.dbapi import dbapi
+from portage.dbapi import _MyListString, dbapi
 
 class portdbapi(dbapi):
     def getFetchMap(
@@ -25,6 +25,11 @@ class portdbapi(dbapi):
     def findname2(
         self, mycpv: str, mytree: str | None = None, myrepo: str | None = None
     ) -> tuple[None, Literal[0]] | tuple[str, str] | tuple[str, None]: ...
+    # This method overrides in an incompatible way
+    def aux_get(  # type: ignore[override]
+        self, mycpv: str, mylist: Sequence[_MyListString], mytree: str | None = None, myrepo: str | None = None
+    ) -> list[str]: ...
+    def match(self, mydep: str, use_cache: Literal[0, 1] = 1) -> list[str] | str: ...
 
 class portagetree:
     dbapi: portdbapi