Package to automate processing DCF ThankView Assignments
Project description
Process Assignments Package for the DCF ThankView
Initial Author: Mubbie Idoko
Current Maintainer: Mubbie Idoko
Contributors
Description
To manage ThankView for the DCF, it is necessary to take a large spreadsheet that contains details about alumni i.e. "Thank You" video recipients, and divide them into smaller units that can be sent out as assignments.
These smaller units needs to be in two forms, the one used to create the campaigns on ThankView, and the ones sent out to those making the videos.
This package is intended to do all of this so that the ThankView Manager does not need to spend time making the divisions manually.
Guide
The scripts reads a *.csv file containing DCF Assignment Data, a *.csv file containing the student making videos for that assignment, and the date for the assignment.
For the date of the assignment, make sure that it is in the form mmm-dd-yy e.g:
- "mar-1-22" for March 1st, 2022
- "jun-30-20" for June 30th, 2020).
Likewise the date should be valid.
For the assignment file, make sure that these headings exist exactly in the *.csv file (i.e. they are at the top of the file):
- "Entity ID Display"
- "Pref Name Sort"
- "Entity Pref Class Year"
- "Email Pref Address"
- "Salutation"
- "DCF Segment Desc"
For the people making videos, make sure that these headings exist exactly in the *.csv file (i.e. they are at the top of the file):
- "Student Name"
- "Class Year"
- "Email"
If any of the above is not the case, the call will fail and throw an error.
It is also important to ensure that in the directory (folder) where you are maintaining all the DCF ThankView files, you have directories:
- assignments/sends
- assignments/campaigns
Although the script will attempt to create these directories if they do not exist, it is recommended that you create them manually. This way, we reduce the possibilities of having any permissions issues arising.
Usage
# process assignments
$/> process_assignments [-h] --dateOfAssignment mmm-dd-yy --assignmentCSV "ASSIGNMENT_FILE_PATH.csv" --makingVideosCSV "PEOPLE_MAKING_VIDEOS_FILE_PATH.csv"
# help
$/> process_assignments -h
# process assignments short hand
$/> process_assignment -d mmm-dd-yy -a "ASSIGNMENT_FILE_PATH.csv" -p "PEOPLE_MAKING_VIDEOS_FILE_PATH.csv"
description
Process Assignment given the date, *.csv assignment list, and *.csv people making videos list
options
-h, --help show this help message and exit
--dateOfAssignment DATE, -d DATE
date of assignment
--assignmentCSV ASSIGNFILE, -a ASSIGNFILE
csv file with assignment list
--makingVideosCSV PPLEFILE, -p PPLEFILE
csv file with list of people making videos
additional information
This program takes in the date for the assignment.
Formatted in the form "mar-20-22" for March 20, 2022.
It also reads two CSV Files.
The first one contains the list for the assignment
Formatted with columns (exactly):
"Entity ID Display", "Pref Name Sort", "Entity Pref Class Year",
"Email Pref Address", "Salutation", "DCF Segment Desc".
The second file contains a list of the people making videos for this assignment
Formatted with columns (exactly):
"Student Name", "Class Year", "Email"
Where in the form: Mubarak Idoko,23,mubarak.o.idoko.23@dartmouth.edu
All of these have to be correct for it to work properly.
Report Bugs/Issues
If you notice any bugs or issues while using this package, please report the details to Mubbie Idoko.
Contributing
If you are interested in contributing to this project, or other projects aimed to automate the DCF ThankView Management, please go ahead and contact Mubbie Idoko.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for dcf_process_assignments-0.0.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 738d35b2c384bd425f23b946948f0243eedd7b693f86216e450c59d7a285e5d8 |
|
MD5 | 7c348ffe680f583e06610a27d08bbe2b |
|
BLAKE2b-256 | fb4e9137c9ca76d1e374c47ffb0ab1f50717b89e95cdd29aac4d4bc35e23159b |
Hashes for dcf_process_assignments-0.0.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3ea9648eb3621e00deb5224a285d7321d9105ca21514b06e2a5531d72d7feac2 |
|
MD5 | 8489d85d12e25e36c2e508c5f11f5509 |
|
BLAKE2b-256 | a70d1b2d39b96a4d8a9a608f28efcc70c68c28f0a92d4f0145e3cbaafd826cbc |