Merge branch 'review/base' of Sulley/khana into master

src/base/models.py

@@ -1,8 +1,13 @@
+"""Ensemble des classes d'utilité publique :-)"""
+
 from django.db import models
+
 import markdown
 
 
 class Markdownizable(models.Model):
+    """Classe abstraite ajoutant un champ `information`, convertible de .md -> .html."""
+
     class Meta:
         abstract = True
 
@@ -14,14 +19,6 @@ class Markdownizable(models.Model):
     )
 
     def to_markdown(self):
-        """
-        Convertit le commentaire associé au `skill` en (Github-flavored) Markdown.
-        """
-        # parser = CommonMark.DocParser()
-        # ast = parser.parse(self.information)
-
-        html = markdown.markdown(self.information)
-
-        return html
-
-        # return CommonMark.HTMLRenderer().render(ast)
+        """Convertit le champ `information` en (Github-flavored) Markdown."""
+        
+        return markdown.markdown(self.information)

src/base/tests.py

@@ -0,0 +1,16 @@
+"""Tests associés à la conversion de contenu Markdown en HTML."""
+
+from django.test import TestCase
+
+from .models import Markdownizable
+
+
+class TestMarkdownizable(TestCase):
+    """Vérifie les fonctionnalités associées à la classe Markdownizable.
+    """
+
+    def test_to_markdown(self):
+        """Vérifie qu'un contenu Markdown est correctement convertit en HTML."""
+        m = Markdownizable(information="# Title")
+
+        self.assertEqual(m.to_markdown(), "<h1>Title</h1>")