basedpyright 1.22.0 → 1.22.1

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]: ...

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

@@ -1,12 +1,14 @@
 import datetime
 from _typeshed import Incomplete, SupportsItems
 from collections.abc import Callable
-from typing import Any, ClassVar, Final, Literal, overload
-from typing_extensions import TypeIs
+from typing import Any, ClassVar, Final, Literal, NamedTuple, overload
+from typing_extensions import Self
 
+from .alarms import Alarms
 from .caselessdict import CaselessDict
 from .parser import Contentline, Contentlines
 from .prop import TypesFactory
+from .timezone.tzp import TZP
 
 __all__ = [
     "Alarm",
@@ -37,6 +39,8 @@ INLINE: CaselessDict[int]
 class InvalidCalendar(ValueError): ...
 class IncompleteComponent(ValueError): ...
 
+def create_utc_property(name: str, docs: str) -> property: ...
+
 class Component(CaselessDict[Incomplete]):
     name: ClassVar[str | None]
     required: ClassVar[tuple[str, ...]]
@@ -64,8 +68,8 @@ class Component(CaselessDict[Incomplete]):
     def get_inline(self, name, decode: bool = True): ...
     def set_inline(self, name, values, encode: bool = True) -> None: ...
     def add_component(self, component: Component) -> None: ...
-    def walk(self, name: str | None = None, select: Callable[[Component], bool] = ...): ...
-    def property_items(self, recursive: bool = True, sorted: bool = True): ...
+    def walk(self, name: str | None = None, select: Callable[[Component], bool] = ...) -> list[Component]: ...
+    def property_items(self, recursive: bool = True, sorted: bool = True) -> list[tuple[str, object]]: ...
     @overload
     @classmethod
     def from_ical(cls, st: str, multiple: Literal[False] = False) -> Component: ...  # or any of its subclasses
@@ -76,16 +80,27 @@ class Component(CaselessDict[Incomplete]):
     def content_lines(self, sorted: bool = True) -> Contentlines: ...
     def to_ical(self, sorted: bool = True) -> bytes: ...
     def __eq__(self, other: Component) -> bool: ...  # type: ignore[override]
+    @property
+    def DTSTAMP(self) -> datetime.datetime | None: ...
+    @DTSTAMP.setter
+    def DTSTAMP(self, value: datetime.datetime) -> None: ...
+    @property
+    def LAST_MODIFIED(self) -> datetime.datetime | None: ...
+    @LAST_MODIFIED.setter
+    def LAST_MODIFIED(self, value: datetime.datetime) -> None: ...
+    def is_thunderbird(self) -> bool: ...
 
 # type_def is a TypeForm
-def create_single_property(prop: str, value_attr: str, value_type: tuple[type, ...], type_def: Any, doc: str) -> property: ...
-def is_date(dt: datetime.date) -> bool: ...  # TypeIs[datetime.date and not datetime.datetime]
-def is_datetime(dt: datetime.date) -> TypeIs[datetime.datetime]: ...
+def create_single_property(
+    prop: str, value_attr: str | None, value_type: tuple[type, ...], type_def: Any, doc: str, vProp: type[Incomplete] = ...
+) -> property: ...
 
 class Event(Component):
     name: ClassVar[Literal["VEVENT"]]
+    @property
+    def alarms(self) -> Alarms: ...
     @classmethod
-    def example(cls, name: str) -> Event: ...
+    def example(cls, name: str = "rfc_9074_example_3") -> Event: ...
     @property
     def DTSTART(self) -> datetime.date | datetime.datetime | None: ...
     @DTSTART.setter
@@ -108,9 +123,49 @@ class Event(Component):
     def end(self) -> datetime.date | datetime.datetime: ...
     @end.setter
     def end(self, value: datetime.date | datetime.datetime | None) -> None: ...
+    @property
+    def X_MOZ_SNOOZE_TIME(self) -> datetime.datetime | None: ...
+    @X_MOZ_SNOOZE_TIME.setter
+    def X_MOZ_SNOOZE_TIME(self, value: datetime.datetime) -> None: ...
+    @property
+    def X_MOZ_LASTACK(self) -> datetime.datetime | None: ...
+    @X_MOZ_LASTACK.setter
+    def X_MOZ_LASTACK(self, value: datetime.datetime) -> None: ...
 
 class Todo(Component):
     name: ClassVar[Literal["VTODO"]]
+    @property
+    def DTSTART(self) -> datetime.datetime | datetime.date | None: ...
+    @DTSTART.setter
+    def DTSTART(self, value: datetime.datetime | datetime.date | None) -> None: ...
+    @property
+    def DUE(self) -> datetime.datetime | datetime.date | None: ...
+    @DUE.setter
+    def DUE(self, value: datetime.datetime | datetime.date | None) -> None: ...
+    @property
+    def DURATION(self) -> datetime.timedelta | None: ...
+    @DURATION.setter
+    def DURATION(self, value: datetime.timedelta | None) -> None: ...
+    @property
+    def start(self) -> datetime.datetime | datetime.date: ...
+    @start.setter
+    def start(self, value: datetime.datetime | datetime.date | None) -> None: ...
+    @property
+    def end(self) -> datetime.datetime | datetime.date: ...
+    @end.setter
+    def end(self, value: datetime.datetime | datetime.date | None) -> None: ...
+    @property
+    def duration(self) -> datetime.timedelta: ...
+    @property
+    def X_MOZ_SNOOZE_TIME(self) -> datetime.datetime | None: ...
+    @X_MOZ_SNOOZE_TIME.setter
+    def X_MOZ_SNOOZE_TIME(self, value: datetime.datetime) -> None: ...
+    @property
+    def X_MOZ_LASTACK(self) -> datetime.datetime | None: ...
+    @X_MOZ_LASTACK.setter
+    def X_MOZ_LASTACK(self, value: datetime.datetime) -> None: ...
+    @property
+    def alarms(self) -> Alarms: ...
 
 class Journal(Component):
     name: ClassVar[Literal["VJOURNAL"]]
@@ -132,25 +187,96 @@ class FreeBusy(Component):
 class Timezone(Component):
     name: ClassVar[Literal["VTIMEZONE"]]
     @classmethod
-    def example(cls, name: str) -> Calendar: ...
-    def to_tz(self, tzp=...): ...  # FIXME -> DstTzInfo: ...
+    def example(cls, name: str = "pacific_fiji") -> Calendar: ...
+    def to_tz(self, tzp: TZP = ..., lookup_tzid: bool = True) -> datetime.tzinfo: ...
     @property
     def tz_name(self) -> str: ...
     def get_transitions(self) -> tuple[list[datetime.datetime], list[tuple[datetime.timedelta, datetime.timedelta, str]]]: ...
+    @classmethod
+    def from_tzinfo(
+        cls, timezone: datetime.tzinfo, tzid: str | None = None, first_date: datetime.date = ..., last_date: datetime.date = ...
+    ) -> Self: ...
+    @classmethod
+    def from_tzid(cls, tzid: str, tzp: TZP = ..., first_date: datetime.date = ..., last_date: datetime.date = ...) -> Self: ...
+    @property
+    def standard(self) -> list[TimezoneStandard]: ...
+    @property
+    def daylight(self) -> list[TimezoneDaylight]: ...
 
 class TimezoneStandard(Component):
     name: ClassVar[Literal["STANDARD"]]
+    @property
+    def DTSTART(self) -> datetime.date | datetime.datetime | None: ...
+    @DTSTART.setter
+    def DTSTART(self, value: datetime.date | datetime.datetime | None) -> None: ...
+    @property
+    def TZOFFSETTO(self) -> datetime.timedelta | None: ...
+    @TZOFFSETTO.setter
+    def TZOFFSETTO(self, value: datetime.timedelta | None) -> None: ...
+    @property
+    def TZOFFSETFROM(self) -> datetime.timedelta | None: ...
+    @TZOFFSETFROM.setter
+    def TZOFFSETFROM(self, value: datetime.timedelta | None) -> None: ...
 
 class TimezoneDaylight(Component):
     name: ClassVar[Literal["DAYLIGHT"]]
+    @property
+    def DTSTART(self) -> datetime.date | datetime.datetime | None: ...
+    @DTSTART.setter
+    def DTSTART(self, value: datetime.date | datetime.datetime | None) -> None: ...
+    @property
+    def TZOFFSETTO(self) -> datetime.timedelta | None: ...
+    @TZOFFSETTO.setter
+    def TZOFFSETTO(self, value: datetime.timedelta | None) -> None: ...
+    @property
+    def TZOFFSETFROM(self) -> datetime.timedelta | None: ...
+    @TZOFFSETFROM.setter
+    def TZOFFSETFROM(self, value: datetime.timedelta | None) -> None: ...
 
 class Alarm(Component):
     name: ClassVar[Literal["VALARM"]]
+    @property
+    def REPEAT(self) -> int: ...
+    @REPEAT.setter
+    def REPEAT(self, value: int) -> None: ...
+    @property
+    def DURATION(self) -> datetime.timedelta | None: ...
+    @DURATION.setter
+    def DURATION(self, value: datetime.timedelta | None) -> None: ...
+    @property
+    def ACKNOWLEDGED(self) -> datetime.datetime | None: ...
+    @ACKNOWLEDGED.setter
+    def ACKNOWLEDGED(self, value: datetime.datetime | None) -> None: ...
+    @property
+    def TRIGGER(self) -> datetime.timedelta | datetime.datetime | None: ...
+    @TRIGGER.setter
+    def TRIGGER(self, value: datetime.timedelta | datetime.datetime | None) -> None: ...
+    @property
+    def TRIGGER_RELATED(self) -> Literal["START", "END"]: ...
+    @TRIGGER_RELATED.setter
+    def TRIGGER_RELATED(self, value: Literal["START", "END"]) -> None: ...
+
+    class Triggers(NamedTuple):
+        start: tuple[datetime.timedelta, ...]
+        end: tuple[datetime.timedelta, ...]
+        absolute: tuple[datetime.datetime, ...]
+
+    @property
+    def triggers(self) -> Alarm.Triggers: ...
 
 class Calendar(Component):
     name: ClassVar[Literal["VCALENDAR"]]
     @classmethod
-    def example(cls, name: str) -> Calendar: ...
+    def example(cls, name: str = "example") -> Calendar: ...
+    @property
+    def events(self) -> list[Event]: ...
+    @property
+    def todos(self) -> list[Todo]: ...
+    def get_used_tzids(self) -> set[str]: ...
+    def get_missing_tzids(self) -> set[str]: ...
+    @property
+    def timezones(self) -> list[Timezone]: ...
+    def add_missing_timezones(self, first_date: datetime.date = ..., last_date: datetime.date = ...) -> None: ...
 
 types_factory: Final[TypesFactory]
 component_factory: Final[ComponentFactory]

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

@@ -9,13 +9,13 @@ from typing_extensions import Self, TypeAlias
 from .caselessdict import CaselessDict
 from .parser import Parameters
 from .parser_tools import ICAL_TYPE
+from .timezone import tzid_from_dt as tzid_from_dt, tzid_from_tzinfo as tzid_from_tzinfo
 
 __all__ = [
     "DURATION_REGEX",
     "TimeBase",
     "TypesFactory",
     "WEEKDAY_RULE",
-    "tzid_from_dt",
     "vBinary",
     "vBoolean",
     "vCalAddress",
@@ -39,6 +39,8 @@ __all__ = [
     "vUTCOffset",
     "vUri",
     "vWeekday",
+    "tzid_from_dt",
+    "tzid_from_tzinfo",
 ]
 
 _PropType: TypeAlias = type[Any]  # any of the v* classes in this file
@@ -47,8 +49,6 @@ _vRecurT = TypeVar("_vRecurT", bound=vRecur)
 DURATION_REGEX: Final[Pattern[str]]
 WEEKDAY_RULE: Final[Pattern[str]]
 
-def tzid_from_dt(dt: datetime.datetime) -> str | None: ...
-
 class vBinary:
     obj: Incomplete
     params: Parameters
@@ -140,7 +140,7 @@ class vDatetime(TimeBase):
     def __init__(self, dt) -> None: ...
     def to_ical(self) -> bytes: ...
     @staticmethod
-    def from_ical(ical, timezone: str | None = None) -> datetime.datetime: ...
+    def from_ical(ical, timezone: datetime.timezone | str | None = None) -> datetime.datetime: ...
 
 class vDuration(TimeBase):
     td: Incomplete
@@ -241,13 +241,14 @@ class vGeo:
 
 class vUTCOffset:
     ignore_exceptions: bool
-    td: Incomplete
+    td: datetime.timedelta
     params: Parameters
-    def __init__(self, td) -> None: ...
+    def __init__(self, td: datetime.timedelta) -> None: ...
     def to_ical(self) -> bytes: ...
     @classmethod
     def from_ical(cls, ical): ...
-    def __eq__(self, other): ...
+    def __eq__(self, other: object) -> bool: ...
+    def __hash__(self) -> int: ...
 
 class vInline(str):
     params: Parameters