public/subjects/hello_rust

hello_rust

Introduction

Hello and welcome to rust. The goal of this first exercise is to configure your repository properly and to give you a set of rules for the whole piscine rust. Make sure those rules are followed consistenly during the whole piscine.

Instructions

1- get-ready

Create in your Gitea account the repository named [[ROOT]].

This repository will be the folder where all the exercices must be uploaded.

Once created, clone that repository on your desktop.

If your username was choumi this is the command that will need to be used :

git clone git@git.[[DOMAIN]]:choumi/[[ROOT]].git

This command needs to be adapted with your own username.

If the git clone gives you an authenticity of host error, your SSH key must be configured. Follow the steps below.

SSH Configuration

Execute the following commands:

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N ''
cat ~/.ssh/id_ed25519.pub

• Copy the result and paste it in the content field of adding an ssh key in your settings (adapt the link with your username).

https://git.[[DOMAIN]]/choumi/settings/keys

• Confirm by clicking on the add key button.

Once this is done the git clone command should work now.

gitignore file

Once you repository is cloned, create and edit the .gitignore file in your repository and add this line:

**/target/*

The goal of this setup is to avoid any binary files to be pushed in your gitea accidentaly.

Do not forget to push it to your repository.

1. git add .gitignore
2. git commit -m "My very first gitignore commit"
3. git push

2- get-ready

Below are the commands that you must use during this piscine for initiating programs and functions. This command that you are going to depend in what is asked in the subject.

Commands for a program

cargo new --vcs=none name-of-exercise

Commands for a function

cargo new --vcs=none --lib name-of-exercise

3- try it yourself

Execute the below command for creating a program inside your repository

cargo new --vcs=none hello_rust

Then adapt the main.rs so that it would display Hello, Rust!

You can test it with the below command inside the folder of your exercise.

cargo run

This command will compile, and run the binary.

4- return your solution

After that the hello_rust project is executing correctly, it needs to be uploaded to the repository with the following commands :

1. git add hello_rust/
2. git commit -m "My very first rust commit"
3. git push

Once these steps are applied, the project can now be submitted for grading on the platform by clicking on the "RUN HELLO_RUST..." button.

This action will run the tests on your submitted hello_rust folder.