FjZdZddlmZddlmZmZddlmZddlm Z ddl m Z erddl m Z ddlZdd lmZGd d e ZGd d Zy)zProvide the Emoji class.) annotations) TYPE_CHECKINGAny)API_PATH)ClientException) RedditBase)IteratorN)modelsceZdZdZdZd fd Zd dZ d dfd Zdfd ZddZ dddd  dd Z xZ 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. ====================== ================================================= namect|tr|t|k(St||jr2t|t|k(xr|j|jk(St||S)z5Return whether the other instance equals the current.) isinstancestr __class__ subredditsuper__eq__)selfotherrs V/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/reddit/emoji.pyrz Emoji.__eq__%s^ eS !CI% % eT^^ ,t9E *Pu$../P Pw~e$$ct|jjtt|z t|jz S)z(Return the hash of the current instance.)hashr__name__rr)rs r__hash__zEmoji.__hash__-s2DNN++,tCI>dnnAUUUrNcD||_||_t| ||y)z'Initialize an :class:`.Emoji` instance._dataN)r rr__init__)rredditrr rrs rr zEmoji.__init__1s% " u-rc$|jjD]P}|j|jk(s|jj |jt |yd|jd|j}t|)Nzr/z does not have the emoji )remojir __dict__updater_fetchr)rr#msgrs rr&z Emoji._fetch=sx^^)) EzzTYY& $$U^^4    4>>"";DII;Gc""rctdj|j|j}|jj |y)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)rurls rr-z Emoji.deleteFs8~&--dnn-] C rmod_flair_onlypost_flair_alloweduser_flair_allowedct}dDcic]}||| }}td|jDr d}t|d|ji}|j D]\}} | t ||} | ||<tdj|j} |jj| ||j D]\}} t||| ycc}w) 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) r/c3$K|]}|du ywN).0values r zEmoji.update..ys;u};sz'At least one attribute must be providedr N emoji_updaterdata) localsallvalues TypeErrorr itemsgetattrrr+rr,postsetattr) rr0r1r2locals_reference attributemappingr'r=r8r.s rr%z Emoji.updateSs:"8  ' 2 2   ;'..*:; ;;CC.  " '  $ Iu}i0#DO $~&---G #D) $  , Iu D)U + ,' s C*)rz str | Emojireturnbool)rIintr5) r!z praw.Redditrmodels.Subredditr rrzdict[str, Any] | NonerINone)rIrM)r0 bool | Noner1rNr2rNrIrM) r __module__ __qualname____doc__ STR_FIELDrrr r&r-r% __classcell__)rs@rr r s I%V(, . .$ . . % .  .# ! '+*.*. 2,$2,( 2, ( 2,  2,rr cPeZdZdZddZd dZd dZdddd d dZy) SubredditEmojiz?Provides a set of functions to a :class:`.Subreddit` for emoji.cDt|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 r,r)rr s r __getitem__zSubredditEmoji.__getitem__sT\\4>>488rc4||_|j|_y)z|Initialize a :class:`.SubredditEmoji` instance. :param subreddit: The subreddit whose emoji are affected. N)rr,)rrs rr zSubredditEmoji.__init__s # (( rc#K|jjtdj|j}|Dcgc]7}|j |jj jds6|9}}t|dk(sJ||djD]*\}}t|j|j||,ycc}ww)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_listr;rrrN) r,getrr+r startswithconfigkindslenrBr )rresponsekeysubreddit_keysr* emoji_datas r__iter__zSubredditEmoji.__iter__s<<##H\$:$A$ADNN$A$[\)1l#S^^DLLDWDWD]D]^iDj5k#ll>"a'''&.~a/@&A&G&G&I T "J  dnnj S S TmsAC7C;C?ACNr/c |j|j}|||||d}tdj|j}|jj ||t |j|j|S)aWAdd an emoji to this subreddit. :param media: The :class:`.EmojiMedia` to be uploaded as an emoji. :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 from praw.models import EmojiMedia media = EmojiMedia("emoji.png") reddit.subreddit("test").emoji.add(media=media, name="emoji") )r0r r1s3_keyr2 emoji_uploadr;r<)_uploadrrr+r,rDr ) rmediar0r r1r2rgr=r.s raddzSubredditEmoji.adds{@t~~.-"4"4  ~&---G #D)T\\4>>488r)r rrIr )rrLrIrM)rIzIterator[Emoji]) rjzmodels.EmojiMediar0rNr rr1rNr2rNrIr )rrOrPrQrWr rerkr6rrrUrUsaI 9)T*'+*.*.+9!+9$ +9  +9 ( +9(+9 +9rrU)rQ __future__rtypingrr praw.constrpraw.exceptionsrpraw.models.reddit.basercollections.abcr prawr r rUr6rrrss>"%+.(s,Js,lW9W9r