uv-{lock, sync, build, export, version}: add Russian translation (#21126)

pages.ru/common/uv-build.md

@@ -0,0 +1,36 @@
+# uv build
+
+> Собирать пакеты Python в исходные дистрибутивы и wheel-файлы.
+> Больше информации: <https://docs.astral.sh/uv/reference/cli/#uv-build>.
+
+- Собрать пакет в текущем каталоге:
+
+`uv build`
+
+- Собрать пакет из указанного каталога:
+
+`uv build {{путь/к/каталогу}}`
+
+- Собрать только wheel (пропустить исходный дистрибутив):
+
+`uv build --wheel`
+
+- Собрать только исходный дистрибутив (пропустить wheel):
+
+`uv build --sdist`
+
+- Собрать и поместить результат в указанный каталог:
+
+`uv build {{[-o|--out-dir]}} {{путь/к/выходному_каталогу}}`
+
+- Собрать определённый пакет в рабочем пространстве:
+
+`uv build --package {{имя_пакета}}`
+
+- Собрать все пакеты в рабочем пространстве:
+
+`uv build {{[--all|--all-packages]}}`
+
+- Собрать с использованием определённого интерпретатора Python:
+
+`uv build {{[-p|--python]}} {{python3.11}}`

pages.ru/common/uv-export.md

@@ -0,0 +1,36 @@
+# uv export
+
+> Экспортировать файл блокировки проекта в альтернативный формат.
+> Больше информации: <https://docs.astral.sh/uv/reference/cli/#uv-export>.
+
+- Экспортировать зависимости в файл `requirements.txt`:
+
+`uv export --format requirements-txt {{[-o|--output-file]}} {{requirements.txt}}`
+
+- Экспортировать зависимости в формат `pylock.toml`:
+
+`uv export --format pylock.toml`
+
+- Экспортировать только рабочие зависимости (без зависимостей разработки):
+
+`uv export --no-dev`
+
+- Экспортировать с определённой необязательной группой зависимостей:
+
+`uv export --extra {{имя_группы}}`
+
+- Экспортировать со всеми необязательными зависимостями:
+
+`uv export --all-extras`
+
+- Экспортировать с определённой группой зависимостей:
+
+`uv export --group {{имя_группы}}`
+
+- Экспортировать без хешей:
+
+`uv export --no-hashes`
+
+- Экспортировать зависимости для определённого пакета в рабочем пространстве:
+
+`uv export --package {{имя_пакета}}`

pages.ru/common/uv-lock.md

@@ -0,0 +1,32 @@
+# uv lock
+
+> Обновлять файл блокировки проекта.
+> Больше информации: <https://docs.astral.sh/uv/reference/cli/#uv-lock>.
+
+- Создать или обновить файл блокировки проекта:
+
+`uv lock`
+
+- Проверить актуальность файла блокировки без его обновления:
+
+`uv lock --check`
+
+- Убедиться, что файл блокировки существует, без проверки актуальности:
+
+`uv lock --check-exists`
+
+- Предварительно просмотреть, что будет заблокировано, без записи файла:
+
+`uv lock --dry-run`
+
+- Заблокировать зависимости определённого скрипта Python вместо текущего проекта:
+
+`uv lock --script {{путь/к/скрипту.py}}`
+
+- Обновить все пакеты до последних совместимых версий:
+
+`uv lock --upgrade`
+
+- Обновить только определённые пакеты:
+
+`uv lock --upgrade-package {{пакет1}} --upgrade-package {{пакет2}}`

pages.ru/common/uv-sync.md

@@ -0,0 +1,36 @@
+# uv sync
+
+> Обновлять окружение проекта в соответствии с файлом блокировки.
+> Больше информации: <https://docs.astral.sh/uv/reference/cli/#uv-sync>.
+
+- Синхронизировать окружение проекта с файлом блокировки:
+
+`uv sync`
+
+- Синхронизировать со всеми необязательными зависимостями:
+
+`uv sync --all-extras`
+
+- Синхронизировать с определёнными необязательными зависимостями:
+
+`uv sync --extra {{имя_дополнения}}`
+
+- Синхронизировать только зависимости разработки:
+
+`uv sync --only-dev`
+
+- Синхронизировать без зависимостей разработки:
+
+`uv sync --no-dev`
+
+- Синхронизировать определённые группы зависимостей:
+
+`uv sync --group {{имя_группы}}`
+
+- Проверить, синхронизировано ли окружение (без изменений):
+
+`uv sync --check`
+
+- Предварительно просмотреть, что будет синхронизировано, без внесения изменений:
+
+`uv sync --dry-run`

pages.ru/common/uv-version.md

@@ -0,0 +1,28 @@
+# uv version
+
+> Читать или обновлять версию проекта.
+> Больше информации: <https://docs.astral.sh/uv/reference/cli/#uv-version>.
+
+- Показать текущую версию проекта:
+
+`uv version`
+
+- Установить определённую версию проекта:
+
+`uv version {{1.2.3}}`
+
+- Увеличить версию проекта по семантическому версионированию:
+
+`uv version --bump {{major|minor|patch}}`
+
+- Предварительно просмотреть изменение версии без записи в `pyproject.toml`:
+
+`uv version --bump {{patch}} --dry-run`
+
+- Обновить версию определённого пакета в рабочем пространстве:
+
+`uv version --package {{имя_пакета}} {{1.2.3}}`
+
+- Показать версию в формате JSON:
+
+`uv version --output-format json`