Add stubs for xdgenvpy (#12615)

pyrightconfig.stricter.json

@@ -100,6 +100,7 @@
         "stubs/vobject",
         "stubs/workalendar",
         "stubs/wurlitzer",
+        "stubs/xdgenvpy"
     ],
     "typeCheckingMode": "strict",
     // TODO: Complete incomplete stubs

stubs/xdgenvpy/@tests/stubtest_allowlist.txt

@@ -0,0 +1 @@
+xdgenvpy.__main__

stubs/xdgenvpy/METADATA.toml

@@ -0,0 +1,2 @@
+version = "2.4.*"
+upstream_repository = "https://gitlab.com/deliberist-group/xdgenvpy"

stubs/xdgenvpy/xdgenvpy/__init__.pyi

@@ -0,0 +1,3 @@
+from xdgenvpy.xdgenv import XDG as XDG, XDGPackage as XDGPackage, XDGPedanticPackage as XDGPedanticPackage
+
+__all__ = ("XDG", "XDGPackage", "XDGPedanticPackage")

stubs/xdgenvpy/xdgenvpy/_defaults.pyi

@@ -0,0 +1,7 @@
+def system_path_separator() -> str: ...
+def XDG_DATA_HOME() -> str: ...
+def XDG_CONFIG_HOME() -> str: ...
+def XDG_CACHE_HOME() -> str: ...
+def XDG_RUNTIME_DIR() -> str: ...
+def XDG_DATA_DIRS() -> str: ...
+def XDG_CONFIG_DIRS() -> str: ...

stubs/xdgenvpy/xdgenvpy/xdgenv.pyi

@@ -0,0 +1,35 @@
+class XDG:
+    def __init__(self) -> None: ...
+    @property
+    def XDG_DATA_HOME(self) -> str: ...
+    @property
+    def XDG_CONFIG_HOME(self) -> str: ...
+    @property
+    def XDG_CACHE_HOME(self) -> str: ...
+    @property
+    def XDG_RUNTIME_DIR(self) -> str: ...
+    @property
+    def XDG_DATA_DIRS(self) -> tuple[str, ...]: ...
+    @property
+    def XDG_CONFIG_DIRS(self) -> tuple[str, ...]: ...
+
+class XDGPackage(XDG):
+    def __init__(self, package_name: str) -> None: ...
+    @property
+    def XDG_DATA_HOME(self) -> str: ...
+    @property
+    def XDG_CONFIG_HOME(self) -> str: ...
+    @property
+    def XDG_CACHE_HOME(self) -> str: ...
+    @property
+    def XDG_RUNTIME_DIR(self) -> str: ...
+
+class XDGPedanticPackage(XDGPackage):
+    @property
+    def XDG_DATA_HOME(self) -> str: ...
+    @property
+    def XDG_CONFIG_HOME(self) -> str: ...
+    @property
+    def XDG_CACHE_HOME(self) -> str: ...
+    @property
+    def XDG_RUNTIME_DIR(self) -> str: ...