submissionsync 0.1.0

Create shortcuts to latest submitted MS teams assignment versions

submissionsync

Create shortcuts to the latest submitted assignment versions from a hierarchical student work directory structure.

Overview

submissionsync automates the organization of student submissions by creating shortcuts to only the latest version of each assignment. Perfect for managing large volumes of student work organized in the nested directories produced by "MS Teams Assignments".

Features

• 🔗 Automatic shortcut creation to latest submission versions
• 📁 Intelligent filtering of Student Work directories
• ⚡ Modification time caching for performance
• 🔄 Force rebuild option for rechecking all submissions
• 🐛 Debug mode for troubleshooting
• 📊 Optional directory tree visualization
• 🖥️ Cross-platform Python module (shortcuts on Windows)

Installation

pip install submissionsync

Quick Start

Using Defaults

Run with default paths:

submissionsync

This uses:

• Source: ~/UTC Sheffield
• Output: P:\Documents\Student Work - Latest Submissions

Custom Directories

Specify custom source and output paths:

submissionsync /path/to/student/work /path/to/output

Usage

Command Line Interface

submissionsync [SOURCE] [OUTPUT] [OPTIONS]

Arguments:

• SOURCE: Source directory containing student work (optional, default: ~/UTC Sheffield)
• OUTPUT: Output directory for shortcuts (optional, default: P:\Documents\Student Work - Latest Submissions)

Options:

  --debug          Show detailed processing information
  --show-tree      Display directory tree before processing
  --force          Force recreation of all shortcuts (ignore cache)
  --version        Show version and exit
  --help           Show help message and exit

Examples

# Debug mode with verbose output
submissionsync --debug

# Force rebuild of all shortcuts
submissionsync --force

# Show directory tree and process
submissionsync --show-tree

# Custom paths with options
submissionsync /source/path /output/path --debug --force

Module Usage

Use submissionsync as a Python library:

python -m submissionsync

Available Functions

from submissionsync import (
    mask,                    # Filter mask for relevant directories
    get_latest_mtime,        # Get latest modification time in path
    iter_latest_versions,    # Iterate over latest version folders
    create_symlink_structure # Main function to create shortcuts
)

Directory Structure

The tool expects a structure like: