magister-tools v1.1.0

intro

The goal of this module is to make getting grades and other data from magister easier. Getting grades from Magister using Magister.js (v1) is a mess in my opinion. For my personal use I needed a way to get the average grades of students and this module does just that.

I am open to any suggestions.

Contents

• Installation
• Example usage
• Documentation
• Suggestions
• License & Disclaimer

Installation

Using npm:

Install the npm package

npm install magister-tools

Cloning github source code:

1: Clone the source code.

git clone https://github.com/skillzzjesse/magister-tools.git

2: install the dependencies.

npm install

3: Profit??

Example usage

var magister_tools = require('magister-tools');

magister_tools.magisterLogin({
   school: 'xxxx' || {url: 'xxxx'},
   username: 'xxxx',
   password: 'xxxx'
}, function (err, magisterlogin) {
   if (err) {
      // Handle error..
   }
   // This is the callback function.
   // What to do when logged in to Magister.

   // Get the current course for the logged in user.
   magister_tools.fetchCurrentCourse(magisterlogin, function (err, course) {
      if (err) {
         // Handle error..
      }   
      // What to do when we have the current course for the logged in user.


      magister_tools.fetchGrades(course, function (err, grades) {
         if (err) {
            // Handle error...
         }
         // What to do when we've got the grades for the current course of the logged in user.

         // Select the endgrades (avarage grades) from this list of grades.
         var endgrades = magister_tools.selectEndGrades(grades);

         /*=======================================================
           ******************************************************
               Now do whatever you want with these endgrades.
           ******************************************************
           =======================================================*/
      })
   })
}, function () {
   // What to do before logging in to Magister.
   // This is optional but can be useful, for example:
   // log something to the console indicating you're trying to login.
});

Or use the (new) shortcut function

var  magister_tools = require('magister-tools');

var login = {
  school: 'xxxx' || {url: 'xxxx'},
  username: 'xxxx',
  password: 'xxxx'
}

magister_tools.fetchEndGrades(login, function (err, endGrades) {
  if (err) {
    // Handle the error
  }

  /* Do something with the endGrades, for example log them */
  console.log(endGrades);

}, function () {
  // What to do before logging in to Magister.
  // This is optional but can be useful, for example:
  // log something to the console indicating you're trying to login.
})

Documentation

Contents

• magisterLogin()
• fetchCurrentCourse()
• fetchGrades()
• selectEndGrades()

Shortcut functions

• fetchEndGrades()

magisterLogin(settings, callback, doFirst)

This function logs into magister using MagisterJS.

fetchCurrentCourse(magisterlogin, callback)

This function fetches the current course for the logged in user.

fetchGrades(course, callback)

This function fetches the grades for the course of the logged in user.

selectEndGrades(grades, settings)

This function selects the endgrades from a list of grades. ⇒ Object
Returns: Object - endgrades An object structured like this:

{ class: endGrade }
// For example (with default settings)
{EN: 7.9, WB: 6.5}  

Shortcut functions

The Goal of this module is to write less and do more! The normal way you would use this module will result in quite a lot of code still. See the example.
Shortcut functions allow you to write even less code and still get the desired results.

fetchEndGrades(settings, callback, doFirst)

This function fetches the endgrades from magister for a specified user.

Note that this is a shortcut function designed to make using this module just a little easier.
However, it has less customizability since the function will use default settings in the selectEndGrades function.
Also tracking where an error occurred while getting the data from Magister isn't possible.

Returns: Object - endgrades An object structured like this: (Note that it will return via the callback)

{ class: endGrade }
// For example (with default settings)
{EN: 7.9, WB: 6.5}  

Suggestions

This module is in a very early state and does not have a lot of functionality yet. Any suggested features are more than welcome. If you have an awesome feature in mind please open an issue.

License & Disclaimer

This module is open-sourced under the MIT Licence (see LICENSE for the full license). So within some limits, you can do with the code whatever you want.

The software is provided as is. It might work as expected - or not. Just don't blame me.