| ... | ... | @@ -2,7 +2,7 @@ Commandes utiles pour interagir avec gestioCOF |
|
|
|
===========================================
|
|
|
|
|
|
|
|
Django fournit un certain nombre de fonctions pour interagir avec GestioCOF en ligne
|
|
|
|
de commande. Pour les lancer, taper `python manage.py <command_name>`. Une partie
|
|
|
|
de commande. Pour les lancer, taper `python manage.py <command_name>`. Une partie
|
|
|
|
d'entre elles sont décrites ci-dessous.
|
|
|
|
|
|
|
|
Les indispensables
|
| ... | ... | @@ -10,9 +10,37 @@ Les indispensables |
|
|
|
|
|
|
|
- La commande `runserver`… lance le serveur ! On peut spécifier une interface et un port
|
|
|
|
en ajoutant à la suite `0.0.0.0:8000` par exemple.
|
|
|
|
- La commande `migrate` permet de faire évoluer la base de donnée lorsque les modèles
|
|
|
|
- La commande `migrate` permet de faire suivre la base de donnée lorsque les modèles
|
|
|
|
changent. Les "migrations" appliquées par `migrate` sont stockées dans `app_name/migrations/`.
|
|
|
|
Lorsque vous effectuez des changements dans les modèles, utiliser `makemigrations` (cf plus bas)
|
|
|
|
Lorsque vous effectuez des changements dans les modèles, utilisez `makemigrations` (cf plus bas)
|
|
|
|
pour créer ces fichiers de migration automatiquement.
|
|
|
|
On peut viser une version précise de la BDD, pour une application, avec `migrate bda 0001`
|
|
|
|
On peut rétablir une version précise de la BDD, pour une application, avec `migrate bda 0001`
|
|
|
|
par exemple.
|
|
|
|
- La commande `makemigrations` crée automatiquement les fichiers de migrations dont il est question
|
|
|
|
plus haut. Ils sont stockés dans `app_name/migrations/`. Ils peuvent être édités à la main si les
|
|
|
|
migrations automatiques ne suffisent pas à vos besoins. Typiquement s'il faut ajouter un élément à la
|
|
|
|
base de donnée pour la rendre cohérente. Cf
|
|
|
|
https://docs.djangoproject.com/en/1.9/ref/migration-operations/ pour plus de détails. Voir aussi
|
|
|
|
https://git.eleves.ens.fr/cof-geek/gestioCOF/blob/master/bda/migrations/0002_add_tirage.py comme
|
|
|
|
exemple.
|
|
|
|
- La commande `createsuperuser` permet de créer un utilisateur avec tous les droits. Il peut créer des
|
|
|
|
utilisateurs, des objets, etc via l'[interface-admin](gestiocof admin).
|
|
|
|
|
|
|
|
Autres commandes utiles
|
|
|
|
----------------------------------
|
|
|
|
|
|
|
|
- La commande `shell` ouvre un shell python qui connaît la config du site. Ça permet de faire toutes
|
|
|
|
les opérations qu'on pourrait faire depuis une vue par exemple. Utile pour faire des essais avant de coder
|
|
|
|
ou manipuler la base de données.
|
|
|
|
- Un autre commande permettant de manipuler la base de donneés : `dbshell` qui lance un shell mysql
|
|
|
|
sur la BDD de GestioCOF
|
|
|
|
- Les commandes `loaddata` et `dumpdata` permettent respectivement de charger et d'exporter tout ou
|
|
|
|
partie de la base de données. À noter que l'option `--indent=4` est utile pour la lisibilité. Attention il peut
|
|
|
|
se passer des choses pas nettes si on charge une bdd dans une bdd non vide.
|
|
|
|
|
|
|
|
Doc officielle
|
|
|
|
-----------------
|
|
|
|
|
|
|
|
Pour plus de détails sur ces commandes et d'autres encore, ne pas hésiter à taper
|
|
|
|
`python manage.py help <command_name>`et à visiter
|
|
|
|
https://docs.djangoproject.com/en/1.9/ref/django-admin/ |
|
|
\ No newline at end of file |
