11import enum
22import io
3+ import sys
34import threading
45from _typeshed import ConvertibleToFloat , FileDescriptorOrPath , Incomplete , StrOrBytesPath , SupportsWrite
6+ from collections import defaultdict
57from collections .abc import Callable
68from socket import AF_INET6 as AF_INET6 , AddressFamily , SocketKind
79from typing import BinaryIO , Final , NamedTuple , SupportsIndex , TypeVar , overload
@@ -213,9 +215,7 @@ class addr(NamedTuple):
213215
214216conn_tmap : dict [str , tuple [list [AddressFamily ], list [SocketKind ]]]
215217
216- class Error (Exception ):
217- msg : str
218- def __init__ (self , msg : str = ...) -> None : ...
218+ class Error (Exception ): ...
219219
220220class NoSuchProcess (Error ):
221221 pid : int
@@ -242,6 +242,7 @@ class TimeoutExpired(Error):
242242
243243_P = ParamSpec ("_P" )
244244_R = TypeVar ("_R" )
245+ _T = TypeVar ("_T" )
245246
246247def usage_percent (used : ConvertibleToFloat , total : float , round_ : SupportsIndex | None = None ) -> float : ...
247248
@@ -257,32 +258,64 @@ def parse_environ_block(data: str) -> dict[str, str]: ...
257258def sockfam_to_enum (num : int ) -> AddressFamily : ...
258259def socktype_to_enum (num : int ) -> SocketKind : ...
259260@overload
260- def conn_to_ntuple (fd : int , fam : int , type_ : int , laddr , raddr , status : str , status_map , pid : int ) -> sconn : ...
261+ def conn_to_ntuple (
262+ fd : int ,
263+ fam : int ,
264+ type_ : int ,
265+ laddr : addr | tuple [str , int ] | tuple [()],
266+ raddr : addr | tuple [str , int ] | tuple [()],
267+ status : int | str ,
268+ status_map : dict [int , str ] | dict [str , str ],
269+ pid : int ,
270+ ) -> sconn : ...
261271@overload
262- def conn_to_ntuple (fd : int , fam : int , type_ : int , laddr , raddr , status : str , status_map , pid : None = None ) -> pconn : ...
272+ def conn_to_ntuple (
273+ fd : int ,
274+ fam : int ,
275+ type_ : int ,
276+ laddr : addr | tuple [str , int ] | tuple [()],
277+ raddr : addr | tuple [str , int ] | tuple [()],
278+ status : int | str ,
279+ status_map : dict [int , str ] | dict [str , str ],
280+ pid : None = None ,
281+ ) -> pconn : ...
263282def deprecated_method (replacement : str ) -> Callable [[Callable [_P , _R ]], Callable [_P , _R ]]: ...
264283
265284class _WrapNumbers :
266285 lock : threading .Lock
267- cache : dict [Incomplete , Incomplete ]
268- reminders : dict [Incomplete , Incomplete ]
269- reminder_keys : dict [Incomplete , Incomplete ]
286+ cache : dict [str , dict [ str , tuple [ int , ...]] ]
287+ reminders : dict [str , defaultdict [ Incomplete , int ] ]
288+ reminder_keys : dict [str , defaultdict [ Incomplete , set [ Incomplete ]] ]
270289 def __init__ (self ) -> None : ...
271- def run (self , input_dict , name ): ...
272- def cache_clear (self , name = None ) -> None : ...
273- def cache_info (self ) -> tuple [dict [Incomplete , Incomplete ], dict [Incomplete , Incomplete ], dict [Incomplete , Incomplete ]]: ...
274-
275- def wrap_numbers (input_dict , name : str ): ...
290+ def run (self , input_dict : dict [str , tuple [int , ...]], name : str ) -> dict [str , tuple [int , ...]]: ...
291+ def cache_clear (self , name : str | None = None ) -> None : ...
292+ def cache_info (
293+ self ,
294+ ) -> tuple [
295+ dict [str , dict [str , tuple [int , ...]]],
296+ dict [str , defaultdict [Incomplete , int ]],
297+ dict [str , defaultdict [Incomplete , set [Incomplete ]]],
298+ ]: ...
299+
300+ def wrap_numbers (input_dict : dict [str , tuple [int , ...]], name : str ) -> dict [str , tuple [int , ...]]: ...
276301def open_binary (fname : FileDescriptorOrPath ) -> BinaryIO : ...
277302def open_text (fname : FileDescriptorOrPath ) -> io .TextIOWrapper : ...
278- def cat (fname : FileDescriptorOrPath , fallback = ..., _open = ...): ...
279- def bcat (fname : FileDescriptorOrPath , fallback = ...): ...
303+ @overload
304+ def cat (fname : FileDescriptorOrPath , _open : Callable [[FileDescriptorOrPath ], io .TextIOWrapper ] = ...) -> str : ...
305+ @overload
306+ def cat (
307+ fname : FileDescriptorOrPath , fallback : _T = ..., _open : Callable [[FileDescriptorOrPath ], io .TextIOWrapper ] = ...
308+ ) -> str | _T : ...
309+ @overload
310+ def bcat (fname : FileDescriptorOrPath ) -> str : ...
311+ @overload
312+ def bcat (fname : FileDescriptorOrPath , fallback : _T = ...) -> str | _T : ...
280313def bytes2human (n : int , format : str = "%(value).1f%(symbol)s" ) -> str : ...
281314def get_procfs_path () -> str : ...
282315def decode (s : bytes ) -> str : ...
283- def term_supports_colors (file : SupportsWrite [str ] = ... ) -> bool : ...
316+ def term_supports_colors (file : SupportsWrite [str ] = sys . stdout ) -> bool : ...
284317def hilite (s : str , color : str | None = None , bold : bool = False ) -> str : ...
285- def print_color (s : str , color : str | None = None , bold : bool = False , file : SupportsWrite [str ] = ... ) -> None : ...
318+ def print_color (s : str , color : str | None = None , bold : bool = False , file : SupportsWrite [str ] = sys . stdout ) -> None : ...
286319def debug (msg : str | Exception ) -> None : ...
287320
288321__all__ = [
0 commit comments