Fj;!dZddlmZddlmZmZddlmZddlm Z ddl m Z ddl m Z er ddlmZdd lmZGd d Zy ) zProvide the Modmail class.) annotations) TYPE_CHECKINGAny)API_PATH)ListingGenerator) RedditBase)ModmailConversation)Iterator)modelsceZdZdZdddddZddZddZddd dd Zdddd  dd Zdd  dd Z ddZ ddZ y)Modmaila@Provides modmail functions for a :class:`.Subreddit`. For example, to send a new modmail from r/test to u/spez with the subject ``"test"`` along with a message body of ``"hello"``: .. code-block:: python reddit.subreddit("test").modmail.create(subject="test", body="hello", recipient="spez") NF) mark_readcFt|jj||S)aReturn an individual conversation. :param id: A reddit base36 conversation ID, e.g., ``"2gmz"``. :param mark_read: If ``True``, conversation is marked as read (default: ``False``). For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz", mark_read=True) To print all messages from a conversation as Markdown source: .. code-block:: python conversation = reddit.subreddit("test").modmail("2gmz", mark_read=True) for message in conversation.messages: print(message.body_markdown) ``ModmailConversation.user`` is a special instance of :class:`.Redditor` with extra attributes describing the non-moderator user's recent posts, comments, and modmail messages within the subreddit, as well as information on active bans and mutes. This attribute does not exist on internal moderator discussions. For example, to print the user's ban status: .. code-block:: python conversation = reddit.subreddit("test").modmail("2gmz", mark_read=True) print(conversation.user.ban_status) To print a list of recent submissions by the user: .. code-block:: python conversation = reddit.subreddit("test").modmail("2gmz", mark_read=True) print(conversation.user.recent_posts) )idr)r subreddit_reddit)selfrrs b/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/reddit/subreddit/modmail.py__call__zModmail.__call__sR#4>>#9#9bIVVc||_y)z(Initialize a :class:`.Modmail` instance.N)r)rrs r__init__zModmail.__init__Is "rcZ|jg|xsgz}djd|DS)z9Return a comma-separated list of subreddit display names.,c32K|]}t|ywN)str).0rs r z0Modmail._build_subreddit_list..PsC9ICs)rjoin)rother_subreddits subredditss r_build_subreddit_listzModmail._build_subreddit_listMs.nn%)9)?R@ xxC CCCr)r!statecd|j|i}|r||d<|jjjtd|}|dDcgc] }|| c}Scc}w)a%Mark conversations for subreddit(s) as read. .. note:: Due to server-side restrictions, r/all is not a valid subreddit for this method. Instead, use :meth:`~.Modmail.subreddits` to get a list of subreddits using the new modmail. :param other_subreddits: A list of :class:`.Subreddit` instances for which to mark conversations (default: ``None``). :param state: Can be one of: ``"all"``, ``"archived"``, or ``"highlighted"``, ``"inprogress"``, ``"join_requests"``, ``"mod"``, ``"new"``, ``"notifications"``, or ``"appeals"`` (default: ``"all"``). ``"all"`` does not include internal, archived, or appeals conversations. :returns: A list of :class:`.ModmailConversation` instances that were marked read. For example, to mark all notifications for a subreddit as read: .. code-block:: python subreddit = reddit.subreddit("test") subreddit.modmail.bulk_read(state="notifications") entityr$modmail_bulk_read)paramsconversation_ids)r#rrpostr)rr!r$r(responseconversation_ids r bulk_readzModmail.bulk_readRsl@)1$2L2LM]2^'_ #F7O>>))..x8K/LU[.\=EFX=YZ/_%ZZZsA")r!sortr$c i}|jdk7r|j||d<tjd|d||d|t |jj t dfi|S)aGenerate :class:`.ModmailConversation` objects for subreddit(s). :param other_subreddits: A list of :class:`.Subreddit` instances for which to fetch conversations (default: ``None``). :param sort: Can be one of: ``"mod"``, ``"recent"``, ``"unread"``, or ``"user"`` (default: ``"recent"``). :param state: Can be one of: ``"all"``, ``"archived"``, ``"highlighted"``, ``"inprogress"``, ``"join_requests"``, ``"mod"``, ``"new"``, ``"notifications"``, or ``"appeals"`` (default: ``"all"``). ``"all"`` does not include internal, archived, or appeals conversations. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. For example: .. code-block:: python conversations = reddit.subreddit("all").modmail.conversations(state="mod") allr&r() argumentskeyr.r$modmail_conversations)rr#r_safely_add_argumentsrrr)rr!r.r$generator_kwargsr(s r conversationszModmail.conversationsxsx: >>U "#99:JKF8 ((t3CX\ditmst NN " " , -   r) author_hiddenc|||j||d}|jjjtd|S)aCreate a new :class:`.ModmailConversation`. :param author_hidden: When ``True``, author is hidden from non-moderators (default: ``False``). :param body: The message body. Cannot be empty. :param recipient: The recipient; a username or an instance of :class:`.Redditor`. :param subject: The message subject. Cannot be empty. :returns: A :class:`.ModmailConversation` object for the newly created conversation. .. code-block:: python subreddit = reddit.subreddit("test") redditor = reddit.redditor("bboe") subreddit.modmail.create(subject="Subject", body="Body", recipient=redditor) )bodyisAuthorHiddensrNamesubjecttor3)data)rrr*r)rr8r: recipientr=r?s rcreatezModmail.createsG8+nn  ~~%%**84K+LSW*XXrc#K|jjjtd}|dj D]8}|jjj|d}|d|_|:yw)zYield subreddits using the new modmail that the user moderates. For example: .. code-block:: python subreddits = reddit.subreddit("all").modmail.subreddits() modmail_subredditsr" display_name lastUpdatedN)rrgetrvalues last_updated)rr+valuers rr"zModmail.subredditssv>>))--h7K.LMl+224 E..88~9NOI%*=%9I "O sAcZ|jjjtdS)aSReturn unread conversation count by conversation state. At time of writing, possible states are: ``"archived"``, ``"highlighted"``, ``"inprogress"``, ``"join_requests"``, ``"mod"``, ``"new"``, ``"notifications"``, or ``"appeals"``. :returns: A dict mapping conversation states to unread counts. For example, to print the count of unread moderator discussions: .. code-block:: python subreddit = reddit.subreddit("test") unread_counts = subreddit.modmail.unread_count() print(unread_counts["mod"]) modmail_unread_count)rrrFr)rs r unread_countzModmail.unread_counts%$~~%%))(3I*JKKrr)r str | Nonerboolreturnr )rzmodels.SubredditrONone)r!#list[models.Subreddit | str] | NonerOr)r!rQr$rMrOzlist[ModmailConversation]) r!rQr.rMr$rMr6rrOzIterator[ModmailConversation]) r8rNr:rr@zstr | models.Redditorr=rrOr )rOzIterator[models.Subreddit])rOzdict[str, int]) __name__ __module__ __qualname____doc__rrr#r-r7rAr"rLr4rrr r s )W5)WV#DAE $[>$[ $[ # $[RAE % >%  %  %  %  '% T$"Y"Y "Y ) "Y  "Y "YH Lrr N)rU __future__rtypingrr praw.constrpraw.models.listing.generatorrpraw.models.reddit.baserpraw.models.reddit.modmailr collections.abcr prawr r r4rrr^s1 "%:.:(SLSLr