basedpyright 1.13.2 → 1.13.3

package/dist/typeshed-fallback/stdlib/datetime.pyi

@@ -14,12 +14,20 @@ MAXYEAR: Literal[9999]
 
 class tzinfo:
     @abstractmethod
-    def tzname(self, dt: datetime | None, /) -> str | None: ...
+    def tzname(self, dt: datetime | None, /) -> str | None:
+        """datetime -> string name of time zone."""
+        ...
     @abstractmethod
-    def utcoffset(self, dt: datetime | None, /) -> timedelta | None: ...
+    def utcoffset(self, dt: datetime | None, /) -> timedelta | None:
+        """datetime -> timedelta showing offset from UTC, negative values indicating West of UTC"""
+        ...
     @abstractmethod
-    def dst(self, dt: datetime | None, /) -> timedelta | None: ...
-    def fromutc(self, dt: datetime, /) -> datetime: ...
+    def dst(self, dt: datetime | None, /) -> timedelta | None:
+        """datetime -> DST offset as timedelta positive east of UTC."""
+        ...
+    def fromutc(self, dt: datetime, /) -> datetime:
+        """datetime in UTC -> datetime in local time."""
+        ...
 
 # Alias required to avoid name conflicts with date(time).tzinfo.
 _TzInfo: TypeAlias = tzinfo
@@ -30,11 +38,21 @@ class timezone(tzinfo):
     min: ClassVar[timezone]
     max: ClassVar[timezone]
     def __init__(self, offset: timedelta, name: str = ...) -> None: ...
-    def tzname(self, dt: datetime | None, /) -> str: ...
-    def utcoffset(self, dt: datetime | None, /) -> timedelta: ...
-    def dst(self, dt: datetime | None, /) -> None: ...
-    def __hash__(self) -> int: ...
-    def __eq__(self, value: object, /) -> bool: ...
+    def tzname(self, dt: datetime | None, /) -> str:
+        """If name is specified when timezone is created, returns the name.  Otherwise returns offset as 'UTC(+|-)HH:MM'."""
+        ...
+    def utcoffset(self, dt: datetime | None, /) -> timedelta:
+        """Return fixed offset."""
+        ...
+    def dst(self, dt: datetime | None, /) -> None:
+        """Return None."""
+        ...
+    def __hash__(self) -> int:
+        """Return hash(self)."""
+        ...
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
 
 if sys.version_info >= (3, 11):
     UTC: timezone
@@ -51,58 +69,129 @@ class date:
     resolution: ClassVar[timedelta]
     def __new__(cls, year: SupportsIndex, month: SupportsIndex, day: SupportsIndex) -> Self: ...
     @classmethod
-    def fromtimestamp(cls, timestamp: float, /) -> Self: ...
+    def fromtimestamp(cls, timestamp: float, /) -> Self:
+        """
+        Create a date from a POSIX timestamp.
+
+        The timestamp is a number, e.g. created via time.time(), that is interpreted
+        as local time.
+        """
+        ...
     @classmethod
-    def today(cls) -> Self: ...
+    def today(cls) -> Self:
+        """Current date or datetime:  same as self.__class__.fromtimestamp(time.time())."""
+        ...
     @classmethod
-    def fromordinal(cls, n: int, /) -> Self: ...
+    def fromordinal(cls, n: int, /) -> Self:
+        """int -> date corresponding to a proleptic Gregorian ordinal."""
+        ...
     @classmethod
-    def fromisoformat(cls, date_string: str, /) -> Self: ...
+    def fromisoformat(cls, date_string: str, /) -> Self:
+        """str -> Construct a date from the output of date.isoformat()"""
+        ...
     @classmethod
-    def fromisocalendar(cls, year: int, week: int, day: int) -> Self: ...
+    def fromisocalendar(cls, year: int, week: int, day: int) -> Self:
+        """
+        int, int, int -> Construct a date from the ISO year, week number and weekday.
+
+        This is the inverse of the date.isocalendar() function
+        """
+        ...
     @property
     def year(self) -> int: ...
     @property
     def month(self) -> int: ...
     @property
     def day(self) -> int: ...
-    def ctime(self) -> str: ...
+    def ctime(self) -> str:
+        """Return ctime() style string."""
+        ...
     # On <3.12, the name of the parameter in the pure-Python implementation
     # didn't match the name in the C implementation,
     # meaning it is only *safe* to pass it as a keyword argument on 3.12+
     if sys.version_info >= (3, 12):
-        def strftime(self, format: str) -> str: ...
+        def strftime(self, format: str) -> str:
+            """format -> strftime() style string."""
+            ...
     else:
-        def strftime(self, format: str, /) -> str: ...
+        def strftime(self, format: str, /) -> str:
+            """format -> strftime() style string."""
+            ...
 
-    def __format__(self, fmt: str, /) -> str: ...
-    def isoformat(self) -> str: ...
-    def timetuple(self) -> struct_time: ...
-    def toordinal(self) -> int: ...
+    def __format__(self, fmt: str, /) -> str:
+        """Formats self with strftime."""
+        ...
+    def isoformat(self) -> str:
+        """Return string in ISO 8601 format, YYYY-MM-DD."""
+        ...
+    def timetuple(self) -> struct_time:
+        """Return time tuple, compatible with time.localtime()."""
+        ...
+    def toordinal(self) -> int:
+        """Return proleptic Gregorian ordinal.  January 1 of year 1 is day 1."""
+        ...
     if sys.version_info >= (3, 13):
         def __replace__(self, /, *, year: SupportsIndex = ..., month: SupportsIndex = ..., day: SupportsIndex = ...) -> Self: ...
 
-    def replace(self, year: SupportsIndex = ..., month: SupportsIndex = ..., day: SupportsIndex = ...) -> Self: ...
-    def __le__(self, value: date, /) -> bool: ...
-    def __lt__(self, value: date, /) -> bool: ...
-    def __ge__(self, value: date, /) -> bool: ...
-    def __gt__(self, value: date, /) -> bool: ...
-    def __eq__(self, value: object, /) -> bool: ...
-    def __add__(self, value: timedelta, /) -> Self: ...
-    def __radd__(self, value: timedelta, /) -> Self: ...
+    def replace(self, year: SupportsIndex = ..., month: SupportsIndex = ..., day: SupportsIndex = ...) -> Self:
+        """Return date with new specified fields."""
+        ...
+    def __le__(self, value: date, /) -> bool:
+        """Return self<=value."""
+        ...
+    def __lt__(self, value: date, /) -> bool:
+        """Return self<value."""
+        ...
+    def __ge__(self, value: date, /) -> bool:
+        """Return self>=value."""
+        ...
+    def __gt__(self, value: date, /) -> bool:
+        """Return self>value."""
+        ...
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
+    def __add__(self, value: timedelta, /) -> Self:
+        """Return self+value."""
+        ...
+    def __radd__(self, value: timedelta, /) -> Self:
+        """Return value+self."""
+        ...
     @overload
-    def __sub__(self, value: datetime, /) -> NoReturn: ...
+    def __sub__(self, value: datetime, /) -> NoReturn:
+        """Return self-value."""
+        ...
     @overload
-    def __sub__(self, value: Self, /) -> timedelta: ...
+    def __sub__(self, value: Self, /) -> timedelta:
+        """Return self-value."""
+        ...
     @overload
-    def __sub__(self, value: timedelta, /) -> Self: ...
-    def __hash__(self) -> int: ...
-    def weekday(self) -> int: ...
-    def isoweekday(self) -> int: ...
+    def __sub__(self, value: timedelta, /) -> Self:
+        """Return self-value."""
+        ...
+    def __hash__(self) -> int:
+        """Return hash(self)."""
+        ...
+    def weekday(self) -> int:
+        """
+        Return the day of the week represented by the date.
+        Monday == 0 ... Sunday == 6
+        """
+        ...
+    def isoweekday(self) -> int:
+        """
+        Return the day of the week represented by the date.
+        Monday == 1 ... Sunday == 7
+        """
+        ...
     if sys.version_info >= (3, 9):
-        def isocalendar(self) -> _IsoCalendarDate: ...
+        def isocalendar(self) -> _IsoCalendarDate:
+            """Return a named tuple containing ISO year, week number, and weekday."""
+            ...
     else:
-        def isocalendar(self) -> tuple[int, int, int]: ...
+        def isocalendar(self) -> tuple[int, int, int]:
+            """Return a 3-tuple containing ISO year, week number, and weekday."""
+            ...
 
 class time:
     min: ClassVar[time]
@@ -130,27 +219,61 @@ class time:
     def tzinfo(self) -> _TzInfo | None: ...
     @property
     def fold(self) -> int: ...
-    def __le__(self, value: time, /) -> bool: ...
-    def __lt__(self, value: time, /) -> bool: ...
-    def __ge__(self, value: time, /) -> bool: ...
-    def __gt__(self, value: time, /) -> bool: ...
-    def __eq__(self, value: object, /) -> bool: ...
-    def __hash__(self) -> int: ...
-    def isoformat(self, timespec: str = ...) -> str: ...
+    def __le__(self, value: time, /) -> bool:
+        """Return self<=value."""
+        ...
+    def __lt__(self, value: time, /) -> bool:
+        """Return self<value."""
+        ...
+    def __ge__(self, value: time, /) -> bool:
+        """Return self>=value."""
+        ...
+    def __gt__(self, value: time, /) -> bool:
+        """Return self>value."""
+        ...
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
+    def __hash__(self) -> int:
+        """Return hash(self)."""
+        ...
+    def isoformat(self, timespec: str = ...) -> str:
+        """
+        Return string in ISO 8601 format, [HH[:MM[:SS[.mmm[uuu]]]]][+HH:MM].
+
+        The optional argument timespec specifies the number of additional terms
+        of the time to include. Valid options are 'auto', 'hours', 'minutes',
+        'seconds', 'milliseconds' and 'microseconds'.
+        """
+        ...
     @classmethod
-    def fromisoformat(cls, time_string: str, /) -> Self: ...
+    def fromisoformat(cls, time_string: str, /) -> Self:
+        """string -> time from time.isoformat() output"""
+        ...
     # On <3.12, the name of the parameter in the pure-Python implementation
     # didn't match the name in the C implementation,
     # meaning it is only *safe* to pass it as a keyword argument on 3.12+
     if sys.version_info >= (3, 12):
-        def strftime(self, format: str) -> str: ...
+        def strftime(self, format: str) -> str:
+            """format -> strftime() style string."""
+            ...
     else:
-        def strftime(self, format: str, /) -> str: ...
+        def strftime(self, format: str, /) -> str:
+            """format -> strftime() style string."""
+            ...
 
-    def __format__(self, fmt: str, /) -> str: ...
-    def utcoffset(self) -> timedelta | None: ...
-    def tzname(self) -> str | None: ...
-    def dst(self) -> timedelta | None: ...
+    def __format__(self, fmt: str, /) -> str:
+        """Formats self with strftime."""
+        ...
+    def utcoffset(self) -> timedelta | None:
+        """Return self.tzinfo.utcoffset(self)."""
+        ...
+    def tzname(self) -> str | None:
+        """Return self.tzinfo.tzname(self)."""
+        ...
+    def dst(self) -> timedelta | None:
+        """Return self.tzinfo.dst(self)."""
+        ...
     if sys.version_info >= (3, 13):
         def __replace__(
             self,
@@ -173,7 +296,9 @@ class time:
         tzinfo: _TzInfo | None = ...,
         *,
         fold: int = ...,
-    ) -> Self: ...
+    ) -> Self:
+        """Return time with new specified fields."""
+        ...
 
 _Date: TypeAlias = date
 _Time: TypeAlias = time
@@ -193,38 +318,90 @@ class timedelta:
         weeks: float = ...,
     ) -> Self: ...
     @property
-    def days(self) -> int: ...
+    def days(self) -> int:
+        """Number of days."""
+        ...
     @property
-    def seconds(self) -> int: ...
+    def seconds(self) -> int:
+        """Number of seconds (>= 0 and less than 1 day)."""
+        ...
     @property
-    def microseconds(self) -> int: ...
-    def total_seconds(self) -> float: ...
-    def __add__(self, value: timedelta, /) -> timedelta: ...
-    def __radd__(self, value: timedelta, /) -> timedelta: ...
-    def __sub__(self, value: timedelta, /) -> timedelta: ...
-    def __rsub__(self, value: timedelta, /) -> timedelta: ...
-    def __neg__(self) -> timedelta: ...
-    def __pos__(self) -> timedelta: ...
-    def __abs__(self) -> timedelta: ...
-    def __mul__(self, value: float, /) -> timedelta: ...
-    def __rmul__(self, value: float, /) -> timedelta: ...
+    def microseconds(self) -> int:
+        """Number of microseconds (>= 0 and less than 1 second)."""
+        ...
+    def total_seconds(self) -> float:
+        """Total seconds in the duration."""
+        ...
+    def __add__(self, value: timedelta, /) -> timedelta:
+        """Return self+value."""
+        ...
+    def __radd__(self, value: timedelta, /) -> timedelta:
+        """Return value+self."""
+        ...
+    def __sub__(self, value: timedelta, /) -> timedelta:
+        """Return self-value."""
+        ...
+    def __rsub__(self, value: timedelta, /) -> timedelta:
+        """Return value-self."""
+        ...
+    def __neg__(self) -> timedelta:
+        """-self"""
+        ...
+    def __pos__(self) -> timedelta:
+        """+self"""
+        ...
+    def __abs__(self) -> timedelta:
+        """abs(self)"""
+        ...
+    def __mul__(self, value: float, /) -> timedelta:
+        """Return self*value."""
+        ...
+    def __rmul__(self, value: float, /) -> timedelta:
+        """Return value*self."""
+        ...
     @overload
-    def __floordiv__(self, value: timedelta, /) -> int: ...
+    def __floordiv__(self, value: timedelta, /) -> int:
+        """Return self//value."""
+        ...
     @overload
-    def __floordiv__(self, value: int, /) -> timedelta: ...
+    def __floordiv__(self, value: int, /) -> timedelta:
+        """Return self//value."""
+        ...
     @overload
-    def __truediv__(self, value: timedelta, /) -> float: ...
+    def __truediv__(self, value: timedelta, /) -> float:
+        """Return self/value."""
+        ...
     @overload
-    def __truediv__(self, value: float, /) -> timedelta: ...
-    def __mod__(self, value: timedelta, /) -> timedelta: ...
-    def __divmod__(self, value: timedelta, /) -> tuple[int, timedelta]: ...
-    def __le__(self, value: timedelta, /) -> bool: ...
-    def __lt__(self, value: timedelta, /) -> bool: ...
-    def __ge__(self, value: timedelta, /) -> bool: ...
-    def __gt__(self, value: timedelta, /) -> bool: ...
-    def __eq__(self, value: object, /) -> bool: ...
-    def __bool__(self) -> bool: ...
-    def __hash__(self) -> int: ...
+    def __truediv__(self, value: float, /) -> timedelta:
+        """Return self/value."""
+        ...
+    def __mod__(self, value: timedelta, /) -> timedelta:
+        """Return self%value."""
+        ...
+    def __divmod__(self, value: timedelta, /) -> tuple[int, timedelta]:
+        """Return divmod(self, value)."""
+        ...
+    def __le__(self, value: timedelta, /) -> bool:
+        """Return self<=value."""
+        ...
+    def __lt__(self, value: timedelta, /) -> bool:
+        """Return self<value."""
+        ...
+    def __ge__(self, value: timedelta, /) -> bool:
+        """Return self>=value."""
+        ...
+    def __gt__(self, value: timedelta, /) -> bool:
+        """Return self>value."""
+        ...
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
+    def __bool__(self) -> bool:
+        """self != 0"""
+        ...
+    def __hash__(self) -> int:
+        """Return hash(self)."""
+        ...
 
 class datetime(date):
     min: ClassVar[datetime]
@@ -259,26 +436,55 @@ class datetime(date):
     # meaning it is only *safe* to pass it as a keyword argument on 3.12+
     if sys.version_info >= (3, 12):
         @classmethod
-        def fromtimestamp(cls, timestamp: float, tz: _TzInfo | None = ...) -> Self: ...
+        def fromtimestamp(cls, timestamp: float, tz: _TzInfo | None = ...) -> Self:
+            """timestamp[, tz] -> tz's local time from POSIX timestamp."""
+            ...
     else:
         @classmethod
-        def fromtimestamp(cls, timestamp: float, /, tz: _TzInfo | None = ...) -> Self: ...
+        def fromtimestamp(cls, timestamp: float, /, tz: _TzInfo | None = ...) -> Self:
+            """timestamp[, tz] -> tz's local time from POSIX timestamp."""
+            ...
 
     @classmethod
     @deprecated("Use timezone-aware objects to represent datetimes in UTC; e.g. by calling .fromtimestamp(datetime.UTC)")
-    def utcfromtimestamp(cls, t: float, /) -> Self: ...
+    def utcfromtimestamp(cls, t: float, /) -> Self:
+        """Construct a naive UTC datetime from a POSIX timestamp."""
+        ...
     @classmethod
-    def now(cls, tz: _TzInfo | None = None) -> Self: ...
+    def now(cls, tz: _TzInfo | None = None) -> Self:
+        """
+        Returns new datetime object representing current time local to tz.
+
+          tz
+            Timezone object.
+
+        If no tz is specified, uses local timezone.
+        """
+        ...
     @classmethod
     @deprecated("Use timezone-aware objects to represent datetimes in UTC; e.g. by calling .now(datetime.UTC)")
-    def utcnow(cls) -> Self: ...
+    def utcnow(cls) -> Self:
+        """Return a new datetime representing UTC day and time."""
+        ...
     @classmethod
-    def combine(cls, date: _Date, time: _Time, tzinfo: _TzInfo | None = ...) -> Self: ...
-    def timestamp(self) -> float: ...
-    def utctimetuple(self) -> struct_time: ...
-    def date(self) -> _Date: ...
-    def time(self) -> _Time: ...
-    def timetz(self) -> _Time: ...
+    def combine(cls, date: _Date, time: _Time, tzinfo: _TzInfo | None = ...) -> Self:
+        """date, time -> datetime with same date and time fields"""
+        ...
+    def timestamp(self) -> float:
+        """Return POSIX timestamp as float."""
+        ...
+    def utctimetuple(self) -> struct_time:
+        """Return UTC time tuple, compatible with time.localtime()."""
+        ...
+    def date(self) -> _Date:
+        """Return date object with same year, month and day."""
+        ...
+    def time(self) -> _Time:
+        """Return time object with same time but with tzinfo=None."""
+        ...
+    def timetz(self) -> _Time:
+        """Return time object with same time and tzinfo."""
+        ...
     if sys.version_info >= (3, 13):
         def __replace__(
             self,
@@ -307,21 +513,57 @@ class datetime(date):
         tzinfo: _TzInfo | None = ...,
         *,
         fold: int = ...,
-    ) -> Self: ...
-    def astimezone(self, tz: _TzInfo | None = ...) -> Self: ...
-    def isoformat(self, sep: str = ..., timespec: str = ...) -> str: ...
+    ) -> Self:
+        """Return datetime with new specified fields."""
+        ...
+    def astimezone(self, tz: _TzInfo | None = ...) -> Self:
+        """tz -> convert to local time in new timezone tz"""
+        ...
+    def isoformat(self, sep: str = ..., timespec: str = ...) -> str:
+        """
+        [sep] -> string in ISO 8601 format, YYYY-MM-DDT[HH[:MM[:SS[.mmm[uuu]]]]][+HH:MM].
+        sep is used to separate the year from the time, and defaults to 'T'.
+        The optional argument timespec specifies the number of additional terms
+        of the time to include. Valid options are 'auto', 'hours', 'minutes',
+        'seconds', 'milliseconds' and 'microseconds'.
+        """
+        ...
     @classmethod
-    def strptime(cls, date_string: str, format: str, /) -> Self: ...
-    def utcoffset(self) -> timedelta | None: ...
-    def tzname(self) -> str | None: ...
-    def dst(self) -> timedelta | None: ...
-    def __le__(self, value: datetime, /) -> bool: ...  # type: ignore[override]
-    def __lt__(self, value: datetime, /) -> bool: ...  # type: ignore[override]
-    def __ge__(self, value: datetime, /) -> bool: ...  # type: ignore[override]
-    def __gt__(self, value: datetime, /) -> bool: ...  # type: ignore[override]
-    def __eq__(self, value: object, /) -> bool: ...
-    def __hash__(self) -> int: ...
+    def strptime(cls, date_string: str, format: str, /) -> Self:
+        """string, format -> new datetime parsed from a string (like time.strptime())."""
+        ...
+    def utcoffset(self) -> timedelta | None:
+        """Return self.tzinfo.utcoffset(self)."""
+        ...
+    def tzname(self) -> str | None:
+        """Return self.tzinfo.tzname(self)."""
+        ...
+    def dst(self) -> timedelta | None:
+        """Return self.tzinfo.dst(self)."""
+        ...
+    def __le__(self, value: datetime, /) -> bool:
+        """Return self<=value."""
+        ...
+    def __lt__(self, value: datetime, /) -> bool:
+        """Return self<value."""
+        ...
+    def __ge__(self, value: datetime, /) -> bool:
+        """Return self>=value."""
+        ...
+    def __gt__(self, value: datetime, /) -> bool:
+        """Return self>value."""
+        ...
+    def __eq__(self, value: object, /) -> bool:
+        """Return self==value."""
+        ...
+    def __hash__(self) -> int:
+        """Return hash(self)."""
+        ...
     @overload  # type: ignore[override]
-    def __sub__(self, value: Self, /) -> timedelta: ...
+    def __sub__(self, value: Self, /) -> timedelta:
+        """Return self-value."""
+        ...
     @overload
-    def __sub__(self, value: timedelta, /) -> Self: ...
+    def __sub__(self, value: timedelta, /) -> Self:
+        """Return self-value."""
+        ...

package/dist/typeshed-fallback/stdlib/dbm/gnu.pyi

@@ -39,6 +39,56 @@ if sys.platform != "win32":
         __init__: None  # type: ignore[assignment]
 
     if sys.version_info >= (3, 11):
-        def open(filename: StrOrBytesPath, flags: str = "r", mode: int = 0o666, /) -> _gdbm: ...
+        def open(filename: StrOrBytesPath, flags: str = "r", mode: int = 0o666, /) -> _gdbm:
+            """
+            Open a dbm database and return a dbm object.
+
+            The filename argument is the name of the database file.
+
+            The optional flags argument can be 'r' (to open an existing database
+            for reading only -- default), 'w' (to open an existing database for
+            reading and writing), 'c' (which creates the database if it doesn't
+            exist), or 'n' (which always creates a new empty database).
+
+            Some versions of gdbm support additional flags which must be
+            appended to one of the flags described above.  The module constant
+            'open_flags' is a string of valid additional flags.  The 'f' flag
+            opens the database in fast mode; altered data will not automatically
+            be written to the disk after every change.  This results in faster
+            writes to the database, but may result in an inconsistent database
+            if the program crashes while the database is still open.  Use the
+            sync() method to force any unwritten data to be written to the disk.
+            The 's' flag causes all database operations to be synchronized to
+            disk.  The 'u' flag disables locking of the database file.
+
+            The optional mode argument is the Unix mode of the file, used only
+            when the database has to be created.  It defaults to octal 0o666.
+            """
+            ...
     else:
-        def open(filename: str, flags: str = "r", mode: int = 0o666, /) -> _gdbm: ...
+        def open(filename: str, flags: str = "r", mode: int = 0o666, /) -> _gdbm:
+            """
+            Open a dbm database and return a dbm object.
+
+            The filename argument is the name of the database file.
+
+            The optional flags argument can be 'r' (to open an existing database
+            for reading only -- default), 'w' (to open an existing database for
+            reading and writing), 'c' (which creates the database if it doesn't
+            exist), or 'n' (which always creates a new empty database).
+
+            Some versions of gdbm support additional flags which must be
+            appended to one of the flags described above.  The module constant
+            'open_flags' is a string of valid additional flags.  The 'f' flag
+            opens the database in fast mode; altered data will not automatically
+            be written to the disk after every change.  This results in faster
+            writes to the database, but may result in an inconsistent database
+            if the program crashes while the database is still open.  Use the
+            sync() method to force any unwritten data to be written to the disk.
+            The 's' flag causes all database operations to be synchronized to
+            disk.  The 'u' flag disables locking of the database file.
+
+            The optional mode argument is the Unix mode of the file, used only
+            when the database has to be created.  It defaults to octal 0o666.
+            """
+            ...

package/dist/typeshed-fallback/stdlib/dbm/ndbm.pyi

@@ -35,6 +35,30 @@ if sys.platform != "win32":
         __init__: None  # type: ignore[assignment]
 
     if sys.version_info >= (3, 11):
-        def open(filename: StrOrBytesPath, flags: str = "r", mode: int = 0o666, /) -> _dbm: ...
+        def open(filename: StrOrBytesPath, flags: str = "r", mode: int = 0o666, /) -> _dbm:
+            """
+            Return a database object.
+
+            filename
+              The filename to open.
+            flags
+              How to open the file.  "r" for reading, "w" for writing, etc.
+            mode
+              If creating a new file, the mode bits for the new file
+              (e.g. os.O_RDWR).
+            """
+            ...
     else:
-        def open(filename: str, flags: str = "r", mode: int = 0o666, /) -> _dbm: ...
+        def open(filename: str, flags: str = "r", mode: int = 0o666, /) -> _dbm:
+            """
+            Return a database object.
+
+            filename
+              The filename to open.
+            flags
+              How to open the file.  "r" for reading, "w" for writing, etc.
+            mode
+              If creating a new file, the mode bits for the new file
+              (e.g. os.O_RDWR).
+            """
+            ...

package/dist/typeshed-fallback/stdlib/difflib.pyi

@@ -55,7 +55,13 @@ class SequenceMatcher(Generic[_T]):
     def quick_ratio(self) -> float: ...
     def real_quick_ratio(self) -> float: ...
     if sys.version_info >= (3, 9):
-        def __class_getitem__(cls, item: Any, /) -> GenericAlias: ...
+        def __class_getitem__(cls, item: Any, /) -> GenericAlias:
+            """
+            Represent a PEP 585 generic type
+
+            E.g. for t = list[int], t.__origin__ is list and t.__args__ is (int,).
+            """
+            ...
 
 @overload
 def get_close_matches(word: AnyStr, possibilities: Iterable[AnyStr], n: int = 3, cutoff: float = 0.6) -> list[AnyStr]: ...