Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Blackboard analysis tools

Project description

# Blackboard Analysis Tool
An analysis automation tool to avoid repetitive tasks while grading student assignments that have been handed in through the Blackboard learning system.

For example:
* Extract hundreds of .zip files
* Sort the files per assignment, student
* Create statistics: number of students, late assignments,...

## Usage:
* Download assignment files from Blackboard (e.g.
* 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:
* Install using pip: ``pip install blackboard_analysis_tools``. (Linux & Windows)
* Python Package available in the Python Package Index at:
* Download the source and run ``python install``.

## Limitations:
* Currently only tested on Linux & Windows7
* 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 MIT license.
See LICENSE in the distribution for details.

## Bug reports:
* Post issues to GitHub

## What is happening behind the scenes:
1. Scan for .zip files
2. Extract the .zip files
3. Scan for .txt files (these contain the metadata that describes the student reports/assignments)
4. Analyse the .txt files
5. Create a folder for each student
6. Move all the files to the correct folder (including those with filenames that have been 'mangled' by Blackboard)
7. Write some statistics: a list of all students that have handed something in
8. Write a summary of the process: number of students, number of assignments, number of 'mangled' files,...

## Changelog:
* Windows compatible
* Modified the default analysis options to 'AP University College'

* Cleanup temp folders
* Debug code for timing analysis
* Parallel processing (no speedup)
* Python 3.3 compatible
* Partially Windows compatible
* Sorting output folders
* Print build summary
* Detect late files

* 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

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for blackboard_analysis_tools, version 0.0.4
Filename, size File type Python version Upload date Hashes
Filename, size blackboard_analysis_tools-0.0.4.tar.gz (7.1 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page