CARGO-NEW(1)                General Commands Manual               CARGO-NEW(1)

<?><?><?> (NAME)
       cargo-new - <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> Cargo

<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       cargo new [<?><?><?><?><?><?><?><?>] <?><?><?><?>

<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> Cargo <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?>. <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> Cargo.toml<?> <?><?><?><?>
       <?><?><?><?> <?><?><?><?><?><?> <?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?> (ignore) <?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?> (VCS) <?><?><?>. <?><?><?>
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?> <?><?> <?><?><?><?>
       VCS <?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> (<?><?> --vcs <?><?> <?><?><?> <?><?><?><?><?><?>
       <?><?><?><?>).

       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?>
       <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> cargo-init(1) <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?><?><?><?> (OPTIONS)
   <?><?><?><?><?><?><?><?><?> new (New Options)
       --bin
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?> (binary target) (src/main.rs).  <?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?>.

       --lib
           <?><?><?><?><?> <?><?> <?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?> (library target) (src/lib.rs).

       --edition edition
           <?><?><?><?><?> <?><?><?><?><?><?> (edition) <?><?><?><?> Rust
           <?><?><?><?> <?><?><?><?><?><?><?>. <?><?><?><?><?><?><?> 2024
           <?><?><?>.  <?><?><?><?><?><?> <?><?><?><?>: 2015<?> 2018<?>
           2021<?> 2024

       --name name
           <?><?><?><?><?> <?><?><?> <?><?><?><?>. <?><?><?><?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?>.

       --vcs vcs
           <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           VCS <?><?><?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> (git<?> hg<?> pijul <?><?>
           fossil) <?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           (none). <?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> git <?><?> <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> cargo-new.vcs <?><?><?><?><?> <?><?><?><?>
           <?><?> <?><?><?> <?><?> <?><?><?> <?><?><?><?> <?><?> <?><?><?><?>
           VCS <?><?><?><?><?> <?><?> none <?><?><?><?><?> <?><?><?><?><?><?>.

       --registry registry
           <?><?><?><?> publish <?><?> <?><?> Cargo.toml <?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?>.

           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> Cargo
           <https://doc.rust-lang.org/cargo/reference/config.html>
           <?><?><?><?><?> <?><?><?><?><?><?><?>.  <?><?> <?><?><?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> registry.default <?><?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?> <?><?><?><?> <?> <?><?> --registry <?><?><?>
           <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?> publish
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?>
           <?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?><?><?>
           <?><?><?><?><?><?> <?><?>.

   <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (Display Options)
       -v, --verbose
           <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
           (verbose). <?><?><?><?> <?><?><?> <?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?> <<<?><?><?><?><?> <?><?><?><?>>> <?><?> <?><?><?>
           <?><?><?><?> <?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?>
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> term.verbose
           <https://doc.rust-lang.org/cargo/reference/config.html>
           <?><?><?><?><?> <?><?><?>.

       -q, --quiet
           <?><?><?><?><?><?><?><?> <?><?><?> cargo <?><?> <?><?><?>
           <?><?><?><?><?><?><?>.  <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?> <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>
           term.quiet <https://doc.rust-lang.org/cargo/reference/config.html>
           <?><?><?><?><?> <?><?><?>.

       --color when
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?> <?><?><?><?>. <?><?><?><?><?><?> <?><?><?><?><?>:

           o   auto (<?><?><?><?><?><?><?>): <?><?><?><?><?>
               <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?><?><?>
               <?><?> <?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
               <?><?> <?><?><?>.

           o   always: <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?>
               <?><?><?><?><?> <?><?><?>.

           o   never: <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?>
               <?><?><?>.

           <?><?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?><?><?> term.color
           <https://doc.rust-lang.org/cargo/reference/config.html>
           <?><?><?><?><?> <?><?><?>.

   <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> (Common Options)
       +toolchain
           <?><?><?> Cargo <?><?><?><?><?><?><?><?><?> rustup <?><?><?>
           <?><?><?> <?><?><?><?> <?> <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           cargo <?><?> + <?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> (toolchain) rustup
           <?><?><?><?><?> <?><?><?><?><?> <?><?> (<?><?><?><?><?> +stable
           <?><?> +nightly).  <?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?> <?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?> <?><?><?><?><?><?><?> rustup
           <https://rust-lang.github.io/rustup/overrides.html> <?><?>
           <?><?><?><?><?><?>.

       --config KEY=VALUE <?><?> PATH
           <?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> Cargo <?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?>. <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?> TOML <?><?>
           <?><?><?><?> KEY=VALUE <?><?><?><?><?> <?><?> <?><?> <?><?><?><?>
           <?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
           <?><?><?><?><?> <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?> <?><?><?><?>
           <?><?><?>.  <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?>
           <?><?><?> <?><?><?><?><?><?><?><?><?><?><?><?> <?><?>
           <?><?><?><?><?>
           <https://doc.rust-lang.org/cargo/reference/config.html#command-line-overrides>
           <?><?> <?><?><?><?><?><?>.

       -C PATH
           <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?>
           <?><?><?> <?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?> <?><?><?>
           <?><?><?><?> <?><?> cargo <?><?><?><?><?><?> <?><?><?><?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?> (Cargo.toml)
           <?><?><?><?><?> <?><?><?><?><?><?><?> <?> <?><?><?><?><?><?>
           <?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
           <?><?><?><?><?> .cargo/config.toml <?><?><?><?><?>
           <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?>.
           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?> <?><?><?><?> <?><?><?><?> <?><?><?><?>
           <?><?><?><?><?>: cargo -C path/to/my-project build.

           <?><?><?> <?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?><?>
           nightly
           <https://doc.rust-lang.org/book/appendix-07-nightly-rust.html>
           <?><?> <?><?><?><?><?> <?><?><?> <?> <?><?><?><?>
           <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?> -Z
           unstable-options <?><?><?><?><?><?><?> (<?><?><?><?><?><?>: #10098
           <https://github.com/rust-lang/cargo/issues/10098>).

       -h, --help
           <?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?>
           <?><?><?><?><?><?>.

       -Z flag
           <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> (<?><?><?><?>
           <?><?><?><?> <?><?><?><?><?><?><?><?> nightly) <?><?><?><?> Cargo.
           <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> cargo -Z help
           <?><?> <?><?><?><?> <?><?><?><?>.

<?><?><?><?> (ENVIRONMENT)
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> Cargo
       <?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?><?><?>
       <https://doc.rust-lang.org/cargo/reference/environment-variables.html>
       <?><?> <?><?><?><?><?><?>.

<?><?><?><?><?> <?><?><?><?> (EXIT STATUS)
       o   0: <?><?><?><?><?> Cargo <?><?><?><?><?><?><?><?><?><?><?>
           <?><?><?>.

       o   101: <?><?><?><?><?> Cargo <?><?> <?><?><?><?> <?><?><?><?><?>
           <?><?>.

<?><?><?><?><?><?><?> (EXAMPLES)
        1. <?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?> (binary)
           Cargo <?><?> <?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>:

               cargo new foo

<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       cargo(1), cargo-init(1)

                                                                  CARGO-NEW(1)