[psutil] Complete common POSIX logic

Author: donbarbos

stubs/psutil/psutil/_psaix.pyi

@@ -108,5 +108,5 @@ if sys.platform != "linux" and sys.platform != "win32" and sys.platform != "darw
         def open_files(self) -> list[_common.popenfile]: ...
         def num_fds(self) -> int: ...
         def num_ctx_switches(self) -> _common.pctxsw: ...
-        def wait(self, timeout: float | None = None): ...
+        def wait(self, timeout: float | None = None) -> int | None: ...
         def io_counters(self) -> _common.pio: ...

stubs/psutil/psutil/_psbsd.pyi

@@ -177,7 +177,7 @@ if sys.platform != "linux" and sys.platform != "win32" and sys.platform != "darw
         def num_ctx_switches(self) -> _common.pctxsw: ...
         def threads(self) -> list[_common.pthread]: ...
         def net_connections(self, kind: str = "inet") -> list[_common.pconn]: ...
-        def wait(self, timeout: float | None = None): ...
+        def wait(self, timeout: float | None = None) -> int | None: ...
         def nice_get(self) -> int: ...
         def nice_set(self, value: int) -> None: ...
         def status(self) -> str: ...

stubs/psutil/psutil/_pslinux.pyi

@@ -260,7 +260,7 @@ if sys.platform == "linux":
         def io_counters(self) -> pio: ...
         def cpu_times(self) -> pcputimes: ...
         def cpu_num(self) -> int: ...
-        def wait(self, timeout: float | None = None): ...
+        def wait(self, timeout: float | None = None) -> int | None: ...
         def create_time(self, monotonic: bool = False) -> float: ...
         def memory_info(self) -> pmem: ...
         def memory_full_info(self) -> pfullmem: ...

stubs/psutil/psutil/_psosx.pyi

@@ -110,7 +110,7 @@ if sys.platform == "darwin":
         def open_files(self) -> list[_common.popenfile]: ...
         def net_connections(self, kind: str = "inet"): ...
         def num_fds(self) -> int: ...
-        def wait(self, timeout: float | None = None): ...
+        def wait(self, timeout: float | None = None) -> int | None: ...
         def nice_get(self): ...
         def nice_set(self, value): ...
         def status(self) -> str: ...

stubs/psutil/psutil/_psposix.pyi

@@ -1,19 +1,67 @@
+import enum
 import sys
-from _typeshed import FileDescriptorOrPath, StrOrBytesPath
+from _typeshed import FileDescriptorOrPath, StrOrBytesPath, Unused
+from collections.abc import Callable
 
 from ._common import sdiskusage
 
 def pid_exists(pid: int) -> bool: ...
+
+# Sync with `signal.Signals`, but with opposite values:
+class Negsignal(enum.IntEnum):
+    SIGABRT = -6
+    SIGFPE = -8
+    SIGILL = -4
+    SIGINT = -2
+    SIGSEGV = -11
+    SIGTERM = -15
+    SIGALRM = -14
+    SIGBUS = -7
+    SIGCHLD = -17
+    SIGCONT = -18
+    SIGHUP = -1
+    SIGIO = -29
+    SIGIOT = 6
+    SIGKILL = -9
+    SIGPIPE = -13
+    SIGPROF = -27
+    SIGQUIT = -3
+    SIGSTOP = -19
+    SIGSYS = -31
+    SIGTRAP = -5
+    SIGTSTP = -20
+    SIGTTIN = -21
+    SIGTTOU = -22
+    SIGURG = -23
+    SIGUSR1 = -10
+    SIGUSR2 = -12
+    SIGVTALRM = -26
+    SIGWINCH = -28
+    SIGXCPU = -24
+    SIGXFSZ = -25
+    if sys.platform != "linux":
+        SIGEMT = -7
+        SIGINFO = -29
+    if sys.platform != "darwin":
+        SIGCLD = -17
+        SIGPOLL = -29
+        SIGPWR = -30
+        SIGRTMAX = -64
+        SIGRTMIN = -34
+        if sys.version_info >= (3, 11):
+            SIGSTKFLT = -16
+
+def negsig_to_enum(num: int) -> int: ...
 def wait_pid(
     pid: int,
     timeout: float | None = None,
     proc_name: str | None = None,
-    _waitpid=...,
-    _timer=...,
+    _waitpid: Unused = ...,
+    _timer: Callable[[], float] = ...,
     _min=...,
-    _sleep=...,
-    _pid_exists=...,
-): ...
+    _sleep: Callable[[float], None] = ...,
+    _pid_exists: Callable[[int], bool] = ...,
+) -> int | None: ...
 
 if sys.platform == "darwin":
     def disk_usage(path: StrOrBytesPath) -> sdiskusage: ...

stubs/psutil/psutil/_pssunos.pyi

@@ -148,4 +148,4 @@ if sys.platform != "linux" and sys.platform != "win32" and sys.platform != "darw
         def memory_maps(self) -> list[tuple[str, str, str, int, int, int]]: ...
         def num_fds(self) -> int: ...
         def num_ctx_switches(self) -> _common.pctxsw: ...
-        def wait(self, timeout: float | None = None): ...
+        def wait(self, timeout: float | None = None) -> int | None: ...

stubs/psutil/psutil/_psutil_aix.pyi

@@ -7,7 +7,7 @@ if sys.platform != "linux" and sys.platform != "win32" and sys.platform != "darw
     AF_LINK: Final = 18
 
     def getpagesize() -> int: ...
-    def net_if_addrs(): ...
+    def net_if_addrs() -> list[tuple[str, int, str, str | None, str | None, str | None]]: ...
     def net_if_flags(nic_name: str, /) -> list[str]: ...
     def net_if_is_running(nic_name: str, /) -> bool: ...
     def net_if_mtu(nic_name: str, /) -> int: ...

stubs/psutil/psutil/_psutil_bsd.pyi

@@ -23,13 +23,13 @@ if sys.platform != "linux" and sys.platform != "win32" and sys.platform != "darw
     RLIM_INFINITY: Final[int]  # only FreeBSD
 
     def getpagesize() -> int: ...
-    def net_if_addrs(): ...
+    def net_if_addrs() -> list[tuple[str, int, str, str | None, str | None, str | None]]: ...
     def net_if_flags(nic_name: str, /) -> list[str]: ...
     def net_if_is_running(nic_name: str, /) -> bool: ...
     def net_if_mtu(nic_name: str, /) -> int: ...
     def proc_priority_get(pid: int, /) -> int: ...
     def proc_priority_set(pid: int, priority: int, /) -> None: ...
-    def net_if_duplex_speed(nic_name: str, /): ...
+    def net_if_duplex_speed(nic_name: str, /) -> tuple[int, int]: ...  # It's actually list of 2 elements
     def proc_is_zombie(pid: int, /) -> bool: ...
 
     version: Final[int]

stubs/psutil/psutil/_psutil_linux.pyi

@@ -1,7 +1,6 @@
 import sys
 
 if sys.platform == "linux":
-    from _typeshed import Incomplete
     from collections.abc import Sequence
     from typing import Final
 
@@ -24,13 +23,13 @@ if sys.platform == "linux":
     RLIM_INFINITY: Final[int]
 
     def getpagesize() -> int: ...
-    def net_if_addrs(): ...
+    def net_if_addrs() -> list[tuple[str, int, str, str | None, str | None, str | None]]: ...
     def net_if_flags(nic_name: str, /) -> list[str]: ...
     def net_if_is_running(nic_name: str, /) -> bool: ...
     def net_if_mtu(nic_name: str, /) -> int: ...
     def proc_priority_get(pid: int, /) -> int: ...
     def proc_priority_set(pid: int, priority: int, /) -> None: ...
-    def users() -> list[tuple[Incomplete, ...]]: ...
+    def users() -> list[tuple[str, str, str, float, int]]: ...
 
     version: Final[int]
     DUPLEX_FULL: Final[int]

stubs/psutil/psutil/_psutil_osx.pyi

@@ -1,7 +1,7 @@
 import sys
 
 if sys.platform == "darwin":
-    from _typeshed import Incomplete, StrOrBytesPath
+    from _typeshed import StrOrBytesPath
     from collections.abc import Sequence
     from socket import AddressFamily, SocketKind
     from typing import Final, TypeVar
@@ -11,14 +11,14 @@ if sys.platform == "darwin":
     AF_LINK: Final = 18
 
     def getpagesize() -> int: ...
-    def net_if_addrs(): ...
+    def net_if_addrs() -> list[tuple[str, int, str, str | None, str | None, str | None]]: ...
     def net_if_flags(nic_name: str, /) -> list[str]: ...
     def net_if_is_running(nic_name: str, /) -> bool: ...
     def net_if_mtu(nic_name: str, /) -> int: ...
     def proc_priority_get(pid: int, /) -> int: ...
     def proc_priority_set(pid: int, priority: int, /) -> None: ...
-    def net_if_duplex_speed(nic_name: str, /): ...
-    def users() -> list[tuple[Incomplete, ...]]: ...
+    def net_if_duplex_speed(nic_name: str, /) -> tuple[int, int]: ...  # It's actually list of 2 elements
+    def users() -> list[tuple[str, str, str, float, int]]: ...
     def proc_is_zombie(pid: int, /) -> bool: ...
 
     version: Final[int]