FjdZddlmZddlmZmZddlmZddlm Z ddl m Z ddl m Z ddlmZer dd lmZdd lmZGd d e Zy )zProvide the Subreddits class.) annotations) TYPE_CHECKINGAny)API_PATH) Subreddit)PRAWBase)ListingGenerator)stream_generator)Iterator)modelsceZdZdZeddZddZddZddZddZ d ddZ dd Z d d d  dd Z ddZ y) SubredditszDSubreddits is a Listing class that provides various subreddit lists.c\dj|Dcgc] }t|c}Scc}w)N,)joinstr)subreddit_listxs T/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/subreddits.py_to_listzSubreddits._to_lists#xx8AQ8998s)c >t|jtdfi|S)zReturn a :class:`.ListingGenerator` for default subreddits. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. subreddits_defaultr _redditrselfgenerator_kwargss rdefaultzSubreddits.default!  h7K.LaP`aac >t|jtdfi|S)zReturn a :class:`.ListingGenerator` for new subreddits. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. subreddits_newrrs rnewzSubreddits.new#s!  h7G.H]L\]]r c >t|jtdfi|S)zReturn a :class:`.ListingGenerator` for popular subreddits. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. subreddits_popularrrs rpopularzSubreddits.popular,rr c >t|jtdfi|S)zReturn a :class:`.ListingGenerator` for premium subreddits. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. subreddits_premiumrrs rpremiumzSubreddits.premium5rr Nct|ts d}t||t|ts d}t|d|j|xsgi}tdj |j|}|j j||Dcgc]}t|j |dc}Scc}w)aaReturn subreddits recommended for the given list of subreddits. :param subreddits: A list of :class:`.Subreddit` instances and/or subreddit names. :param omit_subreddits: A list of :class:`.Subreddit` instances and/or subreddit names to exclude from the results (Reddit's end may not work as expected). zsubreddits must be a listz&omit_subreddits must be a list or Noneomitsub_recommended) subreddits)paramssr_name) isinstancelist TypeErrorrrformatrgetr)rr-omit_subredditsmsgr.urlsubs r recommendedzSubreddits.recommended>s*d+-CC.  &z/4/P:CC. (. o>SQS0T'U()00DMM*c f|j|d|t|jtdfi|S)aReturn a :class:`.ListingGenerator` of subreddits matching ``query``. Subreddits are searched by both their title and description. :param query: The query string to filter subreddits by. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. .. seealso:: :meth:`.search_by_name` to search by subreddit names r.) argumentskeyqsubreddits_search)_safely_add_argumentsr rr)rqueryrs rsearchzSubreddits.searchVs7 ""-=8u"U h7J.K`O_``r FT)exact include_nsfwc|jjtd|||d}|dDcgc]}|jj|c}Scc}w)a?Return list of :class:`.Subreddit`\ s whose names begin with ``query``. :param query: Search for subreddits beginning with this string. :param exact: Return only exact matches to ``query`` (default: ``False``). :param include_nsfw: Include subreddits labeled NSFW (default: ``True``). subreddits_name_search)rBinclude_over_18r@)datanames)rpostr subreddit)rr@rBrCresultrs rsearch_by_namezSubreddits.search_by_namehsY"" - . \ER# 4:'?Ca &&q)CCCs"Ac .t|jfi|S)zYield new subreddits as they are created. Subreddits are yielded oldest first. Up to 100 historical subreddits will initially be returned. Keyword arguments are passed to :func:`.stream_generator`. )r r#)rstream_optionss rstreamzSubreddits.stream|s ;N;;r )rlist[str | models.Subreddit]returnr)rrrQIterator[models.Subreddit])N)r-rPr5z#list[str | models.Subreddit] | NonerQlist[models.Subreddit])r@rrrrQrR)r@rrBboolrCrTrQrS)rNrrQrR)__name__ __module__ __qualname____doc__ staticmethodrrr#r&r)r9rArLrOr rrrsN::b^bb@Di0i=i i0a,! DD D  D D( rds4#"%!%:-(r<r