shell コマンドの作り方Link to this heading#Djangoの shell は、モデルと設定へのアクセスを提供する対話型の Python 環境であり、コードのテスト、クエリの実験、アプリケーションデータとのやりとりに役立ちます。
shell コマンドをカスタマイズすることで、機能を追加したり、特定のモジュールをプリロードしたりできます。そのためには、 django.core.management.commands.shell.Command のサブクラスを作成し、既存の shell 管理コマンドをオーバーライドする新しい管理コマンドを作成します。詳細については、 コマンドのオーバーライド に関するガイドを参照してください。
shell 管理コマンドの自動インポート動作をカスタマイズするには、 get_auto_imports() メソッドをオーバーライドします。このメソッドは、アプリケーションで利用可能なオブジェクトまたはモジュールのインポートパスのシーケンスを返す必要があります。例えば:
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 ]\nThe customization above adds resolve() and\nreverse() to the default namespace, which already includes\nall models from the apps listed in INSTALLED_APPS plus what is\nimported by default. These objects will be available in the shell without\nrequiring a manual import.
このようにカスタムした shell コマンドを verbosity=2 を付けて実行すると、次のように表示されます：
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\nオーバーライドされた shell コマンドにインポートできないパスが含まれている場合、 verbosity を 1 以上に設定するとエラーが表示されます。重複したインポートは自動的に処理されます。
特定の shell セッションで自動インポートを無効にしたい場合は、 --no-imports フラグを使用してください。自動インポートを恒久的に無効にするには、get_auto_imports() をオーバーライドして None を返すようにします：
class Command(shell.Command):\n def get_auto_imports(self):\n return None\n