Массовое удаление сообщений и файлов в Slack.
это форк https://github.com/kfei/slack-cleaner
Улучшенная версия на основе модуля Python находится по адресу https://github.com/sgratzl/slack_cleaner2.
Установить из Пипа:
pip install slack-cleaner
текущая версия разработки:
pip install -e git+https://github.com/sgratzl/slack-cleaner.git#egg=slack-cleaner
Если вы предпочитаете Docker, есть также готовый образ Docker:
docker pull sgratzl/slack-cleaner
Просто используйте docker run -it --rm sgratzl/slack-cleaner -c "slack-cleaner ..."
для каждой команды или перейдите в оболочку с помощью docker run -it --rm sgratzl/slack-cleaner
.
Установите для Fedora или EPEL7.
@rapgro поддерживает пакеты как для Fedora, так и для EPEL7.
# Fedora
dnf install slack-cleaner
# EPEL7
yum install -y epel-release ; yum install slack-cleaner
usage: slack-cleaner [-h] --token TOKEN [--log] [--quiet] [--rate RATE]
[--as_user] [--message | --file | --info] [--regex]
[--channel CHANNEL] [--direct DIRECT] [--group GROUP]
[--mpdirect MPDIRECT] [--user USER] [--botname BOTNAME]
[--bot] [--keeppinned] [--after AFTER] [--before BEFORE]
[--types TYPES] [--pattern PATTERN] [--perform]
optional arguments:
-h, --help show this help message and exit
--token TOKEN Slack API token (https://api.slack.com/web) or SLACK_TOKEN env var
--log Create a log file in the current directory
--quiet Run quietly, does not log messages deleted
--proxy Proxy Server url:port
--verify Verify option for Session (http://docs.python-requests.org/en/master/user/advanced/#ssl-cert-verification)
--rate RATE Delay between API calls (in seconds)
--as_user Pass true to delete the message as the authed user. Bot
users in this context are considered authed users.
--message Delete messages
--file Delete files
--info Show information
--regex Interpret channel, direct, group, and mpdirect as regex
--channel CHANNEL Channel name's, e.g., general
--direct DIRECT Direct message's name, e.g., sherry
--group GROUP Private group's name
--mpdirect MPDIRECT Multiparty direct message's name, e.g.,
sherry,james,johndoe
--user USER Delete messages/files from certain user
--botname BOTNAME Delete messages/files from certain bots. Implies '--bot'
--bot Delete messages from bots
--keeppinned exclude pinned messages from deletion
--after AFTER Delete messages/files newer than this time (YYYYMMDD)
--before BEFORE Delete messages/files older than this time (YYYYMMDD)
--types TYPES Delete files of a certain type, e.g., posts,pdfs
--pattern PATTERN Delete messages/files with specified pattern or if one of their attachments matches (regex)
--perform Perform the task
Предоставляемые разрешения зависят от того, для чего вы собираетесь использовать сценарий. Предоставьте разрешения ниже в зависимости от вашего использования.
Помимо предоставления разрешений, если вы хотите использовать этот сценарий для удаления сообщений или файлов, опубликованных другими, вам необходимо быть владельцем или администратором рабочей области.
channels:history
channels:read
chat:write
(или оба chat:write:user
и chat:write:bot
для старых приложений)users:read
groups:history
groups:read
chat:write
(или chat:write:user
для старых приложений)users:read
im:history
im:read
chat:write
(или chat:write:user
для старых приложений)users:read
mpim:history
mpim:read
chat:write
(или chat:write:user
для старых приложений)users:read
files:read
files:write
(или files:write:user
для старых приложений)users:read
# Delete all messages from a channel
slack-cleaner --token < TOKEN > --message --channel general --user " * "
# Delete all messages from a private group aka private channel
slack-cleaner --token < TOKEN > --message --group hr --user " * "
# Delete all messages from a direct message channel
slack-cleaner --token < TOKEN > --message --direct sherry --user johndoe
# Delete all messages from a multiparty direct message channel. Note that the
# list of usernames must contains yourself
slack-cleaner --token < TOKEN > --message --mpdirect sherry,james,johndoe --user " * "
# Delete all messages from certain user
slack-cleaner --token < TOKEN > --message --channel gossip --user johndoe
# Delete all messages from bots (especially flooding CI updates)
slack-cleaner --token < TOKEN > --message --channel auto-build --bot
# Delete all messages older than 2015/09/19
slack-cleaner --token < TOKEN > --message --channel general --user " * " --before 20150919
# Delete all files
slack-cleaner --token < TOKEN > --file --user " * "
# Delete all files from certain user
slack-cleaner --token < TOKEN > --file --user johndoe
# Delete all snippets and images
slack-cleaner --token < TOKEN > --file --types snippets,images
# Show information about users, channels:
slack-cleaner --token < TOKEN > --info
# Delete matching a regexp pattern
slack-cleaner --token < TOKEN > --pattern " (bar|foo.+) "
# TODO add add keep_pinned example, add quiet
# Always have a look at help message
slack-cleaner --help
Очистителю необходимо, чтобы вы дали разрешение API Slack, чтобы он мог выполнять необходимые ему операции. Вы предоставляете их, регистрируя его как приложение в рабочей области, в которой вы хотите его использовать.
Вы можете предоставить эти разрешения приложению следующим образом:
--token
в скрипте. После выполнения задачи в текущем каталоге будет создан файл резервной копии slack-cleaner.<timestamp>.log
если указан --log
.
Если возникла какая-либо проблема с API, попробуйте --rate=<delay-in-seconds>
, чтобы уменьшить частоту вызовов API (которая по умолчанию не ограничена).
Если вы видите следующее предупреждение от urllib3
, рассмотрите возможность установки недостающих пакетов: pip install --upgrade requests[security]
или просто обновите Python до версии 2.7.9.
InsecurePlatformWarning: A true SSLContext object is not available.
This prevents urllib3 from configuring SSL appropriately and may cause certain SSL connections to fail.
For more information, see https://urllib3.readthedocs.org/en/latest/security.html#insecureplatformwarning.
Всем людям, которые могут позволить себе только бесплатный план. ?