lanisapi 0.0.2a0

A unofficial python api for Lanis

[README DE] [README EN]

LanisAPI

⚠ Notice

Because the Schulportal Hessen changes quickly and is very fragmented, (like the backwards compability with Linux libraries) can some functions at specifc 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.

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.logout()
    
if __name__ == "__main__":
    main()

More infos at the wiki.

Overview of future Features, Problems and other things here.

How can I help?

1. You can report Problems at Issues.
2. You can suggest Ideas at Issues.
3. Extra nice: 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 shitpile Schulportal Hessen.

The Android-App sph-planner (if you know Kotlin, you can contribute to this app) 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 officialy related to the Schulportal Hessen. It's only a unofficial libray, supported by the community.