749

15. Lo stile nello scrivere codice

750

This chapter documents the coding style used in live systems.

751

15.1 Compatibilità

752

• Non usare sintassi o semantiche mirate alla shell Bash. Ad esempio l'uso di costrutti array.

753

• Utilizzare solo il sottoinsieme POSIX - ad esempio, usare $(foo) invece di `foo`.

754

• È possibile verificare i propri script con "sh -n" e "checkbashisms".

755

Assicurarsi che tutto il codice giri con 'set -e'.

756

15.2 Rientri

757

• Usare sempre i tab piuttosto che gli spazi.

758

15.3 Ritorno a capo

759

• Generalmente le righe sono composte da un massimo di 80 caratteri.

760

• Utilizzare lo "stile Linux" per le interruzioni di riga:

761

Sbagliato:

762

if foo; then
         bar
fi

763

Corretto:

764

if foo
then
         bar
fi

765

• Lo stesso vale per le funzioni:

766

Sbagliato:

767

Foo () {
         bar
}

768

Corretto:

769

Foo ()
{
         bar
}

770

15.4 Variabili

771

• Le variabili vanno sempre scritte in maiuscolo.

772

• Le variabili usate in live-build iniziano sempre con il prefisso LB_.

773

• Le variabili interne temporanee in live-build dovrebbero iniziare con il prefisso _LB_.

774

• Le variabili locali iniziano con il prefisso live-build __LB_.

775

• Le variabili in live-config relative ai parametri di avvio iniziano con LIVE_.

776

• Tutte le altre variabili in live-config iniziano con il prefisso _.

777

• Intorno alle variabili utilizzare le graffe; ad esempio scrivere ${FOO} invece di $FOO.

778

• Proteggere sempre le variabili con le virgolette per rispettare potenziali spaziature: scrivere "${FOO}" e non ${FOO}.

779

• Per coerenza usare sempre le virgolette quando si assegnano valori alle variabili:

780

Sbagliato:

781

FOO=bar

782

Corretto:

783

FOO="bar"

784

• Utilizzando variabili multiple, quotare l'intera espressione:

785

Sbagliato:

786

if [ -f "${FOO}"/foo/"${BAR}"/bar ]
then
         foobar
fi

787

Corretto:

788

if [ -f "${FOO}/foo/${BAR}/bar" ]
then
         foobar
fi

789

15.5 Varie

790

• Per le chiamate a sed utilizzare "|" (senza virgolette intorno) come separatore, ad esempio "sed -e 's|foo|bar|'" (senza "").

791

• Non utilizzare il comando test per prove o confronti, usare "[" "]" (senza ""); ad esempio "if [ -x /bin/foo ]; ..." e non "if test -x /bin/foo; ...".

792

• Ove possibile utilizzare case invece di test, essendo più facile da leggere e più veloce in esecuzione.

793

• Per le funzioni utilizzare nomi che iniziano con la maiuscola per limitare i problemi con le variabili d'ambiente dell'utente.