## hellorust

### 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](https://git.[[DOMAIN]]) 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:

```console
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](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,
edit the .gitignore file and add this line:
```console
**/target/*
```
The goal of this setup is to avoid any binary files to be pushed in your gitea accidentaly. 


#### 2- get-ready

Below are the commands that you must use during this piscine for initiating programs and functions.

#### Commands for a program

```console
Cargo --vcs=none new name-of-exercise
```

#### Commands for a function

```console
Cargo --vcs=none new --lib name-of-exercise
```

#### 3- try it yourself

Execute the below command inside your repository

```console
Cargo --vcs=none new 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.

```console
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.