Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
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 →
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
|
utilisateurs:hypathie:tutos:developpement-pyhon-utiliser-django [08/12/2015 11:56] Hypathie [Configurations et installation de Django avec SQLite3] |
utilisateurs:hypathie:tutos:developpement-pyhon-utiliser-django [16/12/2015 07:19] Hypathie [Installations] |
||
|---|---|---|---|
| Ligne 1: | Ligne 1: | ||
| ====== Développer en Python3 avec Django====== | ====== Développer en Python3 avec 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. | + | * Objet : Installer un environnement virtuel pour coder en python3 avec Django |
| * Niveau requis : {{tag>débutant}} | * Niveau requis : {{tag>débutant}} | ||
| - | =====Avant de commencer ==== | + | ===== Installations ===== |
| - | Sur Jessie python et python 3 sont tous deux installés. | + | ===Installer les outils et bibliothèques pour développer en python ou python3=== |
| - | ==== Installer les outils et bibliothèques pour développer en python ou python 3 ==== | + | <note tip> |
| + | Sur Jessie, python et python 3 sont tous deux installés. | ||
| + | </note> | ||
| * Fichiers d'en-tête de Python | * Fichiers d'en-tête de Python | ||
| Ligne 21: | Ligne 23: | ||
| * Bibliothèques FreeType nécessaire par matplotlib | * Bibliothèques FreeType nécessaire par matplotlib | ||
| - | <code=root>apt-get install libfreetype6 libfreetype6-dev</code> | + | <code root>apt-get install libfreetype6 libfreetype6-dev</code> |
| * Dépendances nécessaire pour la cryptographie | * Dépendances nécessaire pour la cryptographie | ||
| Ligne 64: | Ligne 66: | ||
| <code root>apt-get install tree</code> | <code root>apt-get install tree</code> | ||
| - | ====Préparer son système pour travailler avec python2 et python3==== | + | ===Vim IDE pour coder pour python3 === |
| - | + | ||
| - | ===Utiliser update-alternatives pour choisir l'une ou l'autre des versions:=== | + | |
| - | * Charger les différentes versions de Python : | + | * https://debian-facile.org/utilisateurs:hypathie:tutos:vim-ide-python?&#installer-vim-ide-pour-python |
| + | * https://code.djangoproject.com/wiki/UsingVimWithDjango | ||
| + | * https://github.com/yodiaditya/vim-pydjango | ||
| - | <code root>update-alternatives --list python</code> | + | ===== Créer des projets Django en python2 ou python3===== |
| - | <code retour>update-alternatives: error: no alternatives for python</code> | + | |
| - | * Pour voir où sont les exécutables des deux versions disponibles de python : | + | ===Les versions de python sur sa Jessie=== |
| <code user> ls /usr/bin/python*</code> | <code user> ls /usr/bin/python*</code> | ||
| Ligne 84: | Ligne 85: | ||
| </code> | </code> | ||
| - | * Pour ajouter à la liste de update-alternatives les deux versions de python disponibles : | + | ===Problème avec python pour utiliser virtualenv=== |
| - | (ici par exemple; "/usr/bin/python2.7" et "/usr/bin/python3.4 ") | + | |
| - | <code root>update-alternatives --install /usr/bin/python python /usr/bin/python2.7 1</code> | + | <note tip> |
| - | <code root>update-alternatives --install /usr/bin/python python /usr/bin/python3.4 2</code> | + | **L'idée suivie ici est de pouvoir aussi bien créer des projets Django pour coder en python 3 tandis que c'est la version python 2 qui est en place sur tout le système que l'inverse, c'est-à-dire, pouvoir créer des projects Django pour coder en python2 alors que c'est une version 3 de python qui est mise en place sur tout le système.** \\ |
| - | - Pour voir la nouvelle liste de update-alternatives : | + | Pour ce faire, on va créer un environnement virtuel dans un dossier créé dans le répertoire courant de l'utilisateur du système. |
| + | On pourra alors installer Django aussi bien pour y coder en python2 qu'en python3, sans se soucier de la version mise en place sur l'ensemble du système. \\ | ||
| - | <code root>update-alternatives --list python</code> | + | Cela évitera aussi de se mélanger les pinceaux entre les utilitaires ''pip install ...'' ou ''pip3 install ...''. \\ |
| - | <code retour> /usr/bin/python2.7 | + | |
| - | /usr/bin/python3.4</code> | + | |
| - | + | ||
| - | + | ||
| - | - On va laisser tout le système configurer avec python3 dans un premier temps : | + | |
| - | + | ||
| - | <code root>update-alternatives --config python</code> | + | |
| - | <code retour> | + | |
| - | Il existe 2 choix pour l'alternative python (qui fournit /usr/bin/python). | + | |
| - | + | ||
| - | Sélection Chemin Priorité État | + | |
| - | ------------------------------------------------------------ | + | |
| - | * 0 /usr/bin/python3.4 2 mode automatique | + | |
| - | 1 /usr/bin/python2.7 1 mode manuel | + | |
| - | 2 /usr/bin/python3.4 2 mode manuel | + | |
| - | + | ||
| - | Appuyez sur <Entrée> pour conserver la valeur par défaut[*] ou choisissez le num | + | |
| - | </code> | + | |
| - | + | ||
| - | On choisit la sélection correspondante à python2.7 pour tout le système. Ici c'est le choix n°1. | + | |
| - | + | ||
| - | <note warning> | + | |
| - | * À savoir pour supprimer l'un des choix de la liste : | + | |
| - | + | ||
| - | <code root>update-alternatives --remove python /usr/bin/python2.7</code> | + | |
| - | + | ||
| - | * Ne jamais désinstaller les versions inférieures à python 3 ! \\ De nombreux logiciels ne fonctionneraient plus. | + | |
| - | + | ||
| - | ''<del>apt-get purge python</del>'' | + | |
| - | </note> | + | |
| - | + | ||
| - | * Pour vérifier | + | |
| - | + | ||
| - | <code root>python --version</code> | + | |
| - | <code retour>Python 2.7.9</code> | + | |
| - | + | ||
| - | <note tip> | + | |
| - | L'idée suivie ici sera de conserver python2 pour tout le système, et de mettre en place python3 dans un environnement virtuel consacré aux projets django. \\ | + | |
| - | Pour installer Django avec python3 y compris **dans un environnement virtuel on n'utilisera pas** ''virtualenv'', afin de s'éviter quelque conflits lors de l'installation de django. \\ | + | **On n'utilisera pas ''virtualenv'' seul, mais on l'utilisera avec ''pyenv'' afin de s'éviter quelque conflits lors de l'installation de django.** \\ |
| En effet : | En effet : | ||
| Ligne 165: | Ligne 128: | ||
| </code> | </code> | ||
| - | </note> | + | :-/ |
| + | <code user>rm -r ~/MonPy3Django</code> | ||
| + | </note> | ||
| + | ==== Installer pyenv==== | ||
| - | ===Configurer son système avec Python3 pour l'utilisateur courant :=== | + | * Références : https://github.com/yyuu/pyenv |
| - | * On édite le fichier "~/bashrc" : | + | <code user>git clone https://github.com/yyuu/pyenv.git ~/.pyenv</code> |
| - | <code user>vim ~/.bashrc</code> | + | * On configure le PATH en ajoutant quelques lignes au fichier ~/.bashrc |
| - | * On ajoute cet alias : | ||
| - | |||
| - | <code> | ||
| - | alias python='/usr/bin/python3.4' | ||
| - | </code> | ||
| - | |||
| - | * On enregistre puis on actualise l'environnement de l'utilisateur courant : | ||
| - | |||
| - | <code user>. ~/.bashrc</code> | ||
| - | |||
| - | <code user>python --version</code> | ||
| - | |||
| - | <code retour>Python 3.4.2</code> | ||
| - | |||
| - | |||
| - | ===== Configurations et installation de Django avec SQLite3===== | ||
| - | |||
| - | ==== Installer Django dans un environnement virtuel avec pyenv==== | ||
| - | |||
| - | <code user>git clone https://github.com/yyuu/pyenv.git ~/.pyenv</code> | ||
| <code user>echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc</code> | <code user>echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc</code> | ||
| <code user>echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc</code> | <code user>echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc</code> | ||
| <code user>echo 'eval "$(pyenv init -)"' >> ~/.bashrc</code> | <code user>echo 'eval "$(pyenv init -)"' >> ~/.bashrc</code> | ||
| + | |||
| + | * On recharge son shell | ||
| + | |||
| <code user>exec $SHELL</code> | <code user>exec $SHELL</code> | ||
| - | <code user>pyenv</code> | ||
| - | <code retour>pyenv 20151124-16-g132179d | ||
| - | Usage: pyenv <command> [<args>] | ||
| - | Some useful pyenv commands are: | + | * On installe les versions de python que l'on voudra utiliser dans différents projets |
| - | commands List all available pyenv commands | + | |
| - | local Set or show the local application-specific Python version | + | |
| - | global Set or show the global Python version | + | |
| - | shell Set or show the shell-specific Python version | + | |
| - | install Install a Python version using python-build | + | |
| - | uninstall Uninstall a specific Python version | + | |
| - | rehash Rehash pyenv shims (run this after installing executables) | + | |
| - | version Show the current Python version and its origin | + | |
| - | versions List all Python versions available to pyenv | + | |
| - | which Display the full path to an executable | + | |
| - | whence List all Python versions that contain the given executable | + | |
| - | See `pyenv help <command>' for information on a specific command. | ||
| - | For full documentation, see: https://github.com/yyuu/pyenv#readme</code> | ||
| <code user>pyenv install 2.7.9</code> | <code user>pyenv install 2.7.9</code> | ||
| <code user>pyenv install 3.4.3</code> | <code user>pyenv install 3.4.3</code> | ||
| Ligne 232: | Ligne 165: | ||
| 3.4.3</code> | 3.4.3</code> | ||
| | | ||
| - | * les commandes pyenv | + | ===Quelques commandes pyenv=== |
| - | + | ||
| - | <code user>pyenv +lacommande</code> | + | |
| * Avoir une liste des commandes pyenv | * Avoir une liste des commandes pyenv | ||
| Ligne 253: | Ligne 184: | ||
| </code> | </code> | ||
| - | * Configurer la version du shell pyenv pour choisir sa version de python | + | * Comment lancer une commande pyenv |
| - | - Pour que le shell utilise la version 2 installée plutôt | + | |
| + | <code user>pyenv +lacommande</code> | ||
| + | |||
| + | * Pour coder dans une version de python, on appelle le shell de pyenv de la version souhaitée | ||
| + | |||
| + | - Pour utiliser la version 2 (installée plutôt) | ||
| <code user>pyenv shell 2.7.9</code> | <code user>pyenv shell 2.7.9</code> | ||
| - Pour savoir quelle est la version de son shell | - Pour savoir quelle est la version de son shell | ||
| Ligne 266: | Ligne 202: | ||
| <code user>/home/hypathie/.pyenv/shims/python</code> | <code user>/home/hypathie/.pyenv/shims/python</code> | ||
| - | - Pour changer de version de python pour l'environnement virtuel, on fait la même chose avec la version | + | - Pour utiliser la version 3 (installée aussi plutôt) |
| <code user>pyenv shell 3.4.3</code> | <code user>pyenv shell 3.4.3</code> | ||
| <code user>python --version</code> | <code user>python --version</code> | ||
| <code retour>Python 3.4.3</code> | <code retour>Python 3.4.3</code> | ||
| - | * Utiliser virtualenv avec pyenv | + | ====Utiliser virtualenv avec pyenv==== |
| + | |||
| + | * Configuration du système pour utiliser virtualenv avec pyenv | ||
| <code user>git clone https://github.com/yyuu/pyenv-virtualenv.git ~/.pyenv/plugins/pyenv-virtualenv</code> | <code user>git clone https://github.com/yyuu/pyenv-virtualenv.git ~/.pyenv/plugins/pyenv-virtualenv</code> | ||
| <code user>echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc</code> | <code user>echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc</code> | ||
| <code user>exec $SHELL</code> | <code user>exec $SHELL</code> | ||
| - | * Créer un répertoire pour django | + | * Créer un répertoire où l'on pourra installer django pour python 3 |
| - | <code user>mkdir MonPython3Django</code> | + | |
| - | <code user>cd MonPython3Django/</code> | + | <code user>mkdir ProjetsDjangoPy3 && cd ProjetsDjangoPy3</code> |
| <code user>pyenv shell 3.4.3</code> | <code user>pyenv shell 3.4.3</code> | ||
| <code user>python --version</code> | <code user>python --version</code> | ||
| Ligne 288: | Ligne 227: | ||
| </code> | </code> | ||
| <code user>pyenv activate 1.8-3.4</code> | <code user>pyenv activate 1.8-3.4</code> | ||
| + | |||
| + | ====Installer Django ==== | ||
| + | |||
| + | * On vérifie qu'on est dans le répertoire de l'environnement préparé plus haut | ||
| + | |||
| + | <code user>pwd</code> | ||
| + | <code retour>/home/hypathie/ProjetsDjangoPy3</code> | ||
| + | |||
| + | * On installe Django | ||
| + | |||
| <code user>pip install django</code> | <code user>pip install django</code> | ||
| <code retour>You are using pip version 6.0.8, however version 7.1.2 is available. | <code retour>You are using pip version 6.0.8, however version 7.1.2 is available. | ||
| Ligne 299: | Ligne 248: | ||
| (1.8-3.4) hypathie@debian:~/MonPython3Django$ pip install django</code> | (1.8-3.4) hypathie@debian:~/MonPython3Django$ pip install django</code> | ||
| Pas d'erreur cette fois 8-) | Pas d'erreur cette fois 8-) | ||
| - | <code user></code> | ||
| - | <code user></code> | ||
| - | <code user></code> | ||
| + | * Pour vérifier les versions | ||
| - | ==== Installer Django dans un environnement python virtuel ==== | + | <code user>django-admin.py --version</code> |
| + | <code retour>1.9</code> | ||
| - | === On créer un répertoire=== | + | <code user>python --version</code> |
| + | <code user>Python 3.4.3</code> | ||
| - | <code user>virtualenv MonPy3Django -p /usr/bin/python3.4</code> | + | Avec la commande recommandée par la doc officielle de django: |
| - | + | ||
| - | Cela a crée une dossier nommé "PremiersProjetsDjango" dans le répertoire de l'utilisateur courant | + | |
| - | + | ||
| - | + | ||
| - | ===on se place dans le dossier "PremiersProjetsDjango"=== | + | |
| - | + | ||
| - | <code user>cd ~/MonPy3Django/ && ls</code> | + | |
| - | + | ||
| - | Il contient trois dossiers permettant d'utiliser python : | + | |
| - | + | ||
| - | <code retour>bin include lib</code> | + | |
| - | + | ||
| - | Les outils sont dans bin/ | + | |
| - | + | ||
| - | <code user>tree bin/</code> | + | |
| - | <code retour> | + | |
| - | bin/ | + | |
| - | ├── activate | + | |
| - | ├── activate.csh | + | |
| - | ├── activate.fish | + | |
| - | ├── activate_this.py | + | |
| - | ├── easy_install | + | |
| - | ├── easy_install-3.4 | + | |
| - | ├── pip | + | |
| - | ├── pip3 | + | |
| - | ├── pip3.4 | + | |
| - | ├── python -> python3.4 | + | |
| - | ├── python3 -> python3.4 | + | |
| - | └── python3.4 | + | |
| - | </code> | + | |
| - | + | ||
| - | On voit que tout l'environnement pointe vers python3.4 | + | |
| - | + | ||
| - | === On active l'environnement virtuel python=== | + | |
| - | + | ||
| - | + | ||
| - | + | ||
| - | <note tip> | + | |
| - | **Pour sortir de l'environnement virtuel python :** | + | |
| - | + | ||
| - | <code user>deactivate</code> | + | |
| - | </note> | + | |
| - | + | ||
| - | === On installe Django === | + | |
| - | + | ||
| - | <code user>pip3 install django</code> | + | |
| - | + | ||
| - | * Et pour vérifier tout en prenant connaissance de la version de django installée : | + | |
| - | + | ||
| - | (selon la méthode proposer par la doc officielle de Django : https://docs.djangoproject.com/fr/1.8/intro/tutorial01/) | + | |
| <code user>python3 -c "import django; print(django.get_version())"</code> | <code user>python3 -c "import django; print(django.get_version())"</code> | ||
| - | <code retour>1.9</code> | ||
| - | <note tip> | + | on a aussi : |
| - | * **Tout est bien clair ? ** | + | |
| - | <code user>deactivate</code> | ||
| - | <code user>python3 -c "import django; print(django.get_version())"</code> | ||
| - | <code retour> | ||
| - | Traceback (most recent call last): | ||
| - | File "<string>", line 1, in <module> | ||
| - | ImportError: No module named 'django' | ||
| - | </code> | ||
| - | |||
| - | |||
| - | <code user>source bin/activate</code> | ||
| - | <code user>python3 -c "import django; print(django.get_version())"</code> | ||
| <code retour>1.9</code> | <code retour>1.9</code> | ||
| + | 8-) | ||
| - | * Pour avoir la liste de tous les modules python installés dans son environnement : | + | <note tip> |
| + | * Pour sortir de pyenv : | ||
| - | <code user>pip freeze</code> | + | <code user>pyenv deactivate</code> |
| - | <code retour> | + | |
| - | Django==1.9 | + | |
| - | wheel==0.24.0 | + | |
| - | </code> | + | |
| - | + | ||
| - | * **Manuel officiel de pip** : https://pip.pypa.io/en/stable/user_guide/ | + | |
| </note> | </note> | ||
| - | ==== Création d'un premier projet Django==== | + | ====Créer un projet django sous python 3==== |
| <note> | <note> | ||
| - | **Un petit rappel ?** | + | Si l'on reprend le wiki ici ! |
| + | * On va dans son répertoire configuré pour python 3 dans lequel est installé django | ||
| + | <code user>cd ~/ProjetsDjangoPy3/</code> | ||
| - | - On a crée un dossier par exemple sur son bureau pour l'environnement virtuel python "virtualenv PremiersProjetsDjango"; | + | * On active pyenv |
| - | - 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>pyenv activate 1.8-3.4</code> |
| - | + | Le prompt de terminal a changé, il devient quelque chose comme cela : | |
| - | <code user>cd ~/Bureau/PremiersProjetsDjango/</code> | + | <code>(1.8-3.4) hypathie@debian:~/ProjetsDjangoPy3/premierProjet$</code> |
| - | + | ||
| - | <code user>source bin/activate</code> | + | |
| - | + | ||
| - | <code user>python3 -c "import django; print(django.get_version())"</code> | + | |
| </note> | </note> | ||
| - | * Le contenu de son dossier avant création d'un nouveau projet: | + | * Pour créer le projet Django nommé par exemple "premierProjet" |
| - | + | ||
| - | <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>django-admin.py startproject premierProjet</code> | ||
| - | <code user>ls</code> | ||
| - | <code retour>bin include lib premierProjet</code> | ||
| - | * Architecture du dossier premierProjet : | + | <code user>tree</code> |
| - | + | ||
| - | <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> | <code retour> | ||
| - | premierProjet/ | + | . |
| - | ├── manage.py | + | |
| └── premierProjet | └── premierProjet | ||
| - | ├── __init__.py | + | ├── manage.py |
| - | ├── settings.py | + | └── premierProjet |
| - | ├── urls.py | + | ├── __init__.py |
| - | └── wsgi.py | + | ├── settings.py |
| + | ├── urls.py | ||
| + | └── wsgi.py | ||
| </code> | </code> | ||
| - | **Ces fichiers sont :** | + | <note tip> |
| + | **Et voilà, partir de là, on retombe sur nos pattes** \\ | ||
| - | * __premierProjet/__ c'est le répertoire racine qui est le contenant du projet nouvellement créé. | + | On peut suivre simplement le premier projet de la doc officielle de Django et les commandes qu'elle indique alors que notre environnement virtuel est sous python 3 ! \\ https://docs.djangoproject.com/fr/1.8/intro/tutorial01/ |
| - | * __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. | + | * A chaque fois que l'on veut reprendre l'avancement de son projet |
| + | On se place dans le projet Django (répertoire ''premierProjet'' et non dans son sous-répertoire de même nom !) | ||
| - | * 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. | + | <code user>cd ~/ProjetsDjangoPy3/premierProjet/</code> |
| - | * __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). | + | * On active pyenv pour utiliser l'interpréteur python |
| - | * __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. | + | <code user>pyenv activate 1.8-3.4</code> |
| - | * __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. | + | * Pour tester |
| + | <code user>python manage.py runserver</code> | ||
| - | * __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/ | + | ou celle-ci 8-) |
| - | === Premier test=== | + | <code user>python3 manage.py runserver</code> |
| - | * On se place à la racine du nouveau projet : | + | * On inscrit dans son navigateur l'url: "http://localhost:8000/" |
| - | <code user>cd ~/Bureau/PremiersProjetsDjango/premierProjet/</code> | + | Et on obtient : |
| - | <code user>python3 manage.py runserver</code> | + | {{http://pix.toile-libre.org/upload/img/1449147148.png}}\\ |
| - | <code retour> | + | * Pour arrêter le serveur : |
| - | Performing system checks... | + | <code user>ctrl+c</code> |
| - | System check identified no issues (0 silenced). | + | * Pour sortir de l'interpréteur python du shell pyenv |
| + | <code user>pyenv deactivate</code> | ||
| - | 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> | </note> | ||
| - | * Depuis son navigateur on entre dans la barre url: "http://localhost:8000/" | + | =====Résumer des fichiers de configuration et commandes "manage.py" ===== |
| - | On obtient : | + | ===Le fichier ''settings.py'' : pour associer une BDD au projet === |
| + | * On peut aller voir dans le sous-répertoire ''premierProjet'' | ||
| - | {{http://pix.toile-libre.org/upload/img/1449147148.png}}\\ | + | <code user>cd ~/ProjetsDjangoPy3/premierProjet/premierProjet</code> |
| + | <code user>ls</code> | ||
| + | <code retour>__init__.py __pycache__ settings.py urls.py wsgi.py</code> | ||
| - | ====Premier projet avec la base de données sqlite3==== | + | * On édite le fichier ''settings.py'' : |
| - | + | ||
| - | * 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 user>vim settings.py</code> | ||
| - | |||
| - | |||
| <code> | <code> | ||
| Ligne 519: | Ligne 366: | ||
| </code> | </code> | ||
| - | <note tip> | + | * ''ENGINE'' – Par défaut Django utilise 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'. |
| - | * **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. |
| - | * **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. | + | * Puisqu'on y est, on modifie l'encodage : |
| - | </note> | + | On change : |
| + | <code> | ||
| + | LANGUAGE_CODE = 'en-us' | ||
| - | ===Modifier le fichier settings.py et Générer le fichier de base de données SQLite=== | + | TIME_ZONE = 'UTC' |
| + | </code> | ||
| - | * Modifier les paramètres : | + | Par : |
| <code> | <code> | ||
| Ligne 536: | Ligne 386: | ||
| </code> | </code> | ||
| - | * Avant migration : | + | * Dans la section "INSTALLED_APPS" on ajoute la ligne : '' 'polls', '' |
| - | + | ||
| - | <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 retour> | ||
| + | INSTALLED_APPS = ( | ||
| + | 'django.contrib.admin', | ||
| + | 'django.contrib.auth', | ||
| + | 'django.contrib.contenttypes', | ||
| + | 'django.contrib.sessions', | ||
| + | 'django.contrib.messages', | ||
| + | 'django.contrib.staticfiles', | ||
| + | ) | ||
| </code> | </code> | ||
| - | * On lance la commande de migration : | + | Comme ceci : |
| - | + | ||
| - | <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> | <code retour> | ||
| INSTALLED_APPS = ( | INSTALLED_APPS = ( | ||
| Ligne 611: | Ligne 412: | ||
| ) | ) | ||
| </code> | </code> | ||
| + | - Cela dit à Django de générer de fichier de scripts (en sql) correspondant aux entités de la base de données : \\ Voir le paragraphe https://debian-facile.org/utilisateurs:hypathie:tutos:developpement-pyhon-utiliser-django?&#la-commande-managepy-makemigrations | ||
| + | - Cela dit à Django de créer une arborescence de fichiers pour créer des Modèles : \\ Voir le paragraphe création de modèle : https://debian-facile.org/utilisateurs:hypathie:tutos:developpement-pyhon-utiliser-django#le-fichier-modelspy-pour-coder-des-modeles | ||
| - | * À 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). | + | ===Commande manage.py startapp polls : créer les fichiers pour coder en python des Modèles=== |
| - | <code user>python3 manage.py makemigrations</code> | + | * Toujours à la racine du projet Django pour utiliser manage.py |
| - | <code retour>No changes detected</code> | + | |
| - | </note> | + | <code user>cd ~/ProjetsDjangoPy3/premierProjet</code> |
| - | ===Création de Modèle (c'est presque du code first !)=== | + | * Si on est sorti du shell pyenv |
| - | * On se place dans le répertoire "~/Bureau/PremiersProjetsDjango/premierProjet" : | + | <code>pyenv activate 1.8-3.4</code> |
| - | <code user>cd ~/Bureau/PremiersProjetsDjango/premierProjet</code> | + | |
| - | * On utilise manage.py pour créé l'arborescence nécessaire à l'utilisation de Modèle : | + | <code user>python manage.py startapp polls</code> |
| + | |||
| + | <note> | ||
| - | <code user>python3 manage.py startapp polls</code> | + | * On remarque que l'arborescence a changé : |
| Cela a crée le répertoire polls à la racine du dossier consacré au projet django : | 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 user>tree</code> | ||
| Ligne 667: | Ligne 467: | ||
| </code> | </code> | ||
| - | * On crée des Modèles dans le fichier models.py : | + | </note> |
| + | |||
| + | |||
| + | |||
| + | ===Commande de création de Modèles : manage.py migrate=== | ||
| + | |||
| + | On se place à la racine du projet Django | ||
| + | |||
| + | <code user>cd ~/ProjetsDjangoPy3/premierProjet/</code> | ||
| + | |||
| + | On active le shell de pyenv pour utiliser l'une des commandes de manage.py | ||
| + | |||
| + | <code user>pyenv activate 1.8-3.4</code> | ||
| + | |||
| + | Pour charger ou modifier les entités de la base de donnée associée au Modèles du projet Django | ||
| + | |||
| + | <code user>python manage.py migrate</code> | ||
| + | |||
| + | Alors qu'on n'a : | ||
| + | |||
| + | <code user>python --version</code> | ||
| + | <code retour>Python 3.4.3</code> | ||
| + | |||
| + | On peut tout aussi bien lancer cette commande-ci 8-) | ||
| + | |||
| + | <code user>python3 manage.py migrate</code> | ||
| + | |||
| + | |||
| + | **Sur la commande ''python manage.py migrate'' exécutée plutôt** | ||
| + | |||
| + | * On remarque que la commande ''python manage.py migrate'' a créé le fichier ''db.sqlite3'' | ||
| + | |||
| + | <code user>tree</code> | ||
| + | <code retour> | ||
| + | . | ||
| + | ├── 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> | ||
| + | |||
| + | |||
| + | |||
| + | ===La commande manage.py makemigrations === | ||
| + | |||
| + | * À 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>cd ~/ProjetsDjangoPy3/premierProjet/</code> | ||
| + | <code user>pyenv activate 1.8-3.4</code> | ||
| + | |||
| + | <code user>python manage.py makemigrations</code> | ||
| + | <code retour>No changes detected</code> | ||
| + | |||
| + | ===Le fichier models.py pour coder des Modèles === | ||
| + | |||
| + | C'est là qu'on code des Modèles en python : | ||
| + | |||
| + | <code user>cd ~/ProjetsDjangoPy3/premierProjet/ && pyenv activate 1.8-3.4</code> | ||
| <code user>vim polls/models.py</code> | <code user>vim polls/models.py</code> | ||
| Ligne 695: | Ligne 561: | ||
| </file> | </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> | + | * Cette fois la commande "makemigrations" 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>python manage.py makemigrations polls</code> | ||
| <code>Migrations for 'polls': | <code>Migrations for 'polls': | ||
| Ligne 709: | Ligne 576: | ||
| * 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): | * 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> | + | <code user>python 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 : | + | * Mais c'est la commande suivante qui applique les changements correspondants à ce script afin que les entités de la base de données soient l'image des classes du Modèle : |
| - | <code user>python3 manage.py migrate</code> | + | <code user>python 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 | * Il est ensuite possible d'interroger la base de donnée depuis le shell en utilisant les méthodes du Modèle | ||
| Ligne 721: | Ligne 588: | ||
| * Explication sur API : http://sametmax.com/quest-ce-quune-api/ | * 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> | + | ===La commande "python manage.py shell" : pour interroger le Modèle et ses méthodes === |
| + | Si on a désactivé le shell pyenv et/ou qu'on est sorti du dossier pour Django : | ||
| - | * Pour s'exercer : https://docs.djangoproject.com/fr/1.8/intro/tutorial01/#playing-with-the-api | + | <code user>cd ~/ProjetsDjangoPy3/premierProjet/ && pyenv activate 1.8-3.4</code> |
| + | Pour utiliser l'API Django depuis un shell python : | ||
| - | === Création d'un administrateur Django=== | + | <code user>python manage.py shell</code> |
| + | |||
| + | <note> | ||
| + | Et nous, même en lançant ''python manage.py shell'' \\ | ||
| + | |||
| + | On a un shell python de version 3 ! :-D | ||
| + | |||
| + | <code retour> | ||
| + | Python 3.4.3 (default, Dec 8 2015, 11:06:14) | ||
| + | [GCC 4.9.2] on linux | ||
| + | Type "help", "copyright", "credits" or "license" for more information. | ||
| + | (InteractiveConsole) | ||
| + | >>> | ||
| + | </code> | ||
| + | |||
| + | * Évidemment, on code en python 3 dans le fichier de création de Modèle ''models.py'' ! | ||
| + | |||
| + | * Un lien utile sur les différences entre le code python2 et le code python 3 : \\ http://apprendre-python.com/page-syntaxe-differente-python2-python3-python-differences | ||
| + | |||
| + | * Pour plus de détails et s'exercer, exemple du site officiel de Django : \\ https://docs.djangoproject.com/fr/1.8/intro/tutorial01/#playing-with-the-api | ||
| + | |||
| + | </note> | ||
| + | |||
| + | |||
| + | |||
| + | ===== Création d'un administrateur Django===== | ||
| * On se place de le dossier de son projet Django : | * On se place de le dossier de son projet Django : | ||
| Ligne 736: | Ligne 629: | ||
| * On crée un administrateur : | * On crée un administrateur : | ||
| - | <code user>python3 manage.py createsuperuser</code> | + | <code user>python manage.py createsuperuser</code> |
| <code retour> | <code retour> | ||
| Ligne 748: | Ligne 641: | ||
| * Et maintenant on peut accéder à la gestion de son projet depuis son navigateur : | * 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> | + | <code user>python manage.py runserver 192.168.0.26:8000</code> |
| <note tip> | <note tip> | ||
| Ligne 759: | Ligne 652: | ||
| * remarques : | * 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 installer sous le même routeur (dans cet exemple). |
| - | - L'avantage de l'ip de la machine c'est de pouvoir se connecter à son application depuis son navigateur depuis une machine distante. | + | |
| </note> | </note> | ||
| Ligne 767: | Ligne 659: | ||
| <code>192.168.0.26:8000/admin</code> | <code>192.168.0.26:8000/admin</code> | ||
| - | {{http://pix.toile-libre.org/upload/original/1449160999.png}} | + | {{http://pix.toile-libre.org/upload/original/1449160999.png?700}} |
| - | {{http://pix.toile-libre.org/upload/original/1449161189.png}} | + | {{http://pix.toile-libre.org/upload/original/1449161189.png?900}} |
| * Pour apprendre à gérer son site depuis le site d'administration de Django : https://docs.djangoproject.com/fr/1.8/intro/tutorial02/ | * Pour apprendre à gérer son site depuis le site d'administration de Django : https://docs.djangoproject.com/fr/1.8/intro/tutorial02/ | ||
| Ligne 782: | Ligne 674: | ||
| - | ====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> | ||
| - | |||
| - | * Pour utiliser la souris | ||
| - | |||
| - | <code> | ||
| - | set mouse=a | ||
| - | </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> | ||
| - | |||
| - | <note tip> | ||
| - | Ajout dans '' ~/.vimrc '' | ||
| - | <code> | ||
| - | "Racourci clavier pour basculer avec Tagbar | ||
| - | nmap <F2> :TagbarToggle<CR> | ||
| - | </code> | ||
| - | </note> | ||
| - | |||
| - | |||
| - | * Ajout de l'autocomplétion : | ||
| - | <note tip> | ||
| - | Ajout dans '' ~/.vimrc '' | ||
| - | <code> | ||
| - | "Pour utiliser un plugin d'autocomplétion | ||
| - | set omnifunc=syntaxComplet#Complete | ||
| - | </code> | ||
| - | </note> | ||
| - | ===== Configurations et installation de Django avec PostgreSQL===== | ||
