= Minor swing with Django
Cédric Declerfayt <jaguarondi27@gmail.com>; Fred Pauchet <fred@grimbox.be>
:doctype: book
:toc:
:sectnums:
:chapter-label: Chapitre
:preface-title: Préface
:source-highlighter: rouge

On ne va pas se mentir: il existe enormément de tutoriaux très bien réalisés sur "Comment réaliser une application Django" et autres "Déployer votre code en 2 minutes". On se disait juste que ces tutoriaux restaient relativement haut-niveau et se limitaient à un contexte donné. 

L'idée du texte ci-dessous est de jeter les bases d'un bon développement, en survolant l'ensemble des outils permettant de suivre des lignes directrices reconnues, de maintenir une bonne qualité de code au travers des différentes étapes (du développement au déploiement) et de s'assurer du maintient correct de la base de code, en permettant à n'importe qui de reprendre le développement.

Ces idées ne s'appliquent pas uniquement à Django et à son cadre de travail, ni même au langage Python. Juste que ces deux bidules sont de bons candidats et que le cadre de travail est bien défini et suffisamment flexible.

Django se présente comme un `Framework Web pour perfectionnistes ayant des deadlines <https://www.djangoproject.com/>`_. 

Django suit quelques principes <https://docs.djangoproject.com/en/dev/misc/design-philosophies/>:

 * Faible couplage et forte cohésion, pour que chaque composant ait son indépendance.
 * Moins de code, plus de fonctionnalités.
 * `Don't repeat yourself <https://fr.wikipedia.org/wiki/Sec>`_: ne pas se répéter!
 * Rapidité du développement (après une courbe d'apprentissage relativement ardue, malgré tout)

Mis côté à côté, l'application de ces principes permet une meilleure stabilité du projet. Dans la suite de ce chapitre, on verra comment configurer l'environnement, comment installer Django de manière isolée et comment démarrer un nouveau projet. On verra comment gérer correctement les dépendances, les versions et comment applique un score sur note code.

Finalement, on verra aussique la configuration proposée par défaut par le framework n'est pas idéale pour la majorité des cas.

Pour cela, on présentera différents outils (mypy, flake8, black, ...), la rédaction de tests unitaires et d'intégration pour limiter les régressions, les règles de nomenclature et de contrôle du contenu, ainsi que les bonnes étapes à suivre pour arriver à un déploiement rapide et fonctionnel avec peu d'efforts.

Et tout ça à un seul et même endroit. Oui. :-)

Bonne lecture.

= Environnement de travail

Avant de démarrer le développement, il est nécessaire de passer un peu de temps sur la configuration de l'environnement.

Les morceaux de code seront développés pour Python3.4+ et Django 1.8+. Ils nécessiteront peut-être quelques adaptations pour fonctionner sur une version antérieure.

**Remarque** : les commandes qui seront exécutés dans ce livre le seront depuis un shell sous GNU/Linux. Certaines devront donc être adaptées si vous êtes dans un autre environnemnet.

include::toolchain/12-factors.adoc[]

include::toolchain/venvs.adoc[]

include::toolchain/django.adoc[]

include::toolchain/maintainable-applications.adoc[]

include::toolchain/tools.adoc[]

include::toolchain/external_tools.adoc[]

include::toolchain/summary.adoc[]


= Déploiement
Et sécurisation du serveur.

include::deploy/index.adoc[]

include::deploy/centos.adoc[]

include::deploy/database.adoc[]

= Modélisation

Dans ce chapitre, on va parler de plusieurs concepts utiles au développement rapide d'une application. On parlera de modélisation, de migrations, d'administration auto-générée. 

include::django/models.adoc[]

include::django/querysets.adoc[]

include::django/forms.adoc[]

include::django/migrations.adoc[]

include::django/mvc.adoc[]

include::django/logging.adoc[]

include::django/admin.adoc[]

= Go Live !

Pour commencer, nous allons nous concentrer sur la création d'un site ne contenant qu'une seule application, même si en pratique le site contiendra déjà plusieurs applications fournies pas django, comme nous le verrons plus loin.

Pour prendre un exemple concret, nous allons créer un site permettant de gérer des listes de souhaits, que nous appellerons `gwift` (pour `GiFTs and WIshlisTs` :)).

La première chose à faire est de définir nos besoins du point de vue de l'utilisateur, c'est-à-dire ce que nous souhaitons qu'un utilisateur puisse faire avec l'application.

Ensuite, nous pourrons traduire ces besoins en fonctionnalités et finalement effectuer le développement

include::gwift/specs.adoc[]

include::gwift/models.adoc[]

include::gwift/tests.adoc[]

include::gwift/key-points.adoc[]

include::gwift/refactoring.adoc[]

include::gwift/user-management.adoc[]

include::gwift/console.adoc[]

include::gwift/metamodel.adoc[]

== Supervision des logs


== feedbacks utilisateurs


= En bonus

include::bonus/code-snippets.adoc[]
