Возвращаемся в файл weather_fsm.py и ниже создаём вторую функцию get_by_city.

Код функции:

from botlogic.utils.get_weather import request_weather
from botlogic.settings import bot

async def get_by_city(message: Message, state: FSMContext):
    if message.text.lower() == 'отмена':
        await message.answer(views.abort_weather())
        await state.clear()
    else:
        result = request_weather(message.text)
        if result:
            await message.reply(result)
            await message.answer(views.weather_request_done())
            await state.clear()
        else:
            await bot.send_message(message.chat.id, views.weather_wrong_city())
            await state.set_state(GetWeatherSteps.BY_CITY)

Первым делом проверяем, отменил пользователь запрос или нет.
Если запрос отменён, выводим сообщение и очищаем состояние.

Если отмены не произошло, вызываем функцию получения погоды, передав туда сообщение пользователя.

Далее снова проверка. Если вернулась сформированная строка, отвечаем пользователю сформированной строкой, затем отправляем сообщение, что задача выполнена и очищаем состояние.

Иначе, если вернулся 0, просим пользователя повторить попытку или отменить запрос.

Готово. Осталось только зарегистрировать команды и прописать в меню.


Регистрация команды.
Откроем файл main.py и найдем другие зарегистрированные команды.

Ниже добавим следующие строки:

from botlogic.handlers import weather_fsm
from botlogic.utils.statesform import GetWeatherSteps


dp.message.register(weather_fsm.get_weather_command, Command(commands='weather'))  
dp.message.register(weather_fsm.get_by_city, GetWeatherSteps.BY_CITY)

Добавляем в меню.
Откройте файл commands.py в пакете utils.

Добавьте команду в меню, по аналогии с другими:

BotCommand(  
    command='weather',  
    description='Получить прогноз погоды'  
),

Завершение.
Поздравляю. Теперь ваш бот умеет сообщать прогноз погоды.
Как я и говорил в начале, добавление функционала погоды, достаточно простое. Также оно служит "примером" использования бота для получения каких-либо данных по API.

Файлы к посту, можно получить в боте по коду: 603735
Пост на сайте.
Поддержать канал.

Состоялся релиз новой версии Python - 3.12.

Из ключевых изменений:
- Улучшена работа с f-строками.
- Улучшена поддержка многоядерных систем, за счёт определения добавления поддержки изолированных субинтерпретаторов и отдельных GIL.
- Улучшена работа с ошибками и подсказками для ошибок.

Подготовил для вас перевод ключевых изменений.

Пост на сайте.
Поддержать проект.

🤔И где эта Света?

Которых нет.

AIOgram3 14. Фильтруем запрещённые слова

Следующей задачей для бота является фильтрация сообщений от запрещённый слов.

Задача не самая сложная, но есть пара нюансов.

Первый - что делать с сообщением?
Сообщение другого пользователя нельзя отредактировать удалив оттуда нежелательные слова. Его можно удалить, но бывают ситуации когда пользователь пишет большое сообщение и может вставить туда какое-то ругательство и весь его труд будет потерян.

Решение будет следующим:
- Пользовательское сообщение проверяется на наличие слова в нём
- В случае нахождения, создаётся копия сообщения
- Затем из копии удаляются / заменяются на звёздочки / модифицируются слова. Тут уже зависит от того, какой результат вы хотите получить. В моём случае слова будут заменяться на звёздочки.
- Далее удаляется оригинальное сообщение и от имени бота отправляется новое, содержащее имя отправителя и отредактированное сообщение.

Второй - сложность алгоритма и затрачиваемые ресурсы.
В используемом списке бранных слов насчитывается свыше 1000 слов.
Сообщение от пользователя очищается от пунктуации и разделяется на множество (set) слов.
При большом потоке сообщений, это может сильно увеличить нагрузку на сервер и замедлить работу бота.
Я опишу уже улучшенный вариант, к которому мы пришли с подписчиком @rusheslav после тестирования фильтра в чате, но если у вас есть комментарии или рекомендации по улучшению кода, буду рад!


Множество запрещённых слов.
Использовать будем готовый список: https://github.com/bars38/Russian_ban_words
Вы можете составить свой или найти другой.

Скачиваем файл words.txt. Для большей наглядности, я его переименовал в ban_words.txt.

В корне проекта создаём директорию res и помещаем туда файл.

Открываем файл settings.py и в начале, после импортов создаём константу BAN_WORDS.
В этой константе создаётся множество из слов в файле.

BAN_WORDS = set(line.strip() for line in open('res/ban_words.txt'))

Фильтрующая функция.
В пакете handlers создадим новый файл filter_words.py.

Создаём асинхронную функцию check_message, принимающую message.

Код функции:

import string

from aiogram.types import Message

from botlogic import views
from botlogic.settings import BAN_WORDS, logger


async def check_message(message: Message):
    contains_ban_word = False

    if message.text:
        message_words = set(message.text.translate(str.maketrans('', '', string.punctuation)).split())
        filtered_message = message.text
        for word in message_words:
            if word.lower() in BAN_WORDS:
                filtered_message = filtered_message.replace(word, "*" * len(word))
                contains_ban_word = True

    if contains_ban_word:
        await message.delete()
        logger.info(f"Удалено сообщение от пользователя {message.from_user.username}: {message.text}")
        await message.answer_sticker('CAACAgIAAxkBAAEKbW1lGVW1I6zFVLyovwo2rSgIt1l35QADJQACYp0ISWYMy8-mubjIMAQ')
        await message.answer(views.filtered_message(message.from_user.username, filtered_message))

По ходу действий:
Создаём переменную contains_ban_word. Это "флаг", по умолчанию считаем, что в сообщении нет запрещённых слов.
После проверки на наличие сообщения создаём переменную message_words, в которой создаём множество очищенных от пунктуации слов. Множество не позволяет хранить в себе два одинаковых объекта, тем самым в переменной будут только уникальные слова. И переменную filtered_message, в которую помещаем копию сообщения.

Далее проходимся циклом for по множеству слов из сообщения.
Если слово есть среди запрещённых, заменяем его на звёздочки в количестве длинны слова и выставляем "флаг" о наличии в тексте запрещённых слов.

Далее проверка "флага", если переменная contains_ban_word по-прежнему в изначальном состоянии False, то бот ничего не делает.
В противном случае бот сперва удаляет исходное сообщение. Записывает сообщение и информацию от кого в лог файл. Затем отправляет стикер по его идентификатору, после чего отправляет сообщение с исправленным текстом.


Как получить идентификатор стикера.
Для получения идентификатора стикера, достаточно отправить боту https://t.iss.one/idstickerbot стикер, идентификатор которого хотите получить.
В ответ он пришлёт идентификатор.
Готово.


Завершение
Осталось только зарегистрировать обработчик. Добавляем в файл main.py следующую строку: dp.message.register(check_message). Отсутствие второго аргумента означает, что бот будет обрабатывать все сообщения.

Готово. Теперь бот фильтрует нежелательные слова в сообщениях. Конечно это не панацея и мы все знаем, как можно исхитриться в Русском языке, но основную часть отсеивать будет. А потом просто добавляем слова.


Дополнительно: Изменение логгера.
Изначально логгер находился в файле main.py и не записывал никуда события, только отображал в терминале.

Вынес логгер в файл settings.py. Определил два обработчика, для терминала и для файла.

Код нового логгера:

# Логгер  
logger = logging.getLogger()  
logger.setLevel(logging.INFO)  
formatter = logging.Formatter(  
    "%(asctime)s - [%(levelname)s] -  %(name)s - (%(filename)s).%(funcName)s(%(lineno)d) - %(message)s")  
  
console_handler = logging.StreamHandler()  
console_handler.setLevel(logging.INFO)  
console_handler.setFormatter(formatter)  
  
file_handler = logging.FileHandler("logs.txt")  
file_handler.setLevel(logging.INFO)  
file_handler.setFormatter(formatter)  
  
logger.addHandler(console_handler)  
logger.addHandler(file_handler)

Файлы к посту, можно получить в боте по коду: 702209
Пост на сайте.
Поддержать канал.

Кто помнит карточки?))

Соберём результаты опроса по возрасту подписчиков.

В опросе приняло участие 47 человек!

Получаются следующие цифры:
2 подписчика до 15 лет.
На третьем месте подписчики от 19 до 25 лет - в числе 8 проголосовавших.
Бо́льшая часть, а именно 19 человек в возрасте от 26 до 35.
Не отстают и подписчики от 36 до 45, их насчитывается 16.
Один подписчик в возрасте 46-55.
И одна(ин) стеснительный, пожелавший остаться неизвестным)

В комментарии к опросу пришло предложение сделать опрос по городам подписчиков.
Вместо опроса, пишите в комментариях из какого вы города! Потом также оформлю результаты.

Приветствую.

В комментариях к шуточному опросу про тестирование систем оповещения, зашла речь о бункерах. И мне вспомнился один хороший фильм на эту тему.

Посему, предлагаю ввести "пятничную" рубрику с фильмом на вечер от меня и с вашими вариантами в комментариях.

Фильм на сегодня: Взрыв из прошлого (1998).

Краткий синопсис: Адам Уэббер родился нормальным ребенком, но, по глупому недоразумению, провел 35 лет в бомбоубежище вместе со своими родителями. Наивный и искренний, он впервые оказывается среди людей в бушующем Лос-Анджелесе 90-х! И кто знает - может, он еще успеет наверстать упущенное?!

Посмотреть фильм можно по ссылке: https://www.sspoisk.ru/film/2408

Может быть у вас есть свой вариант фильма на вечер? Делитесь им в комментариях!

AIOgram3 15. Обработка события вступления или покидания чата

Последняя (на данный момент) задача - это приветствие нового участника чата и оповещение о том, что кто-то нас покинул.

Решение достаточно простое и пост будет коротким.

Обработка событий.
Откроем файл events.py в пакете handlers и создадим две асинхронные функции: on_user_join и on_user_left.
Обе функции принимают event - объект класса ChatMemberUpdated.

В теле функции напишем отправку сообщения в ответ на событие, обращаясь к методам new_chat_member и old_chat_member.

Код функций:

from aiogram.types import ChatMemberUpdated


async def on_user_join(event: ChatMemberUpdated):
    await event.answer(views.join_message(event.new_chat_member.user.first_name))


async def on_user_left(event: ChatMemberUpdated):
    await event.answer(views.left_message(event.old_chat_member.user.first_name))

Не забудьте написать функции, возвращающие текст сообщения в файле views.py.


Регистрация обработчиков.
Переходим в файл main.py и добавляем следующие строки:

from aiogram.filters import ChatMemberUpdatedFilter, IS_NOT_MEMBER, IS_MEMBER


dp.chat_member.register(on_user_join, ChatMemberUpdatedFilter(IS_NOT_MEMBER >> IS_MEMBER))  
dp.chat_member.register(on_user_left, ChatMemberUpdatedFilter(IS_MEMBER >> IS_NOT_MEMBER))

Готово! Теперь если новый пользователь зайдёт в чат, его поприветствует бот, а если кто-то его покинет, бот уведомит и об этом.

Файлы к посту, можно получить в боте по коду: 164296
Пост на сайте.
Поддержать канал.

#aiogram #гайды #python

😐И так каждый раз...