{i/SrSSKJr SSKJrJr SSKJr SSKJ r J r SSK J r \(aSS K r "S S \ 5r"S S \ 5r"SS\5r"SS\5rg )zProvide models for new modmail.) annotations) TYPE_CHECKINGAny)API_PATH)_deprecate_argssnake_case_keys) RedditBaseNc8^\rSrSrSrSrSrSU4SjjrSrU=r $) ModmailObjectz7A base class for objects within a modmail conversation.authoridc>XR:Xa%URRRU5n[TU]X5 g)z)Objectify the AUTHOR_ATTRIBUTE attribute.N)AUTHOR_ATTRIBUTE_reddit _objector objectifysuper __setattr__)self attributevalue __class__s T/home/james-whalen/.local/lib/python3.13/site-packages/praw/models/reddit/modmail.pyrModmailObject.__setattr__s6 -- -LL**44U;E I-)rstrrr) __name__ __module__ __qualname____firstlineno____doc__r STR_FIELDr__static_attributes__ __classcell__rs@rr r sAI..rr c^\rSrSrSrSr\S Sj5r\S Sj5r\ S!Sj5r S"S#U4S jjjr S$S jr U4S jr S rSrSr\"S5SS.S%Sjj5r\"S 5SS.S&Sjj5r\"SSS5SSS.S'Sjj5rSrSrSr\"S 5SS.S&Sjj5rSrU=r$)(ModmailConversationa,A 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 rc//S.nUSH>nUSnXUSnX$RURRU55 M@ URU5 g)z1Convert messages and mod actions to PRAW objects.)messages modActionsobjIdskeyrN)appendrrupdate)dataredditresultthingr1 thing_datas r_convert_conversation_objects1ModmailConversation._convert_conversation_objectsDsd!3(^E,C5;/J K  v//99*E F$ Frc URRURRS[URRURRSS.nUR 5Hup4/nXR 5H`upgU"XR SS5SS9nU[LaUS UR 5Hup[XU 5 M URU5 Mb [US S S 9X'M g ) z;ModmailConversation._convert_user_summary..`ss144b7IrT)r1reverseN) rparsersconfigkindsr+itemsrsplitsetattrr2sorted) r4r5rMkindparserobjectsthing_idsummaryr7r1rs r_convert_user_summary)ModmailConversation._convert_user_summaryNs%..66v}}7J7J97UV/!++33FMM4G4G 4UV  $MMOLDG%)Z%5%5%7!v//#q*A"*EF!44 ,")--/JCE.#2u% &8 -ISWXDJ,rcxUSVs/sHo2RRU5PM snUS'SH"nURRX5X'M$ URS5(a6URUSU5 URRUS5US'[ U5nU"X!S9$s snf)zReturn an instance of :class:`.ModmailConversation` from ``data``. :param data: The structured data. :param reddit: An instance of :class:`.Reddit`. authors)owner participantuser_data)rrgetrYr )clsr4r5rentitys rparseModmailConversation.parsebs>B)_ =L6   & &v ._ Y-F!++55dlCDL- 88F    % %d6lF ;!++55d6lCDLt$6&& s$B7NFc>[U5[U5:Xa Sn[U5eU(aX l[TU]XS9 U(a SS0UlgSUlg)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.r`markReadTN)bool TypeErrorrr__init__ _info_params)rr5r mark_readramsgrs rrkModmailConversation.__init__|sR 8tE{ "?ModmailConversation._build_conversation_list..sJMLMs)join)rrp conversationss r_build_conversation_list,ModmailConversation._build_conversation_lists+"5";< xxJMJJJrc>UR5nURRRU5nURR UR5 [ TU]5 grt) _fetch_datarrr__dict__r3r_fetch)rr4otherrs rrModmailConversation._fetchsK! &&006 U^^, rc8SSUR0UR4$)Nmodmail_conversationr)rrlrs r _fetch_infoModmailConversation._fetch_infos%dgg8I8IIIrcvURR[SRURS95 g)zyArchive the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").archive() modmail_archiverCNrpostrformatrrs rarchiveModmailConversation.archives. (#45<<<HIrcvURR[SRURS95 g)z}Highlight the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").highlight() modmail_highlightrCNrrs r highlightModmailConversation.highlight. (#67>>$''>JKrnum_daysr)rcUS:waSUS-0O0nURRSU[SRURS9S9 g) alMute 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) r num_hoursPOST modmail_muterC)methodparamspathNrrequestrrr)rrrs rmuteModmailConversation.mutesQ(2:Q+x"}-B .)00DGG0<  r)rpclSURU50nURR[SUS9 g)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_readr4Nr{rrrrrpr4s rreadModmailConversation.reads6""4#@#@AT#UV (>2>rbody author_hiddeninternal)rrcUUUS.nURR[SRURS9US9n[ U[ 5(a;USSSSnUS UnURRRU5$URH'nURURSS:XdM%Us $ g ) aReply 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) )risAuthorHidden isInternalrrCrrvr0rBrr.N) rrrrr isinstancedictrrr.obj_ids) rrrrr4response message_id message_datamessages rreplyModmailConversation.replys:+"  <<$$ + , 3 3tww 3 ?d%  h % %!.1(;B?EJ#J/ ;L<<))33LA A((GzzX--b1$77)rcvURR[SRURS95 g)z}Unarchive the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").unarchive() modmail_unarchiverCNrrs r unarchiveModmailConversation.unarchiverrcvURR[SRURS95 g)zUn-highlight the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").unhighlight() rrCN)rdeleterrrrs r unhighlightModmailConversation.unhighlight$s. H%89@@DGG@LMrctURRS[SRURS9S9 g)zUnmute the non-mod user associated with the conversation. For example: .. code-block:: python reddit.subreddit("test").modmail("2gmz").unmute() rmodmail_unmuterC)rrNrrs runmuteModmailConversation.unmute0s8 )9 : A ATWW A M  rclSURU50nURR[SUS9 g)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 runreadModmailConversation.unread>s7""4#@#@AT#UV (#344@r)rlr)r4dict[str, Any]r5 praw.Reddit)r4rr5rreturnr+)NFN)r5rrz str | Nonermrirazdict[str, Any] | None)rpzlist[ModmailConversation]rr )rrH)rpz list[ModmailConversation] | None)rrirr rrirModmailMessage)r!r"r#r$r%r& staticmethodr9rY classmethodrerkr{rrrrrrrrrrrrr'r(r)s@rr+r+s#JIYY&'''  ''8'+ FF F F % FF0K#<K K J J LZ &' ! 4*+NR?,?&V_j9',%* $*47*CG* *:*X L N  *+PTA,Arr+c\rSrSrSrSrg) ModmailActioniSz7A class for moderator actions on modmail conversations.rNr!r"r#r$r%r'rrrrrSsArrc\rSrSrSrSrg)riWzA class for modmail messages.rNrrrrrrWs'rr)r% __future__rtypingrrconstrutilrr rGr prawr r+rrrrrrsT%"%4 .J .tA*tAn BMB(](r