Fj00dZddlmZddlmZmZddlmZddlm Z ddl m Z erddl Z Gdd e Z Gd d e ZGd d eZGddeZy)zProvide models for new modmail.) annotations) TYPE_CHECKINGAny)API_PATH) RedditBase)snake_case_keysNc eZdZdZdZdZeddZeddZe ddZ dddd  dfd Z dd Z dfd Z d d ZddZddZedd!dZddd"dZdddd#dZddZddZddZddd"dZxZS)$ModmailConversationaA class for modmail conversations. .. include:: ../../typical_attributes.rst ==================== =============================================================== Attribute Description ==================== =============================================================== ``authors`` Provides an ordered list of :class:`.Redditor` instances. The authors of each message in the modmail conversation. ``id`` The ID of the :class:`.ModmailConversation`. ``is_highlighted`` Whether or not the :class:`.ModmailConversation` is highlighted. ``is_internal`` Whether or not the :class:`.ModmailConversation` is a private mod conversation. ``last_mod_update`` Time of the last mod message reply, represented in the `ISO 8601`_ standard with timezone. ``last_updated`` Time of the last message reply, represented in the `ISO 8601`_ standard with timezone. ``last_user_update`` Time of the last user message reply, represented in the `ISO 8601`_ standard with timezone. ``num_messages`` The number of messages in the :class:`.ModmailConversation`. ``obj_ids`` Provides a list of dictionaries representing mod actions on the :class:`.ModmailConversation`. Each dict contains attributes of ``"key"`` and ``"id"``. The key can be either ``""messages"`` or ``"ModAction"``. ``"ModAction"`` represents archiving/highlighting etc. ``owner`` Provides an instance of :class:`.Subreddit`. The subreddit that the :class:`.ModmailConversation` belongs to. ``participant`` Provides an instance of :class:`.Redditor`. The participating user in the :class:`.ModmailConversation`. ``subject`` The subject of the :class:`.ModmailConversation`. ==================== =============================================================== .. _iso 8601: https://en.wikipedia.org/wiki/ISO_8601 idcggd}|dD]@}|d}|||d}||j|jj|B|j|y)z1Convert messages and mod actions to PRAW objects.)messages modActionsobjIdskeyr dataN)append _objector objectifyupdate)rredditresultthingr thing_datas X/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/reddit/modmail.py_convert_conversation_objectsz1ModmailConversation._convert_conversation_objects8sr!3(^ LE,Cc5;/J 3K  v//99z9J K L Fc |jj|jjdt|jj|jjdd}|j D]\}}g}||j D]c\}}|||j ddd}|tur|d=|j D]\} } t|| | |j|et|d d ||<y ) zz;ModmailConversation._convert_user_summary..Tss144b7IrT)rreverseN) rparsersconfigkindsr itemsrsplitsetattrrsorted) rrr1kindparserobjectsthing_idsummaryrrvalues r_convert_user_summaryz)ModmailConversation._convert_user_summaryBs %..66v}}7J7J97UV/!++33FMM4G4G 4UV  $MMO YLD&G%)$Z%5%5%7 &!'v(//#q*A"*EF!44 ,")--//JCE3./u%  & -ISWXDJ Yrcx|dDcgc]}|jj| c}|d<dD]$}|jj||||<&|jdr7|j|d||jj|d|d<t |}|||Scc}w)zReturn an instance of :class:`.ModmailConversation` from ``data``. :param data: The structured data. :param reddit: An instance of :class:`.Reddit`. authorsr)owner participantuser_data)rrgetr>r)clsrrauthorentitys rparsezModmailConversation.parseVsRVV_Q`av6++5565BaY, IF!++554<5HDL I 88F   % %d6lF ;!++554<5HDLt$6&&bs#B7NF)rE mark_readct|t|k(r d}t||r||_t||||r ddi|_yd|_y)zInitialize a :class:`.ModmailConversation` instance. :param mark_read: If ``True``, conversation is marked as read (default: ``False``). z(Either 'id' or '_data' must be provided.rDmarkReadTN)bool TypeErrorr super__init__ _info_params)selfrr rErKmsg __class__s rrQzModmailConversation.__init__nsV 8tE{ "z?ModmailConversation._build_conversation_list..sJL Js)join)rSother_conversations conversationss r_build_conversation_listz,ModmailConversation._build_conversation_lists)"5";< xxJMJJJrc|j}|jjj|}|jj |jt |y)Nr) _fetch_data_redditrr__dict__rrP_fetch)rSrotherrUs rrezModmailConversation._fetchsN! &&00d0; U^^, rc8dd|ji|jfS)Nmodmail_conversationr )r rRrSs r _fetch_infozModmailConversation._fetch_infos%dgg8I8IIIrc||jjtdj|jy)zArchive the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").archive() modmail_archiver(Nrcpostrformatr ris rarchivezModmailConversation.archives. (#45<<<HIrc||jjtdj|jy)zHighlight the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").highlight() modmail_highlightr(Nrmris r highlightzModmailConversation.highlight. (#67>>$''>JKr)num_daysc||jk7rd|dzini}|jjd|tdj |j y)aMute the non-mod user associated with the conversation. :param num_days: Duration of mute in days. Valid options are ``3``, ``7``, or ``28`` (default: ``3``). For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").mute() To mute for 7 days: .. code-block:: python reddit.subreddit("test").modmail("2gmz").mute(num_days=7) num_hoursPOST modmail_muter()methodparamspathN)DEFAULT_NUMBER_OF_MUTE_DAYSrcrequestrror )rSrur|s rmutezModmailConversation.mutes^(-58X8X,X[(R- (^`  .)00DGG0<  r)r^crd|j|i}|jjtd|y)aMark the conversation(s) as read. :param other_conversations: A list of other conversations to mark (default: ``None``). For example, to mark the conversation as read along with other recent conversations from the same user: .. code-block:: python subreddit = reddit.subreddit("test") conversation = subreddit.modmail.conversation("2gmz") conversation.read(other_conversations=conversation.user.recent_convos) conversationIds modmail_readrNr`rcrnrrSr^rs rreadzModmailConversation.reads6 "4#@#@AT#UV (>2>r) author_hiddeninternalc|||d}|jjtdj|j|t t rPdddd}d |}|jjj|}t |tsJ|Stfd jDS) a[Reply to the conversation. :param author_hidden: When ``True``, author is hidden from non-moderators (default: ``False``). :param body: The Markdown formatted content for a message. :param internal: When ``True``, message is a private moderator note, hidden from non-moderators (default: ``False``). :returns: A :class:`.ModmailMessage` object for the newly created message. For example, to reply to the non-mod user while hiding your username: .. code-block:: python conversation = reddit.subreddit("test").modmail("2gmz") conversation.reply(body="Message body", author_hidden=True) To create a private moderator note on the conversation: .. code-block:: python conversation.reply(body="Message body", internal=True) )bodyisAuthorHidden isInternalrhr(rr[rr'r rc3bK|]&}|jjddk(s#|(yw)r'r N)r obj_ids)rZmessageresponses rr\z,ModmailConversation.reply..s.i hN^N^_aNbcgNh@hGis$//) rcrnrror isinstancedictrrModmailMessagenextr) rSrrrr message_id message_datarrs @rreplyzModmailConversation.replys4+"  <<$$X.D%E%L%LPTPWPW%L%X_c$d h %!.1(;B?EJ#J/ ;Lll,,66L6IGg~6 66Ni8+<+<iiirc||jjtdj|jy)zUnarchive the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").unarchive() modmail_unarchiver(Nrmris r unarchivezModmailConversation.unarchivertrc||jjtdj|jy)zUn-highlight the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").unhighlight() rrr(N)rcdeleterror ris r unhighlightzModmailConversation.unhighlights. H%89@@DGG@LMrc|jjdtdj|jy)zUnmute the non-mod user associated with the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").unmute() rymodmail_unmuter()r{r}N)rcrrror ris runmutezModmailConversation.unmutes6 F:J1K1R1RVZV]V]1R1^_rcrd|j|i}|jjtd|y)aMark the conversation(s) as unread. :param other_conversations: A list of other conversations to mark (default: ``None``). For example, to mark the conversation as unread along with other recent conversations from the same user: .. code-block:: python subreddit = reddit.subreddit("test") conversation = subreddit.modmail.conversation("2gmz") conversation.unread(other_conversations=conversation.user.recent_convos) rmodmail_unreadrNrrs runreadzModmailConversation.unread(s7 "4#@#@AT#UV (#344@r)rdict[str, Any]r praw.RedditreturnNone)rrrrrr rY) rrr z str | NonerEzdict[str, Any] | NonerKrNrr)r^ list[ModmailConversation] | Nonerstr)rr)rz2tuple[str, dict[str, str], dict[str, bool] | None])rur-rr)r^rrr)rrNrrrrNrr)__name__ __module__ __qualname____doc__r~ STR_FIELD staticmethodrr> classmethodrJrQr`rerjrprsrrrrrrr __classcell__rUs@rr r s$#J#$IYY&'''  ''4F (, FF F % F  F F2K  J J L'B 8OS?&.3PU&jP L N `QUAArr c,eZdZdZdZdZdfd ZxZS) ModmailObjectz7A base class for objects within a modmail conversation.rHr c||jk(r&|jjj|}t|||y)z)Objectify the AUTHOR_ATTRIBUTE attribute.rN)AUTHOR_ATTRIBUTErcrrrP __setattr__)rS attributer=rUs rrzModmailObject.__setattr__Bs= -- -LL**44%4@E Iu-r)rrr=rrr)rrrrrrrrrs@rrr<sAI..rrceZdZdZy) ModmailActionz7A class for moderator actions on modmail conversations.NrrrrrrrrIsArrceZdZdZy)rzA class for modmail messages.NrrrrrrMs'rr)r __future__rtypingrr praw.constrpraw.models.reddit.baser praw.utilrprawr rrrrrrrsT%"%.%jA*jAZ .J .BMB(](r