i5XdZddlmZddlZddlmZmZmZddlmZm Z ddl m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZm Z m!Z!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)m*Z*m+Z+m,Z,m-Z-m.Z.ddl/m0Z0ddl1m2Z2er dd l3m4Z4dd l5m6Z6dd l7m8Z8m9Z9dd l:m;Z;dd ldgZ?dS)z:rfc:`5545` VTODO component.) annotationsN)datedatetime timedelta) TYPE_CHECKINGLiteral)$CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERX_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)SequenceAlarms)CLASSSTATUS) vCalAddress) ConferencecfeZdZdZdZdZdZdZdZe dde e fe d Z e d de e fe d Z eeeeejd Zd ZedUdZejdVdZedUdZejdWdZedXdZejdYdZ dZd[dZ d\d]d"Z dZd^d$ZeZeZ ed_d&Z!e"Z#e$Z%e&Z'e(Z)e*Z+e,Z-e.Z/e0Z1e2Z3e4Z5e6Z7e8Z9e:Z;eZ?e@ZAeBZCeDZEeFZGd'd(lHmIZIeJ d`dafdP ZKeJdbdcdTZLxZMS)dTodoa 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 VTODO)UIDDTSTAMP)r2COLOR COMPLETEDCREATED DESCRIPTIONr:DTSTARTGEOz LAST-MODIFIEDLOCATION ORGANIZERzPERCENT-COMPLETEPRIORITYz RECURRENCE-IDSEQUENCEr3SUMMARYr9URLDUEDURATION)rGrH) ATTACHATTENDEE CATEGORIESCOMMENTCONTACTEXDATERSTATUSRELATED RESOURCESRDATERRULEr?dtzOThe "DTSTART" property for a "VTODO" specifies the inclusive start of the Todo.rGz`The "DUE" property for a "VTODO" calendar component specifies the non-inclusive end of the Todo.) componentc&t|dddS)z=Verify the calendar validity and return the right attributes.r?rGr8)rselfs M/root/projects/butler/venv/lib/python3.11/site-packages/icalendar/cal/todo.py_get_start_end_durationzTodo._get_start_end_durations5dIugVVVreturndate | datetimec t|S)aThe start of the VTODO. Invalid values raise an InvalidCalendar. If there is no start, we also raise an 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 )rrWs rYstartz Todo.starts,"$'''r[r_date | datetime | Nonec||_dS)zSet the start.N)r?)rXr_s rYr_z Todo.starts r[c"t|dS)zThe end of the todo. Invalid values raise an InvalidCalendar error. If there is no end, we also raise an IncompleteComponent error. rG)rrWs rYendzTodo.ends e,,,r[rcc||_dS)z Set the end.N)rG)rXrcs rYrczTodo.endsr[rc t|S)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: 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 )rrWs rYdurationz Todo.durations%T***r[valuect|ts%tdt|jd||ddS)NzUse timedelta, not .r_)locked) isinstancer TypeErrortype__name__ set_duration)rXrgs rYrfz Todo.durationsY%++ KI$u++2FIIIJJ J %00000r[rftimedelta | NonerjLiteral['start', 'end']c*t|||ddS)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') rGN)r&)rXrfrjs rYrozTodo.set_durations "$&%@@@@@r[N!Literal['duration', 'end'] | Nonec*t|||ddS)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) rGN)r()rXr_rjs rY set_startzTodo.set_starts tUFE:::::r[Literal['start', 'duration']c*t|||ddS)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') rGN)r')rXrcrjs rYset_endz Todo.set_end s T366666r[r1c$ddlm}||S)aCompute 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. rr0)icalendar.alarmsr1)rXr1s rYalarmsz Todo.alarmss$ ,+++++vd||r[r) RECURRENCE_ID attendeeslist[vCalAddress] | None categories Sequence[str]classification CLASS | Nonecolor str | Nonecommentslist[str] | str | Noneconceptsr contacts conferenceslist[Conference] | Nonecreated date | None description last_modifiedlinksr location organizervCalAddress | str | Nonepriority int | None recurrence_idrefids related_tor sequencestampstatus STATUS | Nonesummaryuidstr | uuid.UUID | Noneurlc t||n|| | || |||}||_| |_||nt j|_||_| |_ ||_ ||_ ||_ ||_ ||_||_||_||_||_||_||_||_||_|jr||| |S)aCreate 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. 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. 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. N)rrrrrrrr)supernew_utc_nowrruuiduuid4rr_rcrrrrrrrrrrr~rr| _validate_new_validate_start_and_end)clsr~rrrrrrrrrrcrrrrrrrrrrr_rrrrtodo __class__s rYrzTodo.new>sRWW[[ ,%%#,,..'!!    &/33tz||  $  ,"       "&*   4  ' 's 3 3 3 r[examplenamestrcH|td|S)z,Return the todo example with the given name.todos) from_icalr.)rrs rYrz Todo.examples }}[$77888r[)r\r])r_r`)rcr`)r\r)rgr)r_)rfrprjrq)N)r_r]rjrs)rcr]rjrv)r\r1)Nr}NNNNNNNNNNNNNNNNNNNNNNNN)4r~rrrrrrrrrrr rrrrrrrrrcr`rrrr rrrrrrrr`rrrr rrrrr_r`rrrrrrrr)r)rrr\r7)Nrn __module__ __qualname____doc__rrequired singletons exclusivemultiplerrrr?rGpropertyr!r"rr formatrHrZr_setterrcrfrorurxr X_MOZ_SNOOZE_TIMEr X_MOZ_LASTACKr{rrr%rrrr#rdatesrexdatesr$rrulesr+rr*rrrrrr,rrrrrrrrrr)rrr~rimagesrricalendar.attrr| classmethodrr __classcell__)rs@rYr7r7;sR))V DHJ.I H%$ 4 Y G !   4 j   Cx-&-@@@ HWWW(((X(. \\---X- ZZ+++X+ _111_1MT A A A A ASW ; ; ; ; ;LS 7 7 7 7 73*M X" E H$J FG F CG&K#N C"I H H H F"I F&K,,,,,,/3$&'+ +/)-+//3#"&&*%)#'#.2#04)--1#!(, $"&*9gggggg[gR9999[99999r[r7)@r __future__rrrrrtypingrrrr 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/rzr1icalendar.enumsr2r3icalendar.propr4icalendar.prop.conferencer5r7__all__r}r[rYrs"""""""" ..........))))))))%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%L.-----......5((((((''''''--------******444444p9p9p9p9p99p9p9p9f (r[