From 062b9c29d13e732d89a97711139b83766c2d1da2 Mon Sep 17 00:00:00 2001
From: jfgiraud <jfgiraud@giraud-finance.com>
Date: Sun, 30 Aug 2026 09:52:34 +0200
Subject: [PATCH] programme final

---
 .gitignore  |   1 +
 Cargo.lock  |   7 ++
 Cargo.toml  |   6 ++
 README.md   | 180 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 src/main.rs |   4 ++
 5 files changed, 198 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 Cargo.lock
 create mode 100644 Cargo.toml
 create mode 100644 README.md
 create mode 100644 src/main.rs

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..ea8c4bf
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+/target
diff --git a/Cargo.lock b/Cargo.lock
new file mode 100644
index 0000000..2db6835
--- /dev/null
+++ b/Cargo.lock
@@ -0,0 +1,7 @@
+# This file is automatically @generated by Cargo.
+# It is not intended for manual editing.
+version = 4
+
+[[package]]
+name = "hello_rust"
+version = "0.1.0"
diff --git a/Cargo.toml b/Cargo.toml
new file mode 100644
index 0000000..6890966
--- /dev/null
+++ b/Cargo.toml
@@ -0,0 +1,6 @@
+[package]
+name = "hello_rust"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..361550a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,180 @@
+# Hello World en Rust 🦀
+
+Un programme Rust minimal qui affiche **Hello, World!** dans le terminal.
+
+## 📋 Prérequis
+
+Il faut installer **Rust** et son gestionnaire de paquets **Cargo**.
+
+Sur Kubuntu, l'installation recommandée se fait avec `rustup` :
+
+```bash
+curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
+```
+
+Puis rechargez votre environnement :
+
+```bash
+source "$HOME/.cargo/env"
+```
+
+Vérifiez l'installation :
+
+```bash
+rustc --version
+cargo --version
+```
+
+## 🚀 Création du projet
+
+Créer un nouveau projet :
+
+```bash
+cargo new hello-world
+```
+
+Entrer dans le répertoire :
+
+```bash
+cd hello-world
+```
+
+Le projet contient automatiquement :
+
+```text
+hello-world/
+├── Cargo.toml
+└── src/
+    └── main.rs
+```
+
+## 💻 Le programme
+
+Le fichier `src/main.rs` contient :
+
+```rust
+fn main() {
+    println!("Hello, World!");
+}
+```
+
+### Explication
+
+- `fn main()` définit la fonction principale du programme.
+- `println!()` affiche du texte dans le terminal.
+- `;` termine l'instruction.
+
+## ▶️ Exécuter le programme
+
+Depuis le répertoire du projet :
+
+```bash
+cargo run
+```
+
+Résultat :
+
+```text
+Hello, World!
+```
+
+## 🔨 Compiler le programme
+
+Pour compiler :
+
+```bash
+cargo build
+```
+
+L'exécutable sera placé dans :
+
+```text
+target/debug/hello-world
+```
+
+Vous pouvez également l'exécuter directement :
+
+```bash
+./target/debug/hello-world
+```
+
+## ⚡ Compilation optimisée
+
+Pour créer une version optimisée :
+
+```bash
+cargo build --release
+```
+
+L'exécutable sera alors disponible ici :
+
+```text
+target/release/hello-world
+```
+
+Exécution :
+
+```bash
+./target/release/hello-world
+```
+
+## 🧪 Vérifier le code
+
+Rust fournit également `cargo check`, qui vérifie le code sans produire l'exécutable :
+
+```bash
+cargo check
+```
+
+C'est particulièrement pratique pendant le développement.
+
+## 📦 Structure de Cargo.toml
+
+Le fichier `Cargo.toml` décrit le projet :
+
+```toml
+[package]
+name = "hello-world"
+version = "0.1.0"
+edition = "2024"
+
+[dependencies]
+```
+
+Pour ce programme, aucune dépendance externe n'est nécessaire.
+
+## 🦀 Commandes Cargo essentielles
+
+| Commande                | Fonction                              |
+| ----------------------- | ------------------------------------- |
+| `cargo new projet`      | Créer un projet                       |
+| `cargo run`             | Compiler et exécuter                  |
+| `cargo build`           | Compiler                              |
+| `cargo build --release` | Compiler en mode optimisé             |
+| `cargo check`           | Vérifier le code                      |
+| `cargo clean`           | Supprimer les fichiers de compilation |
+| `cargo fmt`             | Formater le code                      |
+| `cargo test`            | Exécuter les tests                    |
+
+## 🎯 Objectif
+
+Ce projet constitue le point de départ pour apprendre Rust.
+
+Les prochaines étapes peuvent être :
+
+1. Variables et constantes
+2. Types et fonctions
+3. Conditions `if`
+4. Boucles `for`, `while`, `loop`
+5. Tableaux et `Vec`
+6. Structs
+7. Enums
+8. Gestion des erreurs
+9. Ownership et borrowing
+10. Modules et crates
+11. Programmation concurrente
+12. Appels GPU avec Rust
+
+---
+
+**Rust 🦀 — rapide, sûr et moderne.**
diff --git a/src/main.rs b/src/main.rs
new file mode 100644
index 0000000..644dff7
--- /dev/null
+++ b/src/main.rs
@@ -0,0 +1,4 @@
+fn main() {
+    println!("Hello, world!");
+    println!("Bonjour depuis Rust !");
+}