https://github.com/zmoog/classeviva-client
https://github.com/zmoog/classeviva-client
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/zmoog/classeviva-client
- Owner: zmoog
- Created: 2021-01-06T16:44:04.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2022-04-11T21:08:48.000Z (about 4 years ago)
- Last Synced: 2025-05-11T11:06:28.551Z (about 1 year ago)
- Language: Python
- Size: 27.3 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# classeviva-client
classeviva-client is a Python library and a CLI tool to access the https://web.spaggiari.eu, probably the most used portal for schools, students and families.
## Getting Started
Set your credentials as environment variables:
```shel
export CLASSEVIVA_USERNAME="you@domain.com"
export CLASSEVIVA_PASSWORD="secret!"
```
### As a Python library
```shell
$ python
>>>
>>> from classeviva.client import Client
>>> from classeviva.credentials import EnvCredentialsProvider
>>>
>>>
>>> with Client(EnvCredentialsProvider()) as client:
... print(client.grades()[:1])
...
[Grade(value=7.25, display_value='7+', subject='ITALIANO', date='2021-10-11', color='green', comment='')]
```
### As a CLI tool
List your grades:
```shell
$ classeviva list-grades
2022-03-30
- MUSICA, 7
2022-03-28
- MATEMATICA, 7½
2022-02-22
- MUSICA, 9½
- RELIGIONE, 8½
```
List your agenda entries for homework assignments:
```shell
$ classeviva list-agenda
2022-04-07
- TEACHER A, Geometria: pagina 42 n.90-91-96-100.
- TEACHER B, leggere e tradurre oralmente i dialogo di p. 130 e copiare una volta sul quaderno.
```
## Refs
Special thanks to [@michelangelomo](https://github.com/michelangelomo) for providing good API docs at [michelangelomo/Classeviva-Official-Endpoints](https://github.com/michelangelomo/Classeviva-Official-Endpoints).