Atelier 2011-12-12 : Plan détaillé

INTRODUCTION

* Présentations ** Davin Baragiotta ** Montréal-Python (MP, sprints/hackathons, ateliers, PyCon) * Objectifs ** connaître l'architecture d'un projet : principaux fichiers ** gérer data dans backend ** présenter data dans frontend * Documentation ** doc : bonne version de django *** officielle : https://docs.djangoproject.com/en/1.3/ *** français : http://docs.django-fr.org/ ** tutoriel *** Part 1 : créer un projet, créer une app, jouer avec ORM (API) _couvert ici_ *** Part 2 : backend (admin) _couvert ici_ *** Part 3 : frontend _couvert ici, plus straightforward même ;)_ *** Part 4 : forms et vues génériques _pas couvert ici_ * Environnement technique ** Python >= 2.5 ** Django 1.3.1 *** Mac OS X : voir tutoriel Part 1 pour manip supplémentaire

Principaux fichiers * models.py * admin.py * urls.py * views.py * templates (HTML)

h3. Projet : définition du besoin

Montréal-Python a une ligue de hockey cosom _(ce n'est pas vrai)_. On veut gérer quels joueurs sont dans quelles équipes... ... et planifier les matchs de la saison.

h3. Projet : modélisation

* Joueur * Equipe * Match

PARTIE 2 : HANDS-ON : PROJET ET APPLICATIONS

Frontend : présenter les données

* recrutement/urls.py https://docs.djangoproject.com/en/1.3/topics/http/urls/ ** home

* recrutement/views.py https://docs.djangoproject.com/en/1.3/topics/http/views/ _voir tutoriel Part 3 (version shortcut)_ https://docs.djangoproject.com/en/1.3/intro/tutorial03/

* templates https://docs.djangoproject.com/en/1.3/topics/templates/ ** créer répertoire templates ** settings.py

os.path.join(os.path.dirname(__file__), "templates"),
import os

** templates/recrutement/home.html

* recrutement/views.py _passer une variable au template_

* templates/recrutement/home.html _utiliser une variable :_

{{ var }}

* recrutement/views.py _endroit où on code en logique en Python plus simple si explore interactivement..._

python manage.py shell

* ORM (API) : object relation mapping

from recrutement.models import *
equipes = Equipe.objects.all()
for e in equipes: print e
e = equipes[0]
e.joueur_set.all()
j = Joueur.objects.get(id=1)
j.id
j = Joueur.objects.get(id=314)
e.id
joueurs = Joueur.objects.filter(equipe__nom__startswith='Pyth')

* recrutement/models.py

related_name = "joueurs"

* relancer shell

e.joueurs.all()
e.joueurs.count()

* recrutement/views.py _passer les variables pertinentes pour accueil_

* templates/recrutement/home.html _boucle for dans template :_

{% for e in equipes %}
{% endfor %}

PARTIE 3 : PROJET LIGUEMP PIMPÉ

Télécharger les sources du projet pimpé : http://montrealpython.org/r/attachments/8

Extraire (_sans clash de nom avec projet en cours_)

Pimpé? Quoi de neuf?

Héritage de templates

* base.html

{% block main %}

* templates

{% extends "base.html" %}
{% block main %}

Fichiers statiques : CSS, images et js

https://docs.djangoproject.com/en/1.3/howto/static-files/

* répertoire : static ** css ** images ** js

* settings.py ** STATICFILES_DIRS

os.path.join(os.path.dirname(__file__), "static"),

* urls.py

from django.contrib.staticfiles.urls import staticfiles_urlpatterns
urlpatterns += staticfiles_urlpatterns()

Connexion du user

* templates ** connexion.html ** deconnexion.html

* urls.py ** connexion ** deconnexion

* settings.py

LOGIN_REDIRECT_URL = "/"

URL avec paramètres

* pages de détail : capter l'id de l'objet ** urls.py : import des urls de l'app recrutement ** recrutement/urls.py ** recrutement/views.py ** templates/recrutement/*

Refactoring du home

* urls home dans views.py à la racine

Admin pimpé : ModelAdmin

* recrutement/admin.py

* classes JoueurAdmin, EquipeAdmin _héritent de ModelAdmin_ ** enregistrer Modele avec ModeleAdmin

admin.site.register(Joueur, JoueurAdmin)

** config ModeleAdmin

list_display
search_fields
list_filter

** plus? https://docs.djangoproject.com/en/1.3/ref/contrib/admin/ *** fields *** fieldsets

Charger données initiales : fixtures

https://docs.djangoproject.com/en/1.3/ref/django-admin/

* créer répertoire fixtures à la racine

python manage.py dumpdata > initial_data.json

* mettre initial_data.json dans fixtures

* pour récupération data :

python manage.py syncdb
no (pas créer user)
python manage.py loaddata fixtures/initial_data.json

PARTIE 4 : HANDS-ON : CRÉER L'APPLICATION SAISON POUR LE PROJET LIGUEMP

Ajouter modèle Match

* Match ** date ** lieu ** equipe1 ** equipe2 ** score1 ** score2

Autre exercice : age d'un joueur

* Joueur.date_naissance * Joueur.age() _ajouter une methode age() sur la classe Joueur utilisant la date de naissance_

CONCLUSION : POUR CONTINUER

* Autres aspects non couverts (quelques uns) ** permissions et décorateurs ** manage.py inspectdb ** manage.py test ** forms ** generic views ** templates : tags, filtres

* Mailing list Django users : http://groups.google.com/group/django-users

* Channel IRC #django : irc://irc.freenode.net/django

* Contribs, plugins https://docs.djangoproject.com/en/dev/ref/contrib/ ** south ** reversion ** Autre : pypi http://pypi.python.org/

* Enjoy!