Skip to main content

Python wrapper for moodle web service.

Project description

moodlepy

PyPi Package Version Supported Python versions LICENSE Tests codecov pre-commit Mypy

Python wrapper for moodle web service.

Introduction

This library provide a pure Python interface for Moodle Web Service. It's compatible with Python versions 3.6+

Installing

You can install or upgrade moodlepy with:

pip install moodlepy --upgrade

Or you can install from source with:

git clone https://github.com/hexatester/moodlepy
cd moodlepy
python setup.py install

Usage

Example usage

from moodle import Moodle
url = 'https://my.domain/webservice/rest/server.php'
token = 'super secret token'
moodle = Moodle(url, token)
raw_site_info = moodle('core_webservice_get_site_info')
site_info = moodle.core.webservice.get_site_info()  # return typed site_info

print(raw_site_info)
print(site_info)

# or
from moodle import Mdl
from moodle.core.webservice import BaseWebservice

moodle = Mdl(url, token)
webservice = BaseWebservice(moodle)
site_info2 = webservice.get_site_info()

assert site_info == site_info2

❗️ If the function area does not have a type in the support table, the return value is in accordance with the Moodle web service documentation, wich mostly dict.

In the near future all of Web service functions will be covered by moodlepy.

Moodle Web Service support

❗️ Not all types and methods are supported, since moodlepy is not yet released. (A = Added.)

Area Functions Types Tests Status
auth_email A A
block A A
core_auth A A
core_backup A A
core_badge A A A
core_blog A A A
core_calendar A A
core_cohort A A
core_comment
core_competency
core_completion A A
core_course
core_customfield A A
core_enrol
core_fetch
core_files
core_filters
core_form
core_get
core_grade
core_grades
core_grading
core_group
core_h5p
core_message A
core_notes A A
core_output
core_question
core_rating
core_role
core_search
core_session
core_tag
core_update
core_user
core_webservice A A A A
enrol_guest A A
enrol_manual A A
enrol_self A A
gradereport_overview
gradereport_user
gradingform_guide
gradingform_rubric
local_mobile
message_airnotifier
message_popup
mod_assign
mod_book
mod_chat A
mod_choice
mod_data A
mod_feedback
mod_folder A A
mod_forum
mod_glossary
mod_imscp
mod_label
mod_lesson
mod_lti
mod_page A A
mod_quiz
mod_resource A A
mod_scorm
mod_survey
mod_url A A
mod_wiki
mod_workshop A
report_competency
report_insights
tool_analytics
tool_lp
tool_mobile A A
tool_templatelibrary
tool_usertours
tool_xmldb

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

moodlepy-0.22.2.tar.gz (77.4 kB view hashes)

Uploaded Source

Built Distribution

moodlepy-0.22.2-py3-none-any.whl (141.5 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page