Publication to `crates.io`


Steps to Publish to `crates.io`

Publish to `crates.io`, Step by Step

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 in bk/crates↗.
cargo update↗ if necessary.
Go to crates.io↗, sign in, and create an API token in Account 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.