понедельник, 2 июня 2025 г.

poetry new , Giga, Python. Code Format, Tools

poetry new <project-name>, Giga, Python. Code Format, Tools

https://giga.chat/link/gcsObBTGeV

Команда poetry new <project-name> инициирует создание нового Python-проекта с базовой структурой и

подготовленным файлом конфигурации pyproject.toml.

Давайте разберём детально, что конкретно делает команда poetry new toy-project:

Шаги, выполняемые командой:

  1. Создание каталога проекта:Команда создаёт новый каталог с именем указанного вами проекта (toy-project).
  2. Генерация базовой структуры:Внутри каталога создаются стандартные директории и файлы,
  3. соответствующие стандартной структуре Python-проекта:
    • .gitignore: файл с правилами игнорирования временных файлов и артефактов.
    • tests/: директория для размещения модульных тестов.
    • src/toy_project/__init__.py: директория с основным источником кода и пустой инициализационный файл.
    • pyproject.toml: главный файл конфигурации, содержащий базовые сведения о проекте
    • (метаданные, информация о сборке и зависимостях).
  4. Заполнение pyproject.toml:Этот файл получает начальную информацию о вашем новом проекте:
    • Название проекта: <project-name>.
    • Версия: обычно начинается с нуля (0.1.0).
    • Описание: короткое пояснение назначения проекта.
    • Лицензия: тип лицензии по умолчанию — MIT.
    • Информация о зависимостях: пока никаких зависимостей не добавляется.

Пример содержимого pyproject.toml после запуска команды:

[tool.poetry]
name = "toy-project"
version = "0.1.0"
description = ""
authors = []
license = "MIT"

[tool.poetry.dependencies]
python = "^3.10"

[tool.poetry.dev-dependencies]
pytest = "^7.0.0"

[build-system]
requires = ["poetry-core>=1.0.0"]
build-backend = "poetry.core.masonry.api"
  1. Настройка рабочего окружения:После создания проекта и заполнения базовых файлов,
  2. Poetry может предложить дополнительно инициализировать Git-репозиторий и
  3. создать первое коммит-сообщение («Initial commit»).

Резюме

Команда poetry new toy-project фактически запускает процесс быстрого старта нового Python-проекта,

создавая минимальный набор нужных файлов и директорий, определяя первичные метаданные и

готовя основу для дальнейшего развития и сборки проекта.

Теперь, когда проект создан, вы можете приступить к дальнейшему развитию:

добавлять зависимости, разрабатывать функциональности,

проводить тестирование и готовить релиз с помощью мощного функционала Poetry.

Комментариев нет:

Отправить комментарий