o 2g_!@sdZddlmZddlmZddlmZmZddlm Z ddl m Z ddl m Z d d lmZer4dd lZGd d d eZGdddZd S)zProvide the Emoji class.) annotations)Path) TYPE_CHECKINGAny)API_PATH)ClientException)_deprecate_args) RedditBaseNcsveZdZdZdZd!fdd Zd"d d Z d#d$fdd ZfddZddZ e dddd d d dd%dd Z Z S)&EmojiaAn individual :class:`.Emoji` object. .. include:: ../../typical_attributes.rst ====================== ================================================= Attribute Description ====================== ================================================= ``mod_flair_only`` Whether the emoji is restricted for mod use only. ``name`` The name of the emoji. ``post_flair_allowed`` Whether the emoji may appear in post flair. ``url`` The URL of the emoji image. ``user_flair_allowed`` Whether the emoji may appear in user flair. ====================== ================================================= nameother str | EmojireturnboolcsJt|tr |t|kSt||jrt|t|ko|j|jkSt|S)z5Return whether the other instance equals the current.) isinstancestr __class__ subredditsuper__eq__)selfrrP/home/garg/my-data/venv/lib/python3.10/site-packages/praw/models/reddit/emoji.pyr$s    z Emoji.__eq__intcCs"t|jjtt|At|jAS)z(Return the hash of the current instance.)hashr__name__rrrrrr__hash__,s"zEmoji.__hash__Nreddit praw.Redditrpraw.models.Subredditr_datadict[str, Any] | Nonecs ||_||_tj||ddS)z'Initialize an :class:`.Emoji` instance.r$N)r rr__init__)rr!rr r$rrrr'0szEmoji.__init__csT|jjD]}|j|jkr|j|jtdSqd|jd|j}t|)Nzr/z does not have the emoji )remojir __dict__updater_fetchr)rr(msgrrrr+<s   z Emoji._fetchcCs&tdj|j|jd}|j|dS)zDelete an emoji from this subreddit by :class:`.Emoji`. To delete ``"emoji"`` as an emoji on r/test try: .. code-block:: python reddit.subreddit("test").emoji["emoji"].delete() emoji_delete) emoji_namerN)rformatr r_redditdelete)rurlrrrr1Es z Emoji.deletemod_flair_onlypost_flair_alloweduser_flair_allowedr3r4r5 bool | Nonec stfdddD}tdd|Drd}t|d|ji}|D]\}}|dur3t||}|||<q&td j|j d } |j j | |d |D] \}}t |||qMdS) aUpdate the permissions of an emoji in this subreddit. :param mod_flair_only: Indicate whether the emoji is restricted to mod use only. Respects pre-existing settings if not provided. :param post_flair_allowed: Indicate whether the emoji may appear in post flair. Respects pre-existing settings if not provided. :param user_flair_allowed: Indicate whether the emoji may appear in user flair. Respects pre-existing settings if not provided. .. note:: In order to retain pre-existing values for those that are not explicitly passed, a network request is issued. To avoid that network request, explicitly provide all values. To restrict the emoji ``"emoji"`` in r/test to mod use only, try: .. code-block:: python reddit.subreddit("test").emoji["emoji"].update(mod_flair_only=True) csi|]}||qSrr).0 attributelocals_referencerr ssz Emoji.update..r6css|]}|duVqdSNr)r8valuerrr {szEmoji.update..z'At least one attribute must be providedr N emoji_updaterdata) localsallvalues TypeErrorr itemsgetattrrr/rr0postsetattr) rr3r4r5mappingr,rCr9r>r2rr:rr*Ts"    z Emoji.update)rrrr)rrr=)r!r"rr#r rr$r%)r3r7r4r7r5r7) r __module__ __qualname____doc__ STR_FIELDrr r'r+r1r r* __classcell__rrrrr s    r c@sBeZdZdZdddZdd d Zdd dZdddddddZdS)SubredditEmojiz?Provides a set of functions to a :class:`.Subreddit` for emoji.r rrr cCst|j|j|S)a;Lazily return the :class:`.Emoji` for the subreddit named ``name``. :param name: The name of the emoji. This method is to be used to fetch a specific emoji url, like so: .. code-block:: python emoji = reddit.subreddit("test").emoji["emoji"] print(emoji) )r r0r)rr rrr __getitem__s zSubredditEmoji.__getitem__rr#cCs||_|j|_dS)z|Initialize a :class:`.SubredditEmoji` instance. :param subreddit: The subreddit whose emoji are affected. N)rr0)rrrrrr's zSubredditEmoji.__init__ list[Emoji]c#srjtdjjd}fdd|D}t|dksJ||dD]\}}tjj||dVq'dS) zReturn a list of :class:`.Emoji` for the subreddit. This method is to be used to discover all emoji for a subreddit: .. code-block:: python for emoji in reddit.subreddit("test").emoji: print(emoji) emoji_listrAcs$g|]}|jjjdr|qSrA) startswithr0configkinds)r8keyrrr s z+SubredditEmoji.__iter__..r rr&N)r0getrr/rlenrHr )rresponsesubreddit_keysr. emoji_datarrr__iter__s  zSubredditEmoji.__iter__Nr6 image_pathr3r7r4r5cCst|}|jdd}|drd|d<tdj|jd}|jj||dd } d d | d D} d | d} | d} |jj j j j| | d| id} Wdn1sVwY| |||| d|d}tdj|jd}|jj||dt|j|j|S)aAdd an emoji to this subreddit. :param image_path: A path to a jpeg or png image. :param mod_flair_only: When provided, indicate whether the emoji is restricted to mod use only (default: ``None``). :param name: The name of the emoji. :param post_flair_allowed: When provided, indicate whether the emoji may appear in post flair (default: ``None``). :param user_flair_allowed: When provided, indicate whether the emoji may appear in user flair (default: ``None``). :returns: The :class:`.Emoji` added. To add ``"emoji"`` to r/test try: .. code-block:: python reddit.subreddit("test").emoji.add(name="emoji", image_path="emoji.png") z image/jpeg)filepathmimetypez.pngz image/pngrc emoji_leaserArB s3UploadLeasecSsi|] }|d|dqS)r r>r)r8itemrrrr<sz&SubredditEmoji.add..fieldszhttps:actionrbfile)rCfilesNrY)r3r r4s3_keyr5 emoji_upload)rr lowerendswithrr/rr0rJopen_core _requestor_httpraise_for_statusr )rrar3r r4r5rjrCr2 upload_lease upload_data upload_urlimager]rrradds2   zSubredditEmoji.add)r rrr )rr#)rrT) rarr3r7r rr4r7r5r7rr )rrMrNrOrSr'r`ryrrrrrRs   rR)rO __future__rpathlibrtypingrrconstr exceptionsrutilr baser prawr rRrrrrs      y