+
    ¾¾j#  ã                   ór   € R t ^ RIHtHt ^ RIHt ^ RIHt ^ RIH	t	H
t
 ^ RIHtHtHt  ! R R]4      tR.tR# )	zTEXT values from :rfc:`5545`.)ÚAnyÚClassVar)ÚSelf)ÚJCalParsingError)Ú
ParametersÚ_escape_char)ÚDEFAULT_ENCODINGÚ	ICAL_TYPEÚ
to_unicodec                   ó<  a a€ ] tR t^t oRtRtRt]R3V3R lV 3R llltV3R lR lt	V3R lR	 lt
]V3R
 lR l4       t]V3R lR l4       t^ RIHtHtHtHtHt V3R lR lt]V3R lR l4       t]V3R lR l4       t]V3R lR l4       tV3R ltRtVtV ;t# )ÚvTextaä  vText is a data type that contains human-readable text values.

The vText property uses the :rfc:`5545#section-3.3.11` TEXT value type
in various icalendar properties to show free-form text that others can read.
This class can be created from Python strings, and can be used to add text
descriptions to calendar events.

To create a TEXT object, pass in the string you want when creating the
object.

To add a line break, use ``\n`` or ``\N``.

Use the LANGUAGE property parameter to set the language of the text.

When the TEXT object is serialized to an icalendar stream, certain
characters are escaped or changed.
These characters include the COMMA, SEMICOLON, BACKSLASH, and line breaks.

Contrast TEXT with the UNKNOWN value data type specified in :rfc:`7265#section-5`.
UNKNOWN is implemented in the Python class :class:`~icalendar.prop.unknown.vUnknown`,
which does **not** apply this escaping and preserves its value verbatim,
because the escaping rules of an unrecognized value type are not known.
:class:`~icalendar.prop.unknown.vUnknown` deliberately does not inherit from
``vText``, so the two don't share escaping behavior.

Examples:

    vText property as a TEXT value type.

    .. code-block:: text

        Project XYZ Final Review\nConference Room - 3B\nCome Prepared.

    Create a vText property, and display it in a readable format.

    .. code-block:: pycon

        >>> from icalendar.prop import vText
        >>> desc = 'Project XYZ Final Review\nConference Room - 3B\nCome Prepared.'
        >>> text = vText(desc)
        >>> text
        vText(b'Project XYZ Final Review\\nConference Room - 3B\\nCome Prepared.')
        >>> print(text.ical_value)
        Project XYZ Final Review
        Conference Room - 3B
        Come Prepared.

    Add a SUMMARY to an event, then display its value as a vText property then in a readable format:

    .. code-block:: pycon

        >>> from icalendar import Event
        >>> event = Event()
        >>> event.add('SUMMARY', desc)
        >>> event['SUMMARY']
        vText(b'Project XYZ Final Review\\nConference Room - 3B\\nCome Prepared.')
        >>> print(event.to_ical().decode())
        BEGIN:VEVENT
        SUMMARY:Project XYZ Final Review\nConference Room - 3B\nCome Prepared.
        END:VEVENT

ÚTEXTNc                óV   <€ V ^8„  d   QhRS[ S[S[3,          R,          RS[RS[RS[/# )é   ÚparamsNÚvalueÚencodingÚreturn)ÚdictÚstrr   r	   r   )ÚformatÚ__classdict__s   "€ÚR/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/prop/text.pyÚ__annotate__ÚvText.__annotate__O   s@   ø€ ÷ ñ ñ
 ‘S™#�X• Õ%ðáðñ ðñ 
ñó    c               ój   <€ \        WR 7      p\        SV `	  W4      pW$n        \	        V4      Vn        V# ))r   )r
   ÚsuperÚ__new__r   r   r   )Úclsr   r   r   ÚselfÚ	__class__s   """& €r   r   ÚvText.__new__O   s3   ø€ ô ˜5Ô4ˆÜ‰w‰˜sÓ*ˆØ ŒÜ  Ó(ˆŒØˆr   c                ó    <€ V ^8„  d   QhRS[ /# ©r   r   ©r   )r   r   s   "€r   r   r   \   s   ø€ ÷ @ñ @™#ñ @r   c                óX   € V P                   P                   R V P                  4       : R2# )Ú(Ú))r!   Ú__name__Úto_ical©r    s   &r   Ú__repr__ÚvText.__repr__\   s'   € Ø—.‘.×)Ñ)Ð*¨!¨D¯L©L«NÑ+=¸QÐ?Ð?r   c                ó    <€ V ^8„  d   QhRS[ /# r$   )Úbytes)r   r   s   "€r   r   r   _   s   ø€ ÷ 8ñ 8™ñ 8r   c                óJ   € \        V 4      P                  V P                  4      # ©N)r   Úencoder   r+   s   &r   r*   ÚvText.to_ical_   s   € Ü˜DÓ!×(Ñ(¨¯©Ó7Ð7r   c                ó&   <€ V ^8„  d   QhRS[ RS[/# )r   Úicalr   )r	   r   )r   r   s   "€r   r   r   c   s   ø€ ÷ ñ ™Yð ©4ñ r   c                ó   € V ! V4      # r1   © )r   r5   s   &&r   Ú	from_icalÚvText.from_icalb   s   € á�4‹yÐr   c                ó    <€ V ^8„  d   QhRS[ /# r$   r%   )r   r   s   "€r   r   r   g   s   ø€ ÷ ñ ™Cñ r   c                ó   € \        V 4      # )zThe string value of the text.r%   r+   s   &r   Ú
ical_valueÚvText.ical_valuef   s   € ô �4‹yÐr   )ÚALTREPÚGAPÚLANGUAGEÚRELTYPEÚVALUEc                ó&   <€ V ^8„  d   QhRS[ RS[/# )r   Únamer   )r   Úlist)r   r   s   "€r   r   r   m   s   ø€ ÷ Lñ L™Cð L¡Dñ Lr   c                ó¸   € VR8X  d   V/ RV P                  R^4      .# WP                  P                  4       V P                  P	                  4       \        V 4      .# )zBThe jCal representation of this property according to :rfc:`7265`.úrequest-statusÚtextÚ;)Úsplitr   Úto_jcalrB   Úlowerr   )r    rD   s   &&r   rK   ÚvText.to_jcalm   sP   € àÐ#Ô#Ø˜"˜f d§j¡j°°aÓ&8Ð9Ð9Ø—k‘k×)Ñ)Ó+¨T¯Z©Z×-=Ñ-=Ó-?ÄÀTÃÐKÐKr   c                ó0   <€ V ^8„  d   QhRS[ S[,          /# r$   ©rE   r   )r   r   s   "€r   r   r   t   s   ø€ ÷ %ñ %™™d�ñ %r   c                ó   € V ! R4      .# )zExamples of vText.zHello World!r7   )r   s   &r   ÚexamplesÚvText.exampless   s   € ñ �NÓ#Ð$Ð$r   c                ó&   <€ V ^8„  d   QhRS[ RS[/# )r   Újcal_propertyr   rO   )r   r   s   "€r   r   r   y   s   ø€ ÷ 
ñ 
¡dð 
©tñ 
r   c                óŠ  € \         P                  ! W4       V^ ,          pVR8X  d   ^ RIHp VP	                  V4      # V^,          pVR8X  d=   \         P
                  ! V^,          \        V ^4       RP                  V^,          4      p\         P                  ! V\        V ^4       V ! V\        P                  ! V4      R7      # )z Parse jCal from :rfc:`7265`.

Parameters:
    jcal_property: The jCal property to parse.

Raises:
    ~error.JCalParsingError: If the provided jCal is invalid.
Ú
categories)Ú	vCategoryrG   rI   )r   )r   Úvalidate_propertyÚicalendar.proprW   Ú	from_jcalÚvalidate_list_typer   ÚjoinÚvalidate_value_typer   Úfrom_jcal_property)r   rT   rD   rW   Ústrings   &&   r   rZ   ÚvText.from_jcalx   s©   € ô 	×*Ò*¨=Ô>Ø˜QÕˆØ�<ÔÝ0à×&Ñ& }Ó5Ð5Ø˜qÕ!ˆØÐ#Ô#Ü×/Ò/°¸aÕ0@Ä#ÀsÈAÔNØ—X‘X˜m¨AÕ.Ó/ˆFÜ×,Ò,¨V´S¸#¸qÔAÙØÜ×0Ò0°Ó?ô
ð 	
r   c                ó&   <€ V ^8„  d   QhRS[ RS[/# )r   Ú
jcal_valuer   )r   r   )r   r   s   "€r   r   r   “   s   ø€ ÷ $ñ $©#ð $±$ñ $r   c                ór   € \         P                  ! V\        \        \        3V 4       V ! \        V4      4      # )z Parse a jCal value into a vText.)r   r]   r   ÚintÚfloat)r   rb   s   &&r   Úparse_jcal_valueÚvText.parse_jcal_value’   s,   € ô 	×,Ò,¨Z¼#¼sÄEÐ9JÈCÔPÙ”3�z“?Ó#Ð#r   c                óB   <€ V ^8„  d   Qh/ S[ S[,          ;R&   S[;R&   # )r   Údefault_valuer   )r   r   r   )r   r   s   "€r   r   r      s'   ø‡ ‚ ñ@ ™C•=Ñ)ñA ñB ÑòC r   )r   r   )r)   Ú
__module__Ú__qualname__Ú__firstlineno__Ú__doc__ri   Ú	__slots__r   r   r,   r*   Úclassmethodr8   Úpropertyr<   Úicalendar.paramr>   r?   r@   rA   rB   rK   rQ   rZ   rf   Ú__annotate_func__Ú__static_attributes__Ú__classdictcell__Ú__classcell__)r!   r   s   @@r   r   r      sÀ   ù‡ € ñ=ð~ $*€Mà&€Ið
 )à(,÷õ ÷@ð @÷8ð 8ð ÷ó ðð ÷ó ð÷ FÕE÷Lð Lð ÷%ó ð%ð ÷
ó ð
ð2 ÷$ó ð$÷Q … r   r   N)rm   Útypingr   r   Úicalendar.compatibilityr   Úicalendar.errorr   Úicalendar.parserr   r   Úicalendar.parser_toolsr   r	   r
   r   r   Ú__all__r7   r   r   Ú<module>r|      s2   ðÙ #ç  å (Ý ,ß 5ß JÑ JôK$ˆCô K$ð\ ˆ)‚r   