axios
Python library and CLI to access the school electronic register from Axios
Command line utility to access https://family.axioscloud.it
Installation
Install this tool using pip:
pip install axios
Usage
First, set the environment variables:
export AXIOS_CUSTOMER_ID="12345678909"
export AXIOS_USERNAME="1234"
export AXIOS_PASSWORD="a-secret-i-will-not-share"
export AXIOS_STUDENT_ID="4567"
To list latest grades, run:
$ axios grades list
Grades
Data Materia Tipo Voto Obiettivi Commento Docente
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
2022-12-06 TECNOLOGIA e INFORMATICA Scritto 7.5 Pavarin Maria Luisa
2022-12-02 MATEMATICA Scritto 7,75 Verifica sugli insiemi Micela Silvia
2022-12-01 ARTE E IMMAGINE Grafico 10 Tav.3 figura e sfondo Pagliarulo Veronica
2022-12-01 ARTE E IMMAGINE Grafico 7/8 Tav.1 Punto e linea Pagliarulo Veronica
2022-11-30 MUSICA Orale 7 Verifica di carattere teorico. Interrogazione su tutto il programma svolto finora. Cataldo Francesco
2022-11-24 ITALIANO Scritto 8.5 Fonologia e ortografia Rapalino Lara
2022-11-23 TECNOLOGIA e INFORMATICA Grafico 6.5 Pavarin Maria Luisa
2022-11-23 MUSICA Orale 7,5 Verifica di carattere teorico. Interrogazione su tutto il programma svolto finora. Cataldo Francesco
2022-11-18 MATEMATICA Grafico 8,5 Verifica sulle equivalenze e le operazioni con le misure del tempo Micela Silvia
2022-11-16 TECNOLOGIA e INFORMATICA Grafico 7 Pavarin Maria Luisa
2022-11-10 ARTE E IMMAGINE Grafico 8 Poster per la pace Pagliarulo Veronica
2022-11-09 LINGUA STRANIERA INGLESE Scritto 8,5 Test units 1 e 2 Barbero Daniela
Defaults to current year and period.
To select a different year or period, run:
# allowed values: FT01 and FT02
axios --period FT02 grades list
# the year classes started
axios --year 2021 grades list
# you can combine them, of course
axios --year 2021 --period FT01
To format the output in JSON or NDJSON, run:
$ axios --output-format json grades list
[
{
"date": "2023-03-23",
"subject": "ARTE E IMMAGINE",
"kind": "Grafico",
"value": "9",
"teacher": "Pagliarulo Veronica",
"comment": "Concorso LAV"
},
{
"date": "2023-03-20",
"subject": "STORIA",
"kind": "Orale",
"value": "10",
"teacher": "Novelli Cristina",
"comment": ""
}
]
$ axios --output-format ndjson grades list
{"date": "2023-03-23", "subject": "ARTE E IMMAGINE", "kind": "Grafico", "value": "9", "teacher": "Pagliarulo Veronica", "comment": "Concorso LAV"}
{"date": "2023-03-20", "subject": "STORIA", "kind": "Orale", "value": "10", "teacher": "Novelli Cristina", "comment": ""}
For help, run:
axios --help
You can also use:
python -m axios --help
Development
To contribute to this tool, first checkout the code. Then create a new virtual environment:
cd axios
python -m venv venv
source venv/bin/activate
Now install the dependencies and test dependencies:
pip install -e '.[test]'
To run the tests:
pytest
