This is tweaked cargo init --lib for FOSS. It contains recommendations from cargo book.

• Follow Rust API Guidelines
  • license MIT OR APACHE v2.0
• Contains default README.tpl that help you generate README.md with cargo-readme
• Contains CHANGELOG.md that follow keepchangelog
• Quick start CI workflow on stable rust:
  • cargo check
  • cargo test
  • cargo fmt
  • cargo clippy -- -D warnings

Installed:

• cargo-generate cargo install --git https://github.com/ashleygwilliams/cargo-generate (see issue #1)
• cargo-readme cargo install cargo-readme

You need to do four simple steps:

cargo generate --git https://github.com/xoac/crates-io-lib-template.git --name my-project
cd my-project

Learn more about cargo generate here.

You need to replace GITHUB_ORG_PATH with your organization path. For example for this project the GITHUB_ORG_PATH would be https://github.com/xoac/ (remember about last /).

You can do this with sed or with your IDE.

sed -i 's/GITHUB_ORG_PATH/https:\/\/github\.com\/xoac\//g' README.tpl CHANGELOG.md Cargo.toml

This is limitation because of this issue.

Edit Cargo.toml there are some basic information you should provide (look for TODO).

Learn more about Cargo.toml here.

This is limitation because of this issue.

Add documentation at top of src/lib.rs and generate README.md from that with:

cargo readme > README.md

Lern more about cargo readme here.