blackboard_analysis_tools 0.0.2

Blackboard analysis tools

An analysis automation tool to avoid repetitive task while grading student assignments that have been handed in using the Blackboard learning system.

Usage:

• Download assignment files from Blackboard (e.g. gradebook_ART_EA-38302_Assignment1_2013-06-11-20-50-44.zip).

• Place these .zip files in the “input” folder.

• Run the program: python -m blackboard_analysis_tools.

• Wait… (about 10 seconds when processing around 100MB of assignments) (time will vary).

• Open the “output” folder to see the results (all files sorted per student, a summary, logfile, …).

Installation:

• Download the source and run python setup.py install.

• Python Package available in the Python Package Index at: (coming soon).

• Install using pip: pip install blackboard_analysis_tools.

Limitations:

• Currently only tested on Linux.

• The program was created with other OS users in mind, so it will eventually get full cross-platform support.

License:

If not stated otherwise blackboard_analysis_tools is distributed in terms of the GPLv2 software license. See COPYING in the distribution for details.

Bug reports:

• Jeroen Doggen <[e-mail]>

• Post issues to GitHub http://github.com/jeroendoggen/blackboard-analysis-tools/issues.

What’s happening behind the scenes:

• Scan for .zip files

• Extract the .zip files

• Scan for .txt files (these contain the metadata that describes the student reports/assignments)

• Analyse the .txt files

• Create a folder for each student

• Move all the files to the correct folder (including the filenames that have been ‘mangled’ by Blackboard)

• Write some statistics: a list of all students that have handed something in

• Write a summary of the process: number of students, number of assignments, number of ‘mangled’ files,…

Changelog:

0.0.2:

• Detect ‘mangled’ files

• Statistics: logfile, summary, student list

• using input & output folders

• Code cleanup: pep8, pylint

0.0.1: Basic features

• Extract .zip files

• Create student folders

• Move files to folder