{i~SrSSKJr SSKJrJr SSKJr SSKJ r SSK J r SS K J r \(aSS Kr"S S 5rg ) z.Provide CommentForest for submission comments.) annotations)heappopheappush) TYPE_CHECKING)DuplicateReplaceException)_deprecate_args) MoreCommentsNc\rSrSrSrSSjrSSjrSSjrSSjr\ SS.SS jj5r SSS jjr SS jr \ "S S 5SSS.SSjj5rSrg) CommentForestzqA forest of comments starts with multiple top-level comments. Each of these comments can be a tree of replies. c URU$)a{Return the comment at position ``index`` in the list. This method is to be used like an array access, such as: .. code-block:: python first_comment = submission.comments[0] Alternatively, the presence of this method enables one to iterate over all top level comments, like so: .. code-block:: python for comment in submission.comments: print(comment.body) ) _comments)selfindexs T/home/james-whalen/.local/lib/python3.13/site-packages/praw/models/comment_forest.py __getitem__CommentForest.__getitem__s$~~e$$c,[UR5$)z6Return the number of top-level comments in the forest.)lenr)rs r__len__CommentForest.__len__+s4>>""rcURURR;a[eURUl[ U[ 5(dUR(aURRU5 gURURR;dS5eURRURnURRRU5 g)NzYPRAW Error occurred. Please file a bug report and include the code that caused the error.) name _submission_comments_by_idr submission isinstancer is_rootrappend parent_idreplies)rcommentparents r_insert_commentCommentForest._insert_comment/s <<4++;; ;+ +!-- g| , , NN ! !' *$$(8(8(H(HH * H%%55g6G6GHF NN $ $ + +G 4rc/n[U5nU(a[URS5nURU5 [U[5(dUR UR 5 U(aM[U$)zReturn a flattened list of all comments. This list may contain :class:`.MoreComments` instances if :meth:`.replace_more` was not called first. r)listpopr"r r extendr$)rcommentsqueuer%s rr*CommentForest.list=sYT iilG OOG $g|44 W__- e rN parent_treect/nUVs/sHnSU4PM nnU(aURS5upV[U[5(a?[X&5 U(aURR UlO6U=(d UUlO%URHnURXg45 M U(aMU$s snf)zCReturn a list of :class:`.MoreComments` objects obtained from tree.Nr)r+r r rr$r _remove_fromr")treer1 more_commentsxr.r&r%items r_gather_more_comments#CommentForest._gather_more_commentsOs $()Dq$D)#iilOF'<000+1>>+C+CG(+6+>$G(#OODLL'1,e*sB5cX lXlg)zInitialize a :class:`.CommentForest` instance. :param submission: An instance of :class:`.Submission` that is the parent of the comments. :param comments: Initialize the forest with a list of comments (default: ``None``). Nrr)rrr-s r__init__CommentForest.__init__es"%rcDXlUHnURUlM gN)rrr)rr-r%s r_updateCommentForest._updateus!G!%!1!1G  rlimit threshold r)rBrCcUnURUR5n/nU(a[U5nUbUS::dURU:a.UR U5 UR R U5 MYURSS9nUbUS-nURXpRS9HnURUl [XH5 M! UHn URU 5 M UR R U5 U(aMXE-$)a=Update the comment forest by resolving instances of :class:`.MoreComments`. :param limit: The maximum number of :class:`.MoreComments` instances to replace. Each replacement requires 1 API request. Set to ``None`` to have no limit, or to ``0`` to remove all :class:`.MoreComments` instances without additional requests (default: ``32``). :param threshold: The minimum number of children comments a :class:`.MoreComments` instance must have in order to be replaced. :class:`.MoreComments` instances that represent "continue this thread" links unfortunately appear to have 0 children (default: ``0``). :returns: A list of :class:`.MoreComments` instances that were not replaced. :raises: ``prawcore.TooManyRequests`` when used concurrently. For example, to replace up to 32 :class:`.MoreComments` instances of a submission try: .. code-block:: python submission = reddit.submission("3hahrw") submission.comments.replace_more() Alternatively, to replace :class:`.MoreComments` instances within the replies of a single comment try: .. code-block:: python comment = reddit.comment("d8r4im1") comment.refresh() comment.replies.replace_more() .. note:: This method can take a long time as each replacement will discover at most 100 new :class:`.Comment` instances. As a result, consider looping and handling exceptions until the method returns successfully. For example: .. code-block:: python while True: try: submission.comments.replace_more() break except PossibleExceptions: print("Handling replace_more exception") sleep(1) .. warning:: If this method is called, and the comments are refreshed, calling this method again will result in a :class:`.DuplicateReplaceException`. rF)updater r0) r8rrcountr"r3remover-rrrr') rrBrC remainingr5skippedr7 new_commentsmorer%s r replace_moreCommentForest.replace_morezst 224>>B =)D$a4:: ;Qt$!!((.===6L$Q 22..3#'"2"2-  ($$W-(    $ $T *-m0&&rr;)rintreturnpraw.models.Comment)rPrO)r%rQ)rPz4list[praw.models.Comment | praw.models.MoreComments])r4list[praw.models.MoreComments]r1z%list[praw.models.MoreComments] | NonerPzlist[MoreComments]r?)rzpraw.models.Submissionr-z list[praw.models.Comment] | None)r-zlist[praw.models.Comment])rBz int | NonerCrOrPrR)__name__ __module__ __qualname____firstlineno____doc__rrr'r* staticmethodr8r<r@r rM__static_attributes__rrr r s %(# 5 =$>B,;  06:&*&3& 2 Wk*%'!V'"V'47V' 'V'+V'rr )rW __future__rheapqrrtypingr exceptionsrutilr reddit.morer praw.modelsprawr rZrrrcs,4"# 2"%A'A'r