+ j8rRt^RIHt^RIt^RIHtHtHt^RIHtH t ^RI H t H t H t HtHtHtHtHtHtHtHtHtHtHtHtHtHtHtHtHtHtH t H!t!H"t"H#t#H$t$H%t%H&t&H't'H(t(H)t)H*t*H+t+H,t,H-t-H.t.H/t/^RI0H1t1^RI2H3t3]'d)^RI4H5t5H6t6^R I7H8t8^R I9H:t:^R I;HH?t?^R I@HAtA!RR]14tBR.tCR#)z:rfc:`5545` VTODO component.) annotationsN)datedatetime timedelta) TYPE_CHECKINGLiteral)%CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERREQUEST_STATUS_propertyX_MOZ_LASTACK_propertyX_MOZ_SNOOZE_TIME_propertyattendees_propertycategories_propertyclass_propertycolor_propertyconferences_propertycontacts_propertycreate_single_propertydescription_propertyexdates_propertyget_duration_propertyget_end_property&get_start_end_duration_with_validationget_start_propertyimages_propertylocation_propertyorganizer_propertypriority_propertyproperty_del_durationproperty_doc_duration_templateproperty_get_durationproperty_set_durationrdates_propertyrrules_propertysequence_propertyset_duration_with_lockingset_end_with_lockingset_start_with_lockingstatus_propertysummary_property uid_property url_property) Component) get_example)IterableSequenceAlarms)Self)CLASSSTATUS) vCalAddress) Conferencec Na]tRt^=tRtRtR$tR%tR&tR't ] !RR] ] 3] R4t ] !RR] ] 3] R4t]!]]]]P(!RR74tR t]R R l4t]P0R R l4t]RRl4t]P0RRl4t]RRl4t]P0RRl4tR(RRlltR)RRlltR(RRllt]t] t!]RRl4t"]#t$]%t&]'t(])t*]+t,]-t.]/t0]1t2]3t4]5t6]7t8]9t:];t<]=t>]?t@]AtB]CtD]EtF]GtH]ItJ^RIKHLtL]MR*RV3R lll4tN]MR+R!R"ll4tOR#tPV;tQ#),Todoa A "VTODO" calendar component is a grouping of component properties that represents an action item or assignment. For example, it can be used to represent an item of work assigned to an individual, such as "Prepare for the upcoming conference seminar on Internet Calendaring". Examples: Create a new Todo: >>> from icalendar import Todo >>> todo = Todo.new() >>> print(todo.to_ical()) BEGIN:VTODO DTSTAMP:20250517T080612Z UID:d755cef5-2311-46ed-a0e1-6733c9e15c63 END:VTODO Complete the example Todo. .. code-block:: pycon >>> from datetime import datetime, timezone >>> from icalendar import Todo, STATUS >>> todo = Todo.example() >>> todo["PERCENT-COMPLETE"] = 100 >>> todo["COMPLETED"] = datetime(2007, 5, 1, 12, tzinfo=timezone.utc) >>> todo.status = STATUS.COMPLETED >>> print(todo.to_ical().decode()) BEGIN:VTODO CATEGORIES:FAMILY,FINANCE CLASS:CONFIDENTIAL COMPLETED:2007-05-01 12:00:00+00:00 DTSTAMP:20070313T123432Z DUE;VALUE=DATE:20070501 PERCENT-COMPLETE:100 STATUS:COMPLETED SUMMARY:Submit Quebec Income Tax Return for 2006 UID:20070313T123432Z-456553@example.com END:VTODO VTODODTSTARTDUEdtzOThe "DTSTART" property for a "VTODO" specifies the inclusive start of the Todo.z`The "DUE" property for a "VTODO" calendar component specifies the non-inclusive end of the Todo.) componentc \VRRR4#)z=Verify the calendar validity and return the right attributes.r;r<r:)rselfs&Q/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/cal/todo.py_get_start_end_durationTodo._get_start_end_durations5dIugVVcV^8dQhRR/#returndate | datetime)formats"rB __annotate__Todo.__annotate__s(((rEc \V4#)aWThe start of the VTODO. Invalid values raise an :exc:`~icalendar.error.InvalidCalendar`. If there is no start, we also raise an :exc:`~icalendar.error.IncompleteComponent` error. You can get the start, end and duration of a Todo as follows: >>> from datetime import datetime >>> from icalendar import Todo >>> todo = Todo() >>> todo.start = datetime(2021, 1, 1, 12) >>> todo.end = datetime(2021, 1, 1, 12, 30) # 30 minutes >>> todo.duration # 1800 seconds == 30 minutes datetime.timedelta(seconds=1800) >>> print(todo.to_ical()) BEGIN:VTODO DTSTART:20210101T120000 DUE:20210101T123000 END:VTODO )rr@s&rBstart Todo.starts,"$''rEcV^8dQhRR/#)rHrPdate | datetime | NonerK)rLs"rBrMrNs1rEc WnR#)zSet the start.N)r;)rArPs&&rBrPrQs  rEcV^8dQhRR/#rGrK)rLs"rBrMrNs--_-rEc \VR4#)zThe end of the todo. Invalid values raise an :exc:`~icalendar.error.InvalidCalendar` error. If there is no end, we also raise an :exc:`~icalendar.error.IncompleteComponent` error. r<)rr@s&rBendTodo.ends e,,rEcV^8dQhRR/#)rHrWrSrK)rLs"rBrMrNs-rEc WnR#)z Set the end.N)r<)rArWs&&rBrWrXs rEcV^8dQhRR/#)rHrIrrK)rLs"rBrMrNs++)+rEc \V4#)aThe duration of the VTODO. Returns the DURATION property if set, otherwise calculated from start and end. You can set the duration to automatically adjust the end time while keeping start locked. Setting the duration will do the following. 1. Keep the start time locked (unchanged) 2. Adjust the end time to start + duration 3. Remove any existing DUE property 4. Set the DURATION property )rr@s&rBduration Todo.durations%T**rEcV^8dQhRR/#)rHvaluerrK)rLs"rBrMrNs11i1rEc \V\4'g#\R\V4P R24hVP VRR7R#)zUse timedelta, not .rP)lockedN) isinstancer TypeErrortype__name__ set_duration)rAr`s&&rBr]r^sD%++1$u+2F2F1GqIJ J %0rEc V^8dQhRRRR/#)rHr]ztimedelta | NonerczLiteral['start', 'end']rK)rLs"rBrMrNs A A( A2I ArEc \WVR4R#)zSet the duration of the event relative to either start or end. Parameters: duration: The duration to set, or None to convert to DURATION property locked: Which property to keep unchanged ('start' or 'end') r<N)r&)rAr]rcs&&&rBrhTodo.set_durations "$&%@rEc V^8dQhRRRR/#)rHrPrJrcz!Literal['duration', 'end'] | NonerK)rLs"rBrMrNs ; ;$ ;.O ;rEc \WVR4R#)zSet the start with explicit locking behavior. Parameters: start: The start time to set locked: Which property to keep unchanged ('duration', 'end', or None for auto-detect) r<N)r()rArPrcs&&&rB set_startTodo.set_starts tFE:rEc V^8dQhRRRR/#)rHrWrJrczLiteral['start', 'duration']rK)rLs"rBrMrN s 7 7" 7,H 7rEc \WVR4R#)zSet the end of the component, keeping either the start or the duration same. Parameters: end: The end time to set locked: Which property to keep unchanged ('start' or 'duration') r<N)r')rArWrcs&&&rBset_end Todo.set_end s T6rEcV^8dQhRR/#)rHrIr2rK)rLs"rBrMrNsrEc ^RIHpV!V4#)aACompute the alarm times for this component. >>> from datetime import datetime >>> from icalendar import Todo >>> todo = Todo() # empty without alarms >>> todo.start = datetime(2024, 10, 26, 10, 21) >>> len(todo.alarms.times) 0 Note that this only uses DTSTART and DUE, but ignores RDATE, EXDATE, and RRULE properties. r1)icalendar.alarmsr2)rAr2s& rBalarms Todo.alarmss ,d|rE) RECURRENCE_IDc:V^8dQhRRRRRRRRR R R R R R RRRRRRRRRRRRRRRRRRRRRR RR R!R R"RR#RR$RR%R&R'R(R)RR*R+R,RR-R./#)/rH attendeeszlist[vCalAddress] | None categoriesz Sequence[str]classificationz CLASS | Nonecolorz str | Nonecommentszlist[str] | str | Noneconceptsrcontacts conferenceszlist[Conference] | Nonecreatedz date | None descriptionrWrS last_modifiedlinksr location organizerzvCalAddress | str | Nonepriorityz int | None recurrence_idrefids related_tor request_statussequencestamprPstatusz STATUS | None subcomponentszIterable[Component] | Nonesummaryuidzstr | uuid.UUID | NoneurlrIr3rK)rLs"rBrMrNBsMmm,m" m % m  m)m'm)m-mm m$m#m!m !m",#m$%m&.'m(')m*++m,/-m./m01m2&3m45m627m89m:$;m<=m> ?mrEc  <\ST`VeTMVP4V V VV VVVVR7 pVVnV VnVeTM\ P !4VnVVnV Vn VVn VVn VVn VVn VVnVVnVVnVVnVVnVVnVVnVVnVVnVVnVP0'dVP3VV 4V#)abCreate a new TODO with all required properties. This creates a new Todo in accordance with :rfc:`5545`. Parameters: attendees: The :attr:`attendees` of the todo. categories: The :attr:`categories` of the todo. classification: The :attr:`classification` of the todo. color: The :attr:`color` of the todo. comments: The :attr:`~icalendar.Component.comments` of the todo. concepts: The :attr:`~icalendar.Component.concepts` of the todo. contacts: The :attr:`contacts` of the todo. conferences: The :attr:`conferences` of the todo. created: The :attr:`~icalendar.Component.created` of the todo. description: The :attr:`description` of the todo. end: The :attr:`end` of the todo. last_modified: The :attr:`~icalendar.Component.last_modified` of the todo. links: The :attr:`~icalendar.Component.links` of the todo. location: The :attr:`location` of the todo. organizer: The :attr:`organizer` of the todo. recurrence_id: The :attr:`RECURRENCE_ID` of the todo. refids: :attr:`~icalendar.Component.refids` of the todo. related_to: :attr:`~icalendar.Component.related_to` of the todo. request_status: The :attr:`REQUEST_STATUS` of the todo. sequence: The :attr:`sequence` of the todo. stamp: The :attr:`~icalendar.Component.DTSTAMP` of the todo. If None, this is set to the current time. start: The :attr:`start` of the todo. status: The :attr:`status` of the todo. subcomponents: The subcomponents of the todo. summary: The :attr:`summary` of the todo. uid: The :attr:`uid` of the todo. If None, this is set to a new :func:`uuid.uuid4`. url: The :attr:`url` of the todo. Returns: :class:`Todo` Raises: ~error.InvalidCalendar: If the content is not valid according to :rfc:`5545`. .. warning:: As time progresses, we will be stricter with the validation. ) rrrrrrrrr)supernew_utc_nowrruuiduuid4rrPrWr~r|rr}rrrrrrREQUEST_STATUSr{rry _validate_new_validate_start_and_end)clsr{r|r}r~rrrrrrrWrrrrrrrrrrrrPrrrrrtodo __class__s"&&&&&&&&&&&&&&&&&&&&&&&&&&&& rBrTodo.newAsZW[ ,%#,,.'!'!   &/3tzz|  $  ,"       ,"&*      ' 's 3 rEc V^8dQhRRRR/#)rHnamestrrIr9rK)rLs"rBrMrNs9939t9rEc 8VP\RV44#)z,Return the todo example with the given name.todos) from_icalr.)rrs&&rBexample Todo.examples}}[$788rE)r;r<)UIDDTSTAMP)r4COLOR COMPLETEDCREATED DESCRIPTIONrr;GEOz LAST-MODIFIEDLOCATION ORGANIZERzPERCENT-COMPLETEPRIORITYz RECURRENCE-IDSEQUENCEr5SUMMARYrURLr<DURATION)r<r) ATTACHATTENDEE CATEGORIESCOMMENTCONTACTEXDATEzREQUEST-STATUSRELATED RESOURCESRDATERRULE)rP)N)NrKNNNNNNNNNNNNNNNNNNNNNNNNNN)r)Rrg __module__ __qualname____firstlineno____doc__rrequired singletons exclusivemultiplerrrr;r<propertyr!r"rr rLrrCrPsetterrWr]rhrnrrr X_MOZ_SNOOZE_TIMEr X_MOZ_LASTACKrwrr~r%rrr|r#rdatesrexdatesr$rrulesr rr+rr*rrrrr}r,rrrrrrrrrr)rrr{rimagesrricalendar.attrry classmethodrr__static_attributes__ __classcell__)rs@rBr9r9=s)V DHJ.I H% 4 Y G !  4 j  C&--@ HW((. \\-- ZZ++ __11 A ; 73*M " E H$J FG F,N CG&K#N C"I H H H F"I F&K,mmm^99rEr9)Dr __future__rrrrrtypingrrrrr r r r r rrrrrrrrrrrrrrrrrrr r!r"r#r$r%r&r'r(r)r*r+r,icalendar.cal.componentr-icalendar.cal.examplesr.collections.abcr/r0rvr2icalendar.compatibilityr3icalendar.enumsr4r5icalendar.propr6icalendar.prop.conferencer7r9__all__rKrErBrs"" ..)&&&&&&&&&&N..2',-*4w99w9t (rE