sapienza_driver 0.0.1

Driver for connections with Sapienza Infostud, to get informations about a student for your application

Sapienza Driver

Sapienza Driver is a Flutter/Dart package designed to interface with the Sapienza University systems, providing functionalities for managing exams, certificates, news, and other student-related data. This package simplifies interaction with university APIs.

---

Features

• Exams Management:

  • Fetch completed, reservable, and reserved exams.
  • Make and manage exam reservations.

• Certificates:

  • Generate academic certificates.
  • Download certificate PDFs directly.

• News Fetching:

  • Retrieve university news with descriptions and images.
  • Search with optional filters and pagination.

• Tax Management:

  • Retrieve paid and unpaid taxes.
  • Download payment slips in PDF format.

---

Getting Started

1. Add the package to your pubspec.yaml:

   dependencies:
     sapienza_driver: ^1.0.0
   

2. Install the package:

   flutter pub get
   

3. Import the necessary handlers:

   import 'package:sapienza_driver/handlers/exam_handler.dart';
   import 'package:sapienza_driver/handlers/news_handler.dart';
   import 'package:sapienza_driver/handlers/certificate_handler.dart';
   

Usage

Fetch Completed Exams

```flutter
await authHandler.login(studentID, password);
token = authHandler.token;
if (token == null) throw Exception('Token non valido');

final examHandler = ExamHandler(token: token!);

void fetchExams() async {
    try {
        final exams = await examHandler.getExamsDone('studentID');
        for (var exam in exams) {
            print('Exam: ${exam.nomeEsame}, Score: ${exam.result}');
        }
    } catch (e) {
        print('Error fetching exams: $e');
    }
}
```

Student Informations

```flutter
await authHandler.login(studentID, password);
token = authHandler.token;
if (token == null) throw Exception('Token non valido');

final studentHandler = StudentHandler(token: token!);
var info = await studentHandler.getStudentInfo(studentID);
print(info.nome);
```

Additional Information

• Contributions: Contributions are welcome! Feel free to fork the repository and submit pull requests.
• Issues: If you encounter any issues, please file them in the GitHub Issues section.
• License: This package is distributed under the MIT License.