Metadata-Version: 2.1
Name: ptyx-mcq
Version: 22.2
Summary: pTyX is a python precompiler for LaTeX.
Home-page: https://github.com/wxgeo/ptyx
License: GPL-3.0-or-later
Keywords: python,tikz,latex,pdf,exam,mcq,student
Author: Nicolas Pourcelot
Author-email: nicolas.pourcelot@gmail.com
Requires-Python: >=3.8,<4.0
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Requires-Dist: Pillow (>=9.1.1,<10.0.0)
Requires-Dist: numpy (>=1.23.0,<2.0.0)
Requires-Dist: pdf2image (>=1.16.0,<2.0.0)
Requires-Dist: sympy (>=1.10.1,<2.0.0)
Project-URL: Repository, https://github.com/wxgeo/ptyx
Description-Content-Type: text/markdown

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

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

Installation
------------

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

Usage
-----

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

