mirror of https://github.com/01-edu/public.git
1 changed files with 99 additions and 0 deletions
@ -0,0 +1,99 @@ |
|||||||
|
## 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. |
Loading…
Reference in new issue