2015-03-07 10:40:30 +00:00
|
|
|
|
.\" Man page generated from reStructuredText.
|
|
|
|
|
.
|
2021-09-20 18:55:10 +00:00
|
|
|
|
.TH "DJANGO-ADMIN" "1" "September 20, 2021" "4.0" "Django"
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SH NAME
|
2021-09-20 18:55:10 +00:00
|
|
|
|
django-admin \- Utility script for the Django web framework
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.
|
|
|
|
|
.nr rst2man-indent-level 0
|
|
|
|
|
.
|
|
|
|
|
.de1 rstReportMargin
|
|
|
|
|
\\$1 \\n[an-margin]
|
|
|
|
|
level \\n[rst2man-indent-level]
|
|
|
|
|
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
-
|
|
|
|
|
\\n[rst2man-indent0]
|
|
|
|
|
\\n[rst2man-indent1]
|
|
|
|
|
\\n[rst2man-indent2]
|
|
|
|
|
..
|
|
|
|
|
.de1 INDENT
|
|
|
|
|
.\" .rstReportMargin pre:
|
|
|
|
|
. RS \\$1
|
|
|
|
|
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
|
|
|
|
|
. nr rst2man-indent-level +1
|
|
|
|
|
.\" .rstReportMargin post:
|
|
|
|
|
..
|
|
|
|
|
.de UNINDENT
|
|
|
|
|
. RE
|
|
|
|
|
.\" indent \\n[an-margin]
|
|
|
|
|
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
.nr rst2man-indent-level -1
|
|
|
|
|
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
|
|
|
|
|
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
|
|
|
|
|
..
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBdjango\-admin\fP is Django\(aqs command\-line utility for administrative tasks.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
This document outlines all it can do.
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.sp
|
2019-04-01 10:04:08 +00:00
|
|
|
|
In addition, \fBmanage.py\fP is automatically created in each Django project. It
|
|
|
|
|
does the same thing as \fBdjango\-admin\fP but also sets the
|
|
|
|
|
\fBDJANGO_SETTINGS_MODULE\fP environment variable so that it points to your
|
|
|
|
|
project\(aqs \fBsettings.py\fP file.
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.sp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
The \fBdjango\-admin\fP script should be on your system path if you installed
|
2020-05-12 05:21:09 +00:00
|
|
|
|
Django via \fBpip\fP\&. If it\(aqs not in your path, ensure you have your virtual
|
|
|
|
|
environment activated.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Generally, when working on a single Django project, it\(aqs easier to use
|
2015-03-07 10:40:30 +00:00
|
|
|
|
\fBmanage.py\fP than \fBdjango\-admin\fP\&. If you need to switch between multiple
|
|
|
|
|
Django settings files, use \fBdjango\-admin\fP with
|
|
|
|
|
\fBDJANGO_SETTINGS_MODULE\fP or the \fI\%\-\-settings\fP command line
|
|
|
|
|
option.
|
|
|
|
|
.sp
|
|
|
|
|
The command\-line examples throughout this document use \fBdjango\-admin\fP to
|
2015-09-23 23:28:33 +00:00
|
|
|
|
be consistent, but any example can use \fBmanage.py\fP or \fBpython \-m django\fP
|
|
|
|
|
just as well.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SH USAGE
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
$ django\-admin <command> [options]
|
|
|
|
|
$ manage.py <command> [options]
|
2015-09-23 23:28:33 +00:00
|
|
|
|
$ python \-m django <command> [options]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
\fBcommand\fP should be one of the commands listed in this document.
|
|
|
|
|
\fBoptions\fP, which is optional, should be zero or more of the options available
|
|
|
|
|
for the given command.
|
|
|
|
|
.SS Getting runtime help
|
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B django\-admin help
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Run \fBdjango\-admin help\fP to display usage information and a list of the
|
|
|
|
|
commands provided by each application.
|
|
|
|
|
.sp
|
|
|
|
|
Run \fBdjango\-admin help \-\-commands\fP to display a list of all available
|
|
|
|
|
commands.
|
|
|
|
|
.sp
|
|
|
|
|
Run \fBdjango\-admin help <command>\fP to display a description of the given
|
|
|
|
|
command and a list of its available options.
|
|
|
|
|
.SS App names
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Many commands take a list of "app names." An "app name" is the basename of
|
2015-03-07 10:40:30 +00:00
|
|
|
|
the package containing your models. For example, if your \fBINSTALLED_APPS\fP
|
|
|
|
|
contains the string \fB\(aqmysite.blog\(aq\fP, the app name is \fBblog\fP\&.
|
|
|
|
|
.SS Determining the version
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin version
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Run \fBdjango\-admin version\fP to display the current Django version.
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
The output follows the schema described in \fI\%PEP 440\fP:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
1.4.dev17026
|
|
|
|
|
1.4a1
|
|
|
|
|
1.4
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS Displaying debug output
|
|
|
|
|
.sp
|
2021-09-20 18:55:10 +00:00
|
|
|
|
Use \fI\%\-\-verbosity\fP, where it is supported, to specify the amount of
|
|
|
|
|
notification and debug information that \fBdjango\-admin\fP prints to the console.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SH AVAILABLE COMMANDS
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBcheck\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin check [app_label [app_label ...]]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Uses the system check framework to inspect the entire
|
|
|
|
|
Django project for common problems.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
By default, all apps will be checked. You can check a subset of apps by
|
|
|
|
|
providing a list of app labels as arguments:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin check auth admin myapp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-tag TAGS, \-t TAGS
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
The system check framework performs many different types of checks that are
|
|
|
|
|
categorized with tags\&. You can use these
|
|
|
|
|
tags to restrict the checks performed to just those in a particular category.
|
|
|
|
|
For example, to perform only models and compatibility checks, run:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin check \-\-tag models \-\-tag compatibility
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2020-05-12 05:21:09 +00:00
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies the database to run checks requiring database access:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin check \-\-database default \-\-database other
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
By default, these checks will not be run.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-list\-tags
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Lists all available tags.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2008-07-06 06:39:44 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-deploy
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Activates some additional checks that are only relevant in a deployment setting.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
You can use this option in your local development environment, but since your
|
|
|
|
|
local development settings module may not have many of your production settings,
|
|
|
|
|
you will probably want to point the \fBcheck\fP command at a different settings
|
2021-01-14 10:24:18 +00:00
|
|
|
|
module, either by setting the \fBDJANGO_SETTINGS_MODULE\fP environment
|
|
|
|
|
variable, or by passing the \fB\-\-settings\fP option:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin check \-\-deploy \-\-settings=production_settings
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Or you could run it directly on a production or staging deployment to verify
|
|
|
|
|
that the correct settings are in use (omitting \fB\-\-settings\fP). You could even
|
|
|
|
|
make it part of your integration test suite.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-fail\-level {CRITICAL,ERROR,WARNING,INFO,DEBUG}
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies the message level that will cause the command to exit with a non\-zero
|
|
|
|
|
status. Default is \fBERROR\fP\&.
|
|
|
|
|
.SS \fBcompilemessages\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2008-07-06 06:39:44 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B django\-admin compilemessages
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Compiles \fB\&.po\fP files created by \fI\%makemessages\fP to \fB\&.mo\fP files for
|
|
|
|
|
use with the built\-in gettext support. See /topics/i18n/index\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-locale LOCALE, \-l LOCALE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the locale(s) to process. If not provided, all locales are processed.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-exclude EXCLUDE, \-x EXCLUDE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the locale(s) to exclude from processing. If not provided, no locales
|
2015-03-07 10:40:30 +00:00
|
|
|
|
are excluded.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-use\-fuzzy, \-f
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2021-01-14 10:24:18 +00:00
|
|
|
|
Includes \fI\%fuzzy translations\fP into compiled files.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin compilemessages \-\-locale=pt_BR
|
|
|
|
|
django\-admin compilemessages \-\-locale=pt_BR \-\-locale=fr \-f
|
|
|
|
|
django\-admin compilemessages \-l pt_BR
|
|
|
|
|
django\-admin compilemessages \-l pt_BR \-l fr \-\-use\-fuzzy
|
|
|
|
|
django\-admin compilemessages \-\-exclude=pt_BR
|
|
|
|
|
django\-admin compilemessages \-\-exclude=pt_BR \-\-exclude=fr
|
|
|
|
|
django\-admin compilemessages \-x pt_BR
|
|
|
|
|
django\-admin compilemessages \-x pt_BR \-x fr
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-ignore PATTERN, \-i PATTERN
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Ignores directories matching the given \fI\%glob\fP\-style pattern. Use
|
|
|
|
|
multiple times to ignore more.
|
|
|
|
|
.sp
|
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin compilemessages \-\-ignore=cache \-\-ignore=outdated/*/locale
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBcreatecachetable\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B django\-admin createcachetable
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Creates the cache tables for use with the database cache backend using the
|
2017-09-22 16:26:46 +00:00
|
|
|
|
information from your settings file. See /topics/cache for more
|
2015-03-07 10:40:30 +00:00
|
|
|
|
information.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database in which the cache table(s) will be created. Defaults to
|
|
|
|
|
\fBdefault\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-dry\-run
|
|
|
|
|
.UNINDENT
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Prints the SQL that would be run without actually running it, so you can
|
|
|
|
|
customize it or use the migrations framework.
|
|
|
|
|
.SS \fBdbshell\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-10-10 09:39:14 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B django\-admin dbshell
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Runs the command\-line client for the database engine specified in your
|
2017-09-22 16:26:46 +00:00
|
|
|
|
\fBENGINE\fP setting, with the connection parameters
|
|
|
|
|
specified in your \fBUSER\fP, \fBPASSWORD\fP, etc., settings.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
For PostgreSQL, this runs the \fBpsql\fP command\-line client.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
For MySQL, this runs the \fBmysql\fP command\-line client.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
For SQLite, this runs the \fBsqlite3\fP command\-line client.
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.IP \(bu 2
|
|
|
|
|
For Oracle, this runs the \fBsqlplus\fP command\-line client.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2019-09-10 08:10:50 +00:00
|
|
|
|
This command assumes the programs are on your \fBPATH\fP so that a call to
|
2015-09-23 23:28:33 +00:00
|
|
|
|
the program name (\fBpsql\fP, \fBmysql\fP, \fBsqlite3\fP, \fBsqlplus\fP) will find the
|
2018-05-17 13:30:20 +00:00
|
|
|
|
program in the right place. There\(aqs no way to specify the location of the
|
2015-09-23 23:28:33 +00:00
|
|
|
|
program manually.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database onto which to open a shell. Defaults to \fBdefault\fP\&.
|
2020-05-12 05:21:09 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\- ARGUMENTS
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Any arguments following a \fB\-\-\fP divider will be passed on to the underlying
|
|
|
|
|
command\-line client. For example, with PostgreSQL you can use the \fBpsql\fP
|
|
|
|
|
command\(aqs \fB\-c\fP flag to execute a raw SQL query directly:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
$ django\-admin dbshell \-\- \-c \(aqselect current_user\(aq
|
|
|
|
|
current_user
|
|
|
|
|
\-\-\-\-\-\-\-\-\-\-\-\-\-\-
|
|
|
|
|
postgres
|
|
|
|
|
(1 row)
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
On MySQL/MariaDB, you can do this with the \fBmysql\fP command\(aqs \fB\-e\fP flag:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
$ django\-admin dbshell \-\- \-e "select user()"
|
|
|
|
|
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
|
|
|
|
| user() |
|
|
|
|
|
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
|
|
|
|
| djangonaut@localhost |
|
|
|
|
|
+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
\fBNOTE:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
Be aware that not all options set in the \fBOPTIONS\fP part of your
|
|
|
|
|
database configuration in \fBDATABASES\fP are passed to the
|
|
|
|
|
command\-line client, e.g. \fB\(aqisolation_level\(aq\fP\&.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBdiffsettings\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B django\-admin diffsettings
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Displays differences between the current settings file and Django\(aqs default
|
2017-09-22 16:26:46 +00:00
|
|
|
|
settings (or another settings file specified by \fI\%\-\-default\fP).
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Settings that don\(aqt appear in the defaults are followed by \fB"###"\fP\&. For
|
|
|
|
|
example, the default settings don\(aqt define \fBROOT_URLCONF\fP, so
|
2015-03-07 10:40:30 +00:00
|
|
|
|
\fBROOT_URLCONF\fP is followed by \fB"###"\fP in the output of
|
|
|
|
|
\fBdiffsettings\fP\&.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-all
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Displays all settings, even if they have Django\(aqs default value. Such settings
|
2017-09-22 16:26:46 +00:00
|
|
|
|
are prefixed by \fB"###"\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-default MODULE
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
The settings module to compare the current settings against. Leave empty to
|
2018-05-17 13:30:20 +00:00
|
|
|
|
compare against Django\(aqs default settings.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-output {hash,unified}
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies the output format. Available values are \fBhash\fP and \fBunified\fP\&.
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBhash\fP is the default mode that displays the output that\(aqs described above.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
\fBunified\fP displays the output similar to \fBdiff \-u\fP\&. Default settings are
|
|
|
|
|
prefixed with a minus sign, followed by the changed setting prefixed with a
|
|
|
|
|
plus sign.
|
|
|
|
|
.SS \fBdumpdata\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin dumpdata [app_label[.ModelName] [app_label[.ModelName] ...]]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2010-10-10 09:39:14 +00:00
|
|
|
|
Outputs to standard output all data in the database associated with the named
|
|
|
|
|
application(s).
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
If no application name is provided, all installed applications will be dumped.
|
|
|
|
|
.sp
|
|
|
|
|
The output of \fBdumpdata\fP can be used as input for \fI\%loaddata\fP\&.
|
|
|
|
|
.sp
|
|
|
|
|
Note that \fBdumpdata\fP uses the default manager on the model for selecting the
|
2018-05-17 13:30:20 +00:00
|
|
|
|
records to dump. If you\(aqre using a custom manager as
|
2015-03-07 10:40:30 +00:00
|
|
|
|
the default manager and it filters some of the available records, not all of the
|
|
|
|
|
objects will be dumped.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-all, \-a
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Uses Django\(aqs base manager, dumping records which might otherwise be filtered
|
2017-09-22 16:26:46 +00:00
|
|
|
|
or modified by a custom manager.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-10-10 09:39:14 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-format FORMAT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the serialization format of the output. Defaults to JSON. Supported
|
|
|
|
|
formats are listed in serialization\-formats\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-10-10 09:39:14 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-indent INDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the number of indentation spaces to use in the output. Defaults to
|
|
|
|
|
\fBNone\fP which displays all data on single line.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-exclude EXCLUDE, \-e EXCLUDE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Prevents specific applications or models (specified in the form of
|
2021-09-20 18:55:10 +00:00
|
|
|
|
\fBapp_label.ModelName\fP) from being dumped. If you specify a model name, then
|
|
|
|
|
only that model will be excluded, rather than the entire application. You can
|
|
|
|
|
also mix application names and model names.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
If you want to exclude multiple applications, pass \fB\-\-exclude\fP more than
|
|
|
|
|
once:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin dumpdata \-\-exclude=auth \-\-exclude=contenttypes
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies the database from which data will be dumped. Defaults to \fBdefault\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-natural\-foreign
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Uses the \fBnatural_key()\fP model method to serialize any foreign key and
|
|
|
|
|
many\-to\-many relationship to objects of the type that defines the method. If
|
2018-05-17 13:30:20 +00:00
|
|
|
|
you\(aqre dumping \fBcontrib.auth\fP \fBPermission\fP objects or
|
2017-09-22 16:26:46 +00:00
|
|
|
|
\fBcontrib.contenttypes\fP \fBContentType\fP objects, you should probably use this
|
|
|
|
|
flag. See the natural keys
|
|
|
|
|
documentation for more details on this and the next option.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-natural\-primary
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Omits the primary key in the serialized data of this object since it can be
|
|
|
|
|
calculated during deserialization.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-pks PRIMARY_KEYS
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Outputs only the objects specified by a comma separated list of primary keys.
|
|
|
|
|
This is only available when dumping one model. By default, all the records of
|
|
|
|
|
the model are output.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-output OUTPUT, \-o OUTPUT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies a file to write the serialized data to. By default, the data goes to
|
|
|
|
|
standard output.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
When this option is set and \fB\-\-verbosity\fP is greater than 0 (the default), a
|
2015-09-23 23:28:33 +00:00
|
|
|
|
progress bar is shown in the terminal.
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.SS Fixtures compression
|
|
|
|
|
.sp
|
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
The output file can be compressed with one of the \fBbz2\fP, \fBgz\fP, \fBlzma\fP, or
|
|
|
|
|
\fBxz\fP formats by ending the filename with the corresponding extension.
|
|
|
|
|
For example, to output the data as a compressed JSON file:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin dumpdata \-o mydata.json.gz
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBflush\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin flush
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2015-09-23 23:28:33 +00:00
|
|
|
|
Removes all data from the database and re\-executes any post\-synchronization
|
|
|
|
|
handlers. The table of which migrations have been applied is not cleared.
|
|
|
|
|
.sp
|
|
|
|
|
If you would rather start from an empty database and re\-run all migrations, you
|
|
|
|
|
should drop and recreate the database and then run \fI\%migrate\fP instead.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-noinput, \-\-no\-input
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Suppresses all user prompts.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database to flush. Defaults to \fBdefault\fP\&.
|
|
|
|
|
.SS \fBinspectdb\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin inspectdb [table [table ...]]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2015-09-23 23:28:33 +00:00
|
|
|
|
Introspects the database tables in the database pointed\-to by the
|
2015-03-07 10:40:30 +00:00
|
|
|
|
\fBNAME\fP setting and outputs a Django model module (a \fBmodels.py\fP
|
2018-05-17 13:30:20 +00:00
|
|
|
|
file) to standard output.
|
|
|
|
|
.sp
|
|
|
|
|
You may choose what tables or views to inspect by passing their names as
|
|
|
|
|
arguments. If no arguments are provided, models are created for views only if
|
2019-01-17 10:26:40 +00:00
|
|
|
|
the \fI\%\-\-include\-views\fP option is used. Models for partition tables are
|
|
|
|
|
created on PostgreSQL if the \fI\%\-\-include\-partitions\fP option is used.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Use this if you have a legacy database with which you\(aqd like to use Django.
|
2015-09-23 23:28:33 +00:00
|
|
|
|
The script will inspect the database and create a model for each table within
|
|
|
|
|
it.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
As you might expect, the created models will have an attribute for every field
|
2015-09-23 23:28:33 +00:00
|
|
|
|
in the table. Note that \fBinspectdb\fP has a few special cases in its field\-name
|
|
|
|
|
output:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
If \fBinspectdb\fP cannot map a column\(aqs type to a model field type, it\(aqll
|
2015-03-07 10:40:30 +00:00
|
|
|
|
use \fBTextField\fP and will insert the Python comment
|
|
|
|
|
\fB\(aqThis field type is a guess.\(aq\fP next to the field in the generated
|
2017-09-22 16:26:46 +00:00
|
|
|
|
model. The recognized fields may depend on apps listed in
|
|
|
|
|
\fBINSTALLED_APPS\fP\&. For example, \fBdjango.contrib.postgres\fP adds
|
|
|
|
|
recognition for several PostgreSQL\-specific field types.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.IP \(bu 2
|
|
|
|
|
If the database column name is a Python reserved word (such as
|
|
|
|
|
\fB\(aqpass\(aq\fP, \fB\(aqclass\(aq\fP or \fB\(aqfor\(aq\fP), \fBinspectdb\fP will append
|
|
|
|
|
\fB\(aq_field\(aq\fP to the attribute name. For example, if a table has a column
|
|
|
|
|
\fB\(aqfor\(aq\fP, the generated model will have a field \fB\(aqfor_field\(aq\fP, with
|
|
|
|
|
the \fBdb_column\fP attribute set to \fB\(aqfor\(aq\fP\&. \fBinspectdb\fP will insert
|
|
|
|
|
the Python comment
|
|
|
|
|
\fB\(aqField renamed because it was a Python reserved word.\(aq\fP next to the
|
|
|
|
|
field.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
This feature is meant as a shortcut, not as definitive model generation. After
|
2018-05-17 13:30:20 +00:00
|
|
|
|
you run it, you\(aqll want to look over the generated models yourself to make
|
|
|
|
|
customizations. In particular, you\(aqll need to rearrange models\(aq order, so that
|
2015-03-07 10:40:30 +00:00
|
|
|
|
models that refer to other models are ordered properly.
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Django doesn\(aqt create database defaults when a
|
2015-03-07 10:40:30 +00:00
|
|
|
|
\fBdefault\fP is specified on a model field.
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Similarly, database defaults aren\(aqt translated to model field defaults or
|
2015-03-07 10:40:30 +00:00
|
|
|
|
detected in any fashion by \fBinspectdb\fP\&.
|
|
|
|
|
.sp
|
|
|
|
|
By default, \fBinspectdb\fP creates unmanaged models. That is, \fBmanaged = False\fP
|
2018-05-17 13:30:20 +00:00
|
|
|
|
in the model\(aqs \fBMeta\fP class tells Django not to manage each table\(aqs creation,
|
2015-03-07 10:40:30 +00:00
|
|
|
|
modification, and deletion. If you do want to allow Django to manage the
|
2018-05-17 13:30:20 +00:00
|
|
|
|
table\(aqs lifecycle, you\(aqll need to change the
|
2019-09-10 08:10:50 +00:00
|
|
|
|
\fBmanaged\fP option to \fBTrue\fP (or remove
|
2015-03-07 10:40:30 +00:00
|
|
|
|
it because \fBTrue\fP is its default value).
|
2019-01-17 10:26:40 +00:00
|
|
|
|
.SS Database\-specific notes
|
|
|
|
|
.SS Oracle
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Models are created for materialized views if \fI\%\-\-include\-views\fP is
|
|
|
|
|
used.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS PostgreSQL
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Models are created for foreign tables.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Models are created for materialized views if
|
|
|
|
|
\fI\%\-\-include\-views\fP is used.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Models are created for partition tables if
|
|
|
|
|
\fI\%\-\-include\-partitions\fP is used.
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database to introspect. Defaults to \fBdefault\fP\&.
|
2018-05-17 13:30:20 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2019-01-17 10:26:40 +00:00
|
|
|
|
.B \-\-include\-partitions
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
If this option is provided, models are also created for partitions.
|
|
|
|
|
.sp
|
|
|
|
|
Only support for PostgreSQL is implemented.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2018-05-17 13:30:20 +00:00
|
|
|
|
.B \-\-include\-views
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
If this option is provided, models are also created for database views.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBloaddata\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin loaddata fixture [fixture ...]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2010-10-10 09:39:14 +00:00
|
|
|
|
Searches for and loads the contents of the named fixture into the database.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database into which the data will be loaded. Defaults to
|
|
|
|
|
\fBdefault\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-10-10 09:39:14 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-ignorenonexistent, \-i
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Ignores fields and models that may have been removed since the fixture was
|
|
|
|
|
originally generated.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-app APP_LABEL
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies a single app to look for fixtures in rather than looking in all apps.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-format FORMAT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies the serialization format (e.g.,
|
|
|
|
|
\fBjson\fP or \fBxml\fP) for fixtures \fI\%read from stdin\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-exclude EXCLUDE, \-e EXCLUDE
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Excludes loading the fixtures from the given applications and/or models (in the
|
|
|
|
|
form of \fBapp_label\fP or \fBapp_label.ModelName\fP). Use the option multiple
|
|
|
|
|
times to exclude more than one app or model.
|
2018-05-17 13:30:20 +00:00
|
|
|
|
.SS What\(aqs a "fixture"?
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
A \fIfixture\fP is a collection of files that contain the serialized contents of
|
|
|
|
|
the database. Each fixture has a unique name, and the files that comprise the
|
|
|
|
|
fixture can be distributed over multiple directories, in multiple applications.
|
|
|
|
|
.sp
|
|
|
|
|
Django will search in three locations for fixtures:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP 1. 3
|
|
|
|
|
In the \fBfixtures\fP directory of every installed application
|
|
|
|
|
.IP 2. 3
|
|
|
|
|
In any directory named in the \fBFIXTURE_DIRS\fP setting
|
|
|
|
|
.IP 3. 3
|
|
|
|
|
In the literal path named by the fixture
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Django will load any and all fixtures it finds in these locations that match
|
|
|
|
|
the provided fixture names.
|
|
|
|
|
.sp
|
|
|
|
|
If the named fixture has a file extension, only fixtures of that type
|
|
|
|
|
will be loaded. For example:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin loaddata mydata.json
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
would only load JSON fixtures called \fBmydata\fP\&. The fixture extension
|
|
|
|
|
must correspond to the registered name of a
|
2015-09-23 23:28:33 +00:00
|
|
|
|
serializer (e.g., \fBjson\fP or \fBxml\fP).
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
If you omit the extensions, Django will search all available fixture types
|
|
|
|
|
for a matching fixture. For example:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin loaddata mydata
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
would look for any fixture of any fixture type called \fBmydata\fP\&. If a fixture
|
|
|
|
|
directory contained \fBmydata.json\fP, that fixture would be loaded
|
|
|
|
|
as a JSON fixture.
|
|
|
|
|
.sp
|
|
|
|
|
The fixtures that are named can include directory components. These
|
|
|
|
|
directories will be included in the search path. For example:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin loaddata foo/bar/mydata.json
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
would search \fB<app_label>/fixtures/foo/bar/mydata.json\fP for each installed
|
|
|
|
|
application, \fB<dirname>/foo/bar/mydata.json\fP for each directory in
|
|
|
|
|
\fBFIXTURE_DIRS\fP, and the literal path \fBfoo/bar/mydata.json\fP\&.
|
|
|
|
|
.sp
|
|
|
|
|
When fixture files are processed, the data is saved to the database as is.
|
|
|
|
|
Model defined \fBsave()\fP methods are not called, and
|
|
|
|
|
any \fBpre_save\fP or
|
|
|
|
|
\fBpost_save\fP signals will be called with
|
|
|
|
|
\fBraw=True\fP since the instance only contains attributes that are local to the
|
|
|
|
|
model. You may, for example, want to disable handlers that access
|
2018-05-17 13:30:20 +00:00
|
|
|
|
related fields that aren\(aqt present during fixture loading and would otherwise
|
2015-03-07 10:40:30 +00:00
|
|
|
|
raise an exception:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
from django.db.models.signals import post_save
|
|
|
|
|
from .models import MyModel
|
|
|
|
|
|
|
|
|
|
def my_handler(**kwargs):
|
|
|
|
|
# disable the handler during fixture loading
|
|
|
|
|
if kwargs[\(aqraw\(aq]:
|
|
|
|
|
return
|
|
|
|
|
...
|
|
|
|
|
|
|
|
|
|
post_save.connect(my_handler, sender=MyModel)
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2019-09-10 08:10:50 +00:00
|
|
|
|
You could also write a decorator to encapsulate this logic:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
from functools import wraps
|
|
|
|
|
|
|
|
|
|
def disable_for_loaddata(signal_handler):
|
|
|
|
|
"""
|
|
|
|
|
Decorator that turns off signal handlers when loading fixture data.
|
|
|
|
|
"""
|
|
|
|
|
@wraps(signal_handler)
|
|
|
|
|
def wrapper(*args, **kwargs):
|
|
|
|
|
if kwargs[\(aqraw\(aq]:
|
|
|
|
|
return
|
|
|
|
|
signal_handler(*args, **kwargs)
|
|
|
|
|
return wrapper
|
|
|
|
|
|
|
|
|
|
@disable_for_loaddata
|
|
|
|
|
def my_handler(**kwargs):
|
|
|
|
|
...
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Just be aware that this logic will disable the signals whenever fixtures are
|
|
|
|
|
deserialized, not just during \fBloaddata\fP\&.
|
|
|
|
|
.sp
|
|
|
|
|
Note that the order in which fixture files are processed is undefined. However,
|
|
|
|
|
all fixture data is installed as a single transaction, so data in
|
|
|
|
|
one fixture can reference data in another fixture. If the database backend
|
|
|
|
|
supports row\-level constraints, these constraints will be checked at the
|
|
|
|
|
end of the transaction.
|
|
|
|
|
.sp
|
|
|
|
|
The \fI\%dumpdata\fP command can be used to generate input for \fBloaddata\fP\&.
|
|
|
|
|
.SS Compressed fixtures
|
|
|
|
|
.sp
|
2021-01-14 10:24:18 +00:00
|
|
|
|
Fixtures may be compressed in \fBzip\fP, \fBgz\fP, \fBbz2\fP, \fBlzma\fP, or \fBxz\fP
|
|
|
|
|
format. For example:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin loaddata mydata.json
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2021-01-14 10:24:18 +00:00
|
|
|
|
would look for any of \fBmydata.json\fP, \fBmydata.json.zip\fP, \fBmydata.json.gz\fP,
|
|
|
|
|
\fBmydata.json.bz2\fP, \fBmydata.json.lzma\fP, or \fBmydata.json.xz\fP\&. The first
|
|
|
|
|
file contained within a compressed archive is used.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Note that if two fixtures with the same name but different
|
|
|
|
|
fixture type are discovered (for example, if \fBmydata.json\fP and
|
|
|
|
|
\fBmydata.xml.gz\fP were found in the same fixture directory), fixture
|
|
|
|
|
installation will be aborted, and any data installed in the call to
|
|
|
|
|
\fBloaddata\fP will be removed from the database.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.IP "MySQL with MyISAM and fixtures"
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
The MyISAM storage engine of MySQL doesn\(aqt support transactions or
|
|
|
|
|
constraints, so if you use MyISAM, you won\(aqt get validation of fixture
|
2015-03-07 10:40:30 +00:00
|
|
|
|
data, or a rollback if multiple transaction files are found.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.sp
|
|
|
|
|
Support for XZ archives (\fB\&.xz\fP) and LZMA archives (\fB\&.lzma\fP) was added.
|
|
|
|
|
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SS Database\-specific fixtures
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
If you\(aqre in a multi\-database setup, you might have fixture data that
|
2015-03-07 10:40:30 +00:00
|
|
|
|
you want to load onto one database, but not onto another. In this
|
2015-09-23 23:28:33 +00:00
|
|
|
|
situation, you can add a database identifier into the names of your fixtures.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
For example, if your \fBDATABASES\fP setting has a \(aqmaster\(aq database
|
2015-03-07 10:40:30 +00:00
|
|
|
|
defined, name the fixture \fBmydata.master.json\fP or
|
|
|
|
|
\fBmydata.master.json.gz\fP and the fixture will only be loaded when you
|
|
|
|
|
specify you want to load data into the \fBmaster\fP database.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS Loading fixtures from \fBstdin\fP
|
|
|
|
|
.sp
|
|
|
|
|
You can use a dash as the fixture name to load input from \fBsys.stdin\fP\&. For
|
|
|
|
|
example:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin loaddata \-\-format=json \-
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
When reading from \fBstdin\fP, the \fI\%\-\-format\fP option
|
|
|
|
|
is required to specify the serialization format
|
|
|
|
|
of the input (e.g., \fBjson\fP or \fBxml\fP).
|
|
|
|
|
.sp
|
|
|
|
|
Loading from \fBstdin\fP is useful with standard input and output redirections.
|
|
|
|
|
For example:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin dumpdata \-\-format=json \-\-database=test app_label.ModelName | django\-admin loaddata \-\-format=json \-\-database=prod \-
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS \fBmakemessages\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin makemessages
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2008-07-06 06:39:44 +00:00
|
|
|
|
Runs over the entire source tree of the current directory and pulls out all
|
|
|
|
|
strings marked for translation. It creates (or updates) a message file in the
|
2015-03-07 10:40:30 +00:00
|
|
|
|
conf/locale (in the Django tree) or locale (for project and application)
|
|
|
|
|
directory. After making changes to the messages files you need to compile them
|
|
|
|
|
with \fI\%compilemessages\fP for use with the builtin gettext support. See
|
2015-09-23 23:28:33 +00:00
|
|
|
|
the i18n documentation for details.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
This command doesn\(aqt require configured settings. However, when settings aren\(aqt
|
|
|
|
|
configured, the command can\(aqt ignore the \fBMEDIA_ROOT\fP and
|
2019-01-17 10:26:40 +00:00
|
|
|
|
\fBSTATIC_ROOT\fP directories or include \fBLOCALE_PATHS\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-all, \-a
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Updates the message files for all available languages.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-extension EXTENSIONS, \-e EXTENSIONS
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies a list of file extensions to examine (default: \fBhtml\fP, \fBtxt\fP,
|
|
|
|
|
\fBpy\fP or \fBjs\fP if \fI\%\-\-domain\fP is \fBjs\fP).
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin makemessages \-\-locale=de \-\-extension xhtml
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Separate multiple extensions with commas or use \fB\-e\fP or \fB\-\-extension\fP
|
|
|
|
|
multiple times:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin makemessages \-\-locale=de \-\-extension=html,txt \-\-extension xml
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-locale LOCALE, \-l LOCALE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the locale(s) to process.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-exclude EXCLUDE, \-x EXCLUDE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the locale(s) to exclude from processing. If not provided, no locales
|
2015-03-07 10:40:30 +00:00
|
|
|
|
are excluded.
|
|
|
|
|
.sp
|
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin makemessages \-\-locale=pt_BR
|
|
|
|
|
django\-admin makemessages \-\-locale=pt_BR \-\-locale=fr
|
|
|
|
|
django\-admin makemessages \-l pt_BR
|
|
|
|
|
django\-admin makemessages \-l pt_BR \-l fr
|
|
|
|
|
django\-admin makemessages \-\-exclude=pt_BR
|
|
|
|
|
django\-admin makemessages \-\-exclude=pt_BR \-\-exclude=fr
|
|
|
|
|
django\-admin makemessages \-x pt_BR
|
|
|
|
|
django\-admin makemessages \-x pt_BR \-x fr
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-domain DOMAIN, \-d DOMAIN
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the domain of the messages files. Supported options are:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBdjango\fP for all \fB*.py\fP, \fB*.html\fP and \fB*.txt\fP files (default)
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBdjangojs\fP for \fB*.js\fP files
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-symlinks, \-s
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Follows symlinks to directories when looking for new translation strings.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin makemessages \-\-locale=de \-\-symlinks
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-ignore PATTERN, \-i PATTERN
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Ignores files or directories matching the given \fI\%glob\fP\-style pattern. Use
|
|
|
|
|
multiple times to ignore more.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
These patterns are used by default: \fB\(aqCVS\(aq\fP, \fB\(aq.*\(aq\fP, \fB\(aq*~\(aq\fP, \fB\(aq*.pyc\(aq\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin makemessages \-\-locale=en_US \-\-ignore=apps/* \-\-ignore=secret/*.html
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-no\-default\-ignore
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Disables the default values of \fB\-\-ignore\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-no\-wrap
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Disables breaking long message lines into several lines in language files.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-no\-location
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Suppresses writing \(aq\fB#: filename:line\fP’ comment lines in language files.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Using this option makes it harder for technically skilled translators to
|
2018-05-17 13:30:20 +00:00
|
|
|
|
understand each message\(aqs context.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-add\-location [{full,file,never}]
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Controls \fB#: filename:line\fP comment lines in language files. If the option
|
|
|
|
|
is:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBfull\fP (the default if not given): the lines include both file name and
|
|
|
|
|
line number.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBfile\fP: the line number is omitted.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBnever\fP: the lines are suppressed (same as \fI\%\-\-no\-location\fP).
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Requires \fBgettext\fP 0.19 or newer.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-keep\-pot
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Prevents deleting the temporary \fB\&.pot\fP files generated before creating the
|
|
|
|
|
\fB\&.po\fP file. This is useful for debugging errors which may prevent the final
|
|
|
|
|
language files from being created.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
\fBSEE ALSO:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
2015-09-23 23:28:33 +00:00
|
|
|
|
See customizing\-makemessages for instructions on how to customize
|
2015-03-07 10:40:30 +00:00
|
|
|
|
the keywords that \fI\%makemessages\fP passes to \fBxgettext\fP\&.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBmakemigrations\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin makemigrations [app_label [app_label ...]]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Creates new migrations based on the changes detected to your models.
|
|
|
|
|
Migrations, their relationship with apps and more are covered in depth in
|
2017-09-22 16:26:46 +00:00
|
|
|
|
the migrations documentation\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Providing one or more app names as arguments will limit the migrations created
|
|
|
|
|
to the app(s) specified and any dependencies needed (the table at the other end
|
|
|
|
|
of a \fBForeignKey\fP, for example).
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
To add migrations to an app that doesn\(aqt have a \fBmigrations\fP directory, run
|
|
|
|
|
\fBmakemigrations\fP with the app\(aqs \fBapp_label\fP\&.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-noinput, \-\-no\-input
|
|
|
|
|
.UNINDENT
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Suppresses all user prompts. If a suppressed prompt cannot be resolved
|
|
|
|
|
automatically, the command will exit with error code 3.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-empty
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Outputs an empty migration for the specified apps, for manual editing. This is
|
|
|
|
|
for advanced users and should not be used unless you are familiar with the
|
|
|
|
|
migration format, migration operations, and the dependencies between your
|
|
|
|
|
migrations.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-dry\-run
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Shows what migrations would be made without actually writing any migrations
|
|
|
|
|
files to disk. Using this option along with \fB\-\-verbosity 3\fP will also show
|
|
|
|
|
the complete migrations files that would be written.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-merge
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Enables fixing of migration conflicts.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-name NAME, \-n NAME
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2019-01-17 10:26:40 +00:00
|
|
|
|
Allows naming the generated migration(s) instead of using a generated name. The
|
|
|
|
|
name must be a valid Python \fI\%identifier\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-no\-header
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Generate migration files without Django version and timestamp header.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-check
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Makes \fBmakemigrations\fP exit with a non\-zero status when model changes without
|
|
|
|
|
migrations are detected.
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.sp
|
|
|
|
|
Support for calling \fBmakemigrations\fP without an active database
|
|
|
|
|
connection was added. In that case, check for a consistent migration
|
|
|
|
|
history is skipped.
|
|
|
|
|
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBmigrate\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin migrate [app_label] [migration_name]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Synchronizes the database state with the current set of models and migrations.
|
|
|
|
|
Migrations, their relationship with apps and more are covered in depth in
|
2017-09-22 16:26:46 +00:00
|
|
|
|
the migrations documentation\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
The behavior of this command changes depending on the arguments provided:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
No arguments: All apps have all of their migrations run.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fB<app_label>\fP: The specified app has its migrations run, up to the most
|
2018-05-17 13:30:20 +00:00
|
|
|
|
recent migration. This may involve running other apps\(aq migrations too, due
|
2015-03-07 10:40:30 +00:00
|
|
|
|
to dependencies.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fB<app_label> <migrationname>\fP: Brings the database schema to a state where
|
|
|
|
|
the named migration is applied, but no later migrations in the same app are
|
|
|
|
|
applied. This may involve unapplying migrations if you have previously
|
2020-05-12 05:21:09 +00:00
|
|
|
|
migrated past the named migration. You can use a prefix of the migration
|
|
|
|
|
name, e.g. \fB0001\fP, as long as it\(aqs unique for the given app name. Use the
|
|
|
|
|
name \fBzero\fP to migrate all the way back i.e. to revert all applied
|
2015-03-07 10:40:30 +00:00
|
|
|
|
migrations for an app.
|
|
|
|
|
.UNINDENT
|
2020-05-12 05:21:09 +00:00
|
|
|
|
.sp
|
|
|
|
|
\fBWARNING:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
When unapplying migrations, all dependent migrations will also be
|
|
|
|
|
unapplied, regardless of \fB<app_label>\fP\&. You can use \fB\-\-plan\fP to check
|
|
|
|
|
which migrations will be unapplied.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database to migrate. Defaults to \fBdefault\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-fake
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Marks the migrations up to the target one (following the rules above) as
|
|
|
|
|
applied, but without actually running the SQL to change your database schema.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
This is intended for advanced users to manipulate the
|
2018-05-17 13:30:20 +00:00
|
|
|
|
current migration state directly if they\(aqre manually applying changes;
|
2015-03-07 10:40:30 +00:00
|
|
|
|
be warned that using \fB\-\-fake\fP runs the risk of putting the migration state
|
|
|
|
|
table into a state where manual recovery will be needed to make migrations
|
|
|
|
|
run correctly.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-fake\-initial
|
|
|
|
|
.UNINDENT
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Allows Django to skip an app\(aqs initial migration if all database tables with
|
2017-09-22 16:26:46 +00:00
|
|
|
|
the names of all models created by all
|
|
|
|
|
\fBCreateModel\fP operations in that
|
2015-03-07 10:40:30 +00:00
|
|
|
|
migration already exist. This option is intended for use when first running
|
|
|
|
|
migrations against a database that preexisted the use of migrations. This
|
|
|
|
|
option does not, however, check for matching database schema beyond matching
|
|
|
|
|
table names and so is only safe to use if you are confident that your existing
|
|
|
|
|
schema matches what is recorded in your initial migration.
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2019-01-17 10:26:40 +00:00
|
|
|
|
.B \-\-plan
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Shows the migration operations that will be performed for the given \fBmigrate\fP
|
|
|
|
|
command.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.B \-\-run\-syncdb
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Allows creating tables for apps without migrations. While this isn\(aqt
|
2017-09-22 16:26:46 +00:00
|
|
|
|
recommended, the migrations framework is sometimes too slow on large projects
|
|
|
|
|
with hundreds of models.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-noinput, \-\-no\-input
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Suppresses all user prompts. An example prompt is asking about removing stale
|
|
|
|
|
content types.
|
2020-05-12 05:21:09 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-check
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Makes \fBmigrate\fP exit with a non\-zero status when unapplied migrations are
|
|
|
|
|
detected.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBrunserver\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin runserver [addrport]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2021-09-20 18:55:10 +00:00
|
|
|
|
Starts a lightweight development web server on the local machine. By default,
|
2015-03-07 10:40:30 +00:00
|
|
|
|
the server runs on port 8000 on the IP address \fB127.0.0.1\fP\&. You can pass in an
|
|
|
|
|
IP address and port number explicitly.
|
|
|
|
|
.sp
|
|
|
|
|
If you run this script as a user with normal privileges (recommended), you
|
|
|
|
|
might not have access to start a port on a low port number. Low port numbers
|
|
|
|
|
are reserved for the superuser (root).
|
|
|
|
|
.sp
|
|
|
|
|
This server uses the WSGI application object specified by the
|
|
|
|
|
\fBWSGI_APPLICATION\fP setting.
|
|
|
|
|
.sp
|
|
|
|
|
DO NOT USE THIS SERVER IN A PRODUCTION SETTING. It has not gone through
|
2018-05-17 13:30:20 +00:00
|
|
|
|
security audits or performance tests. (And that\(aqs how it\(aqs gonna stay. We\(aqre in
|
2021-09-20 18:55:10 +00:00
|
|
|
|
the business of making web frameworks, not web servers, so improving this
|
2015-03-07 10:40:30 +00:00
|
|
|
|
server to be able to handle a production environment is outside the scope of
|
|
|
|
|
Django.)
|
|
|
|
|
.sp
|
|
|
|
|
The development server automatically reloads Python code for each request, as
|
2018-05-17 13:30:20 +00:00
|
|
|
|
needed. You don\(aqt need to restart the server for code changes to take effect.
|
|
|
|
|
However, some actions like adding files don\(aqt trigger a restart, so you\(aqll
|
2015-03-07 10:40:30 +00:00
|
|
|
|
have to restart the server in these cases.
|
|
|
|
|
.sp
|
2019-01-17 10:26:40 +00:00
|
|
|
|
If you\(aqre using Linux or MacOS and install both \fI\%pywatchman\fP and the
|
|
|
|
|
\fI\%Watchman\fP service, kernel signals will be used to autoreload the server
|
|
|
|
|
(rather than polling file modification timestamps each second). This offers
|
|
|
|
|
better performance on large projects, reduced response time after code changes,
|
2019-09-10 08:10:50 +00:00
|
|
|
|
more robust change detection, and a reduction in power usage. Django supports
|
|
|
|
|
\fBpywatchman\fP 1.2.0 and higher.
|
2019-01-17 10:26:40 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.IP "Large directories with many files may cause performance issues"
|
|
|
|
|
.sp
|
|
|
|
|
When using Watchman with a project that includes large non\-Python
|
|
|
|
|
directories like \fBnode_modules\fP, it\(aqs advisable to ignore this directory
|
|
|
|
|
for optimal performance. See the \fI\%watchman documentation\fP for information
|
|
|
|
|
on how to do this.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.IP "Watchman timeout"
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B DJANGO_WATCHMAN_TIMEOUT
|
|
|
|
|
.UNINDENT
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.sp
|
|
|
|
|
The default timeout of \fBWatchman\fP client is 5 seconds. You can change it
|
2021-01-14 10:24:18 +00:00
|
|
|
|
by setting the \fI\%DJANGO_WATCHMAN_TIMEOUT\fP environment variable.
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
When you start the server, and each time you change Python code while the
|
2015-09-23 23:28:33 +00:00
|
|
|
|
server is running, the system check framework will check your entire Django
|
|
|
|
|
project for some common errors (see the \fI\%check\fP command). If any
|
2021-09-20 18:55:10 +00:00
|
|
|
|
errors are found, they will be printed to standard output. You can use the
|
|
|
|
|
\fB\-\-skip\-checks\fP option to skip running system checks.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
You can run as many concurrent servers as you want, as long as they\(aqre on
|
2019-09-10 08:10:50 +00:00
|
|
|
|
separate ports by executing \fBdjango\-admin runserver\fP more than once.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Note that the default IP address, \fB127.0.0.1\fP, is not accessible from other
|
|
|
|
|
machines on your network. To make your development server viewable to other
|
|
|
|
|
machines on the network, use its own IP address (e.g. \fB192.168.2.1\fP) or
|
|
|
|
|
\fB0.0.0.0\fP or \fB::\fP (with IPv6 enabled).
|
|
|
|
|
.sp
|
|
|
|
|
You can provide an IPv6 address surrounded by brackets
|
|
|
|
|
(e.g. \fB[200a::1]:8000\fP). This will automatically enable IPv6 support.
|
|
|
|
|
.sp
|
|
|
|
|
A hostname containing ASCII\-only characters can also be used.
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
If the staticfiles contrib app is enabled
|
2015-03-07 10:40:30 +00:00
|
|
|
|
(default in new projects) the \fI\%runserver\fP command will be overridden
|
2015-09-23 23:28:33 +00:00
|
|
|
|
with its own runserver command.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Logging of each request and response of the server is sent to the
|
|
|
|
|
django\-server\-logger logger.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2008-07-06 06:39:44 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-noreload
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Disables the auto\-reloader. This means any Python code changes you make while
|
|
|
|
|
the server is running will \fInot\fP take effect if the particular Python modules
|
|
|
|
|
have already been loaded into memory.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-nothreading
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Disables use of threading in the development server. The server is
|
|
|
|
|
multithreaded by default.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-ipv6, \-6
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Uses IPv6 for the development server. This changes the default IP address from
|
2015-03-07 10:40:30 +00:00
|
|
|
|
\fB127.0.0.1\fP to \fB::1\fP\&.
|
2021-09-20 18:55:10 +00:00
|
|
|
|
.sp
|
|
|
|
|
Support for the \fB\-\-skip\-checks\fP option was added.
|
|
|
|
|
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SS Examples of using different ports and addresses
|
|
|
|
|
.sp
|
|
|
|
|
Port 8000 on IP address \fB127.0.0.1\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Port 8000 on IP address \fB1.2.3.4\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver 1.2.3.4:8000
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Port 7000 on IP address \fB127.0.0.1\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver 7000
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Port 7000 on IP address \fB1.2.3.4\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver 1.2.3.4:7000
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Port 8000 on IPv6 address \fB::1\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver \-6
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Port 7000 on IPv6 address \fB::1\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver \-6 7000
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Port 7000 on IPv6 address \fB2001:0db8:1234:5678::9\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver [2001:0db8:1234:5678::9]:7000
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Port 8000 on IPv4 address of host \fBlocalhost\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver localhost:8000
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Port 8000 on IPv6 address of host \fBlocalhost\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin runserver \-6 localhost:8000
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SS Serving static files with the development server
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
By default, the development server doesn\(aqt serve any static files for your site
|
2015-03-07 10:40:30 +00:00
|
|
|
|
(such as CSS files, images, things under \fBMEDIA_URL\fP and so forth). If
|
|
|
|
|
you want to configure Django to serve static media, read
|
2017-09-22 16:26:46 +00:00
|
|
|
|
/howto/static\-files/index\&.
|
|
|
|
|
.SS \fBsendtestemail\fP
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin sendtestemail [email [email ...]]
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Sends a test email (to confirm email sending through Django is working) to the
|
|
|
|
|
recipient(s) specified. For example:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin sendtestemail foo@example.com bar@example.com
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
There are a couple of options, and you may use any combination of them
|
|
|
|
|
together:
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-managers
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Mails the email addresses specified in \fBMANAGERS\fP using
|
|
|
|
|
\fBmail_managers()\fP\&.
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-admins
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Mails the email addresses specified in \fBADMINS\fP using
|
|
|
|
|
\fBmail_admins()\fP\&.
|
|
|
|
|
.SS \fBshell\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-10-10 09:39:14 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B django\-admin shell
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Starts the Python interactive interpreter.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-interface {ipython,bpython,python}, \-i {ipython,bpython,python}
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the shell to use. By default, Django will use \fI\%IPython\fP or \fI\%bpython\fP if
|
|
|
|
|
either is installed. If both are installed, specify which one you want like so:
|
|
|
|
|
.sp
|
|
|
|
|
IPython:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin shell \-i ipython
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
bpython:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin shell \-i bpython
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
If you have a "rich" shell installed but want to force use of the "plain"
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Python interpreter, use \fBpython\fP as the interface name, like so:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin shell \-i python
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-nostartup
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Disables reading the startup script for the "plain" Python interpreter. By
|
2017-09-22 16:26:46 +00:00
|
|
|
|
default, the script pointed to by the \fI\%PYTHONSTARTUP\fP environment
|
|
|
|
|
variable or the \fB~/.pythonrc.py\fP script is read.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-command COMMAND, \-c COMMAND
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Lets you pass a command as a string to execute it as Django, like so:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin shell \-\-command="import django; print(django.__version__)"
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
You can also pass code in on standard input to execute it. For example:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
$ django\-admin shell <<EOF
|
|
|
|
|
> import django
|
|
|
|
|
> print(django.__version__)
|
|
|
|
|
> EOF
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
On Windows, the REPL is output due to implementation limits of
|
|
|
|
|
\fI\%select.select()\fP on that platform.
|
|
|
|
|
.SS \fBshowmigrations\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin showmigrations [app_label [app_label ...]]
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Shows all migrations in a project. You can choose from one of two formats:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-list, \-l
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Lists all of the apps Django knows about, the migrations available for each
|
|
|
|
|
app, and whether or not each migration is applied (marked by an \fB[X]\fP next to
|
2019-09-10 08:10:50 +00:00
|
|
|
|
the migration name). For a \fB\-\-verbosity\fP of 2 and above, the applied
|
|
|
|
|
datetimes are also shown.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Apps without migrations are also listed, but have \fB(no migrations)\fP printed
|
|
|
|
|
under them.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
This is the default output format.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-plan, \-p
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Shows the migration plan Django will follow to apply migrations. Like
|
|
|
|
|
\fB\-\-list\fP, applied migrations are marked by an \fB[X]\fP\&. For a \fB\-\-verbosity\fP
|
|
|
|
|
of 2 and above, all dependencies of a migration will also be shown.
|
|
|
|
|
.sp
|
|
|
|
|
\fBapp_label\fPs arguments limit the output, however, dependencies of provided
|
|
|
|
|
apps may also be included.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies the database to examine. Defaults to \fBdefault\fP\&.
|
|
|
|
|
.SS \fBsqlflush\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B django\-admin sqlflush
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Prints the SQL statements that would be executed for the \fI\%flush\fP
|
|
|
|
|
command.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database for which to print the SQL. Defaults to \fBdefault\fP\&.
|
|
|
|
|
.SS \fBsqlmigrate\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-10-10 09:39:14 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin sqlmigrate app_label migration_name
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Prints the SQL for the named migration. This requires an active database
|
|
|
|
|
connection, which it will use to resolve constraint names; this means you must
|
|
|
|
|
generate the SQL against a copy of the database you wish to later apply it on.
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Note that \fBsqlmigrate\fP doesn\(aqt colorize its output.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-backwards
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Generates the SQL for unapplying the migration. By default, the SQL created is
|
|
|
|
|
for running the migration in the forwards direction.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database for which to generate the SQL. Defaults to \fBdefault\fP\&.
|
|
|
|
|
.SS \fBsqlsequencereset\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin sqlsequencereset app_label [app_label ...]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Prints the SQL statements for resetting sequences for the given app name(s).
|
|
|
|
|
.sp
|
|
|
|
|
Sequences are indexes used by some database engines to track the next available
|
|
|
|
|
number for automatically incremented fields.
|
|
|
|
|
.sp
|
|
|
|
|
Use this command to generate SQL which will fix cases where a sequence is out
|
|
|
|
|
of sync with its automatically incremented field data.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database for which to print the SQL. Defaults to \fBdefault\fP\&.
|
|
|
|
|
.SS \fBsquashmigrations\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin squashmigrations app_label [start_migration_name] migration_name
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Squashes the migrations for \fBapp_label\fP up to and including \fBmigration_name\fP
|
|
|
|
|
down into fewer migrations, if possible. The resulting squashed migrations
|
|
|
|
|
can live alongside the unsquashed ones safely. For more information,
|
2015-09-23 23:28:33 +00:00
|
|
|
|
please read migration\-squashing\&.
|
|
|
|
|
.sp
|
|
|
|
|
When \fBstart_migration_name\fP is given, Django will only include migrations
|
|
|
|
|
starting from and including this migration. This helps to mitigate the
|
|
|
|
|
squashing limitation of \fBRunPython\fP and
|
|
|
|
|
\fBdjango.db.migrations.operations.RunSQL\fP migration operations.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-no\-optimize
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Disables the optimizer when generating a squashed migration. By default, Django
|
|
|
|
|
will try to optimize the operations in your migrations to reduce the size of
|
|
|
|
|
the resulting file. Use this option if this process is failing or creating
|
|
|
|
|
incorrect migrations, though please also file a Django bug report about the
|
|
|
|
|
behavior, as optimization is meant to be safe.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-noinput, \-\-no\-input
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Suppresses all user prompts.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-squashed\-name SQUASHED_NAME
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Sets the name of the squashed migration. When omitted, the name is based on the
|
|
|
|
|
first and last migration, with \fB_squashed_\fP in between.
|
2019-01-17 10:26:40 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-no\-header
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Generate squashed migration file without Django version and timestamp header.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBstartapp\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin startapp name [directory]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Creates a Django app directory structure for the given app name in the current
|
|
|
|
|
directory or the given destination.
|
|
|
|
|
.sp
|
2019-04-01 10:04:08 +00:00
|
|
|
|
By default, \fI\%the new directory\fP contains a
|
|
|
|
|
\fBmodels.py\fP file and other app template files. If only the app name is given,
|
|
|
|
|
the app directory will be created in the current working directory.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
If the optional destination is provided, Django will use that existing
|
2018-05-17 13:30:20 +00:00
|
|
|
|
directory rather than creating a new one. You can use \(aq.\(aq to denote the current
|
2015-03-07 10:40:30 +00:00
|
|
|
|
working directory.
|
|
|
|
|
.sp
|
|
|
|
|
For example:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin startapp myapp /Users/jezdez/Code/myapp
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-template TEMPLATE
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2019-09-10 08:10:50 +00:00
|
|
|
|
Provides the path to a directory with a custom app template file, or a path to
|
|
|
|
|
an uncompressed archive (\fB\&.tar\fP) or a compressed archive (\fB\&.tar.gz\fP,
|
|
|
|
|
\fB\&.tar.bz2\fP, \fB\&.tar.xz\fP, \fB\&.tar.lzma\fP, \fB\&.tgz\fP, \fB\&.tbz2\fP, \fB\&.txz\fP,
|
|
|
|
|
\fB\&.tlz\fP, \fB\&.zip\fP) containing the app template files.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
For example, this would look for an app template in the given directory when
|
|
|
|
|
creating the \fBmyapp\fP app:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin startapp \-\-template=/Users/jezdez/Code/my_app_template myapp
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Django will also accept URLs (\fBhttp\fP, \fBhttps\fP, \fBftp\fP) to compressed
|
|
|
|
|
archives with the app template files, downloading and extracting them on the
|
|
|
|
|
fly.
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
For example, taking advantage of GitHub\(aqs feature to expose repositories as
|
2015-03-07 10:40:30 +00:00
|
|
|
|
zip files, you can use a URL like:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin startapp \-\-template=https://github.com/githubuser/django\-app\-template/archive/master.zip myapp
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-extension EXTENSIONS, \-e EXTENSIONS
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies which file extensions in the app template should be rendered with the
|
|
|
|
|
template engine. Defaults to \fBpy\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-name FILES, \-n FILES
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies which files in the app template (in addition to those matching
|
|
|
|
|
\fB\-\-extension\fP) should be rendered with the template engine. Defaults to an
|
|
|
|
|
empty list.
|
2021-09-20 18:55:10 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-exclude DIRECTORIES, \-x DIRECTORIES
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
Specifies which directories in the app template should be excluded, in addition
|
|
|
|
|
to \fB\&.git\fP and \fB__pycache__\fP\&. If this option is not provided, directories
|
|
|
|
|
named \fB__pycache__\fP or starting with \fB\&.\fP will be excluded.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
The \fBtemplate context\fP used for all matching
|
|
|
|
|
files is:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Any option passed to the \fBstartapp\fP command (among the command\(aqs supported
|
2015-03-07 10:40:30 +00:00
|
|
|
|
options)
|
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBapp_name\fP \-\- the app name as passed to the command
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBapp_directory\fP \-\- the full path of the newly created app
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBcamel_case_app_name\fP \-\- the app name in camel case format
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBdocs_version\fP \-\- the version of the documentation: \fB\(aqdev\(aq\fP or \fB\(aq1.x\(aq\fP
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.IP \(bu 2
|
2019-09-10 08:10:50 +00:00
|
|
|
|
\fBdjango_version\fP \-\- the version of Django, e.g. \fB\(aq2.0.3\(aq\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
\fBWARNING:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
When the app template files are rendered with the Django template
|
|
|
|
|
engine (by default all \fB*.py\fP files), Django will also replace all
|
|
|
|
|
stray template variables contained. For example, if one of the Python files
|
|
|
|
|
contains a docstring explaining a particular feature related
|
|
|
|
|
to template rendering, it might result in an incorrect example.
|
|
|
|
|
.sp
|
|
|
|
|
To work around this problem, you can use the \fBtemplatetag\fP
|
2018-05-17 13:30:20 +00:00
|
|
|
|
template tag to "escape" the various parts of the template syntax.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
In addition, to allow Python template files that contain Django template
|
|
|
|
|
language syntax while also preventing packaging systems from trying to
|
|
|
|
|
byte\-compile invalid \fB*.py\fP files, template files ending with \fB\&.py\-tpl\fP
|
|
|
|
|
will be renamed to \fB\&.py\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBstartproject\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin startproject name [directory]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Creates a Django project directory structure for the given project name in
|
|
|
|
|
the current directory or the given destination.
|
|
|
|
|
.sp
|
2019-04-01 10:04:08 +00:00
|
|
|
|
By default, \fI\%the new directory\fP contains
|
|
|
|
|
\fBmanage.py\fP and a project package (containing a \fBsettings.py\fP and other
|
|
|
|
|
files).
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
If only the project name is given, both the project directory and project
|
|
|
|
|
package will be named \fB<projectname>\fP and the project directory
|
|
|
|
|
will be created in the current working directory.
|
|
|
|
|
.sp
|
|
|
|
|
If the optional destination is provided, Django will use that existing
|
|
|
|
|
directory as the project directory, and create \fBmanage.py\fP and the project
|
2018-05-17 13:30:20 +00:00
|
|
|
|
package within it. Use \(aq.\(aq to denote the current working directory.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
For example:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin startproject myproject /Users/jezdez/Code/myproject_repo
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.TP
|
|
|
|
|
.B \-\-template TEMPLATE
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies a directory, file path, or URL of a custom project template. See the
|
|
|
|
|
\fI\%startapp \-\-template\fP documentation for examples and usage.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.TP
|
|
|
|
|
.B \-\-extension EXTENSIONS, \-e EXTENSIONS
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
Specifies which file extensions in the project template should be rendered with
|
|
|
|
|
the template engine. Defaults to \fBpy\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-name FILES, \-n FILES
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies which files in the project template (in addition to those matching
|
|
|
|
|
\fB\-\-extension\fP) should be rendered with the template engine. Defaults to an
|
|
|
|
|
empty list.
|
2021-09-20 18:55:10 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-exclude DIRECTORIES, \-x DIRECTORIES
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
Specifies which directories in the project template should be excluded, in
|
|
|
|
|
addition to \fB\&.git\fP and \fB__pycache__\fP\&. If this option is not provided,
|
|
|
|
|
directories named \fB__pycache__\fP or starting with \fB\&.\fP will be excluded.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
The \fBtemplate context\fP used is:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Any option passed to the \fBstartproject\fP command (among the command\(aqs
|
2015-03-07 10:40:30 +00:00
|
|
|
|
supported options)
|
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBproject_name\fP \-\- the project name as passed to the command
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBproject_directory\fP \-\- the full path of the newly created project
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBsecret_key\fP \-\- a random key for the \fBSECRET_KEY\fP setting
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBdocs_version\fP \-\- the version of the documentation: \fB\(aqdev\(aq\fP or \fB\(aq1.x\(aq\fP
|
|
|
|
|
.IP \(bu 2
|
2019-09-10 08:10:50 +00:00
|
|
|
|
\fBdjango_version\fP \-\- the version of Django, e.g. \fB\(aq2.0.3\(aq\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Please also see the \fI\%rendering warning\fP as mentioned
|
|
|
|
|
for \fI\%startapp\fP\&.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBtest\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin test [test_label [test_label ...]]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Runs tests for all installed apps. See /topics/testing/index for more
|
2015-03-07 10:40:30 +00:00
|
|
|
|
information.
|
|
|
|
|
.INDENT 0.0
|
2010-11-13 18:41:55 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-failfast
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Stops running tests and reports the failure immediately after a test fails.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2011-06-17 13:08:36 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-testrunner TESTRUNNER
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Controls the test runner class that is used to execute tests. This value
|
|
|
|
|
overrides the value provided by the \fBTEST_RUNNER\fP setting.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-11-13 18:41:55 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-noinput, \-\-no\-input
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Suppresses all user prompts. A typical prompt is a warning about deleting an
|
|
|
|
|
existing test database.
|
|
|
|
|
.SS Test runner options
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
The \fBtest\fP command receives options on behalf of the specified
|
|
|
|
|
\fI\%\-\-testrunner\fP\&. These are the options of the default test runner:
|
|
|
|
|
\fBDiscoverRunner\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-11-26 13:33:53 +00:00
|
|
|
|
.TP
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.B \-\-keepdb
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Preserves the test database between test runs. This has the advantage of
|
|
|
|
|
skipping both the create and destroy actions which can greatly decrease the
|
|
|
|
|
time to run tests, especially those in a large test suite. If the test database
|
|
|
|
|
does not exist, it will be created on the first run and then preserved for each
|
2020-05-12 05:21:09 +00:00
|
|
|
|
subsequent run. Unless the \fBMIGRATE\fP test setting is
|
|
|
|
|
\fBFalse\fP, any unapplied migrations will also be applied to the test database
|
|
|
|
|
before running the test suite.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2021-09-20 18:55:10 +00:00
|
|
|
|
.B \-\-shuffle [SEED]
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
Randomizes the order of tests before running them. This can help detect tests
|
|
|
|
|
that aren\(aqt properly isolated. The test order generated by this option is a
|
|
|
|
|
deterministic function of the integer seed given. When no seed is passed, a
|
|
|
|
|
seed is chosen randomly and printed to the console. To repeat a particular test
|
|
|
|
|
order, pass a seed. The test orders generated by this option preserve Django\(aqs
|
|
|
|
|
guarantees on test order\&. They also keep tests grouped
|
|
|
|
|
by test case class.
|
|
|
|
|
.sp
|
|
|
|
|
The shuffled orderings also have a special consistency property useful when
|
|
|
|
|
narrowing down isolation issues. Namely, for a given seed and when running a
|
|
|
|
|
subset of tests, the new order will be the original shuffling restricted to the
|
|
|
|
|
smaller set. Similarly, when adding tests while keeping the seed the same, the
|
|
|
|
|
order of the original tests will be the same in the new order.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-reverse, \-r
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Sorts test cases in the opposite execution order. This may help in debugging
|
2018-05-17 13:30:20 +00:00
|
|
|
|
the side effects of tests that aren\(aqt properly isolated. Grouping by test
|
2021-09-20 18:55:10 +00:00
|
|
|
|
class is preserved when using this option. This can be used
|
|
|
|
|
in conjunction with \fB\-\-shuffle\fP to reverse the order for a particular seed.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-10-10 09:39:14 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-debug\-mode
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Sets the \fBDEBUG\fP setting to \fBTrue\fP prior to running tests. This may
|
|
|
|
|
help troubleshoot test failures.
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-debug\-sql, \-d
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Enables SQL logging for failing tests. If
|
|
|
|
|
\fB\-\-verbosity\fP is \fB2\fP, then queries in passing tests are also output.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-parallel [N]
|
|
|
|
|
.UNINDENT
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B DJANGO_TEST_PROCESSES
|
|
|
|
|
.UNINDENT
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Runs tests in separate parallel processes. Since modern processors have
|
|
|
|
|
multiple cores, this allows running tests significantly faster.
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
2021-09-20 18:55:10 +00:00
|
|
|
|
Using \fB\-\-parallel\fP without a value, or with the value \fBauto\fP, runs one test
|
|
|
|
|
process per core according to \fI\%multiprocessing.cpu_count()\fP\&. You can
|
|
|
|
|
override this by passing the desired number of processes, e.g.
|
|
|
|
|
\fB\-\-parallel 4\fP, or by setting the \fI\%DJANGO_TEST_PROCESSES\fP environment
|
|
|
|
|
variable.
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.sp
|
|
|
|
|
Django distributes test cases — \fI\%unittest.TestCase\fP subclasses — to
|
|
|
|
|
subprocesses. If there are fewer test cases than configured processes, Django
|
|
|
|
|
will reduce the number of processes accordingly.
|
|
|
|
|
.sp
|
|
|
|
|
Each process gets its own database. You must ensure that different test cases
|
2018-05-17 13:30:20 +00:00
|
|
|
|
don\(aqt access the same resources. For instance, test cases that touch the
|
2015-09-23 23:28:33 +00:00
|
|
|
|
filesystem should create a temporary directory for their own use.
|
|
|
|
|
.sp
|
2020-05-12 05:21:09 +00:00
|
|
|
|
\fBNOTE:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
If you have test classes that cannot be run in parallel, you can use
|
|
|
|
|
\fBSerializeMixin\fP to run them sequentially. See Enforce running test
|
|
|
|
|
classes sequentially\&.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2015-09-23 23:28:33 +00:00
|
|
|
|
This option requires the third\-party \fBtblib\fP package to display tracebacks
|
|
|
|
|
correctly:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2019-09-10 08:10:50 +00:00
|
|
|
|
$ python \-m pip install tblib
|
2015-09-23 23:28:33 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
This feature isn\(aqt available on Windows. It doesn\(aqt work with the Oracle
|
2015-09-23 23:28:33 +00:00
|
|
|
|
database backend either.
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
If you want to use \fI\%pdb\fP while debugging tests, you must disable parallel
|
2018-05-17 13:30:20 +00:00
|
|
|
|
execution (\fB\-\-parallel=1\fP). You\(aqll see something like \fBbdb.BdbQuit\fP if you
|
|
|
|
|
don\(aqt.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
2015-09-23 23:28:33 +00:00
|
|
|
|
\fBWARNING:\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
When test parallelization is enabled and a test fails, Django may be
|
|
|
|
|
unable to display the exception traceback. This can make debugging
|
|
|
|
|
difficult. If you encounter this problem, run the affected test without
|
|
|
|
|
parallelization to see the traceback of the failure.
|
|
|
|
|
.sp
|
|
|
|
|
This is a known limitation. It arises from the need to serialize objects
|
|
|
|
|
in order to exchange them between processes. See
|
|
|
|
|
\fI\%What can be pickled and unpickled?\fP for details.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2021-09-20 18:55:10 +00:00
|
|
|
|
.sp
|
|
|
|
|
Support for the value \fBauto\fP was added.
|
|
|
|
|
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2008-07-06 06:39:44 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-tag TAGS
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Runs only tests marked with the specified tags\&.
|
|
|
|
|
May be specified multiple times and combined with \fI\%test \-\-exclude\-tag\fP\&.
|
2021-09-20 18:55:10 +00:00
|
|
|
|
.sp
|
|
|
|
|
Tests that fail to load are always considered matching.
|
|
|
|
|
.sp
|
|
|
|
|
In older versions, tests that failed to load did not match tags.
|
|
|
|
|
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-exclude\-tag EXCLUDE_TAGS
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Excludes tests marked with the specified tags\&.
|
|
|
|
|
May be specified multiple times and combined with \fI\%test \-\-tag\fP\&.
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-k TEST_NAME_PATTERNS
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Runs test methods and classes matching test name patterns, in the same way as
|
|
|
|
|
\fI\%unittest\(aqs \-k option\fP\&. Can be specified multiple times.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-pdb
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Spawns a \fBpdb\fP debugger at each test error or failure. If you have it
|
|
|
|
|
installed, \fBipdb\fP is used instead.
|
2020-05-12 05:21:09 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-buffer, \-b
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Discards output (\fBstdout\fP and \fBstderr\fP) for passing tests, in the same way
|
|
|
|
|
as \fI\%unittest\(aqs \-\-buffer option\fP\&.
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-no\-faulthandler
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
Django automatically calls \fI\%faulthandler.enable()\fP when starting the
|
|
|
|
|
tests, which allows it to print a traceback if the interpreter crashes. Pass
|
|
|
|
|
\fB\-\-no\-faulthandler\fP to disable this behavior.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-timing
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
|
|
|
|
|
.sp
|
|
|
|
|
Outputs timings, including database setup and total run time.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBtestserver\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin testserver [fixture [fixture ...]]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Runs a Django development server (as in \fI\%runserver\fP) using data from
|
|
|
|
|
the given fixture(s).
|
|
|
|
|
.sp
|
|
|
|
|
For example, this command:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin testserver mydata.json
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\&...would perform the following steps:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP 1. 3
|
2015-09-23 23:28:33 +00:00
|
|
|
|
Create a test database, as described in the\-test\-database\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.IP 2. 3
|
|
|
|
|
Populate the test database with fixture data from the given fixtures.
|
|
|
|
|
(For more on fixtures, see the documentation for \fI\%loaddata\fP above.)
|
|
|
|
|
.IP 3. 3
|
|
|
|
|
Runs the Django development server (as in \fI\%runserver\fP), pointed at
|
|
|
|
|
this newly created test database instead of your production database.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
This is useful in a number of ways:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
When you\(aqre writing unit tests of how your views
|
2015-03-07 10:40:30 +00:00
|
|
|
|
act with certain fixture data, you can use \fBtestserver\fP to interact with
|
2021-09-20 18:55:10 +00:00
|
|
|
|
the views in a web browser, manually.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.IP \(bu 2
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Let\(aqs say you\(aqre developing your Django application and have a "pristine"
|
|
|
|
|
copy of a database that you\(aqd like to interact with. You can dump your
|
2015-03-07 10:40:30 +00:00
|
|
|
|
database to a fixture (using the \fI\%dumpdata\fP command, explained
|
2021-09-20 18:55:10 +00:00
|
|
|
|
above), then use \fBtestserver\fP to run your web application with that data.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
With this arrangement, you have the flexibility of messing up your data
|
2018-05-17 13:30:20 +00:00
|
|
|
|
in any way, knowing that whatever data changes you\(aqre making are only
|
2015-03-07 10:40:30 +00:00
|
|
|
|
being made to a test database.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Note that this server does \fInot\fP automatically detect changes to your Python
|
|
|
|
|
source code (as \fI\%runserver\fP does). It does, however, detect changes to
|
|
|
|
|
templates.
|
|
|
|
|
.INDENT 0.0
|
2014-03-24 13:03:06 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-addrport ADDRPORT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies a different port, or IP address and port, from the default of
|
|
|
|
|
\fB127.0.0.1:8000\fP\&. This value follows exactly the same format and serves
|
|
|
|
|
exactly the same function as the argument to the \fI\%runserver\fP command.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Examples:
|
|
|
|
|
.sp
|
|
|
|
|
To run the test server on port 7000 with \fBfixture1\fP and \fBfixture2\fP:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin testserver \-\-addrport 7000 fixture1 fixture2
|
|
|
|
|
django\-admin testserver fixture1 fixture2 \-\-addrport 7000
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
(The above statements are equivalent. We include both of them to demonstrate
|
2018-05-17 13:30:20 +00:00
|
|
|
|
that it doesn\(aqt matter whether the options come before or after the fixture
|
2015-03-07 10:40:30 +00:00
|
|
|
|
arguments.)
|
|
|
|
|
.sp
|
|
|
|
|
To run on 1.2.3.4:7000 with a \fBtest\fP fixture:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin testserver \-\-addrport 1.2.3.4:7000 test
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-noinput, \-\-no\-input
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Suppresses all user prompts. A typical prompt is a warning about deleting an
|
|
|
|
|
existing test database.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SH COMMANDS PROVIDED BY APPLICATIONS
|
|
|
|
|
.sp
|
|
|
|
|
Some commands are only available when the \fBdjango.contrib\fP application that
|
2017-09-22 16:26:46 +00:00
|
|
|
|
implements them has been
|
2015-03-07 10:40:30 +00:00
|
|
|
|
\fBenabled\fP\&. This section describes them grouped by
|
|
|
|
|
their application.
|
|
|
|
|
.SS \fBdjango.contrib.auth\fP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBchangepassword\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2008-07-06 06:39:44 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B django\-admin changepassword [<username>]
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
This command is only available if Django\(aqs authentication system (\fBdjango.contrib.auth\fP) is installed.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
Allows changing a user\(aqs password. It prompts you to enter a new password twice
|
2015-09-23 23:28:33 +00:00
|
|
|
|
for the given user. If the entries are identical, this immediately becomes the
|
|
|
|
|
new password. If you do not supply a user, the command will attempt to change
|
|
|
|
|
the password whose username matches the current user.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database to query for the user. Defaults to \fBdefault\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin changepassword ringo
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBcreatesuperuser\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2008-08-08 16:41:55 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B django\-admin createsuperuser
|
|
|
|
|
.UNINDENT
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B DJANGO_SUPERUSER_PASSWORD
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
This command is only available if Django\(aqs authentication system (\fBdjango.contrib.auth\fP) is installed.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Creates a superuser account (a user who has all permissions). This is
|
|
|
|
|
useful if you need to create an initial superuser account or if you need to
|
|
|
|
|
programmatically generate superuser accounts for your site(s).
|
|
|
|
|
.sp
|
|
|
|
|
When run interactively, this command will prompt for a password for
|
2019-09-10 08:10:50 +00:00
|
|
|
|
the new superuser account. When run non\-interactively, you can provide
|
2021-01-14 10:24:18 +00:00
|
|
|
|
a password by setting the \fI\%DJANGO_SUPERUSER_PASSWORD\fP environment
|
|
|
|
|
variable. Otherwise, no password will be set, and the superuser account will
|
|
|
|
|
not be able to log in until a password has been manually set for it.
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.sp
|
|
|
|
|
In non\-interactive mode, the
|
|
|
|
|
\fBUSERNAME_FIELD\fP and required
|
|
|
|
|
fields (listed in
|
|
|
|
|
\fBREQUIRED_FIELDS\fP) fall back to
|
|
|
|
|
\fBDJANGO_SUPERUSER_<uppercase_field_name>\fP environment variables, unless they
|
|
|
|
|
are overridden by a command line argument. For example, to provide an \fBemail\fP
|
|
|
|
|
field, you can use \fBDJANGO_SUPERUSER_EMAIL\fP environment variable.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-noinput, \-\-no\-input
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Suppresses all user prompts. If a suppressed prompt cannot be resolved
|
|
|
|
|
automatically, the command will exit with error code 1.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-02-16 12:14:27 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-username USERNAME
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
2010-02-16 12:15:04 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-email EMAIL
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
The username and email address for the new account can be supplied by
|
|
|
|
|
using the \fB\-\-username\fP and \fB\-\-email\fP arguments on the command
|
|
|
|
|
line. If either of those is not supplied, \fBcreatesuperuser\fP will prompt for
|
|
|
|
|
it when running interactively.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the database into which the superuser object will be saved.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
You can subclass the management command and override \fBget_input_data()\fP if you
|
|
|
|
|
want to customize data input and validation. Consult the source code for
|
2018-05-17 13:30:20 +00:00
|
|
|
|
details on the existing implementation and the method\(aqs parameters. For example,
|
2015-03-07 10:40:30 +00:00
|
|
|
|
it could be useful if you have a \fBForeignKey\fP in
|
|
|
|
|
\fBREQUIRED_FIELDS\fP and want to
|
|
|
|
|
allow creating an instance instead of entering the primary key of an existing
|
|
|
|
|
instance.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBdjango.contrib.contenttypes\fP
|
|
|
|
|
.SS \fBremove_stale_contenttypes\fP
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin remove_stale_contenttypes
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2018-05-17 13:30:20 +00:00
|
|
|
|
This command is only available if Django\(aqs contenttypes app (\fBdjango.contrib.contenttypes\fP) is installed.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
Deletes stale content types (from deleted models) in your database. Any objects
|
|
|
|
|
that depend on the deleted content types will also be deleted. A list of
|
2018-05-17 13:30:20 +00:00
|
|
|
|
deleted objects will be displayed before you confirm it\(aqs okay to proceed with
|
2017-09-22 16:26:46 +00:00
|
|
|
|
the deletion.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-database DATABASE
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Specifies the database to use. Defaults to \fBdefault\fP\&.
|
2020-05-12 05:21:09 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-include\-stale\-apps
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Deletes stale content types including ones from previously installed apps that
|
|
|
|
|
have been removed from \fBINSTALLED_APPS\fP\&. Defaults to \fBFalse\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SS \fBdjango.contrib.gis\fP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBogrinspect\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
This command is only available if GeoDjango
|
2015-03-07 10:40:30 +00:00
|
|
|
|
(\fBdjango.contrib.gis\fP) is installed.
|
|
|
|
|
.sp
|
|
|
|
|
Please refer to its \fBdescription\fP in the GeoDjango
|
|
|
|
|
documentation.
|
|
|
|
|
.SS \fBdjango.contrib.sessions\fP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBclearsessions\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django\-admin clearsessions
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Can be run as a cron job or directly to clean out expired sessions.
|
|
|
|
|
.SS \fBdjango.contrib.sitemaps\fP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBping_google\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
This command is only available if the Sitemaps framework (\fBdjango.contrib.sitemaps\fP) is installed.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Please refer to its \fBdescription\fP in the Sitemaps
|
|
|
|
|
documentation.
|
|
|
|
|
.SS \fBdjango.contrib.staticfiles\fP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.SS \fBcollectstatic\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
This command is only available if the static files application (\fBdjango.contrib.staticfiles\fP) is installed.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Please refer to its \fBdescription\fP in the
|
2017-09-22 16:26:46 +00:00
|
|
|
|
staticfiles documentation.
|
|
|
|
|
.SS \fBfindstatic\fP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
This command is only available if the static files application (\fBdjango.contrib.staticfiles\fP) is installed.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Please refer to its \fBdescription\fP in the staticfiles documentation.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SH DEFAULT OPTIONS
|
|
|
|
|
.sp
|
|
|
|
|
Although some commands may allow their own custom options, every command
|
2021-09-20 18:55:10 +00:00
|
|
|
|
allows for the following options by default:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
2010-02-16 12:15:04 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-pythonpath PYTHONPATH
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Adds the given filesystem path to the Python \fI\%import search path\fP\&. If this
|
2021-01-14 10:24:18 +00:00
|
|
|
|
isn\(aqt provided, \fBdjango\-admin\fP will use the \fI\%PYTHONPATH\fP environment
|
2017-09-22 16:26:46 +00:00
|
|
|
|
variable.
|
|
|
|
|
.sp
|
|
|
|
|
This option is unnecessary in \fBmanage.py\fP, because it takes care of setting
|
|
|
|
|
the Python path for you.
|
|
|
|
|
.sp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin migrate \-\-pythonpath=\(aq/home/djangoprojects/myproject\(aq
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
2012-02-06 02:00:19 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-settings SETTINGS
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the settings module to use. The settings module should be in Python
|
2018-05-17 13:30:20 +00:00
|
|
|
|
package syntax, e.g. \fBmysite.settings\fP\&. If this isn\(aqt provided,
|
2021-01-14 10:24:18 +00:00
|
|
|
|
\fBdjango\-admin\fP will use the \fBDJANGO_SETTINGS_MODULE\fP environment
|
|
|
|
|
variable.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
This option is unnecessary in \fBmanage.py\fP, because it uses
|
|
|
|
|
\fBsettings.py\fP from the current project by default.
|
|
|
|
|
.sp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin migrate \-\-settings=mysite.settings
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
2010-11-04 12:08:37 +00:00
|
|
|
|
.TP
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.B \-\-traceback
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Displays a full stack trace when a \fBCommandError\fP
|
2019-09-10 08:10:50 +00:00
|
|
|
|
is raised. By default, \fBdjango\-admin\fP will show an error message when a
|
2017-09-22 16:26:46 +00:00
|
|
|
|
\fBCommandError\fP occurs and a full stack trace for any other exception.
|
|
|
|
|
.sp
|
2021-09-20 18:55:10 +00:00
|
|
|
|
This option is ignored by \fI\%runserver\fP\&.
|
|
|
|
|
.sp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin migrate \-\-traceback
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-verbosity {0,1,2,3}, \-v {0,1,2,3}
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Specifies the amount of notification and debug information that a command
|
|
|
|
|
should print to the console.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fB0\fP means no output.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fB1\fP means normal output (default).
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fB2\fP means verbose output.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fB3\fP means \fIvery\fP verbose output.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2021-09-20 18:55:10 +00:00
|
|
|
|
This option is ignored by \fI\%runserver\fP\&.
|
|
|
|
|
.sp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin migrate \-\-verbosity 2
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.INDENT 0.0
|
2012-02-06 02:00:19 +00:00
|
|
|
|
.TP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.B \-\-no\-color
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Disables colorized command output. Some commands format their output to be
|
|
|
|
|
colorized. For example, errors will be printed to the console in red and SQL
|
|
|
|
|
statements will be syntax highlighted.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Example usage:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2017-09-22 16:26:46 +00:00
|
|
|
|
django\-admin runserver \-\-no\-color
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2019-01-17 10:26:40 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-force\-color
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Forces colorization of the command output if it would otherwise be disabled
|
|
|
|
|
as discussed in \fI\%Syntax coloring\fP\&. For example, you may want to pipe
|
|
|
|
|
colored output to another command.
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \-\-skip\-checks
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Skips running system checks prior to running the command. This option is only
|
|
|
|
|
available if the
|
|
|
|
|
\fBrequires_system_checks\fP command
|
2021-01-14 10:24:18 +00:00
|
|
|
|
attribute is not an empty list or tuple.
|
2019-09-10 08:10:50 +00:00
|
|
|
|
.sp
|
|
|
|
|
Example usage:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
django\-admin migrate \-\-skip\-checks
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SH EXTRA NICETIES
|
|
|
|
|
.SS Syntax coloring
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B DJANGO_COLORS
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
The \fBdjango\-admin\fP / \fBmanage.py\fP commands will use pretty
|
|
|
|
|
color\-coded output if your terminal supports ANSI\-colored output. It
|
2018-05-17 13:30:20 +00:00
|
|
|
|
won\(aqt use the color codes if you\(aqre piping the command\(aqs output to
|
2019-01-17 10:26:40 +00:00
|
|
|
|
another program unless the \fI\%\-\-force\-color\fP option is used.
|
2021-01-14 10:24:18 +00:00
|
|
|
|
.SS Windows support
|
|
|
|
|
.sp
|
|
|
|
|
On Windows 10, the \fI\%Windows Terminal\fP application, \fI\%VS Code\fP, and PowerShell
|
|
|
|
|
(where virtual terminal processing is enabled) allow colored output, and are
|
|
|
|
|
supported by default.
|
|
|
|
|
.sp
|
|
|
|
|
Under Windows, the legacy \fBcmd.exe\fP native console doesn\(aqt support ANSI
|
|
|
|
|
escape sequences so by default there is no color output. In this case either of
|
|
|
|
|
two third\-party libraries are needed:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Install \fI\%colorama\fP, a Python package that translates ANSI color codes into
|
|
|
|
|
Windows API calls. Django commands will detect its presence and will make use
|
|
|
|
|
of its services to color output just like on Unix\-based platforms.
|
|
|
|
|
\fBcolorama\fP can be installed via pip:
|
|
|
|
|
.INDENT 2.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
\&...\e> py \-m pip install colorama
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Install \fI\%ANSICON\fP, a third\-party tool that allows \fBcmd.exe\fP to process
|
|
|
|
|
ANSI color codes. Django commands will detect its presence and will make use
|
|
|
|
|
of its services to color output just like on Unix\-based platforms.
|
|
|
|
|
.UNINDENT
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
2021-01-14 10:24:18 +00:00
|
|
|
|
Other modern terminal environments on Windows, that support terminal colors,
|
|
|
|
|
but which are not automatically detected as supported by Django, may "fake" the
|
|
|
|
|
installation of \fBANSICON\fP by setting the appropriate environmental variable,
|
|
|
|
|
\fBANSICON="on"\fP\&.
|
|
|
|
|
.sp
|
|
|
|
|
Updated support for syntax coloring on Windows.
|
|
|
|
|
|
|
|
|
|
.SS Custom colors
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
The colors used for syntax highlighting can be customized. Django
|
|
|
|
|
ships with three color palettes:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBdark\fP, suited to terminals that show white text on a black
|
|
|
|
|
background. This is the default palette.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBlight\fP, suited to terminals that show black text on a white
|
|
|
|
|
background.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBnocolor\fP, which disables syntax highlighting.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2021-01-14 10:24:18 +00:00
|
|
|
|
You select a palette by setting a \fI\%DJANGO_COLORS\fP environment
|
2015-03-07 10:40:30 +00:00
|
|
|
|
variable to specify the palette you want to use. For example, to
|
|
|
|
|
specify the \fBlight\fP palette under a Unix or OS/X BASH shell, you
|
|
|
|
|
would run the following at a command prompt:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
export DJANGO_COLORS="light"
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
You can also customize the colors that are used. Django specifies a
|
|
|
|
|
number of roles in which color is used:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBerror\fP \- A major error.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBnotice\fP \- A minor error.
|
|
|
|
|
.IP \(bu 2
|
2017-09-22 16:26:46 +00:00
|
|
|
|
\fBsuccess\fP \- A success.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBwarning\fP \- A warning.
|
|
|
|
|
.IP \(bu 2
|
2015-03-07 10:40:30 +00:00
|
|
|
|
\fBsql_field\fP \- The name of a model field in SQL.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBsql_coltype\fP \- The type of a model field in SQL.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBsql_keyword\fP \- An SQL keyword.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBsql_table\fP \- The name of a model in SQL.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBhttp_info\fP \- A 1XX HTTP Informational server response.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBhttp_success\fP \- A 2XX HTTP Success server response.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBhttp_not_modified\fP \- A 304 HTTP Not Modified server response.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBhttp_redirect\fP \- A 3XX HTTP Redirect server response other than 304.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBhttp_not_found\fP \- A 404 HTTP Not Found server response.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBhttp_bad_request\fP \- A 4XX HTTP Bad Request server response other than 404.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBhttp_server_error\fP \- A 5XX HTTP Server Error response.
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBmigrate_heading\fP \- A heading in a migrations management command.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBmigrate_label\fP \- A migration name.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Each of these roles can be assigned a specific foreground and
|
|
|
|
|
background color, from the following list:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBblack\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBred\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBgreen\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fByellow\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBblue\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBmagenta\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBcyan\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBwhite\fP
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Each of these colors can then be modified by using the following
|
|
|
|
|
display options:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBbold\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBunderscore\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBblink\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBreverse\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBconceal\fP
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
A color specification follows one of the following patterns:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBrole=fg\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBrole=fg/bg\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBrole=fg,option,option\fP
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
\fBrole=fg/bg,option,option\fP
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
where \fBrole\fP is the name of a valid color role, \fBfg\fP is the
|
|
|
|
|
foreground color, \fBbg\fP is the background color and each \fBoption\fP
|
|
|
|
|
is one of the color modifying options. Multiple color specifications
|
2015-09-23 23:28:33 +00:00
|
|
|
|
are then separated by a semicolon. For example:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
export DJANGO_COLORS="error=yellow/blue,blink;notice=magenta"
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
would specify that errors be displayed using blinking yellow on blue,
|
|
|
|
|
and notices displayed using magenta. All other color roles would be
|
|
|
|
|
left uncolored.
|
|
|
|
|
.sp
|
|
|
|
|
Colors can also be specified by extending a base palette. If you put
|
|
|
|
|
a palette name in a color specification, all the colors implied by that
|
|
|
|
|
palette will be loaded. So:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
export DJANGO_COLORS="light;error=yellow/blue,blink;notice=magenta"
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
would specify the use of all the colors in the light color palette,
|
|
|
|
|
\fIexcept\fP for the colors for errors and notices which would be
|
|
|
|
|
overridden as specified.
|
|
|
|
|
.SS Bash completion
|
|
|
|
|
.sp
|
|
|
|
|
If you use the Bash shell, consider installing the Django bash completion
|
2018-05-17 13:30:20 +00:00
|
|
|
|
script, which lives in \fBextras/django_bash_completion\fP in the Django source
|
2015-03-07 10:40:30 +00:00
|
|
|
|
distribution. It enables tab\-completion of \fBdjango\-admin\fP and
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBmanage.py\fP commands, so you can, for instance...
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Type \fBdjango\-admin\fP\&.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Press [TAB] to see all available options.
|
|
|
|
|
.IP \(bu 2
|
|
|
|
|
Type \fBsql\fP, then [TAB], to see all available options whose names start
|
|
|
|
|
with \fBsql\fP\&.
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
See /howto/custom\-management\-commands for how to add customized actions.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B django.core.management.call_command(name, *args, **options)
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
To call a management command from code use \fBcall_command\fP\&.
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.TP
|
|
|
|
|
.B \fBname\fP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
the name of the command to call or a command object. Passing the name is
|
|
|
|
|
preferred unless the object is required for testing.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.TP
|
|
|
|
|
.B \fB*args\fP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
a list of arguments accepted by the command. Arguments are passed to the
|
|
|
|
|
argument parser, so you can use the same style as you would on the command
|
|
|
|
|
line. For example, \fBcall_command(\(aqflush\(aq, \(aq\-\-verbosity=0\(aq)\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.TP
|
|
|
|
|
.B \fB**options\fP
|
2017-09-22 16:26:46 +00:00
|
|
|
|
named options accepted on the command\-line. Options are passed to the command
|
2018-05-17 13:30:20 +00:00
|
|
|
|
without triggering the argument parser, which means you\(aqll need to pass the
|
2017-09-22 16:26:46 +00:00
|
|
|
|
correct type. For example, \fBcall_command(\(aqflush\(aq, verbosity=0)\fP (zero must
|
|
|
|
|
be an integer rather than a string).
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Examples:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
from django.core import management
|
2017-09-22 16:26:46 +00:00
|
|
|
|
from django.core.management.commands import loaddata
|
|
|
|
|
|
2015-03-07 10:40:30 +00:00
|
|
|
|
management.call_command(\(aqflush\(aq, verbosity=0, interactive=False)
|
|
|
|
|
management.call_command(\(aqloaddata\(aq, \(aqtest_data\(aq, verbosity=0)
|
2017-09-22 16:26:46 +00:00
|
|
|
|
management.call_command(loaddata.Command(), \(aqtest_data\(aq, verbosity=0)
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
|
|
|
|
Note that command options that take no arguments are passed as keywords
|
|
|
|
|
with \fBTrue\fP or \fBFalse\fP, as you can see with the \fBinteractive\fP option above.
|
|
|
|
|
.sp
|
|
|
|
|
Named arguments can be passed by using either one of the following syntaxes:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
|
|
|
|
.sp
|
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
# Similar to the command line
|
|
|
|
|
management.call_command(\(aqdumpdata\(aq, \(aq\-\-natural\-foreign\(aq)
|
|
|
|
|
|
|
|
|
|
# Named argument similar to the command line minus the initial dashes and
|
|
|
|
|
# with internal dashes replaced by underscores
|
|
|
|
|
management.call_command(\(aqdumpdata\(aq, natural_foreign=True)
|
2007-06-10 06:33:31 +00:00
|
|
|
|
|
2015-03-07 10:40:30 +00:00
|
|
|
|
# \(gause_natural_foreign_keys\(ga is the option destination variable
|
|
|
|
|
management.call_command(\(aqdumpdata\(aq, use_natural_foreign_keys=True)
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.sp
|
2017-09-22 16:26:46 +00:00
|
|
|
|
Some command options have different names when using \fBcall_command()\fP instead
|
|
|
|
|
of \fBdjango\-admin\fP or \fBmanage.py\fP\&. For example, \fBdjango\-admin
|
|
|
|
|
createsuperuser \-\-no\-input\fP translates to \fBcall_command(\(aqcreatesuperuser\(aq,
|
|
|
|
|
interactive=False)\fP\&. To find what keyword argument name to use for
|
2018-05-17 13:30:20 +00:00
|
|
|
|
\fBcall_command()\fP, check the command\(aqs source code for the \fBdest\fP argument
|
2017-09-22 16:26:46 +00:00
|
|
|
|
passed to \fBparser.add_argument()\fP\&.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.sp
|
|
|
|
|
Command options which take multiple options are passed a list:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.sp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
|
|
|
|
management.call_command(\(aqdumpdata\(aq, exclude=[\(aqcontenttypes\(aq, \(aqauth\(aq])
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
2017-09-22 16:26:46 +00:00
|
|
|
|
.sp
|
|
|
|
|
The return value of the \fBcall_command()\fP function is the same as the return
|
|
|
|
|
value of the \fBhandle()\fP method of the command.
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.SH OUTPUT REDIRECTION
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.sp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
Note that you can redirect standard output and error streams as all commands
|
|
|
|
|
support the \fBstdout\fP and \fBstderr\fP options. For example, you could write:
|
|
|
|
|
.INDENT 0.0
|
|
|
|
|
.INDENT 3.5
|
2007-06-10 06:33:31 +00:00
|
|
|
|
.sp
|
2015-03-07 10:40:30 +00:00
|
|
|
|
.nf
|
|
|
|
|
.ft C
|
2019-09-10 08:10:50 +00:00
|
|
|
|
with open(\(aq/path/to/command_output\(aq, \(aqw\(aq) as f:
|
2015-03-07 10:40:30 +00:00
|
|
|
|
management.call_command(\(aqdumpdata\(aq, stdout=f)
|
|
|
|
|
.ft P
|
|
|
|
|
.fi
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.UNINDENT
|
|
|
|
|
.SH AUTHOR
|
|
|
|
|
Django Software Foundation
|
|
|
|
|
.SH COPYRIGHT
|
|
|
|
|
Django Software Foundation and contributors
|
|
|
|
|
.\" Generated by docutils manpage writer.
|
|
|
|
|
.
|