Metadata-Version: 2.1
Name: OurvleApi
Version: 0.3.1
Summary: Unofficial module for Ourvle
Home-page: https://github.com/Alexcmad/OurvleScraper
Author: Alexander McIntosh
Author-email: mcintoshalexander80@gmail.com
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# OurvleApi
Unofficial API to interface with OurVle through python

## Getting Started:
##### Install package with pip
```
pip install OurvleApi
```
##### Import the package
```
from OurvleApi import ourvle
```
# Features:
#### Without Login
- View and read news
- Get help information
- login
#### With Login:
- View all your courses
- Get detailed information about your courses, including the lecturers, resources. news and links

## Functions:
### Without Login

##### ourvle.news()

- Returnts a list of News objects (sourced from the front page)
```
news_list = ourvle.news()
```

##### ourvle.help()

- Prints a string of helpful information

##### ourvle.login(username,password)

- Accepts strings for username and password
- Returns a Client object
- Prints the name of the user
```
client = login(username,password)
  ==> Alexander McIntosh
```

### With Login
#### Client:

##### Client.session
- Returns a session object with the necessary cookies to traverse the website

##### Client.course_list
- 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']
```

##### Client.user
- Returns a string of the name of the current user
```
client.user
  ==> Alexander McIntosh
```

### Course:
##### Course.name
- Returns a string of the course name
```
test_course = my_courses[1]
test_course.name
  ==> S2_2022/23 Mathematics for Computing
```
##### Course.code
- Returns a string of the course code
```
test_course.code
  ==> COMP1210
```
##### Course.link
- Returns a string of the link to the course page
```
  ==> https://ourvle.mona.uwi.edu/course/....
```
##### Course.teachers
- 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....'}]
```
##### Course.resources()
- 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,...]}...]
```
##### Course.links()
- 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/....}]
```
#### (experimental)
##### Course.blocks()
- Returns a list of dictionaries with information in blocks located around the course page (if any)
```
test_course.blocks()
  ==> []
```
##### Course.news()
- 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/...}]
```
### Resource
##### Resource.name
- Returns a string with the name of the Resource
```
resource.name
  ==> 'Course Outline File'
```
##### Resource.details
- Returns a string with the Resource details
```
resource.details
  ==> '15KB Word document'
```
##### Resource.link
- Returns a string with the link to the resource
```
resource.link
  ==>'https://ourvle.mona.uwi.edu/mod/resource/view....'
```
##### Resource.download(*name)
- 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")
 ```
### News:
##### News.topic
- 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'
```
##### News.author
- Returns the author of the news post as a string
```
test_news.author
  ==> 'OurVle Administrator'
```
##### News.date
- Returns the date the news was posted as a string
```
test_news.date
  ==>'Tue, 27 Dec 2022, 1:32 PM'
```
##### News.link
- Returns the link to the news post as a string
```
test_news.link
  ==> 'https://ourvle.mona.uwi.edu/mod/forum/....'
```
##### News.content()
- 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,'
```
# DISCLAIMER: 
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.

