mirror of
https://github.com/django/django.git
synced 2024-12-23 01:25:58 +00:00
Updated man page for Django 3.1 alpha.
This commit is contained in:
parent
0b938cb7d2
commit
d51e090db2
@ -1,6 +1,6 @@
|
|||||||
.\" Man page generated from reStructuredText.
|
.\" Man page generated from reStructuredText.
|
||||||
.
|
.
|
||||||
.TH "DJANGO-ADMIN" "1" "September 10, 2019" "3.0" "Django"
|
.TH "DJANGO-ADMIN" "1" "May 12, 2020" "3.1" "Django"
|
||||||
.SH NAME
|
.SH NAME
|
||||||
django-admin \- Utility script for the Django Web framework
|
django-admin \- Utility script for the Django Web framework
|
||||||
.
|
.
|
||||||
@ -40,14 +40,8 @@ does the same thing as \fBdjango\-admin\fP but also sets the
|
|||||||
project\(aqs \fBsettings.py\fP file.
|
project\(aqs \fBsettings.py\fP file.
|
||||||
.sp
|
.sp
|
||||||
The \fBdjango\-admin\fP script should be on your system path if you installed
|
The \fBdjango\-admin\fP script should be on your system path if you installed
|
||||||
Django via its \fBsetup.py\fP utility. If it\(aqs not on your path, you can find it
|
Django via \fBpip\fP\&. If it\(aqs not in your path, ensure you have your virtual
|
||||||
in \fBsite\-packages/django/bin\fP within your Python installation. Consider
|
environment activated.
|
||||||
symlinking it from some place on your path, such as \fB/usr/local/bin\fP\&.
|
|
||||||
.sp
|
|
||||||
For Windows users, who do not have symlinking functionality available, you can
|
|
||||||
copy \fBdjango\-admin.exe\fP to a location on your existing path or edit the
|
|
||||||
\fBPATH\fP settings (under \fBSettings \- Control Panel \- System \- Advanced \-
|
|
||||||
Environment...\fP) to point to its installed location.
|
|
||||||
.sp
|
.sp
|
||||||
Generally, when working on a single Django project, it\(aqs easier to use
|
Generally, when working on a single Django project, it\(aqs easier to use
|
||||||
\fBmanage.py\fP than \fBdjango\-admin\fP\&. If you need to switch between multiple
|
\fBmanage.py\fP than \fBdjango\-admin\fP\&. If you need to switch between multiple
|
||||||
@ -164,6 +158,26 @@ django\-admin check \-\-tag models \-\-tag compatibility
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
|
.B \-\-database DATABASE
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
|
||||||
|
.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
|
||||||
.B \-\-list\-tags
|
.B \-\-list\-tags
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
@ -321,6 +335,56 @@ program manually.
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
Specifies the database onto which to open a shell. Defaults to \fBdefault\fP\&.
|
Specifies the database onto which to open a shell. Defaults to \fBdefault\fP\&.
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-\- ARGUMENTS
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
|
||||||
|
.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
|
||||||
.SS \fBdiffsettings\fP
|
.SS \fBdiffsettings\fP
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -558,9 +622,6 @@ Models are created for materialized views if
|
|||||||
Models are created for partition tables if
|
Models are created for partition tables if
|
||||||
\fI\%\-\-include\-partitions\fP is used.
|
\fI\%\-\-include\-partitions\fP is used.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
|
||||||
Support for foreign tables and materialized views was added.
|
|
||||||
|
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-\-database DATABASE
|
.B \-\-database DATABASE
|
||||||
@ -571,8 +632,6 @@ Specifies the database to introspect. Defaults to \fBdefault\fP\&.
|
|||||||
.TP
|
.TP
|
||||||
.B \-\-include\-partitions
|
.B \-\-include\-partitions
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
|
||||||
|
|
||||||
.sp
|
.sp
|
||||||
If this option is provided, models are also created for partitions.
|
If this option is provided, models are also created for partitions.
|
||||||
.sp
|
.sp
|
||||||
@ -1081,8 +1140,6 @@ name must be a valid Python \fI\%identifier\fP\&.
|
|||||||
.TP
|
.TP
|
||||||
.B \-\-no\-header
|
.B \-\-no\-header
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
|
||||||
|
|
||||||
.sp
|
.sp
|
||||||
Generate migration files without Django version and timestamp header.
|
Generate migration files without Django version and timestamp header.
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -1114,9 +1171,20 @@ to dependencies.
|
|||||||
\fB<app_label> <migrationname>\fP: Brings the database schema to a state where
|
\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
|
the named migration is applied, but no later migrations in the same app are
|
||||||
applied. This may involve unapplying migrations if you have previously
|
applied. This may involve unapplying migrations if you have previously
|
||||||
migrated past the named migration. Use the name \fBzero\fP to unapply all
|
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
|
||||||
migrations for an app.
|
migrations for an app.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
|
.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
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-\-database DATABASE
|
.B \-\-database DATABASE
|
||||||
@ -1153,8 +1221,6 @@ schema matches what is recorded in your initial migration.
|
|||||||
.TP
|
.TP
|
||||||
.B \-\-plan
|
.B \-\-plan
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
|
||||||
|
|
||||||
.sp
|
.sp
|
||||||
Shows the migration operations that will be performed for the given \fBmigrate\fP
|
Shows the migration operations that will be performed for the given \fBmigrate\fP
|
||||||
command.
|
command.
|
||||||
@ -1173,6 +1239,15 @@ with hundreds of models.
|
|||||||
.sp
|
.sp
|
||||||
Suppresses all user prompts. An example prompt is asking about removing stale
|
Suppresses all user prompts. An example prompt is asking about removing stale
|
||||||
content types.
|
content types.
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-\-check
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
|
||||||
|
.sp
|
||||||
|
Makes \fBmigrate\fP exit with a non\-zero status when unapplied migrations are
|
||||||
|
detected.
|
||||||
.SS \fBrunserver\fP
|
.SS \fBrunserver\fP
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -1225,9 +1300,6 @@ The default timeout of \fBWatchman\fP client is 5 seconds. You can change it
|
|||||||
by setting the \fBDJANGO_WATCHMAN_TIMEOUT\fP environment variable.
|
by setting the \fBDJANGO_WATCHMAN_TIMEOUT\fP environment variable.
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
|
||||||
Watchman support replaced support for \fIpyinotify\fP\&.
|
|
||||||
|
|
||||||
.sp
|
.sp
|
||||||
When you start the server, and each time you change Python code while the
|
When you start the server, and each time you change Python code while the
|
||||||
server is running, the system check framework will check your entire Django
|
server is running, the system check framework will check your entire Django
|
||||||
@ -1658,8 +1730,6 @@ first and last migration, with \fB_squashed_\fP in between.
|
|||||||
.TP
|
.TP
|
||||||
.B \-\-no\-header
|
.B \-\-no\-header
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
|
||||||
|
|
||||||
.sp
|
.sp
|
||||||
Generate squashed migration file without Django version and timestamp header.
|
Generate squashed migration file without Django version and timestamp header.
|
||||||
.SS \fBstartapp\fP
|
.SS \fBstartapp\fP
|
||||||
@ -1901,8 +1971,9 @@ Preserves the test database between test runs. This has the advantage of
|
|||||||
skipping both the create and destroy actions which can greatly decrease the
|
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
|
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
|
does not exist, it will be created on the first run and then preserved for each
|
||||||
subsequent run. Any unapplied migrations will also be applied to the test
|
subsequent run. Unless the \fBMIGRATE\fP test setting is
|
||||||
database before running the test suite.
|
\fBFalse\fP, any unapplied migrations will also be applied to the test database
|
||||||
|
before running the test suite.
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
.B \-\-reverse, \-r
|
.B \-\-reverse, \-r
|
||||||
@ -1946,6 +2017,15 @@ Each process gets its own database. You must ensure that different test cases
|
|||||||
don\(aqt access the same resources. For instance, test cases that touch the
|
don\(aqt access the same resources. For instance, test cases that touch the
|
||||||
filesystem should create a temporary directory for their own use.
|
filesystem should create a temporary directory for their own use.
|
||||||
.sp
|
.sp
|
||||||
|
\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
|
||||||
This option requires the third\-party \fBtblib\fP package to display tracebacks
|
This option requires the third\-party \fBtblib\fP package to display tracebacks
|
||||||
correctly:
|
correctly:
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
@ -2018,6 +2098,15 @@ This feature is only available for Python 3.7 and later.
|
|||||||
.sp
|
.sp
|
||||||
Spawns a \fBpdb\fP debugger at each test error or failure. If you have it
|
Spawns a \fBpdb\fP debugger at each test error or failure. If you have it
|
||||||
installed, \fBipdb\fP is used instead.
|
installed, \fBipdb\fP is used instead.
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-\-buffer, \-b
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
|
||||||
|
.sp
|
||||||
|
Discards output (\fBstdout\fP and \fBstderr\fP) for passing tests, in the same way
|
||||||
|
as \fI\%unittest\(aqs \-\-buffer option\fP\&.
|
||||||
.SS \fBtestserver\fP
|
.SS \fBtestserver\fP
|
||||||
.INDENT 0.0
|
.INDENT 0.0
|
||||||
.TP
|
.TP
|
||||||
@ -2235,6 +2324,15 @@ the deletion.
|
|||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
.sp
|
||||||
Specifies the database to use. Defaults to \fBdefault\fP\&.
|
Specifies the database to use. Defaults to \fBdefault\fP\&.
|
||||||
|
.INDENT 0.0
|
||||||
|
.TP
|
||||||
|
.B \-\-include\-stale\-apps
|
||||||
|
.UNINDENT
|
||||||
|
.sp
|
||||||
|
|
||||||
|
.sp
|
||||||
|
Deletes stale content types including ones from previously installed apps that
|
||||||
|
have been removed from \fBINSTALLED_APPS\fP\&. Defaults to \fBFalse\fP\&.
|
||||||
.SS \fBdjango.contrib.gis\fP
|
.SS \fBdjango.contrib.gis\fP
|
||||||
.SS \fBogrinspect\fP
|
.SS \fBogrinspect\fP
|
||||||
.sp
|
.sp
|
||||||
@ -2393,8 +2491,6 @@ django\-admin runserver \-\-no\-color
|
|||||||
.TP
|
.TP
|
||||||
.B \-\-force\-color
|
.B \-\-force\-color
|
||||||
.UNINDENT
|
.UNINDENT
|
||||||
.sp
|
|
||||||
|
|
||||||
.sp
|
.sp
|
||||||
Forces colorization of the command output if it would otherwise be disabled
|
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
|
as discussed in \fI\%Syntax coloring\fP\&. For example, you may want to pipe
|
||||||
|
Loading…
Reference in New Issue
Block a user