Metadata-Version: 2.1
Name: moodlexport
Version: 0.0.1
Summary: A package to export test questions into Moodle from python or latex
Home-page: https://github.com/Guillaume-Garrigos/moodlexport
Author: Guillaume Garrigos
Author-email: guillaume.garrigos@lpsm.paris
License: UNKNOWN
Description: # moodlexport
        
        The Jupyter Notebook `Moodle_generator` contains Python code which allows to easily generate families of questions (called *categories* in Moodle) that can be directly exported to Moodle and used to create a test. The main idea is that : 
        - it is easier to define mathematical objects in Python than Moodle
        - generating random problems is simpler in Python (Moodle provides a way to generate random number but it is quite a mess)
        
        ### Features of this module so far :
        - Creating a question. Supported classes of questions are:
            -  "essay" : the student answers in a white text box. Options are :
                - Possibility for the student to upload a file as an answer as well. 
            -  "multichoice" : the question comes with at least 2 possible answers. Options are :
                - Possibility to specify "multiple answers allowed" or "unique answer allowed"
        - All the options available in Moodle are available here (defining a grade, information for the grader, feedback, etc)
        - Creating a category (family) of questions
        - Adding a question to a given category
        - Export a category of questions under the format Moodle XML, which can be imported directly into Moodle.
        - Supports Unicode Ã©Ã Ãª ...
        - Supports Latex syntax : correctly supports inline latex with `$e^x$`, and equation with `$$ f(x) = \sum_i x_i^2 $$, \begin{equation*}...\end{equation*}, \begin{cases}` etc
        
        ### Simple examples : 
        
        
            category = Category("Questions for exam 2")
            question = Question("essay") # new open question
            question.text("What is the derivative of $f(x) = e^x + 0.5 \Vert x \Vert^2$.") # question with latex
            question.grade(1.5)
            question.addto(category) # adds the question to the category
            category.save() # creates a "Questions for exam 2.xml" file ready to import in Moodle
        
            question = Question("multichoice") # new multiple choice question
            question.text("Is every symmetric matrix invertible?")
            question.grade(2.0)
            Answer("Yes", False).addto(question)
            Answer("No", True).addto(question) 
            question.addto(category) 
            category.save()
        
         
        Known issues/missing features :
        - Extract list of questions from .txt file is doable online see https://vletools.herokuapp.com/info/help but their code is not shared...
        - for multichoice we never check that the sum of the fractions is equal to 100% 
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7
Description-Content-Type: text/markdown
