bfurddlmZmZmZmZmZmZmZmZm Z ddl m Z ddl m Z ddlmZGddeZdS)) _DICT_VERSION_ADMIN_ACCOUNT_DICT_VERSION_REPORT_DICT_VERSION_HASHTAG_DICT_VERSION_STATUS_DICT_VERSION_CARD _DICT_VERSION_ADMIN_DOMAIN_BLOCK_DICT_VERSION_ADMIN_MEASURE_DICT_VERSION_ADMIN_DIMENSION_DICT_VERSION_ADMIN_RETENTION)MastodonIllegalArgumentError) api_version)Mastodonc>eZdZedde d-dZedded.dZedded.dZedded Zedded Z edded Z edded Z edded Z eddedZ eddedZeddedZedddd/dZedded0dZeddedZeddedZeddedZeddedZeddedZedded1dZeddedZeddedZedded2dZedded3de d e d!e!d"e!d#e d$e d%e!fd&Z"edded3d e d!e!d"e!d#e d$e d%e!f d'Z#edded1d(Z$edde% d4d)Z&edde' d5d*Z(edde)d6d,Z*dS)7rz2.9.1z4.0.0Nc4| | d} | | d} | | d} | &t| ts| g} fd| D} | | } ||dvrtd||dvrtd||d vrtd ||}t }d d |S) a Fetches a list of accounts that match given criteria. By default, local accounts are returned. * Set `origin` to "local" or "remote" to get only local or remote accounts. * Set `by_domain` to a domain to get only accounts from that domain. * Set `status` to one of "active", "pending", "disabled", "silenced" or "suspended" to get only accounts with that moderation status (default: active) * Set `username` to a string to get only accounts whose username contains this string. * Set `display_name` to a string to get only accounts whose display name contains this string. * Set `email` to an email to get only accounts with that email (this only works on local accounts). * Set `ip` to an ip (as a string, standard v4/v6 notation) to get only accounts whose last active ip is that ip (this only works on local accounts). * Set `permissions` to "staff" to only get accounts with staff permissions. * Set `invited_by` to an account id to get only accounts invited by this user. * Set `role_ids` to a list of role IDs to get only accounts with those roles. Returns a list of :ref:`admin account dicts `. NTdateconvc:g|]}|S)_Mastodon__unpack_id).0xselfs \/home/feoh/.local/pipx/venvs/mastodon-archive/lib/python3.11/site-packages/mastodon/admin.py z.Mastodon.admin_accounts_v2...s'>>>((++>>>)staffz#Permissions must be staff if passed)localremotezOrigin must be local or remoteactivependingdisabledsilenced suspendedzHStatus must be local or active, pending, disabled, silenced or suspendedGETz/api/v2/admin/accounts)r isinstancelistr _Mastodon__deprotocolize_Mastodon__generate_paramslocals_Mastodon__api_request)rorigin by_domainstatususername display_nameemailip permissions invited_byrole_idsmax_idmin_idsince_idlimitparamss` radmin_accounts_v2zMastodon.admin_accounts_v2sX&  %%ft%<>>>X>>>H  !))*55J  ";)+C+C./TUU U  f0C&C&C./OPP P  f0j&j&j./yzz z ,,Y77I''11!!%)A6JJJrFr c B|||||||||| | |  S)aH Currently a synonym for admin_accounts_v1, now deprecated. You are strongly encouraged to use admin_accounts_v2 instead, since this one is kind of bad. !!!!! This function may be switched to calling the v2 API in the future. This is your warning. If you want to keep using v1, use it explicitly. !!!!! ) rr-r.r/r0r1r2 staff_onlyr6r7r8)admin_accounts_v1) rrr-r.r/r0r1r2r=r6r7r8r9s radmin_accountszMastodon.admin_accountsBsB%%%!&   rc | || d} | || d} | || d} |tgd} |rd| d<gd}||vrtd|rd| d<|D] }||krd| |<|||}|d d | S) a@ Fetches a list of accounts that match given criteria. By default, local accounts are returned. * Set `remote` to True to get remote accounts, otherwise local accounts are returned (default: local accounts) * Set `by_domain` to a domain to get only accounts from that domain. * Set `status` to one of "active", "pending", "disabled", "silenced" or "suspended" to get only accounts with that moderation status (default: active) * Set `username` to a string to get only accounts whose username contains this string. * Set `display_name` to a string to get only accounts whose display name contains this string. * Set `email` to an email to get only accounts with that email (this only works on local accounts). * Set `ip` to an ip (as a string, standard v4/v6 notation) to get only accounts whose last active ip is that ip (this only works on local accounts). * Set `staff_only` to True to only get staff accounts (this only works on local accounts). Note that setting the boolean parameters to False does not mean "give me users to which this does not apply" but instead means "I do not care if users have this attribute". Deprecated in Mastodon version 3.5.0. Returns a list of :ref:`admin account dicts `. NTr)rr.r=rrz$Invalid moderation status requested.rr%z/api/v1/admin/accounts)rr)r* ValueErrorr(r+)rrr-r.r/r0r1r2r=r6r7r8r9r: mod_statuses mod_statuss rr>zMastodon.admin_accounts_v1Ws*  %%ft%<` for the user with the given id. Returns that dict. r%/api/v1/admin/accounts/rr+rids r admin_accountzMastodon.admin_accounts6  b ! !!!%)G2)G)GHHHrc`||}|dd|dS)z Reenables login for a local account for which login has been disabled. Returns the updated :ref:`admin account dict `. POSTrEz/enablerFrGs radmin_account_enablezMastodon.admin_account_enable9  b ! !!!&*OB*O*O*OPPPrc`||}|dd|dS)zz Approves a pending account. Returns the updated :ref:`admin account dict `. rKrEz/approverFrGs radmin_account_approvezMastodon.admin_account_approves9  b ! !!!&*PB*P*P*PQQQrc`||}|dd|dS)z Rejects and deletes a pending account. Returns the updated :ref:`admin account dict ` for the account that is now gone. rKrEz/rejectrFrGs radmin_account_rejectzMastodon.admin_account_rejectrMrc`||}|dd|dS)zu Unsilences an account. Returns the updated :ref:`admin account dict `. rKrEz /unsilencerFrGs radmin_account_unsilencez Mastodon.admin_account_unsilence9  b ! !!!&*RB*R*R*RSSSrc`||}|dd|dS)zu Unsuspends an account. Returns the updated :ref:`admin account dict `. rKrEz /unsuspendrFrGs radmin_account_unsuspendz Mastodon.admin_account_unsuspendrTrz3.3.0c^||}|dd|S)z| Delete a local user account. The deleted accounts :ref:`admin account dict `. DELETErErFrGs radmin_account_deletezMastodon.admin_account_deletes6  b ! !!!(,Jb,J,JKKKrc`||}|dd|dS)z Unmark an account as force-sensitive. Returns the updated :ref:`admin account dict `. rKrEz /unsensitiverFrGs radmin_account_unsensitivez"Mastodon.admin_account_unsensitives9  b ! !!!&*TB*T*T*TUUUrTc|d}|sd}||}|||}|tddg}||d<|dd|d|dS) a Perform a moderation action on an account. Valid actions are: * "disable" - for a local user, disable login. * "silence" - hide the users posts from all public timelines. * "suspend" - irreversibly delete all the user's posts, past and future. * "sensitive" - forcce an accounts media visibility to always be sensitive. If no action is specified, the user is only issued a warning. Specify the id of a report as `report_id` to close the report with this moderation action as the resolution. Specify `warning_preset_id` to use a warning preset as the notification text to the user, or `text` to specify text directly. If both are specified, they are concatenated (preset first). Note that there is currently no API to retrieve or create warning presets. Set `send_email_notification` to False to not send the user an email notification informing them of the moderation action. NnonerHactiontyperKrEz/actionrr)r*r+)rrHr^ report_idwarning_preset_idtextsend_email_notificationr:s radmin_account_moderatezMastodon.admin_account_moderates( >F& +&* #   b ! !  ((33I''42BCCv 6#HR#H#H#H&QQQQQrcl|||d}|||d}|||d}|||}|||}|sd}|t}|dd|S)a Fetches the list of reports. Set `resolved` to True to search for resolved reports. `account_id` and `target_account_id` can be used to get reports filed by or about a specific user. Returns a list of :ref:`report dicts `. NTrr%z/api/v1/admin/reportsr`) rresolved account_idtarget_account_idr6r7r8r9r:s r admin_reportszMastodon.admin_reportss  %%ft%<`. r%/api/v1/admin/reports/rFrGs r admin_reportzMastodon.admin_reports6  b ! !!!%)F")F)FGGGrc`||}|dd|dS)z Assigns the given report to the logged-in user. Returns the updated :ref:`report dict `. rKrlz/assign_to_selfrFrGs radmin_report_assignzMastodon.admin_report_assign's9  b ! !!!&*V2*V*V*VWWWrc`||}|dd|dS)z Unassigns the given report from the logged-in user. Returns the updated :ref:`report dict `. rKrlz /unassignrFrGs radmin_report_unassignzMastodon.admin_report_unassign1s9  b ! !!!&*P2*P*P*PQQQrc`||}|dd|dS)zi Reopens a closed report. Returns the updated :ref:`report dict `. rKrlz/reopenrFrGs radmin_report_reopenzMastodon.admin_report_reopen;s9  b ! !!!&*N2*N*N*NOOOrc`||}|dd|dS)z Marks a report as resolved (without taking any action). Returns the updated :ref:`report dict `. rKrlz/resolverFrGs radmin_report_resolvezMastodon.admin_report_resolveEs9  b ! !!!&*O2*O*O*OPPPrz3.5.0cr|t}|dd|S)z Admin version of :ref:`trending_tags() `. Includes unapproved tags. Returns a list of :ref:`hashtag dicts `, sorted by the instance's trending algorithm, descending. r%z/api/v1/admin/trends/tagsr)r*r+)rr9r:s radmin_trending_tagszMastodon.admin_trending_tagsOs4''11!!%)DfMMMrcr|t}|dd|S)z Admin version of :ref:`trending_statuses() `. Includes unapproved tags. Returns a list of :ref:`status dicts `, sorted by the instance's trending algorithm, descending. r%z/api/v1/admin/trends/statusesrwrr:s radmin_trending_statusesz Mastodon.admin_trending_statusesZs4''11!!%)H&QQQrcr|t}|dd|S)z Admin version of :ref:`trending_links() `. Includes unapproved tags. Returns a list of :ref:`card dicts `, sorted by the instance's trending algorithm, descending. r%z/api/v1/admin/trends/linksrwrzs radmin_trending_linkszMastodon.admin_trending_linkses4''11!!%)EvNNNrc`|||}|||}|||}|.||}|dd|S|tdg}|dd|S)aM Fetches a list of blocked domains. Requires scope `admin:read:domain_blocks`. Provide an `id` to fetch a specific domain block based on its database id. Returns a list of :ref:`admin domain block dicts `, raises a `MastodonAPIError` if the specified block does not exist. Nr%/api/v1/admin/domain_blocks/r9)rr+r)r*)rrHr6r7r8r9r:s radmin_domain_blockszMastodon.admin_domain_blocksps  %%f--F  %%f--F  ''11H >!!"%%B%%e-PB-P-PQQ Q++FHHwi@@F%%e-KVTT Trdomainseverity reject_mediareject_reportsprivate_commentpublic_comment obfuscatec|td|t}|dd|S)a Perform a moderation action on a domain. Requires scope `admin:write:domain_blocks`. Valid severities are: * "silence" - hide all posts from federated timelines and do not show notifications to local users from the remote instance's users unless they are following the remote user. * "suspend" - deny interactions with this instance going forward. This action is reversible. * "limit" - generally used with reject_media=true to force reject media from an instance without silencing or suspending.. If no action is specified, the domain is only silenced. `domain` is the domain to block. Note that using the top level domain will also imapct all subdomains. ie, example.com will also impact subdomain.example.com. `reject_media` will not download remote media on to your local instance media storage. `reject_reports` ignores all reports from the remote instance. `private_comment` sets a private admin comment for the domain. `public_comment` sets a publicly available comment for this domain, which will be available to local users and may be available to everyone depending on your settings. `obfuscate` censors some part of the domain name. Useful if the domain name contains unwanted words like slurs. Returns the new domain block as an :ref:`admin domain block dict `. Nz'Must provide a domain to block a domainrKr)AttributeErrorr)r*r+) rrrrrrrrr:s radmin_create_domain_blockz"Mastodon.admin_create_domain_blocksH( > !JKK K''11!!&*H&QQQrc|td||}|tdg}|dd||S)a Modify existing moderation action on a domain. Requires scope `admin:write:domain_blocks`. Valid severities are: * "silence" - hide all posts from federated timelines and do not show notifications to local users from the remote instance's users unless they are following the remote user. * "suspend" - deny interactions with this instance going forward. This action is reversible. * "limit" - generally used with reject_media=true to force reject media from an instance without silencing or suspending. If no action is specified, the domain is only silenced. `domain` is the domain to block. Note that using the top level domain will also imapct all subdomains. ie, example.com will also impact subdomain.example.com. `reject_media` will not download remote media on to your local instance media storage. `reject_reports` ignores all reports from the remote instance. `private_comment` sets a private admin comment for the domain. `public_comment` sets a publicly available comment for this domain, which will be available to local users and may be available to everyone depending on your settings. `obfuscate` censors some part of the domain name. Useful if the domain name contains unwanted words like slurs. Returns the modified domain block as an :ref:`admin domain block dict `, raises a `MastodonAPIError` if the specified block does not exist. NzOMust provide an id to modify the existing moderation actions on a given domain.rHPUTr)rrr)r*r+) rrHrrrrrrr:s radmin_update_domain_blockz"Mastodon.admin_update_domain_blocksg( : !rss s   b ! !''4&99!!%)L)L)LfUUUrc|0||}|dd|dStd)a Removes moderation action against a given domain. Requires scope `admin:write:domain_blocks`. Provide an `id` to remove a specific domain block based on its database id. Raises a `MastodonAPIError` if the specified block does not exist. NrXrz@You must provide an id of an existing domain block to remove it.)rr+rrGs radmin_delete_domain_blockz"Mastodon.admin_delete_domain_blocksP >!!"%%B   x)L)L)L M M M M M !cdd drct}g}dD]#}||dkr||$i}dD]?}||5||d|||i||<@dD]]}||S||dt||dd i||<^t |d krtd ||d <|||d <|||d <| dd|dS)a Retrieves numerical instance information for the time period (at day granularity) between `start_at` and `end_at`. * `active_users`: Pass true to retrieve the number of active users on your instance within the time period * `new_users`: Pass true to retrieve the number of users who joined your instance within the time period * `interactions`: Pass true to retrieve the number of interactions (favourites, boosts, replies) on local statuses within the time period * `opened_reports`: Pass true to retrieve the number of reports filed within the time period * `resolved_reports` = Pass true to retrieve the number of reports resolved within the time period * `tag_accounts`: Pass a tag ID to get the number of accounts which used that tag in at least one status within the time period * `tag_uses`: Pass a tag ID to get the number of statuses which used that tag within the time period * `tag_servers`: Pass a tag ID to to get the number of remote origin servers for statuses which used that tag within the time period * `instance_accounts`: Pass a domain to get the number of accounts originating from that remote domain within the time period * `instance_media_attachments`: Pass a domain to get the amount of space used by media attachments from that remote domain within the time period * `instance_reports`: Pass a domain to get the number of reports filed against accounts from that remote domain within the time period * `instance_statuses`: Pass a domain to get the number of statuses originating from that remote domain within the time period * `instance_follows`: Pass a domain to get the number of accounts from a remote domain followed by that local user within the time period * `instance_followers`: Pass a domain to get the number of local accounts followed by accounts from that remote domain within the time period This API call is relatively expensive - watch your servers load if you want to get a lot of statistical data. Especially the instance_statuses stats might take a long time to compute and, in fact, time out. There is currently no way to get tag IDs implemented in Mastodon.py, because the Mastodon public API does not implement one. This will be fixed in a future release. Returns a list of :ref:`admin measure dicts `. ) active_users new_users interactionsopened_reportsresolved_reportsT) tag_accountstag_uses tag_serversNrH)instance_accountsinstance_media_attachmentsinstance_reportsinstance_statusesinstance_followsinstance_followersr/z!Must request at least one metric.keysstart_atend_atrKz/api/v1/admin/measuresuse_json r*appendrrr(splitlenr #_Mastodon__consistent_isoformat_utcr+)rrrrrrrrrrrrrrrrr params_initrkeyr:s radmin_measureszMastodon.admin_measuressw<hh f ! !C34'' C   > I IC3+ C   #T%5%5k#6F%G%GHs Z c cC3+ C   ')A)A+cBR)S)S)Y)YZ])^)^_`)abs t99>>./RSS Sv!<`. ) languagessourcesservers space_usagesoftware_versionsT)r tag_languagesNrH)rinstance_languagesrrrz$Must request at least one dimension.rr9rrrKz/api/v1/admin/dimensionsrr)rrrr9rrrrrrrrrrrrr:s radmin_dimensionszMastodon.admin_dimensionss2hh Z ! !C34'' C   3 I IC3+ C   #T%5%5k#6F%G%GHs > c cC3+ C   ')A)A+cBR)S)S)Y)YZ])^)^_`)abs t99>>./UVV Vv  #F7O!<` )rmonthzFrequency must be day or month)rr frequencyrKz/api/v1/admin/retention)r rr+)rrrrr:s radmin_retentionzMastodon.admin_retention6sm,,,./OPP P77AA55f=="   !!&*CVLLLr)NNNNNNNNNNNNNN) FNr NNNNFNNNN)NNNNT)FNNNNNN)N)NNNNN)NNNNNN)FFFFFNNNNNNNNN) NFFFFFNNNN)r)+__name__ __module__ __qualname__r rr;r?r>rIrLrOrQrSrVrYr[rerrjrmrorqrsrurrxrr{rr}rrstrboolrrrr rr rr rrrrrr s8['#>??{~B0K0K0K@?0Kd['#>??   @? (['#>??0K0K0K@?0Kd['#>??II@?I['#>??QQ@?Q['#>??RR@?R['#>??QQ@?Q['#>??TT@?T['#>??TT@?T['#>??LL@?L['#>??VV@?V['7++!R!R!R,+!RF['#788JJJ98J<['#788HH98H['#788XX98X['#788RR98R['#788PP98P['#788QQ98Q['#899NNN:9N['#788RR98R['#566OO76O['#CDDUUUEDU0['#CDDRRsRSRTXRnrRJMRcfRw{RRREDR0['#CDDVVSVDVfjVBEV[^VosVVVEDV2['#CDD e e eED e['#>??RWW[Z^4[4[4[@?4[l['#@AARWmq1]1]1]BA1]f['#@AAMMMBAMMMrrN)versionsrrrrrrr r r errorsr utilityr internalsr InternalsrrrrsTTTTTTTTTTTTTTTTTTTTTT000000 ,,,,,,zMzMzMzMzMyzMzMzMzMzMr