{iSrSSKJr SSKJrJr SSKJr SSKJ r SSK J r \ (aSSK r SSK r "S S \5r"S S \5r"S S\5rg)aToken Manager classes. There should be a 1-to-1 mapping between an instance of a subclass of :class:`.BaseTokenManager` and a :class:`.Reddit` instance. A few proof of concept token manager classes are provided here, but it is expected that PRAW users will create their own token manager classes suitable for their needs. .. deprecated:: 7.4.0 Tokens managers have been deprecated and will be removed in the near future. ) annotations)ABCabstractmethod)Path) TYPE_CHECKING)_deprecate_argsNc\rSrSrSr\S Sj5r\S Sj5r\S Sj5r \ RS Sj5r Sr Sr g ) BaseTokenManagerz)An abstract class for all token managers.cg)aRHandle callback that is invoked after a refresh token is used. :param authorizer: The ``prawcore.Authorizer`` instance used containing ``access_token`` and ``refresh_token`` attributes. This function will be called after refreshing the access and refresh tokens. This callback can be used for saving the updated ``refresh_token``. Nself authorizers Q/home/james-whalen/.local/lib/python3.13/site-packages/praw/util/token_manager.pypost_refresh_callback&BaseTokenManager.post_refresh_callback cg)aYHandle callback that is invoked before refreshing PRAW's authorization. :param authorizer: The ``prawcore.Authorizer`` instance used containing ``access_token`` and ``refresh_token`` attributes. This callback can be used to inspect and modify the attributes of the ``prawcore.Authorizer`` instance, such as setting the ``refresh_token``. Nrrs rpre_refresh_callback%BaseTokenManager.pre_refresh_callback,rrcUR$)z@Return the :class:`.Reddit` instance bound to the token manager._redditrs rredditBaseTokenManager.reddit8s||rcDURb Sn[U5eXlg)Nz7'reddit' can only be set once and is done automatically)r RuntimeError)rvaluemsgs rrr=s! << #KCs# # rcSUlg)z1Initialize a :class:`.BaseTokenManager` instance.Nrrs r__init__BaseTokenManager.__init__Ds  rrNrzprawcore.auth.BaseAuthorizer)return praw.Reddit)r"r)) __name__ __module__ __qualname____firstlineno____doc__rrrpropertyrsetterr%__static_attributes__rrrr r s\3         ]] rr cD^\rSrSrSrSU4SjjrSSjrSSjrSrU=r $) FileTokenManagerIaProvides a single-file based token manager. It is expected that the file with the initial ``refresh_token`` is created prior to use. .. warning:: The same ``file`` should not be used by more than one instance of this class concurrently. Doing so may result in data corruption. Consider using :class:`.SQLiteTokenManager` if you want more than one instance of PRAW to concurrently manage a specific ``refresh_token`` chain. c.>[TU]5 Xlg)znInitialize a :class:`.FileTokenManager` instance. :param filename: The file the contains the refresh token. N)superr% _filename)rfilename __class__s rr%FileTokenManager.__init__Xs !rc[UR5RS5nURUR5 SSS5 g!,(df  g=f)z+Update the saved copy of the refresh token.wN)rr7openwrite refresh_tokenrrfps rr&FileTokenManager.post_refresh_callbackas9 $.. ! & &s +r HHZ-- ., + +s A  AcURcP[UR5R5nUR 5R 5UlSSS5 gg!,(df  g=f)z%Load the refresh token from the file.N)r?rr7r=readstripr@s rr%FileTokenManager.pre_refresh_callbackfsN  # # +dnn%**,+-779??+< (-, ,,,s $A A-)r7)r8strr') r*r+r,r-r.r%rrr1 __classcell__r9s@rr3r3Is "/ ==rr3c^\rSrSrSr\"SS5S U4Sjj5rSrSSjrSSjr SS jr SS jr SS jr S r U=r$)SQLiteTokenManagermaProvides a SQLite3 based token manager. Unlike, :class:`.FileTokenManager`, the initial database need not be created ahead of time, as it'll automatically be created on first use. However, initial refresh tokens will need to be registered via :meth:`.register` prior to use. .. warning:: This class is untested on Windows because we encountered file locking issues in the test environment. databasekeyc>[TU]5 SSKnURU5UlURR S5 URR S5 URR 5 X lg)aInitialize a :class:`.SQLiteTokenManager` instance. :param database: The path to the SQLite database. :param key: The key used to locate the refresh token. This ``key`` can be anything. You might use the ``client_id`` if you expect to have unique a refresh token for each ``client_id``, or you might use a redditor's ``username`` if you're managing multiple users' authentications. rNzACREATE TABLE IF NOT EXISTS tokens (id, refresh_token, updated_at)zNayrcURRSURU45 URR5 g)zSet the refresh token in the database. This function will overwrite an existing value if the corresponding ``key`` already exists. z2REPLACE INTO tokens VALUES (?, ?, datetime('now'))N)rRrSrNrT)rr?s r_setSQLiteTokenManager._sets;   @ XX} %  !rctURRSUR45nUR5SL$)z7Return whether ``key`` already has a ``refresh_token``.rWN)rRrSrNrX)rrZs r is_registered SQLiteTokenManager.is_registereds7!!)) 9DHH;  ,,rcHURUR5 SUlg)z)Update the refresh token in the database.N)r_r?rs rr(SQLiteTokenManager.post_refresh_callbacks ***+ $(  rcLURbeUR5Ulg)z)Load the refresh token from the database.N)r?r\rs rr'SQLiteTokenManager.pre_refresh_callbacks"''///#'99;  rcURRSURU45nURR5 URS:H$)zRegister the initial refresh token in the database. :returns: ``True`` if ``refresh_token`` is saved to the database, otherwise, ``False`` if there is already a ``refresh_token`` for the associated ``key``. z;INSERT OR IGNORE INTO tokens VALUES (?, ?, datetime('now'))r)rRrSrNrTrowcount)rr?rZs rregisterSQLiteTokenManager.registersL!!)) I XX} %  !!##r)rRrN)rMrGrNrG)r?rG)r(boolr')r?rGr(rl)r*r+r,r-r.r r%r\r_rbrrrjr1rHrIs@rrKrKmsF Z'(. "-(/ $ $rrK)r. __future__rabcrrpathlibrtypingrr prawcoreprawr r3rKrrrrtsN ## )s)X!='!=H^$)^$r