Python e Vim

Questa pagina raccoglie piccoli suggerimenti per sfruttare al meglio Vim e gVim con il linguaggio di programmazione Python.

Syntax Higlight

La porima funzione che generlamente si abilita quando si usa un editor per programmazione è il syntax highlight.

Per abilitarlo in Vim per i vari linguaggi (incluso pyton) è sufficiente decommentare in/etc/vim/vimrc la riga:

 syntax on 

Gestire l'indentazione

In python è di vitale importanza gestire correttamente l'indentazione dato che (a differenza dei linguaggi free-form come C) questa è parte integrante della sintassi.

Il python di per se riconosce ogni tipo di indentazione (TAB, spazi, o un mix dei due). Nei moderni sistemi il TAB ha tuttavia una larghezza variabile ed impostabile a piacere. Per evitare dunque problemi di interoperabilità tra persone che usano convezione diverse è universalmente consigliato di usare nei file di codice python solamente spazi oppure solamente TAB. Anche l'uso esclusivo di TAB può talvolta creare dei problemi di visualizzazione (e quindi difficoltà di lettura) a causa di una diversa larghezza usata. Per tagliare la testa al toro, dunque, il modo più robusto e portabile di programmare il python è quello di usare soltanto spazi. È possibile impostare qualsiasi editor per programmazione in modo da sostituire automaticamente al TAB un numero di spazi pari alla larghezza dell'indentazione, e ovviamente anche vim non è da meno. La larghezza per una unità di indentazione usata in modo quasi universalmente in python è pari ad una larghezza di 4 spazi. Per ricapitolare il nostro scopo è ottenere:

• Sostituzione alla pressione del tasto TAB con un numero equivalente di spazi
• Larghezza indentazione pari a 4 spazi.

Per ottenere questo comportamento in Vim/gVim si può inserire il seguente codice nel file di configurazione /etc/vim/vimrc:

 filetype plugin indent on
 autocmd FileType python      setlocal sw=4 sts=4 et tw=78 sta

La prima riga abilita l'indentazione automatica per i vari linguaggi di programmazione. In particolare per il python, se ad esempio dichiariamo una funzione su una riga, andando a capo avremo già il cursore indentato per poter scrivere il corbpo della funzione con la giusta indenzatione. Stessa cosa vale per i vari if, for, ecc... Questa funzione è utile anche per accorgersi di errori sintattici come la mancanza dei :, poiche la loro assenza fa si che il cursono non venga indentato.

La seconda riga imposta per i tipi di file python le seguenti impostazioni:

tabstop o ts: larghezza del carattere TAB quando incontrato nel file. Noi non useremo caratteri TAB quindi questa impostazione può essere ignorata (e non è riportata infatti nell'esempio precendente). Viene elencata qui solo per chiarezza e completezza.

expandtab o et

riempe con spazi le indentazioni generate dalla pressione del tasto TAB.

softtabstop o sts

larghezza di un rientro causato dalla pressione di un TAB. Il rientro è creato inserendo spazi se et è settato, altrimenti viene usata una combinazione di spazi e caratteri TAB (questi ultimi hanno larghezza ts).

shiftwidth o sw

larghezza di un rientro dell'indentazione automatica. È usato anche per definire la larghezza del rientro che si aggiunge o toglie ad un blocco di testo quando si seleziona (con v') e poi si indenta/deintenta con > o con <.

smarttab o sta

In combinazione con le opzioni precendenti questa impostazione permette di cancellare un rientro (4 spazi reali nel nostro caso) con una sola pressione del tasto BS (o BackSpace).

Folding: le piegature

Una funzione comoda durante la programmazione è la possibilità di ripiegare del codice (ad esempio una funzione o una classe) in modo di avere una visione più compatta del file e facilitare la navigazione.

Questo è possibile in Vim tramite il folding (piegature). Esistono dei plugin per Vim che riconoscono le trutture sintattiche del python e creano automaticamente le piegature. Tuttavia il metodo illustrato di seguito è ancora più semplice: piegature autmatiche in base all'indentazione. Nel caso del python questo semplice metodo è particolarmente efficace.

Per abilitarlo basta inserire in /etc/vim/vimrc:

 set foldmethod=indent

Di seguito sono elencati i principali comandi per gestire le piegature:

zo oppure Spazio

apre la piegature sotto il cursore (un solo livello)

zO

apre la piegature sotto il cursore e ricorsivamente tutte le piegature in essa contenute

zc

chiude la piegatura alla quale appartiene il blocco di codice indicato dal cursore (un solo livello)

zC

chiude la piegatura alla quale appartiene il blocco di codice indicato dal cursore e ricorsivamente tutte le piegature che la contengono

zr

apre tutte le piegature del file corrente di un livello

zR

apre completamente le piegature contenute nel file corrente (tutti i livelli)

zm

chiude tutte le piegature del file corrente di un livello

zM

chiude completamente le piegature contenute nel file corrente (tutti i livelli)

stub