Publish to crates.io
Publication Steps
The publish
↗ folder contains a placeholder crate, so that the book could be located when searching on crates.io
↗.
To publish the crate to crates.io
, use the following steps:
-
cd publish
-
Review
Cargo.toml
↗, update the metadata as needed. Keep the version in sync with that of the main workspace inbk/crates
↗. -
cargo update
↗ if necessary. -
Go to
crates.io
↗, sign in, and create an API token inAccount Settings
>API Tokens
. -
Use
cargo login
↗ to save the token in$CARGO_HOME/credentials.toml
. -
cargo build --locked --release
. -
cargo clippy
. -
cargo run --release
. -
cargo doc
. -
Review
cargo package --list
. -
cargo package
. -
Review the packaging output in
target/publish/package
. -
When ready,
cargo publish --dry-run; cargo publish
.
Type just
↗ at the command line for a list of shortcuts for some of the above commands.