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!