bfUddlZddlmZmZmZmZmZmZddlm Z m Z ddl m Z m Z mZddlmZddlmZGdd eZdS) N)_DICT_VERSION_ACCOUNT_DICT_VERSION_STATUS_DICT_VERSION_RELATIONSHIP_DICT_VERSION_LIST _DICT_VERSION_FAMILIAR_FOLLOWERS_DICT_VERSION_HASHTAG)_DEFAULT_SCOPES _SCOPE_SETS)MastodonIllegalArgumentErrorMastodonAPIErrorMastodonNotFoundError) api_version)MastodonceZdZeddddddeddfdZeddddZedded Zedd ed Z edd ed Z edd e d/dZ edded0dZ edded0dZeddedZedded1dZed d edZeddedZeddedZedded2dZedd edZeddedZeddedZedded Zedded!Zed"d#ed3d$Zed"ded%Zed&d'e d4d(Zed)d)ed*Z ed)d)ed+Z!ed,d,ed-Z"edde#d.Z$dS)5rz2.7.0z3.4.0FNenc <|tddg} |j| d<|j| d<|s| d= i} d|| d<|j| d<|j| d<d| d <|d d | d } | d} n$#t $r}td|d}~wwxYw |d d| d | d} d| vr| rd| fStd|| d|_| | d| t| ddn!#t $r}tdd}~wwxYw| d d}tjD]}||vr|t|z }t!|t!|ksL ))=L &))&.,`e)ffH ( 8   [ [ [./YVW/Y/YZZ Z [ B))&2Df^c|M`d)eeH(""(*>)23Jq3J3JKKK ( 8D   $ $X\\/%B%B C C C  $ $SlA)F)F%G%G H H H H B B B./@AA A B#7+11#66$)++ : :IO++;y#996{{c/2222"T388O#<#<TT?Bxx?O?OTTT   gs## ;z  .!9D!@AAA  !2T!9::: ; ; ; ; ; ; ; ; ; ; ; ; ; ; ;#  ,N+R/ /N+ +sIAB B5B00B59$EA=E E:&E55E:0`. GET/api/v1/accounts/_Mastodon__unpack_idr*r7ids rFaccountzMastodon.accountys6  b ! !!!%)AR)A)ABBBrLz2.1.0c.|ddS)z Fetch logged-in user's account information. Returns a :ref:`account dict ` (Starting from 2.1.0, with an additional "source" field). rNz#/api/v1/accounts/verify_credentialsrIrJs rFaccount_verify_credentialsz#Mastodon.account_verify_credentialss!!%)NOOOrLc*|S)z Get this user's account. Synonym for `account_verify_credentials()`, does exactly the same thing, just exists because `account_verify_credentials()` has a confusing name. )rVrJs rFmez Mastodon.mes..000rLz2.8.0c f||}|||d}|||d}| || d} |tdg} |s| d=|s| d=|s| d=|s| d=|d d |d | S) a Fetch statuses by user `id`. Same options as :ref:`timeline() ` are permitted. Returned toots are from the perspective of the logged-in user, i.e. all statuses visible to the logged-in user (including DMs) are included. If `only_media` is set, return only statuses with media attachments. If `pinned` is set, return only statuses that have been pinned. Note that as of Mastodon 2.1.0, this only works properly for instance-local users. If `exclude_replies` is set, filter out all statuses that are replies. If `exclude_reblogs` is set, filter out all statuses that are reblogs. If `tagged` is set, return only statuses that are tagged with `tagged`. Only a single tag without a '#' is valid. Does not require authentication for Mastodon versions after 2.7.0 (returns publicly visible statuses in that case), for publicly visible accounts. Returns a list of :ref:`status dicts `. NTdateconvrSpinned only_mediaexclude_repliesexclude_reblogsrNrOz /statusesrQr'r(r*) r7rSr]r\r^r_taggedmax_idmin_idsince_idlimitr>s rFaccount_statuseszMastodon.account_statusess(  b ! !  %%ft%<||}|||d}|||d}|||d}|tdg}|dd|d|S)z{ Fetch users the given user is following. Returns a list of :ref:`account dicts `. NTrZrSrNrOz /followingr`r7rSrbrcrdrer>s rFaccount_followingzMastodon.account_following  b ! !  %%ft%<||}|||d}|||d}|||d}|tdg}|dd|d|S)z} Fetch users the given user is followed by. Returns a list of :ref:`account dicts `. NTrZrSrNrOz /followersr`rhs rFaccount_followerszMastodon.account_followersrjrLz1.4.0c||}|t}|dd|S)z Fetch relationship (following, followed_by, blocking, follow requested) of the logged in user to a given account. `id` can be a list. Returns a list of :ref:`relationship dicts `. rNz/api/v1/accounts/relationshipsr`r7rSr>s rFaccount_relationshipszMastodon.account_relationshipssN  b ! !''11!!%)I"(** *rLz2.3.0c|t}|ddkr|d=|dd|S)a= Fetch matching accounts. Will lookup an account remotely if the search term is in the username@domain format and not yet in the database. Set `following` to True to limit the search to users the logged-in user follows. Returns a list of :ref:`account dicts `. followingFrNz/api/v1/accounts/search)r'r(r*)r7qrerqresolver>s rFaccount_searchzMastodon.account_searchsL''11 + % ' '{#!!%)BFKKKrLc||}|tdg}|dd|d|S)z Get all of the logged-in user's lists which the specified user is a member of. Returns a list of :ref:`list dicts `. rSrNrOz/listsr`rns rF account_listszMastodon.account_listssV  b ! !''4&99!!%)GR)G)G)GPPPrLcn|dd|tS)az Look up an account from user@instance form (@instance allowed but not required for local accounts). Will only return accounts that the instance already knows about, and not do any webfinger requests. Use `account_search` if you need to resolve users through webfinger from remote. Returns an :ref:`account dict `. rNz/api/v1/accounts/lookup)r*r'r()r7accts rFaccount_lookupzMastodon.account_lookups2!!%)BDDZDZ[a[c[cDdDdeeerLz3.5.0ct|ts|g}tt|D] }|||||<!|ddd|idS)z Find followers for the account given by id (can be a list) that also follow the logged in account. Returns a list of :ref:`familiar follower dicts ` rNz#/api/v1/accounts/familiar_followersrST)use_json) isinstancelistrangelenrQr*)r7rSis rFaccount_familiar_followersz#Mastodon.account_familiar_followerss{"d## Bs2ww , ,A$$RU++BqEE!!%)NQUWYPZei!jjjrLz3.3.0Tc||}|tdg}|d|d=|dd|d|S)a- Follow a user. Set `reblogs` to False to hide boosts by the followed user. Set `notify` to True to get a notification every time the followed user posts. Returns a :ref:`relationship dict ` containing the updated relationship to the user. rSreblogsNrrOz/followr`)r7rSrnotifyr>s rFaccount_followzMastodon.account_follow/si  b ! !''4&99 )  $y!!!&*Ib*I*I*I6RRRrLc ||d}n#tdxYw||S)a Follow a remote user with username given in username@domain form. Returns a :ref:`account dict `. Deprecated - avoid using this. Currently uses a backwards compat implementation that may or may not work properly. rzUser not found)rtrr)r7urirxs rFfollowszMastodon.followsAsM :&&s++A.DD :'(899 9""4(((s/c`||}|dd|dS)z Unfollow a user. Returns a :ref:`relationship dict ` containing the updated relationship to the user. rrOz /unfollowrPrRs rFaccount_unfollowzMastodon.account_unfollowPs9  b ! !!!&*Kb*K*K*KLLLrLc`||}|dd|dS)z Remove a user from the logged in users followers (i.e. make them unfollow the logged in user / "softblock" them). Returns a :ref:`relationship dict ` reflecting the updated following status. rrOz/remove_from_followersrPrRs rFaccount_remove_from_followersz&Mastodon.account_remove_from_followersZs9  b ! !!!&*Xb*X*X*XYYYrLc`||}|dd|dS)z Block a user. Returns a :ref:`relationship dict ` containing the updated relationship to the user. rrOz/blockrPrRs rF account_blockzMastodon.account_blocke9  b ! !!!&*Hb*H*H*HIIIrLc`||}|dd|dS)z Unblock a user. Returns a :ref:`relationship dict ` containing the updated relationship to the user. rrOz/unblockrPrRs rFaccount_unblockzMastodon.account_unblockos9  b ! !!!&*Jb*J*J*JKKKrLz1.1.0z2.4.3c||}|tdg}|dd|d|S)ao Mute a user. Set `notifications` to False to receive notifications even though the user is muted from timelines. Pass a `duration` in seconds to have Mastodon automatically lift the mute after that many seconds. Returns a :ref:`relationship dict ` containing the updated relationship to the user. rSrrOz/muter`)r7rS notificationsdurationr>s rF account_mutezMastodon.account_muteysV  b ! !''4&99!!&*Gb*G*G*GPPPrLc`||}|dd|dS)z Unmute a user. Returns a :ref:`relationship dict ` containing the updated relationship to the user. rrOz/unmuterPrRs rFaccount_unmutezMastodon.account_unmutes9  b ! !!!&*Ib*I*I*IJJJrLz1.1.1z3.1.0c tjt} | Nt| dkrt dg} t | D]\} \}}|| d| d<|| d| d<dD] }|| vr| |= i}|||||d<|||||d <|| }|d d || S) a Update the profile for the currently logged-in user. `note` is the user's bio. `avatar` and 'header' are images. As with media uploads, it is possible to either pass image data and a mime type, or a filename of an image file, for either. `locked` specifies whether the user needs to manually approve follow requests. `bot` specifies whether the user should be set to a bot. `discoverable` specifies whether the user should appear in the user directory. `fields` can be a list of up to four name-value pairs (specified as tuples) to appear as semi-structured information in the user's profile. Returns the updated `account dict` of the logged-in user. Nz%A maximum of four fields are allowed.zfields_attributes[z][name]z][value])avataravatar_mime_typeheaderheader_mime_typefieldsrrPATCHz#/api/v1/accounts/update_credentials)files) collections OrderedDictr(rr enumerate_Mastodon__load_media_filer'r*)r7 display_namenoterrrrlockedbot discoverablerparams_initialfields_attributesidx field_name field_valueparamrr>s rFaccount_update_credentialsz#Mastodon.account_update_credentialss>2%0::  6{{Q2;===!# 2;F2C2C Q Q..j+DN@C@@@AEPACAAABB\ * *E&&"5)  "44V=MNNE(O  "44V=MNNE(O''77!!'+PRX`e!fffrLz2.5.0c`||}|dd|dS)z Pin / endorse a user. Returns a :ref:`relationship dict ` containing the updated relationship to the user. rrOz/pinrPrRs rF account_pinzMastodon.account_pins9  b ! !!!&*Fb*F*F*FGGGrLc`||}|dd|dS)z Unpin / un-endorse a user. Returns a :ref:`relationship dict ` containing the updated relationship to the user. rrOz/unpinrPrRs rF account_unpinzMastodon.account_unpinrrLz3.2.0c||}|tdg}|dd|d|S)z Set a note (visible to the logged in user only) for the given account. Returns a :ref:`status dict ` with the `note` updated. rSrrOz/noter`)r7rScommentr>s rFaccount_note_setzMastodon.account_note_setsV  b ! !''4&99!!&*Gb*G*G*GPPPrLc`||}|dd|dS)z Get an account's featured hashtags. Returns a list of :ref:`hashtag dicts ` (NOT `featured tag dicts`_). rNrOz/featured_tagsrPrRs rFaccount_featured_tagszMastodon.account_featured_tagss9  b ! !!!%)OR)O)O)OPPPrL) FFFFNNNNN)NNNN)NFF)TF)TN) NNNNNNNNNN)%__name__ __module__ __qualname__rr rGrKrrTrVrXrrfrirlrrortrrvryrrrrrrrrrrrrrrr rrLrFrr s['7++BGPT]ajyDH`e\,\,\,,+\,|['7++CC,+C['#899 C C:9 C['#899PP:9P['#89911:91['#788'T'T'T98'TR['#899UUU:9U&['#899UUU:9U&['#=>> * *?> *['#899 L L L:9 L['#566 Q Q76 Q['#899 f f:9 f['#CDD k kED k ['#=>>SSS?>S"['#899 ) ):9 )['#=>>MM?>M['#=>>ZZ?>Z['#=>>JJ?>J['#=>>LL?>L['#=>> Q Q Q?> Q['#=>>KK?>K['#899AEAEAE48=A 2g2g2g:92gh['#=>>HH?>H['#=>>JJ?>J['#=>>QQ?>Q['#899QQ:9QQQrLr)rversionsrrrrrr defaultsr r errorsr r rutilityr internalsr InternalsrrLrFrskkkkkkkkkkkkkkkk22222222YYYYYYYYYY ,,,,,,aQaQaQaQaQyaQaQaQaQaQrL