mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-04-25 18:47:56 +00:00
Alexandru Vasile
798a1d0b88
* scripts: Generate changelog Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io> * scripts: Remove git tag verification Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io> * scripts: Add usage example Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io> * Update releasing steps to automate the changelog commits Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io>
91 lines
3.8 KiB
Markdown
91 lines
3.8 KiB
Markdown
# Release Checklist
|
|
|
|
These steps assume that you've checked out the Subxt repository and are in the root directory of it.
|
|
|
|
We also assume that ongoing work done is being merged directly to the `master` branch.
|
|
|
|
1. Ensure that everything you'd like to see released is on the `master` branch.
|
|
|
|
2. Create a release branch off `master`, for example `release-v0.17.0`. Decide how far the version needs to be bumped based
|
|
on the changes to date. If unsure what to bump the version to (e.g. is it a major, minor or patch release), check with the
|
|
Parity Tools team.
|
|
|
|
3. Check that you're happy with the current documentation.
|
|
|
|
```
|
|
cargo doc --open --all-features
|
|
```
|
|
|
|
CI checks for broken internal links at the moment. Optionally you can also confirm that any external links
|
|
are still valid like so:
|
|
|
|
```
|
|
cargo install cargo-deadlinks
|
|
cargo deadlinks --check-http -- --all-features
|
|
```
|
|
|
|
If there are minor issues with the documentation, they can be fixed in the release branch.
|
|
|
|
4. Bump the crate version in `Cargo.toml` to whatever was decided in step 2 for `subxt-cli`, `subxt-codegen`, `subxt-examples`, `subxt-macro` ,`subxt`, `test-runtime`.
|
|
|
|
5. Update `CHANGELOG.md` to reflect the difference between this release and the last. If you're unsure of
|
|
what to add, check with the Tools team. See the `CHANGELOG.md` file for details of the format it follows.
|
|
|
|
Utilize the following script to generate the merged PRs between releases.
|
|
```
|
|
./scripts/generate_changelog.sh
|
|
```
|
|
Ensure that the script picked the latest published release tag (e.g. if releasing `v0.17.0`, the script should
|
|
provide `[+] Latest release tag: v0.16.0` ). Then group the PRs into "Added" and "Changed" sections.
|
|
|
|
6. Commit any of the above changes to the release branch and open a PR in GitHub with a base of `master`.
|
|
|
|
7. Once the branch has been reviewed and passes CI, merge it.
|
|
|
|
8. Now, we're ready to publish the release to crates.io.
|
|
|
|
1. Checkout `master`, ensuring we're looking at that latest merge (`git pull`).
|
|
|
|
```
|
|
git checkout master && git pull
|
|
```
|
|
|
|
2. Perform a dry-run publish to ensure the crates can be correctly published.
|
|
|
|
The crates in this repository need publishing in a specific order, since they depend on each other.
|
|
|
|
```
|
|
(cd codegen && cargo publish --dry-run) && \
|
|
(cd macro && cargo publish --dry-run) && \
|
|
(cd subxt && cargo publish --dry-run) && \
|
|
(cd cli && cargo publish --dry-run);
|
|
```
|
|
|
|
3. If the dry-run was successful, run the following command to publish each crate in the required order (allowing
|
|
a little time in between each to let crates.io catch up with what we've published).
|
|
|
|
```
|
|
(cd codegen && cargo publish) && \
|
|
sleep 10 && \
|
|
(cd macro && cargo publish) && \
|
|
sleep 10 && \
|
|
(cd subxt && cargo publish) && \
|
|
sleep 10 && \
|
|
(cd cli && cargo publish);
|
|
```
|
|
|
|
If you run into any issues regarding crates not being able to find suitable versions of other `subxt-*` crates,
|
|
you may just need to wait a little longer and then run the remaining portion of that command.
|
|
|
|
9. If the release was successful, tag the commit that we released in the `master` branch with the
|
|
version that we just released, for example:
|
|
|
|
```
|
|
git tag -s v0.17.0 # use the version number you've just published to crates.io, not this one
|
|
git push --tags
|
|
```
|
|
|
|
Once this is pushed, go along to [the releases page on GitHub](https://github.com/paritytech/subxt/releases)
|
|
and draft a new release which points to the tag you just pushed to `master` above. Copy the changelog comments
|
|
for the current release into the release description.
|