EzQt-Widgets 2.1.0

Une collection de widgets Qt personnalisés et réutilisables pour PySide6. Fournit des composants graphiques avancés, réutilisables et stylés pour faciliter le développement d'interfaces modernes et ergonomiques.

🎨 EzQt_Widgets

Une collection de widgets Qt personnalisés et réutilisables pour PySide6.

📦 Installation

pip install ezqt_widgets

🚀 Utilisation Rapide

from PySide6.QtWidgets import QApplication
from ezqt_widgets.button import IconButton, DateButton, LoaderButton
from ezqt_widgets.label import ClickableTagLabel, FramedLabel, HoverLabel, IndicatorLabel
from ezqt_widgets.input import AutoCompleteInput, SearchInput, PasswordInput
from ezqt_widgets.misc import CircularTimer, OptionSelector, ToggleIcon, ToggleSwitch

app = QApplication([])

# Widgets bouton
icon_btn = IconButton(icon="path/to/icon.png", text="Mon Bouton")
date_btn = DateButton(date="2024-01-01")
loader_btn = LoaderButton(text="Charger...")

# Widgets label
tag_label = ClickableTagLabel(name="Tag Cliquable")
framed_label = FramedLabel(text="Label Encadré")
hover_label = HoverLabel(text="Label avec Hover")
indicator_label = IndicatorLabel(status="online")

# Widgets input
search_input = SearchInput(placeholder="Rechercher...")
password_input = PasswordInput(placeholder="Mot de passe")

# Widgets misc
timer = CircularTimer(duration=60)
toggle_switch = ToggleSwitch(checked=True)

app.exec()

📚 Documentation

• Documentation complète : docs/
• Guide de style : docs/STYLE_GUIDE.md
• Changelog : docs/CHANGELOG.md

🧪 Tests

Exécution des Tests

# Tous les tests
python tests/run_tests.py --type unit

# Tests spécifiques
python -m pytest tests/unit/test_button/ -v
python -m pytest tests/unit/test_label/ -v

Documentation des Tests

• Guide rapide : docs/QUICK_START_TESTS.md
• Documentation complète : docs/tests/

📊 Statistiques des Tests

• Widgets Bouton : 59 tests (56 passent, 3 skipped)
• Widgets Label : 70 tests (67 passent, 3 skipped)
• Widgets Input : 112 tests (111 passent, 1 skipped)
• Widgets Misc : 41 tests ✅
• Tests de Base : 3 tests ✅
• Total : 262 tests (254 passent, 8 skipped)

🎯 Widgets Disponibles

Boutons

• IconButton - Bouton avec icône personnalisable
• DateButton - Sélecteur de date avec calendrier
• LoaderButton - Bouton avec états de chargement

Labels

• ClickableTagLabel - Tag cliquable avec toggle
• FramedLabel - Label avec cadre personnalisable
• HoverLabel - Label avec effets au survol
• IndicatorLabel - Indicateur de statut avec LED

Inputs

• AutoCompleteInput - Champ de saisie avec autocomplétion
• SearchInput - Champ de recherche avec historique
• TabReplaceTextEdit - Éditeur de texte avec remplacement de tabulations
• PasswordInput - Champ de mot de passe avec barre de force

Misc

• CircularTimer - Timer circulaire avec animation
• OptionSelector - Sélecteur d'options avec interface moderne
• ToggleIcon - Icône basculante avec états multiples
• ToggleSwitch - Interrupteur moderne avec animation

🔧 Développement

Structure du Projet

ezqt_widgets/
├── README.md              # Ce fichier
├── docs/                  # Documentation
│   ├── README.md         # Index de documentation
│   ├── STYLE_GUIDE.md    # Guide de style
│   ├── CHANGELOG.md      # Historique des versions
│   ├── QUICK_START_TESTS.md # Guide rapide des tests
│   └── tests/            # Documentation des tests
├── tests/                # Tests
│   ├── run_tests.py      # Script d'exécution des tests
│   ├── conftest.py       # Configuration pytest
│   └── unit/             # Tests unitaires
├── ezqt_widgets/         # Code source
└── pyproject.toml        # Configuration du projet

Installation pour Développement

git clone <repository>
cd ezqt_widgets
pip install -e .
pip install -e ".[dev]"

📄 Licence

Ce projet est sous licence MIT. Voir LICENSE pour plus de détails.

---

État des tests : 🟢 OPÉRATIONNEL (254/262 tests passent, 8 skipped)