Python/it

Descrizione
Python è un linguaggio di programmazione di alto livello per scopi generali, comunemente utilizzato in applicazioni di grandi dimensioni per automatizzare alcune attività creando script o macro.

In FreeCAD, il codice Python può essere utilizzato per creare vari elementi in modo programmatico, senza la necessità di fare clic sull'interfaccia utente grafica. Inoltre, molti strumenti e ambienti di lavoro di FreeCAD sono programmati in Python.

Vedere Introduzione a Python per conoscere il linguaggio di programmazione Python, quindi Guida agli Script Python e Script di base per FreeCAD per iniziare a creare script in FreeCAD.

Leggibilità
La leggibilità del codice Python è uno degli aspetti più importanti di questo linguaggio. L'uso di uno stile chiaro e coerente all'interno della comunità Python facilita i contributi da parte di diversi sviluppatori, poiché i programmatori Python più esperti si aspettano che il codice sia formattato in un certo modo e segua determinate regole. Quando si scrive codice Python, è consigliabile seguire PEP8: Style Guide for Python Code e PEP257: Docstring Conventions.

Questi documenti presentano le spiegazioni in modo più intuitivo:
 * How to Write Beautiful Python Code With PEP 8
 * Documenting Python Code: A Complete Guide.

Convenzioni
In questa documentazione dovrebbero essere seguite alcune convenzioni per gli esempi Python.

Questa è una tipica firma di funzione


 * Gli argomenti con coppie chiave-valore sono facoltativi, con il valore predefinito indicato nella firma. Ciò significa che le seguenti chiamate sono equivalenti:


 * In questo esempio il primo argomento non ha un valore predefinito quindi dovrebbe essere sempre incluso.


 * Quando gli argomenti vengono forniti con la chiave esplicita, gli argomenti opzionali possono essere forniti in qualsiasi ordine. Ciò significa che le seguenti chiamate sono equivalenti:


 * Le linee guida di Python sottolineano la leggibilità del codice; in particolare, le parentesi dovrebbero seguire immediatamente il nome della funzione e uno spazio dovrebbe seguire una virgola.


 * Se è necessario suddividere il codice su più righe, ciò dovrebbe essere fatto con una virgola tra parentesi quadre o parentesi quadre; la seconda riga dovrebbe essere allineata con la precedente.


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