types-vobject

import vobject from vobject.base import Component, VEvent from typing import cast, List # Install 'vobject' and 'types-vobject' first: # pip install vobject types-vobject def create_simple_calendar() -> Component: """Creates a VCALENDAR with a single VEVENT using type hints.""" # 'calendar' is inferred as vobject.base.Component calendar = vobject.newFromBehavior('vcalendar') # Add an event component event: Component = calendar.add('vevent') # Accessing the event via vevent_list is type-safe due to stubs event_list: List[VEvent] = calendar.vevent_list first_event = event_list[0] # first_event is inferred as VEvent first_event.add('dtstart').value = '20231027T100000' first_event.add('dtend').value = '20231027T110000' first_event.add('summary').value = 'Meeting with client' first_event.add('description').value = 'Discuss project roadmap and next steps.' return calendar if __name__ == '__main__': my_calendar = create_simple_calendar() print(my_calendar.serialize()) # Accessing properties with type safety first_event: VEvent = my_calendar.vevent_list[0] print(f"\nEvent Summary: {first_event.summary.value}") print(f"Event Description: {first_event.description.value}") print(f"Event Start: {first_event.dtstart.value}")