plom-create
Plom tools related to producing papers, and setting up servers.
usage: plom-create [-h] [--version]
{status,newspec,validatespec,extra-pages,predictions,rubric,clear}
...
Named Arguments
- --version
show program’s version number and exit
subcommands
Perform tasks related to building tests.
- command
Possible choices: status, newspec, validatespec, extra-pages, predictions, rubric, clear
Sub-commands
status
Information about the server.
plom-create status [-h] [-s SERVER[:PORT]] [-w PASSWORD]
Named Arguments
- -s, --server
Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.
- -w, --password
for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.
newspec
Create new spec file.
plom-create newspec [-h] [--demo] [--demo-num-papers N] [specFile]
Positional Arguments
- specFile
defaults to ‘’testSpec.toml’’.
Default:
'testSpec.toml'
Named Arguments
- --demo
Use an auto-generated demo test. Obviously not for real use
Default:
False- --demo-num-papers
How many fake exam papers for the demo (defaults to 20 if omitted)
validatespec
Parse and verify a test-specification toml file.
plom-create validatespec [-h] [--save] [specFile]
Positional Arguments
- specFile
defaults to ‘’testSpec.toml’’.
Default:
'testSpec.toml'
Named Arguments
- --save
By default the verified spec file is not saved. Pass this to write it to ‘verifiedSpec.toml’.
Default:
False
extra-pages
Make a extra-paper PDF for when anyone needs more space. NOTE: the resulting file is NOT COMPATIBLE with legacy servers (including those in common use in 2023).
plom-create extra-pages [-h]
predictions
Before papers are identified, there can exist various predictions about which paper goes with which individual. “Prenamed” is one example, where names are pre-printed on the ID sheet. Computer vision tools also make predictions based on student ID numbers.
plom-create predictions [-h] (--predictor P | --all | --erase P)
[-s SERVER[:PORT]] [-w PASSWORD]
Named Arguments
- --predictor
Show all predictions by the predictor P.
- --all
Show all predictions.
Default:
False- --erase
Erase all predictions by the predictor P. Caution: think carefully before erasing the “prename” predictor.
- -s, --server
Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.
- -w, --password
for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.
rubric
Add pre-made rubrics to the server. Your graders will be able to build their own rubrics but if you have premade rubrics you can add them here. This tool can also dump the current rubrics from a running server.
plom-create rubric [-h] [--dump FILE] [--demo] [-s SERVER[:PORT]]
[-w PASSWORD]
[rubric_file]
Positional Arguments
- rubric_file
Upload a pre-build list of rubrics from this file. This can be a .json, .toml or .csv file.
Named Arguments
- --dump
- Dump the current rubrics from SERVER into FILE,
which can be a .toml, .json, or .csv file. Defaults to FILE.toml if no extension specified..
- --demo
Upload an auto-generated rubric list for demos.
Default:
False- -s, --server
Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.
- -w, --password
for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.
clear
Clear “manager” login after a crash or other expected event.
plom-create clear [-h] [-s SERVER[:PORT]] [-w PASSWORD]
Named Arguments
- -s, --server
Which server to contact, port defaults to 41984. Also checks the environment variable PLOM_SERVER if omitted.
- -w, --password
for the “manager” user, also checks the environment variable PLOM_MANAGER_PASSWORD.
See help for each subcommand or consult online documentation for an overview of the steps in setting up a server.
Most subcommands communicate with a server, which can be specified on the command line or by setting environment variables PLOM_SERVER and PLOM_MANAGER_PASSWORD.