o 2g;@sdZddlmZddlmZmZmZddlmZddl m Z ddl m Z ddl mZdd lmZmZd d lmZer>dd lZGd ddeZGdddZGdddZGdddZd S)zProvide the Rule class.) annotations) TYPE_CHECKINGAnyIterator)quote)warn)API_PATH)ClientException)_deprecate_argscachedproperty) RedditBaseNcsVeZdZdZdZedddZdfd d Z ddfdd ZfddZ Z S)RuleaRAn individual :class:`.Rule` object. .. include:: ../../typical_attributes.rst ==================== ============================================================= Attribute Description ==================== ============================================================= ``created_utc`` Time the rule was created, represented in `Unix Time`_. ``description`` The description of the rule, if provided, otherwise a blank string. ``kind`` The kind of rule. Can be ``"link"``, ``comment"``, or ``"all"``. ``priority`` Represents where the rule is ranked. For example, the first rule is at priority ``0``. Serves as an index number on the list of rules. ``short_name`` The name of the rule. ``violation_reason`` The reason that is displayed on the report menu for the rule. ==================== ============================================================= .. _unix time: https://en.wikipedia.org/wiki/Unix_time short_namereturn'praw.models.reddit.rules.RuleModerationcCt|S)aContain methods used to moderate rules. To delete ``"No spam"`` from r/test try: .. code-block:: python reddit.subreddit("test").rules["No spam"].mod.delete() To update ``"No spam"`` from r/test try: .. code-block:: python reddit.subreddit("test").removal_reasons["No spam"].mod.update( description="Don't do this!", violation_reason="Spam post" ) )RuleModerationselfrP/home/garg/my-data/venv/lib/python3.10/site-packages/praw/models/reddit/rules.pymod,szRule.mod attributestrrcs,t|}|dkr|durd}t||S)zGet the value of an attribute. subredditNz;The Rule is missing a subreddit. File a bug report at PRAW.)super__getattribute__ ValueError)rrvaluemsg __class__rrrAs zRule.__getattribute__Nreddit praw.Redditrpraw.models.Subreddit | None str | None_datadict[str, str] | NonecsB||fddkrd}t||r||_||_tj||ddS)z%Initialize a :class:`.Rule` instance.Nr z-Either short_name or _data needs to be given.)r()countrrrr__init__)rr$rrr(r!r"rrr+Isz Rule.__init__csT|jjD]}|j|jkr|j|jtdSqd|jd|j}t|)Nz Subreddit z does not have the rule )rrulesr__dict__updater_fetchr )rruler!r"rrr/\s   z Rule._fetch)rr)rrrr)NNN)r$r%rr&rr'r(r)) __name__ __module__ __qualname____doc__ STR_FIELDr rrr+r/ __classcell__rrr"rrs  rc@sFeZdZdZdddZddZedd d d d d d d d dddZd S)raContain methods used to moderate rules. To delete ``"No spam"`` from r/test try: .. code-block:: python reddit.subreddit("test").rules["No spam"].mod.delete() To update ``"No spam"`` from r/test try: .. code-block:: python reddit.subreddit("test").removal_reasons["No spam"].mod.update( description="Don't do this!", violation_reason="Spam post" ) r0praw.models.RulecC ||_dS)z/Initialize a :class:`.RuleModeration` instance.N)r0)rr0rrrr+y zRuleModeration.__init__cCs0t|jj|jjd}|jjjtd|ddS)zDelete a rule from this subreddit. To delete ``"No spam"`` from r/test try: .. code-block:: python reddit.subreddit("test").rules["No spam"].mod.delete() )rrremove_subreddit_ruledataN)rr0rr_redditpostr )rr=rrrdelete}s zRuleModeration.delete descriptionkindrviolation_reasonNrArBrrCr'rc Csvt|jj|jjd}||||dD]\}}|dur"t|j|n|||<q|jjjtd|dd}|jj|_|S)a Update the rule from this subreddit. .. note:: Existing values will be used for any unspecified arguments. :param description: The new description for the rule. Can be empty. :param kind: The kind of item that the rule applies to. One of ``"link"``, ``"comment"``, or ``"all"``. :param short_name: The name of the rule. :param violation_reason: The reason that is shown on the report menu. :returns: A Rule object containing the updated values. To update ``"No spam"`` from r/test try: .. code-block:: python reddit.subreddit("test").removal_reasons["No spam"].mod.update( description="Don't do this!", violation_reason="Spam post" ) )r:old_short_namerDNupdate_subreddit_ruler<r) rr0rritemsgetattrr>r?r ) rrArBrrCr=namer updated_rulerrrr.s$ !  zRuleModeration.update)r0r7) rAr'rBr'rr'rCr'rr7)r1r2r3r4r+r@r r.rrrrrfs  rc@sTeZdZdZedddZedddZdd d ZdddZdddZ dddZ dS)SubredditRulesa Provide a set of functions to access a :class:`.Subreddit`'s rules. For example, to list all the rules for a subreddit: .. code-block:: python for rule in reddit.subreddit("test").rules: print(rule) Moderators can also add rules to the subreddit. For example, to make a rule called ``"No spam"`` in r/test: .. code-block:: python reddit.subreddit("test").rules.mod.add( short_name="No spam", kind="all", description="Do not spam. Spam bad" ) r list[Rule]cCs0|jtdj|jd}|D]}|j|_q|S)ziGet a list of :class:`.Rule` objects. :returns: A list of instances of :class:`.Rule`. r,r)r>getr formatr)r rule_listr0rrr _rule_lists zSubredditRules._rule_listSubredditRulesModerationcCr)aContain methods to moderate subreddit rules as a whole. To add rule ``"No spam"`` to r/test try: .. code-block:: python reddit.subreddit("test").rules.mod.add( short_name="No spam", kind="all", description="Do not spam. Spam bad" ) To move the fourth rule to the first position, and then to move the prior first rule to where the third rule originally was in r/test: .. code-block:: python subreddit = reddit.subreddit("test") rules = list(subreddit.rules) new_rules = rules[3:4] + rules[1:3] + rules[0:1] + rules[4:] # Alternate: [rules[3]] + rules[1:3] + [rules[0]] + rules[4:] new_rule_list = subreddit.rules.mod.reorder(new_rules) )rRrrrrrszSubredditRules.modlist[praw.models.Rule]cCs,tdtdd|jjdtdj|jddS)aReturn a list of :class:`.Rule`\ s (Deprecated). :returns: A list of instances of :class:`.Rule`. .. deprecated:: 7.1 Use the iterator by removing the call to :class:`.SubredditRules`. For example, in order to use the iterator: .. code-block:: python for rule in reddit.subreddit("test").rules: print(rule) a=Calling SubredditRules to get a list of rules is deprecated. Remove the parentheses to use the iterator. View the PRAW documentation on how to change the code in order to use the iterator (https://praw.readthedocs.io/en/latest/code_overview/other/subredditrules.html#praw.models.reddit.rules.SubredditRules.__call__).)category stacklevelGETr,rM)methodpath)rDeprecationWarningr>requestr rOrrrrr__call__szSubredditRules.__call__rstr | int | slicer7cCs&t|ts |j|St|j|j|dS)aReturn the :class:`.Rule` for the subreddit with short_name ``short_name``. :param short_name: The short_name of the rule, or the rule number. .. note:: Rules 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 rule, like so: .. code-block:: python rule_name = "No spam" rule = reddit.subreddit("test").rules[rule_name] print(rule) You can also fetch a numbered rule of a subreddit. Rule numbers start at ``0``, so the first rule is at index ``0``, and the second rule is at index ``1``, and so on. :raises: :py:class:`IndexError` if a rule of a specific number does not exist. .. note:: You can use negative indexes, such as ``-1``, to get the last rule. You can also use slices, to get a subset of rules, such as the last three rules with ``rules[-3:]``. For example, to fetch the second rule of r/test: .. code-block:: python rule = reddit.subreddit("test").rules[1] )rr) isinstancerrQrr>r)rrrrr __getitem__s & zSubredditRules.__getitem__rpraw.models.SubredditcCs||_|j|_dS)z|Initialize a :class:`.SubredditRules` instance. :param subreddit: The subreddit whose rules to work with. N)rr>)rrrrrr+@s zSubredditRules.__init__Iterator[praw.models.Rule]cCs t|jS)aiIterate through the rules of the subreddit. :returns: An iterator containing all the rules of a subreddit. This method is used to discover all rules for a subreddit. For example, to get the rules for r/test: .. code-block:: python for rule in reddit.subreddit("test").rules: print(rule) )iterrQrrrr__iter__Is zSubredditRules.__iter__N)rrL)rrR)rrS)rr]rr7)rr`)rra) r1r2r3r4r rQrr\r_r+rcrrrrrKs     * rKc@sDeZdZdZdddZedddd d d d dddZdddZd S)rRaContain methods to moderate subreddit rules as a whole. To add rule ``"No spam"`` to r/test try: .. code-block:: python reddit.subreddit("test").rules.mod.add( short_name="No spam", kind="all", description="Do not spam. Spam bad" ) To move the fourth rule to the first position, and then to move the prior first rule to where the third rule originally was in r/test: .. code-block:: python subreddit = reddit.subreddit("test") rules = list(subreddit.rules) new_rules = rules[3:4] + rules[1:3] + rules[0:1] + rules[4:] # Alternate: [rules[3]] + rules[1:3] + [rules[0]] + rules[4:] new_rule_list = subreddit.rules.mod.reorder(new_rules) subreddit_rulesrKcCr8)z9Initialize a :class:`.SubredditRulesModeration` instance.N)rd)rrdrrrr+sr9z!SubredditRulesModeration.__init__rrBrArCN)rArCrr'rr7cCsLt|jj||||dur|n|d}|jjjtd|dd}|jj|_|S)aAdd a removal reason to this subreddit. :param description: The description for the rule. :param kind: The kind of item that the rule applies to. One of ``"link"``, ``"comment"``, or ``"all"``. :param short_name: The name of the rule. :param violation_reason: The reason that is shown on the report menu. If a violation reason is not specified, the short name will be used as the violation reason. :returns: The added :class:`.Rule`. To add rule ``"No spam"`` to r/test try: .. code-block:: python reddit.subreddit("test").rules.mod.add( short_name="No spam", kind="all", description="Do not spam. Spam bad" ) N)r:rArBrrCadd_subreddit_ruler<r)rrdrr>r?r )rrArBrrCr=new_rulerrraddws   zSubredditRulesModeration.addrPrScCs\tddd|Ddd}t|jj|d}|jjjtd|d}|D]}|jj|_q$|S)aReorder the rules of a subreddit. :param rule_list: The list of rules, in the wanted order. Each index of the list indicates the position of the rule. :returns: A list containing the rules in the specified order. For example, to move the fourth rule to the first position, and then to move the prior first rule to where the third rule originally was in r/test: .. code-block:: python subreddit = reddit.subreddit("test") rules = list(subreddit.rules) new_rules = rules[3:4] + rules[1:3] + rules[0:1] + rules[4:] # Alternate: [rules[3]] + rules[1:3] + [rules[0]] + rules[4:] new_rule_list = subreddit.rules.mod.reorder(new_rules) ,cSsg|]}|jqSr)r).0r0rrr sz4SubredditRulesModeration.reorder..)safe)r:new_rule_orderreorder_subreddit_rulesr<)rjoinrrdrr>r?r )rrP order_stringr=responser0rrrreorders  z SubredditRulesModeration.reorder)rdrK) rArrBrrrrCr'rr7)rPrSrrS)r1r2r3r4r+r rhrrrrrrrR[s  ,rR)r4 __future__rtypingrrr urllib.parserwarningsrconstr exceptionsr utilr r baser praw.modelsprawrrrKrRrrrrs       TY