x h݁gdZdZddlZddlZddlZddlZddlZddlZddlZddl Z ddl m Z m Z ddl m Z mZddlmZddlmZmZmZddlmZdd lmZdd lmZmZmZmZmZmZm Z dd l!m"Z"m#Z#m$Z$m%Z%m&Z&m'Z'm(Z(m)Z)dd l*m+Z+d Z,dZ-dZ.dZ/dZ0dZ1dZ2dZ3dZ4Gdde5Z6Gdde5Z7d#dZ8Gdde5Z9Gdde9eZ:Gdd e9eZ;Gd!d"e<Z=y)$)Dropbox DropboxTeamcreate_sessionz12.0.2N)datetime timedelta)AuthError_validatorRateLimitError_validator)files)PathRootPathRoot_validatorPathRootError_validator) DropboxBase)DropboxTeamBase)ApiError AuthError BadInputError HttpError PathRootErrorInternalServerErrorRateLimitError)API_HOSTAPI_CONTENT_HOSTAPI_NOTIFICATION_HOSTHOST_API HOST_CONTENT HOST_NOTIFYpinned_sessionDEFAULT_TIMEOUT)stone_serializerszDropbox-API-Path-Rootii,zDropbox-API-Select-AdminzDropbox-API-Select-UseruserteamappnoauthceZdZdZddZy) RouteResultz+The successful result of a call to a route.Nct|tjsJdt|z|7t|tj j sJdt|z||_||_y)a3 :param str obj_result: The result of a route not including the binary payload portion, if one exists. Must be serialized JSON. :param requests.models.Response http_resp: A raw HTTP response. It will be used to stream the binary-body payload of the response. z#obj_result: expected string, got %rNz4http_resp: expected requests.models.Response, got %r) isinstancesix string_typestyperequestsmodelsResponse obj_result http_resp)selfr.r/s [/var/www/html/lionshead-backend/venv/lib/python3.12/site-packages/dropbox/dropbox_client.py__init__zRouteResult.__init__Gsv*c&6&67 E 1D4D D E7  i)A)AB FY  B%"N__name__ __module__ __qualname____doc__r2r3r1r%r%Ds 5#r3r%ceZdZdZdZy)RouteErrorResultz&The error result of a call to a route.c ||_||_y)a :param str request_id: A request_id can be shared with Dropbox Support to pinpoint the exact request that returns an error. :param str obj_result: The result of a route not including the binary payload portion, if one exists. N) request_idr.)r0r>r.s r1r2zRouteErrorResult.__init__Zs%$r3Nr5r:r3r1r<r<Ws 0%r3r<c2t||}|r||_|S)ae Creates a session object that can be used by multiple :class:`Dropbox` and :class:`DropboxTeam` instances. This lets you share a connection pool amongst them, as well as proxy parameters. :param int max_connections: Maximum connection pool size. :param dict proxies: See the `requests module `_ for more details. :rtype: :class:`requests.sessions.Session`. `See the requests module `_ for more details. ) pool_maxsizeca_certs)rproxies)max_connectionsrBrAsessions r1rrds/HMG! Nr3c eZdZdZdZdZdZdZddddddeddddddf dZ dd Z dd Z d Z e dfd Z dd Z ddZ ddZdZdZddZdZdZdZdZy)_DropboxTransportzd Responsible for implementing the wire protocol for making requests to the Dropbox API. 2downloaduploadrpcNc"|s|s| r| s td|*t|tstdj||r | s td| )t | dk(st| t s td||_||_| |_| |_ | |_ | |_ ||_ ||_ |rFt|tjj stdj|||_nt%| |_||_d t(z}|r||_d j|||_nd|_||_t/j0d |_t4t6t8t:t<t>i|_ ||_!y) a :param str oauth2_access_token: OAuth2 access token for making client requests. :param int max_retries_on_error: On 5xx errors, the number of times to retry. :param Optional[int] max_retries_on_rate_limit: On 429 errors, the number of times to retry. If `None`, always retries. :param str user_agent: The user agent to use when making requests. This helps us identify requests coming from your application. We recommend you use the format "AppName/Version". If set, we append "/OfficialDropboxPythonSDKv2/__version__" to the user_agent, :param session: If not provided, a new session (connection pool) is created. To share a session across multiple clients, use :func:`create_session`. :type session: :class:`requests.sessions.Session` :param dict headers: Additional headers to add to requests. :param Optional[float] timeout: Maximum duration in seconds that client will wait for any single packet from the server. After the timeout the client will give up on connection. If `None`, client will wait forever. Defaults to 100 seconds. :param str oauth2_refresh_token: OAuth2 refresh token for refreshing access token :param datetime oauth2_access_token_expiration: Expiration for oauth2_access_token :param str app_key: application key of requesting application; used for token refresh :param str app_secret: application secret of requesting application; used for token refresh Not required if PKCE was used to authorize the token :param list scope: list of scopes to request on refresh. If left blank, refresh will request all available scopes for application :param str ca_certs: a path to a file of concatenated CA certificates in PEM format. Has the same meaning as when using :func:`ssl.wrap_socket`. zBOAuth2 access token or refresh token or app key/secret must be setNzExpected dict, got {}z%app_key is required to refresh tokensrScope list must be of type listz*Expected requests.sessions.Session, got {})rAzOfficialDropboxPythonSDKv2/z{}/{}dropbox)"BadInputExceptionr'dictformatlenlist_oauth2_access_token_oauth2_refresh_token_oauth2_access_token_expiration_app_key _app_secret_scope_max_retries_on_error_max_retries_on_rate_limitr+sessionsSession_sessionr_headers __version___raw_user_agent _user_agentlogging getLogger_loggerrrrrrr _host_map_timeout)r0oauth2_access_tokenmax_retries_on_errormax_retries_on_rate_limit user_agentrDheaderstimeoutoauth2_refresh_tokenoauth2_access_token_expirationapp_key app_secretscoperAbase_user_agents r1r2z_DropboxTransport.__init__st\$';J#T   z'4'@#$;$B$B7$KL L #$KL L  #e*/E49P#$EF F$7!%9"/M, % %9"*C' gx'8'8'@'@A'(T)/::#DM*H=DM 7+E #-D &~~j/JD #'D .D ((3 "H&(8%'<>  r3c |j|xs |j|xs |j|xs |j|xs |j|xs |j |xs |j |xs |j|xs |j| xs |j| xs |j| xs |j| xs |j S)a Creates a new copy of the Dropbox client with the same defaults unless modified by arguments to clone() See constructor for original parameter descriptions. :return: New instance of Dropbox client :rtype: Dropbox ) __class__rTrZr[rbr^r_rgrUrVrWrXrY) r0rhrirjrkrDrlrmrnrorprqrrs r1clonez_DropboxTransport.clones0~~  <4#<#< >D$>$> % H)H)H  *$**  $t}}  $t}}  $t}} >D$>$> * Rd.R.R  $t}}  *$**  T[[  r3c |j|jdxsd}|jd}|dz|jz}|jdkDr|dj |jz }|jdxsd} t j |j|} |"|tjk(r|jd z}|j||| | ||| } tj| j} t| t r|j"} | }ntt| t$rM|j&} | d }| j)d }|xr|j)d }|xr|j)d}nt+dt-| zt j.| |d}t| t$rt1| j2|| |j4k(r|| j6fS|S)a Makes a request to the Dropbox API and in the process validates that the route argument and result are the expected data types. The request_arg is converted to JSON based on the arg_data_type. Likewise, the response is deserialized from JSON and converted to an object based on the {result,error}_data_type. :param host: The Dropbox API host to connect to. :param route: The route to make the request to. :type route: :class:`stone.backends.python_rsrc.stone_base.Route` :param request_arg: Argument for the route that conforms to the validator specified by route.arg_type. :param request_binary: String or file pointer representing the binary payload. Use None if there is no binary payload. :param Optional[float] timeout: Maximum duration in seconds that client will wait for any single packet from the server. After the timeout the client will give up on connection. If `None`, will use default timeout set on Dropbox object. Defaults to `None`. :return: The route's result. hostapiauth/z_v{}stylerJZrmerror user_messagetextlocalez7Expected RouteResult or RouteErrorResult, but res is %sF)strict)check_and_refresh_access_tokenattrsnameversionrQr json_encodearg_typer list_folder_longpollrmrequest_json_string_with_retryjsonloadsr.r'r% result_typer< error_typegetAssertionErrorr*json_compat_obj_decoderr>_ROUTE_STYLE_DOWNLOADr/)r0route namespace request_argrequest_binaryrmrx auth_type route_name route_styleserialized_argresdecoded_obj_resultreturned_data_typeobjruser_message_textuser_message_localedeserialized_results r1requestz_DropboxTransport.requests8 ++-{{6"+eKK' _uzz1 ==1  &-- 6 6Jkk'*3e *66u~~7BD O333"))B.G11$2<2=2@2;2@:A 2C"ZZ7 c; '!&!2!2 $C - .!&!1!1 $W-C-11.AL , I1A1A&1I "."M<3C3CH3M  "1379"=> >0FF E3 c+ ,3>>.,.0 0D66 6'7 7& &r3c8|jxr |j}|jxrA|j xs2tjt t z|jk\}|j }|s|r |r|j|jyyy)zi Checks if access token needs to be refreshed and refreshes if possible :return: seconds)rrN) rUrWrVrutcnowrTOKEN_EXPIRATION_BUFFERrTrefresh_access_tokenrY)r0 can_refresh needs_refresh needs_tokens r1rz0_DropboxTransport.check_and_refresh_access_tokenhs 00BT]] 22255 51 __ 3J!K K  0 0 1 333 [k  % %DKK % 8/:[r3c|)t|dk(st|ts td|jr |j s|j jdy|j jddj|}d|j|j d}|jr|j|d <|rd j|}||d <t}|jr |j}|jj||| }|j!||j#}|d |_t'j(t+t-|dz|_y)z Refreshes an access token via refresh token if available :param host: host to hit token endpoint with :param scope: list of permission scopes for access token :return: NrrMzPUnable to refresh access token without refresh token and app keyzRefreshing access token.zhttps://{}/oauth2/token refresh_token) grant_typer client_id client_secret rr)datarm access_token expires_inr)rRr'rSrOrUrWrewarninginforQrXjoinrrgr^postraise_dropbox_error_for_resprrTrrrintrV)r0rxrrurlbodyrmr token_contents r1rz&_DropboxTransport.refresh_access_tokenvs@  #e*/E49P#$EF F**t}} LL "+ ,  45'..t4-!%!;!;!]]   $($4$4D ! HHUOE!DM! ==mmGmm  4 A ))#. $1.$A!/7/@ c- "=> ?0@,r3c tj|}|j|||||||} tj| j} t | t r| j| | jfS| S)a Makes a request to the Dropbox API, taking a JSON-serializable Python object as an argument, and returning one as a response. :param host: The Dropbox API host to connect to. :param route_name: The name of the route to invoke. :param route_style: The style of the route. :param str request_arg: A JSON-serializable Python object representing the argument for the route. :param auth_type str :param Optional[bytes] request_binary: Bytes representing the binary payload. Use None if there is no binary payload. :param Optional[float] timeout: Maximum duration in seconds that client will wait for any single packet from the server. After the timeout the client will give up on connection. If `None`, will use default timeout set on Dropbox object. Defaults to `None`. :return: The route's result as a JSON-serializable Python object. r)rdumpsrrr.r'r%r/) r0rxrrrrrrmrrrs r1request_json_objectz%_DropboxTransport.request_json_objectsy6K011$2<2=2@2;2@:A 2C#jj8 c; 'CMM,E'7 7& &r3c hd}d} d} |jjd| |j|||||||S#t$rn} | jrV| jj r<| r|jjd| j |jd} nYd} ~ nd} ~ wt$rv} |dz }||jkrWd |ztjz} |jjd | j | tj| nYd} ~ nd} ~ wt$rw} | dz } |j|j| k\rL| j | jnd } |jjd | tj| nYd} ~ nd} ~ wwxYw) z See :meth:`request_json_object` for description of parameters. :param request_json_arg: A string representing the serialized JSON argument to the route. rFTz Request to %srz:ExpiredCredentials status_code=%s: Refreshing and RetryingNr|z2HttpError status_code=%s: Retrying in %.1f secondsg@z$Ratelimit: Retrying in %.1f seconds.)rerrequest_json_stringrris_expired_access_token status_coderrrZrandomtimesleeprr[backoff) r0rxrrrequest_json_argrrrmattemptrate_limit_errors has_refresheders r1rz0_DropboxTransport.request_json_string_with_retrys  LL  oz :) //0:0;0@090>8? 0AA 77qww>>@$ ))XMM+113(, &' 1 d888j6==?:GLL%%L w0JJw'(" !Q&!33;77;LL+,99+@aiicGLL%%>IJJw'( Cs0= F/A#B// F/;A,D,, F/8A-F**F/c||jvrtd|zt|tjt dfst dt |z|j|}|j||} d|ji} |jddjd} t| vst| vrF|jr:d|jz| d <|jr| j|jnt | vr|j" |j$ t'd t)j*d j-|j"|j$j/d } d j-| j1d | d <|jr@| j|jn$|t2k(rnt'dj-|d} d}||j4k(rd| d<|} nA||j6k(r|| d<d}n*||j8k(r d| d<|| d<|} ntd|z| |j:}|j<j?| | | ||}|jA||jBjEd}|jFdvr'|jHj1d }tK||S||j6k(r|jBd}n\|jBjEddk(s#Jd|jBjEdz|jHj1d }||j6k(r tM||StM|S)zc See :meth:`request_json_string_with_retry` for description of parameters. zUnknown value for host: %rNz.expected request_binary as binary type, got %sz User-Agentr,z Bearer %s AuthorizationzAClient id and client secret are required for routes with app authz{}:{}zutf-8zBasic {}zUnhandled auth type: {}Fapplication/jsonz Content-TypezDropbox-API-ArgTzapplication/octet-streamzUnknown operation style: %r)rlrstreamrmx-dropbox-request-idiiizdropbox-api-result content-type4Expected content-type to be application/json, got %r)'rf ValueErrorr'r( binary_typer* TypeError_get_route_urlrbreplacesplit USER_AUTH TEAM_AUTHrTr_updateAPP_AUTHrWrXrObase64 b64encoderQencodedecodeNO_AUTH_ROUTE_STYLE_RPCr_ROUTE_STYLE_UPLOADrgr^rrrlrrcontentr<r%)r0rx func_namerrrrrm fq_hostnamerrl auth_types auth_headerrrrr>raw_resps r1rz%_DropboxTransport.request_json_stringsA t~~ %9D@A A.3??DJ*GH L 012 2nnT* !!+y9!1!12&&sB/55c:  #yJ'>DD]D]'2T5N5N'NGO $}}t}}-  #}}$(8(8(@'WYY **t}}d.>.>?FFwOK(2'8'89K9KG9T'UGO $}}t}}- ' ! #$=$D$DY$OP P $// /&8GN ##D D66 6)9G% &F D44 4&@GN #)9G% &!D:[HI I ?mmG MM  s'.$(&,'.  ! ))!,YY]]#9: ==O +yy''0H#J9 9 $44 4yy!56H99==04FF /F n-. /Fyy''0H $44 4x+ +x( (r3cH|jjd}|jdk\r!t||j|j|jdk(rn |j ddk(rA|jjd}t jtd}t||t||j|jdk(rx|jjdd k(s#Jd |jjdzt jt|j d}t|||jtk(r7t jt|j d}t|||jd k(rd }|jjdd k(r8t jt|j d}|j }n+|jjd }| t#|}nd }t%||||jdvry d|jcxkrdks#nt'||j|jy #t$rt||jwxYw)zpChecks for errors from a res and handles appropiately. :param res: Response of an api request. riir invalid_grantinvalid_access_tokenirrriNz retry-afterri+)rlrrrrrrrrrrrHTTP_STATUS_INVALID_PATH_ROOTr rr retry_afterrrr)r0rr>errrretry_after_strs r1rz._DropboxTransport.raise_dropbox_error_for_respes= [[__%;< ??c !%j#//388L L __ # :88:g&/9!$1G!HJ+BB+-CEC#J44' CHH==__ #;;??>26HH 1F /0 1H$::#SXXZ%8:CJ, , __ = =#::'G)<>C C0 0 __ #C{{~.2DD'>>,chhj.AC!oo "%++//-"@"."%o"6K"&K S+> > __ / /C/JB B0; :#J99 :s A-J J!cFdj|tj|S)zReturns the URL of the route. :param str hostname: Hostname to make the request to. :param str route_name: Name of the route. :rtype: str z)https://{hostname}/{version}/{route_name})hostnamerr)rQr _API_VERSION)r0rrs r1rz _DropboxTransport._get_route_urls,;AA((!B  r3ct|d5}tj|5|j|D]}|j | ddddddy#1swYxYw#1swYyxYw)a Saves the body of an HTTP response to a file. :param str download_path: Local path to save data to. :param http_resp: The HTTP response whose body will be saved. :type http_resp: :class:`requests.models.Response` :rtype: None wbN)open contextlibclosing iter_contentwrite)r0 download_pathr/ chunksizefcs r1_save_body_to_filez$_DropboxTransport._save_body_to_files[- &!##I."// :AGGAJ;/' &..' &s"A)(A A)A& "A))A2ct|ts td|jr|jj ni}t j t||t<|j|S)a Creates a clone of the Dropbox instance with the Dropbox-API-Path-Root header as the appropriate serialized instance of PathRoot. For more information, see https://www.dropbox.com/developers/reference/namespace-guide#pathrootmodes :param PathRoot path_root: instance of PathRoot to serialize into the headers field :return: A :class: `Dropbox` :rtype: Dropbox z)path_root must be an instance of PathRoot)rl) r'r rr_copyrrr PATH_ROOT_HEADERrv)r0 path_root new_headerss r1with_path_rootz _DropboxTransport.with_path_rootsg)X.HI I.2mmdmm((* (9(E(EFXZc(d $%zz  r3c8|jjy)zV Cleans up all resources like the request session/network connection. N)r^closer0s r1rz_DropboxTransport.closes r3c|Sr4r:rs r1 __enter__z_DropboxTransport.__enter__s r3c$|jyr4)r)r0argss r1__exit__z_DropboxTransport.__exit__s  r3) NNNNNNNNNNNNr4)i)r6r7r8r9rrrrrr2rvrrrrrrrrrr rrrrr:r3r1rFrFxs L ' #&*&'+/ (&*04 ] B!%!%&*!%+/% X R'h 9)1%@\%))'d04<J%)])~/Cb    . r3rFceZdZdZy)rz Use this class to make requests to the Dropbox API using a user's access token. Methods of this class are meant to act on the corresponding user's Dropbox. Nr6r7r8r9r:r3r1rrs   r3rc"eZdZdZdZdZdZy)rz Use this class to make requests to the Dropbox API using a team's access token. Methods of this class are meant to act on the team, but there is also an :meth:`as_user` method for assuming a team member's identity. c.|jt|S)a Allows a team credential to assume the identity of an administrator on the team and perform operations on any team-owned content. :param str team_member_id: team member id of administrator to perform actions with :return: A :class:`Dropbox` object that can be used to query on behalf of this admin of the team. :rtype: Dropbox )&_get_dropbox_client_with_select_headerSELECT_ADMIN_HEADERr0team_member_ids r1as_adminzDropboxTeam.as_admins::;N;IK Kr3c.|jt|S)aK Allows a team credential to assume the identity of a member of the team. :param str team_member_id: team member id of team member to perform actions with :return: A :class:`Dropbox` object that can be used to query on behalf of this member of the team. :rtype: Dropbox )rSELECT_USER_HEADERrs r1as_userzDropboxTeam.as_users::;M;IK Kr3cf|jr|jjni}|||<t|j|j|j |j |j|j|j|j||j|j|j S)ap Get Dropbox client with modified headers :param str select_header_name: Header name used to select users :param str team_member_id: team member id of team member to perform actions with :return: A :class:`Dropbox` object that can be used to query on behalf of a member or admin of the team :rtype: Dropbox ) rhrnrorirjrmrkrDrlrprqrr)r_r rrTrUrVrZr[rgrar^rWrXrY)r0select_header_namerrs r1rz2DropboxTeam._get_dropbox_client_with_select_headers/3mmdmm((* *8 &' $ 9 9!%!;!;+/+O+O!%!;!;&*&E&EMM++MMMM''++  r3N)r6r7r8r9r r#rr:r3r1rrs K K r3rceZdZdZy)rOz Thrown if incorrect types/values are used This should only ever be thrown during testing, app should have validation of input prior to reaching this point Nrr:r3r1rOrOs   r3rO)NN)>__all__r`rrrrcrrr+r(rr dropbox.authrr rNr dropbox.commonr r r dropbox.baserdropbox.base_teamrdropbox.exceptionsrrrrrrrdropbox.sessionrrrrrrrrstone.backends.python_rsrcrr rrrr"rrrrobjectr%r<rrFrr ExceptionrOr:r3r1r2s     ( %-   9* #0.    #&#& %v %(Z Z z  : #_: x  r3