FiNoodle 0.1.13

A small transpiler that converts human-readable text and TOML file formats representing Moodle questions to Moodle XML

Python program that can transform a suite of Moodle Question data
in a format specified by the client to Moodle XML and back.

About The Project

The process to write CodeRunner questions with Moodle is difficult and the number of options makes question creation long and tedious. This means that teaching staff spend large amounts of time working simply writing out the questions, and the process leads to a high incidence of question errors.

Based on Toodle by @James-Ansley, FiNoodle by Finale supports various question types (including CodeRunner, short answer, multiple choice, etc.) and provide warnings for common errors in generating questions. FiNoodle also various supports question templates to generate questions in a consistent and precise format.

Built With

• Python (3.10)
• Moodle
• XML
• Jinja (3.1.2)

---

Installation

pip install FiNoodle

FiNoodle supports installing using pip. Enter the command above in the project folder to install FiNoodle.

---

Usage

Place files for questions in ../Finale/questions/ and run ../Finale/src/FiNoodle.py. An output file called out.xml will be generated in the project folder which can be loaded to Moodle directly.

Supported File Types

• .py: Python programs
• .md: Prompt messages
• .toml: Test cases
• Folders: Supporting files (including images)

Supported Question Types

• .cr: CodeRunner
• .mc: Multiple choice
• .sa: Short answer
• .de: Description

python src/FiNoodle/FiNoodle.py new questions/CLIBuilt/Quiz1 blank cr

---

Requirements

• Markdown~=3.3.7
• Jinja2~=3.1.2

---

Future Plan

• Question repository: Managing and loading questions from external sources.
• More question types: Filling the blanks.
• More error checking: Duplicated questions.

---

The Team

• Carl Taka
• Mongkulviseth Rithy
• Sam Shoykhet
• Sambav Ravivenkatesh
• Shejie Shuang
• Yunu Choi

• Trello board: https://trello.com/b/4HmtI49x/399-project-kanban

---

Acknowledgments

• Toodle (@James-Ansley): https://github.com/James-Ansley/moodle-toml
• Best-README-Template : https://github.com/othneildrew/Best-README-Template