Skip to content

README.md

Latest commit

 

History

History
325 lines (252 loc) · 11 KB

README.md

File metadata and controls

325 lines (252 loc) · 11 KB
Raw

ProgPythonExpl

Professional-grade CRUD demonstration program in Python – Tkinter GUI – SQLite database – MVC Architecture.

Programme de démonstration CRUD Python de niveau professionnel – Interface graphique Tkinter – Base SQLite – Architecture MVC.

🇬🇧 English

Description

ProgPythonExpl is a CRUD (Create – Read – Update – Delete) application designed as a reference example and starting point for future Python projects.

It manages the main operations on a Clients table in a SQLite database: search, create, update, delete and select records.

Prerequisites

  • Python 3.13 or higher
  • No external dependencies — standard Python modules only
  • Tkinter (included in standard Python)
  • SQLite 3 (included in standard Python)
  • Compatible with Linux, macOS and Windows

Installation

# Extract the ZIP, that's all — no additional installation required.
cd ProgPythonExpl

Launch

python main.py

Seeding the demo database (optional)

# Creates demo.sqlite with 10 fictional clients
python seed_data.py

# Or specify an existing file
python seed_data.py /path/to/my_database.sqlite

Project Structure (MVC Architecture)

ProgPythonExpl/
│
├── main.py                          # Entry point – launcher
├── seed_data.py                     # Data seeding script
├── requirements.txt                 # Python dependencies
│
├── core/                            # Configuration and database access
│   ├── __init__.py
│   ├── config.py                    # Global constants (colors, fonts, modes...)
│   └── database.py                  # GestionnaireBase: SQLite connection
│
├── models/                          # Model layer
│   ├── __init__.py
│   └── client_model.py              # Client dataclass + ClientDAO (CRUDS)
│
├── controllers/                     # Controller layer
│   ├── __init__.py
│   ├── bienvenue_controller.py      # Main window logic
│   ├── cruds_controller.py          # Client list/management logic
│   └── fiche_controller.py          # Client form logic + validation
│
├── views/                           # View layer (Tkinter windows)
│   ├── __init__.py
│   ├── Win_Bienvenue_Main.py        # Main window (File + Actions menus)
│   ├── Win_Client_CRUDS.py          # Client table + icon buttons
│   └── Win_Client_Fiche.py          # Client record form
│
├── classes/                         # Shared / utility classes
│   ├── __init__.py
│   └── base_window.py               # FenetreBase: modal Toplevel + ttk theme
│
├── fonctionsgen/                    # General utility functions
│   ├── __init__.py
│   └── fonctionsgen.py              # Formatting, validation, data manipulation
│
└── images/                          # Button icons (60×60 px PNG)
    ├── Base_create.png              # Add button
    ├── Base_update.png              # Edit button
    ├── Base_delete.png              # Delete button
    ├── Base_read.png                # View button
    ├── Base_search.png              # Search button
    ├── Base_select.png              # Select button (selection mode)
    ├── Base_save.png                # Save button (client form)
    └── zone_exit.png                # Quit / Cancel button

Button Images

The PNG icons in the images/ folder must be in PNG format, exactly 60×60 pixels. Tkinter loads PNG natively, no external library required.

Note: If images are missing, buttons display their text label as a fallback. The program runs perfectly without images.

Window Opening Modes

Win_Client_CRUDS

Mode Constant Description
Standard STD Full CRUD (Add, Edit, Delete, View)
Single selection S1 Select one client – returns (id, name)
Multiple selection SX Select several clients – returns [(id, name), ...]

Win_Client_Fiche

Mode Constant Description
Read-only L All fields disabled, Close button only
Edit M Active input, Validate and Cancel buttons

Clients Table – SQLite Structure

Column Type Constraints
IDCLIENT INTEGER PRIMARY KEY (managed by Python)
nom_client TEXT NOT NULL
numero_telephone TEXT NOT NULL
adresse TEXT NOT NULL
code_postal TEXT NOT NULL, 5 digits
ville TEXT NOT NULL
date_naissance TEXT NOT NULL, ISO format YYYY-MM-DD
credit_disponible REAL NOT NULL, >= 0
bon_client INTEGER NOT NULL, 0 or 1
couleur_cheveux TEXT NOT NULL, brun/blond/roux/chauve

Design Principles

  • Strict MVC architecture: models, views and controllers clearly separated
  • Window modality: Toplevel + grab_set() + transient(parent)
  • Validation: real-time (validatecommand) + full validation on submit
  • SQLite error handling: non-blocking messagebox popup
  • ID incrementation: managed in Python via SELECT MAX(IDCLIENT) + 1
  • Missing images: automatic text fallback, no exception raised
  • Linux compatible: paths built with os.path.join

🇫🇷 Français

Description

ProgPythonExpl est un programme de type CRUD (Create – Read – Update – Delete) servant d'exemple et de base de réflexion pour le développement de futurs projets Python.

Il gère les opérations principales sur une table Clients dans une base SQLite : recherche, création, modification, suppression et sélection d'enregistrements.

Prérequis

  • Python 3.13 ou supérieur
  • Aucune dépendance externe — uniquement des modules Python standard
  • Tkinter (inclus dans Python standard)
  • SQLite 3 (inclus dans Python standard)
  • Compatible Linux, macOS et Windows

Installation

# Extraire le ZIP, c'est tout — aucune installation supplémentaire requise.
cd ProgPythonExpl

Lancement

python main.py

Peuplement de la base de démonstration (optionnel)

# Crée demo.sqlite avec 10 clients fictifs
python seed_data.py

# Ou spécifier un fichier existant
python seed_data.py /chemin/vers/ma_base.sqlite

Structure du projet (Architecture MVC)

ProgPythonExpl/
│
├── main.py                          # Point d'entrée – lanceur
├── seed_data.py                     # Script de peuplement
├── requirements.txt                 # Dépendances Python
│
├── core/                            # Configuration et accès base de données
│   ├── __init__.py
│   ├── config.py                    # Constantes globales (couleurs, polices, modes...)
│   └── database.py                  # GestionnaireBase : connexion SQLite
│
├── models/                          # Couche Modèle
│   ├── __init__.py
│   └── client_model.py              # Dataclass Client + ClientDAO (CRUDS)
│
├── controllers/                     # Couche Contrôleur
│   ├── __init__.py
│   ├── bienvenue_controller.py      # Logique fenêtre principale
│   ├── cruds_controller.py          # Logique fenêtre liste/gestion clients
│   └── fiche_controller.py          # Logique fenêtre fiche client + validation
│
├── views/                           # Couche Vue (fenêtres Tkinter)
│   ├── __init__.py
│   ├── Win_Bienvenue_Main.py        # Fenêtre principale (menu Fichier + Actions)
│   ├── Win_Client_CRUDS.py          # Tableau clients + boutons icônes
│   └── Win_Client_Fiche.py          # Formulaire fiche client
│
├── classes/                         # Classes communes / utilitaires
│   ├── __init__.py
│   └── base_window.py               # FenetreBase : Toplevel modal + thème ttk
│
├── fonctionsgen/                    # Fonctions utilitaires générales
│   ├── __init__.py
│   └── fonctionsgen.py              # Formatage, validation, manipulation de données
│
└── images/                          # Icônes des boutons (60×60 px PNG)
    ├── Base_create.png              # Bouton Ajouter
    ├── Base_update.png              # Bouton Modifier
    ├── Base_delete.png              # Bouton Supprimer
    ├── Base_read.png                # Bouton Consulter
    ├── Base_search.png              # Bouton Rechercher
    ├── Base_select.png              # Bouton Sélectionner (mode sélection)
    ├── Base_save.png                # Bouton Valider (fiche client)
    └── zone_exit.png                # Bouton Quitter / Annuler

Images des boutons

Les icônes PNG du dossier images/ doivent être au format PNG, exactement 60×60 pixels. Tkinter charge les PNG nativement, sans aucune bibliothèque externe.

Note : Si les images sont absentes, les boutons s'affichent avec leur libellé texte en remplacement. Le programme fonctionne parfaitement sans les images.

Modes d'ouverture des fenêtres

Win_Client_CRUDS

Mode Constante Description
Standard STD CRUD complet (Ajouter, Modifier, Supprimer, Consulter)
Sélection simple S1 Sélection d'un seul client – retourne (id, nom)
Sélection multiple SX Sélection de plusieurs clients – retourne [(id, nom), ...]

Win_Client_Fiche

Mode Constante Description
Lecture L Tous les champs désactivés, bouton Fermer uniquement
Modification M Saisie active, boutons Valider et Annuler

Table Clients – Structure SQLite

Colonne Type Contraintes
IDCLIENT INTEGER PRIMARY KEY (géré par Python)
nom_client TEXT NOT NULL
numero_telephone TEXT NOT NULL
adresse TEXT NOT NULL
code_postal TEXT NOT NULL, 5 chiffres
ville TEXT NOT NULL
date_naissance TEXT NOT NULL, format ISO YYYY-MM-DD
credit_disponible REAL NOT NULL, >= 0
bon_client INTEGER NOT NULL, 0 ou 1
couleur_cheveux TEXT NOT NULL, brun/blond/roux/chauve

Principes de conception

  • Architecture MVC stricte : modèles, vues et contrôleurs clairement séparés
  • Modalité des fenêtres : Toplevel + grab_set() + transient(parent)
  • Validation : temps réel (validatecommand) + validation globale à la soumission
  • Gestion des erreurs SQLite : popup messagebox non bloquante
  • Incrémentation des ID : gérée en Python via SELECT MAX(IDCLIENT) + 1
  • Images manquantes : fallback texte automatique, sans exception
  • Compatible Linux : chemins construits avec os.path.join