Unofficial API to interface with OurVle through python

pip install OurvleApi

from OurvleApi import ourvle

• View and read news
• Get help information
• login

• View all your courses
• Get detailed information about your courses, including the lecturers, resources. news and links

• Returnts a list of News objects (sourced from the front page)

news_list = ourvle.news()

• Prints a string of helpful information

• Accepts strings for username and password
• Returns a Client object
• Prints the name of the user

client = login(username,password)
  ==> Alexander McIntosh

• Returns a session object with the necessary cookies to traverse the website

• Returns a list of Course objects

my_courses = client.course_list
print(my_courses)
  ==> [COMP1161, COMP1210,...]
print(my_courses[1])
  ==> COMP1210 | S2_2022/23 Mathematics for Computing ['Fake Name', 'Faker Name']

• Returns a string of the name of the current user

client.user
  ==> Alexander McIntosh

• Returns a string of the course name

test_course = my_courses[1]
test_course.name
  ==> S2_2022/23 Mathematics for Computing

• Returns a string of the course code

test_course.code
  ==> COMP1210

• Returns a string of the link to the course page

  ==> https://ourvle.mona.uwi.edu/course/....

• Returns a list of dictionaries with the course teachers' information

test_course.teachers
  ==> [{'role': 'Lecturer', 'name': 'Fake Name', 'profile_link': 'https://ourvle.mona.uwi.edu/user....'}, {'role': 'Tutor', 'name': 'Faker Name', 'profile_link': 'https://ourvle.mona.uwi.edu/user....'}]

• returns a list of dictionaries with the course resources organized by topic (or section)

test_course.resources()
  ==> [{'section_name': 'NOTICE', 'resources': [Course Outline File, TEXTBOOK (New Elementary Approach to Japanese)  Units 1-2 File, Textbook Units 1-5 File,...]}...]

• returnsa a list of dictionaries with the course links organized by topic (or section) including links to online classes.

test_course.links()
  ==> [{'section_name': 'General', 'links': []}, {'section_name': 'COURSE OUTLINE', 'links': []}, {'section_name': 'ZOOM ONLINE TEACHING CORNER', 'links': [{'name': 'ZOOM LECTURES  (ONLINE) - Mona and WJC_Tuesdays', 'link': 'https://ourvle.mona.uwi.edu/....}]

• Returns a list of dictionaries with information in blocks located around the course page (if any)

test_course.blocks()
  ==> []

• Returns a list of dictionaries with information about items in the course news block (if any)

test_course.news()
  ==> [{'date': '31 Jan, 21:55', 'author': Fake Name, 'topic': 'ONLINE Tutorial', 'link': 'https://ourvle.mona.uwi.edu/...}]

• Returns a string with the name of the Resource

resource.name
  ==> 'Course Outline File'

• Returns a string with the Resource details

resource.details
  ==> '15KB Word document'

• Returns a string with the link to the resource

resource.link
  ==>'https://ourvle.mona.uwi.edu/mod/resource/view....'

• Downloads the resource
• If no name is passed, uses the resource name
• File extension should not be included when passing the name

resource.download("outline")

• Returns the topic of the news post as a string

test_news = news_list[0]
test_news.topic
  ==> 'Unavailability of UWI Mona ICT Services; December 28 - 31, 2022'

• Returns the author of the news post as a string

test_news.author
  ==> 'OurVle Administrator'

• Returns the date the news was posted as a string

test_news.date
  ==>'Tue, 27 Dec 2022, 1:32 PM'

• Returns the link to the news post as a string

test_news.link
  ==> 'https://ourvle.mona.uwi.edu/mod/forum/....'

• Reuturns the content of the news post as a string

test_news.content()
  ==> 'TO WHOM IT MAY CONCERN\n\xa0\nGood day.\nAs per a Mona Messaging announcement sent on Dec.... Regards,'

This API is not affiliated with, endorsed by, or sponsored by the University of the West Indies (UWI) or OurVle. The information provided through this API is intended for educational and informational purposes only and is not guaranteed to be accurate or up-to-date. The University of the West Indies and OurVle are the sole owners of all rights, title, and interest in OurVle. Use of this API is subject to the terms and conditions outlined by the University of the West Indies and OurVle. By using this API, you agree to indemnify and hold harmless the University of the West Indies and OurVle for any and all claims arising from your use of this API.