bf-OddlZddlmZddlZddlZddlZddlZddlmZm Z m Z m Z ddl m Z ddlmZmZmZmZddlmZmZddlmZGd d eZdS) N) urlencode)MastodonIllegalArgumentErrorMastodonNetworkErrorMastodonVersionErrorMastodonAPIError)_DICT_VERSION_APPLICATION)_DEFAULT_SCOPES _SCOPE_SETS_DEFAULT_TIMEOUT_DEFAULT_USER_AGENT)parse_version_string api_version)MastodonceZdZeeddddedefdZdddddddeddddedfdZdd edddfd Z dddd dedfd Z d Z e d de dZdS)rNc |tdt|}|d|d} d|i} |Dt |t t fr"dt |}|| d<nd| d<||| d < |r1||d | | | } | } n/tj|d | | | } | } n$#t$r} td | d} ~ wwxYw|t|d 5}| | ddz| | ddz| |dz| |dzdddn #1swxYwY| d| dfS)a Create a new app with given `client_name` and `scopes` (The basic scopes are "read", "write", "follow" and "push" - more granular scopes are available, please refer to Mastodon documentation for which) on the instance given by `api_base_url`. Specify `redirect_uris` if you want users to be redirected to a certain page after authenticating in an OAuth flow. You can specify multiple URLs by passing a list. Note that if you wish to use OAuth authentication with redirects, the redirect URI must be one of the URLs specified here. Specify `to_file` to persist your app's info to a file so you can use it in the constructor. Specify `website` to give a website for your app. Specify `session` with a requests.Session for it to be used instead of the default. This can be used to, amongst other things, adjust proxy or SSL certificate settings. Specify `user_agent` if you want to use a specific name as `User-Agent` header, otherwise "mastodonpy" will be used. Presently, app registration is open by default, but this is not guaranteed to be the case for all Mastodon instances in the future. Returns `client_id` and `client_secret`, both as strings. NAPI base URL is required. ) client_namescopesz User-Agent redirect_urisurn:ietf:wg:oauth:2.0:oobwebsitez /api/v1/apps)dataheaderstimeoutzCould not complete request: w client_id client_secret)rr_Mastodon__protocolizejoin isinstancelisttuplepostjsonrequests Exceptionropenwrite)rrrrto_file api_base_urlrequest_timeoutsession user_agent request_datarretresponsee secret_files e/home/feoh/.local/pipx/venvs/mastodon-archive/lib/python3.11/site-packages/mastodon/authentication.py create_appzMastodon.create_apps`4  ./JKK K--l;; 'hhv&&  *   $-$77 ? $ $}*=*= > > ,9L ) ),GL )  &-L # K +lll#@#@#@|]dn}l~~88::#=L)F)F)F\cjuDEEE#==?? K K K&'Ia'I'IJJ J K  gs## 6{!!(;"7$">???!!(?";d"BCCC!!,"5666!!+"4555  6 6 6 6 6 6 6 6 6 6 6 6 6 6 6 %x'@AAs,A"C>> DDD4A-F--F14F1Fwaitg?createdmainlinec ||_|j||j|_||_||_||_||_||_tj|_ d|_ d|_ d|_ tj |_d|_tj |_||_||_| r| |_nt)j|_| |_|jdvrt/d| |_||_|jrt4j|jr7t;|jd5}||_||_|}|UtA|dkrBtB|}|j||jkst/d||_|}|r |j||_dddn #1swxYwYn|jt/d|j`t4j|jr;t;|jd5}||_|}|UtA|dkrBtB|}|j||jkst/d||_|j_ ||_||_n#YnxYwdddn #1swxYwY|jt/d tB|j|_| d vrt/d | |_"d |_#d|_$d|_%d|_&| |j"d kr|'nC|j"d kr8 tQ| \|_#|_$|_%n#tSdxYw|dvrt/ddS)a Create a new API wrapper instance based on the given `client_secret` and `client_id` on the instance given by `api_base_url`. If you give a `client_id` and it is not a file, you must also give a secret. If you specify an `access_token` then you don't need to specify a `client_id`. It is allowed to specify neither - in this case, you will be restricted to only using endpoints that do not require authentication. If a file is given as `client_id`, client ID, secret and base url are read from that file. You can also specify an `access_token`, directly or as a file (as written by :ref:`log_in() `). If a file is given, Mastodon.py also tries to load the base URL from this file, if present. A client id and secret are not required in this case. Mastodon.py can try to respect rate limits in several ways, controlled by `ratelimit_method`. "throw" makes functions throw a `MastodonRatelimitError` when the rate limit is hit. "wait" mode will, once the limit is hit, wait and retry the request as soon as the rate limit resets, until it succeeds. "pace" works like throw, but tries to wait in between calls so that the limit is generally not hit (how hard it tries to avoid hitting the rate limit can be controlled by ratelimit_pacefactor). The default setting is "wait". Note that even in "wait" and "pace" mode, requests can still fail due to network or other problems! Also note that "pace" and "wait" are NOT thread safe. By default, a timeout of 300 seconds is used for all requests. If you wish to change this, pass the desired timeout (in seconds) as `request_timeout`. For fine-tuned control over the requests object use `session` with a requests.Session. The `mastodon_version` parameter can be used to specify the version of Mastodon that Mastodon.py will expect to be installed on the server. The function will throw an error if an unparseable Version is specified. If no version is specified, Mastodon.py will set `mastodon_version` to the detected version. The version check mode can be set to "created" (the default behaviour), "changed" or "none". If set to "created", Mastodon.py will throw an error if the version of Mastodon it is connected to is too old to have an endpoint. If it is set to "changed", it will throw an error if the endpoint's behaviour has changed after the version of Mastodon that is connected has been released. If it is set to "none", version checking is disabled. `feature_set` can be used to enable behaviour specific to non-mainline Mastodon API implementations. Details are documented in the functions that provide such functionality. Currently supported feature sets are `mainline`, `fedibird` and `pleroma`. For some Mastodon instances a `User-Agent` header is needed. This can be set by parameter `user_agent`. Starting from Mastodon.py 1.5.2 `create_app()` stores the application name into the client secret file. If `client_id` points to this file, the app name will be used as `User-Agent` header as default. It is possible to modify old secret files and append a client app name to use it as a `User-Agent` name. `lang` can be used to change the locale Mastodon will use to generate responses. Valid parameters are all ISO 639-1 (two letter) or for a language that has none, 639-3 (three letter) language codes. This affects some error messages (those related to validation) and trends. You can change the language using :ref:`set_language()`. If no other `User-Agent` is specified, "mastodonpy" will be used. Ni,)r:fedibirdpleromazRequested invalid feature setrrz4Mismatch in base URLs between files and/or specifiedz7Specified client id directly, but did not supply secretr)r9changednonezInvalid version check method.rr@zBad version specified)throwr8pacezInvalid ratelimit method.)*r-r!rr access_tokendebug_requestsratelimit_methoddatetimenow_token_expired_refresh_token_Mastodon__logged_in_idratelimit_limittimeratelimit_resetratelimit_remainingratelimit_lastcallratelimit_pacefactorr.r/r(Session feature_setrr0langospathisfiler*readlinerstriplenrversion_check_modemastodon_majormastodon_minormastodon_patchversion_check_workedretrieve_mastodon_versionrr)selfrr rCr-rDrErPr.mastodon_versionrZr/rRr0rSr5 try_base_urlr token_files r6__init__zMastodon.__init__Zs*n)   ( $ 2 243D E ED "*(, 0&/3355"""#y{{#& "&)++$8!.  ."DLL#+--DL&#FFF./NOO O%  > %w~~dn-- r$.#..?+%0%9%9%;%;%B%B%D%DDN)4)=)=)?)?)F)F)H)HD&#.#7#7#9#9#@#@#B#BL#/C 4E4E4J4J'/'='=l'K'K $ 1 9\TM^=^=^">?u"v"vv,8)#."6"6"8"8K"?t'>*5*<*<*>*>??????????????? %-67pqqq   (RW^^D))3)<)<)>)>)E)E)G)G-7-@-@-B-B-I-I-K-K**#               (   $./JKK K$2243DEE!%CCC./NOO O"4$(!  #(?6(I(I  * * , , , ,  $ . . DPdeuPvPvM#T%8$:M:M D*+BCCC #< < <./JKK K = `. `scopes` are as in :ref:`log_in() `, redirect_uris is where the user should be redirected to after authentication. Note that `redirect_uris` must be one of the URLs given during app registration. When using urn:ietf:wg:oauth:2.0:oob, the code is simply displayed, otherwise it is added to the given URL as the "code" request parameter. Pass force_login if you want the user to always log in even when already logged into web Mastodon (i.e. when registering multiple different accounts in an app). `state` is the oauth `state` parameter to pass to the server. It is strongly suggested to use a random, nonguessable value (i.e. nothing meaningful and no incrementing ID) to preserve security guarantees. It can be left out for non-web login flows. Pass an ISO 639-1 (two letter) or, for languages that do not have one, 639-3 (three letter) language code as `lang` to control the display language for the oauth form. Nr>rcode response_type redirect_urirscope force_loginstaterSz/oauth/authorize?) rrTrUrVr*rWrXdictr"rr-) r`rrrrjrkrSr5paramsformatted_paramss r6auth_request_urlzMastodon.auth_request_urls?,  IIw~~i(( @)S))@[ + 4 4 6 6 = = ? ?I@@@@@@@@@@@@@@@'{"(!.~((6**w +}wv$V,,ww)+>@PQRRRs'A--A14A1c |,|*|tgd}d|d<ng|*|tgd}d|d<n;|*|tgd}d|d<ntd |j|d <|j|d <d ||d < |dd|d} | d|_|| d| t| ddnN#t$rA} ||td| |td| td| d} ~ wwxYw| d  d } tjD]} | | vr| t| z } t!|t!| ksAt#dd | zdzd |zdz|t%|d5} | | ddz| |jdz| |jdz| |jdzdddn #1swxYwYd|_|js|| dS)aK Get the access token for a user. The username is the email address used to log in into Mastodon. Can persist access token to file `to_file`, to be used in the constructor. Handles password and OAuth-based authorization. Will throw a `MastodonIllegalArgumentError` if the OAuth flow data or the username / password credentials given are incorrect, and `MastodonAPIError` if all of the requested scopes were not granted. For OAuth 2, obtain a code via having your user go to the URL returned by :ref:`auth_request_url() ` and pass it as the code parameter. In this case, make sure to also pass the same redirect_uri parameter as you used when generating the auth request URL. Returns the access token as a string. N)rr,rf refresh_tokenpassword grant_type)rr,usernamersrrauthorization_code)rr,rursrfrrzDInvalid arguments given. username and password or code are required.rr rriPOSTz /oauth/tokenF)do_ratelimitingrC expires_inrz/Invalid user name, password, or redirect_uris: z'Invalid access token or redirect_uris: zInvalid request: zGranted scopes "z." do not contain all of the requested scopes "z".rr)_Mastodon__generate_paramslocalsrrr r"_Mastodon__api_requestrC_Mastodon__set_refresh_tokenget_Mastodon__set_token_expiredintr)splitr keyssetrr*r+r-rJr^r_)r`rursrfrhrrrr,rnr3r4received_scopes scope_setrcs r6log_inzMastodon.log_in"s*  H$8++FHH6d6d6deeF#-F<  ++FHH6t6t6tuuF#7F<  &++FHH6k6k6kllF#2F< ./uvv v"n{"&"4((6**w L))&.&Z_)``H ( 8D   $ $X\\/%B%B C C C  $ $SlA)F)F%G%G H H H H L L L#x';23hef3h3hiii!23`]^3`3`aaa23Jq3J3JKKK  L#7+11#66$)++ : :IO++;y#996{{c/2222"#58Q8Q#QUE$EHKHPHPQWHXHX$X[_$_`` `  gs## !T%7%?./rss s(,,"n{"&"4+w 6?F;;;!"z2.0.0z2.7.2c.|ddS)z Fetch information about the current application. Returns an :ref:`application dict `. GETz/api/v1/apps/verify_credentials)r|)r`s r6app_verify_credentialszMastodon.app_verify_credentialss!!%)JKKKr)__name__ __module__ __qualname__ staticmethodr r r r7rdrprrrr rrr6rrsB'6dTXbf $6FPTat>B>B>B\>BF"&T[_pu"(sTdw{$-t`sz~^L^L^L^L@*.=XapDLPW[&S&S&S&SP#TKfvzDS]aG(G(G(G(R###,['#<==LL>=LLLrr)r(requests.modelsrrFrTrLrerrorsrrrrversionsr defaultsr r r r utilityrr internalsr Internalsrrr6rs%%%%%% nnnnnnnnnnnn//////YYYYYYYYYYYY66666666,,,,,,vLvLvLvLvLyvLvLvLvLvLr