o .j"@sdZddlmZddlZddlmZmZmZddlmZddl m Z m Z m Z m Z mZmZmZmZmZmZmZmZmZmZmZmZmZmZmZmZddlmZddl m!Z!erjdd l"m#Z#dd l$m%Z%m&Z&dd l'm(Z(Gd d d eZ)d gZ*dS)z:rfc:`5545` VJOURNAL component.) annotationsN)datedatetime timedelta) TYPE_CHECKING)CONCEPTS_TYPE_SETTERLINKS_TYPE_SETTERRELATED_TO_TYPE_SETTERattendees_propertycategories_propertyclass_propertycolor_propertycontacts_propertycreate_single_propertydescriptions_propertyexdates_propertyimages_propertyorganizer_propertyrdates_propertyrrules_propertysequence_propertystatus_propertysummary_property uid_property url_property) Component)IncompleteComponent)Sequence)CLASSSTATUS) vCalAddresscs eZdZdZdZdZdZdZedde e fe dZ e dDd d Z e jdEdd Z e Ze dFddZeZeZeZeZeZeZeZeZ e!Z"e#Z$e%Z&e'Z(e)Z*e+Z,e-Z.ddl/m0Z0e dGddZ1e1jdHddZ1e1j2ddZ1e3Z4e5                      dIdJfdBdC Z6Z7S)KJournalaNA descriptive text at a certain time or associated with a component. Description: A "VJOURNAL" calendar component is a grouping of component properties that represent one or more descriptive text notes associated with a particular calendar date. The "DTSTART" property is used to specify the calendar date with which the journal entry is associated. Generally, it will have a DATE value data type, but it can also be used to specify a DATE-TIME value data type. Examples of a journal entry include a daily record of a legislative body or a journal entry of individual telephone contacts for the day or an ordered list of accomplishments for the day. Examples: Create a new Journal: >>> from icalendar import Journal >>> journal = Journal.new() >>> print(journal.to_ical()) BEGIN:VJOURNAL DTSTAMP:20250517T080612Z UID:d755cef5-2311-46ed-a0e1-6733c9e15c63 END:VJOURNAL VJOURNAL)UIDDTSTAMP) rCOLORCREATEDDTSTARTr$z LAST-MODIFIED ORGANIZERz RECURRENCE-IDSEQUENCErSUMMARYr#URL) ATTACHATTENDEE CATEGORIESCOMMENTCONTACTEXDATERELATEDRDATERRULERSTATUS DESCRIPTIONr'dtzjThe "DTSTART" property for a "VJOURNAL" that specifies the exact date at which the journal entry was made.returnrcCs|j}|dur td|S)zThe start of the Journal. The "DTSTART" property is used to specify the calendar date with which the journal entry is associated. NzNo DTSTART given.)r'r)selfstartr;J/home/thesage/.local/lib/python3.10/site-packages/icalendar/cal/journal.pyr:psz Journal.startvaluedatetime | dateNonecC ||_dS)zSet the start of the journal.N)r')r9r=r;r;r<r:} rcCstdS)z*The journal has no duration: timedelta(0).r)rr9r;r;r<durationzJournal.durationr) RECURRENCE_IDstrcCs|j}|sdSd|S)zThe concatenated descriptions of the journal. A Journal can have several descriptions. This is a compatibility method. Nz ) descriptionsjoin)r9rGr;r;r< descriptions zJournal.descriptionrI str | NonecCr@)zSet the descriptionNrG)r9rIr;r;r<rIrAcCs|`dS)zDelete all descriptions.NrKrBr;r;r<rIrDNr; attendeeslist[vCalAddress] | None categories Sequence[str]classification CLASS | Nonecolorcommentslist[str] | str | Noneconceptsrcontactscreated date | Nonestr | Sequence[str] | None last_modifiedlinksr organizervCalAddress | str | None recurrence_iddate | datetime | Nonerefids related_tor sequence int | Nonestampr:status STATUS | Nonesummaryuidstr | uuid.UUID | Noneurlc stj|dur |n||| || |||d}||_| |_|dur"|nt|_||_||_ ||_ ||_ ||_ ||_ | |_||_||_||_||_| |_|S)aCreate a new journal entry with all required properties. This creates a new Journal in accordance with :rfc:`5545`. Parameters: attendees: The :attr:`attendees` of the journal. categories: The :attr:`categories` of the journal. classification: The :attr:`classification` of the journal. color: The :attr:`color` of the journal. comments: The :attr:`~icalendar.Component.comments` of the journal. concepts: The :attr:`~icalendar.Component.concepts` of the journal. contacts: The :attr:`contacts` of the journal. created: The :attr:`~icalendar.Component.created` of the journal. description: The :attr:`description` of the journal. end: The :attr:`end` of the journal. last_modified: The :attr:`~icalendar.Component.last_modified` of the journal. links: The :attr:`~icalendar.Component.links` of the journal. organizer: The :attr:`organizer` of the journal. recurrence_id: The :attr:`RECURRENCE_ID` of the journal. refids: :attr:`~icalendar.Component.refids` of the journal. related_to: :attr:`~icalendar.Component.related_to` of the journal. sequence: The :attr:`sequence` of the journal. stamp: The :attr:`~icalendar.Component.stamp` of the journal. If None, this is set to the current time. start: The :attr:`start` of the journal. status: The :attr:`status` of the journal. summary: The :attr:`summary` of the journal. uid: The :attr:`uid` of the journal. If None, this is set to a new :func:`uuid.uuid4`. url: The :attr:`url` of the journal. Returns: :class:`Journal` 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)rdrWrZrSr[rar`rU)supernew_utc_nowrgrGuuiduuid4rhr:rRrNrbrPrjr\rVrerLrE)clsrLrNrPrRrSrUrVrWrIrZr[r\r^r`rarbrdr:rergrhrjjournal __class__r;r<rls4D z Journal.new)r8r)r=r>r8r?)r8r)r8rF)rIrJ)Nr;NNNNNNNNNNNNNNNNNNNN),rLrMrNrOrPrQrRrJrSrTrUrrVrTrWrXrIrYrZrXr[rr\r]r^r_r`rTrar rbrcrdrXr:r_rerfrgrJrhrirjrJ)8__name__ __module__ __qualname____doc__namerequired singletonsmultiplerrrr'propertyr:setterendrCr rRrrbr rNrrdatesrexdatesrrrulesrrhrrgrrGr rPrrjrr\rrVrrer rLicalendar.attrrErIdeleterrimages classmethodrl __classcell__r;r;rrr<r!)s       r!)+rw __future__rrnrrrtypingrrrrr r r r r rrrrrrrrrrrrricalendar.cal.componentricalendar.errorrcollections.abcricalendar.enumsrricalendar.propr r!__all__r;r;r;r<s  X     l