ERP-CORE-DEV Generate Cargo Project
Scaffold a Rust Cargo project with idiomatic structure and Cargo best practices.
What To Do
- Cargo.toml with edition = "2021", pinned dependency versions, and [profile.release] optimizations
- src/lib.rs or src/main.rs with module declaration skeleton and top-level lint attributes
- src/error.rs with a thiserror-derived error type
- tests/ directory with a basic integration test stub
- benches/ directory with a criterion benchmark stub
- .cargo/config.toml with rustflags = ["-D", "warnings"]
Project Types
lib (default)
- src/lib.rs re-exports the public API
- Include #![deny(missing_docs)] and #![deny(clippy::unwrap_used)]
bin
- src/main.rs entry point with anyhow::Result return type
- Suitable for CLI tools and application binaries
workspace
- Root Cargo.toml with [workspace] members list
- crates/{name}-core/ (lib) and crates/{name}-cli/ (bin) as initial members
- Shared [workspace.dependencies] table for version pinning
Best Practices
- Set edition = "2021" in every Cargo.toml
- Pin dependencies to major.minor.* (e.g., serde = "1.0.*")
- Add [profile.release] with lto = true, codegen-units = 1, opt-level = 3
- Use [workspace.dependencies] to deduplicate versions across workspace members
- List thiserror for lib crates, anyhow for bin crates
Arguments
<project-name>: Crate name in snake_case (e.g., my_service, data_pipeline)--type=<lib|bin|workspace>: Project type (default: lib)