Bump pywin32 to 309 (#13607)

stubs/pywin32/win32/lib/win32timezone.pyi

@@ -1,13 +1,23 @@
 import datetime
-from _typeshed import Incomplete
+from _operator import _SupportsComparison
+from _typeshed import Incomplete, SupportsKeysAndGetItem
+from collections.abc import Callable, Iterable, Mapping
+from logging import Logger
+from typing import ClassVar, TypeVar, overload, type_check_only
+from typing_extensions import Self
 
-log: Incomplete
+_RangeMapKT = TypeVar("_RangeMapKT", bound=_SupportsComparison)
+
+_T = TypeVar("_T")
+_VT = TypeVar("_VT")
+
+log: Logger
 
 class _SimpleStruct:
     def __init__(self, *args, **kw) -> None: ...
-    def field_names(self): ...
-    def __eq__(self, other): ...
-    def __ne__(self, other): ...
+    def field_names(self) -> list[str]: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
 
 class SYSTEMTIME(_SimpleStruct): ...
 class TIME_ZONE_INFORMATION(_SimpleStruct): ...
@@ -15,59 +25,88 @@ class DYNAMIC_TIME_ZONE_INFORMATION(_SimpleStruct): ...
 
 class TimeZoneDefinition(DYNAMIC_TIME_ZONE_INFORMATION):
     def __init__(self, *args, **kwargs) -> None: ...
+    # TIME_ZONE_INFORMATION fields as obtained by __getattribute__
+    bias: datetime.timedelta
+    standard_name: str
+    standard_start: SYSTEMTIME
+    standard_bias: datetime.timedelta
+    daylight_name: str
+    daylight_start: SYSTEMTIME
+    daylight_bias: datetime.timedelta
     def __getattribute__(self, attr: str): ...
     @classmethod
-    def current(cls): ...
+    def current(cls) -> tuple[int, Self]: ...
     def set(self) -> None: ...
-    def copy(self): ...
-    def locate_daylight_start(self, year): ...
-    def locate_standard_start(self, year): ...
+    def copy(self) -> Self: ...
+    def locate_daylight_start(self, year) -> datetime.datetime: ...
+    def locate_standard_start(self, year) -> datetime.datetime: ...
 
 class TimeZoneInfo(datetime.tzinfo):
-    tzRegKey: str
-    timeZoneName: Incomplete
-    fixedStandardTime: Incomplete
-    def __init__(self, param: Incomplete | None = ..., fix_standard_time: bool = ...) -> None: ...
-    def tzname(self, dt): ...
-    def getWinInfo(self, targetYear): ...
-    def utcoffset(self, dt): ...
-    def dst(self, dt): ...
-    def GetDSTStartTime(self, year): ...
-    def GetDSTEndTime(self, year): ...
-    def __le__(self, other) -> bool: ...
-    def __eq__(self, other) -> bool: ...
-    def __ne__(self, other) -> bool: ...
+    tzRegKey: ClassVar[str]
+    timeZoneName: str
+    fixedStandardTime: bool
+    def __init__(self, param: str | TimeZoneDefinition, fix_standard_time: bool = False) -> None: ...
+    @overload  # type: ignore[override] # Split definition into overrides
+    def tzname(self, dt: datetime.datetime) -> str: ...
+    @overload
+    def tzname(self, dt: None) -> None: ...
+    def getWinInfo(self, targetYear: int) -> TimeZoneDefinition: ...
+    @overload  # type: ignore[override] # False-positive, our overload covers all base types
+    def utcoffset(self, dt: None) -> None: ...
+    @overload
+    def utcoffset(self, dt: datetime.datetime) -> datetime.timedelta: ...
+    @overload  # type: ignore[override] # False-positive, our overload covers all base types
+    def dst(self, dt: None) -> None: ...
+    @overload
+    def dst(self, dt: datetime.datetime) -> datetime.timedelta: ...
+    def GetDSTStartTime(self, year: int) -> datetime.datetime: ...
+    def GetDSTEndTime(self, year: int) -> datetime.datetime: ...
+    def __eq__(self, other: object) -> bool: ...
+    def __ne__(self, other: object) -> bool: ...
     @classmethod
-    def local(cls): ...
+    def local(cls) -> Self: ...
     @classmethod
-    def utc(cls): ...
+    def utc(cls) -> Self: ...
     @staticmethod
-    def get_sorted_time_zone_names(): ...
+    def get_sorted_time_zone_names() -> list[str]: ...
     @staticmethod
-    def get_all_time_zones(): ...
+    def get_all_time_zones() -> list[TimeZoneInfo]: ...
     @staticmethod
     def get_sorted_time_zones(key: Incomplete | None = ...): ...
 
-def utcnow(): ...
-def now(): ...
-def GetTZCapabilities(): ...
+def utcnow() -> datetime.datetime: ...
+def now() -> datetime.datetime: ...
+def GetTZCapabilities() -> dict[str, bool]: ...
 
 class DLLHandleCache:
-    def __getitem__(self, filename): ...
+    def __getitem__(self, filename: str) -> int: ...
 
-DLLCache: Incomplete
+DLLCache: DLLHandleCache
 
-def resolveMUITimeZone(spec): ...
+def resolveMUITimeZone(spec: str) -> str | None: ...
 
-class RangeMap(dict[int, str]):
-    sort_params: Incomplete
-    match: Incomplete
-    def __init__(self, source, sort_params=..., key_match_comparator=...) -> None: ...
-    def __getitem__(self, item): ...
-    def get(self, key, default: Incomplete | None = ...): ...
-    def bounds(self): ...
-    undefined_value: Incomplete
+class RangeMap(dict[_RangeMapKT, _VT]):
+    sort_params: Mapping[str, Incomplete]
+    match: Callable[[_RangeMapKT, _RangeMapKT], bool]
+    def __init__(
+        self,
+        source: SupportsKeysAndGetItem[_RangeMapKT, _VT] | Iterable[tuple[_RangeMapKT, _VT]],
+        sort_params: Mapping[str, Incomplete] = {},
+        key_match_comparator: Callable[[_RangeMapKT, _RangeMapKT], bool] = ...,
+    ) -> None: ...
+    @classmethod
+    def left(cls, source: SupportsKeysAndGetItem[_RangeMapKT, _VT] | Iterable[tuple[_RangeMapKT, _VT]]) -> Self: ...
+    def __getitem__(self, item: _RangeMapKT) -> _VT: ...
+    @overload  # type: ignore[override] # Signature simplified over dict and Mapping
+    def get(self, key: _RangeMapKT, default: _T) -> _VT | _T: ...
+    @overload
+    def get(self, key: _RangeMapKT, default: None = None) -> _VT | None: ...
+    def bounds(self) -> tuple[_RangeMapKT, _RangeMapKT]: ...
+    @type_check_only
+    class RangeValueUndefined: ...
+
+    undefined_value: RangeValueUndefined
 
     class Item(int): ...
-    first_item: Incomplete
-    last_item: Incomplete
+    first_item: Item
+    last_item: Item

stubs/pywin32/win32/servicemanager.pyi

@@ -15,7 +15,7 @@ def PrepareToHostSingle(klass: Incomplete | None = ..., /) -> None: ...
 def PrepareToHostMultiple(service_name: str, klass, /) -> None: ...
 def RunningAsService(): ...
 def SetEventSourceName(sourceName: str, registerNow: bool = ..., /) -> None: ...
-def StartServiceCtrlDispatcher(*args): ...  # incomplete
+def StartServiceCtrlDispatcher(): ...
 
 COINIT_APARTMENTTHREADED: int
 COINIT_DISABLE_OLE1DDE: int

stubs/pywin32/win32/win32trace.pyi

@@ -1,7 +1,7 @@
 from win32.lib.pywintypes import error as error
 
 def GetHandle(*args): ...  # incomplete
-def GetTracer(*args): ...  # incomplete
+def GetTracer(): ...
 def InitRead(*args): ...  # incomplete
 def InitWrite(*args): ...  # incomplete
 def TermRead(*args): ...  # incomplete

stubs/pywin32/win32/win32ts.pyi

@@ -32,6 +32,7 @@ WTSClientHardwareId: int
 WTSClientName: int
 WTSClientProductId: int
 WTSClientProtocolType: int
+WTSIsRemoteSession: int
 WTSConnectQuery: int
 WTSConnectState: int
 WTSConnected: int