{iGdSrSSKJr SSKrSSKJrJr SSKJrJ r J r SSK J r SSK Jr SS KJr SS KJrJrJr \(a SS KJr SS KJr "S S\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r"SS\5r "SS\5r!g)z2Provides Authentication and Authorization classes.) annotationsN)ABCabstractmethod) TYPE_CHECKINGAnyCallable)Request)codes)const)InvalidInvocationOAuthExceptionResponseException)Response) Requestorc\rSrSrSr\S5rS S Sjjr\S4S Sjjr SSSjjr S SS jjr S r g)BaseAuthenticatorzEProvide the base authenticator object that stores OAuth2 credentials.cgNselfs G/home/james-whalen/.local/lib/python3.13/site-packages/prawcore/auth.py_authBaseAuthenticator._auths Nc(XlX lX0lg)aRepresent a single authentication to Reddit's API. :param requestor: An instance of :class:`.Requestor`. :param client_id: The OAuth2 client ID to use with the session. :param redirect_uri: The redirect URI exactly as specified in your OAuth application settings on Reddit. This parameter is required if you want to use the :meth:`~.Authorizer.authorize_url` method, or the :meth:`~.Authorizer.authorize` method of the :class:`.Authorizer` class (default: ``None``). N _requestor client_id redirect_uri)r requestorr!r"s r__init__BaseAuthenticator.__init__s"$"(rokc URRSUUR5[UR 55SS0S9nUR U:wa [ U5eU$)Npost Connectionclose)authdataheaders)r requestrsorteditems status_coder)rurlsuccess_statusr,responses r_postBaseAuthenticator._post0sb??**   %!7+ +    > 1#H- -rcURc Sn[U5eU(a"[U[5(d Sn[U5eU(aUS:wa Sn[U5eURUURU(aSOSSR U5US.nUR R[R-n[S XvS 9nUR5R$) aReturn the URL used out-of-band to grant access to your application. :param duration: Either ``"permanent"`` or ``"temporary"``. ``"temporary"`` authorizations generate access tokens that last only 1 hour. ``"permanent"`` authorizations additionally generate a refresh token that can be indefinitely used to generate new hour-long access tokens. Only ``"temporary"`` can be specified if ``implicit`` is set to ``True``. :param scopes: A list of OAuth scopes to request authorization for. :param state: A string that will be reflected in the callback to ``redirect_uri``. Elements must be printable ASCII characters in the range ``0x20`` through ``0x7E`` inclusive. This value should be temporarily unique to the client for whom the URL was generated. :param implicit: Use the implicit grant flow (default: ``False``). This flow is only available for ``UntrustedAuthenticators``. :returns: URL to be used out-of-band for granting access to your application. :raises: :class:`.InvalidInvocation` if ``redirect_uri`` is not provided, if ``implicit`` is ``True`` and an authenticator other than :class:`.UntrustedAuthenticator` is used, or ``implicit`` is ``True`` and ``duration`` is ``"permanent"``. redirect URI not providedzFOnly UntrustedAuthenticator instances can use the implicit grant flow. temporaryz>The implicit grant flow only supports temporary access tokens.tokencode )r!durationr" response_typescopestateGET)params) r"r isinstanceUntrustedAuthenticatorr!joinr reddit_urlr AUTHORIZATION_PATHr preparer2) rr=scopesr@implicitmsgrBr2r.s r authorize_urlBaseAuthenticator.authorize_url>s<    $-C#C( ( Jt-CDDX $C( ( K/RC#C( (  --(0WfXXf%  oo((5+C+CC%4 $$$rcSU0nUbX#S'URR[R-nUR"U40UD6 g)aAsk Reddit to revoke the provided token. :param token: The access or refresh token to revoke. :param token_type: When provided, hint to Reddit what the token type is for a possible efficiency gain. The value can be either ``"access_token"`` or ``"refresh_token"``. r:Ntoken_type_hint)r rFr REVOKE_TOKEN_PATHr5)rr: token_typer,r2s r revoke_tokenBaseAuthenticator.revoke_tokentsH  !&0" #oo((5+B+BB 3$rrr)r#rr!strr" str | NonereturnNone)r2rTr3intr,rrVrF) r=rTrIz list[str]r@rTrJboolrVrT)r:rTrQrUrVrW) __name__ __module__ __qualname____firstlineno____doc__rrr$r r5rLrR__static_attributes__rrrrrsO  $( )))! )  ),/4Dk  (+ CF   & 4%4%4% 4%  4% 4%l   rrcd\rSrSr%Sr\rS\S'S SjrSSjr SSjr SSjr SS jr SS jr S rg )BaseAuthorizerz6Superclass for OAuth2 authorization tokens and scopes.z tuple | typeAUTHENTICATOR_CLASScPXlUR5 UR5 g)zvRepresent a single authorization to Reddit's API. :param authenticator: An instance of :class:`.BaseAuthenticator`. N)_authenticator_clear_access_token_validate_authenticator)r authenticators rr$BaseAuthorizer.__init__s" ,   " $$&rc$U SUlSUlgr) access_tokenrIrs rrg"BaseAuthorizer._clear_access_tokens (,'+ rc URRR[R-n[ R "5nURR "S SU0UD6nUR5nSU;a[XESURS55eUS- US-Ul USUl SU;a USUl [USRS 55Ulg) Nr2errorerror_description expires_inrl refresh_tokenr?r<r)rfr rFr ACCESS_TOKEN_PATHtimer5jsonrget_expiration_timestamprlrssetsplitrI)rr,r2pre_request_timer4payloads r_request_tokenBaseAuthorizer._request_tokens!!,,77%:Q:QQ99;&&,,===--/ g  '*GKK8K,L &6%:W\=R%R"#N3 g %!(!9D ''*0056 rcd[URUR5(dSn[UR[5(aUSURRS3- nO[TU]XU5 X0lg)a-Represent a single authentication to Reddit's API. :param requestor: An instance of :class:`.Requestor`. :param client_id: The OAuth2 client ID to use with the session. :param client_secret: The OAuth2 client secret to use with the session. :param redirect_uri: The redirect URI exactly as specified in your OAuth application settings on Reddit. This parameter is required if you want to use the :meth:`~.Authorizer.authorize_url` method, or the :meth:`~.Authorizer.authorize` method of the :class:`.Authorizer` class (default: ``None``). N)superr$ client_secret)rr#r!rr" __class__s rr$TrustedAuthenticator.__init__s& |<*rc2URUR4$r)r!rrs rrTrustedAuthenticator._auths~~t1111r)rr) r#rr!rTrrTr"rUrVrWrVztuple[str, str]) r[r\r]r^r_rrr$rr` __classcell__rs@rrrsYOM3$( +++ + ! +  ++,22rrc"\rSrSrSrSSjrSrg)rDzCStore OAuth2 authentication credentials for installed applications.cURS4$)N)r!rs rrUntrustedAuthenticator._auths~~r!!rrNr)r[r\r]r^r_rr`rrrrDrDs M"rrDcv^\rSrSrSrSSSS.S U4SjjjrS SjrS SjrS SU4SjjjrS r U=r $) Authorizerz/Manages OAuth2 authorization tokens and scopes.N)post_refresh_callbackpre_refresh_callbackrscH>[TU]U5 X lX0lX@lg)aVRepresent a single authorization to Reddit's API. :param authenticator: An instance of a subclass of :class:`.BaseAuthenticator`. :param post_refresh_callback: When a single-argument function is passed, the function will be called prior to refreshing the access and refresh tokens. The argument to the callback is the :class:`.Authorizer` instance. This callback can be used to inspect and modify the attributes of the :class:`.Authorizer`. :param pre_refresh_callback: When a single-argument function is passed, the function will be called after refreshing the access and refresh tokens. The argument to the callback is the :class:`.Authorizer` instance. This callback can be used to inspect and modify the attributes of the :class:`.Authorizer`. :param refresh_token: Enables the ability to refresh the authorization. N)rr$_post_refresh_callback_pre_refresh_callbackrs)rrirrrsrs rr$Authorizer.__init__s$0 '&;#%9"*rcURRc Sn[U5eURUSURRS9 g)zObtain and set authorization tokens based on ``code``. :param code: The code obtained by an out-of-band authorization request to Reddit. Nr8authorization_code)r; grant_typer")rfr"r r})rr;rKs r authorizeAuthorizer.authorizesN    + + 3-C#C( ( +,,99  rcUR(aURU5 URc Sn[U5eURSURS9 UR(aUR U5 gg)z1Obtain a new access token from the refresh_token.Nzrefresh token not providedrs)rrs)rrsr r}rrs rrefreshAuthorizer.refreshsq  % %  & &t ,    %.C#C( ( &d6H6H    & &  ' ' - 'rc>U(d URc[TU] 5 gURR URS5 UR 5 SUlg)zRevoke the current Authorization. :param only_access: When explicitly set to ``True``, do not evict the refresh token if one is set. Revoking a refresh token will in-turn revoke all access tokens associated with that authorization. Nrs)rsrrrfrRrg)r only_accessrs rrAuthorizer.revoke+sM $,,4 GN     , ,T-?-? Q  $ $ &!%D r)rrrs) rirr#Callable[[Authorizer], None] | NonerrrsrUrVrW)r;rTrVrWrrY)rrZrVrW) r[r\r]r^r_r$rrrr`rrs@rrrsc9 FJDH$( +(+ C + B + " + ++: .&&rrcH^\rSrSrSr\rSU4SjjrSrU=r $)ImplicitAuthorizeri=z3Manages implicit installed-app type authorizations.c>[TU]U5 [R"5U-UlX l[ UR S55Ulg)aRepresent a single implicit authorization to Reddit's API. :param authenticator: An instance of :class:`.UntrustedAuthenticator`. :param access_token: The access_token obtained from Reddit via callback to the authenticator's ``redirect_uri``. :param expires_in: The number of seconds the ``access_token`` is valid for. The origin of this value was returned from Reddit via callback to the authenticator's redirect uri. Note, you may need to subtract an offset before passing in this number to account for a delay between when Reddit prepared the response, and when you make this function call. :param scope: A space-delimited string of Reddit OAuth2 scope names as returned from Reddit in the callback to the authenticator's redirect uri. r<N)rr$rurxrlryrzrI)rrirlrrr?rs rr$ImplicitAuthorizer.__init__Bs@* '%)YY[:%="(%++c*+ r)rxrlrI) rirDrlrTrrrXr?rTrVrW) r[r\r]r^r_rDrdr$r`rrs@rrr=sF=0,-,, ,  ,  ,,rrcN^\rSrSrSr\rSSU4SjjjrSSjrSr U=r $) ReadOnlyAuthorizeri]zManages authorizations that are not associated with a Reddit account. While the ``"*"`` scope will be available, some endpoints simply will not work due to the lack of an associated Reddit account. c0>[TU]U5 X lg)zRepresent a ReadOnly authorization to Reddit's API. :param scopes: A list of OAuth scopes to request authorization for (default: ``None``). The scope ``"*"`` is requested when the default argument is used. N)rr$_scopes)rrirIrs rr$ReadOnlyAuthorizer.__init__gs ' rc0nUR(aSRUR5US'UR"SSS0UD6 g)z#Obtain a new ReadOnly access token.r<r?rclient_credentialsNr)rrEr})radditional_kwargss rrReadOnlyAuthorizer.refreshus? <<),$,,)? g & Q';Q?PQr)rr)rirrIlist[str] | NonerVrWr r[r\r]r^r_rrdr$rr`rrs@rrr]sG/ $( ( !    RRrrc\^\rSrSrSr\rSSU4SjjjrSSjrSr U=r $) ScriptAuthorizeri}zManages personal-use script type authorizations. Only users who are listed as developers for the application will be granted access tokens. cT>[TU]U5 X0lXPlX@lX lg)akRepresent a single personal-use authorization to Reddit's API. :param authenticator: An instance of :class:`.TrustedAuthenticator`. :param username: The Reddit username of one of the application's developers. :param password: The password associated with ``username``. :param two_factor_callback: A function that returns OTPs (One-Time Passcodes), also known as 2FA auth codes. If this function is provided, prawcore will call it when authenticating. :param scopes: A list of OAuth scopes to request authorization for (default: ``None``). The scope ``"*"`` is requested when the default argument is used. N)rr$ _passwordr_two_factor_callback _username)rriusernamepasswordtwo_factor_callbackrIrs rr$ScriptAuthorizer.__init__s'( '! $7!!rc0nUR(aSRUR5US'UR=(a UR5nU(aX!S'UR"SSURUR S.UD6 g)z3Obtain a new personal-use script type access token.r<r?otpr)rrrNr)rrErr}rr)rrtwo_factor_codes rrScriptAuthorizer.refreshsy <<),$,,)? g &33S8Q8Q8S '6e $  !^^^^   r)rrrrNN) rirrrUrrUrzCallable | NonerIrrVrWrrrs@rrr}sf/04#' "("" " - " ! " ""4   rrcX^\rSrSrSr\\4rSSU4SjjjrSSjr Sr U=r $) DeviceIDAuthorizerizManages app-only OAuth2 for 'installed' applications. While the ``"*"`` scope will be available, some endpoints simply will not work due to the lack of an associated Reddit account. cF>UcSn[TU]U5 X lX0lg)azRepresent an app-only OAuth2 authorization for 'installed' apps. :param authenticator: An instance of :class:`.UntrustedAuthenticator` or :class:`.TrustedAuthenticator`. :param device_id: A unique ID (20-30 character ASCII string) (default: ``None``). ``device_id`` is set to ``"DO_NOT_TRACK_THIS_DEVICE"`` when the default argument is used. For more information about this parameter, see: https://github.com/reddit/reddit/wiki/OAuth2#application-only-oauth :param scopes: A list of OAuth scopes to request authorization for (default: ``None``). The scope ``"*"`` is requested when the default argument is used. NDO_NOT_TRACK_THIS_DEVICE)rr$ _device_idr)rri device_idrIrs rr$DeviceIDAuthorizer.__init__s'$  2I '# rc0nUR(aSRUR5US'SnUR"SUURS.UD6 g)zObtain a new access token.r<r?z0https://oauth.reddit.com/grants/installed_client)rrNr)rrEr}r)rrrs rrDeviceIDAuthorizer.refreshsS <<),$,,)? g &G   !oo   r)rrr)rirrrUrIrrVrWr) r[r\r]r^r_rrDrdr$rr`rrs@rrrsX01GH !%#' (!   0   rr)"r_ __future__rruabcrrtypingrrrrequestsr requests.status_codesr rr exceptionsr rrrequests.modelsrprawcore.requestorrrrbrrDrrrrrrrrrs8" #//'LL(,m m `A#SA#H2,2>"."L&L&^,,@RR@1 z1 h, , r