Difference between revisions of "Rust-Programming-Language/C2/Hello-World-using-Cargo/English"

From Script | Spoken-Tutorial
Jump to: navigation, search
 
Line 22: Line 22:
  
 
'''System Requirements'''
 
'''System Requirements'''
|| This tutorial is recorded using
+
|| This tutorial is recorded using,
 
* Ubuntu Linux OS version 22.04
 
* Ubuntu Linux OS version 22.04
 
* Rust version 1.80.0  
 
* Rust version 1.80.0  
Line 55: Line 55:
 
* To compile, use '''cargo build''' inside the created project.
 
* To compile, use '''cargo build''' inside the created project.
 
* To run, use '''cargo run''' inside the project
 
* To run, use '''cargo run''' inside the project
 
  
 
|-
 
|-
Line 61: Line 60:
 
|| Let us open the '''Visual Studio Code editor.'''
 
|| Let us open the '''Visual Studio Code editor.'''
 
|-
 
|-
|| click on '''terminal''' and select '''New Terminal.'''
+
|| Click on '''terminal''' and select '''New Terminal.'''
|| In the menu bar, click on '''terminal''' and select '''New Terminal.'''
+
|| In the menu bar, click on '''terminal''' and select '''New Terminal'''.
  
 
We can see a terminal window at the bottom.
 
We can see a terminal window at the bottom.
Line 72: Line 71:
 
>cd Desktop/MyRustProject
 
>cd Desktop/MyRustProject
  
|| Let us create a directory '''MyRustProject''' on the Desktop.
+
|| Let us create a directory '''MyRustProject''' on the '''Desktop'''.
  
 
In the terminal, type as shown to create a directory '''MyRustProject'''.
 
In the terminal, type as shown to create a directory '''MyRustProject'''.
Line 88: Line 87:
  
 
Select hello folder under MyRustPRoject
 
Select hello folder under MyRustPRoject
|| Open the created project by clicking on the '''File''' menu in the menu bar and then '''Open folder.'''
+
 
 +
|| Open the created project by clicking on the '''File''' menu in the menu bar and then '''Open Folder.'''
  
 
Go to '''Desktop''' and then select '''MyRustProject'''.
 
Go to '''Desktop''' and then select '''MyRustProject'''.
Line 97: Line 97:
 
|-
 
|-
 
|| '''Click src folder> main.rs'''
 
|| '''Click src folder> main.rs'''
|| In the left panel,under the '''EXPLORER''' section, expand the project '''HELLO''' by clicking on it.
+
|| In the left panel, under the '''EXPLORER''' section, expand the project '''HELLO''' by clicking on it.
  
 
Click the '''src''' folder, and you can see that a file called '''main.rs''' is created.
 
Click the '''src''' folder, and you can see that a file called '''main.rs''' is created.
Line 103: Line 103:
 
Click on it to open the file.
 
Click on it to open the file.
  
All the code has to be run using this particular file '''main.rs.'''
+
All the code has to be run using this particular file '''main.rs'''.
  
 
By default, we can see a hello world program on the right panel.
 
By default, we can see a hello world program on the right panel.
Line 124: Line 124:
 
The '''semicolon `;`''' at the end indicates the end of the command.
 
The '''semicolon `;`''' at the end indicates the end of the command.
  
Save the file by pressing '''Ctrl + S.'''
+
Save the file by pressing '''Ctrl + S'''.
  
 
Let us compile and run the program.
 
Let us compile and run the program.
 
|-
 
|-
 
|| Click on terminal> new terminal
 
|| Click on terminal> new terminal
|| In the menu bar, click on '''terminal''' and select '''New Terminal.'''
+
|| In the menu bar, click on '''terminal''' and select '''New Terminal'''.
  
 
Make sure that we are inside the cargo project that is, '''helloworld'''
 
Make sure that we are inside the cargo project that is, '''helloworld'''
 
|-
 
|-
 
|| '''> cargo build'''
 
|| '''> cargo build'''
|| In the terminal. type '''cargo build '''to compile the Cargo project.
+
|| In the terminal. type '''cargo build ''' to compile the '''Cargo''' project.
  
 
When successfully compiled, we see a finished message.
 
When successfully compiled, we see a finished message.
Line 141: Line 141:
 
|| As the project is compiled successfully, it’s time to run the project.
 
|| As the project is compiled successfully, it’s time to run the project.
  
Then type '''cargo run'''
+
Then type '''cargo run'''.
 
|-
 
|-
 
|| '''Point to the output'''
 
|| '''Point to the output'''
Line 154: Line 154:
 
In the code window, type a print statement “welcome to Rust spoken tutorial” as shown.
 
In the code window, type a print statement “welcome to Rust spoken tutorial” as shown.
  
Press Ctrl+ S to save the file.
+
Press Ctrl + S to save the file.
  
 
|-
 
|-
Line 163: Line 163:
 
|-
 
|-
 
||  
 
||  
|| After switching back, I directly did a cargo run without compiling the project again.
+
|| After switching back, I directly did a '''cargo run''' without '''compiling''' the project again.
  
 
Did you notice that?
 
Did you notice that?
Line 169: Line 169:
 
When we do a '''cargo run, ''' the '''package manager '''will '''build '''again and '''run '''the '''project'''.
 
When we do a '''cargo run, ''' the '''package manager '''will '''build '''again and '''run '''the '''project'''.
  
So going forward, we can directly use '''cargo run '''to '''build '''and '''run '''the '''project '''in one go.
+
So going forward, we can directly use '''cargo run ''' to '''build '''and '''run '''the '''project '''in one go.
 
|-
 
|-
 
|| '''Click on cargo.toml'''
 
|| '''Click on cargo.toml'''
 
|| In the left panel, open the file '''Cargo.toml.'''
 
|| In the left panel, open the file '''Cargo.toml.'''
  
We can see two sections namely '''package''' and '''dependencies.'''
+
We can see two sections namely '''package''' and '''dependencies'''.
  
 
This is where we can write all the project related information like name, version, authors, edition.
 
This is where we can write all the project related information like name, version, authors, edition.
Line 189: Line 189:
 
In this tutorial, we have learnt to
 
In this tutorial, we have learnt to
 
* Create a cargo project
 
* Create a cargo project
* Write a Hello world rust program
+
* Write a Hello world '''rust''' program
 
* Compile and Run the program
 
* Compile and Run the program
  
Line 232: Line 232:
  
 
'''Acknowledgement'''
 
'''Acknowledgement'''
|| We would like to thank '''Vishal Pokuri from VIT Vellore '''for content contribution.
+
|| We would like to thank '''Vishal Pokuri from VIT Vellore '''for the content contribution.
 
|-  
 
|-  
  

Latest revision as of 19:59, 28 March 2025

Visual Cue Narration
Show Slide:

Title Slide

Welcome to the Spoken tutorial on Hello World using Cargo.
Show Slide:

Learning Objectives

In this tutorial, we will learn how to
  • Create a cargo project
  • Write a Hello world rust program
  • Compile and Run the cargo project
Show Slide:

System Requirements

This tutorial is recorded using,
  • Ubuntu Linux OS version 22.04
  • Rust version 1.80.0
  • Visual studio code version 1.19.0
Show Slide:

Prerequisites

To follow this tutorial,
  • You must have basic knowledge of any programming language
  • You should also have Rust installed on your system.
  • If not, go through the relevant tutorials on this website.
Show Slide:

About Cargo

  • Cargo is a Rust build system and package manager
  • Cargo handles the compilation process and automates the building of your project.
  • Cargo allows you to add and manage external libraries to your project
  • In the Cargo.toml file, you can list your dependencies.
  • Complex Rust programs need these dependencies to develop Rust projects
Show Slide:

Cargo commands

Let’s begin understanding the commands first.
  • To create a Cargo project use cargo new project name
  • To compile, use cargo build inside the created project.
  • To run, use cargo run inside the project
Open Visual code editor. Let us open the Visual Studio Code editor.
Click on terminal and select New Terminal. In the menu bar, click on terminal and select New Terminal.

We can see a terminal window at the bottom.

Create direcotry MyRustProject

>mkdir Desktop/MyRustProject

>cd Desktop/MyRustProject

Let us create a directory MyRustProject on the Desktop.

In the terminal, type as shown to create a directory MyRustProject.

We will save all the Rust Projects in this directory required for this series.

Type

>cargo new helloworld

Type the command cargo new helloworld.

A binary cargo application has been created.

Click File>> Open folder

Select hello folder under MyRustPRoject

Open the created project by clicking on the File menu in the menu bar and then Open Folder.

Go to Desktop and then select MyRustProject.

Locate the helloworld folder.

Then click on the Open button at the top right corner.

Click src folder> main.rs In the left panel, under the EXPLORER section, expand the project HELLO by clicking on it.

Click the src folder, and you can see that a file called main.rs is created.

Click on it to open the file.

All the code has to be run using this particular file main.rs.

By default, we can see a hello world program on the right panel.

Let us see the Rust program structure.
Highlight according to narration.

fn main() {

println!("Hello, World!");

}

Every Rust program starts with this `main` function.

Inside the curly braces `{ ... }` Println command prints the text hello world.

The semicolon `;` at the end indicates the end of the command.

Save the file by pressing Ctrl + S.

Let us compile and run the program.

Click on terminal> new terminal In the menu bar, click on terminal and select New Terminal.

Make sure that we are inside the cargo project that is, helloworld

> cargo build In the terminal. type cargo build to compile the Cargo project.

When successfully compiled, we see a finished message.

>cargo run As the project is compiled successfully, it’s time to run the project.

Then type cargo run.

Point to the output Now we see Hello world! printed in the terminal.
Type

Pritnln(“Welcome to Rust Spoken Tutorial”); Press Ctrl+S

Let us add one more print statement in the program.

In the code window, type a print statement “welcome to Rust spoken tutorial” as shown.

Press Ctrl + S to save the file.

> cargo run In the terminal, type cargo run

We can see both the text messages as output.

After switching back, I directly did a cargo run without compiling the project again.

Did you notice that?

When we do a cargo run, the package manager will build again and run the project.

So going forward, we can directly use cargo run to build and run the project in one go.

Click on cargo.toml In the left panel, open the file Cargo.toml.

We can see two sections namely package and dependencies.

This is where we can write all the project related information like name, version, authors, edition.

We can even mention dependencies which the project depends upon.

Show Slide:

Summary

This brings us to the end of this tutorial.

Let us summarize.

In this tutorial, we have learnt to

  • Create a cargo project
  • Write a Hello world rust program
  • Compile and Run the program
Show Slide:

Assignment

As an assignment,
  • Create a cargo project named assignment
  • Print - “ Welcome to Rust Assignment”
  • Compile and execute the project
  • Observe the output in the Terminal
Show Slide:

About Spoken Tutorial Project

The video at the following link summarizes the Spoken Tutorial Project.

Please download and watch it.

Show Slide:

Spoken Tutorial Workshops

The Spoken Tutorial Project team conducts workshops and gives certificates.

For more details, please write to us.

Show Slide:

Forum for specific questions

Please post your timed queries in this forum.
Show Slide:

Acknowledgement

The Spoken Tutorial Project was established by the Ministry of Education, Government of India.
Show Slide:

Acknowledgement

We would like to thank Vishal Pokuri from VIT Vellore for the content contribution.
Show Slide:

Thank you

This tutorial is contributed by Nirmala Venkat and Ketki Bhamble from the spoken tutorial team.

Thank you for joining.

Contributors and Content Editors

Madhurig, Nirmala Venkat