minetest_modding_book/_it/quality/luacheck.md

title	layout	root	idx	description	redirect_from
Controllo automatico degli errori	default	../..	8.2	Usa LuaCheck per trovare eventuali errori	/it/chapters/luacheck.html

Introduzione

In questo capitolo, imparerai come usare uno strumento chiamato LuaCheck per scansionare automaticamente le tue mod alla ricerca di eventuali errori. LuaCheck può essere usato in combinazione con l'editor per fornire avvertimenti vari.

• Installare LuaCheck
  • Windows
  • Linux
• Eseguire LuaCheck
• Configurare LuaCheck
  • Risoluzione problemi
• Uso nell'editor

Installare LuaCheck

Windows

Basta scaricare luacheck.exe dall'apposita pagina delle versioni su Github.

Linux

Per prima cosa, avrai bisogno di installare LuaRocks:

sudo apt install luarocks

Poi va installato globalmente LuaCheck:

sudo luarocks install luacheck

Per controllare che sia stato installato correttamente, fai:

luacheck -v

Eseguire LuaCheck

La prima volta che si esegue LuaCheck, segnalerà probabilmente un sacco di falsi errori. Questo perché ha ancora bisogno di essere configurato.

Su Windows, apri la powershell o la bash nella cartella principale del tuo progetto ed esegui path\to\luacheck.exe .

Su Linux, esegui luacheck . nella cartella principale del progetto.

Configurare LuaCheck

Crea un file chiamato .luacheckrc nella cartella principale del tuo progetto. Questa può essere quella di un gioco, di un pacchetto mod o di una mod singola.

Inserisci il seguente codice all'interno:

unused_args = false
allow_defined_top = true

globals = {
    "minetest",
}

read_globals = {
    string = {fields = {"split"}},
    table = {fields = {"copy", "getn"}},

    -- Builtin
    "vector", "ItemStack",
    "dump", "DIR_DELIM", "VoxelArea", "Settings",

    -- MTG
    "default", "sfinv", "creative",
}

Poi, avrai bisogno di assicurarti che funzioni eseguendo LuaCheck: dovresti ottenere molti meno errori questa volta. Partendo dal primo errore, modifica il codice per risolvere il problema, o modifica la configurazione di LuaCheck se il codice è corretto. Dài un occhio alla lista sottostante.

Risoluzione problemi

• accessing undefined variable foobar - Se foobar dovrebbe essere una variabile globale, aggiungila a read_globals. Altrimenti, manca un local vicino a foobar.
• setting non-standard global variable foobar - Se foobar dovrebbe essere una variabile globale, aggiungila a globals. Rimuovila da read_globals se presente. Altrimenti, manca un local vicino a foobar.
• mutating read-only global variable 'foobar' - Sposta foobar da read_globals a globals, o smetti di modificare foobar.

Uso nell'editor

È caldamente consigliato installare un'estensione per il tuo editor di fiducia che ti mostri gli errori senza eseguire alcun comando. Queste sono disponibili nella maggior parte degli editor, come:

• Atom - linter-luacheck;
• VSCode - Ctrl+P, poi incolla: ext install dwenegar.vscode-luacheck;
• Sublime - Installala usando package-control: SublimeLinter, SublimeLinter-luacheck.