*hSrSSKJr SSKrSSKJrJr SSKJ r \(aSSK J r J r SSK Jr SSKJr SS KJr "S S 5r"S S \ 5rg)z?Collection providing access to comments added to this document.) annotationsN) TYPE_CHECKINGIterator)BlockItemContainer) CT_Comment CT_Comments) CommentsPart)ParagraphStyle) ParagraphcN\rSrSrSrS SjrS SjrS SjrS SSjjrSSjr Sr g )Commentsz:Collection containing the comments added to this document.cXlX lgN _comments_elm_comments_part)self comments_elm comments_parts J/home/mande/repo/quber/.venv/lib/python3.13/site-packages/docx/comments.py__init__Comments.__init__s)+cD^U4SjTRR5$)z.Iterator over the comments in this collection.c3P># UHn[UTR5v M g7fr)Commentr).0 comment_elmrs r $Comments.__iter__..s( =  K!4!4 5 5=s#&)r comment_lstrs`r__iter__Comments.__iter__s! #11==  rc@[URR5$)z*The number of comments in this collection.)lenrr"r#s r__len__Comments.__len__s4%%1122rcURR5nX$lX4l[R R [RR5Ul [X@R5nUS:XaU$[URS55n[U5nURSnUR!U5 UHn UR#U S9 M U$)a:Add a new comment to the document and return it. The comment is added to the end of the comments collection and is assigned a unique comment-id. If `text` is provided, it is added to the comment. This option provides for the common case where a comment contains a modest passage of plain text. Multiple paragraphs can be added using the `text` argument by separating their text with newlines (`"\\n"`). Between newlines, text is interpreted as it is in `Document.add_paragraph(text=...)`. The default is to place a single empty paragraph in the comment, which is the same behavior as the Word UI when you add a comment. New runs can be added to the first paragraph in the empty comment with `comments.paragraphs[0].add_run()` to adding more complex text with emphasis or images. Additional paragraphs can be added using `.add_paragraph()`. `author` is a required attribute, set to the empty string by default. `initials` is an optional attribute, set to the empty string by default. Passing |None| for the `initials` parameter causes that attribute to be omitted from the XML.  rtext)r add_commentauthorinitialsdtdatetimenowtimezoneutcdaterritersplitnext paragraphsadd_run add_paragraph) rr.r0r1rcommentpara_text_iterfirst_para_text first_parass rr/Comments.add_comment#s,((446 #';;??2;;??; +':':; 2:Ndjj./~.''* ?+A  ! !q ! ) rclURRU5nUb[X R5$S$)zFReturn the comment identified by `comment_id`, or |None| if not found.N)rget_comment_by_idrr)r comment_idrs rget Comments.getMs4((:::F [TU]X5 Xlgr)superr _comment_elm)rrr __class__s rrComment.__init__as 4'rcN>[TU]X5nUcSURlU$)a!Return paragraph newly added to the end of the content in this container. The paragraph has `text` in a single run if present, and is given paragraph style `style`. When `style` is |None| or ommitted, the "CommentText" paragraph style is applied, which is the default style for comments. CommentText)rXr=_pstyle)rr.r_ paragraphrZs rr=Comment.add_paragraphes-G)$6  =!.ILL rc.URR$)zmRead/write. The recorded author of this comment. This field is required but can be set to the empty string. rYr0r#s rr0Comment.authorus   '''rc$XRlgrrcrvalues rr0rd}s#( rc.URR$)z&The unique identifier of this comment.)rYidr#s rrFComment.comment_ids  ###rc.URR$)zRead/write. The recorded initials of the comment author. This attribute is optional in the XML, returns |None| if not set. Assigning |None| removes any existing initials from the XML. rYr1r#s rr1Comment.initialss  )))rc$XRlgrrlrfs rr1rms%*"rcFSRSUR55$)zThe text content of this comment as a string. Only content in paragraphs is included and of course all emphasis and styling is stripped. Paragraph boundaries are indicated with a newline (`"\\n"`) r,c38# UHoRv M g7frr-)rps rr Comment.text..s9As)joinr;r#s rr. Comment.textsyy9999rc.URR$)zpThe date and time this comment was authored. This attribute is optional in the XML, returns |None| if not set. )rYr7r#s r timestampComment.timestamps   %%%r)rY)rrrr )r+N)r.rLr_zstr | ParagraphStyle | NonerIr )rIrL)rgrLrJ)rIrM)rgrM)rIzdt.datetime | None)rNrOrPrQrRrr=propertyr0setterrFr1r.rvrS __classcell__)rZs@rrrSs ( (( ]]))$$**__++::&&rr)rR __future__rr3r2typingrr docx.blkcntnrrdocx.oxml.commentsrrdocx.parts.commentsr docx.styles.styler docx.text.paragraphr r rrTrrrs?E"*,:00-?^?^DP& P&r