Skip to content

Commit 2005900

Browse files
Chore: Amélioration du README.md (#35)
- Ajout de la description du projet - Ajout d'une table des matières - Ajout de la partie des fonctionnalités - Ajout de la partie de l'utilisation de base - Ajout de la partie de la documentation - Ajout de la partie des tests unitaires - Ajout de la licence
1 parent 154089c commit 2005900

1 file changed

Lines changed: 103 additions & 1 deletion

File tree

README.md

Lines changed: 103 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,107 @@
11
# LogBuster
22

3+
```
4+
.-. .-') .-') .-') _ ('-. _ .-') ,---.
5+
\ ( OO ) ( OO ). ( OO) ) _( OO)( \( -O ) | |
6+
,--. .-'),-----. ,----. ;-----.\ ,--. ,--. (_)---\_)/ '._(,------.,------. | |
7+
| |.-') ( OO' .-. ' ' .-./-') | .-. | | | | | / _ | |'--...__)| .---'| /`. '| |
8+
| | OO )/ | | | | | |_( O- )| '-' /_) | | | .-') \ :` `. '--. .--'| | | / | || |
9+
| |`-' |\_) | |\| | | | .--, \| .-. `. | |_|( OO ) '..`''.) | | (| '--. | |_.' || .'
10+
(| '---.' \ | | | |(| | '. (_/| | \ | | | | `-' /.-._) \ | | | .--' | . '.'`--'
11+
| | `' '-' ' | '--' | | '--' /(' '-'(_.-' \ / | | | `---.| |\ \ .--.
12+
`------' `-----' `------' `------' `-----' `-----' `--' `------'`--' '--''--'
13+
```
14+
315
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 !
416

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

Comments
 (0)