Публикация релиза

Короткая инструкция для мейнтейнеров Light. Публикация выполняется вручную: токен crates.io не хранится в репозитории.

1. Подготовка

Убедитесь, что рабочее дерево чистое, а версия обновлена во всех манифестах и внутренних зависимостях.
Обновите CHANGELOG.md и docs/ROADMAP.md.

Прогоните проверки:

cargo fmt --all -- --check
cargo clippy --workspace --all-targets --all-features -- -D warnings
cargo test --workspace --all-features
cargo build --workspace

Проверьте демо:

cargo run -p light-fw-cli -- check --strict crates/light-demo

2. Вход в crates.io

Создайте токен на https://crates.io/settings/tokens и выполните:

cargo login

cargo попросит вставить токен и сохранит его в ~/.cargo/credentials.toml. В CI передавайте токен через переменную окружения CARGO_REGISTRY_TOKEN, а не через файл.

3. Проверка пакетов

Сначала выполните dry-run — он упакует все крейты, но ничего не опубликует:

cargo run -p light-fw-cli -- publish --dry-run

Если light уже установлен:

light publish --dry-run

--dry-run полезен для проверки состава пакетов и порядка публикации. Он не требует токена.

Рекомендуемый способ — light publish: команда сама строит топологический порядок из cargo metadata, пропускает publish = false (например, light-demo), проверяет версии и внутренние зависимости, запускает pre-flight-гейты и повторяет попытки при устаревании индекса crates.io.

cargo run -p light-fw-cli -- publish

Или, если CLI установлен:

light publish

Для неинтерактивного запуска:

light publish --yes

Токен можно передать явно:

light publish --token "$CARGO_REGISTRY_TOKEN"

Полезные флаги: --allow-dirty, --skip-gates, --no-verify, --only <крейт> (повторить публикацию одного крейта).

Ручной вариант через `cargo publish`

Если нужно публиковать вручную, соблюдайте порядок зависимостей:

cargo publish -p light-fw-html
cargo publish -p light-fw-cli-core
cargo publish -p light-fw-cli
cargo publish -p light-fw-macros
cargo publish -p light-fw-core
cargo publish -p light-fw-behavior-validation
cargo publish -p light-fw-element-form
cargo publish -p light

После каждой публикации может потребоваться пауза, пока индекс crates.io увидит новую версию. light publish делает такие паузы и повторы автоматически.

5. Тег и проверка

После успешной публикации всех крейтов создайте тег:

git tag -a vX.Y.Z -m "Release X.Y.Z"
git push origin master
git push origin vX.Y.Z

Проверьте результат:

cargo search light
cargo install light-fw-cli --version X.Y.Z

Также откройте страницы крейтов на crates.io и убедитесь, что docs.rs собрал документацию.

Важно

Опубликованную версию нельзя перезаписать. Если публикация оборвалась после части крейтов, исправьте проблему и выпустите следующую версию; light publish пропустит уже опубликованные крейты.
Не публикуйте с грязным рабочим деревом без необходимости.
Тег ставьте только на проверенный коммит, из которого собраны пакеты.

Keyboard shortcuts

Light