ESSE3: nei meandri della burocrazia

Date

2019-03-06 (aggiornato 2022-12-29)

esse3.py: A cosa serve

Automatizza alcune delle fasi delle operazioni più ripetitive della burocrazia accademica: compilare il registro delle lezioni, verbalizzare gli esami.

Dettaglio delle opzioni:

--help, -h

Un breve aiuto

--uid Nomefile.xls

Produce una lista iscritti formattata come :matricola:cognome,nome:, che è già pronta per poter essere usata da mcq.py. Il file Nomefile.xls è il file excel scaricato dal sito delle segreterie online (in genere ha il nome ListaStudentiEsameExportExcel.xls. Un esempio:

$ esse3.py --uid ListaStudenti.xls > sc1-Lista.uid
--guid

Come sopra, ma GUI per produrre una lista di iscritti formattata per mcq.py, a partire da un file .xlsx prodotto non da ESSE3 (per esempio, da MOODLE). Esempio:

$ esse3.py --guid

--pdf Nomefile.xls

Crea una versione PDF del registro (cartaceo) per l’esame, a partire dal file excel Nomefile.xls scaricato dal sito delle segreterie online. Esempio:

$ esse3.py --pdf ListaStudenti.xls

Verrà prodotto il file esse3_output.pdf. Se si vuole un altro nome del file prodotto, per esempio sc1-Registro.pdf, basta usare l’opzione:

$ esse3.py  --baseoutput=sc1-Registro --pdf ListaStudenti.xls

--call

Per la registrazione dei voti: chiama il numero di verbalizzazione online, e interattivamente chiede il numero di quattro cifre indicato nella pagina, per poi inserire automaticamente il PIN di otto cifre. Per poter funzionare, occorre collegare un telefono GSM alla porta USB del computer, e conoscere qual è il nome del dispositivo:

/dev/ttyACM0
/dev/ttyS

I dati utilizzati vengono poi salvati nel file:

${HOME}/.esse3rc
--yml ymlfile.yml

Crea una versione CSV del registro delle lezioni, da compilare tramite il sito delle segreterie online. Il formato corretto del file ymlfile è una variante locale di YAML, seguendo questo esempio:

# commenti
#
# Importante le tree dash tra il preambolo e al cambio di anno)

orario:
lun: 14:30-16:30
mar: 17:30-18:30
mer: 16:30-19:30
gio: 16:30-18:30
ven: 13:30-15:30

anno: 2020
type: '0001'
# cfr. file excel scaricato dal sito delle segreterie
# (lezioni='0001', esercitazioni=... )
target: L

---
OTT:
- 01 *L1,2  Distanza negli spazi vettoriali euclidei.
- 02 *L3 Topologia di R^n.

NOV:
- 03 *L4 Altro argomento

---
GEN:
- 04 *L5 Ultima lezione

Osservazione importante: le lezioni devono iniziare con un trattivo, a inizio riga. La parte senza spazi che segue l’asterisco viene del tutto ignorata (in modo che l’annotazione sul numero di lezioni non compaia nel registro).

Una volta prodotto il file CSV, occorre copia-e-incollarlo nel file XLS delle segreterie online, per il registro delle lezioni.

--blankyml ymlfile.yml

Crea un registro delle lezioni vuoto, con date del calendario indicate. Verranno elencati tutti i giorni (in cui sono previste lezioni da orario) comprese tra le due ISO date di inizio e fine semestre sem-start e sem-end. Il formato corretto del file ymlfile è il preambolo di un file yml, come segue:

# commenti
#
# Importante le tree dash tra il preambolo e al cambio di anno)

orario:
lun: 14:30-16:30
mar: 17:30-18:30
mer: 16:30-19:30
gio: 16:30-18:30
ven: 13:30-15:30

target: L

sem-start: 2020-10-05
sem-end: 2021-01-25
anno: 2020

type: '0001'
# cfr. file excel scaricato dal sito delle segreterie
# (lezioni='0001', esercitazioni=... )

Download

Download : esse3.py