Python console/fr

Introduction
La console Python est une console qui fait partie de l'interface utilisateur de FreeCAD. Elle exécute une instance de l'interpréteur Python qui peut être utilisé pour contrôler les processus FreeCAD, créer et modifier des objets et leurs propriétés.

Elle peut être rendue visible/cachée par le menu déroulant.

La console Python de FreeCAD a une coloration syntaxique de base, capable de différencier avec différents styles et couleurs, commentaires, chaînes, valeurs numériques, fonctions intégrées, sortie texte imprimée et délimiteurs tels que des parenthèses et des virgules. Ces propriétés de la console peuvent être configurées dans l’éditeur de préférences.



Création de scripts
Introduction à Python et Tutoriel sur les scripts Python.

Débuter avec les scripts et Objets créés par script.

La console Python peut effectuer l'achèvement du code de base lorsqu'un point est écrit après un objet. il montrera les méthodes publiques et les attributs (variables) de l'objet actuel (classe), par exemple

La console peut également afficher la chaîne de documentation d’une fonction particulière lors de l’écriture de la parenthèse ouvrante, par exemple



Les scripts d'initialisation FreeCAD chargent automatiquement certains modules et définissent certains alias. De fait, ceux-ci sont disponibles dans la console Python.

Par conséquent, ils sont égaux à

ces modules et alias pré-chargés ne sont disponibles qu'à partir de la console Python intégrée au programme FreeCAD. Si vous utilisez FreeCAD en tant que bibliothèque dans un programme externe, n'oubliez pas de charger les modules et  et de définir les alias nécessaires, si vous le souhaitez.

Actions
Un clic droit sur la console Python affiche certaines commandes:
 * : stocke le texte sélectionné dans le presse-papiers pour un collage ultérieur ; il est désactivé si rien n'est sélectionné.
 * : stocke la commande sélectionnée dans le presse-papiers pour le coller ultérieurement ; il est désactivé si rien n'est sélectionné.
 * : copie l'intégralité de l'historique des commandes Python entrées dans cette session.
 * : enregistre l'intégralité de l'historique des commandes Python entrées dans cette session dans un fichier texte.
 * : colle le texte précédemment copié dans le presse-papiers dans la console Python.
 * : sélectionne tout le texte de la console Python.
 * : efface toutes les commandes entrées dans la console Python. Ceci est utile si la console Python est pleine de messages et de commandes entrées précédemment qui pourraient gêner lors du test d’une nouvelle fonction. Ceci est simplement esthétique, car cette commande ne supprime pas les variables existantes ni les modules importés dans la session.
 * : ouvre une boîte de dialogue pour rechercher un fichier dans le système, puis insère le chemin complet du fichier. Ceci est utile pour tester les fonctions qui traitent un fichier d'entrée sans avoir à écrire le nom complet dans la console, ce qui est sujet aux erreurs. Cette commande n'exécute pas le fichier et ne l'importe pas en tant que module Python. Elle renvoie simplement le chemin complet de ce fichier.
 * : enveloppe les très longues lignes qui dépassent la dimension horizontale de la console Python.

Remarques

 * On a la possibilité de faire défiler l'API dans la console Python. Exemple :
 * Dans la console, tapez :
 * Une boîte de dialogue s'affiche avec des classes/fonctions optionnelles à choisir.
 * Faites défiler la liste pour lire la description de chaque classe/fonction.
 * En choisissant une fonction et en la faisant suivre d'un, on peut répéter les étapes 2 et 3 pour aller plus loin dans l'API.
 * La complétion par tabulation/mot est prise en charge par le raccourci +.