Skip to content

Latest commit

 

History

History
57 lines (43 loc) · 3.92 KB

README.md

File metadata and controls

57 lines (43 loc) · 3.92 KB

Rust Repository Template 🦀

Repository template to get quickly started with writing Rust libraries, ready for distributing.

Getting started

Open your favorite terminal and clone this locally.

  • With the GitHub CLI (replace <project> with what you'd like to call your project):

    gh repo create <project> --template nlp-rs/rust-template
  • With the Git CLI:

    git clone https://github.com/nlp-rs/rust-template.git

Features

Configure

Tool File path Reference
GitHub Codespaces devcontainer.json Reference
GitHub Actions .github/workflows Reference
Cargo package Cargo.toml Reference
Clippy (Rust linter) .clippy.toml Repository, Reference
Rustfmt (Rust formatter) .rustfmt.toml Repository, Reference
Commitlint .commitlintrc.json Repository, Reference
cargo-deny deny.toml Repository

Run scripts locally

Script Command
Run unit/integration/doc tests cargo test
Run fuzz tests cargo fuzz <fuzz-target>
Run Rustfmt cargo fmt
Run Clippy cargo clippy
Run performance benchmarks cargo bench
Generate API docs for crate cargo doc
Generate mdBook docs for crate mdbook build
Run security audits cargo audit1

Footnotes

  1. Requires installing cargo-audit locally