CONVENTIONS
CONVENTIONS
PRESENTATIONS.
Les conventions typographiques, utilisées dans se site, permettent d'identifier chaque élément, d'un script d'exemple, de façon unique, rapide et précise.
Pour optimiser les exemples, les différents éléments du code sont nommés de façon récursive, pour retrouver rapidement, lors de la relecture, un grand nombre de renseignements sur les dits éléments tel que : le type, la portée, l'origine ... selon la nomenclature ci-dessous. Par exemple, chaque fois que l'on rencontrera, dans ce site, un terme commençant par LST_ ..., on comprendra qu'il s'agit d'un objet de type list ( ), avec toutes ses méthodes et particularités, sans qu'il soit nécessaire surcharger le texte explicatif de commentaires superflus. (Ils ne sont pas à reproduire, mais servent à conserver un fil conducteur dans tous les exemples.)
Cela est particulièrement utile lors de la lecture (analyse et compréhension) des fonctions définies par l'utilisateur, placées en général en début de script, et qui font références à des objets (du module tkinter par exemple) qui ne sont pas encore instanciés, car placés en fin de script.
ORIGINES DES OBJETS.
Rouge gras : INVARIABLE ! Mot réservé du langage Python.
Bleu gras : INVARIABLE ! Classe ou méthode built-in du langage Python.
Noir gras : INVARIABLE ! Valeur d’affectation d'une liste imposée par le langage, dites constantes.
Vert normal : Modifiable. Ligne de commentaire du script ( # ).
Orange gras : Modifiable. Variable ou instance d'objet de portée globale.
Orange normal : Modifiable. Variable locale définie par l'utilisateur.
noir : Modifiable. Valeur choisi librement.
Autre gras : INVARIABLE ! Classe ou méthode importée.
IDENTIFICATION DES TYPES D'OBJETS.
BAR_ : Barre de défilement ( tkinter : Scrollbar ).
BDD_ : Base de données SGBD ( sqlite3 : Connection ).
BLB_ : BLOB (Binary Large Object Base) ( sqlite3 : Blob ).
BOX_ : Liste fixe de sélection ( tkinter : Listbox , OptionMenu ).
BUT_ : Bouton cliquable ( tkinter : Button ).
BYA_ : Objet byte muable ( Python : bytearray ).
BYT_ : Objet byte non muable ( Python : bytes ).
CAN_ : Toile, zone de dessins ( tkinter : Canvas , turtle : Canvas ).
CHX_ : Liste à choix déroulante ( tkinter.ttk : Combobox ).
CKB_ : Case à cocher ( tkinter : Checkbutton ).
CLR_ : couleur personnalisée ( pygame ).
CLS_ : Classe personnalisé par l'utilisateur ( Python : class ).
CUR_ : Curseur ( sqlite3 : Cursor , pygame : cursors, Cursor ).
DCT_ : Dictionnaire ( Python : dict ).
DIM_ : Tableau d'élément de type semblable ( array, pygame).
DIR_ : Répertoire (chemin) de fichiers ( Tous ).
DTM : Date, heure et moment divers ( time, datetime, calendar, ... ).
ESB_ : Ensemble modifiable ( Python : set ).
ENT_ : Champs de saisie ( tkinter : Entry ).
event : Evénement, paramètre transmis automatiquement ( Pyhon, tkinter, Tous ).
EVN_ : Evénement virtuel ( Pyhon, tkinter ).
FIL_ : Fichier ( Python : open, Tous ).
FNC_ : Fonction personnalisée ( Python : def ).
FNT_ : Fonte ( Tous ).
FRM_ : Conteneur, cadre ( tkinter : Frame, LabelFrame, PanedWindow ).
FST_ : Ensemble non modifiable ( Python : frozenset ).
GLB_ : Variable globale ( ex.GLB_Joueur, GLB_Score, GLB_PdV ).
i : Variable de boucle ( Python : for ).
IDE_ : Identificateur d'objet ( Tous ).
IMG_ : Image, photo, dessin ( Tous ).
j : Variable de boucle imbriquée ( Python : for ).
k : Variable locale unique.
k??? : Variable locale ( ex. ktexte, knom, klargeur ).
LAB_ : Etiquette ( tkinter : Label, Message ).
LMD_ : Fonction anonyme ( Python : lambda ).
LST_ : Liste ( Python : list ).
MRV_ : Vue mémoire d'un objet tampon ( Python : memoryview , pygame : BufferProxy ).
MNU_ : Menu ( tkinter : Menu , Menubutton ).
NTB_ : Conteneur à onglets ( tkinter.ttk : Notenook ).
OBJ_ : Objet primitif ( Python : objet ).
OTH_ : Autres controles ( tkinter.ttk : Separator , Sizegrip ).
PSR_ : Passeur d'arguments en ligne de commande ( argparse ).
PYG_ : Fenêtre d'affichage principale de Pygame ( pygame ).
Q : attribut unique passé avec def.
Q??? : argument nommé ( ex. Qnom, Qpoint, Qtableau ) avec def.
*Q : tuple ( ) (ou list ( )) passé comme argument avec def.
**Q : dict ( ) passé comme argument avec def.
RAD_ : Bouton radio ( tkinter : Radiobutton ).
REG_ : Emballage tkl ( tkinter : register ).
RNG_ : Suite numérique ( Python : range ).
RTG_ : zone rectangulaire d'une surface graphique ( pygame ).
self : Attribut représentant la classe elle-même ( Python : class ).
SCA_ : Echelle de valeurs ( tkinter : Scale ).
SFC_ : surface de dessin de pygame ( pygame ).
SND_ : Sons ( Tous ).
SPI_ : Sélecteur rotatif ( tkinter, tkinter.ttk : Spinbox ).
STY_ : Thème de Styles ( tkinter.ttk : Style ).
SUR_ : Surface ( pygame : toutes surfaces ).
TAG_ : Marques, balises ( tkinter : text, tkinter.ttk : Treeview ).
TKI_ : Fenêtre tkinter ( tkinter : Tk et Toplevel ).
TKV_ : Variable de controle ( tkinter : StringVar, IntVar et DoubleVar ).
TOR_ : Tortue ( turtle : Turtle).
TPL_ : Liste non modifiable ( Python : tuple ).
TRT_ : Objet itérateur ( Python : iter).
TRV_ : Arborescence hiérarchique d'éléments, grille ( tkinter.ttk : Treeview ).
TXT_ : Texte long et/ou multigne ( tkinter : Text ).
WAI_ : Barre de progression ( tkinter.ttk : Progressbar ).
Votre aide est précieuse pour améliorer ce site, alors n'hésitez pas à faire part de
Dans la LOGITHEQUE de MON PYTHON PAS A PAS
vous trouvez des suggestions de projets simples et classiques pour
ooo
TESTER - DÉCOUVRIR - PRATIQUER - APPROFONDIR - EXPLORER
ooo
la programmation récréative avec le langage PYTHON 3
avec un exemple de résolution à télécharger pour vous inspirer.