+
    ¾¾jT  ã                   óv  € R t ^ RIt^ RIt^ RIt^ RIt0 R0mt0 RkRkRkRkRkR	kR
kRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkRkR kR!kR"kR#ktR$ tR% t]P                  P                  R&]! 4       ]R'7      R( 4       tR) tR* t]P                  P                  R&]! 4       ]R'7      R+ 4       tR, t]P                  P                  R&]! 4       ]R'7      R- 4       t]P                  P                  R&]! 4       ]R'7      R. 4       t]P                  P                  R&]! 4       ]R'7      R/ 4       tR# )1a-  Inspect all docstring section headings.
``ALLOWED_HEADINGS`` is a set of allowed headings.
It may be amended as needed.
``KNOWN_BAD_HEADINGS`` is a set of known bad headings.
As docstrings are fixed, their headings may be removed from this set.
See https://github.com/collective/icalendar/issues/1481
NÚ
ParametersÚTodoÚAvailabilityÚ	AvailableÚBUSYTYPEÚCLASSÚCUTYPEÚCalendarÚ
ConferenceÚEventÚFBTYPEÚFreeBusyÚImageÚJournalÚPARTSTATÚRANGEÚRELATEDÚRELTYPEÚROLEÚSTATUSÚTRANSPÚVALUEÚvCalAddressÚvDateÚ	vDatetimeÚ	vDurationÚvFloatÚvGeoÚvIntÚvMonthÚvRecurÚvTimeÚ
vUTCOffsetÚvUric                  ó  € . p \         P                  ! \        4       Fi  w  rVP                  R 4      '       d   K  \         P                  ! V4      '       g   \         P
                  ! V4      '       g   KX  V P                  V4       Kk  	  V # )Ú_)ÚinspectÚ
getmembersÚ	icalendarÚ
startswithÚisclassÚ
isfunctionÚappend)ÚobjsÚnameÚobjs      Ú^/home/ralf/ical-fahrzeuge/venv/lib/python3.14/site-packages/icalendar/tests/test_docstrings.pyÚget_public_objectsr1   H   sb   € Ø€Dä×'Ò'¬	Ö2‰	ˆØ�?‰?˜3×ÒÙÜ�?Š?˜3×Ò¤7×#5Ò#5°c×#:Ô#:Ø�K‰K˜Öñ	 3ð
 €Kó    c                ó   € V P                   # )z2Return the name of the object for parametrize IDs.)Ú__name__©r/   s   &r0   Ú_obj_idr6   S   s   € à�<‰<Ðr2   r/   )Úidsc                ó²  € V P                   \        9   d2   \        P                  ! RV P                   RV P
                   R24       \        P                  ! V 4      pV'       g   R# \        P                  ! RV\        P                  4      pV FD  pV\        9   d   K  Q RV RV P                    RR	P                  \        \        4      4       24       h	  R# )
zL
Identify docstring section headings that are not one of the allowed types.
Ú'Ú.z–'
  Invalid docstring section heading. See:
  https://icalendar.readthedocs.io/en/stable/contribute/documentation/style-guide.html#docstring-structureNz+^ *([A-Z][A-Za-z]+(?: [A-Za-z]+)*):(?:\n|$)zInvalid docstring heading 'z' found in 'z'. Allowed headings are: z, )r4   ÚKNOWN_BAD_HEADINGSÚpytestÚxfailÚ
__module__Ú__qualname__r&   ÚgetdocÚreÚfindallÚ	MULTILINEÚALLOWED_HEADINGSÚjoinÚsorted)r/   ÚdocÚheadingsÚheadings   &   r0   Ú!test_docstring_headings_are_validrJ   X   sÇ   € ð
 ‡|�|Ô)Ô)Ü�ŠØ�—‘Ð˜q ×!1Ñ!1Ð 2ð 3yð yô	
ô �.Š.˜Ó
€CßÙô �zŠzØ6¸¼R¿\¹\ó€Hó ˆØÔ*Ö*ð 	
Ø)¨'¨°,¸s¿|¹|¸nð M%Ø%)§Y¡Y¬vÔ6FÓ/GÓ%HÐ$IðKó	
Ð*ó r2   c                  ó†  € . p \        4        F°  p\        P                  ! V4      '       d   V P                  V4       K2  \        P                  ! V4      '       g   KP  \        P
                  ! V\        P                  R 7       F6  w  r#VP                  R4      '       d
   VR8w  d   K%  V P                  V4       K8  	  K²  	  V # ))Ú	predicater%   Ú__init__)r1   r&   r+   r,   r*   r'   r)   )r-   r/   r.   Úmethods       r0   Ú$get_all_public_methods_and_functionsrO   t   sŒ   € Ø€Dä!Ö#ˆÜ×Ò˜c×"Ò"Ø�K‰K˜ÖÜ�_Š_˜S×!Ô!Ü '× 2Ò 2°3Ä'×BTÑBT× U‘�Ø—?‘? 3×'Ò'¨D°JÔ,>ÙØ—‘˜FÖ#ó !Vñ	 $ð €Kr2   c                 ó   € V P                   # )N)r?   r5   s   &r0   Ú
_method_idrQ   ‚   s   € Ø×ÑÐr2   c                óâ  €  \         P                  ! V 4      pTP                  P	                  4        UUu. uF  w  r#TR9  g   K  TNK  	  pppT'       g   R# \         P
                  ! T 4      pT'       g   R# \        P                  ! RT\        P                  4      '       g4   \        P                  ! RT P                   RT P                   R24       R# R#   \         d     R# i ; iu uppi )z{
Identify docstrings that lack a Parameters section when the Python object's signature accepts parameters other than self.
Nz^Parameters:$r9   r:   z' lacks a Parameters section.)ÚselfÚcls)r&   Ú	signatureÚ
ValueErrorÚ
parametersÚitemsr@   rA   ÚsearchrC   r<   r=   r>   r?   )r/   ÚsigÚnÚpÚparamsrG   s   &     r0   Ú%test_docstring_has_parameters_sectionr^   †   sÂ   € ð
Ü×Ò Ó$ˆð  ŸN™N×0Ñ0Ô2ÔOÑ2‘D�A°a¸Ñ6N�aˆaÑ2€FÑOßÙä
�.Š.˜Ó
€CßÙä�9Š9Ð% s¬B¯L©L×9Ò9Ü�ŠØ�—‘Ð˜q ×!1Ñ!1Ð 2Ð2OÐPö	
ñ :øô ô Úðüó Ps   ‚C µC+ÁC+ÃC(Ã'C(c                 ó”  €  \         P                  ! V 4      p\         P                  ! V4      p^ RIpVP	                  V4      pRpRpTP                  T4       FM  p\        YbP                  4      '       d   TP                  e   Rp\        YbP                  4      '       g   KK  RpKO  	  YE3#   \
        \        \        3 d    Ru # i ; i)é    NFT)FF)r&   Ú	getsourceÚcleandocÚastÚparseÚOSErrorÚ	TypeErrorÚSyntaxErrorÚwalkÚ
isinstanceÚReturnÚvalueÚRaise)r/   Úsourcerc   ÚtreeÚhas_returnsÚ
has_raisesÚnodes   &      r0   Úcheck_returns_and_raisesrr   ž   s°   € ðÜ×"Ò" 3Ó'ˆÜ×!Ò! &Ó)ˆÛà�y‰y˜Ó ˆð €KØ€Jà—‘˜–ˆÜ�dŸJ™J×'Ò'¨D¯J©JÒ,BØˆKÜ�dŸI™I×&Ô&ØŠJñ	 ð Ð"Ð"øô ”Y¤Ð,ô ØÒðús   ‚AB, Â,CÃCc                ó2  € \        V 4      w  rV'       g   R# \        P                  ! V 4      pV'       g   R# \        P                  ! RV\        P
                  4      '       g4   \        P                  ! RV P                   RV P                   R24       R# R# )zc
Identify docstrings for Python objects that return something, but lack a Returns section heading.
Nz
^Returns:$r9   r:   z.' returns a value but lacks a Returns section.©
rr   r&   r@   rA   rY   rC   r<   r=   r>   r?   )r/   Úhas_retr%   rG   s   &   r0   Ú"test_docstring_has_returns_sectionrv   ´   sq   € ô
 *¨#Ó.�J€GßÙä
�.Š.˜Ó
€CßÙä�9Š9�] C¬¯©×6Ò6Ü�ŠØ�—‘Ð˜q ×!1Ñ!1Ð 2Ð2`Ðaö	
ñ 7r2   c                ó2  € \        V 4      w  rV'       g   R# \        P                  ! V 4      pV'       g   R# \        P                  ! RV\        P
                  4      '       g4   \        P                  ! RV P                   RV P                   R24       R# R# )za
Identify docstrings for Python objects that raise something, but lack a Raises section heading.
Nz	^Raises:$r9   r:   z1' raises an exception but lacks a Raises section.rt   )r/   r%   Ú	has_raiserG   s   &   r0   Ú!test_docstring_has_raises_sectionry   Ç   sq   € ô
 ,¨CÓ0�L€AßÙä
�.Š.˜Ó
€CßÙä�9Š9�\ 3¬¯©×5Ò5Ü�ŠØ�—‘Ð˜q ×!1Ñ!1Ð 2Ð2cÐdö	
ñ 6r2   c                óž  € \         P                  ! V 4      pV'       g   R# VP                  4       P                  R4      p\	        V4      ^8  g   V^,          P                  4       R8w  d   R# \
        P                  ! RV\
        P                  4      '       g4   \        P                  ! RV P                   RV P                   R24       R# R# )zO
Identify docstrings with both a summary and description, but lack an Example.
NÚ
Ú z^(Example|Examples):$r9   r:   z=' has a summary and description but lacks an Example section.)r&   r@   ÚstripÚsplitÚlenrA   rY   rC   r<   r=   r>   r?   )r/   rG   Úliness   &  r0   Ú#test_docstring_has_examples_sectionr�   Ú   s—   € ô
 �.Š.˜Ó
€CßÙà�I‰I‹K×Ñ˜dÓ#€EÜ
ˆ5ƒz�A„~˜˜q�Ÿ™Ó)¨RÔ/áä�9Š9Ð-¨s´B·L±L×AÒAÜ�ŠØ�—‘Ð˜q ×!1Ñ!1Ð 2Ð2oÐpö	
ñ Br2   >   ÚTipÚHintÚNoter   ÚDangerÚRaisesÚCautionÚExampleÚReturnsÚExamplesÚ	AttentionÚ	ImportantÚ
Attributesr   úSee also)Ú__doc__r&   rA   r<   r(   rD   r;   r1   r6   ÚmarkÚparametrizerJ   rO   rQ   r^   rr   rv   ry   r�   © r2   r0   Ú<module>r“      sƒ  ðñó Û 	ã ã òÐ ð$#Øð#àð#ð ð#ð ð	#ð
 ð#ð ð#ð ð#ð ð#ð ð#ð ð#ð ð#ð ð#ð ð#ð ð#ð ð#ð  ð!#ð" ð##ð$ ð%#ð& ð'#ð( ð)#ð* ð+#ð, ð-#ð. ð/#ð0 ð1#ð2 ð3#ð4 ð5#ð6 ð7#ð8 ð9#ð: ð;#ð< ð=#ð> ð?#ð@ ðA#ðB ðC#ðD ðE#Ð òLòð
 ‡�×Ñ˜Ñ 2Ó 4¸'ÐÓBñ
ó Cð
ò6òð ‡�×Ñ˜Ñ DÓ FÈJÐÓWñ
ó Xð
ò.#ð, ‡�×Ñ˜Ñ DÓ FÈJÐÓWñ
ó Xð
ð$ ‡�×Ñ˜Ñ DÓ FÈJÐÓWñ
ó Xð
ð$ ‡�×Ñ˜Ñ DÓ FÈJÐÓWñ
ó Xò
r2   