pymoodle-jku 1.2.0

Description:

pymoodlejku 1.2.0

PyMoodle-JKU Linz
A local python client for accessing the jku moodle page. Passwords aren't sent anywhere except to the official moodle
page https://moodle.jku.at/jku/login/index.php! Optionally you can store them in the local system keyring.
It's also a python library, which you can use in your project.
Table of Contents
Description
Install
Terminal Application
Development
Dependencies and Unittests
Unsupported
Contribution
Planned
Description
What can you do with PyMoodle? A Short Overview.
You can do all this from the commandline and much more:

Download files from moodle videos/pdf/folder/etc. and even Exams as markdown
List all your grades without needing to open the browser and search moodle
List your timetable from moodle.
Password of moodle can be stored in the local system keyring. No need to enter it every time!

Install
pip3 install -U pymoodle-jku
To Download streams, you need ffmpeg installed. Can also be done after installing
pymoodle.
To get autocompletion working add this to your bash .bashrc/.zshrc/....:
eval "$(register-python-argcomplete pymoodle)"
If you are using fish/Tcsh or another shell, have a closer
look here.
Commandline Scripts
The commandline script is called pymoodle.
With pymoodle you can call these Utilities:

download
grades
timeline
config

Just call pymoodle from the terminal to get the Help page.
You will also find everything you need if you call:
pymoodle --help or pymoodle {Utility} --help
Credentials won't be stored anywhere. If the username/password is entered while running Utilities (not with -c), you
will be asked if you want to store your password in the keyring. The Keyring is a local Password Storage where all
passwords are securely stored.
Config
With the config utility you can configure your environment. You can either specify arguments that should be changed (
see pymoodle config --help) or launch the config in interactive mode like this: pymoodle config
Its recommended to configure your environment once if you want. You can also set a default download Path. (which
needs to exist before downloading.)
Download
With the download utility you can download files and exams from moodle. There are multiple ways to select a course. If
you run the pymoodle download without any arguments, you can pick the downloadable courses. But you can also Download
everything from the current semester like this: pymoodle download -a
To download really everything call pymoodle download -a -o. This will also download all older semesters.
Or it's possible to search and download courses, which name includes the word "Logic" or "Daten" like
this: pymoodle download -s Logic -s Daten
To download stuff from old courses specify the -o option, else only running/current courses will be considered. In
interactive mode you can press M or m to load old/more courses.
Only for people who used PyMoodle before
It seems like, Pymoodle had some problems. Thus a lot of not downloaded urls got written to 'urls.txt'. Just delete the
file if you want to try a redownload. Or if you only want to redownload the exams/quizes call:
pymoodle download -e -o
Grades

Grades will launch automatically in interactive mode. It can give you a short overview about your grades, or you can
look at the specific evaluations from a course. Just like {download} it's also possible to use -o for old courses
or -s to search for courses.
Timeline

Timeline shows your next few moodle events from the moodle calendar. The only argument you could specify is the max
limit of events to show (--limits 15).
Development
If you want to run pymoodle locally:
python3 -m pymoodle_jku.pymoodle
There are multiple examples how to use the PyMoodle package. Just look in
the examples folder and start
with moodle_client.py.
There are examples for:

Login
Courses (Data/Section/Urls from a course)
Valuation of a course.
Moodle Calendar
Downloads

Good To Know
Unittests
I have set up multiple unittests, to ensure
that the next releases won't introduce bugs.
Dependencies

argcomplete: Is for commandline auto completion.
cryptography: To encrypt cookies/session key with the users password.
antimarkdown: Converts HTML from Moodle to Markdown
keyring: Saves your password secure locally. (on windows called Credential
Locker)
io-uuid: One of my own packages. Is for creating unique filenames.
lxml: Is to parse HTML.
pick: A simple Terminal Picker.
pytube: For downloads from youtube.
sty: Colors for the terminal. Still needs to be implemented.
urllib3: for parsing urls and so stuff.
requests: for sending requests
requests-futures: A Wrapper around future to send asynchrones requests.
psutil: For getting the network download transfers to check if we should download more.

Unsupported

Downloading of Zoom streams of jku.zoom.us isn't supported for now. If somebody get it working please feel free to do
a merge request.

Contribution
If you want to add something, create an issue and do a pull request.
Install for testing

clones this repo
pip3 install -r requirements.txt

Planned

Log file support
file uploader for assignments

Something that also seems interesting would be a kusss integration:

a kusss integration for checking grades
a kusss integration for registering in courses (so you don't have struggles when the kusss webserver is dying)

I don't really know if I want to integrate or should integrate that, if a few people are interested in that I am more
willing to spend time on it.