basedpyright 1.1.389 → 1.1.392

package/dist/typeshed-fallback/stdlib/zoneinfo/__init__.pyi

@@ -1,47 +1,41 @@
-import sys
-from collections.abc import Iterable
-from datetime import datetime, timedelta, tzinfo
-from typing_extensions import Self
-
-# TODO: remove this version check
-# In theory we shouldn't need this version check. Pyright complains about the imports
-# from zoneinfo.* when run on 3.8 and 3.7 without this. Updates to typeshed's
-# pyright test script are probably needed, see #11189
-if sys.version_info >= (3, 9):
-    from zoneinfo._common import ZoneInfoNotFoundError as ZoneInfoNotFoundError, _IOBytes
-    from zoneinfo._tzpath import (
-        TZPATH as TZPATH,
-        InvalidTZPathWarning as InvalidTZPathWarning,
-        available_timezones as available_timezones,
-        reset_tzpath as reset_tzpath,
-    )
-
-    __all__ = ["ZoneInfo", "reset_tzpath", "available_timezones", "TZPATH", "ZoneInfoNotFoundError", "InvalidTZPathWarning"]
-
-    class ZoneInfo(tzinfo):
-        @property
-        def key(self) -> str: ...
-        def __init__(self, key: str) -> None: ...
-        @classmethod
-        def no_cache(cls, key: str) -> Self:
-            """Get a new instance of ZoneInfo, bypassing the cache."""
-            ...
-        @classmethod
-        def from_file(cls, fobj: _IOBytes, /, key: str | None = None) -> Self:
-            """Create a ZoneInfo file from a file object."""
-            ...
-        @classmethod
-        def clear_cache(cls, *, only_keys: Iterable[str] | None = None) -> None:
-            """Clear the ZoneInfo cache."""
-            ...
-        def tzname(self, dt: datetime | None, /) -> str | None:
-            """Retrieve a string containing the abbreviation for the time zone that applies in a zone at a given datetime."""
-            ...
-        def utcoffset(self, dt: datetime | None, /) -> timedelta | None:
-            """Retrieve a timedelta representing the UTC offset in a zone at the given datetime."""
-            ...
-        def dst(self, dt: datetime | None, /) -> timedelta | None:
-            """Retrieve a timedelta representing the amount of DST applied in a zone at the given datetime."""
-            ...
-
-    def __dir__() -> list[str]: ...
+import sys
+from collections.abc import Iterable
+from datetime import datetime, timedelta, tzinfo
+from typing_extensions import Self
+
+# TODO: remove this version check
+# In theory we shouldn't need this version check. Pyright complains about the imports
+# from zoneinfo.* when run on 3.8 and 3.7 without this. Updates to typeshed's
+# pyright test script are probably needed, see #11189
+if sys.version_info >= (3, 9):
+    from zoneinfo._common import ZoneInfoNotFoundError as ZoneInfoNotFoundError, _IOBytes
+    from zoneinfo._tzpath import (
+        TZPATH as TZPATH,
+        InvalidTZPathWarning as InvalidTZPathWarning,
+        available_timezones as available_timezones,
+        reset_tzpath as reset_tzpath,
+    )
+
+    __all__ = ["ZoneInfo", "reset_tzpath", "available_timezones", "TZPATH", "ZoneInfoNotFoundError", "InvalidTZPathWarning"]
+
+    class ZoneInfo(tzinfo):
+        @property
+        def key(self) -> str: ...
+        def __init__(self, key: str) -> None: ...
+        @classmethod
+        def no_cache(cls, key: str) -> Self: ...
+        @classmethod
+        def from_file(cls, fobj: _IOBytes, /, key: str | None = None) -> Self: ...
+        @classmethod
+        def clear_cache(cls, *, only_keys: Iterable[str] | None = None) -> None: ...
+        def tzname(self, dt: datetime | None, /) -> str | None:
+            """Retrieve a string containing the abbreviation for the time zone that applies in a zone at a given datetime."""
+            ...
+        def utcoffset(self, dt: datetime | None, /) -> timedelta | None:
+            """Retrieve a timedelta representing the UTC offset in a zone at the given datetime."""
+            ...
+        def dst(self, dt: datetime | None, /) -> timedelta | None:
+            """Retrieve a timedelta representing the amount of DST applied in a zone at the given datetime."""
+            ...
+
+    def __dir__() -> list[str]: ...

package/dist/typeshed-fallback/stdlib/zoneinfo/_common.pyi

@@ -1,13 +1,13 @@
-import io
-from typing import Any, Protocol
-
-class _IOBytes(Protocol):
-    def read(self, size: int, /) -> bytes: ...
-    def seek(self, size: int, whence: int = ..., /) -> Any: ...
-
-def load_tzdata(key: str) -> io.BufferedReader: ...
-def load_data(
-    fobj: _IOBytes,
-) -> tuple[tuple[int, ...], tuple[int, ...], tuple[int, ...], tuple[int, ...], tuple[str, ...], bytes | None]: ...
-
-class ZoneInfoNotFoundError(KeyError): ...
+import io
+from typing import Any, Protocol
+
+class _IOBytes(Protocol):
+    def read(self, size: int, /) -> bytes: ...
+    def seek(self, size: int, whence: int = ..., /) -> Any: ...
+
+def load_tzdata(key: str) -> io.BufferedReader: ...
+def load_data(
+    fobj: _IOBytes,
+) -> tuple[tuple[int, ...], tuple[int, ...], tuple[int, ...], tuple[int, ...], tuple[str, ...], bytes | None]: ...
+
+class ZoneInfoNotFoundError(KeyError): ...

package/dist/typeshed-fallback/stdlib/zoneinfo/_tzpath.pyi

@@ -1,13 +1,13 @@
-from _typeshed import StrPath
-from collections.abc import Sequence
-
-# Note: Both here and in clear_cache, the types allow the use of `str` where
-# a sequence of strings is required. This should be remedied if a solution
-# to this typing bug is found: https://github.com/python/typing/issues/256
-def reset_tzpath(to: Sequence[StrPath] | None = None) -> None: ...
-def find_tzfile(key: str) -> str | None: ...
-def available_timezones() -> set[str]: ...
-
-TZPATH: tuple[str, ...]
-
-class InvalidTZPathWarning(RuntimeWarning): ...
+from _typeshed import StrPath
+from collections.abc import Sequence
+
+# Note: Both here and in clear_cache, the types allow the use of `str` where
+# a sequence of strings is required. This should be remedied if a solution
+# to this typing bug is found: https://github.com/python/typing/issues/256
+def reset_tzpath(to: Sequence[StrPath] | None = None) -> None: ...
+def find_tzfile(key: str) -> str | None: ...
+def available_timezones() -> set[str]: ...
+
+TZPATH: tuple[str, ...]
+
+class InvalidTZPathWarning(RuntimeWarning): ...

package/dist/typeshed-fallback/stubs/Deprecated/METADATA.toml

@@ -1,3 +1,3 @@
-version = "1.2.*"
+version = "~=1.2.15"
 upstream_repository = "https://github.com/tantale/deprecated"
 requires = []

package/dist/typeshed-fallback/stubs/Deprecated/deprecated/classic.pyi

@@ -13,7 +13,12 @@ class ClassicAdapter:
     action: _Actions | None
     category: type[Warning]
     def __init__(
-        self, reason: str = "", version: str = "", action: _Actions | None = None, category: type[Warning] = ...
+        self,
+        reason: str = "",
+        version: str = "",
+        action: _Actions | None = None,
+        category: type[Warning] = ...,
+        extra_stacklevel: int = 0,
     ) -> None: ...
     def get_deprecated_msg(self, wrapped: Callable[..., Any], instance: object) -> str: ...
     def __call__(self, wrapped: _F) -> Callable[[_F], _F]: ...

package/dist/typeshed-fallback/stubs/Deprecated/deprecated/sphinx.pyi

@@ -18,6 +18,7 @@ class SphinxAdapter(ClassicAdapter):
         version: str = "",
         action: _Actions | None = None,
         category: type[Warning] = ...,
+        extra_stacklevel: int = 0,
         line_length: int = 70,
     ) -> None: ...
     def __call__(self, wrapped: _F) -> Callable[[_F], _F]: ...

package/dist/typeshed-fallback/stubs/bleach/METADATA.toml

@@ -1,4 +1,4 @@
-version = "6.1.*"
+version = "6.2.*"
 requires = ["types-html5lib"]
 upstream_repository = "https://github.com/mozilla/bleach"
 

package/dist/typeshed-fallback/stubs/docutils/docutils/core.pyi

@@ -1,3 +1,218 @@
 from _typeshed import Incomplete
 
-def __getattr__(name: str) -> Incomplete: ...
+from docutils.writers import _WriterParts
+
+__docformat__: str
+
+class Publisher:
+    document: Incomplete
+    reader: Incomplete
+    parser: Incomplete
+    writer: Incomplete
+    source: Incomplete
+    source_class: Incomplete
+    destination: Incomplete
+    destination_class: Incomplete
+    settings: Incomplete
+    def __init__(
+        self,
+        reader: Incomplete | None = None,
+        parser: Incomplete | None = None,
+        writer: Incomplete | None = None,
+        source: Incomplete | None = None,
+        source_class=...,
+        destination: Incomplete | None = None,
+        destination_class=...,
+        settings: Incomplete | None = None,
+    ) -> None: ...
+    def set_reader(self, reader_name, parser, parser_name) -> None: ...
+    def set_writer(self, writer_name) -> None: ...
+    def set_components(self, reader_name, parser_name, writer_name) -> None: ...
+    def setup_option_parser(
+        self,
+        usage: Incomplete | None = None,
+        description: Incomplete | None = None,
+        settings_spec: Incomplete | None = None,
+        config_section: Incomplete | None = None,
+        **defaults,
+    ): ...
+    def get_settings(
+        self,
+        usage: Incomplete | None = None,
+        description: Incomplete | None = None,
+        settings_spec: Incomplete | None = None,
+        config_section: Incomplete | None = None,
+        **defaults,
+    ): ...
+    def process_programmatic_settings(self, settings_spec, settings_overrides, config_section) -> None: ...
+    def process_command_line(
+        self,
+        argv: Incomplete | None = None,
+        usage: Incomplete | None = None,
+        description: Incomplete | None = None,
+        settings_spec: Incomplete | None = None,
+        config_section: Incomplete | None = None,
+        **defaults,
+    ) -> None: ...
+    def set_io(self, source_path: Incomplete | None = None, destination_path: Incomplete | None = None) -> None: ...
+    def set_source(self, source: Incomplete | None = None, source_path: Incomplete | None = None) -> None: ...
+    def set_destination(self, destination: Incomplete | None = None, destination_path: Incomplete | None = None) -> None: ...
+    def apply_transforms(self) -> None: ...
+    def publish(
+        self,
+        argv: Incomplete | None = None,
+        usage: Incomplete | None = None,
+        description: Incomplete | None = None,
+        settings_spec: Incomplete | None = None,
+        settings_overrides: Incomplete | None = None,
+        config_section: Incomplete | None = None,
+        enable_exit_status: bool = False,
+    ): ...
+    def debugging_dumps(self) -> None: ...
+    def prompt(self) -> None: ...
+    def report_Exception(self, error) -> None: ...
+    def report_SystemMessage(self, error) -> None: ...
+    def report_UnicodeError(self, error) -> None: ...
+
+default_usage: str
+default_description: str
+
+def publish_cmdline(
+    reader: Incomplete | None = None,
+    reader_name: str = "standalone",
+    parser: Incomplete | None = None,
+    parser_name: str = "restructuredtext",
+    writer: Incomplete | None = None,
+    writer_name: str = "pseudoxml",
+    settings: Incomplete | None = None,
+    settings_spec: Incomplete | None = None,
+    settings_overrides: Incomplete | None = None,
+    config_section: Incomplete | None = None,
+    enable_exit_status: bool = True,
+    argv: Incomplete | None = None,
+    usage=...,
+    description=...,
+): ...
+def publish_file(
+    source: Incomplete | None = None,
+    source_path: Incomplete | None = None,
+    destination: Incomplete | None = None,
+    destination_path: Incomplete | None = None,
+    reader: Incomplete | None = None,
+    reader_name: str = "standalone",
+    parser: Incomplete | None = None,
+    parser_name: str = "restructuredtext",
+    writer: Incomplete | None = None,
+    writer_name: str = "pseudoxml",
+    settings: Incomplete | None = None,
+    settings_spec: Incomplete | None = None,
+    settings_overrides: Incomplete | None = None,
+    config_section: Incomplete | None = None,
+    enable_exit_status: bool = False,
+): ...
+def publish_string(
+    source,
+    source_path: Incomplete | None = None,
+    destination_path: Incomplete | None = None,
+    reader: Incomplete | None = None,
+    reader_name: str = "standalone",
+    parser: Incomplete | None = None,
+    parser_name: str = "restructuredtext",
+    writer: Incomplete | None = None,
+    writer_name: str = "pseudoxml",
+    settings: Incomplete | None = None,
+    settings_spec: Incomplete | None = None,
+    settings_overrides: Incomplete | None = None,
+    config_section: Incomplete | None = None,
+    enable_exit_status: bool = False,
+): ...
+def publish_parts(
+    source,
+    source_path: Incomplete | None = None,
+    source_class=...,
+    destination_path: Incomplete | None = None,
+    reader: Incomplete | None = None,
+    reader_name: str = "standalone",
+    parser: Incomplete | None = None,
+    parser_name: str = "restructuredtext",
+    writer: Incomplete | None = None,
+    writer_name: str = "pseudoxml",
+    settings: Incomplete | None = None,
+    settings_spec: Incomplete | None = None,
+    settings_overrides: Incomplete | None = None,
+    config_section: Incomplete | None = None,
+    enable_exit_status: bool = False,
+) -> _WriterParts: ...
+def publish_doctree(
+    source,
+    source_path: Incomplete | None = None,
+    source_class=...,
+    reader: Incomplete | None = None,
+    reader_name: str = "standalone",
+    parser: Incomplete | None = None,
+    parser_name: str = "restructuredtext",
+    settings: Incomplete | None = None,
+    settings_spec: Incomplete | None = None,
+    settings_overrides: Incomplete | None = None,
+    config_section: Incomplete | None = None,
+    enable_exit_status: bool = False,
+): ...
+def publish_from_doctree(
+    document,
+    destination_path: Incomplete | None = None,
+    writer: Incomplete | None = None,
+    writer_name: str = "pseudoxml",
+    settings: Incomplete | None = None,
+    settings_spec: Incomplete | None = None,
+    settings_overrides: Incomplete | None = None,
+    config_section: Incomplete | None = None,
+    enable_exit_status: bool = False,
+): ...
+def publish_cmdline_to_binary(
+    reader: Incomplete | None = None,
+    reader_name: str = "standalone",
+    parser: Incomplete | None = None,
+    parser_name: str = "restructuredtext",
+    writer: Incomplete | None = None,
+    writer_name: str = "pseudoxml",
+    settings: Incomplete | None = None,
+    settings_spec: Incomplete | None = None,
+    settings_overrides: Incomplete | None = None,
+    config_section: Incomplete | None = None,
+    enable_exit_status: bool = True,
+    argv: Incomplete | None = None,
+    usage=...,
+    description=...,
+    destination: Incomplete | None = None,
+    destination_class=...,
+): ...
+def publish_programmatically(
+    source_class,
+    source,
+    source_path,
+    destination_class,
+    destination,
+    destination_path,
+    reader,
+    reader_name,
+    parser,
+    parser_name,
+    writer,
+    writer_name,
+    settings,
+    settings_spec,
+    settings_overrides,
+    config_section,
+    enable_exit_status,
+): ...
+def rst2something(writer, documenttype, doc_path: str = "") -> None: ...
+def rst2html() -> None: ...
+def rst2html4() -> None: ...
+def rst2html5() -> None: ...
+def rst2latex() -> None: ...
+def rst2man() -> None: ...
+def rst2odt() -> None: ...
+def rst2pseudoxml() -> None: ...
+def rst2s5() -> None: ...
+def rst2xetex() -> None: ...
+def rst2xml() -> None: ...

package/dist/typeshed-fallback/stubs/docutils/docutils/writers/__init__.pyi

@@ -1,4 +1,5 @@
-from typing import Any, Generic, TypeVar
+from typing import Any, Generic, TypedDict, TypeVar, type_check_only
+from typing_extensions import Required
 
 from docutils import Component, nodes
 from docutils.io import Output
@@ -6,8 +7,65 @@ from docutils.languages import LanguageImporter
 
 _S = TypeVar("_S")
 
+# It would probably be better to specialize writers for subclasses,
+# but this gives us all possible Writer items w/o instance checks
+@type_check_only
+class _WriterParts(TypedDict, total=False):
+    # Parts Provided by All Writers https://docutils.sourceforge.io/docs/api/publisher.html#parts-provided-by-all-writers
+
+    # See Writer.assemble_parts
+    whole: Required[str | bytes]
+    encoding: Required[str]
+    errors: Required[str]
+    version: Required[str]
+
+    # Parts Provided by the HTML Writers https://docutils.sourceforge.io/docs/api/publisher.html#parts-provided-by-the-html-writers
+
+    # HTML4 Writer https://docutils.sourceforge.io/docs/api/publisher.html#html4-writer
+    # + HTML5 Writer https://docutils.sourceforge.io/docs/api/publisher.html#html5-writer
+    body: str
+    body_prefix: str
+    body_pre_docinfo: str
+    body_suffix: str
+    docinfo: str
+    footer: str
+    fragment: str
+    head: str
+    head_prefix: str
+    header: str
+    html_body: str
+    html_head: str
+    html_prolog: str
+    html_subtitle: str
+    html_title: str
+    meta: str
+    stylesheet: str
+    subtitle: str
+    title: str
+    # PEP/HTML Writer https://docutils.sourceforge.io/docs/api/publisher.html#pep-html-writer
+    # + S5/HTML Writer https://docutils.sourceforge.io/docs/api/publisher.html#s5-html-writer
+    pepnum: str
+
+    # Parts Provided by the (Xe)LaTeX Writers https://docutils.sourceforge.io/docs/api/publisher.html#parts-provided-by-the-xe-latex-writers
+
+    # (commenting out those already included)
+    abstract: str
+    # body: str
+    # body_pre_docinfo: str
+    dedication: str
+    # docinfo: str
+    fallbacks: str
+    # head_prefix: str
+    latex_preamble: str
+    pdfsetup: str
+    requirements: str
+    # stylesheet: str
+    # subtitle: str
+    # title: str
+    titledata: str
+
 class Writer(Component, Generic[_S]):
-    parts: dict[str, Any]
+    parts: _WriterParts
     language: LanguageImporter | None = None
     def __init__(self) -> None: ...
     document: nodes.document | None = None

package/dist/typeshed-fallback/stubs/gevent/METADATA.toml

@@ -1,4 +1,4 @@
-version = "24.10.*"
+version = "24.11.*"
 upstream_repository = "https://github.com/gevent/gevent"
 requires = ["types-greenlet", "types-psutil"]
 

package/dist/typeshed-fallback/stubs/gevent/gevent/events.pyi

@@ -49,13 +49,15 @@ class IEventLoopBlocked(Interface):
     greenlet: greenlet_t
     blocking_time: float
     info: Sequence[str]
+    hub: Hub | None
 
 @implementer(IEventLoopBlocked)
 class EventLoopBlocked:
     greenlet: greenlet_t
     blocking_time: float
     info: Sequence[str]
-    def __init__(self, greenlet: greenlet_t, blocking_time: float, info: Sequence[str]) -> None: ...
+    hub: Hub | None
+    def __init__(self, greenlet: greenlet_t, blocking_time: float, info: Sequence[str], *, hub: Hub | None = None) -> None: ...
 
 class IMemoryUsageThresholdExceeded(Interface):
     mem_usage: int

package/dist/typeshed-fallback/stubs/icalendar/METADATA.toml

@@ -1,6 +1,10 @@
-version = "~= 6.0.1"
+version = "6.1.*"
 upstream_repository = "https://github.com/collective/icalendar"
-requires = ["types-python-dateutil", "backports.zoneinfo; python_version<'3.9'"]
+requires = [
+    "types-python-dateutil",
+    "types-pytz",
+    "backports.zoneinfo; python_version<'3.9'",
+]
 
 [tool.stubtest]
 stubtest_requirements = ["pytz"]

package/dist/typeshed-fallback/stubs/icalendar/icalendar/__init__.pyi

@@ -1,3 +1,11 @@
+from .alarms import (
+    Alarms as Alarms,
+    AlarmTime as AlarmTime,
+    ComponentEndMissing as ComponentEndMissing,
+    ComponentStartMissing as ComponentStartMissing,
+    IncompleteAlarmInformation as IncompleteAlarmInformation,
+    LocalTimezoneMissing as LocalTimezoneMissing,
+)
 from .cal import (
     Alarm as Alarm,
     Calendar as Calendar,
@@ -87,4 +95,10 @@ __all__ = [
     "vMonth",
     "IncompleteComponent",
     "InvalidCalendar",
+    "Alarms",
+    "AlarmTime",
+    "ComponentEndMissing",
+    "ComponentStartMissing",
+    "IncompleteAlarmInformation",
+    "LocalTimezoneMissing",
 ]

package/dist/typeshed-fallback/stubs/icalendar/icalendar/alarms.pyi

@@ -0,0 +1,54 @@
+import datetime
+from typing_extensions import TypeAlias
+
+from .cal import Alarm, Event, Todo
+
+__all__ = [
+    "Alarms",
+    "AlarmTime",
+    "IncompleteAlarmInformation",
+    "ComponentEndMissing",
+    "ComponentStartMissing",
+    "LocalTimezoneMissing",
+]
+
+Parent: TypeAlias = Event | Todo
+
+class IncompleteAlarmInformation(ValueError): ...
+class ComponentStartMissing(IncompleteAlarmInformation): ...
+class ComponentEndMissing(IncompleteAlarmInformation): ...
+class LocalTimezoneMissing(IncompleteAlarmInformation): ...
+
+class AlarmTime:
+    def __init__(
+        self,
+        alarm: Alarm,
+        trigger: datetime.datetime,
+        acknowledged_until: datetime.datetime | None = None,
+        snoozed_until: datetime.datetime | None = None,
+        parent: Parent | None = None,
+    ): ...
+    @property
+    def acknowledged(self) -> datetime.datetime | None: ...
+    @property
+    def alarm(self) -> Alarm: ...
+    @property
+    def parent(self) -> Parent | None: ...
+    def is_active(self) -> bool: ...
+    @property
+    def trigger(self) -> datetime.date: ...
+
+class Alarms:
+    def __init__(self, component: Alarm | Event | Todo | None = None): ...
+    def add_component(self, component: Alarm | Parent) -> None: ...
+    def set_parent(self, parent: Parent) -> None: ...
+    def add_alarm(self, alarm: Alarm) -> None: ...
+    def set_start(self, dt: datetime.date | None) -> None: ...
+    def set_end(self, dt: datetime.date | None) -> None: ...
+    def acknowledge_until(self, dt: datetime.date | None) -> None: ...
+    def snooze_until(self, dt: datetime.date | None) -> None: ...
+    def set_local_timezone(self, tzinfo: datetime.tzinfo | str | None) -> None: ...
+    @property
+    def times(self) -> list[AlarmTime]: ...
+    @property
+    def active(self) -> list[AlarmTime]: ...