Python/ro

Descriere
Python este un limbaj de programare cu scop general, care este foarte frecvent utilizat în aplicații mari pentru a automatiza anumite sarcini prin crearea de scripturi sau macros.

În programul FreeCAD, codul Python poate fi folosit pentru a crea diverse elemente programabil, fără a fi nevoie să faceți clic pe interfața grafică a utilizatorului. În plus, multe instrumente și ateliere de lucru ale programului FreeCAD sunt programate în Python.

A se vedea Introduction to Python pentru a afla despre limbajul de programare Python și apoi Python scripting tutorial și FreeCAD Scripting Basics  pentru a porni scripting-ul în FreeCAD.

Atunci când se scrie codul în Python, este de preferat să se urmeze PEP8: Style Guide for Python Code.

Convenții
În această documentație, ar trebui urmate câteva convenții pentru exemplele Python.

Aceasta este o semnătură tipică a funcției


 * Argumentele cu perechi cheie-valoare sunt opționale, cu valoarea implicită indicată în semnătură. Aceasta înseamnă că următoarele apeluri sunt echivalente:


 * În acest exemplu, primul argument nu are o valoare implicită, așa că trebuie întotdeauna inclus.


 * 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.

Importuri
Funcțiile Python sunt stocate în fișiere numite module. Înainte de a utiliza orice funcție din modulul respectiv, modulul trebuie inclus în document cu instrucțiunea.

Aceasta creează funcții prefixate,. Acest sistem previne conflictele de nume cu funcții numite aceleași, dar care provin de la diferite module. De exemplu, două funcții și  pot coexista fără probleme.

Exemplele complete ar trebui să includă importurile necesare și funcțiile prefixate.