Wikicontrib.sh

wikicontrib.sh è un semplice Bash script creato da Son Gohan che permette di calcolare il numero di contributi di qualunque utente di wiki.metin2.it.

versione attuale: 1.0

Funzionamento dello script

Lo script funziona scaricando temporaneamente le pagine html della wiki corrispondenti alle pagine "Contributi Utente", eseguendo un parsing su di esse e contando il numero di modifiche per ogni pagina di contributi, fornendo quindi il numero totale di modifiche effettuate dall'utente in questione. Naturalmente è necessario essere connessi a Internet per scaricare queste pagine.

Utilizzo del tool

wikicontrib.sh viene lanciato da linea di comando da un qualunque terminale UNIX che supporti Bash (tipicamente: qualunque distribuzione Linux e MacOS). L'utilizzo base è il seguente:

./wikicontrib.sh <nome_utente>

dove <nome_utente> sta ovviamente per il nome dell'utente del quale si desiderano contare i contributi. NOTA BENE: se il nome dell'utente in questione è composto da più parole, sostituire ogni spazio con un underscore.

Il numero di edit viene di default mostrato a schermo. È possibile però redirigere l'output su file (vedi sezione: Opzioni).

Opzioni

Oltre al nome_utente è possibile passare allo script le seguenti opzioni:

--dump <nome_file>	Appende una riga con il formato "nome_utente numero_edit" al file chiamato nome_file
--help	Fornisce un messaggio di istruzioni sull'utilizzo del tool.

L'opzione --dump è utile se si vogliono generare liste: in tal caso è infatti sufficiente lanciare lo script in un ciclo nel seguente modo:

for i in $(cat lista_nomi.txt); do
        ./wikicontrib.sh $i --dump lista_edit.txt
done

Questo comando conta i contributi di tutti i nomi contenuti in "lista_nomi.txt" e restituisce un file "lista_edit.txt" contenente:

Nome_1     123
Nome_2     456
...

dove la prima colonna contiene tutti i nomi di "lista_nomi.txt" e la seconda i rispettivi edit.

NOTA BENE: il numero di edit restituito può in certi casi non essere preciso al 100%; comunque solitamente non differisce di molto dal valore vero.

Come scaricare il tool

Il tool è disponibile per il download qui: wikicontrib.sh v1.0

Una volta scaricato, si lancia nel seguente modo:

• Aprire un terminale (in OSX si chiama "Terminal.app"; su Linux può avere vari nomi a seconda del DE)
• spostarsi nella cartella contenente lo script (tipicamente: `cd ~/Downloads`)
• eseguire un `chmod +x wikicontrib.sh` per rendere lo script eseguibile
• da questo momento è possibile lanciare lo script usando il comando sopra riportato.

Requisiti di sistema

• Una shell, preferibilmente bash, altrimenti anche zsh o sh (bash è di norma la shell di default presente su qualunque sistema Unix-like, compreso OS X);
• Il programma wget, solitamente preinstallato su sistemi Unix-like, o in alternativa curl (in questo caso però sarà necessario decommentare e commentare le apposite due righe nello script).