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 [14/12/2015 06:52] Hypathie [Créer des projets Django en python2 ou python3] |
utilisateurs:hypathie:tutos:developpement-pyhon-utiliser-django [20/12/2015 12:36] Hypathie [Résumer des fichiers de configuration et commandes manage.py] |
||
---|---|---|---|
Ligne 66: | Ligne 66: | ||
<code root>apt-get install tree</code> | <code root>apt-get install tree</code> | ||
- | ===Vim IDE coder pour python3 === | + | ===Vim IDE pour coder pour python3 === |
* https://debian-facile.org/utilisateurs:hypathie:tutos:vim-ide-python?&#installer-vim-ide-pour-python | * https://debian-facile.org/utilisateurs:hypathie:tutos:vim-ide-python?&#installer-vim-ide-pour-python | ||
Ligne 74: | Ligne 74: | ||
===== Créer des projets Django en python2 ou python3===== | ===== Créer des projets Django en python2 ou python3===== | ||
- | ===Les versions de python sur sa Jessie === | + | ===Les versions de python sur sa Jessie=== |
<code user> ls /usr/bin/python*</code> | <code user> ls /usr/bin/python*</code> | ||
Ligne 84: | Ligne 84: | ||
/usr/bin/python2-config /usr/bin/python3.4m-config | /usr/bin/python2-config /usr/bin/python3.4m-config | ||
</code> | </code> | ||
+ | |||
+ | ===Problème avec python pour utiliser virtualenv=== | ||
<note tip> | <note tip> | ||
- | **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.** \\ | + | **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.** \\ |
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. | 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. | ||
Ligne 137: | Ligne 139: | ||
<code user>git clone https://github.com/yyuu/pyenv.git ~/.pyenv</code> | <code user>git clone https://github.com/yyuu/pyenv.git ~/.pyenv</code> | ||
+ | |||
+ | * On configure le PATH en ajoutant quelques lignes au fichier ~/.bashrc | ||
+ | |||
<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 198: | Ligne 190: | ||
* Pour coder dans une version de python, on appelle le shell de pyenv de la version souhaitée | * Pour coder dans une version de python, on appelle le shell de pyenv de la version souhaitée | ||
- | - Pour que le shell de pyenv utilise la version 2 (installée plutôt) | + | - 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 210: | Ligne 202: | ||
<code user>/home/hypathie/.pyenv/shims/python</code> | <code user>/home/hypathie/.pyenv/shims/python</code> | ||
- | - Pour que le shell de pyenv utilise la version 3 (installée aussi plutôt) | + | - 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> | ||
Ligne 237: | Ligne 229: | ||
====Installer Django ==== | ====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> | ||
Ligne 262: | Ligne 261: | ||
<code user>python3 -c "import django; print(django.get_version())"</code> | <code user>python3 -c "import django; print(django.get_version())"</code> | ||
- | aussi bien que : | + | on a aussi : |
- | + | ||
- | <code user>python -c "import django; print(django.get_version())"</code> | + | |
<code retour>1.9</code> | <code retour>1.9</code> | ||
Ligne 283: | Ligne 280: | ||
* On va dans son répertoire configuré pour python 3 dans lequel est installé django | * On va dans son répertoire configuré pour python 3 dans lequel est installé django | ||
<code user>cd ~/ProjetsDjangoPy3/</code> | <code user>cd ~/ProjetsDjangoPy3/</code> | ||
+ | |||
+ | * On active pyenv | ||
+ | |||
+ | <code user>pyenv activate 1.8-3.4</code> | ||
+ | Le prompt de terminal a changé, il devient quelque chose comme cela : | ||
+ | <code>(1.8-3.4) hypathie@debian:~/ProjetsDjangoPy3/premierProjet$</code> | ||
</note> | </note> | ||
Ligne 304: | Ligne 307: | ||
<note tip> | <note tip> | ||
- | Et voilà, partir de là, on retombe sur nos pattes et l'on peut suivre simplement le premier projet de la doc officielle de django alors que notre environnement virtuel est sous python 3 ! \\ | + | **Et voilà, partir de là, on retombe sur nos pattes** \\ |
- | https://docs.djangoproject.com/fr/1.8/intro/tutorial01/ \\ | + | 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/ |
- | Notre avantage, on peut aussi bien lancer à la place des deux commandes suivantes : | + | * 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 !) | |
- | * On fait attention d'être bien dans répertoire ''premierProjet'' et non dans son sous-répertoire de même nom ! | + | |
<code user>cd ~/ProjetsDjangoPy3/premierProjet/</code> | <code user>cd ~/ProjetsDjangoPy3/premierProjet/</code> | ||
- | <code user>python manage.py migrate</code> | + | * On active pyenv pour utiliser l'interpréteur python |
- | que celles-ci 8-) | + | <code user>pyenv activate 1.8-3.4</code> |
- | <code user>python3 manage.py migrate</code> | + | * Pour tester |
+ | <code user>python manage.py runserver</code> | ||
- | </note> | ||
+ | ou celle-ci 8-) | ||
- | === Premier test et quelques explications=== | + | <code user>python3 manage.py runserver</code> |
- | <note> | + | * On inscrit dans son navigateur l'url: "http://localhost:8000/" |
- | * On remarque que la commande ''python manage.py migrate'' a créé le fichier ''db.sqlite3'' | + | |
- | <code user>tree</code> | + | Et on obtient : |
- | <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> | + | {{http://pix.toile-libre.org/upload/img/1449147148.png}}\\ |
- | * Par défaut, Django utilise la base de donnée sqlite3 : | + | * Pour arrêter le serveur : |
+ | <code user>ctrl+c</code> | ||
- | Cette fois il faut aller dans le sous-répertoire ''premierProjet'' | + | * Pour sortir de l'interpréteur python du shell pyenv |
+ | <code user>pyenv deactivate</code> | ||
+ | |||
+ | </note> | ||
+ | |||
+ | =====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'' | ||
<code user>cd ~/ProjetsDjangoPy3/premierProjet/premierProjet</code> | <code user>cd ~/ProjetsDjangoPy3/premierProjet/premierProjet</code> | ||
Ligne 354: | Ligne 351: | ||
<code retour>__init__.py __pycache__ settings.py urls.py wsgi.py</code> | <code retour>__init__.py __pycache__ settings.py urls.py wsgi.py</code> | ||
- | * Pour configurer la base de données associée au projet Django, on édite le fichier ''settings.py'' : | + | * On édite le fichier ''settings.py'' : |
<code user>vim settings.py</code> | <code user>vim settings.py</code> | ||
+ | |||
+ | |||
+ | * Indication de la base de données liée à Django | ||
<code> | <code> | ||
Ligne 369: | Ligne 369: | ||
</code> | </code> | ||
- | * **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'. | + | * ''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. | + | * ''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 le fichier ''settings.py'' : | + | * Puisqu'on y est, on modifie l'encodage et le fuseau horaire : |
On change : | On change : | ||
<code> | <code> | ||
Ligne 389: | Ligne 389: | ||
</code> | </code> | ||
- | * On remarque aussi que la commande la section "INSTALLED_APPS" la ligne : '' 'polls', '' | + | ===Commande de création de Modèles : manage.py migrate=== |
- | <code retour> | + | On se place à la racine du projet Django |
- | INSTALLED_APPS = ( | + | |
- | 'django.contrib.admin', | + | |
- | 'django.contrib.auth', | + | |
- | 'django.contrib.contenttypes', | + | |
- | 'django.contrib.sessions', | + | |
- | 'django.contrib.messages', | + | |
- | 'django.contrib.staticfiles', | + | |
- | ) | + | |
- | </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>cd ~/ProjetsDjangoPy3/premierProjet/</code> |
- | <code user>python3 manage.py makemigrations</code> | + | On active le shell de pyenv pour utiliser l'une des commandes de manage.py |
- | <code retour>No changes detected</code> | + | |
+ | <code user>pyenv activate 1.8-3.4</code> | ||
- | </note> | + | Pour charger ou modifier les entités de la base de donnée associée au Modèles du projet Django |
- | * Pour tester le projet Django, si on a bien lancé la commande ''python manage.py runserver'' \\ | + | <code user>python manage.py migrate</code> |
+ | Alors qu'on n'a : | ||
- | <code user>python manage.py runserver</code> | + | <code user>python --version</code> |
+ | <code retour>Python 3.4.3</code> | ||
- | <note> | + | On peut tout aussi bien lancer cette commande-ci 8-) |
- | ou celle-ci | + | |
- | <code user>python3 manage.py runserver</code> | + | <code user>python3 manage.py migrate</code> |
- | 8-) | ||
- | </note> | + | **Sur la commande ''python manage.py migrate'' exécutée plutôt** |
- | * On inscrit dans son navigateur on entre dans la barre url: "http://localhost:8000/" | + | * On remarque que la commande ''python manage.py migrate'' a créé le fichier ''db.sqlite3'' |
- | Et on obtient : | + | <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> | ||
- | {{http://pix.toile-libre.org/upload/img/1449147148.png}}\\ | ||
- | ====Création de Modèle==== | + | ===Commande manage.py startapp polls : créer les fichiers pour coder en python des Modèles=== |
- | C'est presque du code first ! LOL | + | * Toujours à la racine du projet Django pour utiliser manage.py |
- | * On se place dans le répertoire "~/ProjetsDjangoPy3/premierProjet" : | ||
<code user>cd ~/ProjetsDjangoPy3/premierProjet</code> | <code user>cd ~/ProjetsDjangoPy3/premierProjet</code> | ||
- | * On utilise manage.py pour créé l'arborescence nécessaire à l'utilisation de Modèle : | + | * Si on est sorti du shell pyenv |
+ | |||
+ | <code>pyenv activate 1.8-3.4</code> | ||
<code user>python manage.py startapp polls</code> | <code user>python manage.py startapp polls</code> | ||
Ligne 484: | Ligne 491: | ||
- | * On crée des Modèles dans le fichier models.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). | ||
+ | |||
+ | <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 512: | Ligne 536: | ||
</file> | </file> | ||
- | * On édite encore une fois le fichier ''settings.py'' pour ajouter '''polls','' la section ''INSTALLED_APPS'' | ||
- | <code user>vim premierProjet/settings.py</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> | + | |
- | ... | + | |
- | INSTALLED_APPS = [ | + | |
- | 'django.contrib.admin', | + | |
- | 'django.contrib.auth', | + | |
- | 'django.contrib.contenttypes', | + | |
- | 'django.contrib.sessions', | + | |
- | 'django.contrib.messages', | + | |
- | 'django.contrib.staticfiles', | + | |
- | 'polls', | + | |
- | ] | + | |
- | ... | + | |
- | </code> | + | |
- | + | ||
- | * 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>python manage.py makemigrations polls</code> | <code user>python manage.py makemigrations polls</code> | ||
Ligne 545: | Ligne 553: | ||
<code user>python 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>python manage.py migrate</code> | <code user>python manage.py migrate</code> | ||
Ligne 555: | Ligne 563: | ||
* 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 : | + | * 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 : | ||
+ | <code user>cd ~/ProjetsDjangoPy3/premierProjet/ && pyenv activate 1.8-3.4</code> | ||
+ | |||
+ | Pour vérifier avec le gestionnaire **sqlite3** de la base de données **sqlite** ce qu'a créé la commande ''python manage.py migrate'' | ||
+ | |||
+ | <code user>sqlite3 db.sqlite3</code> | ||
+ | <code user>sqlite> .schema</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 : | ||
+ | |||
+ | <code user>cd ~/ProjetsDjangoPy3/premierProjet/ && pyenv activate 1.8-3.4</code> | ||
+ | |||
+ | Pour utiliser l'API Django depuis un shell python : | ||
<code user>python manage.py shell</code> | <code user>python manage.py shell</code> | ||
Ligne 582: | Ligne 605: | ||
- | ==== Création d'un administrateur Django==== | + | ===== 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 : |