Metadata-Version: 2.1
Name: argofamiglia
Version: 0.1.0
Summary: Simple library that allows you to interface Python with the API of Argo Scuola Next.
Home-page: https://github.com/salvatore-abello/ArgoFamigliaAPI
Author: salvatore.abello
Author-email: salvatore.abello2005@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: certifi (==2022.5.18.1)
Requires-Dist: charset-normalizer (==2.0.12)
Requires-Dist: idna (==3.3)
Requires-Dist: requests (==2.27.1)
Requires-Dist: urllib3 (==1.26.9)

# Argo Famiglia API
A library created to interface Python with Argo ScuolaNext.
You can use this library to automate some actions like:
- Check for new announcements;
- Check homework for the next and past days;
- And more...

## How the idea was born
The idea was born because the official app doesn't notify you if an announcements arrives, or if you receive a new vote, and also because the app is **REALLY** slow.
I then implemented this API in a Discord bot that notifies me and my class about new announcements from the school.

I then discovered that there are libraries already developed by others that do the exact same thing. [hearot](https://github.com/hearot/) has developed a much better library than mine, [it's worth checking out](https://github.com/hearot/ArgoScuolaNext). Thanks to him, I improved some things about my library.

### How to use
You can install this library with:
(On Windows)
`python -m pip install -U git+https://github.com/salvatore-abello/ArgoFamigliaAPI.git`

(On Linux)
`python3 -m pip install -U git+https://github.com/salvatore-abello/ArgoFamigliaAPI.git`

Below is an example of how to print announcements.
```
from argofamiglia import ArgoFamiglia

session = ArgoFamiglia("SCHOOL_CODE", "myusername", "mypassword")
print(session.argoRequest("bachecanuova"))
```

## DISCLAIMER
Use this library at your own risk, as it violates the terms of the services

```The authentication token and the restful services invoked through it, can only be used by the "DidUP - Famiglia" application of Argo Software SRL for the provision of its services or by saas suppliers and related applications specifically pre-authorized, in compliance with current legislation in manner of protection of personal data and the measures required by the AgID for the SaaS applications of the PA.```

```Il token di autenticazione e i servizi restful invocati mediante esso, possono essere utilizzati solo dall'applicazione "DidUP - Famiglia" della Argo Software SRL per lâ€™erogazione dei propri servizi o da fornitori saas e relative applicazioni appositamente preautorizzate, in conformitÃ  alla vigente normativa in maniera di protezione dei dati personali ed alle misure richieste dall'AgID per gli applicativi SaaS delle PA.```

## Credits
Thanks to [veetaw](https://github.com/veetaw/), as I took inspiration (and even help) [from his unofficial client](https://github.com/veetaw/argo-scuolanext-dart).







