Crates.io | cargo-generate |
lib.rs | cargo-generate |
version | 0.21.2 |
source | src |
created_at | 2018-05-29 12:39:19.081679 |
updated_at | 2024-07-15 18:11:07.281428 |
description | cargo, make me a project |
homepage | |
repository | https://github.com/cargo-generate/cargo-generate |
max_upload_size | |
id | 67603 |
size | 423,346 |
cargo, make me a project
cargo-generate
is a developer tool to help you get up and running quickly with a new Rust
project by leveraging a pre-existing git repository as a template.
Here's an example of using cargo-generate
with this template:
See the cargo-generate
guide for complete documentation.
One place to find templates is to look for the cargo-generate topic on GitHub.
cargo install cargo-generate
or if you have no time, use cargo-binstall:
cargo binstall cargo-generate
# templates on github
cargo generate --git https://github.com/username-on-github/mytemplate.git
# or just
cargo generate username-on-github/mytemplate
# templates on other git platforms
cargo generate gl:username-on-gitlab/mytemplate # translates to https://gitlab.com/username-on-gitlab/mytemplate.git
cargo generate bb:username-on-bitbucket/mytemplate # translates to https://bitbucket.org/username-on-bitbucket/mytemplate.git
cargo generate sr:username-on-sourcehut/mytemplate # translates to https://git.sr.ht/~username-on-sourcehut/mytemplate (note the tilde)
# this scheme is also available for github
cargo generate gh:username-on-github/mytemplate # translates to https://github.com/username-on-github/mytemplate.git
# for a complete list of arguments and options
cargo help generate
Licensed under either of
at your option.
Unless you explicitly state otherwise, any contribution intentionally
submitted for inclusion in the work by you, as defined in the Apache-2.0
license, shall be dual licensed as above, without any additional terms or
conditions.
If you want to contribute to cargo-generate
, please read our CONTRIBUTING notes.
cargo-generate would not be what it is today without the wonderful contributions from the community. Thank you!