Tools.Utils

Fichier de fonctions génériques pour la gestion des fichiers, l’affichage de messages colorés dans la console et la manipulation d’images matricielles, comme l’ajout de grilles.

Ce module regroupe des utilitaires pour des tâches courantes et est structuré en plusieurs sections :

• Gestion de fichiers : manipulation des noms de fichiers et ajout d’extensions ou de suffixes.

• Affichage : impression de messages colorés pour les erreurs ou avertissements.

• Dessin : ajout de grilles sur des images représentées sous forme de matrices NumPy.

Structure :

1. File Management

   • add_extension() : Ajoute une extension à un fichier s’il n’en a pas.

   • add_suffix() : Ajoute un suffixe à un nom de fichier, tout en préservant l’extension.

   • get_timestamp_for_files() : Génère un horodatage au format adapté pour les noms de fichiers.

   • get_last_file() : Récupère le dernier fichier (le plus récent) d’un chemin et un pattern prédefini.

2. Prints

   • print_error() : Affiche un message d’erreur en rouge.

   • print_warning() : Affiche un avertissement en jaune.

   • print_success() : Affiche un message de validation en vert.

add_extension(filename: str, extension: str) → str

Ajoute l’extension au fichier si ce n’est pas déjà l’extension actuelle

Paramètres:

• filename – Nom du fichier

• extension – Extension finale du fichier

add_suffix(filename: str, suffix: str) → str

Ajoute un suffixe à un nom de fichier (gère la possibilité d’une extension ou non au nom de fichier).

Paramètres:

• filename – Nom de fichier d’origine.

• suffix – Suffixe à ajouter.

Renvoie:

Nom de fichier avec l’horodatage ajouté.

get_timestamp_for_files(with_hour: bool = True) → str

Créé un horodatage au format -AAAAMMJJ_HHMMSS pour un nom de fichier.

Paramètres:

with_hour – Ajoute ou non l’heure au timestamp

Renvoie:

Horodatage.

get_last_file(path: str, name: str) → str

Récupère le dernier fichier (le plus récent) qui contient le paramètre name dans son nom dans le chemin path.

Paramètres:

• path – Chemin du dossier où chercher les fichiers.

• name – Chaîne à rechercher dans les noms de fichiers.

Renvoie:

Chemin complet du dernier fichier trouvé ou une chaîne vide si aucun fichier ne correspond.

load_dll(name: str) → CDLL | None

Charge une DLL, si elle existe.

print_error(msg: str)

Affiche un message avec une couleur rouge

Paramètres:

msg – message à afficher

print_warning(msg: str)

Affiche un message avec une couleur jaune

Paramètres:

msg – message à afficher

print_success(msg: str)

Affiche un message avec une couleur verte

Paramètres:

msg – message à afficher

format_time(seconds)

Fonction pour formater le temps en secondes en HH:MM:SS.

Paramètres:

seconds – Temps en secondes

Renvoie:

chaine de caractère representant le temps au format HH:MM:SS.