shellLien vers cette rubrique#Le shell Django est un environnement Python interactif donnant accès aux modèles et aux réglages, ce qui en fait un outil important pour tester du code, expérimenter avec des requêtes ou pour interagir avec les données d’une application.
La personnalisation de la commande shell permet d’ajouter des fonctionnalités supplémentaires ou de précharger des modules spécifiques. Pour cela, créez une nouvelle commande d’administration héritant de django.core.management.commands.shell.Command et surchargez la commande shell existante. Pour plus de détails, référez-vous au guide sur la surcharge des commandes.
Pour personnaliser le comportement d’importation automatique de la commande d’administration shell, surchargez la méthode get_auto_imports(). Cette méthode doit renvoyer une séquence de chemins d’importation pour des objets et des modules disponibles dans l’application. Par exemple :
polls/management/commands/shell.pyfrom django.core.management.commands import shell\n\n\nclass Command(shell.Command):\n def get_auto_imports(self):\n return super().get_auto_imports() + [\n "django.urls.reverse",\n "django.urls.resolve",\n ]\nLa personnalisation ci-dessus ajoute resolve() and reverse() à l’espace de noms par défaut, qui contient déjà tous les modèles des applications présentes dans INSTALLED_APPS, en plus de ce qui est importé par défaut. Ces objets seront disponibles dans le shell sans devoir les importer manuellement.
Le lancement de cette commande shell personnalisée avec verbosity=2 va afficher :
13 objects imported automatically:\n\n from django.db import connection, reset_queries, models\n from django.conf import settings\n from django.contrib.admin.models import LogEntry\n from django.contrib.auth.models import Group, Permission, User\n from django.contrib.contenttypes.models import ContentType\n from django.contrib.sessions.models import Session\n from django.urls import resolve, reverse\n from django.utils import timezone\nSi une commande shell personnalisée inclut des chemins qui ne peuvent pas être importés, ces erreurs sont affichées si verbosity est à 1 ou plus. Les importations à double sont gérées automatiquement.
Notez que les importations automatiques peuvent être désactivées pour une session shell spécifique en utilisant l’option --no-imports. Pour désactiver les importations automatiques de manière permanente, surchargez get_auto_imports() pour qu’elle renvoie None:
class Command(shell.Command):\n def get_auto_imports(self):\n return None\n