Python/fr

Description
Python est un langage de programmation de haut niveau à usage général très utilisé dans les grandes applications pour automatiser certaines tâches en créant des scripts ou des macros.

Dans FreeCAD, le code Python peut être utilisé pour créer divers éléments par programmation, sans qu'il soit nécessaire de cliquer sur l'interface graphique. De plus, de nombreux outils et ateliers de FreeCAD sont programmés en Python.

Voir Introduction à Python pour en savoir plus sur le langage de programmation Python, puis sur Tutoriel sur les scripts Python et sur principes de base des scripts FreeCAD pour lancer la création de scripts dans FreeCAD.

Lorsque vous écrivez du code Python, il est conseillé de suivre le PEP8: guide du style pour coder en Python.

Conventions
Dans cette documentation, certaines conventions relatives aux exemples Python doivent être suivies.

Ceci est une signature de fonction typique


 * Les arguments avec des paires clé-valeur sont facultatifs, la valeur par défaut étant indiquée dans la signature. Cela signifie que les appels suivants sont équivalents:


 * In this example the first argument doesn't have a default value so it should always be included.


 * When the arguments are given with the explicit key, the optional arguments can be given in any order. This means that the following calls are equivalent:


 * Python's guidelines stress readability of code; in particular, parentheses should immediately follow the function name, and a space should follow a comma.


 * If code needs to be broken over several lines, this should be done at a comma inside brackets or parentheses; the second line should be aligned with the previous one.


 * Functions may return an object that can be used as the base of another drawing function.

Imports
Python functions are stored in files called modules. Before using any function in that module, the module must be included in the document with the instruction.

This creates prefixed functions, that is,. This system prevents name clashes with functions that are named the same but that come from different modules. For example, the two functions and  may coexist without problem.

Full examples should include the necessary imports and the prefixed functions.