plom-solutions

Plom tools for pushing/pulling solution page images to/from a server

usage: plom-solutions [-h] [--version] {info,upload,get,delete,status,extract,clear} ...

Positional Arguments

command

Possible choices: info, upload, get, delete, status, extract, clear

options

--version

show program’s version number and exit

Sub-commands:

info

Print more information on extracting, uploading and returning solutions.

plom-solutions info [-h]

upload

Upload solution image to the server.

plom-solutions upload [-h] [-s SERVER[:PORT]] [-w PASSWORD] q v image

Positional Arguments

q

The question to upload to

v

The version to upload to

image

The image of the solution.

options

-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.

get

Get solution image from the server.

plom-solutions get [-h] [-s SERVER[:PORT]] [-w PASSWORD] q v

Positional Arguments

q

The question to get

v

The version to get

options

-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.

delete

Delete solution image from the server.

plom-solutions delete [-h] [-s SERVER[:PORT]] [-w PASSWORD] q v

Positional Arguments

q

The question to delete

v

The version to delete

options

-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.

status

Get list of which question/versions have solution-images uploaded

plom-solutions status [-h] [-s SERVER[:PORT]] [-w PASSWORD]

options

-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.

extract

Extract solutions images from solution PDF file. By default it assumes the same structure as the blank papers, or you can pass in solution spec file.

plom-solutions extract [-h] [-u] [-s SERVER[:PORT]] [-w PASSWORD] [solutionSpec]

Positional Arguments

solutionSpec

A simple spec file that describes the solutions. If none given, then one will be auto-generated from the test spec assuming the same structure and saved as solutionSpec.toml.

options

-u, --upload

Do not extract, instead upload already extracted solution images to server.

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-solutions clear [-h] [-s SERVER[:PORT]] [-w PASSWORD]

options

-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.

The plom-solutions command allows you to
  • extract solutions from pdfs

  • upload solution images

  • download a solution image

  • check which questions/versions have solutions

  • reassemble solutions for individual students.

For further information on extracting & uploading solutions, and on returning solutions to students please run plom-solutions info