{i4SrSSKJr SSKJr SSKJrJrJr SSK J r SSK J r SS K Jr SS KJr SS KJr SS KJrJr \(aSS Kr"SS\5r"SS\5r"SS\5r"SS\5rg )zProvide the helper classes.) annotations)dumps) TYPE_CHECKINGAny Generator)API_PATH)_deprecate_args)PRAWBase)Draft) LiveThread) Multireddit SubredditNc \rSrSrSrS S SjjrS SjrSSSSSSSSSSSS. SS jjrS rg) DraftHelperzProvide a set of functions to interact with :class:`.Draft` instances. .. note:: The methods provided by this class will only work on the currently authenticated user's :class:`.Draft`\ s. NcPUb[URUS9$UR5$)ahReturn a list of :class:`.Draft` instances. :param draft_id: When provided, this returns a :class:`.Draft` instance (default: ``None``). :returns: A :class:`.Draft` instance if ``draft_id`` is provided. Otherwise, a list of :class:`.Draft` objects. .. note:: Drafts fetched using a specific draft ID are lazily loaded, so you might have to access an attribute to get all the expected attributes. This method can be used to fetch a specific draft by ID, like so: .. code-block:: python draft_id = "124862bc-e1e9-11eb-aa4f-e68667a77cbb" draft = reddit.drafts(draft_id) print(draft) id)r _reddit _draft_list)selfdraft_ids M/home/james-whalen/.local/lib/python3.13/site-packages/praw/models/helpers.py__call__DraftHelper.__call__s*2  (3 3!!cHURR[SSS0S9$)zZGet a list of :class:`.Draft` instances. :returns: A list of :class:`.Draft` instances. draftsmd_bodyTparamsrgetr rs rrDraftHelper._draft_list:s( || 2It;LMMrFT flair_id flair_textis_public_linknsfworiginal_contentselftext send_repliesspoiler subreddittitleurlc  U(aU (a Sn [U 5e[U [5(aURR U 5n [ R "SUUUUUUUUU U U S. U D6nURR[SUS9$)aCreate a new :class:`.Draft`. :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 is_public_link: Whether to enable public viewing of the draft before it is submitted (default: ``False``). :param nsfw: Whether the draft should be marked NSFW (default: ``False``). :param original_content: Whether the submission should be marked as original content (default: ``False``). :param selftext: The Markdown formatted content for a text submission draft. Use ``None`` to make a title-only submission draft (default: ``None``). ``selftext`` can not be provided if ``url`` is provided. :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 subreddit: The subreddit to create the draft for. This accepts a subreddit display name, :class:`.Subreddit` object, or :class:`.UserSubreddit` object. If ``None``, the :class:`.UserSubreddit` of currently authenticated user will be used (default: ``None``). :param title: The title of the draft (default: ``None``). :param url: The URL for a ``link`` submission draft (default: ``None``). ``url`` can not be provided if ``selftext`` is provided. Additional keyword arguments can be provided to handle new parameters as Reddit introduces them. :returns: The new :class:`.Draft` object. z4Exactly one of 'selftext' or 'url' must be provided.r(draftdata) TypeError isinstancestrrr1r _prepare_datapostr )rr)r*r+r,r-r.r/r0r1r2r3 draft_kwargsmsgr7s rcreateDraftHelper.createBsd HCC. i % % ..y9I""  !)-%    ||  '!2 >>rr8)N)r str | Nonereturnz+list[praw.models.Draft] | praw.models.Draft)rCzlist[praw.models.Draft])r)rBr*rBr+boolr,rDr-rDr.rBr/rDr0rDr1z>str | praw.models.Subreddit | praw.models.UserSubreddit | Noner2rBr3rBr>rrCzpraw.models.Draft) __name__ __module__ __qualname____firstlineno____doc__rrr@__static_attributes__r8rrrrs&*""" 4":N $!%$!&#!  F?F? F?  F?  F?F?F?F?F? KF?F?F? !F?" #F?F?rrcz\rSrSrSrSSjr\"SSSS5SS SS .SS jj5rSS jrSS jr Sr g) LiveHelperzDProvide a set of functions to interact with :class:`.LiveThread`\ s.c*[URUS9$)zReturn a new lazy instance of :class:`.LiveThread`. This method is intended to be used as: .. code-block:: python livethread = reddit.live("ukaeu1ik4sw5") :param id: A live thread ID, e.g., ``ukaeu1ik4sw5``. r)rr)rrs rrLiveHelper.__call__s$,,2..rr2 descriptionr, resourcesNF)rPr,rQcNURR[SUUUUS.S9$)aCreate a new :class:`.LiveThread`. :param title: The title of the new :class:`.LiveThread`. :param description: The new :class:`.LiveThread`'s description. :param nsfw: Indicate whether this thread is not safe for work (default: ``False``). :param resources: Markdown formatted information that is useful for the :class:`.LiveThread`. :returns: The new :class:`.LiveThread` object. livecreate)rPr,rQr2r6)rr=r )rr2rPr,rQs rr@LiveHelper.creates9*||  \ "*& !  rcf^^[T[5(d Sn[U5eUU4SjnU"5$)aFetch information about each live thread in ``ids``. :param ids: A list of IDs for a live thread. :returns: A generator that yields :class:`.LiveThread` instances. :raises: ``prawcore.ServerError`` if invalid live threads are requested. Requests will be issued in batches for each 100 IDs. .. note:: This method doesn't support IDs for live updates. .. warning:: Unlike :meth:`.Reddit.info`, the output of this method may not reflect the order of input. Usage: .. code-block:: python ids = ["3rgnbke2rai6hen7ciytwcxadi", "sw7bubeycai6hey4ciytwamw3a", "t8jnufucss07"] for thread in reddit.live.info(ids): print(thread.title) zids must be a listc3># [S[T5S5HTnTXS-n[SRSR U5S9nSS0nTR R X#S9ShvN MV gN 7f)Nrd live_info,)idslimitr")rangelenr formatjoinrr%)position ids_chunkr3r#rZrs r generator"LiveHelper.info..generatorsv!!SXs3c>: {+22sxx 7J2K!3<<++C+??? 4@sA&A5)A3* A5)r:listr9)rrZr?rbs`` rinfoLiveHelper.infos1:#t$$&CC.  @{rcFURR[S5$)zGet the currently featured live thread. :returns: The :class:`.LiveThread` object, or ``None`` if there is no currently featured live thread. Usage: .. code-block:: python thread = reddit.live.now() # LiveThread object or None live_nowr$r&s rnowLiveHelper.nows|| 455rr8)rr;rCpraw.models.LiveThread) r2r;rPrBr,rDrQr;rCrk)rZz list[str]rCz-Generator[praw.models.LiveThread, None, None])rCzpraw.models.LiveThread | None) rErFrGrHrIrr r@rerirJr8rrrLrLspO /WmV[A #'           B <(T 6rrLc \rSrSrSr\"SS5SSj5r\"SSSS S S S 5S S S SSS.SSjj5rSrg )MultiredditHelperz9Provide a set of functions to interact with multireddits.redditornamec>SUSU3n[URXS.S9$)zReturn a lazy instance of :class:`.Multireddit`. :param name: The name of the multireddit. :param redditor: A redditor name or :class:`.Redditor` instance who owns the multireddit. z/user/z/m/)rppath)_data)rr)rrprorrs rrMultiredditHelper.__call__s*zTF+4<</KLLr display_name subredditsdescription_md icon_name key_color visibilityweighting_schemeNprivateclassic)rwrxryrzr{c UUUUUVs/sHnS[U50PM snUUS.n URR[SS[ U 50S9$s snf)aCreate a new :class:`.Multireddit`. :param display_name: The display name for the new multireddit. :param subreddits: Subreddits to add to the new multireddit. Can be a list of either :class:`.Subreddit` instances or subreddit display names. :param description_md: Description for the new multireddit, formatted in markdown. :param icon_name: Can be one of: ``"art and design"``, ``"ask"``, ``"books"``, ``"business"``, ``"cars"``, ``"comics"``, ``"cute animals"``, ``"diy"``, ``"entertainment"``, ``"food and drink"``, ``"funny"``, ``"games"``, ``"grooming"``, ``"health"``, ``"life advice"``, ``"military"``, ``"models pinup"``, ``"music"``, ``"news"``, ``"philosophy"``, ``"pictures and gifs"``, ``"science"``, ``"shopping"``, ``"sports"``, ``"style"``, ``"tech"``, ``"travel"``, ``"unusual stories"``, ``"video"``, or ``None``. :param key_color: RGB hex color code of the form ``"#FFFFFF"``. :param visibility: Can be one of: ``"hidden"``, ``"private"``, or ``"public"`` (default: ``"private"``). :param weighting_scheme: Can be one of: ``"classic"`` or ``"fresh"`` (default: ``"classic"``). :returns: The new :class:`.Multireddit` object. rp)rwrurxryrvrzr{multireddit_basemodelr6)r;rr=r r) rrwrurxryrvrzr{subrs rr@MultiredditHelper.createsqX-(""9CD#FCH-D$ 0 ||  ' (u/F!  EsA r8)rpr;rozstr | praw.models.RedditorrCpraw.models.Multireddit)rwrBrur;rxrBryrBrvzstr | praw.models.Subredditrzr;r{r;rCr) rErFrGrHrIr rr@rJr8rrrmrmsCZ( M M&@ M  M) M&* $ $# )- #-  -  -  - 0- - -  !- - rrmcr\rSrSrSrSSjr\"SSSSS5S S S S S .SSjj5rSrg )SubredditHelperi?z7Provide a set of functions to interact with Subreddits.cUR5nUS:XaURR5$US:XaURRSS9$[URUS9$)zaReturn a lazy instance of :class:`.Subreddit`. :param display_name: The name of the subreddit. randomrandnsfwT)r,)ru)lowerrrandom_subredditr)rru lower_names rrSubredditHelper.__call__Bs^ "'')  !<<002 2  #<<00d0; ;LAArrpr2 link_typesubreddit_typewikimodeanypublicNdisabled)rrr2rc r[R"SURUUUU=(d UUS.UD6 U"U5$)aCCreate a new :class:`.Subreddit`. :param name: The name for the new subreddit. :param link_type: The types of submissions users can make. One of ``"any"``, ``"link"``, or ``"self"`` (default: ``"any"``). :param subreddit_type: One of ``"archived"``, ``"employees_only"``, ``"gold_only"``, ``"gold_restricted"``, ``"private"``, ``"public"``, or ``"restricted"`` (default: ``"public"``). :param title: The title of the subreddit. When ``None`` or ``""`` use the value of ``name``. :param wikimode: One of ``"anyone"``, ``"disabled"``, or ``"modonly"`` (default: ``"disabled"``). Any keyword parameters not provided, or set explicitly to ``None``, will take on a default value assigned by the Reddit server. .. seealso:: :meth:`~.SubredditModeration.update` for documentation of other available settings. )rrrprr2rr8)r_create_or_updater)rrprrr2rother_settingss rr@SubredditHelper.createQsHB ## LL)-4   Dzrr8)rur;rCpraw.models.Subreddit)rpr;rr;rr;r2rBrr;rrBrCr) rErFrGrHrIrr r@rJr8rrrr?sA BVWk3CZP & ")) )  )  ))%) )Q)rr)rI __future__rjsonrtypingrrrconstr utilr baser reddit.draftr reddit.liver reddit.multirr praw.modelsprawrrLrmrr8rrrse!"00"#0u?(u?pg6g6TG G T<h<r