Skip to content

Home

Jump to bottom
Grivy16 edited this page Oct 23, 2025 · 2 revisions

🧩 Custom_bar — Python Loading Bar Utility

Custom_bar est un module Python simple et personnalisable pour créer et afficher des barres de chargement animées dans la console.
Il permet d’afficher des barres classiques, graphiques ou infinies, avec gestion du pourcentage, du temps et du style visuel.

📦 Installation

pip install Custom_bar

⚙️ Importation et initialisation

import Custom_bar

app = Custom_bar.Loading()
app.info()  # Affiche la liste des méthodes disponibles

🧠 Classe principale : Loading

🔧 style_bar()

Personnalise le style et les options d’affichage de la barre :

Paramètre Type Description Défaut
border str Caractère utilisé pour la bordure de la barre `"
fill str Caractère de remplissage (partie remplie) "█"
empty str Caractère vide (partie non remplie) " "
show_percent bool Affiche le pourcentage True
final_time bool Active le chronomètre (affiche le temps final) False
show_percent_symbol bool Affiche le symbole % True
show_bar bool Affiche ou masque la barre True
show_detail bool Affiche ou masque les détails de progression (ex: 5/10) True
Title str Texte à afficher avant la barre ""
show_time bool Affiche le temps écoulé False
style str Type de barre : "bar" (classique) ou "graphic" (animation graphique) "bar"

Exemple :

app.style_bar(border="||", fill="#", Title="Téléchargement :", style="bar")

🏗️ create_loading_bar(total_task, size_bar=25)

Initialise une nouvelle barre de chargement.

Paramètre Type Description
total_task int Nombre total de tâches à effectuer
size_bar int Taille (nombre de caractères) de la barre

Exemple :

app.create_loading_bar(total_task=100, size_bar=30)

🔄 update_task(status)

Met à jour l’état de progression en fonction du nombre de tâches accomplies.

Paramètre Type Description
status int Nombre de tâches terminées

Exemple :

app.update_task(25)

🔁 update_bar(percent)

Met à jour la barre en fonction du pourcentage d’avancement.

Paramètre Type Description
percent int Pourcentage de progression à ajouter

Exemple :

app.update_bar(5)
print(app.get_bar())

🧱 get_bar()

Retourne la représentation actuelle de la barre sous forme de chaîne de caractères.

Exemple :

bar_text = app.get_bar()
print(bar_text)

⏱️ get_time()

Retourne le temps écoulé (si final_time est activé).

Exemple :

print("Temps écoulé :", app.get_time())

🧹 close()

Ferme et réinitialise la barre de chargement.

Exemple :

app.close()

🔄 infinite_load(size=25, interval=0.1)

Affiche une animation de chargement infinie (utile pour les tâches de durée indéterminée).

Paramètre Type Description Défaut
size int Taille de la barre 25
interval float Délai entre chaque mise à jour (en secondes) 0.1

Exemple :

app.infinite_load(size=20, interval=0.05)

⏳ simple_load(interval)

Affiche une barre de chargement simple avec un intervalle fixe.

Paramètre Type Description
interval float Délai entre chaque étape (en secondes)

Exemple :

app.simple_load(interval=0.05)

🎨 graphic_load()

Retourne une trame de l’animation graphique (style "graphic").

Exemple :

print(app.graphic_load())

🧪 test_load()

Lance une séquence de test de chargement.

Exemple :

app.test_load()

🧰 Méthode utilitaire : info()

Affiche toutes les méthodes et paramètres disponibles dans la console.

Exemple :

app.info()

🧾 Exemple complet

import Custom_bar
import time

app = Custom_bar.Loading()
app.style_bar(Title="Installation :", show_time=True)
app.create_loading_bar(total_task=10, size_bar=30)

for i in range(10):
    time.sleep(0.3)
    app.update_bar(1)
    print("\r" + app.get_bar(), end='', flush=True)

app.close()

🧑‍💻 Auteur

Grivy16
📦 Projet Python : Custom_bar
🕒 Version : 1.0.2

Clone this wiki locally