====== Développer en Python3 avec Django======
* Objet : Installer un environnement virtuel pour coder en python3 avec Django
* Niveau requis : {{tag>débutant}}
===== Installations =====
===Installer les outils et bibliothèques pour développer en python ou python3===
Sur Jessie, python et python 3 sont tous deux installés.
* Fichiers d'en-tête de Python
apt-get install python-dev python3-dev
* Pour l'algèbre avec scipy
apt-get install libblas3 libblas-dev liblapack3 liblapack-dev
* Bibliothèques FreeType nécessaire par matplotlib
apt-get install libfreetype6 libfreetype6-dev
* Dépendances nécessaire pour la cryptographie
apt-get install libffi-dev libssl-dev
* Les paquets Core Python
apt-get install python-pip python3-pip
apt-get install python-virtualenv
À savoir sur Jessie, il est inutile de lancer :
''apt-get install python3-virtualenv'' \\
En effet, avec la commande ''apt-get install python-virtualenv'' a installé ''python3-virtualenv'' et ''python-virtualenv''
- ''python3-pip'' (ou ''python-pip'') : installateur de paquets python, Pip permet d'installer aisément des modules Python, à la manière dont on installe des paquets dans une distribution linux;
- ''python3-dev'' (ou ''python-dev'' ): permet d'utiliser des outils de développement pour la construction des modules Python, non pris en charge par pip, en particulier pour utiliser des bibliothèques avec des extensions en C
- ''virtualenv'' : permet de créer un environnement cloisonné Python
* À consulter : https://virtualenv.readthedocs.org/en/latest/ \\ https://github.com/neurite/debian-setup/wiki/Basic-Development-Setup-on-Debian
* Installer la documentation python
apt-get install python-doc python3-doc
* pour utiliser pyenv
apt-get install -y make build-essential libssl-dev zlib1g-dev libbz2-dev \
libreadline-dev libsqlite3-dev wget curl llvm libncurses5-dev
* Sans rapport avec le développement mais utilisé plus bas
apt-get install tree
===Vim IDE pour coder pour python3 ===
* 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
===== Créer des projets Django en python2 ou python3=====
===Les versions de python sur sa Jessie===
ls /usr/bin/python*
/usr/bin/python /usr/bin/python3 /usr/bin/python3-config
/usr/bin/python2 /usr/bin/python3.4 /usr/bin/python3m
/usr/bin/python2.7 /usr/bin/python3.4-config /usr/bin/python3m-config
/usr/bin/python2.7-config /usr/bin/python3.4m /usr/bin/python-config
/usr/bin/python2-config /usr/bin/python3.4m-config
===Problème avec python pour utiliser virtualenv===
**L'idée suivie ici est de pouvoir aussi bien créer des projets Django pour dans la version 2 que la version 3 de python.** \\
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. \\
Cela évitera aussi de se mélanger les pinceaux entre les utilitaires ''pip install ...'' ou ''pip3 install ...''. \\
**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 :
python --version
Python 3.4.2
virtualenv MonPy3Django -p /usr/bin/python3.4
cd MonPy3Django/
source bin/activate 1.8-3.4
Downloading/unpacking django
Downloading Django-1.9-py2.py3-none-any.whl (6.6MB): 6.6MB downloaded
Installing collected packages: django
*** Error compiling '/tmp/pip-build-c20d1nfa/django/django/conf/app_template/apps.py'...
File "/tmp/pip-build-c20d1nfa/django/django/conf/app_template/apps.py", line 4
class {{ camel_case_app_name }}Config(AppConfig):
^
SyntaxError: invalid syntax
*** Error compiling '/tmp/pip-build-c20d1nfa/django/django/conf/app_template/models.py'...
File "/tmp/pip-build-c20d1nfa/django/django/conf/app_template/models.py", line 1
{{ unicode_literals }}from django.db import models
^
SyntaxError: invalid syntax
Successfully installed django
Cleaning up...
:-/
rm -r ~/MonPy3Django
==== Installer pyenv====
* Références : https://github.com/yyuu/pyenv
git clone https://github.com/yyuu/pyenv.git ~/.pyenv
* On configure le PATH en ajoutant quelques lignes au fichier ~/.bashrc
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
* On recharge son shell
exec $SHELL
* On installe les versions de python que l'on voudra utiliser dans différents projets
pyenv install 2.7.9
pyenv install 3.4.3
L'exécution des deux commandes précédentes est longue. Patience...
pyenv versions
* system (set by /home/hypathie/.pyenv/version)
2.7.9
3.4.3
===Quelques commandes pyenv===
* Avoir une liste des commandes pyenv
pyenv
Some useful pyenv commands are:
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
* Comment lancer une commande pyenv
pyenv +lacommande
* 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)
pyenv shell 2.7.9
- Pour savoir quelle est la version de son shell
pyenv shell
2.7.9
- version de python utilisée
python --version
Python 2.7.9
- Depuis où ?
which python
/home/hypathie/.pyenv/shims/python
- Pour utiliser la version 3 (installée aussi plutôt)
pyenv shell 3.4.3
python --version
Python 3.4.3
====Utiliser virtualenv avec pyenv====
* Configuration du système pour utiliser virtualenv avec pyenv
git clone https://github.com/yyuu/pyenv-virtualenv.git ~/.pyenv/plugins/pyenv-virtualenv
echo 'eval "$(pyenv virtualenv-init -)"' >> ~/.bashrc
exec $SHELL
* Créer un répertoire où l'on pourra installer django pour python 3
mkdir ProjetsDjangoPy3 && cd ProjetsDjangoPy3
pyenv shell 3.4.3
python --version
Python 3.4.3
pyenv virtualenv 1.8-3.4
Ignoring indexes: https://pypi.python.org/simple
Requirement already satisfied (use --upgrade to upgrade): setuptools in /home/hypathie/.pyenv/versions/3.4.3/envs/1.8-3.4/lib/python3.4/site-packages
Requirement already satisfied (use --upgrade to upgrade): pip in /home/hypathie/.pyenv/versions/3.4.3/envs/1.8-3.4/lib/python3.4/site-packages
pyenv activate 1.8-3.4
====Installer Django ====
* On vérifie qu'on est dans le répertoire de l'environnement préparé plus haut
pwd
/home/hypathie/ProjetsDjangoPy3
* On installe Django
pip install django
You are using pip version 6.0.8, however version 7.1.2 is available.
You should consider upgrading via the 'pip install --upgrade pip' command.
Collecting django
Downloading Django-1.9-py2.py3-none-any.whl (6.6MB)
100% |################################| 6.6MB 88kB/s
Installing collected packages: django
Successfully installed django-1.9
(1.8-3.4) hypathie@debian:~/MonPython3Django$ pip install django
Pas d'erreur cette fois 8-)
* Pour vérifier les versions
django-admin.py --version
1.9
python --version
Python 3.4.3
Avec la commande recommandée par la doc officielle de django:
python3 -c "import django; print(django.get_version())"
on a aussi :
1.9
8-)
* Pour sortir de pyenv :
pyenv deactivate
====Créer un projet django sous python 3====
Si l'on reprend le wiki ici !
* On va dans son répertoire configuré pour python 3 dans lequel est installé django
cd ~/ProjetsDjangoPy3/
* On active pyenv
pyenv activate 1.8-3.4
Le prompt de terminal a changé, il devient quelque chose comme cela :
(1.8-3.4) hypathie@debian:~/ProjetsDjangoPy3/premierProjet$
* Pour créer le projet Django nommé par exemple "premierProjet"
django-admin.py startproject premierProjet
tree
.
└── premierProjet
├── manage.py
└── premierProjet
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py
**Et voilà, partir de là, on retombe sur nos pattes** \\
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/
* 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 !)
cd ~/ProjetsDjangoPy3/premierProjet/
* On active pyenv pour utiliser l'interpréteur python
pyenv activate 1.8-3.4
* Pour tester
python manage.py runserver
ou celle-ci 8-)
python3 manage.py runserver
* On inscrit dans son navigateur l'url: "http://localhost:8000/"
Et on obtient :
{{http://pix.toile-libre.org/upload/img/1449147148.png}}\\
* Pour arrêter le serveur :
ctrl+c
* Pour sortir de l'interpréteur python du shell pyenv
pyenv deactivate
=====Résumer des fichiers de configuration et commandes "manage.py" =====
===Le fichier ''settings.py'' : pour associer une BDD au projet ===
* On peut aller voir dans le sous-répertoire ''premierProjet''
cd ~/ProjetsDjangoPy3/premierProjet/premierProjet
ls
__init__.py __pycache__ settings.py urls.py wsgi.py
* On édite le fichier ''settings.py'' :
vim settings.py
* Indication de la base de données liée à Django
...
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
}
}
...
* ''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'.
* ''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 et le fuseau horaire :
On change :
LANGUAGE_CODE = 'en-us'
TIME_ZONE = 'UTC'
Par :
LANGUAGE_CODE = 'fr-fr'
TIME_ZONE = 'Europe/Paris'
===Commande de création de Modèles : manage.py migrate===
On se place à la racine du projet Django
cd ~/ProjetsDjangoPy3/premierProjet/
On active le shell de pyenv pour utiliser l'une des commandes de manage.py
pyenv activate 1.8-3.4
Pour charger ou modifier les entités de la base de donnée associée au Modèles du projet Django
python manage.py migrate
Alors qu'on n'a :
python --version
Python 3.4.3
On peut tout aussi bien lancer cette commande-ci 8-)
python3 manage.py migrate
**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''
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
===Commande manage.py startapp polls : créer les fichiers pour coder en python des Modèles===
* Toujours à la racine du projet Django pour utiliser manage.py
cd ~/ProjetsDjangoPy3/premierProjet
* Si on est sorti du shell pyenv
pyenv activate 1.8-3.4
python manage.py startapp polls
* On remarque que l'arborescence a changé :
Cela a crée le répertoire polls à la racine du dossier consacré au projet django :
tree
.
├── 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
===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).
cd ~/ProjetsDjangoPy3/premierProjet/
pyenv activate 1.8-3.4
python manage.py makemigrations
No changes detected
===Le fichier models.py pour coder des Modèles ===
C'est là qu'on code des Modèles en python :
cd ~/ProjetsDjangoPy3/premierProjet/ && pyenv activate 1.8-3.4
vim polls/models.py
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
* 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" :
python manage.py makemigrations polls
Migrations for 'polls':
0001_initial.py:
- Create model Choice
- Create model Question
- Add field question to choice
* 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):
python manage.py sqlmigrate polls 0001
* 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 :
python manage.py migrate
* Il est ensuite possible d'interroger la base de donnée depuis le shell en utilisant les méthodes du Modèle \\ Voir ci-dessous : https://debian-facile.org/utilisateurs:hypathie:tutos:developpement-pyhon-utiliser-django?&#la-commande-python-managepy-shellpour-interroger-le-modele-et-ses-methodes
* 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 le gestionnaire en ligne de commandes sqlite3 : https://debian-facile.org/utilisateurs:hypathie:tutos:installer-et-utiliser-sqlite?&#introduction
Si ce n'est pas déjà fait :
cd ~/ProjetsDjangoPy3/premierProjet/ && pyenv activate 1.8-3.4
Pour vérifier avec le gestionnaire **sqlite3** de la base de données **sqlite** ce qu'a créé la commande ''python manage.py migrate''
sqlite3 db.sqlite3
sqlite> .schema
===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 :
cd ~/ProjetsDjangoPy3/premierProjet/ && pyenv activate 1.8-3.4
Pour utiliser l'API Django depuis un shell python :
python manage.py shell
Et nous, même en lançant ''python manage.py shell'' \\
On a un shell python de version 3 ! :-D
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)
>>>
* É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
===== Création d'un administrateur Django=====
* On se place de le dossier de son projet Django :
cd ~/ProjetsDjangoPy3/premierProjet/
* On crée un administrateur :
python manage.py createsuperuser
Username (leave blank to use 'hypathie'): Hypathie
Email address: hypathie@gmx.fr
Password:
Password (again):
Superuser created successfully.
* Et maintenant on peut accéder à la gestion de son projet depuis son navigateur :
python manage.py runserver 192.168.0.26:8000
Modifier 192.168.0.26 par l'ip de la machine sur laquelle le projet est installé.
Pour le savoir :
ifconfig
* remarques :
- 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).
* On tape dans son navigateur par exemple :
192.168.0.26:8000/admin
{{http://pix.toile-libre.org/upload/original/1449160999.png?700}}
{{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/
* 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
===== Notes =====
===Installer un gabarit : base_site.html===
Voir : https://docs.djangoproject.com/fr/1.8/intro/tutorial02/#customizing-your-project-s-templates
find /home/hypathie/ -print0 |grep -FzZ "admin/base_site.html"
cd /home/hypathie/.pyenv/versions/3.4.3/envs/1.8-3.4/lib/python3.4/site-packages/django/contrib/admin/templates/admin
cp base_site.html /home/hypathie/ProjetsDjangoPy3/premierProjet/templates/admin/
===Personnaliser l'index de la page d'administration===
Voir : https://docs.djangoproject.com/fr/1.8/intro/tutorial02/#customize-the-admin-index-page
cp /home/hypathie/.pyenv/versions/3.4.3/envs/1.8-3.4/lib/python3.4/site-packages/django/contrib/admin/templates/admin/index.html /home/hypathie/ProjetsDjangoPy3/premierProjet/templates/admin/