Home

Awesome

cargo-io-lib-template

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

What this template provide?:

pre-requires:

Installed:

How to use:

You need to do four simple steps:

1. Use cargo generate to clone this template

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

Learn more about cargo generate here.

2. Update CHANGELOG.md and README.tpl Cargo.toml

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.

3. Update Cargo.toml

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.

4. Replace this README.md

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.