logo Debian Debian Debian-France Debian-Facile Debian-fr.org Forum-Debian.fr Debian ? Communautés logo inclusivité

Debian-facile

Bienvenue sur Debian-Facile, site d'aide pour les nouveaux utilisateurs de Debian.

Vous n'êtes pas identifié(e).


L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT → ODT PDF Export

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Prochaine révision
Révision précédente
Prochaine révision Les deux révisions suivantes
utilisateurs:hypathie:tutos:developpement-pyhon-utiliser-django [04/12/2015 11:32]
Hypathie [Mise en place d'un environnement minimal pour utiliser Django]
utilisateurs:hypathie:tutos:developpement-pyhon-utiliser-django [06/12/2015 17:34]
Hypathie [Configurations et installation de Django avec SQLite3]
Ligne 1: Ligne 1:
-====== Développer en Python avec Django ======+====== Développer en Python avec Django======
  
-  * Objet : Installer un environnement pour Django +  * Objet : Installer un environnement ​virtuel avec python3 ​pour utiliser ​Django ​\\ essayer un mini projet avec chacune des différentes bases de données supportées par ORM de Django. 
-  * Niveau requis : FIXME {{tag>​débutant }} +  * Niveau requis : {{tag>​débutant}}
-  * Commentaires : //Contexte d'​utilisation du sujet du tuto. // +
  
  
-===== Configurations et installation de Django =====+===== Configurations et installation de Django ​avec SQLite3=====
  
-==== Choisir sa version de Python ​sur sa Debian8 ​====+==== Activer Python3 ​sur Jessie ​====
  
  
Ligne 47: Ligne 46:
  
 <note important>​ <note important>​
-Si l'on choisit d'​utiliser Python3 pour tous le système, il faudra prendre garde de bien installer les outils python3 et non python2 :\+Si l'on choisit d'​utiliser Python3 pour tout le système, il faudra prendre garde de bien installer les outils python3 et non python2 :\
  
 Il faudra lancer : Il faudra lancer :
Ligne 110: Ligne 109:
 - __On veut apprendre à coder en python directement avec le framework Django :__ - __On veut apprendre à coder en python directement avec le framework Django :__
  
-Il faut alors choisir une **unique** version de Python pour tout le système, car comme dit plus haut,\ +Il faut alors choisir une **unique** version de Python pour tout le système, car comme dit plus haut,\
-les utiles python ​servant à utiliser Django s'installe ​en tant que root pour tous le système. +les outils python2.xx ou python3.xx ​servant à utiliser Django s'installent ​en tant que root pour tout le système. 
-Et l'​installation pour tout le système des outils ​python ​et python3 génère des conflits.+Or l'​installation pour tout le système des outils ​python2 ​et des des outils ​python3 génère des conflits.
  
-Ou toujours travailler dans un **environnement python virtuel** ​en utilisant " virtualenv" ​(voir plus bas).+L'​utilisation d'un **environnement python virtuel** ​(''​virtualen''​) ​(voir plus bas) permet l'​utilisation de versions différentes au sein de la même version principale ; (python2.2 et python2.7 **ou** python3.1 et python3.2).
  
 </​note>​ </​note>​
Ligne 227: Ligne 226:
  
  
-===== Utilisation =====+==== Création d'un premier projet Django====
  
 +<​note>​
 +**Un petit rappel ?**
  
 +  - On a crée un dossier par exemple sur son bureau pour l'​environnement virtuel python "​virtualenv PremiersProjetsDjango";​
 +  - Dans ce dossier on a activé python "​source bin/​activate"​ ;
 +  - On a installé Django.
 +
 +À partir de là pour créer un projet Django, il faut aller dans le dossier de l'​environnement virtuel python et activer python :
 +
 +<code user>cd ~/​Bureau/​PremiersProjetsDjango/</​code>​
 +
 +<code user>​source bin/​activate</​code>​
 +
 +<code user>​python3 -c "​import django; print(django.get_version())"</​code>​
 +
 +</​note>​
 +
 +  * Le contenu de son dossier avant création d'un nouveau projet:
 +
 +<code user>​pwd</​code>​
 +<code retour>/​home/​hypathie/​Bureau/​PremiersProjetsDjango</​code>​
 +
 +<code user>​ls</​code>​
 +<code retour>​bin ​ include ​ lib</​code>​
 +
 +  * Pour créer un nouveau projet nommé par exemple "​premierProjet":​
 +
 +<code user>​django-admin.py startproject premierProjet</​code>​
 +<code user>​ls</​code>​
 +<code retour>​bin ​ include ​ lib  premierProjet</​code>​
 +
 +  * Architecture du dossier premierProjet :
 +
 +<code user>cd premierProjet/</​code>​
 +<code retour>​manage.py ​ premierProjet</​code>​
 +
 +<code user>cd premierProjet/</​code>​
 +<code retour>​__init__.py ​ settings.py ​ urls.py ​ wsgi.py</​code>​
 +
 +  * Avec la commande tree :
 +
 +<code user>​tree premierProjet/</​code>​
 +<code retour>
 +premierProjet/​
 +├── manage.py
 +└── premierProjet
 +    ├── __init__.py
 +    ├── settings.py
 +    ├── urls.py
 +    └── wsgi.py
 +</​code>​
 +
 +**Ces fichiers sont :**
 +
 +    * __premierProjet/​__ c'est le répertoire racine qui est le contenant du projet nouvellement créé.
 +
 +    * __manage.py__ est un utilitaire en ligne de commande qui vous permet d’interagir avec ce projet Django de différentes façons. Vous trouverez toutes les informations nécessaires sur manage.py dans django-admin et manage.py.
 +
 +    * Le sous-répertoire __premierProjet/​__ correspond au paquet Python effectif de votre projet. C’est le nom du paquet Python que vous devrez utiliser pour importer ce qu’il contient.
 +
 +    * __premierProjet/​__init__.py__ : un fichier vide qui indique à Python que ce répertoire doit être considéré comme un paquet (lisez informations sur les paquets (en) dans la documentation officielle de Python si vous êtes débutant avec ce langage).
 +
 +    * __premierProjet/​settings.py__ : réglages et configuration de ce projet Django. Les réglages de Django vous apprendra tout sur le fonctionnement des réglages.
 +
 +    * __premierProjet/​urls.py__ : les déclarations des URL de ce projet Django, une sorte de « table des matières » de votre site Django. Vous pouvez en lire plus sur les URL dans Distribution des URL.
 +
 +    * __premierProjet/​wsgi.py__ : un point d’entrée pour les serveurs Web compatibles WSGI pour déployer votre projet. Voir Comment déployer avec WSGI pour plus de détails.
 +
 +Pour plus de détails voir la doc officielle de Django : https://​docs.djangoproject.com/​fr/​1.8/​intro/​tutorial01/​
 +
 +=== Premier test===
 +
 +  * On se place à la racine du nouveau projet :
 +
 +<code user>cd ~/​Bureau/​PremiersProjetsDjango/​premierProjet/</​code>​
 +
 +<code user>​python3 manage.py runserver</​code>​
 +
 +<code retour>
 +Performing system checks...
 +
 +System check identified no issues (0 silenced).
 +
 +You have unapplied migrations; your app may not work properly until they are applied.
 +Run '​python manage.py migrate'​ to apply them.
 +
 +December 03, 2015 - 12:43:53
 +Django version 1.9, using settings '​premierProjet.settings'​
 +Starting development server at http://​127.0.0.1:​8000/​
 +Quit the server with CONTROL-C.
 +</​code>​
 +
 +<​note>​
 +Rien de grave dans ce retour.
 +Django prévient qu'​aucune base de données n'a été migrée.
 +Ce n'est pas important pour ce premier test.
 +</​note>​
 +
 +  * Depuis son navigateur on entre dans la barre url: "​http://​localhost:​8000/"​
 +
 +On obtient :
 +
 +{{http://​pix.toile-libre.org/​upload/​img/​1449147148.png}}\\
 +
 +====Premier projet avec la base de données sqlite3====
 +
 +  * Par défaut, Django utilise la base de donnée sqlite3 :
 +
 +<code user>​~/​Bureau/​PremiersProjetsDjango/​premierProjet/​premierProjet</​code>​
 +
 +<code user>vim settings.py</​code>​
 +
 +
 +
 +<​code>​
 +...
 +DATABASES = {
 +    '​default':​ {
 +        '​ENGINE':​ '​django.db.backends.sqlite3',​
 +        '​NAME':​ os.path.join(BASE_DIR,​ '​db.sqlite3'​),​
 +    }
 +}
 +...
 +</​code>​
 +
 +<note tip>
 +
 +    * **ENGINE** – Par défaut avec sqlite3 : '​django.db.backends.sqlite3'​. ​ \\ D’autres moteurs sont également disponibles : \\ Pour utiliser PoesgreSql : '​django.db.backends.postgresql_psycopg2'​ ; \\ Pour utiliser MySql: '​django.db.backends.mysql';​ \\ Pour utiliser Oracle : '​django.db.backends.oracle'​.
 +
 +    * **NAME** – Le nom de votre base de données. Avec SQLite, la base de données est un fichier sur votre ordinateur. \\ Dans ce cas, NAME doit être le chemin absolu complet de celui-ci, y compris le nom de fichier.\\ La valeur par défaut, os.path.join(BASE_DIR,​ '​db.sqlite3'​),​ stocke ce fichier dans le répertoire de votre projet.
 +</​note>​
 +
 +===Modifier le fichier settings.py et Générer le fichier de base de données SQLite===
 +
 +  * Modifier les paramètres ​ :
 +
 +<​code>​
 +LANGUAGE_CODE = '​fr-fr'​
 +
 +TIME_ZONE = '​Europe/​Paris'​
 +</​code>​
 +
 +  * Avant migration :
 +
 +<​code>​
 +tree 
 +.
 +├── manage.py
 +└── premierProjet
 +    ├── __init__.py
 +    ├── __pycache__
 +    │   ​├── __init__.cpython-34.pyc
 +    │   ​├── settings.cpython-34.pyc
 +    │   ​├── urls.cpython-34.pyc
 +    │   ​└── wsgi.cpython-34.pyc
 +    ├── settings.py
 +    ├── urls.py
 +    └── wsgi.py
 +
 +</​code>​
 +
 +  * On lance la commande de migration :
 +
 +<code user>​python3 manage.py migrate</​code>​
 +<code retour>​Operations to perform:
 +  Apply all migrations: admin, auth, contenttypes,​ sessions
 +Running migrations:
 +  Rendering model states... DONE
 +  Applying contenttypes.0001_initial... OK
 +  Applying auth.0001_initial... OK
 +  Applying admin.0001_initial... OK
 +  Applying admin.0002_logentry_remove_auto_add... OK
 +  Applying contenttypes.0002_remove_content_type_name... OK
 +  Applying auth.0002_alter_permission_name_max_length... OK
 +  Applying auth.0003_alter_user_email_max_length... OK
 +  Applying auth.0004_alter_user_username_opts... OK
 +  Applying auth.0005_alter_user_last_login_null... OK
 +  Applying auth.0006_require_contenttypes_0002... OK
 +  Applying auth.0007_alter_validators_add_error_messages... OK
 +  Applying sessions.0001_initial... OK</​code>​
 +
 +  * Après migration :
 +
 +<​code>​
 +tree 
 +.
 +├── db.sqlite3
 +├── manage.py
 +└── premierProjet
 +    ├── __init__.py
 +    ├── __pycache__
 +    │   ​├── __init__.cpython-34.pyc
 +    │   ​├── settings.cpython-34.pyc
 +    │   ​├── urls.cpython-34.pyc
 +    │   ​└── wsgi.cpython-34.pyc
 +    ├── settings.py
 +    ├── urls.py
 +    └── wsgi.py
 +</​code>​
 +
 +<note tip>
 +
 +L'​exécution de la commande "​manage.py migrate"​ a permis :
 +
 +  * de créer à la racine le fichier de base de données nommé par défaut "​db.sqlite3";​
 +  * elle a ajouté au fichier "​settings.py " dans la section "​INSTALLED_APPS"​ la ligne : '​polls',​
 +<code retour>
 +INSTALLED_APPS = (
 +    '​django.contrib.admin',​
 +    '​django.contrib.auth',​
 +    '​django.contrib.contenttypes',​
 +    '​django.contrib.sessions',​
 +    '​django.contrib.messages',​
 +    '​django.contrib.staticfiles',​
 +    '​polls',​
 +)
 +</​code>​
 +
 +  * À savoir : La commande "​makemigrations"​ permet de mettre à jour les polls (sorte de script SQL), à partir d'un modèle s'il en existe (voir plus bas).  ​
 +
 +<code user>​python3 manage.py makemigrations</​code>​
 +<code retour>​No changes detected</​code>​
 +
 +</​note>​
 +
 +===Création de Modèle (c'est presque du code first !)===
 +
 +  * On se place dans le répertoire "​~/​Bureau/​PremiersProjetsDjango/​premierProjet"​ :
 +<code user>cd ~/​Bureau/​PremiersProjetsDjango/​premierProjet</​code>​
 +
 +  * On utilise manage.py pour créé l'​arborescence nécessaire à l'​utilisation de Modèle :
 +
 +<code user>​python3 manage.py startapp polls</​code>​
 +
 +Cela a crée le répertoire polls à la racine du dossier consacré au projet django :
 +
 +<code user>​pwd</​code>​
 +<​code>/​home/​hypathie/​Bureau/​PremiersProjetsDjango/​premierProjet</​code>​
 +
 +<code user>​tree</​code>​
 +<​code>​
 +.
 +├── db.sqlite3
 +├── manage.py
 +├── polls
 +│   ​├── admin.py
 +│   ​├── apps.py
 +│   ​├── __init__.py
 +│   ​├── migrations
 +│   ​│ ​  ​├── 0001_initial.py
 +│   ​│ ​  ​├── __init__.py
 +│   ​│ ​  ​└── __pycache__
 +│   ​│ ​      ​├── 0001_initial.cpython-34.pyc
 +│   ​│ ​      ​└── __init__.cpython-34.pyc
 +│   ​├── models.py
 +│   ​├── __pycache__
 +│   ​│ ​  ​├── admin.cpython-34.pyc
 +│   ​│ ​  ​├── __init__.cpython-34.pyc
 +│   ​│ ​  ​└── models.cpython-34.pyc
 +│   ​├── tests.py
 +│   ​└── views.py
 +└── premierProjet
 +    ├── __init__.py
 +    ├── __pycache__
 +    │   ​├── __init__.cpython-34.pyc
 +    │   ​├── settings.cpython-34.pyc
 +    │   ​├── urls.cpython-34.pyc
 +    │   ​└── wsgi.cpython-34.pyc
 +    ├── settings.py
 +    ├── urls.py
 +    └── wsgi.py
 +</​code>​
 +
 +  * On crée des Modèles dans le fichier models.py :
 +
 +<code user>vim polls/​models.py</​code>​
 +<file >
 +import datetime
 +
 +from django.db import models
 +from django.utils import timezone
 +
 +# Create your models here.
 +
 +class Question(models.Model):​
 +    question_text = models.CharField(max_length=200)
 +    pub_date = models.DateTimeField('​date published'​)
 +    def __str__(self):​
 +        return self.question_text
 +    def was_published_recently(self):​
 +        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)
 +
 +
 +class Choice(models.Model):​
 +    question = models.ForeignKey(Question)
 +    choice_text = models.CharField(max_length=200)
 +    votes = models.IntegerField(default=0)
 +    def __str__(self):​
 +        return self.choice_text
 +</​file>​
 +
 +  * Cette fois la commande "​makemigrations"​ ci-dessous, va créer un script de type SQL de creation et/ou mise à jour de la base de données associées au projet, par défaut ce script est le fichier "​polls/​migrations/​0001_initial.py"​ :
 +
 +<code user>​python3 manage.py makemigrations polls</​code>​
 +
 +<​code>​Migrations for '​polls':​
 +  0001_initial.py:​
 +    - Create model Choice
 +    - Create model Question
 +    - Add field question to choice</​code>​
 +
 +
 +
 +  * L'ORM de Django permet de générer un script de création de base de données avec tables, noms et types des champs, clés primaires et cardinalités...\\ Pour voir le script créé à partir des Modèles python (classe):
 +
 +<code user>​python3 manage.py sqlmigrate polls 0001</​code>​
 +
 +  * Mais c'est la commande suivante qui applique les changements apportés aux Models dans la base de données :
 +
 +<code user>​python3 manage.py migrate</​code> ​
 +
 +  * Il est ensuite possible d'​interroger la base de donnée depuis le shell en utilisant les méthodes du Modèle ​
 +  * Sur "​migrate"​ :  https://​docs.djangoproject.com/​fr/​1.8/​intro/​tutorial01/#​database-setup ​
 +  * Sur "​manage.py"​ : https://​docs.djangoproject.com/​fr/​1.8/​ref/​django-admin/​
 +  * Explication sur ORM : http://​apprendre-python.com/​page-django-orm-apprendre-base-donnees-database-queryset-modeles
 +  * Explication sur API : http://​sametmax.com/​quest-ce-quune-api/​
 +
 +  * Pour utiliser l'API Django depuis un shell python :
 +
 +<code user>​python3 manage.py shell</​code>​
 +
 +  * Pour s'​exercer : https://​docs.djangoproject.com/​fr/​1.8/​intro/​tutorial01/#​playing-with-the-api
 +
 +
 +=== Création d'un administrateur Django===
 +
 +  * On se place de le dossier de son projet Django :
 +
 +<code user>cd ~/​Bureau/​PremiersProjetsDjango/​premierProjet/</​code>​
 +
 +  * On crée un administrateur :
 +
 +<code user>​python3 manage.py createsuperuser</​code>​
 +
 +<code retour>
 +Username (leave blank to use '​hypathie'​):​ Hypathie
 +Email address: hypathie@gmx.fr
 +Password: ​
 +Password (again): ​
 +Superuser created successfully.
 +</​code>​
 +
 +  * Et maintenant on peut accéder à la gestion de son projet depuis son navigateur :
 +
 +<code user>​python3 manage.py runserver 192.168.0.26:​8000</​code>​
 +
 +<note tip>
 +Modifier 192.168.0.26 par l'ip de la machine sur laquelle le projet est installé.
 +
 +Pour le savoir :
 +
 +<code root>​ifconfig</​code>​
 +
 +  * remarques : 
 +
 +  - On peut aussi taper dans son navigateur :\\ localhost:​8000 ou 0.0.0.0:​8000 si l'on a lancé :\\ python3 manage.py runserver 0.0.0.0:​8000
 +  - L'​avantage de l'ip de la machine c'est de pouvoir se connecter à son application depuis son navigateur depuis une machine distante.
 +</​note>​
 +
 +  * On tape dans son navigateur par exemple :
 +
 +<​code>​192.168.0.26:​8000/​admin</​code>​
 +
 +{{http://​pix.toile-libre.org/​upload/​original/​1449160999.png}}
 +
 +{{http://​pix.toile-libre.org/​upload/​original/​1449161189.png}}
 +
 +  * Pour apprendre à gérer son site depuis le site d'​administration de Django : https://​docs.djangoproject.com/​fr/​1.8/​intro/​tutorial02/​
 +
 +  * Le création des Vues : https://​docs.djangoproject.com/​fr/​1.8/​intro/​tutorial03/#​writing-your-first-django-app-part-3
 +
 +  * Factoriser son code Python : https://​docs.djangoproject.com/​fr/​1.8/​intro/​tutorial04/#​writing-your-first-django-app-part-4
 +
 +  * Tests automatisés :  https://​docs.djangoproject.com/​fr/​1.8/​intro/​tutorial05/​
 +
 +  * Utiliser du Javascript, du CSS avec Django : https://​docs.djangoproject.com/​fr/​1.8/​intro/​tutorial06/#​writing-your-first-django-app-part-6
 +
 +
 +====Configurer Vim pour Python ====
 +
 +  * On installe curl
 +
 +<code root>​apt-get install curl</​code>​
 +
 +  * On installe git :
 +
 +<code root>​apt-get install git-core</​code>​
 +
 +  * On installe pathogen
 +
 +Voir : https://​github.com/​search?​utf8=%E2%9C%93&​q=pathogen
 +
 +<code user>
 +mkdir -p ~/​.vim/​autoload ~/​.vim/​bundle && \
 +curl -LSso ~/​.vim/​autoload/​pathogen.vim https://​tpo.pe/​pathogen.vim
 +</​code>​
 +
 +  * On crée et édite un fichier caché ~/.vimrc :
 +
 +<code user>vim ~/​.vimrc</​code>​
 +
 +<​file>​
 +execute pathogen#​infect()
 +syntax on
 +filetype plugin indent on
 +</​file>​
 +
 +pathogen va chercher dans le répertoire bundle les plugin qu'on lui a installé et les utiliser comme si on les avait installé dans le fichier .vimrc
 +
 +  * On installe le module nerdtree :
 +
 +Voir : https://​github.com/​scrooloose/​nerdtree
 +
 +<code user>git clone https://​github.com/​scrooloose/​nerdtree.git ~/​.vim/​bundle/​nerdtree</​code>​
 +
 +<note tip>
 +**
 +Principales commandes de NERD Tree :**
 +
 +
 +    t: Ouvrir le fichier sélectionné dans un nouvel onglet
 +    i: Ouvrez le fichier sélectionné dans une fenêtre fissure verticale
 +    s: Open the selected file in a vertical split window
 +    I: Commutation de fichiers cachés
 +    m: Pour faire apparaître un menu qui vous permettra d'​ajouter rapidement, déplacer(=renomer),​ copier et supprimer des nœuds (ou fichiers).
 +    R: Actualiser l'​arbre,​ utile si les fichiers ont changés en dehors de Vim
 +    ?: Commutation entre l'aide rapide et l'​explorateur NERD Tree 
 +    Ctrl +w puis w: Passer de l'​explorateur NERD Tree à la fenêtre d'​édition des fichiers
 +
 +</​note>​
 +
 +  * On installe vim-airLine améliorer le statusline.
 +
 +<code user>git clone https://​github.com/​bling/​vim-airline.git ~/​.vim/​bundle/​vim-airline</​code>​
 +
 +On ajoute la ligne suivante dans ''​~./​vimrc''​ :
 +
 +<​code>​let g:​airline#​extensions#​tabline#​enabled = 1</​code>​
 +
 +<note tip>
 +Après avoir ouvert plusieurs fichiers, pour passer d'un fichier à l'​autre,​ le curseur entant placé dans l'​encadré d'​édition d'un fichier:
 +
 +  - On peut utiliser la commande vim '':​register''​ puis on choisit son buffer ;
 +  - On peut faire '':​bn''​ (pour Buffer Next) ou '':​bp''​ (pour Buffer Prevous) ;
 +
 +On peut se faire un racourcit :
 +
 +  - On édite ''​~/​.vimrc'' ​
 +  - on ajoute :
 +
 +<​code>​
 +nmap <C-n> :​bn<​CR>​
 +nmap <C-p> :​bp<​CR>​
 +</​code>​
 +</​note>​
 +
 +
 +  * Utilisation de la souris pour naviger entre les fenêtres, et sélectionner dans une seule fenêtre (i.e mode visuel de vim)
 +
 +On édite ''​~/​.vimrc''​
 +
 +On ajoute :
 +<​file>​
 +set mouse=a
 +</​file>​
 +
 +  * On ajoute le plugin syntastic
 +
 +Voir : https://​github.com/​scrooloose/​syntastic
 +
 +<code user>git clone https://​github.com/​scrooloose/​syntastic.git ~/​.vim/​bundle/​syntastic</​code>​
 +
 +  * On ajoute le plugin tagbar
 +
 +<code user>git clone https://​github.com/​majutsushi/​tagbar.git ~/​.vim/​bundle/​tagbar</​code>​
 +
 +===== Configurations et installation de Django avec PostgreSQL=====
utilisateurs/hypathie/tutos/developpement-pyhon-utiliser-django.txt · Dernière modification: 06/01/2016 10:18 par Hypathie

Pied de page des forums

Propulsé par FluxBB