Configuration

The operation of pyAutoMark is highly customisable with a number of parameters that can be set either at the toplevel, in the top level pyAutoMark.json file, or for each cohort in the manifest.json file in the cohort directory. These json files can be edited manually, or the parameters may be set using the config command.

Configuration Keys may be in a ‘.’ format e.g. 2022.assessor.username sets assessor.username in cohort 2022. global name may be used to set global parameters across all cohorts (unless set locally).

Configuration Parameters

The heirarchical list of configurable parameters is given below.

assessor
email

assessor’s email address

name

assessor’s name

course
code

code for module/course

name

title for module/course

institution
name

name of institution

department

name of department

domain

domain to add to usernames for email

github
url

url for organisation on github (if applicable)

assignment

Title of github assignment (prefix for student repositories)

branch

Name of default branch to use in student’s repositories - default: ‘main’

fixtures

(list) List of pytest fixture sets to use

path
tests

(Path) file path to tests - default: ‘tests’

build

(Path) file path to build directory for temporary files - default: ‘build’

cohorts

(Path) file path to directory for cohort/student submissions - default: ‘cohorts’

reports

(Path) file path for reports - default: ‘reports’

deadline

(datetime) deadline for assessment submission

student-folder-name

What field to use for students folder name - default: ‘username’

filematch
pattern

How to match/search for students files - one off exact, glob or regexp. - default: ‘glob’

solution
username

Username for ‘solution’ student in cohort

workbook

Name/relative path to students workbook for xlsx fixtures

student-column
studentid

The column to read for studentid - default: ‘(?i)Students*ID’

username

Column to read for students username - default: ‘(?i)Username’

lastname

Column to read for students last (family) name - default: ‘(?i)Lasts*name’

firstname

Column to read for students first (given) name - default: ‘(?i)Firsts*name’

course

Column to read specifying which course student is on (if different from default) - default: ‘(?i)Child Course ID’

github-username

Column to read for the students username on github - default: ‘(?i)Github Username’

submission-date

Column name to use to record submission dates - default: ‘Submission Date’

extension

Column name to use for student extensions - default: ‘Extension’

mark-column
studentid

Column name in marking csv file with student id - default: ‘#Cand Key’

mark

Column name in marking csv file for mark - default: ‘Mark’

template
report

Name of cell in marking template for report - default: ‘report’