Skip to main content

pTyX is a python precompiler for LaTeX.

Project description

pTyX MCQ Extension

Disclaimer: installation is broken for now (work in progress...)

If you're interested, please wait a few months before it becomes fully usable.

(For now, the following document is only a draft documenting future usage.)


pTyX is a LaTeX precompiler, written in Python. pTyX enables to generate LaTeX documents, using custom commands or plain python code. One single pTyX file may generate many latex documents, with different values. I developed and used pTyX to make several versions of a same test in exams, for my student, to discourage cheating. Since it uses sympy library, pTyX has symbolic calculus abilities too.

The pTyX MCQ extension makes it easy to use pTyX to generate Multiple Choice Questions as pdf documents. The students MCQ can then be scanned and automatically corrected and scored.


Obviously, pTyX needs a working Python installation. Python version 3.8 (at least) is required for pTyX MCQ to run.

Currently, pTyX is only supported on GNU/Linux.

The easiest way to install it is to use pip.

$ pip install --user ptyx_mcq


To generate a template, run:

$ mcq new new_folder

This will generate a new_folder/new.ptyx file, which is the main configuration file.

This will also create a new_folder/questions/ folder, where you should put all the exercises, as .txt files.

See the next section (MCQ file format) for more information about those files format.

To compile the template, run:

$ mcq make

For more options:

$ mcq make --help

To automatically corrected the scanned students MCQs, but them as a pdf inside new_folder/scan.

Then run:

$ mcq scan

MCQ file format

When running mcq new, a template folder will be generated, including a new.ptyx file.

(More to come...)

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ptyx_mcq-22.3.1.tar.gz (410.1 kB view hashes)

Uploaded source

Built Distribution

ptyx_mcq-22.3.1-py3-none-any.whl (413.9 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page