신청서는 자체 조치를 manage.py"에 등록할 수 있다. 예를 들어 "manage.py"액션을 Django 앱을 사용하면서 추가하고 싶을수도 있을것이다.\n"이 문서에서는 "조사" 신청에 대한 사용자 정의 ``closepoll 명령어를 :doc:’tutorial1에서 만들 것이다.
이를 위해 애플리케이션에 management/commands 디렉토리를 추가합니다. django는이름이 밑줄로 시작하지 않는 ``manage.py”를 각 디렉토리안에 있는 Python 모듈에 대한 커멘드에 등록할 것이다.
polls/\n __init__.py\n models.py\n management/\n __init__.py\n commands/\n __init__.py\n _private.py\n closepoll.py\n tests.py\n views.py\n이 예에서 ``closepoll” 명령어는 “polls” 적용을 포함하는 모든 프로젝트에서 사용할 수 있게 된다 INSTALLED_APPS.
``_private.py” 모듈은 관리 명령으로 사용할 수 없습니다.
\n``closepoll.py” 모듈은 다음과 같이 확장되는 “Command” 등급을 정의해야 하는 하나의 요건만 가지고 있다.Base Command 또는 그 중 하나인 ref:’subclasses.
\n\n명령을 구현하려면 polls/management/commands/closepoll.py 를 편집하십시오
from django.core.management.base import BaseCommand, CommandError\nfrom polls.models import Question as Poll\n\nclass Command(BaseCommand):\n help = 'Closes the specified poll for voting'\n\n def add_arguments(self, parser):\n parser.add_argument('poll_ids', nargs='+', type=int)\n\n def handle(self, *args, **options):\n for poll_id in options['poll_ids']:\n try:\n poll = Poll.objects.get(pk=poll_id)\n except Poll.DoesNotExist:\n raise CommandError('Poll "%s" does not exist' % poll_id)\n\n poll.opened = False\n poll.save()\n\n self.stdout.write(self.style.SUCCESS('Successfully closed poll "%s"' % poll_id))\n새로운 커스텀 커맨드는 python manage.py closepoll 1.를 사용하여 부를 수 있다
``handle()” 방식은 하나 이상의 ``poll_ids”를 가져다가 ``poll. opened”를 각각 “False”로 설정한다. 사용자가 존재하지 않는 폴링을 참조한 경우:exc:Command Error가 발생합니다. “poll.opened” 속성은 :doc:”tutorial”에 존재하지 않으며 이 예시에서는 “polls.models.example’에 추가되었다
\n동일한 ``closepoll”를 쉽게 수정해 추가 명령줄 옵션을 수용함으로써 해당 여론조사를 마감하는 대신 삭제할 수 있다. 이러한 사용자 지정 옵션은 다음과 같은 :meth:’~BaseCommand.add_arguments 메서드에 추가할 수 있습니다.
\nclass Command(BaseCommand):\n def add_arguments(self, parser):\n # Positional arguments\n parser.add_argument('poll_ids', nargs='+', type=int)\n\n # Named (optional) arguments\n parser.add_argument(\n '--delete',\n action='store_true',\n help='Delete poll instead of closing it',\n )\n\n def handle(self, *args, **options):\n # ...\n if options['delete']:\n poll.delete()\n # ...\n핸들 방법의 dict 매개변수의 옵션(‘delete’)을 사용할 수 있습니다. “add_argument” 사용에 대한 자세한 내용은 :py:mod:’argparse’ Python 문서를 참조하십시오.
\n사용자 지정 명령줄 옵션을 추가할 수 있을 뿐만 아니라 모든 :doc:’관리 명령’은 :option:’–verbity’ 및 :option:’–traceback’과 같은 기본 옵션을 사용할 수 있습니다.
\n기본적으로 관리 명령은 현재 활성 로케일로 실행됩니다.
\n어떤 이유로 사용자 지정 관리 명령이 활성 로케일 없이 실행되어야 하는 경우(예: 변환된 콘텐츠가 데이터베이스에 삽입되지 않도록 하려면, 다음 방법:meth:’~BaseCommand.handle’에서 “@no_translations’ decorator”를 사용하여 변환을 비활성화하십시오.
\nfrom django.core.management.base import BaseCommand, no_translations\n\nclass Command(BaseCommand):\n ...\n\n @no_translations\n def handle(self, *args, **options):\n ...\n변환 비활성화에는 구성된 설정에 대한 액세스 권한이 필요하므로 구성된 설정 없이 작동하는 명령에는 장식자를 사용할 수 없습니다.
\n사용자 지정 관리 명령의 테스트 방법에 대한 정보는 :ref:’testing documents’에서 확인할 수 있습니다.
\nDjango는 내장 명령을 등록한 다음 :seting:’에서 명령어를 검색한다.`INSTALLED_APPs는 역방향입니다. 검색 중에 명령 이름이 이미 등록된 명령을 중복하면 새로 검색된 명령이 첫 번째 명령을 재정의합니다.
\n즉, 명령을 재정의하려면 새 명령의 이름이 동일해야 하며 해당 앱은 재정의된 명령의 앱 앞에 있어야 합니다. setting:’INSTALLED_APPS.
\n의도하지 않게 재정의된 타사 앱의 관리 명령은 오버라이드 커맨드의 “Command” 를 들여오는 프로젝트의 앱(:setting:`INSTALLED_APPS`으로 서드파티 앱 앞에 주문된 ) 중 하나에 새 명령을 만들어 새 이름으로 사용할 수 있습니다
\n모든 관리 명령이 궁극적으로 파생되는 기본 클래스입니다.
\n명령줄 인수를 구문 분석하고 응답으로 호출할 코드를 알아내는 모든 메커니즘에 액세스하려면 이 클래스를 사용합니다. 이러한 동작을 변경할 필요가 없으면 ref:’subclasses’ 중 하나를 사용하십시오.
\n:클래스 하위 분류:’BaseCommand’ 클래스는 :meth:’~BaseCommand.handle’ 메소드를 구현해야 합니다.
\n모든 속성은 파생 클래스에서 설정할 수 있으며:class:BaseCommand’s :ref:`subclasses1에서 사용할 수 있습니다.
\n사용자가 python manage" 명령을 실행할 때 도움말 메시지에 표시되는 명령어에 대한 간단한 설명입니다 ``python manage.py help 1.
명령에서 필수 위치 인수를 정의하는 경우 인수가 누락된 경우 반환되는 메시지 오류를 사용자 정의할 수 있습니다. 기본값은 :py:mod:’argparse’(“너무 적은 인수”) 출력입니다.
\n명령어가 SQL 문을 출력하는지 여부를 나타내는 부울로, “True”일 경우 출력은 자동으로 “BEGIN”과 “COMIT”로 포장된다. 기본값은 “False”입니다.
\n불. “True”인 경우 명령은 디스크의 마이그레이션 집합이 데이터베이스의 마이그레이션과 일치하지 않을 경우 경고를 인쇄합니다. 경고는 명령 실행을 차단하지 않습니다. 기본값은 “False”입니다.
\nA list or tuple of tags, e.g. [Tags.staticfiles, Tags.models]. System\nchecks registered in the chosen tags\nwill be checked for errors prior to executing the command. The value\n'__all__' can be used to specify that all system checks should be\nperformed. Default value is '__all__'.
“stdout” 또는 “stderr”에 쓸 때 컬러 출력을 생성하는 데 도움이 되는 인스턴스 속성이다. 예를 들어:
\nself.stdout.write(self.style.SUCCESS('...'))\n색상표를 수정하는 방법과 사용 가능한 스타일을 보려면 Syntax coloring 을 참조하십시오(이 절에서 설명하는 “roles”의 대문자 버전 사용).
\n명령을 실행할 때 “-no-color” 옵션을 통과하면 모든 ``self.style()” 호출이 원래 문자열을 무색하게 반환됩니다.
\nThe default command options to suppress in the help output. This should be\na set of option names (e.g. '--verbosity'). The default values for the\nsuppressed options are still passed.
:class:’BaseCommand’에는 무시할 수 있는 몇 가지 방법이 있지만 :meth:’~BaseCommand.handle’ 방법만 구현하면 됩니다.
\n\n“CommandParser” 인스턴스를 반환하는데, 이 인스턴스는 Django에 대한 사용자 지정이 몇 가지 있는:class:ArgumentParser 서브클래스이다
You can customize the instance by overriding this method and calling\nsuper() with kwargs of ArgumentParser parameters.
명령에 전달된 명령줄 인수를 처리할 구문 분석기 인수를 추가하는 진입점입니다. 사용자 지정 명령은 이 메서드를 재정의하여 명령에서 수락한 위치 및 선택적 인수를 모두 추가해야 합니다. “BaseCommand”를 직접 하위 분류할 때는 “super()”라고 부를 필요가 없다.
\n내장된 모든 Django 명령에 대해 정확해야 하는 Django 버전을 반환합니다. 사용자 제공 명령은 해당 버전을 반환하기 위해 이 방법을 재정의할 수 있습니다.
\nTries to execute this command, performing system checks if needed (as\ncontrolled by the requires_system_checks attribute). If the command\nraises a CommandError, it’s intercepted and printed to stderr.
명령의 실제 논리입니다. 하위 클래스는 이 방법을 구현해야 합니다.
\n그것은 “stdout”으로 인쇄될 문자열을 반환할 수도 있다. (‘BEGIN’과 ‘’COMIT’’로 포장된 문자열:attr:’output_transaction’이 “true”일 경우)
\nUses the system check framework to inspect the entire Django project for\npotential problems. Serious problems are raised as a CommandError;\nwarnings are output to stderr; minor notifications are output to\nstdout.
“app_configs”와 “tags”가 둘 다 “None”이면 모든 시스템 점검이 이루어진다. “‘compatibility’ 또는 ‘’models’’과 같은 체크 태그의 목록이 될 수 있다.
\nBaseCommand 하위 클래스Link to this heading#하나 이상의 설치된 응용 프로그램 레이블을 인수로 사용하고 각 레이블로 작업을 수행하는 관리 명령입니다.
\n서브클래스는 :meth:’~BaseCommand.handle’을 구현하기 보다는 :meth:’~AppCommand.handle_app_config’를 구현해야 하며, 각 애플리케이션마다 한 번씩 호출된다.
\n“app_config”에 대한 명령의 작업을 수행합니다. 이 작업은 :class가 됩니다.’~django.the’AppConfig’ 인스턴스는 명령줄에 지정된 애플리케이션 레이블에 해당합니다.
\n명령줄에서 하나 이상의 임의 인수(라벨)를 가져와 각 인수와 작업을 수행하는 관리 명령입니다.
\n서브클래스는 :meth:’~BaseCommand.handle’을 구현하기 보다는 :meth:’~LabelCommand.handle_label’을 구현해야 하며, 각 레이블에 대해 한 번 호출된다.
\n명령에 전달된 임의 인수를 설명하는 문자열입니다. 문자열은 명령의 사용 텍스트 및 오류 메시지에 사용됩니다. 기본값은 “‘label‘“입니다.
\n명령줄에 지정된 문자열인 “라벨”에 대해 명령의 작업을 수행합니다.
\n관리 명령을 실행하는 동안 문제를 나타내는 예외 클래스입니다.
\nIf this exception is raised during the execution of a management command from a\ncommand line console, it will be caught and turned into a nicely-printed error\nmessage to the appropriate output stream (i.e., stderr); as a result,\nraising this exception (with a sensible description of the error) is the\npreferred way to indicate that something has gone wrong in the execution of a\ncommand. It accepts the optional returncode argument to customize the exit\nstatus for the management command to exit with, using sys.exit().
코드에서 :func:’~django.core.management.call_command’까지 관리 명령이 호출되면 필요할 때 예외를 잡는 것은 사용자의 몫입니다.
\n