RAPydity v2.0.0 - RAP Processing Tool

RAPydity is a tool for processing Reasonable Adjustment Plans (RAPs) and applying extra time accommodations to Canvas assignments. As of v2.0, RAP data is read from a single CSV file rather than individual PDF files.

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:
   • 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
   • Select the RAP CSV File
     • In the RAP view of your ServiceNow portal, click on "personalize fields" (red arrow) and make sure that "Exam Time" is included, together with "Student Name" and "Student ID".
     • Export the data as a CSV file and save it somewhere convenient.
     • The CSV file should contain the columns:
       • u_student_id - Student number prefixed by "C" (e.g., "C3472571")
       • u_exam_time - Extra time allocation (e.g., "10 mins/hr.")
       • u_requested_for1 - Student's full name
     • You can optionally select this file during initial setup, or you will be prompted on startup
     • You can change the file at any time using the "Change RAP File..." button
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
   • 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 CSV"

RAP Processing

1. From CSV (Primary Method)
   • Ensure the RAP CSV file is selected (see Initial Setup above, or use "Change RAP File...")
   • Click "Update from RAP CSV" to:
     • Read student accommodations from the RAP CSV
     • Filter to only students enrolled in the selected course
     • Look up Canvas IDs for new students
     • Save the information to a course-specific data file
2. From PDFs (Legacy Fallback)
   • If RAP data is provided as individual PDF files, click "Update from RAP PDFs"
   • You will be prompted to select the folder containing the PDF files
   • PDFs are parsed for student name, number, and extra time allocation

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 the RAP CSV 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., 10 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
• RAP File Management:
  • Use "Change RAP File..." to select a different RAP CSV file at any time
  • The selected file path is remembered across sessions
  • If the file is not found on startup, you will be prompted to select a new one
• 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:
  • Student data is stored in course-specific CSV files
  • Changes are logged for accountability

Troubleshooting

• Common Issues:
  • If students aren't being found from the RAP CSV:
    • Check that the CSV file contains the required columns: u_student_id, u_exam_time, u_requested_for1
    • Verify that u_student_id values are in the format "C" followed by a 7-digit number (e.g., "C3472571")
    • Ensure u_exam_time contains a number for students who need extra time (e.g., "10 mins/hr.")
    • Students with empty u_exam_time or "No additional time required." are automatically skipped
  • 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
  • If using legacy PDF processing:
    • 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"
• 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 the RAP CSV file is accessible and not locked by another program
  • Check that course data CSV files aren't open in other programs when updating
  • Verify file paths don't contain special characters