
    qh                     b    S r SSKJr  SSKJrJr  SSKJr  SSKJ	r	  SSK
JrJr   " S S\5      rg	)
z
oauthlib.oauth2.rfc8628
~~~~~~~~~~~~~~~~~~~~~~~

This module is an implementation of various logic needed
for consuming and providing OAuth 2.0 Device Authorization RFC8628.
    )add_params_to_uri)BackendApplicationClientClient)InsecureTransportError)prepare_token_request)is_secure_transportlist_to_scopec                   H   ^  \ rS rSrSrSrU 4S jrSS jr  S	S jrSr	U =r
$ )
DeviceClient   a  A public client utilizing the device authorization workflow.

The client can request an access token using a device code and
a public client id associated with the device code as defined
in RFC8628.

The device authorization grant type can be used to obtain both
access tokens and refresh tokens and is intended to be used in
a scenario where the device being authorized does not have a
user interface that is suitable for performing authentication.
z,urn:ietf:params:oauth:grant-type:device_codec                 T   > [         TU ]  " U40 UD6  UR                  S5      U l        g )Nclient_secret)super__init__getr   )self	client_idkwargs	__class__s      X/var/www/html/env/lib/python3.13/site-packages/oauthlib/oauth2/rfc8628/clients/device.pyr   DeviceClient.__init__   s&    -f-#ZZ8    c                    [        U5      (       d
  [        5       eUc  U R                  OUnSU R                  4SU R                  4/nU R
                  b  UR                  SU R
                  45        U(       a  UR                  S[        U5      45        U H,  nX5   (       d  M  UR                  [        U5      X5   45        M.     [        X5      $ )Nr   
grant_typer   scope)
r   r   r   r   r   r   appendr	   strr   )r   urir   r   paramsks         r   prepare_request_uri DeviceClient.prepare_request_uri#   s    "3''(**#m

0\4??4SU)MM?D,>,>?@MM7M%$89:Ayys1vvy12  !--r   c                 |    U R                   US'   XES'   Uc  U R                  OUn[        U R                  4X!US.UD6$ )a  Add device_code to request body

The client makes a request to the token endpoint by adding the
device_code as a parameter using the
"application/x-www-form-urlencoded" format to the HTTP request
body.

:param body: Existing request body (URL encoded string) to embed parameters
             into. This may contain extra parameters. Default ''.
:param scope:   The scope of the access request as described by
                `Section 3.3`_.

:param include_client_id: `True` to send the `client_id` in the
                          body of the upstream request. This is required
                          if the client is not authenticating with the
                          authorization server as described in
                          `Section 3.2.1`_. False otherwise (default).
:type include_client_id: Boolean

:param kwargs:  Extra credentials to include in the token request.

The prepared body will include all provided device_code as well as
the ``grant_type`` parameter set to
``urn:ietf:params:oauth:grant-type:device_code``::

    >>> from oauthlib.oauth2 import DeviceClient
    >>> client = DeviceClient('your_id', 'your_code')
    >>> client.prepare_request_body(scope=['hello', 'world'])
    'grant_type=urn:ietf:params:oauth:grant-type:device_code&scope=hello+world'

.. _`Section 3.2.1`: https://datatracker.ietf.org/doc/html/rfc6749#section-3.2.1
.. _`Section 3.3`: https://datatracker.ietf.org/doc/html/rfc6749#section-3.3
.. _`Section 3.4`: https://datatracker.ietf.org/doc/html/rfc8628#section-3.4
r   include_client_id)bodydevice_coder   )r   r   r   r   )r   r&   r%   r   r$   r   s         r   prepare_request_body!DeviceClient.prepare_request_body6   sP    J #nn{&7"##m

$T__ <4+0<4:< 	<r   )r   )N) NF)__name__
__module____qualname____firstlineno____doc__r   r   r!   r'   __static_attributes____classcell__)r   s   @r   r   r      s.    
 @J9.& @D/4)< )<r   r   N)r.   oauthlib.commonr   oauthlib.oauth2r   r   oauthlib.oauth2.rfc6749.errorsr   "oauthlib.oauth2.rfc6749.parametersr   oauthlib.oauth2.rfc6749.utilsr   r	   r    r   r   <module>r7      s)    . < A D LP<6 P<r   