|
1 | 1 | # LogBuster |
2 | 2 |
|
| 3 | +``` |
| 4 | + .-. .-') .-') .-') _ ('-. _ .-') ,---. |
| 5 | + \ ( OO ) ( OO ). ( OO) ) _( OO)( \( -O ) | | |
| 6 | + ,--. .-'),-----. ,----. ;-----.\ ,--. ,--. (_)---\_)/ '._(,------.,------. | | |
| 7 | + | |.-') ( OO' .-. ' ' .-./-') | .-. | | | | | / _ | |'--...__)| .---'| /`. '| | |
| 8 | + | | OO )/ | | | | | |_( O- )| '-' /_) | | | .-') \ :` `. '--. .--'| | | / | || | |
| 9 | + | |`-' |\_) | |\| | | | .--, \| .-. `. | |_|( OO ) '..`''.) | | (| '--. | |_.' || .' |
| 10 | +(| '---.' \ | | | |(| | '. (_/| | \ | | | | `-' /.-._) \ | | | .--' | . '.'`--' |
| 11 | + | | `' '-' ' | '--' | | '--' /(' '-'(_.-' \ / | | | `---.| |\ \ .--. |
| 12 | + `------' `-----' `------' `------' `-----' `-----' `--' `------'`--' '--''--' |
| 13 | +``` |
| 14 | + |
3 | 15 | Bienvenue dans le monde de LogBuster, l'outil ultime pour analyser, décortiquer et sauver vos logs Apache des griffes du chaos. Vous avez des logs qui traînent, qui sont indéchiffrables ou tout simplement encombrants ? Pas de panique, LogBuster est là pour les attraper, les analyser et vous offrir des statistiques claires et précises, comme jamais auparavant ! |
4 | 16 |
|
5 | | -Inspiré par l’univers de Ghostbusters, LogBuster chasse les erreurs et anomalies des logs Apache avec la même efficacité que les chasseurs de fantômes. Que ce soit pour des fichiers volumineux ou des logs complexes, LogBuster est votre équipe d’intervention spécialisée. Plus de confusion, plus de stress – vos logs sont en sécurité ! |
| 17 | +## 📋 Table des matières |
| 18 | + |
| 19 | +- [👻 Fonctionnalités](#-fonctionnalités) |
| 20 | +- [📦 Installation](#-installation) |
| 21 | +- [🛠️ Utilisation de base](#️-utilisation-de-base) |
| 22 | +- [📖 Documentation](#-documentation) |
| 23 | +- [🧪 Lancer les tests](#-lancer-les-tests) |
| 24 | +- [📜 Licence](#-licence) |
| 25 | + |
| 26 | +## 👻 Fonctionnalités |
| 27 | + |
| 28 | +- 📄 Parsing avancé de logs Apache. |
| 29 | +- 📉 Extraire des statistiques clés. |
| 30 | +- 🗂️ Ranger les données par catégorie. |
| 31 | +- 🧹 Indiquer les erreurs de format avec précision. |
| 32 | +- 🚚 Exporter les données en JSON. |
| 33 | + |
| 34 | +## 📦 Installation |
| 35 | + |
| 36 | +### Bash (linux/macOS) |
| 37 | +```bash |
| 38 | +git clone https://github.com/AnthonyGuillauma/code_source |
| 39 | +cd code_source |
| 40 | +python -m venv .venv |
| 41 | +source .venv/bin/activate # Activation de l'environnement virtuel sous Bash |
| 42 | +pip install -r requirements.txt |
| 43 | +``` |
| 44 | + |
| 45 | +### Windows (cmd) |
| 46 | +```bash |
| 47 | +git clone https://github.com/AnthonyGuillauma/code_source |
| 48 | +cd code_source |
| 49 | +python -m venv .venv |
| 50 | +.venv\Scripts\activate # Activation de l'environnement virtuel sous Windows |
| 51 | +pip install -r requirements.txt |
| 52 | +``` |
| 53 | + |
| 54 | +## 🛠️ Utilisation de base |
| 55 | + |
| 56 | +``` |
| 57 | +python app/main.py chemin_log [-s SORTIE] |
| 58 | +``` |
| 59 | +- `chemin_log` : Le chemin vers le fichier de log Apache à analyser. |
| 60 | +- `-s SORTIE` (optionnel) : Le chemin où sauvegarder les résultats de l'analyse. Si non spécifié, les résultats seront sauvegardés dans un fichier `analyse-log-apache.json`. |
| 61 | + |
| 62 | +## 📖 Documentation |
| 63 | + |
| 64 | +La documentation complète du code du projet se situe [ici](https://anthonyguillauma.github.io/code_source/ |
| 65 | +). |
| 66 | + |
| 67 | +Si vous souhaitez la générer vous même, suivez ces étapes : |
| 68 | + |
| 69 | +Tout d'abord, placez-vous dans le dossier `docs` qui contient les fichiers sources de la documentation : |
| 70 | + |
| 71 | +```bash |
| 72 | +cd docs |
| 73 | +``` |
| 74 | + |
| 75 | +Puis, générez la documentation via la commande suivante : |
| 76 | + |
| 77 | +```bash |
| 78 | +./make html |
| 79 | +``` |
| 80 | + |
| 81 | +Enfin, ouvrez le fichier html `build/html/index.html` généré dans un navigateur. |
| 82 | + |
| 83 | +## 🧪 Lancer les tests |
| 84 | + |
| 85 | +Les tests unitaires du projet peuvent être exécutés avec pytest. Pour lancer les tests, assurez-vous d'avoir activé l'environnement virtuel et installé les dépendances. |
| 86 | + |
| 87 | +Premièrement, placez-vous dans le dossier `tests` qui contient les fichiers de configuration pour les tests unitaires : |
| 88 | + |
| 89 | +```bash |
| 90 | +cd tests |
| 91 | +``` |
| 92 | + |
| 93 | +Ensuite, exécutez les tests avec la commande suivante : |
| 94 | + |
| 95 | +```bash |
| 96 | +pytest |
| 97 | +``` |
| 98 | + |
| 99 | +Enfin, si vous souhaitez également afficher la couverture des tests unitaires, utilisez la commande suivante : |
| 100 | + |
| 101 | +```bash |
| 102 | +pytest --cov=../app --cov-report=term-missing |
| 103 | +``` |
| 104 | + |
| 105 | +# 📜 Licence |
| 106 | + |
| 107 | +Ce projet est sous licence MIT. |
0 commit comments