$ sudo teach IT
Модуль 2 · Свой проект · Урок 2.1

Проект за одну команду

Вы создадите проект командой uv init, запустите его и поймёте, что лежит в каждом файле.

Теория + практика~5 минутНовичок

Один файл запускать мы уже умеем. Настоящая программа — это папка: код, нужные пакеты, версия Python. Руками собирать её не придётся.

Одна команда — готовый проект

Создадим проект banner: позже он будет печатать надпись крупными буквами.

Терминал
$ uv init banner
Initialized project `banner` at `~/banner`

Всё. Проект создан. uv сделал папку banner со всем нужным и сразу завёл git-репозиторий (папка .git).

Структура проекта
banner/
├── .git/
├── .gitignore
├── .python-version
├── README.md
├── pyproject.toml
└── src/
    └── banner/
        └── __init__.py

Разбор по строкам

  • .gitignore — список файлов, которые git не берёт (например, .venv)
  • .python-version — версия Python для проекта
  • README.md — описание проекта
  • pyproject.toml — паспорт проекта, разберём ниже
  • src/banner/__init__.py — сам код

Паспорт проекта: pyproject.toml

Здесь uv записывает, что за проект перед вами. Читается как анкета.

TOML · pyproject.toml
[project]
name = "banner"
version = "0.1.0"
description = "Add your description here"
readme = "README.md"
requires-python = ">=3.15"
dependencies = []

[project.scripts]
banner = "banner:main"

[build-system]
requires = ["uv_build>=0.13.9,<0.14.0"]
build-backend = "uv_build"

Разбор по строкам

  • name — имя проекта
  • version — версия самой программы
  • requires-python — какой Python нужен: 3.15 или новее
  • dependencies = [] — пакеты, которые нужны проекту (зависимости); пока пусто
  • banner = "banner:main" — команда banner вызывает функцию main из пакета banner
  • [build-system] — служебное, не трогаем

Про цифру 3.15

У вас она может быть другой: uv берёт тот Python, который нашёл на компьютере. Это не страшно.

Первый запуск

Зайдите в папку и запустите проект: команда называется так же, как он.

Терминал
$ cd banner
$ uv run banner
Вывод
Using CPython 3.15.2 interpreter at: ~/.local/bin/python3.15
Creating virtual environment at: .venv
   Building banner @ file:///home/you/banner
      Built banner @ file:///home/you/banner
Installed 1 package in 1ms
Hello from banner!

Hello from banner! — это работает код проекта:

Python · src/banner/__init__.py
def main() -> None:
    print("Hello from banner!")

Заодно uv сам создал две вещи: .venv — виртуальное окружение: отдельная коробка с пакетами именно этого проекта (git её не берёт). uv.lock — список точных версий (о нём позже). Делать с ними ничего не нужно.

Попробуйте

  • Откройте src/banner/__init__.py и замените текст в print на свой, например "Привет из banner!".
  • Снова выполните uv run banner: выйдет ваша надпись, строк про окружение уже не будет.

Что запомнить

  • uv init имя создаёт папку проекта с файлами и git-репозиторием.
  • pyproject.toml — паспорт проекта: имя, версия Python, зависимости.
  • uv run имя запускает проект и сам создаёт .venv и uv.lock.

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

На следующий урок