
    {iB	                        S r SSKJr  SSKJrJrJr  SSKJr  SSK	J
r
  SSKJr  S	S
KJr  SSKJr  SSKJr  SSKJr  \(       a  SSKr " S S\5      r " S S\\\5      rg)z(Provide the SubredditListingMixin class.    )annotations)TYPE_CHECKINGAnyIterator)urljoin   )cachedproperty   )PRAWBase   )ListingGenerator   )BaseListingMixin)GildedListingMixin)RisingListingMixinNc                  V   ^  \ rS rSrSr\SS j5       r    SS jrS	U 4S jjrSr	U =r
$ )
CommentHelper   zMProvide a set of functions to interact with a :class:`.Subreddit`'s comments.c                B    [        U R                  R                  S5      $ )Nz	comments/)r   	subreddit_pathselfs    ^/home/james-whalen/.local/lib/python3.13/site-packages/praw/models/listing/mixins/subreddit.pyr   CommentHelper._path   s    t~~++[99    c                D    [        U R                  U R                  40 UD6$ )ae  Return a :class:`.ListingGenerator` for the :class:`.Subreddit`'s comments.

Additional keyword arguments are passed in the initialization of
:class:`.ListingGenerator`.

This method should be used in a way similar to the example below:

.. code-block:: python

    for comment in reddit.subreddit("test").comments(limit=25):
        print(comment.author)

)r   _redditr   )r   generator_kwargss     r   __call__CommentHelper.__call__   s       djjM<LMMr   c                B   > [         TU ]  UR                  SS9  Xl        g)z.Initialize a :class:`.CommentHelper` instance.N_data)super__init__r   r   )r   r   	__class__s     r   r&   CommentHelper.__init__,   s     **$7"r   )r   )returnstr)r   zstr | int | dict[str, str]r)   zIterator[praw.models.Comment])r   z-praw.models.Subreddit | SubredditListingMixin)__name__
__module____qualname____firstlineno____doc__propertyr   r    r&   __static_attributes____classcell__r'   s   @r   r   r      s:    W: :N"<N	&N$# #r   r   c                  D   ^  \ rS rSrSr\SS j5       rSU 4S jjrSrU =r	$ )SubredditListingMixin2   z?Adds additional methods pertaining to subreddit-like instances.c                    [        U 5      $ )zProvide an instance of :class:`.CommentHelper`.

For example, to output the author of the 25 most recent comments of r/test
execute:

.. code-block:: python

    for comment in reddit.subreddit("test").comments(limit=25):
        print(comment.author)

)r   r   s    r   commentsSubredditListingMixin.comments5   s     T""r   c                    > [         TU ]  XS9  g)ziInitialize a :class:`.SubredditListingMixin` instance.

:param reddit: An instance of :class:`.Reddit`.

r#   N)r%   r&   )r   redditr$   r'   s      r   r&   SubredditListingMixin.__init__D   s     	-r    )r)   r   )r;   zpraw.Redditr$   zdict[str, Any] | None)
r+   r,   r-   r.   r/   r	   r8   r&   r1   r2   r3   s   @r   r5   r5   2   s"    I# #. .r   r5   )r/   
__future__r   typingr   r   r   urllib.parser   
util.cacher	   baser   	generatorr   r   gildedr   risingr   praw.modelsprawr   r5   r=   r   r   <module>rH      sK    . " / /   )  ( " & &#H #>.,.@BT .r   