cargo new foo
cargo-new - Create a new Cargo package
cargo new [OPTIONS] PATH
This command will create a new Cargo package in the given directory. This
includes a simple template with a Cargo.toml manifest, sample source file,
and a VCS ignore file. If the directory is not already in a VCS repository,
then a new repository is created (see --vcs below).
The "authors" field in the manifest is determined from the environment or configuration settings. A name is required and is determined from (first match wins):
cargo-new.name Cargo config value
CARGO_NAME environment variable
GIT_AUTHOR_NAME environment variable
GIT_COMMITTER_NAME environment variable
user.name git configuration value
USER environment variable
USERNAME environment variable
NAME environment variable
The email address is optional and is determined from:
cargo-new.email Cargo config value
CARGO_EMAIL environment variable
GIT_AUTHOR_EMAIL environment variable
GIT_COMMITTER_EMAIL environment variable
user.email git configuration value
EMAIL environment variable
See the reference for more information about configuration files.
See cargo-init(1) for a similar command which will create a new manifest in an existing directory.
Create a package with a binary target (src/main.rs).
This is the default behavior.
Create a package with a library target (src/lib.rs).
Specify the Rust edition to use. Default is 2018. Possible values: 2015, 2018
Set the package name. Defaults to the directory name.
Initialize a new VCS repository for the given version control system (git,
hg, pijul, or fossil) or do not initialize any version control at all
(none). If not specified, defaults to git or the configuration value
cargo-new.vcs, or none if already inside a VCS repository.
Alternative registry to use. This sets the publish field which will
restrict publishing only to the given registry name.
This option is unstable and available only on the nightly channel and requires
the -Z unstable-options flag to enable.
Use verbose output. May be specified twice for "very verbose" output which
includes extra output such as dependency warnings and build script output.
May also be specified with the term.verbose
config value.
No output printed to stdout.
Control when colored output is used. Valid values:
auto (default): Automatically detect if color support is available on the
terminal.
always: Always display colors.
never: Never display colors.
May also be specified with the term.color
config value.
Prints help information.
Unstable (nightly-only) flags to Cargo. Run cargo -Z help for
details.
See the reference for details on environment variables that Cargo reads.
Cargo succeeded.
Cargo failed to complete.
Create a binary Cargo package in the given directory:
cargo new foo