moodlesg 0.3.1
Python package to generate common strings used in moodle for users (not admin level) and manage exported files from moodle and generate files for import.
License: MIT license
Keywords: moodlesg education moodle

=======================
Moodle String Generator
=======================


.. image:: https://img.shields.io/pypi/v/moodlesg.svg
        :target: https://pypi.python.org/pypi/moodlesg

.. image:: https://api.travis-ci.com/cosmoscalibur/moodlesg.svg?branch=master
        :target: https://travis-ci.com/cosmoscalibur/moodlesg

.. image:: https://readthedocs.org/projects/moodlesg/badge/?version=latest
        :target: https://moodlesg.readthedocs.io/en/latest/?badge=latest
        :alt: Documentation Status

.. image:: https://pyup.io/repos/github/cosmoscalibur/moodlesg/shield.svg
     :target: https://pyup.io/repos/github/cosmoscalibur/moodlesg/
     :alt: Updates


Python package to generate common strings used in moodle for users (not admin level) and manage exported files from moodle and generate files for import.


* Free software: MIT license
* Documentation: https://moodlesg.readthedocs.io.


Description
-----------

MoodleSG (Moodle String Generator) is a python package with the purpose of help to generate common strings using for users (not admin level) when manage a course in moodle, e.g. answer formulas, grade formulas and question generation in markdown or XML.

This package is not intended to use as admin level and is developed because management of some formulas are very uncomfortable because not variable is available as user level (some universities has very strange methods for grade calculation and vary each semester or some math problems has many substitutions). So, you finish with a longer formula with pattern repetitions that you add manually and many brackets and then your math expression for grade or answer formula is very susceptible to fail.

Also, you can think in some automatic question generation that Moodle not support but you can create and export as a question database of questions (not calculated questions that support numeric or text variables only -not both in the same question-) or import from a question database backup and modify that.

Features
--------

n: null support

b: basic support

p: partial support

f: full support

* [p] String generation of moodle math formulas.

  * [f] `Grade calculations <https://docs.moodle.org/33/en/Grade_calculations#Calculation_functions>`_.
  * [p] `Calculated question <https://docs.moodle.org/33/en/Calculated_question_type#Available_functions>`_.
* [n] String generation of questions for text plain moodle editor (not XML nor HTML).
* [n] String manipulation of question bank.

  * [n] Export of question strings to moodle supported `question import formats <https://docs.moodle.org/33/en/Import_questions>`_.
  * [n] Import of question strings from moodle `question export formats <https://docs.moodle.org/33/en/Export_questions>`_.
  * [n] Management `question bank <https://docs.moodle.org/33/en/Question_bank>`_ locally and generate from collections of question strings.

Credits
-------

This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter: https://github.com/audreyr/cookiecutter
.. _`audreyr/cookiecutter-pypackage`: https://github.com/audreyr/cookiecutter-pypackage


=======
History
=======

0.3.1 (2018-05-17)
------------------

* Define changes according to mmParams.
* Remove sdist distribution from travis deployment.
* Update classifiers.
* Support moodle math setting: decimal and list separator, math type.

0.3.0 (2018-05-13)
------------------

* Fix installation wheels: Removed wheels for python2.7.
* Caps convention for constant: pi → PI.
* Better documentation.
* Full support of common functions between grade and answer calculations.

0.2.2 (2018-05-11)
------------------

* Fix docstrings.
* Added new math functions and docstrings (common and extended module).

0.2.0 (2018-05-06)
------------------

* Full implementation of moodle math expressions.
* Added pi constant.
* Some math functions common between grade and answer calculation.

0.1.2 (2018-03-14)
------------------

* Use super method for init of derived classes.
* Removed support of python 3.3.
* Added basic definition of moodle mathematical variable classes (since 0.1.1).

0.1.0 (2018-03-08)
------------------

* First release on PyPI.