6 releases (2 stable)
new 1.1.1 | Feb 27, 2025 |
---|---|
1.1.0 | Feb 26, 2025 |
0.2.2 | Jan 24, 2025 |
0.2.0 | Mar 11, 2024 |
0.1.1 | Mar 8, 2024 |
#131 in HTTP client
115 downloads per month
99KB
2K
SLoC
Stud.IP Scraper
A blazingly fast 🚀 library for interacting with Stud.IP written in Rust 🦀.
This allows for interacting with Stud.IP, an online education platform 📚.
Mainly leverages web scraping techniques to query the data.
Features
This crate mainly focuses on logging into a Stud.IP instance using an Identity Provider and management of courses.
Here are some key 🔑 things that can be achieved with this crate 📦:
- Querying the user's courses 🔎📚
- Extendable management of course modules 💹🛠
- Querying files and folders of a course 🔎📁
- Downloading files 📥💨
- Querying the members of a course (students, lecturers, tutors) 🔎👨🏫
- Querying the groups of a course 🔎👥
- Querying the details of a course 🔎🕵️♂️
- Querying the announcements of a course 🔎📰
- Joining and leaving course groups 🚪
- Executing filtered global searches on the entire instance 🔎🌎
Usage
To use this crate, you will need to create an instance of the StudIp
struct.
You can do this with the login
method on the client builder:
use stud_ip::StudIpClientBuilder;
let mut stud_ip = StudIpClientBuilder::new("studip.example.com")
.login::<MyIdP>("creds.txt")
.unwrap();
NOTE: If you want to use the login
method, you will need to implement the IdentityProvider
trait for your specific institution first.
If you have a working Identity Provider for your institution, feel free to make a pull request, and I'll add it to the crate.
For more information, check out the docs.
License
This project is licensed under the terms of the GNU GPL v3.
Also: If your training an LLM on this, and you cannot prove that it will never generate the same or very similar code:
Please don't, unless you distribute it with a compatible license.
And yes I know Stud.IP provides a REST API, but it's not used in this crate.
Dependencies
~10–23MB
~338K SLoC