karkas/docs/DEV.md

Настройка рабочего окружения

Данная инструкция поможет вам настроить рабочее окружение для разработки Karkas.

Предварительные требования

• Python 3.12: Karkas требует Python 3.12.
• VSCode: Рекомендуется использовать VSCode для разработки.
• Git: У вас должен быть установлен Git для клонирования репозитория.

Шаги

1. Клонируйте репозиторий:

   git clone https://gitflic.ru/project/alt-gnome/karkas.git
   

2. Откройте проект в VSCode:

   • Откройте папку karkas в VSCode.
   • VSCode автоматически предложит открыть проект как workspace, используя файл karkas.code-workspace. Нажмите "Открыть Workspace", чтобы принять предложение.

3. Настройте Poetry:

   • Установите Poetry, следуя инструкциям на официальном сайте: https://python-poetry.org/docs/.
   • Для каждого пакета:
     • Перейдите в папку пакета (например, src/karkas_core).
     • Выполните команду poetry install, чтобы установить зависимости пакета.
     • Poetry создаст виртуальное окружение внутри папки пакета (.venv).

4. Активируйте виртуальное окружение:

   • Выполните команду poetry shell в папке пакета, чтобы активировать виртуальное окружение.

Теперь ваше рабочее окружение настроено, и вы можете начать.

Дополнительная информация

• Каждый пакет в монорепозитории имеет свой собственный файл pyproject.toml, где указаны его зависимости.
• Poetry автоматически управляет виртуальными окружениями для каждого пакета.
• Вы можете использовать команду poetry add <package_name> для добавления новых зависимостей.