10.1.5. Класс cerebro.aclasses.Attachment

class cerebro.aclasses.Attachment(message_id, attach_id)

Базовые классы: cerebro.aclasses.AbstractAttachment

Класс вложения.

Методы

• add_hashtags()
• data()
• file_hash()
• id()
• message_id()
• remove_hashtags()
• review_hash()
• set_comment()
• thumbnail_hashs()
• методы базового класса cerebro.aclasses.AbstractAttachment

attach = cerebro.core.current_attachment()

attachs = message.attachments()

add_hashtags(hashtags)

Параметры:hashtags (string, set(string, ) или list(string, )) – хэштег или массив хэштегов (каждый хэштег должен быть одним словом без пробелов).

Добавляет хэштеги к вложению.

См.также

remove_hashtags().

data()

Результат:кортеж данных по вложению. Тип результата:tuple

По сути, большинство методов данного класса являются обёртками к этому кортежу. Поэтому вы можете пользоваться напрямую данными из него.

attach.file_hash() == attach.data()[attach.DATA_FILE_HASH]
attach.is_link() == (attach.data()[attach.DATA_IS_LINK] != 0)
# и так далее                   

file_hash()

Результат:хеш файла. Тип результата:string

Хеш используется файловым хранилищем Cargador для идентификации файлов. Зная хеш файла вы можете получить путь к файлу или поставить его на закачку, если файла нет в вашем файловом хранилище.

if attach.is_link() != True: # проверяем, что вложение не является линком
        # Скачивание вложения           
        file_name = cerebro.cargador.file_name_form_hash(attach.file_hash()) # пробуем получить имя файла по хешу
        if file_name == '' or file_name == None: # если файла нет, пробуем его скачать
                cerebro.cargador.download_file(attach.file_hash())

Если вложение является линком, у него нет хеша, поскольку вложения добавленные как линки не добавляются в файловое хранилище Cargador.

id()

Результат:идентификатор вложения. Тип результата:int

message_id()

Результат:идентификатор сообщения, к которому принодлежит вложение. Тип результата:int

remove_hashtags(hashtags)

Параметры:hashtags (string, set(string, ) или list(string, )) – хэштег или массив хэштегов (каждый хэштег должен быть одним словом без пробелов).

Удаляет хэштеги из вложения.

См.также

add_hashtags().

review_hash()

Результат:хеш рецензии файла (аудио-визуальных комментариев). Тип результата:string

set_comment(comment)

Параметры:comment (string) – комментарий к вложению.

Изменяет текстовый комментарий к новому вложению.

new_attachs = event.new_attachments()
for attach in new_attachs:
        if attach.is_link() == True: # если новое вложение добавлено как линк
                attach.set_comment(i.comment() + '. Это линк')  # добавим комментарий

thumbnail_hashs()

Результат:список хешей уменшеных эскизов файла. Тип результата:list(string,)