Один файл запускать мы уже умеем. Настоящая программа — это папка: код, нужные пакеты, версия 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 записывает, что за проект перед вами. Читается как анкета.
[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 bannerUsing 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! — это работает код проекта:
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.
Проект пока пустой: добавим первый пакет, и надпись станет большой.