RAPydity v0.9.1 - RAP Processing Tool

RAPydity is a tool for processing Reasonable Adjustment Plans (RAPs) directly from the PDF files and applying extra time accommodations to Canvas assignments.

Installation

1. Python Installation
   • Make sure Python 3.8 or later is installed on your computer
   • You can download Python from the Software Centre, the Microsoft Store, or directly from python.org
   • During installation, make sure to check "Add Python to PATH"
2. Download and Setup
   • Download RAPydity from the releases page
   • Extract the files to a folder of your choice
   • Open a terminal/command prompt and navigate to the RAPydity folder
   • Create and activate a virtual environment (recommended):
     • Windows: python -m venv venv then venv\Scripts\activate
     • Mac/Linux: python3 -m venv venv then source venv/bin/activate
3. Install Required Libraries
   • With your virtual environment activated, run:
   • Run: pip install PyPDF2 requests tk
   Note: On most systems, tkinter comes pre-installed with Python. If you're using a virtual environment and tkinter is not found, you'll need to install it system-wide:

   • On Ubuntu/Debian: sudo apt-get install python3-tk
   • On Fedora: sudo dnf install python3-tkinter
   • On Windows: Reinstall Python and make sure to select "tcl/tk and IDLE" during installation
4. Run RAPydity
   • With your virtual environment activated, run:
     • Windows: python rapydity.py
     • Mac/Linux: python3 rapydity.py
   • Note: Double-clicking rapydity.py won't work when using a virtual environment, as it would use the system Python instead

Initial Setup

1. On first run, you'll need to:
   • Select a Shared RAP Folder
     • This is where RAP PDFs accessible to all courses will be stored
     • The default location is RAP/ in your home directory
     • You can change this location during setup or later via the course manager
   • Enter your Canvas API access token
     • Go to Canvas → Account → Settings
     • Scroll down to "Approved Integrations"
     • Click "+ New Access Token"
     • Give it a purpose (e.g., "RAPydity")
     • Set an expiry date if desired (optional)
     • Click "Generate Token" and copy the token
     • Paste the token into RAPydity when prompted
     • Important: Save this token somewhere safe as Canvas won't show it again
2. The configuration will be saved in config.ini

Course Management

1. Select a course from the dropdown menu at the top of the window
   • By default, only current courses are shown
   • Uncheck "Show current courses only" to see past courses
2. Click "Manage Courses" to:
   • Refresh the course list from Canvas
   • Configure course-specific RAP folders
   • View all available courses

Viewing Extra Time Data

1. Click "View Extra Time Data" to see all processed RAP information for the current course
2. The viewer shows:
   • Student names and numbers
   • Extra time allocations
3. Click any column header to sort the data
4. This view is read-only - to update data, use "Update from RAP PDFs"

RAP Processing

1. Place RAP PDFs in either:
   • The shared RAP folder (default: RAP/)
   • A course-specific folder (if configured)
2. Click "Update from RAP PDFs" to:
   • Extract student information from RAPs
   • Look up Canvas IDs for new students
   • Save the information to a course-specific CSV file

Applying Extra Time

1. After processing RAPs, click "Apply Extra Time" to:
   • Select specific assignments to modify
   • Apply extra time accommodations based on RAP data
   • Verify student enrollments
2. Quick Action: "Just Do It" Button

   For a streamlined workflow, use the ✓ Just Do It! button to:

   • Update student data from all RAP PDFs in one step
   • Automatically apply extra time to ALL quizzes in the course
   • Get a summary of actions performed

   This is ideal when you want to quickly process all RAPs and apply accommodations to all quizzes without selecting them individually.

3. Extra time is calculated proportionally based on:
   • The student's RAP accommodation (e.g., 30 mins per hour)
   • The quiz's time limit

Application Features

• Course Selection:
  • "Show current courses only" checkbox filters out past courses
  • Course list is automatically sorted alphabetically
• Course Configuration:
  • Use the "Configure Course" button to set course-specific RAP folders
  • Configure individual courses directly from the main screen
• Logging:
  • The log window shows important messages and actions
  • Warnings appear with yellow highlighting
  • Errors appear with red highlighting
  • Use the "Clear Log" button to reset the log display
  • All actions are still recorded in rapydity.log even after clearing
• Data Management:
  • Course-specific RAP folders can be configured via "Manage Courses"
  • Student data is stored in course-specific CSV files
  • Changes are logged for accountability

Troubleshooting

• Common Issues:
  • If a student's RAP isn't being processed:
    • Check that the PDF is readable and contains the required information
    • Verify the format matches: name in Title Case, surname in UPPERCASE, followed by 7-digit student number
    • Ensure the extra time specification is in the format "Extra time XX mins per hour"
  • If Canvas integration isn't working:
    • Verify your API token hasn't expired
    • Check that students are enrolled in the correct course
    • Ensure you have appropriate permissions in Canvas
• Logging and Debugging:
  • Check the log window for immediate feedback
  • More detailed logs are in rapydity.log
  • Use "View Extra Time Data" to verify processed information
• File Access:
  • Ensure you have write permissions for the RAP folders
  • Check that CSV files aren't open in other programs when updating
  • Verify file paths don't contain special characters