1.3.1. ParseurLogApache

Module pour parser un fichier log Apache.

exception parse.parseur_log_apache.FichierLogApacheIntrouvableException(*args)

Bases : ParsageLogApacheException

Exception représentant une erreur lorsque le fichier de log Apache est introuvable.

exception parse.parseur_log_apache.FormatLogApacheInvalideException(*args)

Bases : ParsageLogApacheException

Exception représentant une erreur dans le format du fichier de log Apache fourni.

exception parse.parseur_log_apache.ParsageLogApacheException(*args)

Bases : Exception

Exception représentant une erreur lors du parsage du fichier de log Apache.

class parse.parseur_log_apache.ParseurLogApache(chemin_log)

Bases : object

Représente un parseur pour faire une analyse synthaxique d’un fichier log Apache.

Class-level variables:

cvar PATTERN_ENTREE_LOG_APACHE (str):

Le pattern regex d’une entrée dans un log Apache.

PATTERN_ENTREE_LOG_APACHE: str = '(?P<ip>\\S+) (?P<rfc>\\S+) (?P<utilisateur>\\S+) (\\[(?P<horodatage>\\d{2}\\/\\w{3}\\/\\d{4}:\\d{1,2}:\\d{1,2}:\\d{1,2} \\+\\d{4})\\]|-) "((?P<methode>\\S+) (?P<url>\\S+) (?P<protocole>\\S+)|-)" (?P<code_status>\\d+) (?P<taille_octets>\\d+|-)( "(?P<ancienne_url>.*?)")?( "(?P<agent_utilisateur>.*?)")?'

get_information_entree(analyse_regex: dict, nom_information: str) → str | None

Retourne la valeur de l’information dans l’analyse si elle possède une valeur ou None si elle ne possède pas de valeur (égale à - ou vide).

Paramètres:

• analyse_regex (Match[str]) – Résultat du regex de l’analyse.

• nom_information (str) – Nom de l’information souhaitée.

Renvoie:

La valeur sous forme de chaîne de caractère ou None si

aucune valeur n’a été trouvée.

Type renvoyé:

Optional[str]

Lève:

TypeError – Un paramètre n’a pas le bon type.

parse_entree(entree: str) → EntreeLogApache

Effectue une analyse syntaxique d’une entrée dans un fichier de log Apache puis retourne une représentation de l’entrée avec les informations trouvées.

Paramètres:

entree (str) – Entrée à analyser.

Renvoie:

Représentation de l’entrée.

Type renvoyé:

entree_analysee (EntreeLogApache)

Lève:

• TypeError – L’entrée entree n’est pas de type EntreeLogApache

• FormatLogApacheInvalideException – Format de l’entrée du fichier log invalide.

parse_fichier() → FichierLogApache

Effectue une analyse syntaxique du fichier de log Apache puis retourne une représentation du fichier avec les informations trouvées.

Renvoie:

Représentation du fichier.

Type renvoyé:

log_analyse (FichierLogApache)

Lève:

FormatLogApacheInvalideException – Format du fichier log invalide.