lanisapi 0.1.0

A unofficial python api for Lanis

[README DE] [README EN]

LanisAPI

⚠ Notice

Because the Schulportal Hessen changes quickly and is very fragmented, can some functions at specific schools or after a time not be working anymore.

What is this?

It's an unofficial Python library for the Schulportal Hessen. Also available on PyPi.

Features

• Fetch homework
• Fetch substitution plan
• Fetch calendar data

Overview of future Features, Problems and other things here.

How do I install it?

pip install lanisapi

Required is Python 3.11. (older versions should definitely work too but I didn't tested it.)

Example

This example gives the substitution plan.

from lanisapi import LanisClient

def main():
    client = LanisClient("schoolid", "name.lastname", "password")
    client.authenticate()
    print(client.get_substitution_plan())
    client.close()
    
if __name__ == "__main__":
    main()

More infos at the wiki.

How can I help?

1. You can report Problems at Issues.
2. You can suggest Ideas at Issues.
3. Contributing: You can contribute to this project. If you're new to contributing, look here.

Credits

The Javascript project SPHclient from @alessioC42 helped me to understand the Schulportal Hessen.

The Android-App sph-planner from @koenidv helped me to understand the Level 2 encryption.

Other projects that didn't helped me but are cool:

• Flutter Android app SPH-Vertretungsplan also from @alessioC42
• Javascript app SchulportalApp from DerOwnerHD
• Flutter Android app lkwslr-sphplaner from flutter-preview
• TypeScript library Maria from Elderguardian

Notice

This project isn't officially related to the Schulportal Hessen. It's only a unofficial library, supported by the community.