Your Moodle butler who gives usage reports from activity logs.

This is designed to work with UCL's Moodle implementation. It is not tested anywhere else.

Contact [email protected] for enquiries.

• pandas : for data analysis.
• plotly : for plotting.

To install, use:

pip install mootler

If you get the error message: ERROR: Could not find a version that satisfies the requirement pandas (from mootler), you will have to install pandas manually with:

pip install pandas

then try again.

Here is an example command:

moot activity.csv -u students.csv -s Potions -i -p

• activity.csv: Activity log for your module. It is recommended to filter for "participation" type activities.
• -u students.csv: (Optional) User list downloadable from Moodle. Only the users in the list will be considered, this way you can e.g. exclude tutor activity from your analysis.
• -s Potions: (Optional) Filter by "Event context". Just include a substring of what you care about, so if you want to see how many people have clicked on "File 2: Potions", you can just write Potions as long as no other activity contains the word.
• -i: (Optional) Save a list of inactive users as a csv file called inactive.csv by default.
• -p: (Optional) Plot the activity as a histogram by user.

The resulting plots are html and interactive. Here is a screenshot:

There is also a utility called moot_enrol which takes a user list as formatted by Portico, and turns it into a format suitable for Moodle bulk enrol:

moot_enrol portico.csv Charms -o bulk.csv

• portico.csv: A csv file of module participants downloaded from Portico.
• Charms: The name which will populate the 'Group' column, creating a group on Moodle.
• -o bulk.csv: (Optional) Name of the ouptut file. Otherwise, in this case, it would be portico_enrol.csv

Any contributions are welcome! Please ensure that your pull requests pass testing and include their own tests for new features. We use pytest.