FjdZddlmZddlmZmZmZddlmZddl m Z ddl m Z ddl mZerddlmZdd lZdd lmZGd d e ZGd dZy )z!Provide the Removal Reason class.) annotations) TYPE_CHECKINGAny SupportsIndex)API_PATH)ClientException) RedditBase)cachedproperty)IteratorN)modelscteZdZdZdZd dZd dZ d dfd Zdfd ZddZ ddd dd Z xZ S) RemovalReasonaAn individual Removal Reason object. .. include:: ../../typical_attributes.rst =========== ================================== Attribute Description =========== ================================== ``id`` The ID of the removal reason. ``message`` The message of the removal reason. ``title`` The title of the removal reason. =========== ================================== idct|tr|t|k(St||jxrt|t|k(S)z5Return whether the other instance equals the current.) isinstancestr __class__)selfothers `/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/reddit/removal_reasons.py__eq__zRemovalReason.__eq__$s> eS !CI% %%0LSY#e*5LLcjt|jjtt|z S)z(Return the hash of the current instance.)hashr__name__rrs r__hash__zRemovalReason.__hash__*s$DNN++,tCI>>rNc||fjddk7r d}t||r||_||_t|||y)zInitialize a :class:`.RemovalReason` instance. :param reddit: An instance of :class:`.Reddit`. :param subreddit: An instance of :class:`.Subreddit`. :param id: The ID of the removal reason. Nz%Either id or _data needs to be given._data)count ValueErrorr subredditsuper__init__)rredditr$rr!msgrs rr&zRemovalReason.__init__.sN ;  T "a '9CS/ ! DG" u-rc8|jjjD]P}|j|jk(s|jj |jt |yd|jd|j}t|)Nz Subreddit z" does not have the removal reason ) r$modremoval_reasonsr__dict__updater%_fetchr)rremoval_reasonr(rs rr.zRemovalReason._fetchEs"nn00@@ N  DGG+ $$^%<%<=    4>>**LTWWIVc""rctdj|j|j}|jj |y)zDelete a removal reason from this subreddit. To delete ``"141vv5c16py7d"`` from r/test try: .. code-block:: python reddit.subreddit("test").mod.removal_reasons["141vv5c16py7d"].delete() r/rr$N)rformatrr$_redditdelete)rurls rr4zRemovalReason.deleteNs9'(//477dnn/U C rmessagetitlec tdj|j|j}||dj Dcic]\}}|| t ||n|}}}|j j||ycc}}w)aUpdate the removal reason from this subreddit. .. note:: Existing values will be used for any unspecified arguments. :param message: The removal reason's new message. :param title: The removal reason's new title. To update ``"141vv5c16py7d"`` from r/test try: .. code-block:: python reddit.subreddit("test").mod.removal_reasons["141vv5c16py7d"].update( title="New title", message="New message" ) r/r1r6Ndata)rr2rr$itemsgetattrr3put)rr7r8r5namevaluer;s rr-zRemovalReason.update[s&'(//477dnn/U,3UCIIK e '$%E A   4(  sB)rzstr | RemovalReasonreturnbool)rAint)NN) r'z praw.Redditr$models.Subredditr str | Noner!zdict[str, Any] | NonerANone)rArF)r7rEr8rErArF) r __module__ __qualname____doc__ STR_FIELDrrr&r.r4r- __classcell__)rs@rrrsr IM ?'+ ..$.  . % .  ..# !/3))rrcBeZdZdZeddZd dZd dZd dZd dZ y) SubredditRemovalReasonszFProvide a set of functions to a :class:`.Subreddit`'s removal reasons.c |jjtdj|j}|dDcgc]*}t |j|j|d|,c}Scc}w)zrGet a list of Removal Reason objects. :returns: A list of instances of :class:`.RemovalReason`. removal_reasons_listr$orderr;r )r3getrr2r$r)rresponse reason_ids r_removal_reason_listz,SubredditRemovalReasons._removal_reason_listysu<<##H-C$D$K$KVZVdVd$K$ef&g.  $,,hv>Ny>Y Z   s/A6ct|ts|j|St|j|j |S)acReturn the Removal Reason with the ID/number/slice ``reason_id``. :param reason_id: The ID or index of the removal reason .. note:: Removal reasons fetched using a specific rule name are lazily loaded, so you might have to access an attribute to get all the expected attributes. This method is to be used to fetch a specific removal reason, like so: .. code-block:: python reason_id = "141vv5c16py7d" reason = reddit.subreddit("test").mod.removal_reasons[reason_id] print(reason) You can also use indices to get a numbered removal reason. Since Python uses 0-indexing, the first removal reason is index 0, and so on. .. note:: Both negative indices and slices can be used to interact with the removal reasons. :raises: :py:class:`IndexError` if a removal reason of a specific number does not exist. For example, to get the second removal reason of r/test: .. code-block:: python reason = reddit.subreddit("test").mod.removal_reasons[1] To get the last three removal reasons in a subreddit: .. code-block:: python reasons = reddit.subreddit("test").mod.removal_reasons[-3:] for reason in reasons: print(reason) )rrrUrr3r$)rrTs r __getitem__z#SubredditRemovalReasons.__getitem__s7X)S),,Y7 7T\\4>>9EErc4||_|j|_y)zInitialize a :class:`.SubredditRemovalReasons` instance. :param subreddit: The subreddit whose removal reasons to work with. N)r$r3)rr$s rr&z SubredditRemovalReasons.__init__s # (( rc,t|jS)a"Return a list of Removal Reasons for the subreddit. This method is used to discover all removal reasons for a subreddit: .. code-block:: python for removal_reason in reddit.subreddit("test").mod.removal_reasons: print(removal_reason) )iterrUrs r__iter__z SubredditRemovalReasons.__iter__sD--..rc||d}tdj|j}|jj ||}t |j|j|S)aAdd a removal reason to this subreddit. :param message: The message associated with the removal reason. :param title: The title of the removal reason. :returns: The :class:`.RemovalReason` added. The message will be prepended with ``Hi u/username,`` automatically. To add ``"Test"`` to r/test try: .. code-block:: python reddit.subreddit("test").mod.removal_reasons.add(title="Test", message="Foobar") r6rOrPr:)rr2r$r3postr)rr7r8r;r5rTs raddzSubredditRemovalReasons.adds["#U3-.555OLL%%c%5 T\\4>>9EErN)rAzlist[RemovalReason])rTrrAr)r$rDrArF)rAzIterator[RemovalReason])r7rr8rrAr) rrGrHrIr rUrWr&r[r^rrrMrMvs.P    .F`) /FrrM)rI __future__rtypingrrr praw.constrpraw.exceptionsrpraw.models.reddit.baser praw.utilr collections.abcr prawr rrMr_rrrhsF'"44+.$(`)J`)FjFjFr