first commit

README.md

@@ -0,0 +1,57 @@
+# Parseur de Logs HPE 5130
+
+Ce projet permet d'extraire automatiquement des informations pertinentes depuis les logs de switchs **HPE 5130**, notamment les connexions entre les switchs d'accès et le cœur de réseau. Les résultats sont exportés sous deux formats :
+
+- Un **fichier Excel** listant les interfaces côté accès et cœur.
+- Un **diagramme Mermaid** simplifié représentant les connexions.
+
+---
+
+## 🧰 Fonctionnalités
+
+- Extraction des données utiles depuis les fichiers `.log` au format **JSON**.
+- Génération d’un **rapport Excel (`uplink_report.xlsx`)** contenant :
+  - Les informations des interfaces côté accès connectées au cœur.
+  - Les informations des interfaces du cœur.
+- Création d’un **fichier Mermaid (`mermaid.md`)** représentant graphiquement les connexions.
+  
+---
+
+## 🚀 Lancement
+
+Pour lancer l’outil, placez-vous dans le dossier du projet et exécutez la commande suivante :
+
+```bash
+python .\src\main.py [fichier logs du cœur]
+```
+#### 💡 Exemple : python .\src\main.py .\src\logs\core_switch.log
+
+---
+
+## 📁 Arborescence du projet
+```makefile
+C:.
+└───src
+    ├───logs            # Contient les fichiers .log des switchs (à déposer ici)
+    ├───output          # Contient les fichiers générés (Excel et Mermaid)
+    ├───scripts         # Contient les scripts de traitement
+    │   ├───extract_json.py      # Extraction des données en JSON
+    │   ├───format.py            # Formatage des données
+    │   ├───mermaid.py           # Formatage et génération du fichier Mermaid
+    │   └───parse_uplinks.py     # Création du fichier Excel
+    └───main.py         # Programme de lancement
+```
+
+---
+
+## 📌 Instructions d'utilisation
+1. Déposer les fichiers .log dans le dossier src/logs.
+2. Lancer le script main.py avec en argument le log du switch cœur.
+3. Les résultats seront disponibles dans le dossier src/output :
+    - uplink_report.xlsx
+    - mermaid.md
+
+---
+
+## ⚠️ Remarque
+- Bien penser à **mettre les fichiers de logs avec l'extension `.log`** dans le dossier `src/logs`.