djangodocs

Django 6.1
Gaeilge
Documentation contents

django-admin agus manage.py

Is é ``django-admin ``fóntais líne ordaithe Django le haghaidh tascanna riaracháin. Tugann an doiciméad seo leagan amach ar gach is féidir leis a dhéanamh.

Ina theannta sin, cruthaítear manage.py` go huathoibríoch i ngach tionscadal Django. Déanann sé an rud céanna le django-admin ``ach socraíonn sé an athróg comhshaoil: envvar: `DJANGO_SETTINGS_MODULE` ionas go dtreoraíonn sé comhad ``settings.py do thionscadail.

Ba chóir go mbeadh an script django-admin ``ar do chonair chórais má shuiteáil tú Django trí ``pip. Mura bhfuil sé i do chosán, cinntigh go bhfuil do thimpeallacht fhíorúil gníomhachtaithe agat.

Go ginearálta, agus tú ag obair ar thionscadal amháin Django, tá sé níos éasca manage.py a úsáid ná ``django-admin ``. Más gá duit aistriú idir iolracha comhaid socruithe Django, bain úsáid as ``django-admin ``le: envvar: DJANGO_SETTINGS_MODULE nó an rogha líne ordaithe: --settings.

Úsáideann na samplaí líne ordaithe ar fud an doiciméad seo django-admin ``le bheith comhsheasmhach, ach is féidir le haon sampla `manage.py nó python -m django` a úsáid chomh maith.

Úsáid

Linux / macOS

Shell
$ django-admin <command> [options]
$ manage.py <command> [options]
$ python -m django <command> [options]

Windows

Windows
...\> django-admin <command> [options]
...\> manage.py <command> [options]
...\> py -m django <command> [options]

Ba chóir go mbeadh ord ar cheann de na horduithe atá liostaithe sa doiciméad seo. Ba chóir go mbeadh “roghanna”, atá roghnach, nialas nó níos mó de na roghanna atá ar fáil don ordú tugtha.

Cúnamh rith a fháil

django-admin help

Rith ``cabhair django-admin ``chun faisnéis úsáide agus liosta de na horduithe a sholáthraíonn gach feidhmchlár a thaispeáint.

Rith django-admin help --commands chun liosta de na horduithe go léir atá ar fáil a thaispeáint.

Rith ``django-admin cabhair <command>``chun cur síos ar an ordú tugtha agus liosta de na roghanna atá ar fáil a thaispeáint.

Ainmneacha aipeanna

Tógann go leor orduithe liosta de “ainmneacha aipeanna.” Is é “ainm aip” bunainm an phacáiste ina bhfuil do mhúnlaí. Mar shampla, má tá an teaghrán 'mysite.blog' i dta:setting: INSTALLED_APPS, is é blog` ainm an aip.

An leagan a chinneadh

django-admin version

Rith ``leagan django-admin ``chun an leagan reatha Django a thaispeáint.

Leanann an t-aschur an scéim a thuairiscítear in:pep: 440:

Text
1.4.dev17026
1.4a1
1.4

Aschur dífhabhtaithe á th

Úsáid: rogha: --verbosity, nuair a thacaítear leis, chun an méid fógra a shonrú agus an fhaisnéis a dhífhabhtú a phriontáil ``django-admin ``chuig an gconsól.

Orduithe atá ar fáil

``Seiceáil ``

django-admin check [app_label [app_label ...]]

Úsáideann sé an: doc: creat seiceála córas chun an tionscadal iomlán Django a ini</ref/checks> úchadh le haghaidh fadhbanna coitianta.

De réir réamhshocraithe, seiceálfar gach aip. Is féidir leat fo-thacar aipeanna a sheiceáil trí liosta lipéid aipeanna a sholáthar mar argóintí:

Shell
django-admin check auth admin myapp
--tag TAGS, -t TAGS

<system-check-builtin-tags>Déanann creat seiceála an chórais go leor cineálacha éagsúla seiceálacha ara:ref: `catagóirithe le clibeanna `. Is féidir leat na clibeanna seo a úsáid chun na seiceálacha a dhéantar a shrianadh chuig iad siúd i gcatagóir áirithe. Mar shampla, chun samhlacha agus seiceálacha comhoiriúnachta a dhéanamh amháin, reáchtáil:

Shell
django-admin check --tag models --tag compatibility
--database DATABASE

Sonraíonn an bunachar sonraí chun seiceálacha a reáchtáil a éilíonn

Shell
django-admin check --database default --database other

De réir réamhshocraithe, ní reáchtálfar na seiceálacha seo.

--list-tags

Liostaíonn gach clib atá ar fáil.

--deploy

Gníomhachtaíonn sé roinnt seiceálacha breise nach bhfuil ábhartha ach i suíomh imscartha.

Is féidir leat an rogha seo a úsáid i do thimpeallacht forbartha áitiúil, ach ós rud é go mb'fhéidir nach bhfuil go leor de do shocruithe táirgeachta ag do mhodúl socruithe forbartha áitiúil, is dócha go mbeidh tú ag iarraidh an t-ordú check a chur ar mhodúl socruithe difriúil, tríd an athróg timpeallachta:

Shell
django-admin check --deploy --settings=production_settings

Nó d'fhéadfá é a reáchtáil go díreach ar imscaradh léiriúcháin nó stáitse chun a fhíorú go bhfuil na socruithe cearta in úsáid (``--socruithe ``a fhágáil). D'fhéadfá é a dhéanamh mar chuid de do tsraith tástála comhtháthaithe fiú.

--fail-level {CRITICAL,ERROR,WARNING,INFO,DEBUG}

Sonraíonn sé an leibhéal teachtaireachta a chuirfidh ar an ordú imeacht le stádas neamh-nialas. Is é “ERROR” réamhshocraithe.

teachtaireachtaí tiomsaitheach

django-admin compilemessages

Tiomsaíonn sé comhaid .po a chruthaí:djadmin: makemessages chuig comhaid .mo` le húsáid leis an tacaíocht gettext ionsuite. Féach: doc: /topics/i18n/index.

--locale LOCALE, -l LOCALE

Sonraíonn sé na háiteanna atá le próiseáil. Mura gcuirtear ar fáil, déantar gach ceann áitiúil a phróiseáil.

--exclude EXCLUDE, -x EXCLUDE

Sonraíonn sé na háiteanna atá le eisiamh ó phróiseáil. Mura gcuirtear ar fáil, níl aon áiteanna áitiúla eisiata.

--use-fuzzy, -f

Cuimsíonn sé aistriúcháin doiléirí i gcomhaid thiomsaithe.

Úsáid sampla:

Shell
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
--ignore PATTERN, -i PATTERN

Déanann sé neamhaird ar eolairí a mheaitseálann leis an bpatrún given:mod: glob-style. Úsáid arís agus arís eile chun neamhaird a dhéanamh de

Úsáid sampla:

Shell
django-admin compilemessages --ignore=node_modules --ignore=outdated/*/locale

cruthaitheachtabhaí

django-admin createcachetable

Cruthaíonn sé na táblaí taisce le húsáid le cúltaca taisce an bhunachar sonraí agus an fhaisnéis ó do chomhad socruithe á úsáid. Féach: doc: /topics/cache le haghaidh tuilleadh faisnéise.

--database DATABASE

Sonraíonn sé an bunachar sonraí ina gcruthófar an tábla/na taisce. Réamhshocraithe go réamhshocraithe.

--dry-run

Priontáil an SQL a bheidh á reáchtáil gan é a reáchtáil i ndáiríre, ionas gur féidir leat é a shaincheapadh nó an creat imirce a úsáid.

dbshell

django-admin dbshell

Ritheann sé an cliant líne ordaithe don inneall bunachar sonraí a shonraítear i do shuíomh: socrú: ENGIN <DATABASE-ENGINE>, leis na paraiméadair nasc a shonraítear i do: setting: USER, :setting: PASSWORD, srl., socruithe.

  • Maidir le PostgreSQL, ritheann sé seo an cliant líne ordaithe ``psql ``.

  • Maidir le MySQL, ritheann sé seo an cliant líne ordaithe ``mysql`.

  • Maidir le SQLite, ritheann sé seo an cliant líne ordaithe ``sqlite3`.

  • Maidir le Oracle, ritheann sé seo an cliant líne ordaithe ``sqlplus ``.

Glacann an t-ordú seo leis go bhfuil na cláir ar do PATH` ionas go bhfaighidh glao chuig ainm an chláir (psql, mysql`, sqlite3`, sqlplus`) an clár san áit cheart. Níl aon bhealach ann suíomh an chláir a shonrú de láimh.

--database DATABASE

Sonraíonn sé an bunachar sonraí chun blaosc a oscailt air. Réamhshocraithe go réamhshocraithe.

-- ARGUMENTS

Cuirfear aon argóintí tar éis roinnteora -- `ar aghaidh chuig an gcliant líne ordaithe bunúsach. Mar shampla, le PostgreSQL is féidir leat bratach ``-c an ordaithe psql a úsáid chun fiosrúchán SQL amh a fhorghníomhú go díreach:

Linux / macOS

Shell
$ django-admin dbshell -- -c 'select current_user'
 current_user
--------------
 postgres
(1 row)

Windows

Windows
...\> django-admin dbshell -- -c 'select current_user'
 current_user
--------------
 postgres
(1 row)

Ar MySQL/MariaDB, is féidir leat é seo a dhéanamh le bratach -e an ordaithe mysql:

Linux / macOS

Shell
$ django-admin dbshell -- -e "select user()"
+----------------------+
| user()               |
+----------------------+
| djangonaut@localhost |
+----------------------+

Windows

Windows
...\> django-admin dbshell -- -e "select user()"
+----------------------+
| user()               |
+----------------------+
| djangonaut@localhost |
+----------------------+

``difríochtaí ``

django-admin diffsettings

Taispeánann sé difríochtaí idir an comhad socruithe reatha agus socruithe réamhshocraithe Django (nó comhad socruithe eile a shonraítear ar:option: --default).

Leanann "###" socruithe nach bhfuil le feiceáil sna réamhshocruithe. Mar shampla, ní shainmhíníonn na socruithe réamhshocraithe:setting: ROOT_URLCONF, mar sin: ROOT_URLCONF tar éis "###" i aschur diffsettings.

--all

Taispeánann sé na socruithe go léir, fiú má tá luach réamhshocraithe Django acu. Tá socruithe den sórt sin réamhshocraithe le "###".

--default MODULE

An modúl socruithe chun comparáid a dhéanamh idir na socruithe reatha ina choinne. Fág folamh le comparáid i gcoinne socruithe réamhshocraithe Django.

--output {hash,unified}

Sonraíonn an fhormáid aschuir. Is iad na luachanna atá ar fáil ná hash` agus aontaithe ``. Is é ``hash ``an modh réamhshocraithe a thaispeánann an t-aschur atá cur síos thuas. Taispeánann ``unified an t-aschur cosúil le diff -u. Déantar socruithe réamhshocraithe a réamhshocrú le comhartha lúide, agus ina dhiaidh sin tá an suíomh athraithe réamhshocraithe le comhartha móide.

Dumpdata

django-admin dumpdata [app_label[.ModelName] [app_label[.ModelName] ...]]

Aschuir chuig aschur caighdeánach gach sonraí sa bhunachar sonraí a bhaineann leis an bhfeidhmchlár (í) ainmnithe.

Mura gcuirtear aon ainm iarratais ar fáil, déanfar gach feidhmchlár suiteáilte a dumpáil.

Is féidir aschur ``dumpdata ``a úsáid mar ionchur le haghaidh: djadmin: loaddata.

<topics-testing-fixtures><initial-data-via-fixtures>Nuair a shábháiltear toradh dumpdata mar chomhad, féadfaidh sé feidhmiú mar a:ref: daingneán `le haghaidh: ref: `tástálacha nó mar an <fixtures-explanation>:ref: `sonraí tosaigh `.

Tabhair faoi deara go n-úsáideann `dumpdata ``an bainisteoir réamhshocraithe ar an tsamhail chun na taifid a roghnú le dumpáil. Má tá a: ref: `bainisteoir saincheaptha <custom-managers>`á úsáid agat mar an bhainisteoir réamhshocraithe agus scagann sé cuid de na taifid atá ar fáil, ní dhéanfar na rudaí go léir a dumpáil.

--all, -a

Úsáideann bainisteoir bonn Django, taifid dumpála a d'fhéadfadh bainisteoir saincheaptha a scagadh nó a mhodhnú ar shlí eile.

--format FORMAT

Sonraíonn sé formáid sraitheach an aschuir. Réamhshocraithe go JSON. Tá formáidí tacaithe liostaithe in:ref: serialization-formats.

--indent INDENT

Sonraíonn sé líon na spásanna ionbhrúite le húsáid san aschur. Réamhshocraithe go ``None ``a thaispeánann na sonraí go léir ar líne amháin.

--exclude EXCLUDE, -e EXCLUDE

Cuireann sé cosc ar iarratais nó samhlacha sonracha (sonraithe i bhfoirm App_Label.ModelName) a dumpáil. Má shonraíonn tú ainm samhail, ansin ní bheidh ach an tsamhail sin eisiata, seachas an feidhmchlár iomlán. Is féidir leat ainmneacha feidhmchláir agus ainmneacha samhail a mheascadh

Más mian leat iarratais iolracha a eisiamh, pas --eisiam níos mó ná uair amháin:

Shell
django-admin dumpdata --exclude=auth --exclude=contenttypes
--database DATABASE

Sonraíonn sé an bunachar sonraí as a ndéanfar sonraí a dumpáil. Réamhshocraithe go réamhshocraithe.

--natural-foreign

Úsáideann sé an modh samhail natural_key () ``chun aon eochair eachtrach agus gaol go leor a shraitheadh le rudaí den chineál a shainmhíníonn an modh. Má tá tú ag dumpáil rudaí ``contrib.auth Ceadúna nó rudaí contrib.contenttypes contentType, is dócha gur chóir duit an bratach seo a úsáid. Féach an doiciméad:ref: `eochracha nádúrtha <topics-serialization-natural-keys>`le haghaidh tuilleadh sonraí faoin gcéad rogha seo agus an chéad rogha eile.

--natural-primary

Fágann sé an príomh-eochair i sonraí sraitheacha an réada seo ós rud é gur féidir é a ríomh le linn díshealaithe.

--pks PRIMARY_KEYS

Ní aschuireann ach na rudaí a shonraítear le liosta scoite camóg d'eochracha bunscoile. Níl sé seo ar fáil ach amháin nuair a dhumpáiltear samhail amháin. De réir réamhshocraithe, tá gach taifid den tsamhail aschur.

--output OUTPUT, -o OUTPUT

Sonraíonn sé comhad chun na sonraí sraitheacha a scríobh chuig. De réir réamhshocraithe, téann na sonraí chuig aschur caighdeánach.

Nuair a shocraítear an rogha seo agus go bhfuil - verbosity` níos mó ná 0 (an réamhshocraithe), taispeántar barra dul chun cinn sa chríochfort.

Daingneáin comhbhrú

Is féidir an comhad aschuir a chomhbhrú le ceann de na formáidí bz2, gz`, lzma, nó xz tríd an ainm comhaid a chríochnú leis an síneadh comhfhreagrach. Mar shampla, chun na sonraí a aschur mar chomhad JSON comhbhrúite:

Shell
django-admin dumpdata -o mydata.json.gz

`Flush

django-admin flush

Baineann sé na sonraí go léir ón mbunachar sonraí agus déanann sé aon láimhseálaithe iar-sioncrónaithe Ní ghlantar an tábla ar cuireadh imirce i bhfeidhm air.

Más fearr leat tosú ó bhunachar sonraí folamh agus gach imirce a athreáchtáil, ba cheart duit an bunachar sonraí a scaoileadh agus a athchruthú agus ansin rith: djadmin: migrate ina ionad.

--noinput, --no-input

Cuireann sé cosc ar gach leideanna úsáideora.

--database DATABASE

Sonraíonn sé an bunachar sonraí le sruthú. Réamhshocraithe go réamhshocraithe.

Inspectdb

django-admin inspectdb [table [table ...]]

Déanann sé iniúchadh ar na táblaí bunachar sonraí sa bhunachar sonraí a shonraítear trí:setting: NAME agus aschur modúl samhail Django (comhad ``models.py`) chuig aschur caighdeánach.

Féadfaidh tú na táblaí nó na tuairimí atá le iniúchadh a roghnú trí a n-ainmneacha a chur ar aghaidh Mura gcuirtear aon argóintí ar fáil, cruthaítear samhlacha le haghaidh tuairimí ach amháin má úsáidtear an roghna:option: --include-views. Cruthaítear samhlacha do tháblaí deighilte ar PostgreSQL má úsáidtear an rogha: rogha: --include-parttions.

Úsáid é seo má tá bunachar sonraí oidhreachta agat ar mhaith leat Django a úsáid leis. Déanfaidh an script iniúchadh ar an mbunachar sonraí agus cruthóidh sé samhail do gach tábla laistigh de.

As you might expect, the created models will have an attribute for every field in the table. Note that inspectdb has a few special cases and limitations in its output:

  • Mura féidir le inspectdb cineál colún a mhapáil go cineál réimse samhail, úsáidfidh sé Textfield agus cuirfidh sé an trácht Python isteach `Is tuairim é an cineál réimse seo.` in aice leis an réimse sa tsamhail ghintear. Féadfaidh na réimsí aitheanta ag brath ar aipeanna atá liostaithe in:setting: INSTALLED_APPS. Mar shampla, cuireann :mod: django.contrib.postgres aitheantas do roinnt cineálacha réimse atá sonrach le PostgreSQL.

  • Más focal curtha in áirithe Python é ainm an cholún bunachar sonraí (mar shampla `'pass', class' nó `for'), cuirfidh inspectdb `_field' leis an ainm tréithe. Mar shampla, má tá colún 'for' i dtábla, beidh réimse 'for_field' ag an tsamhail ghintear, agus an tréith db_column socraithe go `for'. Cuirfidh inspectdb an trácht Python isteach ```Athainmníodh réimse toisc gur focal forchoimeádaithe Python a bhí aige. '``in aice leis an réimse.

  • Database defaults are not introspected and will be absent from the generated output.

  • Generated fields are mapped to their output field type.

  • Models that reference each other may not be in the correct order.

  • If models were managed by Django's migration framework, Python-level field options that have no database-level representation will not be included. In particular, Field.default will not be included, and Python variants for on_delete are always emitted as DO_NOTHING.

As such, after you run it, you'll want to look over the generated models yourself to make customizations. This feature is meant as a shortcut, not as definitive model generation.

De réir réamhshocraithe, cruthaíonn inspectdb ``samhlacha neamh-bhainistithe. Is é sin, deir ``bhainistithe = False i rang Meta an tsamhail le Django gan cruthú, modhnú agus scriosadh gach tábla a bhainistiú. Más mian leat ligean a thabhairt do Django saolré an tábla a bhainistiú, beidh ort an rogha: attr: ~django.db.models.options.managed a athrú go True` (nó é a bhaint toisc gurb é True` a luach réamhshocraithe).

Nótaí sonracha bunachar sonraí

Oracle

  • Cruthaítear samhlacha le haghaidh tuairimí ábhartha má úsáidtear: rogha: --include-views.

PostgreSQL

  • Cruthaítear samhlacha le haghaidh táblaí eachtracha.

  • Cruthaítear samhlacha le haghaidh tuairimí ábhartha má úsáidtear: rogha: --include-views.

  • Cruthaítear samhlacha le haghaidh táblaí deighilte má úsáidtear: rogha: --include-parttions.

--database DATABASE

Sonraíonn sé an bunachar sonraí chun iontráil a dhéanamh. Réamhshocraithe go réamhshocraithe.

--include-partitions

Má chuirtear an rogha seo ar fáil, cruthaítear samhlacha le haghaidh deighiltí freisin.

Ní chuirtear ach tacaíocht do PostgreSQL i bhfeidhm.

--include-views

Má chuirtear an rogha seo ar fáil, cruthaítear samhlacha freisin le haghaidh tuairimí bunachar sonraí.

Loaddata

django-admin loaddata fixture [fixture ...]

<fixtures-explanation>Cuardaigh agus luchtú ábhar an ainmne:ref: `daingneáin `isteach sa bhunachar sonraí.

--database DATABASE

Sonraíonn sé an bunachar sonraí ina luchtálfar na sonraí. Réamhshocraithe go réamhshocraithe.

--ignorenonexistent, -i

Déanann sé neamhaird ar réimsí agus samhlacha a d'fhéadfadh a bheith bainte ó ghintear an daingneán ar dtús.

--app APP_LABEL

Sonraíonn sé aip amháin chun daingneáin a lorg seachas breathnú i ngach aip.

--format FORMAT

<loading-fixtures-stdin>Sonraíonn sé an fhormáid: ref: sraitheoireacht <serialization-formats>`(m.sh., ``json` nó xml) le haghaidh daingneáin: ref: léamh ó stdin.

--exclude EXCLUDE, -e EXCLUDE

Ní áirítear na daingneáin a luchtú ó na feidhmchláir agus/nó na samhlacha ar leith (i bhfoirm app_label nó App_Label.ModelNam). Úsáid an rogha arís agus arís eile chun níos mó ná aip nó samhail amháin a eisiamh.

Daingneáin á luchtú ó stdin

Is féidir leat doic a úsáid mar ainm an daingneáin chun ionchur a luchtú ó sys.stdin. Mar shampla:

Shell
django-admin loaddata --format=json -

<serialization-formats>Agus tú ag léamh ó stdin`, <loaddata --format>is gá ar an roghna:rogha: --format `chun an: ref: `formáid sraitheach den ionchur a shonrú (m.sh., json nó xml).

Tá luchtú ó `stdin ``úsáideach le hathreoruithe ionchuir agus aschuir caighdeánacha. Mar shampla:

Shell
django-admin dumpdata --format=json --database=test app_label.ModelName | django-admin loaddata --format=json --database=prod -

Is féidir an t-ordú: DJadmin: dumpdata a úsáid chun ionchur a ghiniúint do loaddata.

``déanmhachtaireachtaí ``

django-admin makemessages

Ritheann sé thar chrann foinse iomlán an eolaire reatha agus tarraingíonn sé amach gach teaghráin atá marcáilte le haistriúchán. Cruthaíonn sé (nó nuashonraíonn sé) comhad teachtaireachta san eolaire conf/locale (sa chrann Django) nó áitiúil (le haghaidh tionscadail agus feidhmchláir). Tar éis athruithe a dhéanamh ar na comhaid teachtaireachtaí ní mór duit iad a thiomsú le: djadmin: compilemessages le húsáid leis an tacaíocht gettext bunaithe. <how-to-create-language-files>Féach an doiciméadú: ref: `i18n `le haghaidh sonraí.

Ní theastaíonn socruithe cumraithe ag an ordú seo. Mar sin féin, nuair nach bhfuil socruithe cumraithe, ní féidir leis an ordú neamhaird a dhéanamh ar eolairí: socrú: MEDIA_ROOT agus:setting: STATIC_ROOT nó lena n-áirítear: socrú: LOCALE_PATHS.

--all, -a

Nuashonraíonn sé na comhaid teachtaireachta do gach teanga atá ar fáil.

--extension EXTENSIONS, -e EXTENSIONS

Sonraíonn sé liosta síntí comhaid le scrúdú (réamhshocraithe: html, txt`, py` nó js ``ife:option: `--domain` is ``djangojs).

Úsáid sampla:

Shell
django-admin makemessages --locale=de --extension xhtml

Déan síntí iolracha a scaradh le camóga nó bain úsáid as -e nó ``-- síneadh ``arís agus arís eile:

Shell
django-admin makemessages --locale=de --extension=html,txt --extension xml
--locale LOCALE, -l LOCALE

Sonraíonn sé na háiteanna atá le próiseáil.

--exclude EXCLUDE, -x EXCLUDE

Sonraíonn sé na háiteanna atá le eisiamh ó phróiseáil. Mura gcuirtear ar fáil, níl aon áiteanna áitiúla eisiata.

Úsáid sampla:

Shell
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
--domain DOMAIN, -d DOMAIN

Sonraíonn fearann na gcomhaid teachtaireachtaí. Is iad na roghanna tacaithe:

  • django do gach comhad *.py, *.html` agus ``*.txt ``(réamhshocraithe)

  • djangojs do chomhaid ``*.js ``

Leanann sé naisc shiombailí chuig eolairí agus tú ag lorg teaghráin aistriú

Úsáid sampla:

Shell
django-admin makemessages --locale=de --symlinks
--ignore PATTERN, -i PATTERN

Déanann sé neamhaird ar chomhaid nó eolairí a mheaitseálann leis an bpatrún given:mod: `global `style. Úsáid arís agus arís eile chun neamhaird a dhéanamh de

Úsáidtear na patrúin seo de réir réamhshocraithe: 'CVS', `.*', `*~', '*.pyc'.

Úsáid sampla:

Shell
django-admin makemessages --locale=en_US --ignore=apps/* --ignore=secret/*.html
--no-default-ignore

Díchumasaíonn luachanna réamhshocraithe - ignore.

--no-wrap

Díchumasaíonn sé línte teachtaireachta fada a bhriseadh i roinnt línte i gcomhaid

--no-location

Cuireann sé cosc ar scríbhneoireacht '#: fileainm:line' línte tráchta i gcomhaid teanga. Má úsáidtear an rogha seo, bíonn sé níos deacra d'aistritheoirí oilte go teicniúil comhthéacs gach teachtaireachta

--add-location [{full,file,never}]

Rialuithe #: ainm comhad:line línte tráchta i gcomhaid teanga. Más é an rogha:

  • iomlána (an réamhshocrú mura dtugtar): tá ainm comhaid agus uimhir líne san áireamh sna línte.

  • ``comhad ``: fágtar an uimhir líne.

  • ``riamh ``: cuirtear na línte faoi chois (mar an gcéanna le: rogha: --no-location).

Éilíonn gettext 0.19 nó níos nuaí.

--no-obsolete

Baineann teaghráin teachtaireachta atá as feidhm as na comhaid .po.

--keep-pot

Cuireann sé cosc ar na comhaid shealadacha .pot a ghintear a scriosadh sula gcruthaítear an comhad .po. Tá sé seo úsáideach le haghaidh earráidí dífhabhtaithe a d'fhéadfadh cosc a chur ar na comhaid teanga deiridh a chruthú.

déanaimirceach

django-admin makemigrations [app_label [app_label ...]]

Cruthaíonn imirce nua bunaithe ar na hathruithe a bhraitear ar do mhúnlaí. Tá imirce, a gcaidreamh le feidhmchláir agus go leor eile clúdaithe go domhain in:doc: `an doicimé@@</topics/migrations> adú imirceacha'.

Ag soláthar ainm aipeanna amháin nó níos mó mar argóintí, cuirfear teorainn leis na himirce a cruthaíodh chuig an aip (í) a shonraítear agus aon spleáchais atá ag teastáil (an tábla ag an gceann eile de ForeignKey, mar shampla).

Chun imirce a chur le aip nach bhfuil eolaire migrations` aige, reáchtáil ``makemigrations le app_label` an aip.

--noinput, --no-input

Cuireann sé cosc ar gach leideanna úsáideora. Mura féidir pras faoi chois a réiteach go huathoibríoch, imeoidh an t-ordú le cód earráide 3.

--empty

Aisíonn imirce folamh do na feidhmchláir sonraithe, le haghaidh eagarthóireachta láimhe. Tá sé seo le haghaidh ardúsáideoirí agus níor cheart é a úsáid mura bhfuil tú eolach ar an bhformáid imirce, ar oibríochtaí imirce, agus na spleáchais idir d'imirce.

--dry-run

Taispeánann sé cad iad na himirce a dhéanfaí gan aon chomhaid imirce a scríobh chuig diosca. Ag baint úsáide as an rogha seo in éineacht le --verbosity 3 taispeánfar na comhaid imirce iomlána a scríobhadh freisin.

--merge

Cumasaíonn sé coinbhleachtaí imirce a shocrú

--name NAME, -n NAME

Ligeann sé an imirce ginte a ainmniú in ionad ainm ginte a úsáid. <python:identifiers>Caithfidh an t-ainm a bheith ina Python bailí:ref: `aitheantóir `.

--no-header

Ginigh comhaid imirce gan leagan Django agus ceannteideal stampa ama.

--check

Déanann sé imeacht makemigrations le stádas neamh-nialasach nuair a bhraitear athruithe samhail gan imirce. Tugann le tuiscint ``--dry-run `.

--scriptable

Atreoraíonn sé aschur log agus leideanna ionchuir chuig stderr, agus ní scríobhann ach cosáin de chomhaid imirce ginte chuig stdout.

--update

Comhcheanglaíonn sé athruithe samhail san imirce is déanaí agus na hoibríochtaí atá mar thoradh air a

Beidh ainm ginte ag an imirce nuashonraithe. D'fhonn an t-ainm roimhe seo a chaomhnú, socraigh é ag baint úsáide as ``--ainm ``.

`imirce

django-admin migrate [app_label] [migration_name]

Déanann sé an staid bunachar sonraí a shioncronú leis an tacar reatha samhlacha agus imirce. Tá imirce, a gcaidreamh le feidhmchláir agus go leor eile clúdaithe go domhain in:doc: `an doicimé@@</topics/migrations> adú imirceacha'.

Athraíonn iompar an ordaithe seo ag brath ar na hargóintí a chuirtear ar fáil:

  • Gan aon argóintí: Tá a n-imirce go léir á reáchtáil ag gach aip.

  • <app_label>```: Tá a imirce ag an aip sonraithe a reáchtáil, suas go dtí an imirce is déanaí. D'fhéadfadh imirce aipeanna eile a reáchtáil i gceist leis seo freisin, mar gheall ar spleáchas.

  • <app_label><migrationname>```: Tugann sé scéim an bhunachar sonraí go stát ina gcuirtear an imirce ainmnithe i bhfeidhm, ach ní chuirtear imirce níos déanaí san aip céanna i bhfeidhm. D'fhéadfadh go mbeadh imirce gan cur i bhfeidhm i gceist leis seo má rinne tú imirce thar an imirce ainmnithe Is féidir leat réimír den ainm imirce a úsáid, m.sh. 0001`, fad is atá sé uathúil d'ainm an aip ar leith. Úsáid an t-ainm ``nialó` chun imirce ar fad ar ais ie chun gach imirce a chur ar ais d'aip.

--database DATABASE

Sonraíonn sé an bunachar sonraí le himirce. Réamhshocraithe go réamhshocraithe.

--fake

Marcann na himirce suas go dtí an sprioccheann (ag leanúint na rialacha thuas) mar a chuirtear i bhfeidhm, ach gan an SQL a reáchtáil i ndáiríre chun do scéim bunachar sonraí

Tá sé seo beartaithe d'ardúsáideoirí an stát imirce reatha a ionramháil go díreach má tá athruithe á chur i bhfeidhm de láimh; tabhair rabhadh go mbíonn an baol ag baint úsáide as --fake tábla an stáit imirce a chur i stát ina mbeidh gá le téarnamh láimhe chun imirce a rith i gceart.

--fake-initial

Ligeann sé do Django imirce tosaigh aip a scipeáil má tá gach tábla bunachar sonraí le hainmneacha na samhlacha go léir a chruthaigh uach:class: ~django.db.migrations.operations.createModel oibríochtaí san imirce sin cheana féin. Tá an rogha seo beartaithe le húsáid nuair a bhíonn imirce á reáchtáil ar dtús i gcoinne bunachar sonraí a raibh úsáid imirce ann roimh ré. Ní sheiceálann an rogha seo, áfach, an scéim bunachar sonraí a mheaitseáil níos faide ná ainmneacha táblaí a mheaitseáil agus mar sin níl sé sábháilte le húsáid ach má tá tú muiníneach go bhfuil an scéim atá ann cheana comhoiriúnach leis an

--plan

Taispeánann sé na hoibríochtaí imirce a dhéanfar don ordú imirce a thugtar.

--run-syncdb

Ligeann sé táblaí a chruthú d'aipeanna gan imirce. Cé nach mholtar é seo, bíonn an creat imirce ró-mhall uaireanta ar thionscadail mhóra le céadta samhail.

--noinput, --no-input

Cuireann sé cosc ar gach leideanna úsáideora. Is sampla pras is ea fiafraí faoi chineálacha ábhair seasta a bhaint.

--check

Déanann sé imeacht imirce le stádas neamh-nialasach nuair a bhraitear imirce neamhfheidhmeacha.

--prune

Scriosann sé imirce nach bhfuil ann ón tábla django_migrations. Tá sé seo úsáideach nuair a baineadh comhaid imirce ina ionad imirce scáilte. Féach:ref: migration-squashing le haghaidh tuilleadh sonraí.

Eimirce barrfheabhsaithe

django-admin optimizemigration app_label migration_name

Uasmhéadaíonn sé na hoibríochtaí don imirce ainmnithe agus sáraíonn sé an comhad atá ann cheana. Má tá feidhmeanna san imirce nach mór a chóipeáil de láimh, cruthaíonn an t-ordú comhad imirce nua ar iarmhairc le _optimed atá i gceist chun an imirce ainmnithe a athsholáthar.

--check

Déanann sé “barrfheabhsú inimirce” imeacht le stádas neamh-nialasach nuair is féidir imirce a bharrfheabhsú.

Runserver

django-admin runserver [addrport]

Tosaíonn freastalaí gréasáin forbartha éadrom ar an meaisín áitiúil. De réir réamhshocraithe, ritheann an freastalaí ar chalafort 8000 ar an seoladh IP ``127.0.0.1 ``. Is féidir leat seoladh IP agus uimhir chalafoirt a chur isteach go sainráite.

Má ritheann tú an script seo mar úsáideoir le gnáthphribhléidí (moltar), b'fhéidir nach mbeidh rochtain agat calafort a thosú ar uimhir íseal calafort. Tá uimhreacha calafoirt íseal in áirithe don superuser (fréamh).

Úsáideann an freastalaí seo réad feidhmchláir WSGI a shonraítear leis an socrú: setting: WSGI_APPLICATION.

Athluchtaíonn an freastalaí forbartha cód Python go huathoibríoch do gach iarratas, de réir mar is Ní gá duit an freastalaí a atosú chun athruithe cód a bheith i bhfeidhm. Mar sin féin, ní spreagann roinnt gníomhartha cosúil le comhaid a chur leis atosú, mar sin beidh ort an freastalaí a atosú sna cásanna seo.

Má tá Linux nó macOS á úsáid agat agus má shuiteálann tú araon: pypi: pywatchman agus an tseirbhís Watchman, úsáidfear comharthaí eithne chun an freastalaí a athluchtú uathoibríoch (seachas stampaí ama modhnú comhad a vótáil gach soicind). Tugann sé seo feidhmíocht níos fearr ar thionscadail mhóra, am freagartha laghdaithe tar éis athruithe cód, braite athruithe níos láidre, agus laghdú ar úsáid cumhachta. Tacaíonn Django le pywatchman 1.2.0 agus níos airde.

Nuair a thosaíonn tú an freastalaí, agus gach uair a athraíonn tú cód Python agus an freastalaí ag rith, seiceálfaidh creat seiceála an chórais do thionscadal iomlán Django le haghaidh roinnt earráidí coitianta (féach an t-ordú:djadmin: check). Má aimsítear aon earráidí, clófar iad chuig aschur caighdeánach. Is féidir leat an rogha --skip-checks a úsáid chun seiceálacha córais reatha a scipeáil.

Is féidir leat an oiread freastalaithe comhthráthacha a reáchtáil agus is mian leat, chomh fada agus a bhíonn siad ar chalafoirt ar leithligh trí “django-admin runserver” a fhorghníomhú níos mó ná uair amháin.

Tabhair faoi deara nach bhfuil an seoladh IP réamhshocraithe, 127.0.0.1 ``, inrochtana ó mheaisíní eile ar do líonra. Chun do fhreastalaí forbartha a dhéanamh infheicthe do mheaisíní eile ar an líonra, bain úsáid as a sheoladh IP féin (m.sh. `192.168.2.1 ``), `0 (aicearra le haghaidh 0.0.0.0), 0.0.0.0, nó``: ``(le IPv6 cumasaithe).

Is féidir leat seoladh IPv6 a sholáthar timpeallaithe ag lúibíní (m.sh. [200a: :1]: 8000). Cumasóidh sé seo tacaíocht IPv6 go huathoibríoch.

Is féidir ainm óstach ina bhfuil carachtair ASCII amháin a úsáid freisin.

</ref/contrib/staticfiles> <staticfiles-runserver>Má tá an aip contrib: doc: staticfiles cumasaithe (réamhshocraithe i dtionscadail nua) cuirfear an t-ordú:djadmin: runserver ar a ordú féin: ref: runserver.

Seoltar logáil ar gach iarratas agus freagra an fhreastalaí chuig an logger:ref: django-server-logger.

--noreload

Díchumasann sé an t-athluchtaitheoir uathoibr Ciallaíonn sé seo go mbeidh aon athruithe cód Python a dhéanann tú agus an freastalaí ag rith * ní thiocfaidh éifeacht má tá na modúil Python áirithe luchtaithe i gcuimhne cheana féin.

--nothreading

Díchumasaíonn sé úsáid snáithe sa fhreastalaí forbartha. Tá an freastalaí ilshreathaithe de réir réamhshocraithe.

--ipv6, -6

Úsáideann IPv6 don fhreastalaí forbartha. Athraíonn sé seo an seoladh IP réamhshocraithe ó 127.0.0.1 go : :1.

DJANGO_RUNSERVER_HIDE_WARNING

By default, a warning is printed to the console that runserver is not suitable for production:

Text
WARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.
For more information on production servers see: https://docs.djangoproject.com/en/|version|/howto/deployment/

Set this environment variable to "true" to hide this warning.

Samplaí de úsáid calafoirt agus seoltaí éagsúla

Port 8000 ar sheoladh IP ``127.0.0.1 ``:

Shell
django-admin runserver

Port 8000 ar sheoladh IP ``1.2.3.4`:

Shell
django-admin runserver 1.2.3.4:8000

Port 7000 ar sheoladh IP ``127.0.0.1 ``:

Shell
django-admin runserver 7000

Port 7000 ar sheoladh IP 1.2.3.4:

Shell
django-admin runserver 1.2.3.4:7000

Port 8000 ar sheoladh IPv6 :: 1:

Shell
django-admin runserver -6

Port 7000 ar sheoladh IPv6 : :1:

Shell
django-admin runserver -6 7000

Port 7000 ar sheoladh IPv6 2001:0 db 8:1234:5678: :9:

Shell
django-admin runserver [2001:0db8:1234:5678::9]:7000

Port 8000 ar sheoladh IPv4 an óstach localhost:

Shell
django-admin runserver localhost:8000

Port 8000 ar sheoladh IPv6 an óstach localhost:

Shell
django-admin runserver -6 localhost:8000

Comhaid statacha a sheirbheáil leis an bhfreastalaí

De réir réamhshocraithe, ní fhreastalaíonn an freastalaí forbartha aon chomhaid statacha do do shuíomh (mar shampla comhaid CSS, íomhánna, rudaí faoi: socrú: MEDIA_URL agus mar sin de). Más mian leat Django a chumrú chun freastal ar na meáin statacha, léigh: doc: `/howto/static-files/index `.

Ag freastal le ASGI i bhforbairt

Soláthraíonn ordú runserver Django freastalaí WSGI. D'fhonn rith faoi ASGI beidh ort an:doc: ASGI freastala a </howto/deployment/asgi/index> úsáid. Soláthraíonn tionscadal Django Daphne:ref: daphne-runserver is féidir leat a úsáid.

sendtestemail

django-admin sendtestemail [email [email ...]]

Seolann sé ríomhphost tástála (chun a dhearbhú go bhfuil ríomhphost a sheoladh trí Django ag obair) chuig an bhfaighteoir (í) a sh Mar shampla:

Shell
django-admin sendtestemail foo@example.com bar@example.com

The following options may be used in any combination with each other and with recipient email arguments.

--using ALIAS

Specifies the MAILERS alias to use for sending the test email to the recipients given as arguments. Defaults to the "default" mailer.

--managers

Mails the email addresses specified in MANAGERS using mail_managers().

--admins

Mails the email addresses specified in ADMINS using mail_admins().

sliog

django-admin shell

Tosaíonn an ateangaire idirghníomhach Python.

All models from installed apps are automatically imported into the shell environment. Models from apps listed earlier in INSTALLED_APPS take precedence. The following common utilities are also imported:

Code
from django.db import connection, reset_queries, models
from django.conf import settings
from django.utils import timezone

For a --verbosity of 2 or higher, the automatically imported objects will be listed. To disable automatic importing entirely, use the --no-imports flag.

See the guide on customizing this behavior to add or remove automatic imports.

--interface {ipython,bpython,python}, -i {ipython,bpython,python}

Sonraíonn sé an bhlaosc atá le húsáid. De réir réamhshocraithe, úsáidfidh Django iPython nó bpython má tá ceachtar acu suiteáilte. Má tá an dá cheann suiteáilte, sonraigh cén ceann is mian leat mar sin:

IPython:

Shell
django-admin shell -i ipython

bpython:

Shell
django-admin shell -i bpython

Má tá blaosc “saibhir” suiteáilte agat ach má theastaíonn uait an ateangaire Python “simplí” a úsáid, bain úsáid as python` mar ainm an chomhéadain, mar sin:

Shell
django-admin shell -i python
--no-startup

Díchumasaíonn sé an script tosaithe a léamh don ateangairí Python “simplí”. De réir réamhshocraithe, léitear an script chuig an athróg comhshaoil: envvar: PYTHONSTARTUP nó an script ~/.pythonrc.py.

--no-imports

Disables the automatic import of models from INSTALLED_APPS.

--command COMMAND, -c COMMAND

Ligeann duit ordú a rith mar shreang chun é a fhorghníomhú mar Django, mar sin:

Shell
django-admin shell --command="import django; print(django.__version__)"

Is féidir leat cód a chur isteach ar ionchur caighdeánach chun é a fhorghníomhú. Mar shampla:

Shell
$ django-admin shell <<EOF
> import django
> print(django.__version__)
> EOF

Ar Windows, tá an REPL aschur mar gheall ar theorainneacha cur chun feidhme de:func: select.select ar an ardán sin.

imirce taispeánaithe

django-admin showmigrations [app_label [app_label ...]]

Taispeánann an imirce go léir i dtionscadal. Is féidir leat a roghnú ó cheann de dhá fhormáid:

--list, -l

Liostaíonn gach ceann de na feidhmchláir atá ar eolas ag Django fúthu, na himirce atá ar fáil do gach aip, agus cibé an gcuirtear gach imirce i bhfeidhm nó nach bhfuil (marcáilte le [X] in aice leis an ainm imirce). Maidir le - verbosity de 2 agus os a chionn, taispeántar na dáta a chuirtear i bhfeidhm freisin.

Liostaítear aipeanna gan imirce freisin, ach tá (gan imirce) clóite fúthu.

Is é seo an formáid aschuir réamhshocraithe.

--plan, -p

Taispeánann an plean imirce a leanfaidh Django chun imirce a chur i bhfeidhm. Cosúil le --liosta`, tá imirce feidhmithe marcáilte le ``[X]. Maidir le ``--fhógraíocht ``de 2 agus os a chionn, taispeánfar gach spleáchas imirce freisin.

Cuireann argóintí app_label` teorainn leis an aschur, áfach, féadfar spleáchais na n-aipeanna curtha ar fáil a áireamh freisin.

--database DATABASE

Sonraíonn sé an bunachar sonraí le scrúdú. Réamhshocraithe go réamhshocraithe.

``sqlflush ``

django-admin sqlflush

Priontáil na ráitis SQL a chuirfeadh i bhfeidhm don ordú:djadmin: flush.

--database DATABASE

Sonraíonn sé an bunachar sonraí chun an SQL a phriontáil. Réamhshocraithe go réamhshocraithe.

sqlmigrate

django-admin sqlmigrate app_label migration_name

Priontáil an SQL don imirce ainmnithe. Éilíonn sé seo nasc gníomhach bunachar sonraí, a úsáidfidh sé chun ainmneacha srianta a réiteach; ciallaíonn sé seo go gcaithfidh tú an SQL a ghiniúint i gcoinne cóip den bhunachar sonraí is mian leat é a chur i bhfeidhm níos déanaí.

Tabhair faoi deara nach ndéanann sqlmigrate` dathú a aschur.

--backwards

Gineann sé an SQL chun an imirce a dhíchur i bhfeidhm. De réir réamhshocraithe, is é an SQL a cruthaíodh chun an imirce a reáchtáil sa treo ar aghaidh.

--database DATABASE

Sonraíonn sé an bunachar sonraí chun an SQL a ghiniúint. Réamhshocraithe go réamhshocraithe.

``sqlsequencereset ``

django-admin sqlsequencereset app_label [app_label ...]

Priontáil na ráitis SQL chun seicheamh a athshocrú d'ainmne/ainmneacha an aip ar leith.

Is innéacsanna iad seicheamh a úsáideann roinnt innill bunachar sonraí chun an chéad uimhir eile atá ar fáil a rianú do réimsí a fhásann

Úsáid an t-ordú seo chun SQL a ghiniúint a shocróidh cásanna ina bhfuil seicheamh as sioncronú lena sonraí réimse atá ag méadú go huathoibríoch.

--database DATABASE

Sonraíonn sé an bunachar sonraí chun an SQL a phriontáil. Réamhshocraithe go réamhshocraithe.

`Scuashimirce

django-admin squashmigrations app_label [start_migration_name] migration_name

Déanann an imirce le haghaidh app_label` suas go dtí migration_name san áireamh síos ina níos lú imirce, más féidir. Is féidir leis na himirce scáilte a eascraíonn as maireachtáil in éineacht leis na cinn neamh-scáilte Le haghaidh tuilleadh faisnéise, léigh: ref: migration-squashing.

Nuair a thugtar start_migration_name, ní chuimseoidh Django ach imirce ag tosú ón imirce seo agus lena n-áirítear. Cuidíonn sé seo leis an teorannú squasing de:class: ~django.db.migrations.operations.runpython agus:class: django.db.migrations.operations.runsql oibríochtaí imirce a mhaolú.

--no-optimize

Díchumasann sé an barrfheabhsaitheoir agus imirce scáite á ghiniúint. De réir réamhshocraithe, déanfaidh Django iarracht na hoibríochtaí i d'imirce a bharrfheabhsú chun méid an chomhaid mar thoradh air a laghdú. Úsáid an rogha seo má tá an próiseas seo ag teip nó ag cruthú imirce mícheart, cé go gcomhdaigh tuarascáil fabht Django faoin iompar le do thoil, mar tá sé i gceist go mbeadh optamú sábháilte.

--noinput, --no-input

Cuireann sé cosc ar gach leideanna úsáideora.

--squashed-name SQUASHED_NAME

Socraíonn sé ainm na himirce squashed. Nuair a fhágtar amach, tá an t-ainm bunaithe ar an gcéad imirce agus an imirce deireanach, agus _squashed_ eatarthu.

--no-header

Ginigh comhad imirce squashed gan leagan Django agus ceannteideal stampa ama.

Startapp

django-admin startapp name [directory]

Cruthaíonn struchtúr eolaire aip Django don ainm aip ar leith san eolaire reatha nó sa cheann scríbe ar leith.

De réir réamhshocraithe, :source: tá comhad <django/conf/app_template> `models.py agus comhaid teimpléad aip eile sa stiúrthóir nua'. Mura dtugtar ach ainm an aip, cruthófar eolaire an aip san eolaire oibre reatha.

If the optional destination is provided, Django will use that name instead. If the directory with the given name doesn't exist, it will be created. You can use '.' to denote the current working directory.

Mar shampla:

Shell
django-admin startapp myapp /Users/jezdez/Code/myapp
--template TEMPLATE

Soláthraíonn sé an cosán chuig eolaire le comhad teimpléad aip saincheaptha, nó cosán chuig cartlann neamhbhrúite (.tar`) nó cartlann comhbhrúite (.tar.gz`, .tar.bz2`, .tar.xz`, .tar.lzma, .tgz`, .tbz`tx, .tbz` z``, .tlz`, .zip`) ina bhfuil na comhaid teimpléad aip.

Mar shampla, cuardódh sé seo teimpléad aip san eolaire tugtha agus an aip myapp` á chruthú:

Shell
django-admin startapp --template=/Users/jezdez/Code/my_app_template myapp

Glacfaidh Django le URLanna freisin (http, https`, ftp`) chuig cartlanna comhbhrúite leis na comhaid teimpléad aip, agus iad a íoslódáil agus a bhaint ar an eitilt.

Mar shampla, ag baint leasa as ghné GitHub chun stórais a nochtadh mar chomhaid zip, is féidir leat URL a úsáid mar:

Shell
django-admin startapp --template=https://github.com/githubuser/django-app-template/archive/main.zip myapp
--extension EXTENSIONS, -e EXTENSIONS

Sonraíonn sé na síntí comhaid sa teimpléad aip ba chóir a léiriú leis an inneall teimpléid. Réamhshocraithe go py.

--name FILES, -n FILES

Sonraíonn sé cé na comhaid i dteimpléad an aip (i dteannta na comhaid sin a mheaitseálann “- síneadh”) ba chóir a léiriú leis an inneall teimpléid. Réamhshocraithe ar liosta folamh.

--exclude DIRECTORIES, -x DIRECTORIES

Sonraíonn sé cé na heolairí sa teimpléad aip ba chóir a eisiamh, i dteannta le .git agus __pycache__. Mura gcuirtear an rogha seo ar fáil, cuirfear eolairí darb ainm __pycache__ nó ag tosú le . eisiata.

The template context (see Context) used for all matching files is:

  • Aon rogha a chuirtear chuig an ordú startapp (i measc roghanna tacaithe ón ordú)

  • app_name - ainm an aip mar a chuirtear chuig an ordú

  • app_directory - cosán iomlán an aip nua-chruthaithe

  • camel_case_app_name - ainm an aip i bhformáid cáis camel

  • docs_version - leagan na doiciméadaithe: 'dev' nó `1.x'

  • django_version - leagan de Django, m.sh. `'2.0.3'

tionscadal tosaithe

django-admin startproject name [directory]

Cruthaíonn struchtúr eolaire tionscadail Django don ainm tionscadail ar leith san eolaire reatha nó sa cheann scríbe ar leith.

De réir réamhshocraithe, :source: tá <django/conf/project_template> manage.py` agus pacáiste tionscadail (ina bhfuil settings.py` agus comhaid eile) sa stiúrthóir nua.

Mura dtugtar ach ainm an tionscadail, ainmneofar <projectname>```eolaire an tionscadail agus an pacáiste tionscadail araon agus cruthófar eolaire an tionscadail san eolaire oibre reatha.

If the optional destination is provided, Django will use that name as the project directory, and create manage.py and the project package within it. If the directory with the given name doesn't exist, it will be created. Use '.' to denote the current working directory.

Mar shampla:

Shell
django-admin startproject myproject /Users/jezdez/Code/myproject_repo
--template TEMPLATE

Specifies a directory, file path, or URL of a custom project template. See the startapp --template documentation for examples and usage. The same security considerations described for startapp templates apply here: malicious or poorly constructed templates may introduce weaknesses or consume excessive resources, and templates should be carefully inspected before use.

--extension EXTENSIONS, -e EXTENSIONS

Sonraíonn sé na síntí comhaid i dteimpléad an tionscadail ba chóir a léiriú leis an inneall teimplé Réamhshocraithe go py.

--name FILES, -n FILES

Sonraíonn sé na comhaid i dteimpléad an tionscadail (i dteannta na comhaid sin a mheaitseálann --extension) ba chóir a léiriú leis an inneall teimpléid. Réamhshocraithe ar liosta folamh.

--exclude DIRECTORIES, -x DIRECTORIES

Sonraíonn sé na heolairí sa teimpléad tionscadail ba chóir a eisiamh, chomh maith le .git agus __pycache__. Mura gcuirtear an rogha seo ar fáil, cuirfear eolairí darb ainm __pycache__ nó ag tosú le . eisiata.

The template context (see Context) used is:

  • Aon rogha a chuirtear chuig an ordú startproject (i measc roghanna tacaithe ag an ordú)

  • project_name - ainm an tionscadail mar a chuirtear chuig an ordú

  • project_directory -- cosán iomlán an tionscadail nua-chruthaithe

  • secret_key - eochair randamach don socrú: setting: SECRET_KEY

  • docs_version - leagan na doiciméadaithe: 'dev' nó `1.x'

  • django_version - leagan de Django, m.sh. `'2.0.3'

Féach freisin: ref: rabhadh rindreála `agus:ref: `rabhadh c <render_warning>ód iontaofa mar a luaitear le haghaidh: djadmin: startapp <trusted_code_warning>.

tástála

django-admin test [test_label [test_label ...]]

Ritheann sé tástálacha do gach aip suiteáilte. Féach: doc: `/topics/tástáil/innéacs `le haghaidh tuilleadh faisnéise.

--failfast

Stopann tástálacha a reáchtáil agus tuairiscíonn sé an teip díreach tar éis teip

--testrunner TESTRUNNER

Rialaíonn sé an rang rith tástála a úsáidtear chun tástálacha a fhorghníomhú Sáraíonn an luach seo an luach a sholáthraíonn an socrú: setting: TEST_RUNNER.

--noinput, --no-input

Cuireann sé cosc ar gach leideanna úsáideora. Is é pras tipiciúil rabhadh faoi bhunachar sonraí tástála atá ann cheana a scriosadh.

Tástáil roghanna rudaí

Faigheann an t-ordú tástála roghanna thar ceann an rogha sonraithe:rogha: --testrunner. Seo iad na roghanna an rádálaí tástála réamhshocraithe: :class: ~django.test.runner.DiscoverRunner.

--keepdb

Caomhníonn sé bunachar sonraí tástála idir rith tástála. Tá an buntáiste aige seo na gníomhartha a chruthú agus a scriosadh a scipeáil ar féidir leo an t-am chun tástálacha a reáchtáil a laghdú go mór, go háirithe iad siúd i sraith tástála mór Mura bhfuil an bunachar sonraí tástála ann, cruthófar é ar an gcéad rith agus ansin caomhnófar é do gach rith ina dhiaidh sin. Mura bhfuil an socrú tástála: MIGRATE <TEST_MIGRATE>``False`, cuirfear aon imirce neamhfheidhmeacha i bhfeidhm ar bhunachar sonraí na tástála freisin sula rith an tsraith tástála.

--shuffle [SEED]

Déanann sé ord na dtástálacha a randamach sula ndéantar iad a rith. Is féidir leis seo cabhrú le tástálacha nach bhfuil scoite i gceart a bhrath. Is feidhm chinnitheach den síol sláireach a thugtar an t-ordú tástála a ghineann an rogha seo. Nuair nach ndéantar aon síol a rith, roghnaítear síol go randamach agus é a phriontáil chuig an gconsól. Chun ordú tástála áirithe a athdhéanamh, pas síol. <order-of-tests>Coinníonn na horduithe tástála a ghineann an rogha seo Django's:ref: `ráthaíochtaí ar ordú tástála `. Coinníonn siad tástálacha grúpáilte de réir aicme cásanna tástála freisin

Tá maoin comhsheasmhachta speisialta ag na horduithe cumhdaithe atá úsáideach agus saincheisteanna aonair a chúngú. Eadhon, i gcás síol ar leith agus nuair a bhíonn fo-thacar tástálacha á reáchtáil, is é an t-ordú nua an t-ordú bunaidh atá teoranta don tacar níos lú. Ar an gcaoi chéanna, agus tástálacha á chur leis agus an síol á choinneáil mar an gcéanna, beidh ord na dtástálacha bunaidh mar an gcéanna san ord nua.

--reverse, -r

Déanann cásanna tástála a shórtáil san ord forghníomhaithe D'fhéadfadh sé seo cabhrú le fo-iarsmaí tástálacha nach bhfuil scoite i gceart a dhífhabhtú. :ref: Caomhnaítear Grúpáil de réir aicme tástá <order-of-tests>la nuair a úsáidtear an rogha seo. Is féidir é seo a úsáid i gcomhar le --shuffle chun an t-ordú do shíol áirithe a aisiompú.

--debug-mode

Socraíonn an socrú: socrú: DEBUG go True sula ndéantar tástálacha a reáchtáil. D'fhéadfadh sé seo cabhrú le teipeanna tástála a réiteach

--debug-sql, -d

<django-db-logger>Cumasaí:ref: Logáil SQL `le haghaidh tástálacha a theip. Más é ``--verbosity`` 2, ansin aschur ceisteanna i dtástálacha pas freisin.

--parallel [N]
DJANGO_TEST_PROCESSES

Ritheann sé tástálacha i bpróisis chomhthreomhara Ós rud é go bhfuil croí iomadúla ag próiseálaithe nua-aimseartha, ceadaíonn sé seo tástálacha

Using --parallel without a value, or with the value auto, runs one test process per core according to multiprocessing.cpu_count(). You can override this by passing the desired number of processes, e.g. --parallel 4, or by setting the DJANGO_TEST_PROCESSES environment variable.

Dáileann Django cásanna tástála -: class: UnitTest.TestCase fo-aicmí - chuig fo-phróisis. Má tá níos lú ranganna cásanna tástála ann ná próisis chumraithe, laghdóidh Django líon na bpróisis dá réir.

Faigheann gach próiseas a bhunachar sonraí féin. Ní mór duit a chinntiú nach bhfuil rochtain ag ranganna cásanna tástála éagsúla ar na hacmhainní céanna Mar shampla, ba cheart d'aicmí cásanna tástála a théann i dteagmháil leis an gcóras comhaid eolaire sealadach a chruthú lena n-úsáid féin.

Éilíonn an rogha seo an pacáiste tblib tríú páirtí chun rianais a thaispeáint i gceart:

Shell
$ python -m pip install tblib

Níl an ghné seo ar fáil ar Windows. Ní oibríonn sé le cúltaca bunachar sonraí Oracle ach an oiread.

Más mian leat: mod: pdb a úsáid agus tú ag dífhabhtú tástálacha, ní mór duit forghníomhú comhthreomhar a dhíchumasú (--parallel=1). Feicfidh tú rud éigin cosúil le ``bdb.bdbQuit ``mura ndéanann tú.

--tag TAGS

<topics-tagging-tests>Ní ritheann sé ach tástálacha: ref: marcáilte leis na clibeanna sonraithe `. Is féidir é a shonrú arís agus arís eile agus é a chomhcheangal le: rogha: `test --exclude-tag.

Meastar go bhfuil tástálacha nach dteipfidh orthu a luchtú a mheaitseáil

--exclude-tag EXCLUDE_TAGS

<topics-tagging-tests>Ní áirítear tástálacha: ref: marcáilte leis na clibeanna sonraithe `. Is féidir é a shonrú arís agus arís eile agus é a chomhcheangal le: rogha: `test --tag.

-k TEST_NAME_PATTERNS

<unittest.-k>Ritheann sé modhanna tástála agus ranganna a mheaitseálann patrúin ainmneacha tástála, ar an mbealach céanna le: rogha: `rogha -k unittest `. Is féidir é a shonrú arís agus arís eile.

--pdb

Cruthaíonn dífhabhtaitheoir pdb` ag gach earráid tástála nó teip. Má tá sé suiteáilte agat, úsáidtear ipdb ina ionad.

--buffer, -b

<unittest.-b>Scaoileann sé aschur (stdout agus stderr) chun tástálacha a rith, ar an mbealach céanna se:option: `unittest's --buffer rogha `.

--no-faulthandler

Django automatically calls faulthandler.enable() when starting the tests, which allows it to print a traceback if the interpreter crashes. Pass --no-faulthandler to disable this behavior.

--timing

Uaireanta aschuir, lena n-áirítear socrú bunachar sonraí agus am reatha iomlán.

--durations N

Taispeánann sé na cásanna tástála N is moille (N = 0 do gach duine).

freastalaí tástála

django-admin testserver [fixture [fixture ...]]

Ritheann sé freastalaí forbartha Django (mar atá in:djadmin: runserver) ag baint úsáide as sonraí ón daingneán (í) ar leith.

Mar shampla, an t-ordú seo:

Shell
django-admin testserver mydata.json

... déanfadh na céimeanna seo a leanas:

  1. Cruthaigh bunachar sonraí tástála, mar a thuairiscítear in:ref: the-test-database.

  2. Déan an bunachar sonraí tástála a líonadh le sonraí daingneáin ó na daingneáin ar leith. (Le haghaidh tuilleadh faoi daingneáin, féach an doiciméadú le haghaidh: djadmin: loaddata thuas.)

  3. Ritheann sé an freastalaí forbartha Django (mar atá in:djadmin: runserver), dírithe ar an mbunachar sonraí tástála nua-chruthaithe seo in ionad do bhunachar sonraí táirgeachta.

Tá sé seo úsáideach ar roinnt bealaí:

  • Nuair a bhíonn tú ag scríobh: doc: tástálacha aonaid ar an gcaoi a ngníomhaíonn do thuairimí le sonraí daing</topics/testing/overview> neáin áirithe, is féidir leat testserver a úsáid chun idirghníomhú leis na tuairimí i mbrabhsálaí gréasáin, de láimh.

  • Let's say you're developing your Django application and have a "pristine" copy of a database that you'd like to interact with. You can dump your database to a fixture (using the dumpdata command, explained above), then use testserver to run your web application with that data. With this arrangement, you have the flexibility of messing up your data in any way, knowing that whatever data changes you're making are only being made to a test database.

Tabhair faoi deara go bhraitheann an freastalaí seo* athruithe ar do chód foinse Python go huathoibríoch (mar: djadmin: déanann runserver). Braitheann sé athruithe ar theimpléid, áfach.

--addrport ADDRPORT

Sonraíonn calafort difriúil, nó seoladh IP agus calafort, ó réamhshocrú ``127.0.0. 1:8000 ``. Leanann an luach seo an fhormáid chéanna go díreach agus freastalaíonn sé go díreach an fheidhm chéanna leis an argóint leis an ordú:djadmin: runserver.

Samplaí:

Chun an freastalaí tástála a reáchtáil ar chalafort 7000 le fixture1 agus fixture2`:

Shell
django-admin testserver --addrport 7000 fixture1 fixture2
django-admin testserver fixture1 fixture2 --addrport 7000

(Tá na ráitis thuas coibhéiseach. Cuirimid an dá cheann acu san áireamh chun a thaispeáint nach bhfuil sé cuma an dtagann na roghanna roimh nó tar éis na hargóintí daingneáin.)

Chun rith ar 1.2.3. 4:7000 le daingneán ``tástála`:

Shell
django-admin testserver --addrport 1.2.3.4:7000 test
--noinput, --no-input

Cuireann sé cosc ar gach leideanna úsáideora. Is é pras tipiciúil rabhadh faoi bhunachar sonraí tástála atá ann cheana a scriosadh.

Orduithe a sholáthraíonn iarratais

</howto/custom-management-commands> <INSTALLED_APPS>Níl roinnt orduithe ar fáil ach amháin nuair a bhíonn an feidhmchlár django.contrib ara:doc: `cur i bhfeidhm 'iad: socrú: `cumasaithe `. Déanann an chuid seo cur síos orthu atá grúpáilte de réir a bhfeidh

django.contrib.auth

athraitheaspassword

django-admin changepassword [<username>]

Níl an t-ordú seo ar fáil ach amháin má tá Django's:doc: córas fíordheimhniúcháin (django.contrib.auth) suiteáilte. </topics/auth/index>

Ceadaíonn sé pasfhocal úsáideora a athrú. Spreagann sé duit pasfhocal nua a iontráil faoi dhó don úsáideoir ar leith. Má tá na hiontrálacha comhionann, is é seo an pasfhocal nua láithreach. Mura soláthraíonn tú úsáideoir, déanfaidh an t-ordú iarracht an pasfhocal a mheaitseálann a n-ainm úsáideora leis an úsáideoir reatha a athrú.

--database DATABASE

Sonraíonn sé an bunachar sonraí le fiosrú don úsáideoir. Réamhshocraithe go réamhshocraithe.

Úsáid sampla:

Shell
django-admin changepassword ringo

createsuperuser

django-admin createsuperuser
DJANGO_SUPERUSER_PASSWORD

Níl an t-ordú seo ar fáil ach amháin má tá Django's:doc: córas fíordheimhniúcháin (django.contrib.auth) suiteáilte. </topics/auth/index>

Cruthaíonn sé cuntas superuser (úsáideoir a bhfuil gach cead aige). Tá sé seo úsáideach más gá duit cuntas sárúsáideora tosaigh a chruthú nó más gá duit cuntais sárúsáideora a ghiniúint go cláraitheach do do shuíomh (í).

Nuair a bheidh sé á reáchtáil go hidirghníomhach, spreagfaidh an t-ordú seo pasfhocal don chuntas sárúsáideora nua. Nuair a reáchtáiltear go neamh-idirghníomhach, is féidir leat pasfhocal a sholáthar tríd an athróg comhshaoil: envvar: DJANGO_SUPERUSER_PASSWORD a shocrú. Seachas sin, ní shocrófar aon phasfhocal, agus ní bheidh an cuntas superuser in ann logáil isteach go dtí go socraítear pasfhocal de láimh dó.

<uppercase_field_name>I mód neamh-idirghníomhach, tagann na:attr: ~django.contrib.auth.models.customUser.username_field agus réimsí riachtanacha (liostaithe in:attr: ~django.contrib.auth.models.customUser.required_fields) ar ais chuig athróga comhshaoil DJANGO_SUPERUSER_ `, mura gcuirtear athróg ordaithe orthu. Mar shampla, chun réimse ríomhphost a sholáthar, is féidir leat athróg comhshaoil DJANGO_SUPERUSER_EMAIL a úsáid.

--noinput, --no-input

Cuireann sé cosc ar gach leideanna úsáideora. Mura féidir pras faoi chois a réiteach go huathoibríoch, imeoidh an t-ordú le cód earráide 1.

--username USERNAME
--email EMAIL

Is féidir an t-ainm úsáideora agus an seoladh ríomhphoist don chuntas nua a sholáthar trí na hargóintí --username agus --email ``a úsáid ar an líne ordaithe. Mura gcuirtear ceachtar acu sin ar fáil, spreagfaidh ``createsuperuser dó agus é ag rith idirghníomhach.

--database DATABASE

Sonraíonn sé an bunachar sonraí ina sábhálfar an réad superuser.

Is féidir leat an t-ordú bainistíochta a fho-aicmiú agus get_input_data () `a shárú más mian leat ionchur agus bailíochtú sonraí a shaincheapadh. Téigh i gcomhairle leis an gcód foinse le haghaidh sonraí ar an gcur chun feidhme atá ann cheana agus paraiméadair Mar shampla, d'fhéadfadh sé a bheith úsáideach má tá ``ForeignKey agat in:attr: ~django.contrib.auth.models.customUser.required_fields agus gur mhaith leat sampla a chruthú in ionad eochair phríomh-eochair an chás atá ann cheana a iontráil.

django.contrib.contenttypes

````cineálacha ábhar a bhaint ``

django-admin remove_stale_contenttypes

Níl an t-ordú seo ar fáil ach amháin má tá django's:doc: contenttypes app (:mod: django.contrib.contenttypes </ref/contrib/contenttypes>) suiteáilte.

Scriosann sé cineálacha ábhair bhasa (ó mhúnlaí scriosta) i do bhunachar sonraí. Scriosfar aon rudaí atá ag brath ar na cineálacha ábhair scriosta freisin. Taispeánfar liosta de na rudaí scriosta sula ndeimhníonn tú go bhfuil sé ceart go leor dul ar aghaidh leis an scriosadh.

--database DATABASE

Sonraíonn sé an bunachar sonraí atá le húsáid. Réamhshocraithe go réamhshocraithe.

--include-stale-apps

Scriosann sé cineálacha ábhar seasta lena n-áirítear cinn ó aipeanna atá suiteáilte roimhe seo a baineadh ó:setting: INSTALLED_APPS. Réamhshocraithe go False.

django.contrib.gis

ogrinspect

Níl an t-ordú seo ar fáil ach amháin má tá: doc: GeodJango (django.contrib.gis </ref/contrib/gis/index>) suiteáilte.

Féach le do thoil dá: djadmin: `cur síos <ogrinspect>`sa doiciméadú GeodJango.

django.contrib.sesions

``seisiúin ghlanadh ``

django-admin clearsessions

Is féidir é a reáchtáil mar phost cron nó go díreach chun seisiúin atá in éag a ghlanadh.

``django.contrib.staticfiles ``

Collectstatic

Níl an t-ordú seo ar fáil ach amháin má tá an: doc: feidhmchlár comhaid stataich (django.contrib.staticfiles) suiteáil</howto/static-files/index> te.

Féach dá: djadmin: cur síos `sa doiciméad:doc: `staticfiles</ref/contrib/staticfiles><collectstatic> le do thoil.

findstatic

Níl an t-ordú seo ar fáil ach amháin má tá an: doc: feidhmchlár comhaid stataich (django.contrib.staticfiles) suiteáil</howto/static-files/index> te.

Féach dá: djadmin: cur síos `sa doiciméad:doc: `staticfiles</ref/contrib/staticfiles><findstatic> le do thoil.

Roghanna réamhshocrai

Cé go bhféadfadh roinnt orduithe a roghanna saincheaptha féin a cheadú, ceadaíonn gach ordú na roghanna seo a leanas de réir réamh

--pythonpath PYTHONPATH

Adds the given filesystem path to the Python sys.path module attribute. If this isn't provided, django-admin will use the PYTHONPATH environment variable.

Níl an rogha seo gan ghá i manage.py`, toisc go dtugann sé aire do chonair Python a shocrú duit.

Úsáid sampla:

Shell
django-admin migrate --pythonpath='/home/djangoprojects/myproject'
--settings SETTINGS

Sonraíonn sé an modúl socruithe le húsáid. Ba chóir go mbeadh an modúl socruithe i gcomhréir pacáiste Python, m.sh. mysite.settings. Mura gcuirtear é seo ar fáil, úsáidfidh django-admin an athróg comhshaoil: envvar: DJANGO_SETTINGS_MODULE.

Níl an rogha seo gan ghá i manage.py`, toisc go n-úsáideann sé settings.py ón tionscadal reatha de réir réamhshocraithe.

Úsáid sampla:

Shell
django-admin migrate --settings=mysite.settings
--traceback

Taispeánann sé rian iomlán cruach nuair a ardaítear a:exc: ~Django.Core.Management.CommandError. De réir réamhshocraithe, taispeánfaidh django-admin teachtaireacht earráide nuair a tharlaíonn CommandError agus rian iomlán cruach d'aon eisceacht eile.

Déanann neamhaird ar an rogha seo ag: djadmin: runserver.

Úsáid sampla:

Shell
django-admin migrate --traceback
--verbosity {0,1,2,3}, -v {0,1,2,3}

Sonraíonn sé méid na faisnéise fógra agus dífhabhtaithe ba chóir d'ordú a phriontáil chuig an gconsól.

  • Ciallaíonn 0 gan aon aschur.

  • Ciallaíonn 1 gnáthaschur (réamhshocraithe).

  • Ciallaíonn 2 aschur fhearbhóiseach.

  • Ciallaíonn `3 aschur fíor* mór*.

Déanann neamhaird ar an rogha seo ag: djadmin: runserver.

Úsáid sampla:

Shell
django-admin migrate --verbosity 2
--no-color

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.

Úsáid sampla:

Shell
django-admin runserver --no-color
--force-color

Déanann sé dathú an aschur ordaithe dá ndéanfaí é a dhíchumasú ar shlí eile mar a pléadh in:ref: syntax-coloring. Mar shampla, b'fhéidir gur mhaith leat aschur daite a phíobáil chuig ordú eile.

--skip-checks

Scaipeann sé seiceálacha córais a reáchtáil sula rith an t-ordú. Níl an rogha seo ar fáil ach mura bhfuil an tréith ordaithe: attr: ~django.core.management.baseCommand.requires_System_Checks ina liosta folamh nó tuple.

Úsáid sampla:

Shell
django-admin migrate --skip-checks

Naiseachtaí breise

Dathú comhréireachta

DJANGO_COLORS

Úsáidfidh na horduithe django-admin/manage.py` aschur dathchódaithe deas má thacaíonn do chríochfort le aschur daite ANSI. Ní úsáidfidh sé na cóid datha má tá tú ag píobáil aschur an ordaithe chuig clár eile mura n-úsáidtear an rogha: --force-color.

Tacaíocht Windows

Ar Windows 10, ceadaíonn feidhmchlár Windows Terminal, `VS Code `_, agus PowerShell (áit a bhfuil próiseáil críochfoirt fíorúil cumasaithe) aschur daite, agus tacaíonn siad de réir réamhshocraithe.

Faoi Windows, ní thacaíonn an consól dúchasach oidhreachta cmd.exe` le seicheamh éalaithe ANSI mar sin de réir réamhshocraithe níl aon aschur datha ann. Sa chás seo tá gá le ceachtar de dhá leabharlann tríú páirtí:

  • Install: pypi: colorama, pacáiste Python a aistríonn cóid dathanna ANSI go glaonna API Windows. Braithfidh orduithe Django a láithreacht agus bainfidh siad úsáid as a sheirbhísí chun aschur a dhathú díreach mar atá ar ardáin bunaithe ar Unix-bhunaithe. Is féidir ``colorama ``a shuiteáil trí phíopa:

    Windows
    ...\> py -m pip install "colorama >= 0.4.6"

  • Suiteáil ANSICON, uirlis tríú páirtí a ligeann cmd.exe cóid dathanna ANSI a phróiseáil. Braithfidh orduithe Django a láithreacht agus bainfidh siad úsáid as a sheirbhísí chun aschur a dhathú díreach mar atá ar ardáin bunaithe ar Unix-bhunaithe.

Féadfaidh timpeallachtaí críochfoirt nua-aimseartha eile ar Windows, a thacaíonn le dathanna teirminéil, ach nach bhraitear go huathoibríoch mar a thacaíonn Django, suiteáil ANSICON a “bréagadh” tríd an athróg comhshaoil iomchuí a shocrú, ANSICON="on"`.

Dathanna saincheaptha

Is féidir na dathanna a úsáidtear le haghaidh aibhsiú comhréireachta a shain Longa Django le trí phailéid dathanna:

  • dorch, oiriúnach do theirminéil a thaispeánann téacs bán ar chúlra dubh. Is é seo an pailéad réamhshocraithe.

  • ``solas`, oiriúnach do theirminéil a thaispeánann téacs dubh ar chúlra bán.

  • nocolor, a dhíchumasaíonn aibhsiú comhréireachta.

Roghnaíonn tú pailéad trí athróg comhshaoil a: envvar: DJANGO_COLORS a shocrú chun an pailéad is mian leat a úsáid a shonrú. Mar shampla, chun an pailéad ``sola` a shonrú faoi bhlaosc Unix nó OS/X BASH, rith tú an méid seo a leanas ag pras ordaithe:

Shell
export DJANGO_COLORS="light"

Is féidir leat na dathanna a úsáidtear a shaincheapadh freisin. Sonraíonn Django roinnt róil ina n-úsáidtear dath:

  • ``earráid ``- Earráid mhór.

  • fógra - Earráid bheag.

  • ``rath ``- Rath.

  • ``rabhadh ``- Rabhadh.

  • sql_field - Ainm réimse samhail i SQL.

  • sql_coltype - An cineál réimse samhail i SQL.

  • ``sql_keywords ``- Eochairfhocal SQL.

  • sql_table - Ainm samhail i SQL.

  • http_info - Freagra freastalaí faisnéise 1XX HTTP.

  • http_success - Freagra freastalaí rathúlachta 2XX HTTP.

  • http_not_modified - Freagra freastalaí 304 HTTP Gan Athraithe.

  • http_redirect - Freagra freastalaí atreoraithe HTTP 3XX seachas 304.

  • http_not_found - Freagra freastalaí 404 HTTP Gan aimsiú.

  • http_bad_request - Freagra freastalaí Droch-Iarratas HTTP 4XX seachas 404.

  • http_server_error - Freagra Earráid Freastalaí HTTP 5XX.

  • migrate_heading - Ceannteideal i ordú bainistíochta imirce.

  • migrate_label - Ainm imirce.

Is féidir tosaigh agus dath cúlra ar leith a shannadh do gach ceann de na róil seo, ón liosta seo a leanas:

  • Dub

  • ``dearg ``

  • ``glas ``

  • `buí

  • gorm

  • magenta

  • cyan

  • `bán

Is féidir gach ceann de na dathanna seo a athrú ansin trí na roghanna taispeána seo a leanas a úsáid:

  • `bold

  • Unscór

  • blink

  • `aisiom

  • ceilitheach

Leanann sonraíocht datha ceann de na patrúin seo a leanas:

  • ról = fg

  • ról = fg/bg

  • ``role = fg, rogha, rogha ``

  • ``role = fg/bg, rogha, rogha ``

áit is é ról bailí datha ``, 'ról', is é fg` an dath tosaigh, bg an dath cúlra agus tá gach ``rogha ``ar cheann de na roghanna modhnaithe dathanna. Déantar sonraíochtaí dathanna iolracha scartha ansin le leath-icolón. Mar shampla:

Shell
export DJANGO_COLORS="error=yellow/blue,blink;notice=magenta"

sonródh sé go dtaispeánfaí earráidí ag baint úsáide as buí bliantach ar gorm, agus fógraí a thaispeántar ag úsáid magenta D'fhágfaí gach ról datha eile gan daite.

Is féidir dathanna a shonrú freisin trí phailéad bonn a leathnú. Má chuireann tú ainm pailéad i sonraíocht dathanna, luchtálfar na dathanna go léir a thugann an pailéad sin. Mar sin:

Shell
export DJANGO_COLORS="light;error=yellow/blue,blink;notice=magenta"

sonródh sé úsáid na dathanna go léir sa phailéad dathanna éadrom, * seachas na dathanna le haghaidh earráidí agus fógraí a shárófaí mar a shonraítear.

Críochnú Bash

Má úsáideann tú an bhlaosc Bash, smaoinigh ar script críochnaithe Django bash a shuiteáil, a chónaíonn in:source: extras/django_bash_completion sa dáileadh foinse Django. Cumasaíonn sé orduithe django-admin ``agus `manage.py a chríochnú cluaisíní, ionas gur féidir leat, mar shampla...

  • Cineál ``django-admin ``.

  • Brúigh [TAB] chun gach rogha atá ar fáil a fheiceáil.

  • Clóscríobh sql, ansin [TAB], chun na roghanna go léir atá ar fáil a dtosaíonn a n-ainmneacha le sql` a fheiceáil.

Féach: doc: `/conas/saincheapach-bhainistí-orduithe `maidir le conas gníomhartha saincheaptha a chur leis.

Formáidiú dubh

Déantar na comhaid Python a chruthaí:djadmin: startproject, :djadmin: startapp, :djadmin: optimemigration, :djadmin: makemigrations, agus:djadmin: squashmigrations a fhormáidiú ag baint úsáide as an ordú black má tá sé i láthair ar do PATH`.

Má tá dub suiteáilte go domhanda agat, ach mura dteastaíonn uait go n-úsáidtear é don tionscadal reatha, is féidir leat an PATH` a shocrú go sainráite:

Shell
PATH=path/to/venv/bin django-admin makemigrations

Le haghaidh orduithe a úsáideann stdout is féidir leat an t-aschur a phíobáil chuig dub más gá:

Shell
django-admin inspectdb | black -

Orduithe bainistíochta a rith ó do chód

django.core.management.call_command(name, *args, **options)

Chun ordú bainistíochta a ghlaoch ón gcód bain úsáid as ``call_command () ``.

``ainm `

ainm an ordaithe le glaoch nó réad ordaithe. Is fearr an t-ainm a rith mura bhfuil an réad ag teastáil le haghaidh tástála.

*args

liosta de na hargóintí a nglacann an t-ordú leo. Cuirtear argóintí chuig an parser argóint, ionas gur féidir leat an stíl chéanna a úsáid agus a dhéanfá ar an líne ordaithe. Mar shampla, ``call_command ('flush', '--verbosity=0') ``.

``**roghanna ``

roghanna ainmnithe a nglactar leo ar an líne ordaithe. Cuirtear roghanna chuig an ordú gan an parser argóint a spreagadh, rud a chiallaíonn go mbeidh ort an cineál ceart a rith. Mar shampla, ``call_command ('flush', verbosity=0) ``(caithfidh nialas a bheith ina shláimhir seachas sreang).

Samplaí:

Code
from django.core import management
from django.core.management.commands import loaddata

management.call_command("flush", verbosity=0, interactive=False)
management.call_command("loaddata", "test_data", verbosity=0)
management.call_command(loaddata.Command(), "test_data", verbosity=0)

Tabhair faoi deara go ndéantar roghanna ordaithe nach nglacann aon argóintí a rith mar eochairfhocail le True nó False, mar a fheiceann tú leis an rogha ``idirghníomhach` thuas.

Is féidir argóintí ainmnithe a rith trí cheann de na sintáisí seo a leanas a úsáid:

Code
# Similar to the command line
management.call_command("dumpdata", "--natural-foreign")

# Named argument similar to the command line minus the initial dashes and
# with internal dashes replaced by underscores
management.call_command("dumpdata", natural_foreign=True)

# `use_natural_foreign_keys` is the option destination variable
management.call_command("dumpdata", use_natural_foreign_keys=True)

Tá ainmneacha difriúla ag roinnt roghanna ordaithe nuair a úsáidtear call_command () ``in ionad ``django-admin nó manage.py. Mar shampla, aistríonn django-admin createsuperuser --no-input go call_command ('createsuperuser', interactive=false) ``. Chun a fháil amach cén t-ainm argóint eochairfhocal atá le húsáid le haghaidh ``call_command () ``, seiceáil cód foinse an ordaithe don argóint ``dest a chuirtear chuig parser.add_argument ()`.

Cuirtear liosta ar roghanna ordaithe a thógann roghanna éagsúla:

Code
management.call_command("dumpdata", exclude=["contenttypes", "auth"])

Tá luach tuairisceáin na feidhme call_command () ``mar an gcéanna le luach tuairisceáin modh ``handle () den ordaithe.

Atreorú aschuir

Tabhair faoi deara gur féidir leat sruthanna caighdeánacha aschuir agus earráide a atreorú toisc go dtacaíonn gach ordú leis na roghanna stdout agus stderr. Mar shampla, d'fhéadfá scríobh:

Code
with open("/path/to/command_output", "w") as f:
    management.call_command("dumpdata", stdout=f)

This page as Markdown JSON

Edit this page on GitHub Official version