A python library for accessing your Edupage account
Project description
Disclaimer
I do not have the energy to update this project. I can make bug-fixes or some small feature updates from time to time, but I am fed up with python's weak typing.
edupage-api
This python library allows easy access to Edupage. This is not a Selenium web scraper. It makes requests directly to Edupage's endpoints and parses the HTML document.
If you find any issue with this code, it doesn't work, or you have a suggestion please let me know by opening an issue! If you, even better have fixed the issue, added a new feature or made something work better please open a pull request!
Installing
You can install this library with pip:
pip install edupage-api
Usage
Login
You can log in easily, works with any school:
from edupage_api import Edupage, BadCredentialsException, LoginDataParsingException
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
try:
edupage.login()
except BadCredentialsException:
print("Wrong username or password!")
except LoginDataParsingException:
print("Try again or open an issue!")
Get timetable for a given date
Check all available timetables:
from edupage_api import Edupage
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
# Get dates for all available timetables
dates = edupage.get_available_timetable_dates()
print(dates) # ['2021-02-03', '2021-02-04']
Get the timetable for a date
from edupage_api import Edupage, EduDate
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
# Get today's date
today = EduDate.today() # '2021-02-03'
timetable = edupage.get_timetable(today) # returns EduTimetable
# Get first lesson
first_lesson = timetable.get_first_lesson()
# The starting and ending time of the first lesson
start_time = first_lesson.length.start
end_time = first_lesson.length.end
print(start_time)
print(end_time)
# Get yesterday date
yesterday = EduDate.yesterday_this_time() # '2021-02-04'
print(yesterday)
# This will return None, because the timetable from yesterday is not available
timetable_for_yesterday = edupage.get_timetable(yesterday)
print(timetable_for_yesterday)
Get lesson for a given time
from edupage_api import Edupage, EduDate, EduTime
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
# Timetable for today
timetable = edupage.get_timetable(EduDate.today())
# Get current time
current_time = EduTime.now()
current_lesson = timetable.get_lesson_at_time(current_time)
print(current_lesson)
Get next lesson for a given time
from edupage_api import Edupage, EduDate, EduTime
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
# Timetable for today
timetable = edupage.get_timetable(EduDate.today())
# Get current time
current_time = EduTime.now()
next_lesson = timetable.get_next_lesson_at_time(current_time)
print(next_lesson)
The EduLesson
class provides some information about the lesson:
EduLesson
:
period
: The order of period in timetable (e.g. 1).name
: The subject of this lesson.teacher
: The teacher that will teach this lessonclassroom
: The classroom number where the lesson will be.length
:EduLength
–> The length (start and end times) of the lesson.online_lesson_link
: A string with link to the online lesson. If this lesson is not online,online_lesson_link
isNone
.
Tell edupage that you are on an online lesson
Useful for automating your presence, because you don't actually have to be on the lesson. You can tell edupage that you are on the current lesson like this:
from edupage_api import Edupage, LessonUtil
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
timetable = edupage.get_timetable(EduDate.today())
next_lesson = timetable.get_next_lesson_at_time(EduTime.now())
if LessonUtil.is_online_lesson(next_lesson):
next_lesson.sign_into_lesson(edupage)
print("You are now 'present' on the next lesson!")
else:
print("The next lesson is not an online lesson!")
Get news from the webpage
Thanks to how Edupage's message system works, you can get recent news from the webpage like this:
from edupage_api import Edupage
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
# Note: if you are not logged in or there was an error, get_news returns None
news = edupage.get_news() # returns a list of EduNews
for message in news:
print(str(message))
Get a list of students
This is an edupage-curated list of students. When students enter the school, they get assigned a number. If anybody changes school, leaves or anything happens with any student, the numbers don't change. It just skips the number.
from edupage_api import Edupage, EduStudent
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
# Note: This list doesn't have to be sorted!
students = edupage.get_students()
# Sort the list by student numbers
students.sort(key = EduStudent.__sort__)
for student in students:
print(f"{student.number_in_class}: {student.fullname}")
Get a list of teachers
This list is not sorted in any way and this library doesn't provide a way to sort it.
from edupage_api import Edupage
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
# Note: This list is not sorted and you cannot sort it with EduStudent.__sort__!
teachers = edupage.get_teachers()
for teacher in teachers:
print(str(teacher))
Get homework
from edupage_api import Edupage
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
homework = edupage.get_homework()
for hw in homework:
print(hw.due_date)
Homework, other than its title and description, provides some more information:
EduHomework
due_date
:EduDate
–> When the homework is duesubject
: The subject which this homework is fromgroups
: If this subject is divided into groups, the target should be here. Needs testingtitle
: The title of the homework message. This is usually what you in a notification in the Edupage app.description
: A detailed description of the homework. (Usually is blank)event_id
: A internal Edupage ID, which can be used to find the event corresponding to this homework. Useless for now.datetime_added
:EduDateTime
–> A date and time when this homework was assigned.
Sending messages
You can send a message to one or multiple people when you have an object that extends EduPerson
from edupage_api import Edupage, EduStudent
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
for student in students:
if student.fullname == "John Smith":
# Ignore the attachments parameter, for some reason attachments do not work
edupage.send_message(student, "Hello John!")
Upload a file to Edupage's cloud
The file will be hosted forever (and for free) on Edupage's servers. The file is tied to your user account, but anybody with a link can view it.
Anyway, Edupage limits file size to 50 MB and the file can have only some extensions. All supported file extensions could be found on this Edupage help site.
from edupage_api import Edupage, EduStudent
from edupage_api.cloud import EduCloud
edupage = Edupage("Subdomain (Name) of your school", "Username or E-Mail", "Password")
edupage.login()
f = open("image.png", "rb")
uploaded_file = EduCloud.upload_file(edupage, f)
link = uploaded_file.get_url(edupage)
print(link)
Upcoming features
- Lunches
- Grades
- Reading your own notifications
- Connecting to the online lessons (with your presence being acknowledged by Edupage)
- Uploading (and hosting) files on the Edupage cloud (if possible)
- Writing messages to other students/teachers
- Make this library available through PyPi
Feel free to suggest any other features! Just open an issue with the Feature Request tag.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for edupage_api-0.9.84-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e4bd585dc02e9a931dd760691c5d8b6e7611eff7536ce1f59dc2e3b6a354ed53 |
|
MD5 | 6d619c2d64ae0adeb9df96050c9aef6e |
|
BLAKE2b-256 | c65d6e5c1ac24d9e397e7cb52f01140407196f134c752896859c4fa25adfa4ea |