Metadata-Version: 1.0
Name: blackboard_analysis_tools
Version: 0.0.3
Summary: Blackboard analysis tools
Home-page: none
Author: Jeroen Doggen
Author-email: jeroendoggen@gmail.com
License: LGPL-v2
Description: Blackboard Analysis Tool
        ========================
        
        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 <jeroendoggen@gmail.com>
         * 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
        
Platform: Linux
