{i\1SrSSKJr SSKJrJr SSKJr SSKJ r J r SSK J r SS K Jr S S KJr S S KJrJrJrJr S S KJr \(aSSKr"SS\\\\5r"SS\5rg)zProvide the Comment class.) annotations) TYPE_CHECKINGAny)API_PATH)ClientException InvalidURL)cachedproperty) CommentForest) RedditBase) FullnameMixinInboxableMixinThingModerationMixinUserContentMixin)RedditorNc4^\rSrSrSrSrSr\SSj5r\ SSj5r \ S5r \ SSj5r \ SS j5r\ SS j5r\R SS j5rSSU4S jjjrSU4S jjrSrU4SjrSrSSjrSSjrSrU=r$)CommentatA class that represents a Reddit comment. .. include:: ../../typical_attributes.rst ================= ================================================================= Attribute Description ================= ================================================================= ``author`` Provides an instance of :class:`.Redditor`. ``body`` The body of the comment, as Markdown. ``body_html`` The body of the comment, as HTML. ``created_utc`` Time the comment was created, represented in `Unix Time`_. ``distinguished`` Whether or not the comment is distinguished. ``edited`` Whether or not the comment has been edited. ``id`` The ID of the comment. ``is_submitter`` Whether or not the comment author is also the author of the submission. ``link_id`` The submission ID that the comment belongs to. ``parent_id`` The ID of the parent comment (prefixed with ``t1_``). If it is a top-level comment, this returns the submission ID instead (prefixed with ``t3_``). ``permalink`` A permalink for the comment. :class:`.Comment` objects from the inbox have a ``context`` attribute instead. ``replies`` Provides an instance of :class:`.CommentForest`. ``saved`` Whether or not the comment is saved. ``score`` The number of upvotes for the comment. ``stickied`` Whether or not the comment is stickied. ``submission`` Provides an instance of :class:`.Submission`. The submission that the comment belongs to. ``subreddit`` Provides an instance of :class:`.Subreddit`. The subreddit that the comment belongs to. ``subreddit_id`` The subreddit ID that the comment belongs to. ================= ================================================================= .. _unix time: https://en.wikipedia.org/wiki/Unix_time z6This comment does not appear to be in the comment treeidc[R"U5nURS5n[ U5S- U:wa [ U5eUS$![a [ U5Sef=f)z*Get the ID of a comment from the full URL.commentsN)r _url_partsindex ValueErrorr len)urlparts comment_indexs T/home/james-whalen/.local/lib/python3.13/site-packages/praw/models/reddit/comment.py id_from_urlComment.id_from_urlAsj%%c* ,!KK 3M u:>] *S/ !Ry  ,S/t + ,s A A"c[U5$)zProvide an instance of :class:`.CommentModeration`. Example usage: .. code-block:: python comment = reddit.comment("dkk4qjd") comment.mod.approve() )CommentModerationselfs r#mod Comment.modNs!&&cHURRRS$)zReturn the class's kind.comment)_redditconfigkindsr(s r#_kind Comment._kind\s||""((33r,cURRSS5SnXRRRS:H$)z8Return ``True`` when the comment is a top-level comment._r r submission) parent_idsplitr/r0r1)r) parent_types r#is_rootComment.is_rootas=nn**3215 ll1177 EEEr,c[UR[5(a%[URUR5UlUR$)a@Provide an instance of :class:`.CommentForest`. This property may return an empty list if the comment has not been refreshed with :meth:`.refresh` Sort order and reply limit can be set with the ``reply_sort`` and ``reply_limit`` attributes before replies are fetched, including any call to :meth:`.refresh`: .. code-block:: python comment.reply_sort = "new" comment.refresh() replies = comment.replies .. note:: The appropriate values for ``reply_sort`` include ``"confidence"``, ``"controversial"``, ``"new"``, ``"old"``, ``"q&a"``, and ``"top"``. ) isinstance_replieslistr r6r(s r#repliesComment.repliesgs5. dmmT * *)$//4==IDM}}r,cUR(d.URRUR55UlUR$)z?Return the :class:`.Submission` object this comment belongs to.) _submissionr/r6_extract_submission_idr(s r#r6Comment.submissions9#||66t7R7R7TUD r,ctXRUR'Xl[US/5H nXlM g)zFUpdate the :class:`.Submission` associated with the :class:`.Comment`.r@N)_comments_by_idfullnamerCgetattrr6)r)r6replys r#r6rEs559""4==1%T9b1E) 2r,c>X#U4RS5S:wa Sn[U5eSn/UlSUlU(aX lO U(aUR U5UlOSn[ TU]XUS9 g)z(Initialize a :class:`.Comment` instance.Nr z8Exactly one of 'id', 'url', or '_data' must be provided.FT)_data_fetched)count TypeErrorr>rCrr$super__init__)r)redditrr rLmsgfetched __class__s r#rQComment.__init__st U  ! !$ '1 ,LCC.   G &&s+DGG w?r,c8>US:Xa"[R"URU5nObUS:Xa;US:Xa/nO/URRR U5R nSnO!US:XaURR U5n[TU]!X5 g)z)Objectify author, replies, and subreddit.authorr@r> subredditN) r from_datar/ _objector objectifychildrenrZrP __setattr__)r) attributevaluerUs r#r_Comment.__setattr__s  &&t||U;E ) #{ ..88?HH"I + %LL**51E I-r,cSUR;aURRSS5S$URR SS5S$)Ncontext/rr r5)__dict__rdrsplitlink_idr8r(s r#rDComment._extract_submission_idsF  %<<&&sA.q1 1||!!#q)!,,r,c(>UR5nUSnUS(dSUR3n[U5eUSSSn[U5"URUS9nUR R UR 5 [TU]!5 g)Ndatar^zNo data returned for comment r)rL) _fetch_datarHrtyper/rfupdaterP_fetch)r)rkrS comment_dataotherrUs r#roComment._fetchs!F|J1$--AC!#& &J'*62 T 4<<|< U^^, r,c$S0SUR04$)Ninfor)rHr(s r# _fetch_infoComment._fetch_infosrD$--000r,c|URURR:Xa UR$URURR;a#URRUR$[ UR URR SS5S5nURUlU$)aReturn the parent of the comment. The returned parent will be an instance of either :class:`.Comment`, or :class:`.Submission`. If this comment was obtained through a :class:`.Submission`, then its entire ancestry should be immediately available, requiring no extra network requests. However, if this comment was obtained through other means, e.g., ``reddit.comment("COMMENT_ID")``, or ``reddit.inbox.comment_replies``, then the returned parent may be a lazy instance of either :class:`.Comment`, or :class:`.Submission`. Lazy comment example: .. code-block:: python comment = reddit.comment("cklhv0f") parent = comment.parent() # 'replies' is empty until the comment is refreshed print(parent.replies) # Output: [] parent.refresh() print(parent.replies) # Output is at least: [Comment(id="cklhv0f")] .. warning:: Successive calls to :meth:`.parent` may result in a network request per call when the comment is not obtained through a :class:`.Submission`. See below for an example of how to minimize requests. If you have a deeply nested comment and wish to most efficiently discover its top-most :class:`.Comment` ancestor you can chain successive calls to :meth:`.parent` with calls to :meth:`.refresh` at every 9 levels. For example: .. code-block:: python comment = reddit.comment("dkk4qjd") ancestor = comment refresh_counter = 0 while not ancestor.is_root: ancestor = ancestor.parent() if refresh_counter % 9 == 0: ancestor.refresh() refresh_counter += 1 print(f"Top-most Ancestor: {ancestor}") The above code should result in 5 network requests to Reddit. Without the calls to :meth:`.refresh` it would make at least 31 network requests. r5r )r7r6rHrGrr/r8rC)r)parents r#rxComment.parentsh >>T__55 5?? " >>T__<< <??224>>B Bt~~';';C'CA'FG!__ r,cSUR;a URRSS5SnO;[SR UR R S9nUSUR 3nSS0nS UR;aURUS 'S UR;aURUS 'URRXS 9SRnU(d[UR5eSnUSSnU(aUbUR UR :wahUR5n[U[ 5(aUR#UR$5 U(a!UcMLUR UR :waMhUR UR :wa[UR5eUR&b URS URR)UR5 UHnUR UlM U$)zRefresh the comment's attributes. If using :meth:`.Reddit.comment` this method must be called in order to obtain the comment's replies. Example usage: .. code-block:: python comment = reddit.comment("dkk4qjd") comment.refresh() rd?r rr6)rz_/d reply_limitlimit reply_sortsort)paramsNrC)rfrdr8rformatr6rr}rr/getr^rMISSING_COMMENT_MESSAGEpopr=rextendr>rCrn)r) comment_pathpathr comment_listr.queuerJs r#refreshComment.refresh s  %<<--c15a8LL)00DOO4F4F0GD"V2dggY/LS! DMM )"..F7O 4== (!__F6N||'' 'DQGPP !$">">? ?QGJJ$'',AiikG'7++ W--.GJJ$'',A :: !$">">? ?    '  / W--.!E#E " r,)r>rCr)r strreturnr)rz,praw.models.reddit.comment.CommentModeration)rbool)rr )rpraw.models.Submission)r6r)NNN)rRz praw.Redditr str | Noner rrLzdict[str, Any] | None)r`rraz6str | Redditor | CommentForest | praw.models.Subreddit)rz Comment | praw.models.Submission)rr)__name__ __module__ __qualname____firstlineno____doc__r STR_FIELD staticmethodr$r r*propertyr2r:r@r6setterrQr_rDrorurxr__static_attributes__ __classcell__)rUs@r#rrs)#JWI   ' '44FF 4  **'+ @@ @ @ % @@,..F.$- 1= )=~//r,rc,\rSrSrSrSrSSjrSrSrg) r'i?zProvide a set of functions pertaining to :class:`.Comment` moderation. Example usage: .. code-block:: python comment = reddit.comment("dkk4qjd") comment.mod.approve() removal_comment_messagecXlg)z^Initialize a :class:`.CommentModeration` instance. :param comment: The comment to moderate. Nthing)r)r.s r#rQCommentModeration.__init__Ms  r,c[SnURRRUSURR0S9 g)zUncollapse a :class:`.Comment` that has been collapsed by Crowd Control. Example usage: .. code-block:: python # Uncollapse a comment: comment = reddit.comment("dkk4qjd") comment.mod.show() show_commentr)rkN)rrr/postrH)r)r s r#showCommentModeration.showUs:~& 41D1D*EFr,rN)r.zpraw.models.Comment) rrrrrREMOVAL_MESSAGE_APIrQrrr,r#r'r'?s 4Gr,r')r __future__rtypingrrconstr exceptionsrr util.cacher comment_forestr basermixinsrrrrredditorr praw.modelsprawrr'rr,r#rsW "%5(* dn. zdN $G,$Gr,