The Crux crate depend on one another, and need to be released in the right order
crux_macroscrux_core- Capability crates (
crux_http crux_kv crux_platform crux_time)
There are scripts to help with this.
The easiest way of releasing is using release-plz
-
release-plz update- this should move the versions of all the crates according to the changes to their APIs. Note that this isn't bulletproof, because it doesn't consider all the changes which are in fact breaking as breaking.Things it misses: (may not be the complete list):
- changes to crux_macros that generate incompatible code
- changes to capability operation types
WARNING: If
crux_macrosorcrux_corehad a breaking change, usually it means breaking changes in capabilities because of trait changes etc. and capabilities need a minor version bump even if their API has not changed in a breaking way -
Commit the changes. Optionally, open a PR with the changes to the versions for review
-
Make sure the changes are on
master -
Use
scripts/cargo_publish.fishto publish the crates in the right order OR- publish
crux_macrosif it changed - publish
crux_coreif it changed - publish any capability crates that changed
- publish
-
Tag the commit used for the release with
[crate_name]-vX.Y.Z. You can usescripts/tag.fishto do that -
Push tags
-
for the
crux_coretag, create a GitHub release with release notes, especially breaking changes -
Give Zulip a heads up about the good news :)