Python console/it: Difference between revisions
Renatorivo (talk | contribs) (Created page with "{{Emphasis|Per i principianti assoluti, vedere:}} Introduzione a Python, e Tutorial di script Python.") |
(Created page with "* Si ha la possibilità di scorrere l'API nella console Python. Esempio: *# Nella console digita: {{incode|FreeCAD.}} *# Verrà visualizzata una finestra di dialogo con classi...") |
||
(23 intermediate revisions by 3 users not shown) | |||
Line 4: | Line 4: | ||
==Introduzione== |
==Introduzione== |
||
{{TOCright}} |
|||
⚫ | |||
⚫ | |||
⚫ | La console Python di FreeCAD ha l'evidenziazione di base della sintassi, in grado di differenziare con vari stili e colori, commenti, stringhe, valori numerici, funzioni integrate, output di testo stampato e delimitatori come parentesi e virgole. Queste proprietà della console possono essere configurate nell'[[ |
||
Può essere resa visibile/nascosta tramite il menu a tendina {{MenuCommand|Visualizza → Panelli → Console Python}}. |
|||
⚫ | La console Python di FreeCAD ha l'evidenziazione di base della sintassi, in grado di differenziare con vari stili e colori, commenti, stringhe, valori numerici, funzioni integrate, output di testo stampato e delimitatori come parentesi e virgole. Queste proprietà della console possono essere configurate nell'[[Preferences_Editor/it|editor delle Preferenze]]. |
||
[[File:FreeCAD_Python_console.png|800px]] |
[[File:FreeCAD_Python_console.png|800px]] |
||
Line 16: | Line 20: | ||
{{Emphasis|Per i principianti assoluti, vedere:}} [[Introduction to Python/it|Introduzione a Python]], e [[Python scripting tutorial/it|Tutorial di script Python]]. |
{{Emphasis|Per i principianti assoluti, vedere:}} [[Introduction to Python/it|Introduzione a Python]], e [[Python scripting tutorial/it|Tutorial di script Python]]. |
||
{{Emphasis| |
{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base in FreeCAD]], e [[Scripted objects/it|Oggetti script]]. |
||
La console Python può eseguire il completamento del codice di base quando viene scritto un punto dopo un oggetto; mostra metodi e gli attributi pubblici (variabili) dell'oggetto corrente (classe), ad esempio {{incode|obj.}} |
|||
La console è anche in grado di mostrare la stringa di documentazione di una particolare funzione quando viene scritta la parentesi iniziale, ad esempio {{incode|function(}} |
|||
[[File:FreeCAD_Python_console_example.png|800px]] |
[[File:FreeCAD_Python_console_example.png|800px]] |
||
{{Caption| |
{{Caption|Esempio di codice Python che produce degli oggetti nella vista 3D.}} |
||
The Python console automatically loads some modules, and defines some aliases. |
|||
Gli script di inizializzazione di FreeCAD caricano automaticamente alcuni moduli e definiscono alcuni alias. Pertanto, nella console Python sono disponibili |
|||
{{Code|code= |
{{Code|code= |
||
App = FreeCAD |
App = FreeCAD |
||
Line 34: | Line 36: | ||
}} |
}} |
||
che sono quindi uguali a |
|||
Therefore these are equal |
|||
{{Code|code= |
{{Code|code= |
||
Line 41: | Line 43: | ||
}} |
}} |
||
{{Emphasis|Nota:}} questi moduli e alias precaricati sono disponibili solo dalla console Python incorporata nel programma FreeCAD. Se si usa FreeCAD come libreria in un programma esterno, bisogna ricordarsi di caricare i moduli {{incode|FreeCAD}} e {{incode|FreeCADGui}} e, se lo si desidera, definire gli alias necessari. |
|||
⚫ | |||
==Azioni == |
|||
Un clic con il tasto destro sulla console Python mostra alcuni comandi: |
|||
* {{MenuCommand|Copia}}: memorizza il testo selezionato negli appunti per un successivo incollaggio; è disabilitato se non è selezionato nulla. |
|||
* {{MenuCommand|Copia il comando}}: memorizza il comando selezionato negli appunti per un successivo incollaggio; è disabilitato se non è selezionato nulla. |
|||
* {{MenuCommand|Copia la cronologia}}: copia l'intera cronologia dei comandi Python immessi in questa sessione. |
|||
* {{MenuCommand|Salva la cronologia come}}: salva l'intera cronologia dei comandi Python immessi in questa sessione in un file di testo. |
|||
* {{MenuCommand|Incolla}}: incolla il testo precedentemente copiato negli appunti nella console di Python. |
|||
* {{MenuCommand|Seleziona tutto}}: seleziona tutto il testo nella console di Python. |
|||
* {{MenuCommand|Pulisci la console}}: cancella tutti i comandi immessi nella console Python. Ciò è utile se la console Python è piena di messaggi e comandi precedentemente immessi che potrebbero distrarre durante il test di una nuova funzione. Questo è puramente estetico, poiché questo comando non cancella le variabili esistenti né cancella i moduli importati nella sessione. |
|||
* {{MenuCommand|Inserisci il nome del file}}: apre una finestra di dialogo per cercare un file nel sistema, quindi inserisce il percorso completo del file. Ciò è utile per testare le funzioni che elaborano un file di input, senza dover scrivere l'intero nome nella console, che è soggetto a errori. Questo comando non esegue il file e non lo importa come modulo Python, restituisce semplicemente il percorso completo di quel file. |
|||
* {{MenuCommand|A capo automatico}}: avvolge le linee molto lunghe che superano la dimensione orizzontale della console Python. |
|||
⚫ | |||
* Si ha la possibilità di scorrere l'API nella console Python. Esempio: |
|||
*# Nella console digita: {{incode|FreeCAD.}} |
|||
*# Verrà visualizzata una finestra di dialogo con classi/funzioni opzionali tra cui scegliere |
|||
*# Scorri l'elenco per leggere la descrizione di ogni classe/funzione |
|||
*# Scegliendo una funzione e facendola seguire da un {{incode|.}} è possibile ripetere i passaggi 2 e 3 per approfondire l'API |
|||
* Il completamento di etichette/parole è supportato utilizzando la scorciatoia {{KEY|Ctrl}}+{{KEY|Space}} |
|||
Right click on the Python console shows some commands: |
|||
* {{MenuCommand|Copy}}: stores the selected text in the clipboard for later pasting; it is disabled if nothing is selected. |
|||
* {{MenuCommand|Copy command}}: stores the selected command in the clipboard for later pasting; it is disabled if nothing is selected. |
|||
* {{MenuCommand|Copy history}}: copy the entire history of Python commands entered in this session. |
|||
* {{MenuCommand|Save history as}}: save the entire history of Python commands entered in this session to a text file. |
|||
* {{MenuCommand|Paste}}: paste previously copied text in the clipboard to the Python console. |
|||
* {{MenuCommand|Select all}}: selects all text in the Python console. |
|||
* {{MenuCommand|Clear console}}: erases all commands entered into the Python console. This is useful if the Python console is full of messages and previously entered commands that may be distracting when testing a new function. This is merely aesthetic, as this command doesn't delete existing variables nor clears the imported modules in the session. |
|||
* {{MenuCommand|Insert file name}}: opens a dialog to search for a file in the system, then it inserts the full path of the file. This is useful to test functions that process an input file, without having to write the entire name in the console, which is error prone. This command does not run the file, and does not import it as a Python module, it just returns the full path of that file. |
|||
* {{MenuCommand|Word wrap}}: wrap very long lines that exceed the horizontal dimension of the Python console. |
|||
{{Interface |
{{Interface navi{{#translation:}}}} |
||
{{Std Base navi{{#translation:}}}} |
|||
{{Userdocnavi |
{{Userdocnavi{{#translation:}}}} |
Latest revision as of 06:30, 2 October 2022
Introduzione
La console Python è un pannello che fa parte dell'interfaccia utente di FreeCAD . Esegue un'istanza dell'interprete Python che può essere utilizzato per controllare i processi di FreeCAD e creare e modificare gli oggetti e le loro proprietà.
Può essere resa visibile/nascosta tramite il menu a tendina Visualizza → Panelli → Console Python.
La console Python di FreeCAD ha l'evidenziazione di base della sintassi, in grado di differenziare con vari stili e colori, commenti, stringhe, valori numerici, funzioni integrate, output di testo stampato e delimitatori come parentesi e virgole. Queste proprietà della console possono essere configurate nell'editor delle Preferenze.
Console Python che mostra i messaggi quando FreeCAD è appena stato avviato.
Script
Per i principianti assoluti, vedere: Introduzione a Python, e Tutorial di script Python.
Vedere anche: Script di base in FreeCAD, e Oggetti script.
La console Python può eseguire il completamento del codice di base quando viene scritto un punto dopo un oggetto; mostra metodi e gli attributi pubblici (variabili) dell'oggetto corrente (classe), ad esempio obj.
La console è anche in grado di mostrare la stringa di documentazione di una particolare funzione quando viene scritta la parentesi iniziale, ad esempio function(
Esempio di codice Python che produce degli oggetti nella vista 3D.
Gli script di inizializzazione di FreeCAD caricano automaticamente alcuni moduli e definiscono alcuni alias. Pertanto, nella console Python sono disponibili
App = FreeCAD
Gui = FreeCADGui
che sono quindi uguali a
App.newDocument()
FreeCAD.newDocument()
Nota: questi moduli e alias precaricati sono disponibili solo dalla console Python incorporata nel programma FreeCAD. Se si usa FreeCAD come libreria in un programma esterno, bisogna ricordarsi di caricare i moduli FreeCAD
e FreeCADGui
e, se lo si desidera, definire gli alias necessari.
Azioni
Un clic con il tasto destro sulla console Python mostra alcuni comandi:
- Copia: memorizza il testo selezionato negli appunti per un successivo incollaggio; è disabilitato se non è selezionato nulla.
- Copia il comando: memorizza il comando selezionato negli appunti per un successivo incollaggio; è disabilitato se non è selezionato nulla.
- Copia la cronologia: copia l'intera cronologia dei comandi Python immessi in questa sessione.
- Salva la cronologia come: salva l'intera cronologia dei comandi Python immessi in questa sessione in un file di testo.
- Incolla: incolla il testo precedentemente copiato negli appunti nella console di Python.
- Seleziona tutto: seleziona tutto il testo nella console di Python.
- Pulisci la console: cancella tutti i comandi immessi nella console Python. Ciò è utile se la console Python è piena di messaggi e comandi precedentemente immessi che potrebbero distrarre durante il test di una nuova funzione. Questo è puramente estetico, poiché questo comando non cancella le variabili esistenti né cancella i moduli importati nella sessione.
- Inserisci il nome del file: apre una finestra di dialogo per cercare un file nel sistema, quindi inserisce il percorso completo del file. Ciò è utile per testare le funzioni che elaborano un file di input, senza dover scrivere l'intero nome nella console, che è soggetto a errori. Questo comando non esegue il file e non lo importa come modulo Python, restituisce semplicemente il percorso completo di quel file.
- A capo automatico: avvolge le linee molto lunghe che superano la dimensione orizzontale della console Python.
Note
- Si ha la possibilità di scorrere l'API nella console Python. Esempio:
- Nella console digita:
FreeCAD.
- Verrà visualizzata una finestra di dialogo con classi/funzioni opzionali tra cui scegliere
- Scorri l'elenco per leggere la descrizione di ogni classe/funzione
- Scegliendo una funzione e facendola seguire da un
.
è possibile ripetere i passaggi 2 e 3 per approfondire l'API
- Nella console digita:
- Il completamento di etichette/parole è supportato utilizzando la scorciatoia Ctrl+Space
- Preferences Editor, Interface Customization
- Main window: Standard menu, Main view area, 3D view, Combo view (Tree view, Task panel, Property editor), Selection view, Report view, Python console, Status bar, DAG view, Workbench Selector
- Auxiliary windows: Scene inspector, Dependency graph
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- View:
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Edit, Clipboard, Workbench, Macro, View, Structure, Help
- Panels: Tree view, Property view, Selection view, Tasks, Python console, DAG view, Model, Report view
- Link navigation: Go to linked object, Go to the deepest linked object, Select all links
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection, Selection Back, Selection Forward
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub