{iT+ SrSSKJr SSKJr SSKJrJr SSKJ r SSK J r SS K J r SS KJr SS KJr SS KJr SS KJr SSKJr SSKJr SSKJr SSKJr SSKJr SSK J!r! \(aSSK"r#"SS\5r$"SS\ \\\\\\!5 r%g)z&Package providing reddit class mixins.) annotations)dumps) TYPE_CHECKINGOptional)API_PATH)_deprecate_args) EditableMixin) FullnameMixin) GildableMixin)InboxableMixin)InboxToggleableMixin)MessageableMixin) ModNoteMixin)ReplyableMixin)ReportableMixin) SavableMixin) VotableMixinNc\rSrSrSrSrSSS.S SjjrS r\"S S 5S S S.S!Sjj5r Sr Sr \"SSS5SS SS.S"Sjj5r \"SSS5SSS.S#Sjj5r SrSrSrSrg)$ThingModerationMixinzQProvides moderation methods for :class:`.Comment`\ s and :class:`.Submission`\ s.Nmod_note reason_idrrcU(dU(d Sn[U5eURR/UUS.nURRR [ SS[ U50S9 g)aIAdd a removal reason for a :class:`.Comment` or :class:`.Submission`. :param mod_note: A message for the other moderators. :param reason_id: The removal reason ID. It is necessary to first call :meth:`.remove` on the :class:`.Comment` or :class:`.Submission`. If ``reason_id`` is not specified, ``mod_note`` cannot be blank. z6mod_note cannot be blank if reason_id is not specified)item_idsrrremoval_reasonsjsondataN) ValueErrorthingfullname_redditpostrr)selfrrmsgr"s \/home/james-whalen/.local/lib/python3.13/site-packages/praw/models/reddit/mixins/__init__.py_add_removal_reason(ThingModerationMixin._add_removal_reasonsfJCS/ !,,- "  ): ;65QU;BWXcURRR[SSURR0S9 g)a Approve a :class:`.Comment` or :class:`.Submission`. Approving a comment or submission reverts a removal, resets the report counter, adds a green check mark indicator (only visible to other moderators) on the website view, and sets the ``approved_by`` attribute to the authenticated user. Example usage: .. code-block:: python # approve a comment: comment = reddit.comment("dkk4qjd") comment.mod.approve() # approve a submission: submission = reddit.submission("5or86n") submission.mod.approve() approveidr!Nr$r&r'rr%r(s r*r/ThingModerationMixin.approve6s5&  34ATAT:UVr-howstickyyesF)r4r5cXRRS.nU(a![URSS5(aSUS'URRR [ SUS9 g) aZDistinguish a :class:`.Comment` or :class:`.Submission`. :param how: One of ``"yes"``, ``"no"``, ``"admin"``, or ``"special"``. ``"yes"`` adds a moderator level distinguish. ``"no"`` removes any distinction. ``"admin"`` and ``"special"`` require special user privileges to use (default ``"yes"``). :param sticky: :class:`.Comment` is stickied if ``True``, placing it at the top of the comment page regardless of score. If thing is not a top-level comment, this parameter is silently ignored (default ``False``). Example usage: .. code-block:: python # distinguish and sticky a comment: comment = reddit.comment("dkk4qjd") comment.mod.distinguish(sticky=True) # undistinguish a submission: submission = reddit.submission("5or86n") submission.mod.distinguish(how="no") .. seealso:: :meth:`.undistinguish` )r4r0is_rootFTr5 distinguishr!N)r$r%getattrr&r'r)r(r4r5r"s r*r9 ThingModerationMixin.distinguishKsV8**"5"56 gdjj)U;;!DN  7dCr-cURRR[SSURR0S9 g)aIgnore future reports on a :class:`.Comment` or :class:`.Submission`. Calling this method will prevent future reports on this :class:`.Comment` or :class:`.Submission` from both triggering notifications and appearing in the various moderation listings. The report count will still increment on the :class:`.Comment` or :class:`.Submission`. Example usage: .. code-block:: python # ignore future reports on a comment: comment = reddit.comment("dkk4qjd") comment.mod.ignore_reports() # ignore future reports on a submission: submission = reddit.submission("5or86n") submission.mod.ignore_reports() .. seealso:: :meth:`.unignore_reports` ignore_reportsr0r!Nr1r2s r*r=#ThingModerationMixin.ignore_reportsls;0  % &dDJJ4G4G-H  r-cURRR[SSURR0S9 g)a4Lock a :class:`.Comment` or :class:`.Submission`. Example usage: .. code-block:: python # lock a comment: comment = reddit.comment("dkk4qjd") comment.mod.lock() # lock a submission: submission = reddit.submission("5or86n") submission.mod.lock() .. seealso:: :meth:`.unlock` lockr0r!Nr1r2s r*r@ThingModerationMixin.locks5&  0djj>Q>Q7RSr-spam)rrBrcURR[U5S.nURRR [ SUS9 [ X1/5(aURXS9 gg)aHRemove a :class:`.Comment` or :class:`.Submission`. :param mod_note: A message for the other moderators. :param spam: When ``True``, use the removal to help train the :class:`.Subreddit`'s spam filter (default: ``False``). :param reason_id: The removal reason ID. If either ``reason_id`` or ``mod_note`` are provided, a second API call is made to add the removal reason. Example usage: .. code-block:: python # remove a comment and mark as spam: comment = reddit.comment("dkk4qjd") comment.mod.remove(spam=True) # remove a submission submission = reddit.submission("5or86n") submission.mod.remove() # remove a submission with a removal reason reason = reddit.subreddit.mod.removal_reasons["110ni21zo23ql"] submission = reddit.submission("5or86n") submission.mod.remove(reason_id=reason.id) )r0rBremover!rN)r$r%boolr&r'ranyr+)r(rrBrr"s r*rDThingModerationMixin.removesb<jj))4:>  2>  $ % %  $ $h $ L &r-messagetitletypeignoredpublic)rIrJcURc Sn[U5e[URnURR/UUUS.nURR R US[U50S9=(d S$)acSend a removal message for a :class:`.Comment` or :class:`.Submission`. .. warning:: The object has to be removed before giving it a removal reason. Remove the object with :meth:`.remove`. Trying to add a removal reason without removing the object will result in :class:`.RedditAPIException` being thrown with an ``INVALID_ID`` error_type. Reddit adds human-readable information about the object to the message. :param type: One of ``"public"``, ``"public_as_subreddit"``, ``"private"``, or ``"private_exposed"``. ``"public"`` leaves a stickied comment on the post. ``"public_as_subreddit"`` leaves a stickied comment on the post with the u/subreddit-ModTeam account. ``"private"`` sends a modmail message with hidden username. ``"private_exposed"`` sends a modmail message without hidden username (default: ``"public"``). :param title: The short reason given in the message. Ignored if type is ``"public"`` or ``"public_as_subreddit"``. :param message: The body of the message. :returns: The new :class:`.Comment` if ``type`` is ``"public"`` or ``"public_as_subreddit"``. Nz&ThingModerationMixin must be extended.)item_idrHrIrJr r!)REMOVAL_MESSAGE_APINotImplementedErrorrr$r%r&r'r)r(rHrIrJr)urlr"s r*send_removal_message)ThingModerationMixin.send_removal_messagesF  # # +:C%c* *t//0 ++,  zz!!&&s&%+1F&GO4Or-c"URSS9 g)aRemove mod, admin, or special distinguishing from an object. Also unstickies the object if applicable. Example usage: .. code-block:: python # undistinguish a comment: comment = reddit.comment("dkk4qjd") comment.mod.undistinguish() # undistinguish a submission: submission = reddit.submission("5or86n") submission.mod.undistinguish() .. seealso:: :meth:`.distinguish` no)r4N)r9r2s r* undistinguish"ThingModerationMixin.undistinguishs* T"r-cURRR[SSURR0S9 g)a%Resume receiving future reports on a :class:`.Comment` or :class:`.Submission`. Future reports on this :class:`.Comment` or :class:`.Submission` will cause notifications, and appear in the various moderation listings. Example usage: .. code-block:: python # accept future reports on a comment: comment = reddit.comment("dkk4qjd") comment.mod.unignore_reports() # accept future reports on a submission: submission = reddit.submission("5or86n") submission.mod.unignore_reports() .. seealso:: :meth:`.ignore_reports` unignore_reportsr0r!Nr1r2s r*rY%ThingModerationMixin.unignore_reports s;,  ' (djj6I6I/J  r-cURRR[SSURR0S9 g)a<Unlock a :class:`.Comment` or :class:`.Submission`. Example usage: .. code-block:: python # unlock a comment: comment = reddit.comment("dkk4qjd") comment.mod.unlock() # unlock a submission: submission = reddit.submission("5or86n") submission.mod.unlock() .. seealso:: :meth:`.lock` unlockr0r!Nr1r2s r*r\ThingModerationMixin.unlock#s5&  2$ @S@S9TUr-)rstrr str | None)r4r_r5rE)rr_rBrErr`)rHr_rIr_rJr_returnzpraw.models.Comment | None)__name__ __module__ __qualname____firstlineno____doc__rOr+r/r r9r=r@rDrRrVrYr\__static_attributes__r^r-r*rrs\57QUY.W*UH%(-eD&D@ 8T*VZ5!#%QU M M+/ MDN M6 MDY0  /P/P /P  /P $ /P1/Pb#. 4Vr-rc\rSrSrSrSrg)UserContentMixini9zBA convenience mixin that applies to both Comments and Submissions.r^N)rbrcrdrerfrgr^r-r*riri9sMr-ri)&rf __future__rr rtypingrrconstrutilr editabler r%r gildabler inboxablerinboxtoggleabler messageablermodnoter replyabler reportablersavablervotabler praw.modelsprawrrir^r-r*rzsp,"*$###%1)!%'!!\V<\V~ M Mr-