Home

🧩 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