o 2gA@sddZddlmZddlmZmZmZmZddlm Z m Z ddl m Z ddl mZGd d d eZd S) zProvide the Auth class.) annotations) AuthorizerImplicitAuthorizerUntrustedAuthenticatorsession)InvalidImplicitAuth!MissingRequiredAttributeException)_deprecate_args)PRAWBasec@sheZdZdZed ddZd!d d Zed d d d"ddZd#ddZ edddddddd$ddZ dS)%Authz5Auth provides an interface to Reddit's authorization.returndict[str, str | int | None]cCs|jjj}|j|j|jdS)aReturn a dictionary containing the rate limit info. The keys are: :remaining: The number of requests remaining to be made in the current rate limit window. :reset_timestamp: A unix timestamp providing an upper bound on when the rate limit counters will reset. :used: The number of requests made in the current rate limit window. All values are initially ``None`` as these values are set in response to issued requests. The ``reset_timestamp`` value is an upper bound as the real timestamp is computed on Reddit's end in preparation for sending the response. This value may change slightly within a given window due to slight changes in response times and rounding. ) remainingreset_timestampused)_reddit_core _rate_limiterrrr)selfdatarH/home/garg/my-data/venv/lib/python3.10/site-packages/praw/models/auth.pylimitss z Auth.limitscodestr str | NonecCsF|jjjj}t|}||t||jjjd}||j_ |j_ |j S)a7Complete the web authorization flow and return the refresh token. :param code: The code obtained through the request to the redirect uri. :returns: The obtained refresh token, if available, otherwise ``None``. The session's active authorization will be updated upon success.  authorizer window_size) r_read_only_core _authorizer_authenticatorr authorizerconfigr r_authorized_core refresh_token)rr authenticatorrauthorized_sessionrrrr$+s   zAuth.authorize access_token expires_inscopeintcCsJ|jjjj}t|ts ttt|||||jj j d}||j_ |j_ dS)aSet the active authorization to be an implicit authorization. :param access_token: The access_token obtained from Reddit's callback. :param expires_in: The number of seconds the ``access_token`` is valid for. The origin of this value was returned from Reddit's callback. 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's callback. :raises: :class:`.InvalidImplicitAuth` if :class:`.Reddit` was initialized for a non-installed application type. rN) rr!r"r# isinstancerrrrr%r rr&)rr*r+r,r(implicit_sessionrrrimplicit>s  z Auth.implicitset[str]cCs |jjj}|s ||jS)zReturn a set of scopes included in the current authorization. For read-only authorizations this should return ``{"*"}``. )rrr"is_validrefreshscopes)rrrrrr4Zs z Auth.scopesr4statedurationr0 permanentF)r6r0bool list[str]cCsb|jjjj}|j|jjjurd}t|t|t r&|j |rdn||||dS|r*t | |||S)a)Return the URL used out-of-band to grant access to your application. :param duration: Either ``"permanent"`` or ``"temporary"`` (default: ``"permanent"``). ``"temporary"`` authorizations generate access tokens that last only 1 hour. ``"permanent"`` authorizations additionally generate a refresh token that expires 1 year after the last use and can be used indefinitely to generate new hour-long access tokens. This value is ignored when ``implicit=True``. :param implicit: For **installed** applications, this value can be set to use the implicit, rather than the code flow. When ``True``, the ``duration`` argument has no effect as only temporary tokens can be retrieved. :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``. This value should be temporarily unique to the client for whom the URL was generated for. zredirect_uri must be provided temporary)r0) rr!r"r# redirect_urir%CONFIG_NOT_SETr r.r authorize_urlr)rr6r0r4r5r(msgrrrurles   zAuth.urlN)rr)rrrr)r*rr+r-r,r)rr1) r6rr0r8r4r9r5rrr) __name__ __module__ __qualname____doc__propertyrr$r r0r4r?rrrrr s      r N)rC __future__rprawcorerrrr exceptionsrr utilr baser r rrrrs