o 2g@sdZddlmZddlmZmZddlmZddlm Z ddl m Z m Z m Z dd lmZdd lmZer8dd lZGd d d e e e e ZGdddeZd S)zProvide the Message class.) annotations) TYPE_CHECKINGAny)API_PATH) RedditBase) FullnameMixinInboxableMixinReplyableMixin)Redditor) SubredditNcsheZdZdZdZedd d Zedd d ZedddZ e j dddZ dfdd Z ddZ Z S)MessageaA class for private messages. .. include:: ../../typical_attributes.rst =============== ================================================================ Attribute Description =============== ================================================================ ``author`` Provides an instance of :class:`.Redditor`. ``body`` The body of the message, as Markdown. ``body_html`` The body of the message, as HTML. ``created_utc`` Time the message was created, represented in `Unix Time`_. ``dest`` Provides an instance of :class:`.Redditor`. The recipient of the message. ``id`` The ID of the message. ``name`` The full ID of the message, prefixed with ``t4_``. ``subject`` The subject of the message. ``was_comment`` Whether or not the message was a comment reply. =============== ================================================================ .. _unix time: https://en.wikipedia.org/wiki/Unix_time iddatadict[str, Any]reddit praw.RedditreturnMessage | SubredditMessagecCs|dr t||d|d<|ddr"t||ddd|d<n t||d|d<|dr@|d}|j|dd|d<ng|d<|d rWt||d |d <t||d S|||d S) zReturn an instance of :class:`.Message` or :class:`.SubredditMessage` from ``data``. :param data: The structured data. :param reddit: An instance of :class:`.Reddit`. authordest#rNrepliesrchildren subreddit)_data)r startswithr _objector objectifySubredditMessage)clsrrrr"R/home/garg/my-data/venv/lib/python3.10/site-packages/praw/models/reddit/message.pyparse+s   z Message.parsestrcCs|jjjdS)zReturn the class's kind.message)_redditconfigkindsselfr"r"r#_kindIsz Message._kindpraw.models.Message | NonecCs.|js|jr|jj|jdd|_|jS)z.Return the parent of the message if it exists._r)_parent parent_idr'inboxr&splitr*r"r"r#parentNs zMessage.parentvaluecCs ||_dS)N)r/)r+r4r"r"r#r3Us rcs@tj||ddd|_|dgD] }|j|jkr||_qdS)z(Initialize a :class:`.Message` instance.T)r_fetchedNr)super__init__r/getr0fullnamer3)r+rrreply __class__r"r#r7Ys zMessage.__init__cC|jjtdd|jiddS)a<Delete the message. .. note:: Reddit does not return an indication of whether or not the message was successfully deleted. For example, to delete the most recent message in your inbox: .. code-block:: python next(reddit.inbox.all()).delete() delete_messagerrNr'postrr9r*r"r"r#deleteaszMessage.delete)rrrrrr)rr%)rr-)r4r-)rrrr)__name__ __module__ __qualname____doc__ STR_FIELD classmethodr$propertyr,r3setterr7rB __classcell__r"r"r;r#rs    rc@s eZdZdZddZddZdS)r aA class for messages to a subreddit. .. include:: ../../typical_attributes.rst =============== ================================================================= Attribute Description =============== ================================================================= ``author`` Provides an instance of :class:`.Redditor`. ``body`` The body of the message, as Markdown. ``body_html`` The body of the message, as HTML. ``created_utc`` Time the message was created, represented in `Unix Time`_. ``dest`` Provides an instance of :class:`.Redditor`. The recipient of the message. ``id`` The ID of the message. ``name`` The full ID of the message, prefixed with ``t4_``. ``subject`` The subject of the message. ``subreddit`` If the message was sent from a subreddit, provides an instance of :class:`.Subreddit`. ``was_comment`` Whether or not the message was a comment reply. =============== ================================================================= .. _unix time: https://en.wikipedia.org/wiki/Unix_time cCr=)aMute the sender of this :class:`.SubredditMessage`. For example, to mute the sender of the first :class:`.SubredditMessage` in the authenticated users' inbox: .. code-block:: python from praw.models import SubredditMessage msg = next( message for message in reddit.inbox.all() if isinstance(message, SubredditMessage) ) msg.mute() mute_senderrr?Nr@r*r"r"r#mutezSubredditMessage.mutecCr=)aUnmute the sender of this :class:`.SubredditMessage`. For example, to unmute the sender of the first :class:`.SubredditMessage` in the authenticated users' inbox: .. code-block:: python from praw.models import SubredditMessage msg = next( message for message in reddit.inbox.all() if isinstance(message, SubredditMessage) ) msg.unmute() unmute_senderrr?Nr@r*r"r"r#unmuterNzSubredditMessage.unmuteN)rCrDrErFrMrPr"r"r"r#r ss r )rF __future__rtypingrrconstrbasermixinsr r r redditorr rr praw.modelsprawrr r"r"r"r#s     b