"""Ensemble des classes d'utilité publique :-)"""

from django.db import models

import markdown


class Markdownizable(models.Model):
    """Classe abstraite ajoutant un champ `informations`, convertible de .md -> .html."""

    class Meta:
        abstract = True

    informations = models.TextField(
        null=True,
        blank=True,
        verbose_name="Comments",
        help_text="Only MarkDown is authorized",
    )

    def to_markdown(self):
        """Convertit le champ `informations` en (Github-flavored) Markdown."""

        return markdown.markdown(self.informations)