Fj &dZddlmZddlmZmZddlmZddlm Z ddl m Z ddl m Z ddlmZdd lmZdd lmZdd lmZdd lmZerdd lmZddlZddlmZGddeZy)zProvides the User class.) annotations) TYPE_CHECKINGAny)Conflict)API_PATH)ReadOnlyException) Preferences)PRAWBase)ListingGenerator)Redditor) Subreddit)cachedproperty)IteratorN)modelsceZdZdZeddZdfd ZddZddZddddZ dd Z d d dd Z dd Z ddZ dd d ddZddZddZxZS)UserzOThe :class:`.User` class provides methods for the currently authenticated user.c,t|jS)apGet an instance of :class:`.Preferences`. The preferences can be accessed as a ``dict`` like so: .. code-block:: python preferences = reddit.user.preferences() print(preferences["show_link_flair"]) Preferences can be updated via: .. code-block:: python reddit.user.preferences.update(show_link_flair=True) The :meth:`.Preferences.update` method returns the new state of the preferences as a ``dict``, which can be used to check whether a change went through. Changes with invalid types or parameter names fail silently. .. code-block:: python original_preferences = reddit.user.preferences() new_preferences = reddit.user.preferences.update(invalid_param=123) print(original_preferences == new_preferences) # True, no change )r _redditselfs N/root/workspace/ytshorts/venv/lib/python3.12/site-packages/praw/models/user.py preferenceszUser.preferencess84<<((c(t||dy)zInitialize an :class:`.User` instance. This class is intended to be interfaced with through ``reddit.user``. N_data)super__init__)rreddit __class__s rrz User.__init__:s t,rcF|jjtdS)zAReturn a :class:`.RedditorList` of blocked :class:`.Redditor`\ s.blockedrgetrrs rr"z User.blockedBs|| 344rc >t|jtdfi|S)aReturn a :class:`.ListingGenerator` of contributor :class:`.Subreddit`\ s. These are subreddits in which the user is an approved user. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. To print a list of the subreddits that you are an approved user in, try: .. code-block:: python for subreddit in reddit.user.contributor_subreddits(limit=None): print(str(subreddit)) my_contributorr rrrgenerator_kwargss rcontributor_subredditszUser.contributor_subredditsFs!   h7G.H]L\]]rNuserc| tdn!tdjt|}|jj |S)aOReturn a :class:`.RedditorList` of friends or a :class:`.Redditor` in the friends list. :param user: Checks to see if you are friends with the redditor. Either an instance of :class:`.Redditor` or a string can be given. :returns: A list of :class:`.Redditor`\ s, or a single :class:`.Redditor` if ``user`` is specified. The :class:`.Redditor` instance(s) returned also has friend attributes. :raises: An instance of :class:`.RedditAPIException` if you are not friends with the specified :class:`.Redditor`. friends friend_v1r+)rformatstrrr$)rr,endpoints rr.z User.friendsXsC+/,8I&H[ 'C!$,,D :ID #&Ii  'rT) use_cachec|jjr d}t|d|jvs|s>|jj t d}t |j||_|jS)aReturn a :class:`.Redditor` instance for the authenticated user. :param use_cache: When ``True``, and if this function has been previously called, returned the cached version (default: ``True``). .. note:: If you change the :class:`.Reddit` instance's authorization, you might want to refresh the cached value. Prefer using separate :class:`.Reddit` instances, however, for distinct authorizations. z+`user.me()` does not work in read_only mode_memer)r read_onlyr__dict__r$rr r<)rr:msg user_datas rr=zUser.me~sb << ! !?C#C( (  %Y (($8I I>DHxxrc >t|jtdfi|S)aReturn a :class:`.ListingGenerator` subreddits that the user moderates. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. To print a list of the names of the subreddits you moderate, try: .. code-block:: python for subreddit in reddit.user.moderator_subreddits(limit=None): print(str(subreddit)) .. seealso:: :meth:`.Redditor.moderated` my_moderatorr'r(s rmoderator_subredditszUser.moderator_subredditss $  h~.F[JZ[[rcF|jjtdS)z@Return a list of :class:`.Multireddit`\ s belonging to the user.my_multiredditsr#rs r multiredditszUser.multiredditss||): ;<t|jtdfi|S)aReturn a :class:`.ListingGenerator` of :class:`.Subreddit`\ s the user is subscribed to. Additional keyword arguments are passed in the initialization of :class:`.ListingGenerator`. To print a list of the subreddits that you are subscribed to, try: .. code-block:: python for subreddit in reddit.user.subreddits(limit=None): print(str(subreddit)) my_subredditsr'r(s r subredditszUser.subredditss   h.G\K[\\rcF|jjtdS)a{Return a :class:`.RedditorList` of trusted :class:`.Redditor`\ s. To display the usernames of your trusted users and the times at which you decided to trust them, try: .. code-block:: python trusted_users = reddit.user.trusted() for user in trusted_users: print(f"User: {user.name}, time: {user.date}") trustedr#rs rrVz User.trusteds|| 344r)returnzmodels.Preferences)rz praw.RedditrWNone)rWzlist[models.Redditor])r)rrWzIterator[models.Subreddit])r,zstr | models.Redditor | NonerWz'list[models.Redditor] | models.Redditor)rWz&dict[models.Subreddit, dict[str, int]])r:boolrWzmodels.Redditor | None)rWzlist[models.Multireddit])rPzmodels.SubmissionrHz int | NonerIrYrWzmodels.Submission | None)__name__ __module__ __qualname____doc__rrrr"r*r.r4r=rDrGrQrTrV __classcell__)r s@rrrsY)):-5^$?C*"*'+*\(= CGVZ8+85?8OS8 !8t] 5rr)r] __future__rtypingrrprawcorer praw.constrpraw.exceptionsr praw.modelsr praw.models.baser praw.models.listing.generatorr praw.models.reddit.redditorr praw.models.reddit.subredditr praw.util.cachercollections.abcrprawrrrrrmsC"%-#%:02*(i58i5r