mirror of
https://github.com/pezkuwichain/pezkuwi-subxt.git
synced 2026-04-22 21:58:00 +00:00
Alexandru Vasile
c07b9e4be8
* Bump versions to `v0.22.0` Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io> * Add missing crates for releasing chore Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io> * Update changelog Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io> * Update changelog message & remove non-user facing PRs Signed-off-by: Alexandru Vasile <alexandru.vasile@parity.io> * Update CHANGELOG.md Co-authored-by: James Wilson <james@jsdw.me> * Update CHANGELOG.md Co-authored-by: James Wilson <james@jsdw.me> Co-authored-by: James Wilson <james@jsdw.me>
94 lines
3.8 KiB
Markdown
94 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-metadata`, `subxt-cli`, `subxt-codegen`, `subxt-examples`, `subxt-macro` ,`subxt`, `integration-tests`, `test-runtime`, `ui-tests`.
|
|
|
|
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.
|
|
|
|
First, if there have been any significant changes, add a description of those changes to the top of the
|
|
changelog entry for this release.
|
|
|
|
Next, you can use 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 "Fixed", "Added" and "Changed" sections, and make any
|
|
other adjustments that you feel are necessary for clarity.
|
|
|
|
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 final sanity check that everything looks ok.
|
|
|
|
```
|
|
cargo check --all-targets
|
|
cargo test --all-targets
|
|
```
|
|
|
|
3. 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 metadata && cargo publish) && \
|
|
(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.
|