\chapter{Context Processors}

Un \emph{context processor} sert \emph{grosso-modo} à peupler l'ensemble des données transmises des vues aux templates avec des données communes. Un context processor est un peu l'équivalent d'un middleware, mais est situé entre les données et les templates, là où le middleware va s'occuper des données relatives aux réponses et requêtes elles-mêmes.

\begin{minted}{python}
    # core/context_processors.py

    import subprocess


    def git_describe(request) -> str:
        return {
            "git_describe": subprocess.check_output(
                ["git", "describe", "--always"]
            ).strip(),
            "git_date": subprocess.check_output(
                ["git", "show", "-s", r"--format=%cd", r"--date=format:%d-%m-%Y"]
            ),
        }
\end{minted}


Ceci aura pour effet d'ajouter les deux variables \texttt{git\_describe} et \texttt{git\_date} dans tous les contextes de tous les templates de l'application.

\begin{minted}{python}
    TEMPLATES = [
        {
            'BACKEND': 'django.template.backends.django.DjangoTemplates',
            'DIRS': [os.path.join(BASE_DIR, "templates"),],
            'APP_DIRS': True,
            'OPTIONS': {
                'context_processors': [
                    'django.template.context_processors.debug',
                    'django.template.context_processors.request',
                    'django.contrib.auth.context_processors.auth',
                    'django.contrib.messages.context_processors.messages',
                    "core.context_processors.git_describe"
                ],
            },
        },
    ]
\end{minted}

Les context processors sont extrêmement utiles pour injecter des données dans chacune des vues. 
Il peut cependant être utile d'utiliser un mécanisme de cache pour gagner du temps de traitement, surtout lorsque des appels en base de données doivent être réalisés: ceci évite que ces appels ne soient réalisés trop souvent, alors qu'ils n'évoluent peut-être pas aussi vite.
