cargo Verified current stable Not installed? Package Management

Cargo / Create Init New Rust Project

Create Init New Rust Project

Initialize a new Rust project in a specified directory.

Terminal

cargo init --<bin|lib> <path/to/directory>

cargo init --<bin|lib> <path/to/directory>

#!/bin/bash

# Create Init New Rust Project
cargo init --{{bin|lib}} {{path/to/directory}}

import subprocess

# Create Init New Rust Project
# Make sure to replace <placeholders> with actual values
def run_command():
    cmd = [
        "cargo",
        "init",
        "--<bin|lib>",
        "<path/to/directory>"
    ]
    
    try:
        print(f"Executing: {' '.join(cmd)}")
        subprocess.run(cmd, check=True)
    except subprocess.CalledProcessError as e:
        print(f"Error: {e}")
    except FileNotFoundError:
        print("Error: cargo not found. Please install it first.")

if __name__ == "__main__":
    run_command()

When To Use

When starting a new project requiring either a binary or library structure.

Pro Tip

Use `cargo init --name <project_name>` to name the project immediately during initialization.

Command Builder

Tune the command before you copy it

Back to syntax

Generated Command

cargo init --<bin|lib> <path/to/directory>

Terminal Output

Expected runtime feedback

Simulated preview

Output

Creating new Rust project at 'path/to/directory'  
   Project name: my_project  
   Type: Binary / Library  

Project initialized successfully.

Anatomy of Output

Understanding the result

Created binary (application) `my_project` Project Type

Indicates the creation of a binary project.

Created README.md File Created

The accompanying README file generated for the project.

Your project is ready! Completion Message

Confirms successful project initialization.

Power User Variants

Optimized versions

cargo init --bin --name my_project

Initialize a new binary project with a specified name.

cargo init --lib

Initialize a new library project.

Troubleshooting

Common pitfalls

error: no such directory

Solution: Verify the specified path exists or create it before running the command.

error: invalid input

Solution: Check the syntax of the command; ensure proper flags and options are provided.

error: permissions denied

Solution: Ensure write permissions are available in the specified installation directory.

Command Breakdown

What each part is doing

cargo: Base Command; The executable that performs this operation. Here it runs Cargo before the shell applies any redirect operators.
<bin|lib>: bin|lib; The value supplied for bin|lib.
<path/to/directory>: path to directory; The directory path supplied to this command.
--<bin|lib>: Command Option; Tool-specific option used by this command invocation.

How To Run

Execution path

Step 1
Run the command: cargo init --bin path/to/directory or cargo init --lib path/to/directory
Step 2
Navigate to the specified directory: cd path/to/directory
Step 3
Check if the project files are created: ls -la

Alternative Approaches

Comparable commands in other tools

Alternative package management tools for the same job.

Bun / Install From Local File Or Directory bun add file:<path/to/file_or_directory> Deno / Run File With Explicit Permissions deno run --allow-env {jsr:@deno/deployctl} Ncu / Upgrade All Dependencies Current Directory ncu --upgrade Bun / Display Global Module Cache Path bun pm cache