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

INTRODUCTION

• Objectifs
  • connaître l'architecture d'un projet : principaux fichiers
  • présenter data dans frontend
• Documentation
  • doc : bonne version de django

    • officielle : https://docs.djangoproject.com/en/1.1/

    • français : http://docs.django-fr.org/

  • tutoriel

    • Part 1 : créer un projet, créer une app, jouer avec ORM (API) convert en partie lors de atelier 2011-12-07

    • Part 2 : backend (admin) convert lors de atelier 2011-12-07

    • Part 3 : frontend _couvert ici, plus efficacement même ;)_
    • Part 4 : forms et vues génériques _pas couvert ici_
• Environnement technique

  • Python >= 2.5

  • Django 1.1.1
    • Mac OS X : voir tutoriel Part 1 pour manip supplémentaire

PARTIE 1 : RAPPELS

Django

Principaux fichiers

• models.py
• admin.py
• urls.py
• views.py
• templates (HTML)

Projet carto : définition du besoin

L'AUF veut procéder à la cartographie de ses établissements membres. On veut savoir quelle formation est donnée où... ... et répertorier les projets des membres.

Projet carto : modélisation

• Etablissement
• Formation
• Projet

PARTIE 2 : HANDS-ON : PROJET ET APPLICATIONS

Télécharger les sources initiales

Repartir du projet créé lors de l'atelier du 2011-12-07. Nous avions alors :

• Créé le projet carto
• Créé l'application etablissements
• Créé les modèles Etablissement et Formation
• Géré dans l'admin des Etablissements et des Formations

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

• Projet
  • 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!