Fj" dZddlmZddlmZmZddlmZddlm Z m Z m Z m Z ddl mZddlZddlmZdd lmZdd lmZmZmZdd lmZdd lmZdd lmZddlmZddl m!Z!ddl"m#Z#m$Z$m%Z%ddl&m'Z'ddl(m)Z)ddl*m+Z+ddl,m-Z-ddl.m/Z/ddl0m1Z1ddl2m3Z3m4Z4m5Z5ddl6m7Z7ddl8m9Z9ddl:m;Z;ddlZ>ddl?m@Z@e rddlAmBZBmCZCddlDZDddlDmEZEddlFmGZGGd d!e%ee$e#eZHeHe>_Iy)"zProvide the Subreddit class.) annotations)dumpsloads)Path) TYPE_CHECKINGAnycastoverload)urljoinN)Redirect)API_PATH)MediaPostFailedRedditAPIExceptionWebSocketException)ListingGenerator)SubredditListingMixin) PostMedia) RedditBaseSubredditEmoji) CreatedMixin FullnameMixinMessageableMixinSubredditRulesSubredditFiltersSubredditFlairSubredditModerationModmailSubredditQuarantine)ContributorRelationshipModeratorRelationshipSubredditRelationshipSubredditStreamSubredditStylesheet SubredditWiki)SubredditWidgets WidgetEncoder)cachedproperty)IteratorSequence)models)SubredditCollectionsc#eZdZUdZdZdZdZded<ded<d ed <ed d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d d ! dFd Z e dGdZ edHdZ edIdZ e dJdZe dKdZe dLdZe dMdZe dNdZe dOdZe dPdZe dQdZe dRdZe dJdZe dSdZe dTdZe dUdZe dVdZe dWdZe dXd ZedYd!Z dZ d[fd" Z d\d#Z!d]fd$ Z"d^d%Z# d_d&Z$d`d'Z%dad(Z&d)d*d+d, dbd-Z'd.d/dcd0Z(e)d1d1d1d1d1d1d1d1d1d1d2 ddd3Z*e)d1d1d1d1d1d1d1d1d1d1d4 ded5Z*e)d1d1d1d1d1d1d1d1d1d1d1d6 dfd7Z*e)d1d1d1d1d1d1d1d1d8 dgd9Z*e)d1d1d1d1d1d1d1d1d1d: dhd;Z*e)d1d1d1d1d1d1d1d1d1d1d1d6 did<Z*d d d d d d d d d=d d>d d>d=d?d d d=d@ djdAZ*d dBdkdCZ+dldDZ,d dBdkdEZ-xZ.S)m SubredditaL A class for Subreddits. To obtain an instance of this class for r/test execute: .. code-block:: python subreddit = reddit.subreddit("test") While r/all is not a real subreddit, it can still be treated like one. The following outputs the titles of the 25 hottest submissions in r/all: .. code-block:: python for submission in reddit.subreddit("all").hot(limit=25): print(submission.title) Multiple subreddits can be combined with a ``+`` like so: .. code-block:: python for submission in reddit.subreddit("redditdev+learnpython").top(time_filter="all"): print(submission) Subreddits can be filtered from combined listings as follows. .. note:: These filters are ignored by certain methods, including :attr:`.comments`, and :meth:`.SubredditStream.comments`. .. code-block:: python for submission in reddit.subreddit("all-redditdev").new(): print(submission) .. include:: ../../typical_attributes.rst ========================= ========================================================== Attribute Description ========================= ========================================================== ``can_assign_link_flair`` Whether users can assign their own link flair. ``can_assign_user_flair`` Whether users can assign their own user flair. ``created_utc`` Time the subreddit was created, represented in `Unix Time`_. ``description`` Subreddit description, in Markdown. ``description_html`` Subreddit description, in HTML. ``display_name`` Name of the subreddit. ``icon_img`` The URL of the subreddit icon image. ``id`` ID of the subreddit. ``name`` Fullname of the subreddit. ``over18`` Whether the subreddit is NSFW. ``public_description`` Description of the subreddit, shown in searches and on the "You must be invited to visit this community" page (if applicable). ``spoilers_enabled`` Whether the spoiler tag feature is enabled. ``subscribers`` Count of subscribers. ``user_is_banned`` Whether the authenticated user is banned. ``user_is_moderator`` Whether the authenticated user is a moderator. ``user_is_subscriber`` Whether the authenticated user is subscribed. ========================= ========================================================== .. note:: Trying to retrieve attributes of quarantined or private subreddits will result in a 403 error. Trying to retrieve attributes of a banned subreddit will result in a 404 error. .. _unix time: https://en.wikipedia.org/wiki/Unix_time # display_nameztype[models.Submission]_submission_classztype[SubredditCollections]_subreddit_collections_classint last_updatedN)! allow_imagesallow_post_crossposts allow_topcollapse_deleted_commentscomment_score_hide_mins descriptiondomainexclude_banned_modqueueheader_hover_texthide_ads key_colorlang link_typenameover_18public_descriptionpublic_traffic show_mediashow_media_preview spam_comments spam_linksspam_selfpostsspoilers_enabledsrsubmit_link_label submit_textsubmit_text_labelsubreddit_typesuggested_comment_sorttitle wiki_edit_agewiki_edit_karmawikimodec" (id|d|d|d|d|d|d|d|d | d | d | d | d | d|d|d|d|id|d|d|d|d|d|d|d|d|d|d|d|d|d|d | d!|!}#|#j|"|jtd"|##y)$Nr?r@rArBrCrDrErFz header-titlerHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYr[r\typer]r^r_ site_admindata)updatepostr )$_redditr?r@rArBrCrDrErFrGrHrIrJrKrLrMrNrOrPrQrRrSrTrUrVrWrXrYrZr[r\r]r^r_other_settingsmodels$ d/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/reddit/subreddit/subreddit.py_create_or_updatezSubreddit._create_or_updatesN" L" #%:"  "  ()B " &'> " ; "  f"  &'>"  -"  "  "  D"  "  D"  w" !"4!" " n#" $ *%" & !"4'" ( ])" * *+" , n-" .  0/" 0 "1" 2 !23" 4 ;5" 6 !27" 8 %&<9" : U;" < N=" > ]?" @ A" B C" H  ^$ Xl+% 8c |r5djt|g|Dcgc] }t|c}zSt|Scc}w)N,)joinstr)other_subreddits subredditxs rj_subreddit_listzSubreddit._subreddit_listsB 88S^,@P/Q1A/QQR R9~0RsA c |D]s}|jd}t|ts d}t|t t d|jddt jkrhd}t|y)Nmedia5'media' is required and must be a PostMedia instance.rpcaptionz'Caption must be 180 characters or less.)get isinstancer TypeErrorlenr r7MAX_CAPTION_LENGTH)imagesimagervmsgs rj_validate_galleryzSubreddit._validate_gallerysl %EIIg&EeY/Mn$tE599Y#;<=A]A]]?n$ %rlcRt|jts d}t|y)Nz%'media' must be a PostMedia instance.)r{rvrr|) inline_mediars rj_validate_inline_mediaz Subreddit._validate_inline_medias&,,,i89CC. 9rlct|dS)aProvide an instance of :class:`.SubredditRelationship`. For example, to ban a user try: .. code-block:: python reddit.subreddit("test").banned.add("spez", ban_reason="...") To list the banned users along with any notes, try: .. code-block:: python for ban in reddit.subreddit("test").banned(): print(f"{ban}: {ban.note}") bannedr(selfs rjrzSubreddit.banneds$%T844rlc:|j|j|S)aProvide an instance of :class:`.SubredditCollections`. To see the permalinks of all :class:`.Collection`\ s that belong to a subreddit, try: .. code-block:: python for collection in reddit.subreddit("test").collections: print(collection.permalink) To get a specific :class:`.Collection` by its UUID or permalink, use one of the following: .. code-block:: python collection = reddit.subreddit("test").collections("some_uuid") collection = reddit.subreddit("test").collections( permalink="https://reddit.com/r/SUBREDDIT/collection/some_uuid" ) )r<rgrs rj collectionszSubreddit.collectionss.00tDDrlct|dS)aProvide an instance of :class:`.ContributorRelationship`. Contributors are also known as approved submitters. To add a contributor try: .. code-block:: python reddit.subreddit("test").contributor.add("spez") contributor)r&rs rjrzSubreddit.contributors't];;rlct|S)aProvide an instance of :class:`.SubredditEmoji`. This attribute can be used to discover all emoji for a subreddit: .. code-block:: python for emoji in reddit.subreddit("test").emoji: print(emoji) A single emoji can be lazily retrieved via: .. code-block:: python reddit.subreddit("test").emoji["emoji_name"] .. note:: Attempting to access attributes of a nonexistent emoji will result in a :class:`.ClientException`. rrs rjemojizSubreddit.emoji'.d##rlct|S)zProvide an instance of :class:`.SubredditFilters`. For example, to add a filter, run: .. code-block:: python reddit.subreddit("all").filters.add("test") rrs rjfilterszSubreddit.filters@s %%rlct|S)aSProvide an instance of :class:`.SubredditFlair`. Use this attribute for interacting with a :class:`.Subreddit`'s flair. For example, to list all the flair for a subreddit which you have the ``flair`` moderator permission on try: .. code-block:: python for flair in reddit.subreddit("test").flair(): print(flair) Flair templates can be interacted with through this attribute via: .. code-block:: python for template in reddit.subreddit("test").flair.templates: print(template) rrs rjflairzSubreddit.flairMs*d##rlct|S)zProvide an instance of :class:`.SubredditModeration`. For example, to accept a moderation invite from r/test: .. code-block:: python reddit.subreddit("test").mod.accept_invite() r rs rjmodz Subreddit.modds#4((rlct|dS)aProvide an instance of :class:`.ModeratorRelationship`. For example, to add a moderator try: .. code-block:: python reddit.subreddit("test").moderator.add("spez") To list the moderators along with their permissions try: .. code-block:: python for moderator in reddit.subreddit("test").moderator(): print(f"{moderator}: {moderator.mod_permissions}") moderator)r'rs rjrzSubreddit.moderatorqs$%T;77rlct|S)aHProvide an instance of :class:`.Modmail`. For example, to send a new modmail from r/test to u/spez with the subject ``"test"`` along with a message body of ``"hello"``: .. code-block:: python reddit.subreddit("test").modmail.create(subject="test", body="hello", recipient="spez") r"rs rjmodmailzSubreddit.modmailst}rlct|dS)a Provide an instance of :class:`.SubredditRelationship`. For example, muted users can be iterated through like so: .. code-block:: python for mute in reddit.subreddit("test").muted(): print(f"{mute}: {mute.date}") mutedrrs rjrzSubreddit.muteds%T733rlct|S)a{Provide an instance of :class:`.SubredditQuarantine`. This property is named ``quaran`` because ``quarantine`` is a subreddit attribute returned by Reddit to indicate whether or not a subreddit is quarantined. To opt-in into a quarantined subreddit: .. code-block:: python reddit.subreddit("test").quaran.opt_in() r$rs rjquaranzSubreddit.quaran#4((rlct|S)arProvide an instance of :class:`.SubredditRules`. Use this attribute for interacting with 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" ) rrs rjruleszSubreddit.rulesrrlct|S)aSProvide an instance of :class:`.SubredditStream`. Streams can be used to indefinitely retrieve new comments made to a subreddit, like: .. code-block:: python for comment in reddit.subreddit("test").stream.comments(): print(comment) Additionally, new submissions can be retrieved via the stream. In the following example all submissions are fetched via the special r/all: .. code-block:: python for submission in reddit.subreddit("all").stream.submissions(): print(submission) r)rs rjstreamzSubreddit.streams*t$$rlct|S)aProvide an instance of :class:`.SubredditStylesheet`. For example, to add the css data ``.test{color:blue}`` to the existing stylesheet: .. code-block:: python subreddit = reddit.subreddit("test") stylesheet = subreddit.stylesheet() stylesheet.stylesheet += ".test{color:blue}" subreddit.stylesheet.update(stylesheet.stylesheet) r+rs rj stylesheetzSubreddit.stylesheetrrlct|S)avProvide an instance of :class:`.SubredditWidgets`. **Example usage** Get all sidebar widgets: .. code-block:: python for widget in reddit.subreddit("test").widgets.sidebar: print(widget) Get ID card widget: .. code-block:: python print(reddit.subreddit("test").widgets.id_card) )r/rs rjwidgetszSubreddit.widgetss( %%rlct|S)aProvide an instance of :class:`.SubredditWiki`. This attribute can be used to discover all wikipages for a subreddit: .. code-block:: python for wikipage in reddit.subreddit("test").wiki: print(wikipage) To fetch the content for a given wikipage try: .. code-block:: python wikipage = reddit.subreddit("test").wiki["proof"] print(wikipage.content_md) r-rs rjwikizSubreddit.wiki s&T""rlcH|jjjdS)zThe class's kind.rr)rgconfigkindsrs rj_kindzSubreddit._kinds||""((55rlc||fjddk7r d}t||r||_t|||t dj ||_y)a{Initialize a :class:`.Subreddit` instance. :param reddit: An instance of :class:`.Reddit`. :param display_name: The name of the subreddit. .. note:: This class should not be initialized directly. Instead, obtain an instance via: .. code-block:: python subreddit = reddit.subreddit("test") Nz2Either 'display_name' or '_data' must be provided._datarrrr)countr|r:super__init__r format_path)rredditr:rr __class__s rjrzSubreddit.__init__#sc* % & &t , 1FCC.  ,D  u-k*11D1A rlcZ|dd}|jjtd|dS)zConvert a Markdown string to a dict for use with the ``richtext_json`` param. :param markdown_text: A Markdown string to convert. :returns: A dict in ``richtext_json`` format. rtjson) markdown_text output_modeconvert_rte_bodyrcoutput)rgrfr )rr text_datas rj_convert_to_fancypantsz Subreddit._convert_to_fancypants@s3'4HM ||  *nd|!j|jd2|"j|j?|j+|||4S|||d@<||j dA|3| r| |d<n|j dBC| rr| J| j4dHi| j7D$%cic]\}$}%|$|j9|%c}%}$}&|j t;|j=|&Dn|j | E|jj)tdF|GScc}}wcc}}wcc}wcc}%}$w)Ia"Add a submission to the :class:`.Subreddit`. :param title: The title of the submission. :param collection_id: The UUID of a :class:`.Collection` to add the newly-submitted post to. :param discussion_type: Set to ``"CHAT"`` to enable live discussion instead of traditional comments (default: ``None``). :param draft_id: The ID of a draft to submit. Only applies to text and link submissions. :param flair_id: The flair template to select (default: ``None``). :param flair_text: If the template's ``flair_text_editable`` value is ``True``, this value will set a custom text (default: ``None``). ``flair_id`` is required when ``flair_text`` is provided. :param gallery: A list of images to post as a gallery. Each item is either a :class:`.PostMedia` or a ``dict`` with the structure ``{"media": PostMedia("path"), "caption": "caption", "outbound_url": "url"}``, where only ``media`` is required. :param image: The :class:`.PostMedia` image to upload and post. :param inline_media: A dict of :class:`.InlineMedia` objects where the key is the placeholder name in ``selftext``. Only supported for text submissions. :param nsfw: Whether the submission should be marked NSFW (default: ``False``). :param poll: A ``dict`` with the structure ``{"duration": 3, "options": ["Yes", "No"]}``, where ``duration`` is the number of days the poll should accept votes (between ``1`` and ``7``, inclusive) and ``options`` is a list of two to six poll options as ``str``. Both keys are required. :param resubmit: When ``False``, an error will occur if the URL has already been submitted (default: ``True``). :param selftext: The Markdown formatted content for a ``text`` submission or optional Markdown-formatted body text for any other kind of submission. Use an empty string, ``""``, to make a title-only submission. :param send_replies: When ``True``, messages will be sent to the submission author when comments are made to the submission (default: ``True``). :param spoiler: Whether the submission should be marked as a spoiler (default: ``False``). :param timeout: Specifies a particular timeout, in seconds, for the WebSockets connection used by ``image`` and ``video`` submissions. Use to avoid "Websocket error" exceptions (default: ``10``). :param url: The URL for a ``link`` submission. :param video: The video to upload and post. Either a :class:`.PostMedia` or a ``dict`` with the structure ``{"media": PostMedia("path"), "gif": True, "thumbnail": PostMedia("path")}``, where only ``media`` is required. Set ``"gif"`` to ``True`` to submit the video as a videogif, which is essentially a silent video (default: ``False``). When ``"thumbnail"`` is not provided, the PRAW logo will be used as the thumbnail. :param without_websockets: Set to ``True`` to disable use of WebSockets for ``image`` and ``video`` submissions (see note below for an explanation). If ``True``, this method doesn't return anything (default: ``False``). :returns: A :class:`.Submission` object for the newly created submission, unless ``without_websockets`` is ``True`` for an ``image`` or ``video`` submission. :raises: :class:`.ClientException` if ``image`` or a ``gallery`` item's ``media`` refers to a file that is not an image, or if the ``video`` (or its ``media``) refers to a file that is not a video. At least one of ``gallery``, ``image``, ``poll``, ``selftext``, ``url``, or ``video`` must be provided. ``gallery``, ``image``, ``poll``, ``url``, and ``video`` are mutually exclusive, while ``selftext`` may accompany any of them as optional Markdown-formatted body text. ``selftext`` that accompanies another kind of submission does not support ``inline_media``. For example, to submit a URL to r/test do: .. code-block:: python title = "PRAW documentation" url = "https://praw.readthedocs.io" reddit.subreddit("test").submit(title, url=url) To submit an image to r/test do: .. code-block:: python from praw.models import PostMedia title = "My favorite picture" image = PostMedia("/path/to/image.png") reddit.subreddit("test").submit(title, image=image) To submit an image gallery to r/test do: .. code-block:: python from praw.models import PostMedia title = "My favorite pictures" gallery = [ PostMedia("/path/to/image.png"), { "media": PostMedia("/path/to/image2.png"), "caption": "Image caption 2", }, { "media": PostMedia("/path/to/image3.png"), "caption": "Image caption 3", "outbound_url": "https://example.com/link3", }, ] reddit.subreddit("test").submit(title, gallery=gallery) To submit a video to r/test do: .. code-block:: python from praw.models import PostMedia title = "My favorite movie" video = PostMedia("/path/to/video.mp4") reddit.subreddit("test").submit(title, video=video) To submit a videogif with a custom thumbnail instead, do: .. code-block:: python from praw.models import PostMedia title = "My favorite gif" video = { "gif": True, "media": PostMedia("/path/to/video.mp4"), "thumbnail": PostMedia("/path/to/thumbnail.png"), } reddit.subreddit("test").submit(title, video=video) To submit a poll to r/test do: .. code-block:: python title = "Do you like PRAW?" poll = {"duration": 3, "options": ["Yes", "No"]} reddit.subreddit("test").submit(title, poll=poll) To submit a self post with inline media do: .. code-block:: python from praw.models import InlineGif, InlineImage, InlineVideo, PostMedia gif = InlineGif(caption="optional caption", media=PostMedia("path/to/image.gif")) image = InlineImage(caption="optional caption", media=PostMedia("path/to/image.jpg")) video = InlineVideo(caption="optional caption", media=PostMedia("path/to/video.mp4")) selftext = "Text with a gif {gif1} an image {image1} and a video {video1} inline" media = {"gif1": gif, "image1": image, "video1": video} reddit.subreddit("test").submit("title", inline_media=media, selftext=selftext) .. note:: Inserted media will have a padding of ``\\n\\n`` automatically added. This is due to the weirdness with Reddit's API. Using the example above, the result selftext body will look like so: .. code-block:: Text with a gif ![gif](u1rchuphryq51 "optional caption") an image ![img](srnr8tshryq51 "optional caption") and video ![video](gmc7rvthryq51 "optional caption") inline .. note:: For ``image`` and ``video`` submissions, Reddit's API uses WebSockets to respond with the link of the newly created post. If this fails, the method will raise :class:`.WebSocketException`. Occasionally, the Reddit post will still be created. More often, there is an error with the media file. If you frequently get exceptions but successfully created posts, try setting the ``timeout`` parameter to a value above 10. To disable the use of WebSockets, set ``without_websockets=True``. This will make the method return ``None``, though the post will still be created. You may wish to do this if you are running your program in a restricted network environment, or using a proxy that doesn't support WebSockets connections. .. note:: To submit a post to a subreddit with the ``"news"`` flair, you can get the flair id like this: .. code-block:: choices = list(subreddit.flair.link_templates.user_selectable()) template_id = next(x for x in choices if x["flair_text"] == "news")["flair_template_id"] subreddit.submit("title", flair_id=template_id, url="https://www.news.com/") rrrrrNrzKOnly one of 'gallery', 'image', 'poll', 'url', or 'video' can be provided (z, c32K|]}t|ywrrepr).0rLs rj z#Subreddit.submit..=s jKy}jnosjtjKz given).rryz[At least one of 'gallery', 'image', 'poll', 'selftext', 'url', or 'video' must be provided.zl'inline_media' is only supported for text submissions. Only Markdown text can be used for the selftext of a z submission.T)r  sendrepliesr rVr\validate_on_submitrrrr rvr)api_typeitemsshow_error_listtextr&rxr)expected_mime_prefixr outbound_url)rxrr*POSTsubmit_gallery_post)rmethodrerrorsrdrr durationoptionsz'poll' contains invalid keys: c32K|]}t|ywrrr rs rjr!z#Subreddit.submit..ws@ksc@kr".z!'poll' is missing required keys: c32K|]}t|ywrrr2s rjr!z#Subreddit.submit..{sCnRUDICnr")r/r0r(submit_poll_post)r)r))kindr)rdrr>gifrv thumbnailz'video' contains invalid keys: c32K|]}t|ywrrr2s rjr!z#Subreddit.submit..sAlPS$s)Alr"rwzPostMedia | Noner8rz PRAW logo.pngr7videogif)r6rvideo_poster_urlrlinkr)r6) richtext_json)r(rrcr)r}ror|boolrprer{rrappendrzr rrgrequestr rrkeyssortedrfrr__file__absoluteparentrr&rrr)'rr\rrrrr rrrr rr rr r rrrrrLvalueprovidedrr6rdritemr image_itemr invalid_keys missing_keys video_mediathumbnail_media logo_path placeholderrvbodys' rjrzSubreddit.submitYs[vG$%  %    e       x=1 _`d`i`ijKBJjKaK`LLTUCC. &x{D <h8r>oCC. D,ABFAIIUVCC. J -G}d)"&   !-0"O4X&z*   U   J    U\8MQ:dI#>$DH8F8  " "6 * KKr4K H#'V $  W $$)~~i< $[*W2E F N N -4$-!O! %/NN>2$F& ||++f8TiKj+klrsH!(();<<<<**x/?/F*G G>Z  99;*i)@@L6tyy@kV\]iVj@k7k6llmnn$& 2TYY[@L9$))CnY_`lYmCn:n9oopqn$ KKj)Y!)!5X2   <<$$X.@%A$M M  #'V KKW%-- [b-*cK d%%4Ug%h h  %+ %( ::<*GGL7 AlW]^jWkAl8l7mmnon$))G,Kk95Mn$"#5uyy7MNO& N335<<CCJJQQT\\_nn "+C N";#'V KK#(99U#3Z'' 7'S!0!8!8!F   %%4Ug%h h  'D  ? KKVK -'V KKVK $+++&x\h\n\n\p*FXkSXK!:!:5!AA* %0K0KD0Q*R S  *||  (!3$ ??I  >  8d*sV!V ?V$V))rqczdd|j||d}|jjtd|y)aSubscribe to the subreddit. :param other_subreddits: When provided, also subscribe to the provided list of subreddits. For example, to subscribe to r/test: .. code-block:: python reddit.subreddit("test").subscribe() subTrqrr)actionskip_inital_defaultssr_name subscribercNrtrgrfr rrqrds rjrWzSubreddit.subscribesD$(++=MY]+^  (;/d;rlcf|jjtdj|S)a%Return a dictionary of the :class:`.Subreddit`'s traffic statistics. :raises: ``prawcore.NotFound`` when the traffic stats aren't available to the authenticated user, that is, they are not public and the authenticated user is not a moderator of the subreddit. The traffic method returns a dict with three keys. The keys are ``day``, ``hour`` and ``month``. Each key contains a list of lists with 3 or 4 values. The first value is a timestamp indicating the start of the category (start of the day for the ``day`` key, start of the hour for the ``hour`` key, etc.). The second, third, and fourth values indicate the unique pageviews, total pageviews, and subscribers, respectively. .. note:: The ``hour`` key does not contain subscribers, and therefore each sub-list contains three values. For example, to get the traffic stats for r/test: .. code-block:: python stats = reddit.subreddit("test").traffic() about_trafficr)rgrzr rrs rjtrafficzSubreddit.traffics,4|| 9 @ @4 @ PQQrlcxd|j||d}|jjtd|y)aUnsubscribe from the subreddit. :param other_subreddits: When provided, also unsubscribe from the provided list of subreddits. To unsubscribe from r/test: .. code-block:: python reddit.subreddit("test").unsubscribe() unsubrS)rTrVrWrcNrXrYs rj unsubscribezSubreddit.unsubscribesA++=MY]+^  (;/d;rl)Hrg praw.Redditr? bool | Noner@rarArarBrarC int | NonerD str | NonerErcrFrarGrcrHrarIrcrJrcrKrcrLrcrMrarNrcrOrarPrarQrarRrarSrarTrarUrarVrcrWrcrXrcrYrcrZrcr[rcr\rcr]rbr^rbr_rcrhrreturnNone)rqz'Sequence[str | models.Subreddit] | Nonerrzmodels.Subredditrdrp)rz list[dict[str, str | PostMedia]]rdre)rmodels.InlineMediardre)rdr()rdr5)rdr&)rdr)rdr)rdr)rdr!)rdr')rdr#)rdr%)rdr)rdr*)rdr,)rdzmodels.SubredditWidgets)rdr.)rdrp)NN)rr`r:rcrzdict[str, Any] | Nonerdre)rrprddict)rdre)rdz'tuple[str, dict[str, RedditBase], None])rdzdict[Any, Any]rr=rr>rdmodels.Submission | None)rrfrdrf)rdzdict[str, str | int | bool]) rrprrprrprrprrrdzIterator[models.Submission])rr=rdmodels.Submission)r\rprrcrrcrrcrrcr rcr$dict[str, models.InlineMedia] | Noner r>r r>rrpr r>r r>rdri)r\rprrcrrcrrcrrcr rcr r>r r>rrcr r>r r>rrprdri)r\rprrcrrcrrcr rcrzmodels.PostMediar r>r r>rrcr r>r r>rr=rr>rdrh)r\rprrcrrcrrcr rcrz:list[models.PostMedia | dict[str, str | models.PostMedia]]r r>rrcr r>r r>rdri)r\rprrcrrcrrcr rcr r>rzdict[str, int | list[str]]r r>rrcr r>r r>rdri)r\rprrcrrcrrcr rcr r>r r>rrcr r>r r>rr=rz5models.PostMedia | dict[str, bool | models.PostMedia]rr>rdrh)(r\rprrcrrcrrcrrcr rcrzAlist[models.PostMedia | dict[str, str | models.PostMedia]] | Nonerzmodels.PostMedia | Nonerrjr r>rz!dict[str, int | list[str]] | Noner r>rrcr r>r r>rr=rrcrzrdrh)rqzlist[models.Subreddit] | Nonerdre)rdzdict[str, list[list[int]]])/__name__ __module__ __qualname____doc__r~MESSAGE_PREFIX STR_FIELD__annotations__ staticmethodrkrtrrr1rrrrrrrrrrrrrrrrpropertyrrrrrrrrrrr rrWr\r_ __classcell__)rs@rjr7r7.sF ENNI/."<<%)-1!%15.2"&!/3(, $ $ $#)-&*"&*.%)"&&*(,(,"&(,%)-1 $(&*#GL9L9"L9 + L9  L9 $/ L9",L9 L9L9"-L9&L9L9L9L9L9 !L9"#L9$'%L9&$'L9( )L9*(+L9,#-L9. /L90$1L92&3L94 5L96&7L98 9L9:&;L9<#=L9>!+?L9@AL9B"CL9D$EL9FGL9HIL9J KL9L9\A$ %%!! 55&EE0 < <$$0 & &$$, ) )88&   4 4)) $$0%%,)) &&*##(66$('+ BB!B% B  B: Y<%0%%003%0IM%0 !%0N![N  *G*G *G  *G  *G *G %*GX'(S2 %(&)""!$=@   "  $      ;         " %(&)""!$"   "  $               " %(&)"!$" #&''" ' $ '  '' '''''''!' "!''$ %(&)"!$"     "  $      L                %(&)"!$"   "  $      )         %(&)"!$" #&''" ' $ '  ''''''''E'!' "!'',%)&*##!%UY)-=A26#!NR#(+\@\@" \@ $ \@  \@\@\@S\@'\@;\@\@0\@\@\@ !\@"#\@$%\@&'\@(L)\@*!+\@, "-\@| NR<(R8PT<rs""55 SS:<'.3SS3A=G8G @G;F$2CJ< "7 V`J