IServAPI 0.1.6

Unofficial API for IServ

Unofficial IServ API

This Python module allows you to interact with IServ school servers using only login data for authentication. No API key is required.

Installation

You can install the IServ Python module using pip:

pip install IServAPI

Basic usage

from IServAPI.IServAPI import IServAPI

# Initialize IServ instance with login credentials
iserv = IServAPI(username="YOUR_ISERV_USERNAME",password="YOUR_ISERV_PASSWORD", iserv_url="some_iserv_url.de")

# Example: Get the current user's information
user_info = iserv.get_own_user_info()
print(user_info)

Supported Functionality

1. Get own User Information

user_info = get_own_user_info()

This method retrieves information about the currently logged-in user.

2. Set own User Information

set_own_user_info(key=value)

This method sets your personal information

Available keys are:

title

company

birthday

nickname

_class

street

zipcode

city

country

phone

mobilePhone

fax

mail

homepage

icq

jabber

msn

skype

note

3. Get user avatar

get_user_profile_picture(user, output_folder)

This method retrieves the avatar of any user on the network

It saves the avatar in the folder followed by the username,

4. Get emails

emails = get_emails(path = 'INBOX', length = 50, start = 0, order = 'date', dir = 'desc')

Retrieves emails from a specified path with optional parameters for length, start, order, and direction.

5. Search users

search_users()

NOT YET IMPLEMENTED

6. Search users autocomplete

users = search_users_autocomplete(query, limit=50)

Faster than search_users() but may not display all users

7. Fetch notifications

notifications = get_notifications()

Retrieves notifications from the specified URL and returns them as a JSON object.

8. Get general Information about emails

email_info = get_email_info(path="INBOX", length=0, start=0, order="date", dir="desc")

Retrieves email information from the specified path in the mailbox. For example: unread emails.

9. Get email source

email_source = get_email_source(uid, path="INBOX")

Retrieves the source code of an email message from the specified email path and message ID.

10. Get all mail folders

mail_folders = get_mail_folders()

Retrieves the list of mail folders.

11. Get upcoming events

events = get_upcoming_events()

Retrieves the upcoming events from the IServ calendar API.

12. Get all eventsources

eventsources = get_eventsources()

Retrieves the event sources from the calendar API.

13. Get conference health

health = get_conference_health()

Get the health status of the conference API endpoint.

14. Get badges

badges = get_badges()

Retrieves the badges from the IServ server. (Badges=numbers on sidebar)

15. Files

client = file()

Possible functions:

Synchronous methods

# Checking existence of the resource

client.check("dir1/file1")
client.check("dir1")

# Get information about the resource

client.info("dir1/file1")
client.info("dir1/")

# Check free space

free_size = client.free()

# Get a list of resources

files1 = client.list()
files2 = client.list("dir1")

# Create directory

client.mkdir("dir1/dir2")

# Delete resource

client.clean("dir1/dir2")

# Copy resource

client.copy(remote_path_from="dir1/file1", remote_path_to="dir2/file1")
client.copy(remote_path_from="dir2", remote_path_to="dir3")

# Move resource

client.move(remote_path_from="dir1/file1", remote_path_to="dir2/file1")
client.move(remote_path_from="dir2", remote_path_to="dir3")

# Move resource

client.download_sync(remote_path="dir1/file1", local_path="~/Downloads/file1")
client.download_sync(remote_path="dir1/dir2/", local_path="~/Downloads/dir2/")

# Unload resource

client.upload_sync(remote_path="dir1/file1", local_path="~/Documents/file1")
client.upload_sync(remote_path="dir1/dir2/", local_path="~/Documents/dir2/")

# Publish the resource

link = client.publish("dir1/file1")
link = client.publish("dir2")

# Unpublish resource

client.unpublish("dir1/file1")
client.unpublish("dir2")

# Exception handling

from webdav.client import WebDavException
try:
...
except WebDavException as exception:
...

# Get the missing files

client.pull(remote_directory='dir1', local_directory='~/Documents/dir1')

# Send missing files

client.push(remote_directory='dir1', local_directory='~/Documents/dir1')

Asynchronous methods

# Load resource

kwargs = {
 'remote_path': "dir1/file1",
 'local_path':  "~/Downloads/file1",
 'callback':    callback
}
client.download_async(**kwargs)

kwargs = {
 'remote_path': "dir1/dir2/",
 'local_path':  "~/Downloads/dir2/",
 'callback':    callback
}
client.download_async(**kwargs)

# Unload resource

kwargs = {
 'remote_path': "dir1/file1",
 'local_path':  "~/Downloads/file1",
 'callback':    callback
}
client.upload_async(**kwargs)

kwargs = {
 'remote_path': "dir1/dir2/",
 'local_path':  "~/Downloads/dir2/",
 'callback':    callback
}
client.upload_async(**kwargs)

For further informations visit CloudPolis/webdav-client-python

To-Do List

• Add propper To-Do List

Contribution

Contributions are welcome! If you'd like to contribute to this project, please fork the repository and submit a pull request. Make sure to follow the existing code style and add appropriate tests for new functionality.

License

This project is licensed under the MIT License - see the LICENSE file for details.