# genmq
A Moodle quiz generator using LaTeX and the `moodle.sty` package with jinja2 templates
*Generates Individualized Moodle Quizzes based on a LaTeX Template*
**Author:** Colin Caprani,
[colin.caprani@monash.edu](mailto://colin.caprani@monash.edu)
## Overview
`genmq` is a python package that performs mail-merge like functionality to generate a Moodle quiz XML file for bulk upload. It uses a template latex file based on the [`moodle.sty`](https://framagit.org/mattgk/moodle) package, and populates placeholder variables with entries from a prepared csv file to generate many variants of the template question. It can include the answers, precision, and feedback; all as described in the documentation for the `moodle.sty` package.
`genmq` can also split larger Moodle XML files into multiple files to facilitate uploading when there are file size limits.
## Installation
`genmq` installs as a command into your system.
### Using pip
```python
pip install genmq
```
### For development
Clone or download this repository to a local directory. Open a terminal in that directory (where this README will be found) and run:
```python
pip install -e .
```
## Typical Usage
For generating quizzes:
```bash
genmq -t [template].tex -c [database].csv
```
For splitting an existing large XML file:
```bash
genmq -s [moodle_quiz].xml
```
To see all arguments, run `genmq --help`.
Raw data
{
"_id": null,
"home_page": null,
"name": "genmq",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "moodle, quiz, question bank",
"author": null,
"author_email": "Colin Caprani <colin.caprani@monash.edu>",
"download_url": "https://files.pythonhosted.org/packages/19/6a/619a754684c3b446aec33b3ed646ec60871616ac13188cb80be7cbcc5e0a/genmq-0.6.2.tar.gz",
"platform": "any",
"description": "# genmq\nA Moodle quiz generator using LaTeX and the `moodle.sty` package with jinja2 templates\n\n*Generates Individualized Moodle Quizzes based on a LaTeX Template*\n\n**Author:** Colin Caprani,\n[colin.caprani@monash.edu](mailto://colin.caprani@monash.edu)\n\n## Overview\n`genmq` is a python package that performs mail-merge like functionality to generate a Moodle quiz XML file for bulk upload. It uses a template latex file based on the [`moodle.sty`](https://framagit.org/mattgk/moodle) package, and populates placeholder variables with entries from a prepared csv file to generate many variants of the template question. It can include the answers, precision, and feedback; all as described in the documentation for the `moodle.sty` package.\n\n`genmq` can also split larger Moodle XML files into multiple files to facilitate uploading when there are file size limits.\n\n## Installation\n\n`genmq` installs as a command into your system.\n\n### Using pip\n\n```python\npip install genmq\n```\n\n### For development\nClone or download this repository to a local directory. Open a terminal in that directory (where this README will be found) and run:\n\n```python\npip install -e .\n```\n\n\n## Typical Usage\n\nFor generating quizzes:\n\n```bash\ngenmq -t [template].tex -c [database].csv\n```\n\nFor splitting an existing large XML file:\n```bash\ngenmq -s [moodle_quiz].xml\n```\n\nTo see all arguments, run `genmq --help`.\n\n",
"bugtrack_url": null,
"license": "GNU General Public License v3.0",
"summary": "Moodle quiz generator",
"version": "0.6.2",
"project_urls": {
"Documentation": "https://ccaprani.github.io/genmq/",
"Homepage": "https://ccaprani.github.io/genmq/",
"Source": "https://github.com/ccaprani/genmq/",
"Tracker": "https://github.com/ccaprani/genmq/issues/"
},
"split_keywords": [
"moodle",
" quiz",
" question bank"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8db6fdbd72896fd143a8f8fa22cb6bdfb438feb4cf3007b28d0c4e00030c8cc2",
"md5": "795b4b8f51f8398227890ad9bb1566ae",
"sha256": "fe4005ed1d8f5fc7203461fab6acc7502842bdef651190ed8c66e5ea941604ff"
},
"downloads": -1,
"filename": "genmq-0.6.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "795b4b8f51f8398227890ad9bb1566ae",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 19670,
"upload_time": "2024-05-06T06:17:25",
"upload_time_iso_8601": "2024-05-06T06:17:25.895602Z",
"url": "https://files.pythonhosted.org/packages/8d/b6/fdbd72896fd143a8f8fa22cb6bdfb438feb4cf3007b28d0c4e00030c8cc2/genmq-0.6.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "196a619a754684c3b446aec33b3ed646ec60871616ac13188cb80be7cbcc5e0a",
"md5": "a0ad0ea3ecd710d81420bb46fb791452",
"sha256": "0857f8f31daebb23d4df7cb8196a4cf1666bb32a17fba7f9002725aa92789dcf"
},
"downloads": -1,
"filename": "genmq-0.6.2.tar.gz",
"has_sig": false,
"md5_digest": "a0ad0ea3ecd710d81420bb46fb791452",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 19516,
"upload_time": "2024-05-06T06:17:27",
"upload_time_iso_8601": "2024-05-06T06:17:27.686503Z",
"url": "https://files.pythonhosted.org/packages/19/6a/619a754684c3b446aec33b3ed646ec60871616ac13188cb80be7cbcc5e0a/genmq-0.6.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-06 06:17:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ccaprani",
"github_project": "genmq",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "genmq"
}
JSON
