Fj-= dZddlmZddlmZddlmZmZddlm Z ddl m Z ddl m Z ddlmZmZmZdd lmZdd lmZerdd lmZdd lZdd lmZGddee eee ZGddZy )zProvide the Redditor class.) annotations)dumps) TYPE_CHECKINGAny)API_PATH)RedditorListingMixin) RedditBase) CreatedMixin FullnameMixinMessageableMixin)stream_generator)cachedproperty)IteratorN)modelsc"eZdZdZdZeddZeddZeddZ e ddZ e ddZ d dfd Z d fd Zd!fd Zd"d Zd#d Zd$dZd!dZd!dZddd%dZd&dZd'dZd(dZd)dZd!dZd!dZd!dZxZS)*RedditoraA class representing the users of Reddit. .. include:: ../../typical_attributes.rst .. note:: Shadowbanned accounts are treated the same as non-existent accounts, meaning that they will not have any attributes. .. note:: Suspended/banned accounts will only return the ``name`` and ``is_suspended`` attributes. ====================== ============================================================= Attribute Description ====================== ============================================================= ``comment_karma`` The comment karma for the :class:`.Redditor`. ``comments`` Provide an instance of :class:`.SubListing` for comment access. ``submissions`` Provide an instance of :class:`.SubListing` for submission access. ``created_utc`` Time the account was created, represented in `Unix Time`_. ``has_verified_email`` Whether or not the :class:`.Redditor` has verified their email. ``icon_img`` The url of the Redditors' avatar. ``id`` The ID of the :class:`.Redditor`. ``is_employee`` Whether or not the :class:`.Redditor` is a Reddit employee. ``is_friend`` Whether or not the :class:`.Redditor` is friends with the authenticated user. ``is_mod`` Whether or not the :class:`.Redditor` mods any subreddits. ``is_gold`` Whether or not the :class:`.Redditor` has active Reddit Premium status. ``is_suspended`` Whether or not the :class:`.Redditor` is currently suspended. ``link_karma`` The link karma for the :class:`.Redditor`. ``name`` The Redditor's username. ``subreddit`` If the :class:`.Redditor` has created a user-subreddit, provides a :class:`.UserSubreddit` with additional attributes. ====================== ============================================================= .. _unix time: https://en.wikipedia.org/wiki/Unix_time namec |dk(ry|||S)zDReturn an instance of :class:`.Redditor`, or ``None`` from ``data``.z [deleted]N)clsredditdatas Y/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/reddit/redditor.py from_datazRedditor.from_dataFs ; 64  c4ddlm}||j|S)aProvide an instance of :class:`.RedditorModNotes`. This provides an interface for managing moderator notes for a redditor. .. note:: The authenticated user must be a moderator of the provided subreddit(s). For example, all the notes for u/spez in r/test can be iterated through like so: .. code-block:: python redditor = reddit.redditor("spez") for note in redditor.notes.subreddits("test"): print(f"{note.label}: {note.note}") r)RedditorModNotes)praw.models.mod_notesr_reddit)selfrs rnoteszRedditor.notesMs( ; d33rct|S)aRProvide an instance of :class:`.RedditorStream`. Streams can be used to indefinitely retrieve new comments made by a redditor, like: .. code-block:: python for comment in reddit.redditor("spez").stream.comments(): print(comment) Additionally, new submissions can be retrieved via the stream. In the following example all submissions are fetched via the redditor u/spez: .. code-block:: python for submission in reddit.redditor("spez").stream.submissions(): print(submission) )RedditorStreamr s rstreamzRedditor.streames*d##rcH|jjjdS)zThe class's kind.redditor)rconfigkindsr$s r_kindzRedditor._kind|s||""((44rc4tdj|S)Nuserr,)rformatr$s r_pathzRedditor._paths&&D&11rNctd|||fDdk7r d}t||rt|trd|vsJdd|_|r||_n |r||_t|!||dy ) a7Initialize a :class:`.Redditor` instance. :param reddit: An instance of :class:`.Reddit`. :param name: The name of the redditor. :param fullname: The fullname of the redditor, starting with ``t2_``. Exactly one of ``name``, ``fullname`` or ``_data`` must be provided. c3&K|] }|d yw)Nr).0values r z$Redditor.__init__..sKU9JqKsr2z?Exactly one of 'name', 'fullname', or '_data' must be provided.rzPlease file a bug with PRAW.T _fullname)_data_extra_attribute_to_checkN) sum TypeError isinstancedict_listing_use_sortrr6super__init__)r rrfullnamer7msg __class__s rr?zRedditor.__init__s KtXu5K Kq PSCC. 5$'FeO .- .;!% DI %DN u Trch|dk(r|rddlm}|||j}t|||y)z"Objectify the subreddit attribute. subredditr) UserSubreddit)r7rN)!praw.models.reddit.user_subredditrErr> __setattr__)r rr4rErBs rrGzRedditor.__setattr__s/ ; 5 G!dllCE D%(rc(t|dr |j|j|_|j }|d}t ||j |}|jj|jt|)y)Nr6r)r7) hasattr_fetch_usernamer6r _fetch_datatyper__dict__updater>_fetch)r rotherrBs rrOzRedditor._fetchsp 4 %,,T^^`. For example, .. code-block:: python reddit.read_only = True for subreddit in reddit.redditor("reddit").moderated(): print(str(subreddit)) It is possible that requests made in read-only mode will also raise a ``prawcore.ServerError`` exception. When used in read-only mode, this method does not retrieve information about subreddits that require certain special permissions to access, e.g., private subreddits and premium-only subreddits. .. seealso:: :meth:`.User.moderator_subreddits` moderatedr-rpr$s rrszRedditor.moderated s2Z|| 5 < <$ < GHNBNrcf|jjtdj|S)zReturn a list of the redditor's public multireddits. For example, to get :class:`.Redditor` u/spez's multireddits: .. code-block:: python multireddits = reddit.redditor("spez").multireddits() multireddit_userr-rpr$s r multiredditszRedditor.multireddits8s-||); < C C C NOOrcxt|jjtdj |S)aReturn a list of the redditor's trophies. :returns: A list of :class:`.Trophy` objects. Return ``[]`` if the redditor has no trophies. :raises: :class:`.RedditAPIException` if the redditor doesn't exist. Usage: .. code-block:: python for trophy in reddit.redditor("spez").trophies(): print(trophy.name) print(trophy.description) trophiesr-)listrrYrr.r$s rrxzRedditor.trophiesDs1"DLL$$Xj%9%@%@d%@%KLMMrcd|jjtdd|jiy)anAdd the :class:`.Redditor` to your whitelist of trusted users. Trusted users will always be able to send you PMs. Example usage: .. code-block:: python reddit.redditor("spez").trust() Use the ``accept_pms`` parameter of :meth:`.Preferences.update` to toggle your ``accept_pms`` setting between ``"everyone"`` and ``"whitelisted"``. For example: .. code-block:: python # Accept private messages from everyone: reddit.user.preferences.update(accept_pms="everyone") # Only accept private messages from trusted users: reddit.user.preferences.update(accept_pms="whitelisted") You may trust a user even if your ``accept_pms`` setting is switched to ``"everyone"``. .. note:: You are allowed to have a user on your blocked list and your friends list at the same time. However, you cannot trust a user who is on your blocked list. .. seealso:: - :meth:`.distrust` - :meth:`.Preferences.update` - :meth:`.trusted` add_whitelistedrrhNrcr$s rtrustzRedditor.trustWs+J (#45VTYYrrc(eZdZdZddZddZddZy) r#z(Provides submission and comment streams.c||_y)z}Initialize a :class:`.RedditorStream` instance. :param redditor: The redditor associated with the streams. N)r')r r's rr?zRedditorStream.__init__s ! rc Vt|jjjfi|S)aYield new comments as they become available. Comments are yielded oldest first. Up to 100 historical comments will initially be returned. Keyword arguments are passed to :func:`.stream_generator`. For example, to retrieve all new comments made by redditor u/spez, try: .. code-block:: python for comment in reddit.redditor("spez").stream.comments(): print(comment) )r r'commentsnewr stream_optionss rrzRedditorStream.commentss$   6 6 : :MnMMrc Vt|jjjfi|S)aYield new submissions as they become available. Submissions are yielded oldest first. Up to 100 historical submissions will initially be returned. Keyword arguments are passed to :func:`.stream_generator`. For example, to retrieve all new submissions made by redditor u/spez, try: .. code-block:: python for submission in reddit.redditor("spez").stream.submissions(): print(submission) )r r' submissionsrrs rrzRedditorStream.submissionss$   9 9 = =PPPrN)r'rrr)rrrzIterator[models.Comment])rrrzIterator[models.Submission])rrrrr?rrrrrr#r#s2!N$Qrr#)r __future__rjsonrtypingrr praw.constrpraw.models.listing.mixinsrpraw.models.reddit.baser praw.models.reddit.mixinsr r r praw.models.utilr praw.util.cachercollections.abcrprawrrr#rrrrsX!"%;.SS-*(F>!5}lT^F>R -Q-Qr