Skip to main content

A tool to convert automultiplechoice quizz to moodle questions

Project description

amc2moodle

pypi release License: GPL v3 CI-Ubuntu CI-Mac-OS

amc2moodle, is a suite of tools to convert multiple choice questionnaires (MCQ)

The conversion supports equations, tables, figures and standard text formatting. This software is written in python and in XSLT, thus the conversion step is OS independent. It has been tested for moodle 3.x or 4.x and auto-multiple-choice (v1.0.3-v1.5).

Note that auto-multiple-choice (amc) LaTeX format is very convenient, and can be used for preparing multiple choice questions off-line and avoiding moodle web GUI.

Installation

A Docker image with amc2moodle and its dependencies is available at ghcr.io/nennigb/amc2moodle. Once the docker software is installed, this image allows to use amc2moodle on windows plateforms or to add the resource isolation features on linux or macOS. For more information, see the amc2moodle' docker README. To install amc2moodle as a python package on linux or macOS platform, follow the steps below.

Before installing amc2moodle:

  • install python (version >=3.5)
  • install imageMagick, useful to convert image files (*.eps, *.pdf, ...) into png
    • Ubuntu: sudo apt-get install imagemagick
    • MacOS: brew install imagemagick (see ImageMagick website for more details )
  • install LaTeXML [tested with version >= 0.8.1] This program does the first step of the conversion into XML
    • Ubuntu: sudo apt-get install latexml
    • see also LaTeXML wiki or install notes that all the dependencies are installed (perl, latex, imagemagick).
  • install xmlindent [optional]. This program can be used to indent well the XML file
    • Ubuntu: sudo apt-get install xmlindent
    • MacOS: not necessary. Script will use xmllint natively available on MacOS.

For MacOS users, most dependencies can be installed with brew but LaTeXML installation can failed for some version. Please see the steps given in the install script workflow.

Install with pip

Run

pip install amc2moodle

pip will download automatically the required files.

or if you have download the sources, run

pip install .

in the root folder (where setup.py is). This will automatically install other dependencies i.e., lxml, and Wand. Alternatively, you can run

pip install -e .

to install it in editable mode, useful if git is used.

Note: for Ubuntu users use pip3 instead of pip for python3.

Uninstallation

Run

pip uninstall amc2moodle

Conversion

The program can be run in a shell terminal, for instance to convert an amc LaTeX file to moodle XML

amc2moodle input_Tex_file.tex -o output_file.xml -c catname

Help and options can be obtained using

amc2moodle -h

Then on moodle, go to the course administration\question bank\import and choose 'moodle XML format' and tick: If your grade are not conform to that you must use: 'Nearest grade if not listed' in import option in the moodle question bank (see below for details). Examples of the amc2moodle possibilities are given at QCM.pdf

If your original exam uses AMC-TXT syntax, you must first convert it to LaTeX before feeding it to amc2moodle. To convert an AMC-TXT file to LaTeX, generate the exam documents with AMC graphical interface as usual. AMC will generate a LaTeX version of your exam called DOC-filtered.tex inside the project directory, which you can pass to amc2moodle.

In the same way, conversion from moodle XML to amc LaTeX file, run

moodle2amc input_XML_file.xml

Help and options can be obtained using

moodle2amc -h

Then the output LaTeX can be edited and included for creating amc exams. Examples of the moodle2amc possibilities are given here.

Troubleshooting

In case of problem, do not hesitate to ask for help on discussions or to create an issues. Both binaries (amc2moodle and moodle2amc) write full log in log files based on the name of the input file (_amc2moodle.log and _amc2moodle.log suffixes are added on these files).

  • 'convert: not authorized..' see ImageMagick policy.xml file see here
  • bugs with tikz-LaTeXML in texlive 2019/2020: please update the following perl modules Parse::RecDescent, XML::LibXML and XML::LibXSLT here with cpan or cpanmin CLI.
  • If LaTeXML doesn't know some LaTeX package and return Warning:missing_file:package-name Can't find binding for package package-name, you can try to invoque amc2moodle with --includestyles flag.

Related Project

  • auto-multiple-choice, is a piece of software that can help you creating and managing multiple choice questionnaires (MCQ), with automated marking.
  • TeX2Quiz, is a similar project to translate multiple choice quiz into moodle XML, without connection with AMC.
  • moodle - Generating Moodle quizzes via LaTeX. A package for writing Moodle quizzes in LaTeX. In addition to typesetting the quizzes for proofreading, the package compiles an XML file to be uploaded to a Moodle server.
  • moodle-mod-automultiplechoice - An interface to use AMC within Moodle.
  • flatex - A Python script for "flattening" a nested LaTeX document by pulling in all the \input files. Part of this project has been reused in amc2moodle.
  • pyexams, It allows to eval code inside any jupyter kernel (like Sagemath, sympy, ...) and to export them in the moodle XML format.

How to contribute ?

If you want to contribute to amc2moodle, your are welcomed! Don't hesitate to

  • ask for help or share some tips on discussions
  • report bugs, installation problems on issues
  • propose some enhancements in the code or in documentation through pull requests (PR)
  • create a moodle plugin for import
  • support new kind of questions
  • add support for other language (French and English are present) in AMC command
  • ...

To ensure code homogeneity among contributors, we use ruff as source-code analyzer included in hatch (e.g. hatch fmt --check). Before submitting a PR, run the tests suite using hatch test (or hatch test -c to run test suite with covering report).

License

This file is part of amc2moodle, a tool to convert automultiplechoice quizzes to moodle questions. amc2moodle is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version. amc2moodle is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with amc2moodle. If not, see https://www.gnu.org/licenses/.

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

amc2moodle-2.12.1.tar.gz (499.0 kB view details)

Uploaded Source

Built Distribution

amc2moodle-2.12.1-py3-none-any.whl (521.3 kB view details)

Uploaded Python 3

File details

Details for the file amc2moodle-2.12.1.tar.gz.

File metadata

  • Download URL: amc2moodle-2.12.1.tar.gz
  • Upload date:
  • Size: 499.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for amc2moodle-2.12.1.tar.gz
Algorithm Hash digest
SHA256 4edcfac330d620b11825ad793079954c10799b92e4268e0b2044c11aa83be38f
MD5 c33768e9e07e2349bf6a6c18f5953bda
BLAKE2b-256 d1c53451dafea301c06e34aad916c7544ae09c2aeae41f7f1cbfb1f8dabcafac

See more details on using hashes here.

Provenance

The following attestation bundles were made for amc2moodle-2.12.1.tar.gz:

Publisher: ci-publish.yml on nennigb/amc2moodle

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file amc2moodle-2.12.1-py3-none-any.whl.

File metadata

  • Download URL: amc2moodle-2.12.1-py3-none-any.whl
  • Upload date:
  • Size: 521.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for amc2moodle-2.12.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8dd85df50c1c41d2a08a669513f75aed6a061f9d0ae79410a724918776c5ac7f
MD5 01592b7931a585161b26049fa27b4a24
BLAKE2b-256 8c6a989cfa49708e61e9df56c5193d061ceaed2e427d1290b3b557a1dc32cdbe

See more details on using hashes here.

Provenance

The following attestation bundles were made for amc2moodle-2.12.1-py3-none-any.whl:

Publisher: ci-publish.yml on nennigb/amc2moodle

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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