Перейти к содержанию

Установка и настройка ⚙️#

Прежде чем мы начнем создавать крутые приложения с FastStream, нужно подготовить рабочую среду. В этом разделе мы установим всё необходимое: Python, FastStream, RabbitMQ и дополнительные библиотеки. Не переживайте, если вы новичок — мы разберем каждый шаг простыми словами и с примерами! 😊 Готовы? Погнали! 🚀

Что нам понадобится? 📋#

Для работы с руководством вам нужно:

  • Python 3.9+ 🐍: Основной язык программирования.
  • FastStream 📦: Фреймворк для работы с брокерами сообщений.
  • RabbitMQ 🐰: Брокер сообщений, который мы будем использовать.
  • Pydantic 🛡️: Библиотека для валидации данных (используется в последующих главах).
  • pytest и pytest-asyncio 🧪: Для тестирования приложений.
  • Docker (рекомендуется) 🐳: Для быстрого запуска RabbitMQ.
  • Терминал 💻: Для ввода команд (например, PowerShell, Bash или терминал в вашей IDE).

Если у вас чего-то из этого нет, не беда — мы всё настроим шаг за шагом!

Шаг 1: Установка Python 🐍#

  1. Проверьте, установлен ли Python: В терминале выполните команду: 

    python --version
    или 
    python3 --version
    Если вы видите версию 3.9 или выше (например, Python 3.10.6), всё готово! Если нет, переходите к установке.

  2. Установите Python:

    • Загрузите установщик с официального сайта Python.
    • Установите Python, убедившись, что вы добавили его в PATH (это опция в установщике).
    • Проверьте установку снова с помощью python --version.

  3. Настройте виртуальное окружение (рекомендуется):

    • Создайте папку для проекта и настройте виртуальное окружение: 
      mkdir faststream-tutorial
cd faststream-tutorial
python -m venv venv
    • Активируйте окружение:
    • На Windows: venv\Scripts\activate
    • На macOS/Linux: source venv/bin/activate

После активации вы увидите (venv) в терминале. Это изолирует зависимости проекта. ✅

Шаг 2: Установка FastStream и зависимостей 📦#

FastStream — это Python-фреймворк, который упрощает работу с брокерами сообщений. Мы установим его с поддержкой RabbitMQ, CLI для удобного запуска приложений, а также Pydantic и pytest для валидации данных и тестирования.

  1. Убедитесь, что виртуальное окружение активно (если вы его создали).

  2. Выполните команду для установки всех необходимых библиотек: 

    pip install "faststream[rabbit,cli]"

    • [rabbit] добавляет поддержку RabbitMQ.
    • [cli] устанавливает утилиту для запуска приложений.

  3. Проверьте установку FastStream: 

    faststream --version

Вы должны увидеть версию FastStream, например, FastStream 0.x.x. Если команда не работает, убедитесь, что вы в правильном окружении и Python доступен.

Шаг 3: Установка RabbitMQ 🐰#

RabbitMQ — это брокер сообщений, который мы будем использовать в руководстве. Самый простой способ запустить его — через Docker. Если вы не хотите использовать Docker, мы также опишем ручную установку.

Вариант 1: RabbitMQ через Docker (рекомендуется) 🐳#

  1. Установите Docker:

    • Загрузите и установите Docker Desktop для Windows/macOS или Docker для Linux.
    • Проверьте, что Docker работает: 
      docker --version

  2. Запустите RabbitMQ: Выполните команду, чтобы запустить RabbitMQ с веб-интерфейсом управления: 

    docker run -it --rm --name rabbitmq -p 5672:5672 -p 15672:15672 rabbitmq:3-management

    • -p 5672:5672: Порт для подключения FastStream.
    • -p 15672:15672: Порт для веб-интерфейса.
    • rabbitmq:3-management: Образ с включенным веб-интерфейсом.

  3. Проверьте RabbitMQ:

    • Откройте браузер и перейдите по адресу http://localhost:15672.
    • Войдите с логином guest и паролем guest.
    • Если вы видите панель управления RabbitMQ, всё работает! 🎉

Вариант 2: Ручная установка RabbitMQ#

Если Docker не подходит, установите RabbitMQ вручную:

  1. Загрузите RabbitMQ с официального сайта для вашей ОС.
  2. Установите Erlang (требуется для RabbitMQ) — инструкции там же.
  3. Следуйте инструкциям для вашей системы (Windows, macOS, Linux).
  4. Включите плагин управления: 
    rabbitmq-plugins enable rabbitmq_management
  5. Запустите RabbitMQ и проверьте веб-интерфейс на http://localhost:15672 (логин: guest, пароль: guest).

Шаг 4: Проверка окружения 🔍#

Давайте убедимся, что всё настроено правильно:

  1. Python: Выполните python --version и убедитесь, что версия 3.9+.
  2. FastStream: Выполните faststream --version и проверьте, что CLI работает.
  3. RabbitMQ: Откройте http://localhost:15672 и войдите с guest:guest. Также проверьте, что порт 5672 открыт: 
    telnet localhost 5672
    Если соединение установлено, RabbitMQ готов.

Шаг 5: Создание рабочей директории 📁#

Создайте папку для проекта, если вы ещё этого не сделали:

mkdir faststream-tutorial
cd faststream-tutorial

Если вы используете виртуальное окружение, активируйте его снова:

  • Windows: venv\Scripts\activate
  • macOS/Linux: source venv/bin/activate

Теперь вы готовы писать код! 💻

Что дальше? 🗺️#

Поздравляем, вы настроили всё необходимое для работы с FastStream и RabbitMQ! 🎉 Теперь пора создать первое приложение, которое будет отправлять и получать сообщения. Перейдите к разделу Создаем первое приложение, чтобы начать писать код.

Если у вас есть идеи, вопросы или нужна помощь, загляните в официальную документацию FastStream, пишите в Telegram или Discord. Вперед к созданию потоковых приложений! 🚀