django-admin agus manage.pyLink to this heading#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.
\nIna 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.
Linux / macOS
$ django-admin <command> [options]\n$ manage.py <command> [options]\n$ python -m django <command> [options]\nWindows
...\\> django-admin <command> [options]\n...\\> manage.py <command> [options]\n...\\> py -m django <command> [options]\nBa 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.
Rith ``cabhair django-admin ``chun faisnéis úsáide agus liosta de na horduithe a sholáthraíonn gach feidhmchlár a thaispeáint.
\nRith 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.
\nTó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.
Rith ``leagan django-admin ``chun an leagan reatha Django a thaispeáint.
\nLeanann an t-aschur an scéim a thuairiscítear in:pep: 440:
\n1.4.dev17026\n1.4a1\n1.4\nÚ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.
\nÚ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.
\nDe 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í:
\ndjango-admin check auth admin myapp\n<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:
\ndjango-admin check --tag models --tag compatibility\nSonraíonn an bunachar sonraí chun seiceálacha a reáchtáil a éilíonn
\ndjango-admin check --database default --database other\nDe réir réamhshocraithe, ní reáchtálfar na seiceálacha seo.
\nLiostaíonn gach clib atá ar fáil.
\nGníomhachtaíonn sé roinnt seiceálacha breise nach bhfuil ábhartha ach i suíomh imscartha.
\nIs 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:
django-admin check --deploy --settings=production_settings\nNó 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ú.
\nSonraíonn sé an leibhéal teachtaireachta a chuirfidh ar an ordú imeacht le stádas neamh-nialas. Is é “ERROR” réamhshocraithe.
\nteachtaireachtaí tiomsaitheachLink to this heading#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.
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.
\nSonraíonn sé na háiteanna atá le eisiamh ó phróiseáil. Mura gcuirtear ar fáil, níl aon áiteanna áitiúla eisiata.
\nCuimsíonn sé aistriúcháin doiléirí i gcomhaid thiomsaithe.
\nÚsáid sampla:
\ndjango-admin compilemessages --locale=pt_BR\ndjango-admin compilemessages --locale=pt_BR --locale=fr -f\ndjango-admin compilemessages -l pt_BR\ndjango-admin compilemessages -l pt_BR -l fr --use-fuzzy\ndjango-admin compilemessages --exclude=pt_BR\ndjango-admin compilemessages --exclude=pt_BR --exclude=fr\ndjango-admin compilemessages -x pt_BR\ndjango-admin compilemessages -x pt_BR -x fr\nDé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
\nÚsáid sampla:
\ndjango-admin compilemessages --ignore=node_modules --ignore=outdated/*/locale\ncruthaitheachtabhaíLink to this heading#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.
\nSonraíonn sé an bunachar sonraí ina gcruthófar an tábla/na taisce. Réamhshocraithe go réamhshocraithe.
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.
\ndbshellLink to this heading#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.
\nMaidir 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.
Sonraíonn sé an bunachar sonraí chun blaosc a oscailt air. Réamhshocraithe go réamhshocraithe.
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
$ django-admin dbshell -- -c 'select current_user'\n current_user\n--------------\n postgres\n(1 row)\nWindows
...\\> django-admin dbshell -- -c 'select current_user'\n current_user\n--------------\n postgres\n(1 row)\nAr MySQL/MariaDB, is féidir leat é seo a dhéanamh le bratach -e an ordaithe mysql:
Linux / macOS
$ django-admin dbshell -- -e "select user()"\n+----------------------+\n| user() |\n+----------------------+\n| djangonaut@localhost |\n+----------------------+\nWindows
...\\> django-admin dbshell -- -e "select user()"\n+----------------------+\n| user() |\n+----------------------+\n| djangonaut@localhost |\n+----------------------+\nTaispeánann sé difríochtaí idir an comhad socruithe reatha agus socruithe réamhshocraithe Django (nó comhad socruithe eile a shonraítear ar:option: --default).
\nLeanann "###" 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.
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 "###".
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.
\nSonraí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.
DumpdataLink to this heading#Aschuir chuig aschur caighdeánach gach sonraí sa bhunachar sonraí a bhaineann leis an bhfeidhmchlár (í) ainmnithe.
\nMura gcuirtear aon ainm iarratais ar fáil, déanfar gach feidhmchlár suiteáilte a dumpáil.
\nIs féidir aschur ``dumpdata ``a úsáid mar ionchur le haghaidh: djadmin: loaddata.
\n<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.
\nÚsáideann bainisteoir bonn Django, taifid dumpála a d'fhéadfadh bainisteoir saincheaptha a scagadh nó a mhodhnú ar shlí eile.
\nSonraíonn sé formáid sraitheach an aschuir. Réamhshocraithe go JSON. Tá formáidí tacaithe liostaithe in:ref: serialization-formats.
\nSonraí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.
\nCuireann 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:
django-admin dumpdata --exclude=auth --exclude=contenttypes\nSonraíonn sé an bunachar sonraí as a ndéanfar sonraí a dumpáil. Réamhshocraithe go réamhshocraithe.
Ú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.
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.
\nNí 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.
\nSonraíonn sé comhad chun na sonraí sraitheacha a scríobh chuig. De réir réamhshocraithe, téann na sonraí chuig aschur caighdeánach.
\nNuair 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.
\nIs 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:
django-admin dumpdata -o mydata.json.gz\n`FlushLink to this heading#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.
\nMá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.
\nCuireann sé cosc ar gach leideanna úsáideora.
\nSonraíonn sé an bunachar sonraí le sruthú. Réamhshocraithe go réamhshocraithe.
InspectdbLink to this heading#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.
\nFé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.
\nÚ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.
\nAs you might expect, the created models will have an attribute for every field\nin the table. Note that inspectdb has a few special cases and limitations\nin 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\noutput.
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\noptions that have no database-level representation will not be included. In\nparticular, Field.default will not be included, and Python variants\nfor on_delete are always emitted as DO_NOTHING.
As such, after you run it, you'll want to look over the generated models\nyourself to make customizations. This feature is meant as a shortcut, not as\ndefinitive model generation.
\nDe 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).
Cruthaítear samhlacha le haghaidh tuairimí ábhartha má úsáidtear: rogha: --include-views.
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.
Sonraíonn sé an bunachar sonraí chun iontráil a dhéanamh. Réamhshocraithe go réamhshocraithe.
Má chuirtear an rogha seo ar fáil, cruthaítear samhlacha le haghaidh deighiltí freisin.
\nNí chuirtear ach tacaíocht do PostgreSQL i bhfeidhm.
\nMá chuirtear an rogha seo ar fáil, cruthaítear samhlacha freisin le haghaidh tuairimí bunachar sonraí.
\nLoaddataLink to this heading#<fixtures-explanation>Cuardaigh agus luchtú ábhar an ainmne:ref: `daingneáin `isteach sa bhunachar sonraí.
\nSonraíonn sé an bunachar sonraí ina luchtálfar na sonraí. Réamhshocraithe go réamhshocraithe.
Déanann sé neamhaird ar réimsí agus samhlacha a d'fhéadfadh a bheith bainte ó ghintear an daingneán ar dtús.
\nSonraíonn sé aip amháin chun daingneáin a lorg seachas breathnú i ngach aip.
\n<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.
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.
stdinLink to this heading#Is féidir leat doic a úsáid mar ainm an daingneáin chun ionchur a luchtú ó sys.stdin. Mar shampla:
\ndjango-admin loaddata --format=json -\n<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:
\ndjango-admin dumpdata --format=json --database=test app_label.ModelName | django-admin loaddata --format=json --database=prod -\nIs féidir an t-ordú: DJadmin: dumpdata a úsáid chun ionchur a ghiniúint do loaddata.
\n\nRitheann 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í.
\nNí 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.
\nNuashonraíonn sé na comhaid teachtaireachta do gach teanga atá ar fáil.
\nSonraíonn sé liosta síntí comhaid le scrúdú (réamhshocraithe: html, txt`, py` nó js ``ife:option: `--domain` is ``djangojs).
Úsáid sampla:
\ndjango-admin makemessages --locale=de --extension xhtml\nDéan síntí iolracha a scaradh le camóga nó bain úsáid as -e nó ``-- síneadh ``arís agus arís eile:
django-admin makemessages --locale=de --extension=html,txt --extension xml\nSonraíonn sé na háiteanna atá le próiseáil.
\nSonraíonn sé na háiteanna atá le eisiamh ó phróiseáil. Mura gcuirtear ar fáil, níl aon áiteanna áitiúla eisiata.
\nÚsáid sampla:
\ndjango-admin makemessages --locale=pt_BR\ndjango-admin makemessages --locale=pt_BR --locale=fr\ndjango-admin makemessages -l pt_BR\ndjango-admin makemessages -l pt_BR -l fr\ndjango-admin makemessages --exclude=pt_BR\ndjango-admin makemessages --exclude=pt_BR --exclude=fr\ndjango-admin makemessages -x pt_BR\ndjango-admin makemessages -x pt_BR -x fr\nSonraíonn fearann na gcomhaid teachtaireachtaí. Is iad na roghanna tacaithe:
\n\nLeanann sé naisc shiombailí chuig eolairí agus tú ag lorg teaghráin aistriú
\nÚsáid sampla:
\ndjango-admin makemessages --locale=de --symlinks\nDé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
\nÚsáidtear na patrúin seo de réir réamhshocraithe: 'CVS', `.*', `*~', '*.pyc'.
Úsáid sampla:
\ndjango-admin makemessages --locale=en_US --ignore=apps/* --ignore=secret/*.html\nDíchumasaíonn luachanna réamhshocraithe - ignore.
Díchumasaíonn sé línte teachtaireachta fada a bhriseadh i roinnt línte i gcomhaid
\nCuireann 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
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.
``riamh ``: cuirtear na línte faoi chois (mar an gcéanna le: rogha: --no-location).
Éilíonn gettext 0.19 nó níos nuaí.
Baineann teaghráin teachtaireachta atá as feidhm as na comhaid .po.
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éanaimirceachLink to this heading#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'.
\nAg 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).
\nChun imirce a chur le aip nach bhfuil eolaire migrations` aige, reáchtáil ``makemigrations le app_label` an aip.
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.
\nAisí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.
\nTaispeá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.
Cumasaíonn sé coinbhleachtaí imirce a shocrú
\nLigeann 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 `.
\nGinigh comhaid imirce gan leagan Django agus ceannteideal stampa ama.
\nDéanann sé imeacht makemigrations le stádas neamh-nialasach nuair a bhraitear athruithe samhail gan imirce. Tugann le tuiscint ``--dry-run `.
\nAtreoraíonn sé aschur log agus leideanna ionchuir chuig stderr, agus ní scríobhann ach cosáin de chomhaid imirce ginte chuig stdout.
Comhcheanglaíonn sé athruithe samhail san imirce is déanaí agus na hoibríochtaí atá mar thoradh air a
\nBeidh ainm ginte ag an imirce nuashonraithe. D'fhonn an t-ainm roimhe seo a chaomhnú, socraigh é ag baint úsáide as ``--ainm ``.
\n`imirceLink to this heading#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'.
\nAthraíonn iompar an ordaithe seo ag brath ar na hargóintí a chuirtear ar fáil:
\nGan 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.
Sonraíonn sé an bunachar sonraí le himirce. Réamhshocraithe go réamhshocraithe.
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í
\nTá 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.
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
\nTaispeánann sé na hoibríochtaí imirce a dhéanfar don ordú imirce a thugtar.
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.
\nCuireann sé cosc ar gach leideanna úsáideora. Is sampla pras is ea fiafraí faoi chineálacha ábhair seasta a bhaint.
\nDéanann sé imeacht imirce le stádas neamh-nialasach nuair a bhraitear imirce neamhfheidhmeacha.
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 barrfheabhsaitheLink to this heading#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.
Déanann sé “barrfheabhsú inimirce” imeacht le stádas neamh-nialasach nuair is féidir imirce a bharrfheabhsú.
\nRunserverLink to this heading#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.
\nMá 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).
\nÚsáideann an freastalaí seo réad feidhmchláir WSGI a shonraítear leis an socrú: setting: WSGI_APPLICATION.
\n\nAthluchtaí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.
\nMá 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.
\nTabhair 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.
\n</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.
\nSeoltar logáil ar gach iarratas agus freagra an fhreastalaí chuig an logger:ref: django-server-logger.
\nDí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.
\nDíchumasaíonn sé úsáid snáithe sa fhreastalaí forbartha. Tá an freastalaí ilshreathaithe de réir réamhshocraithe.
\nÚsáideann IPv6 don fhreastalaí forbartha. Athraíonn sé seo an seoladh IP réamhshocraithe ó 127.0.0.1 go : :1.
By default, a warning is printed to the console that runserver is not\nsuitable for production:
WARNING: This is a development server. Do not use it in a production setting. Use a production WSGI or ASGI server instead.\nFor more information on production servers see: https://docs.djangoproject.com/en/|version|/howto/deployment/\nSet this environment variable to "true" to hide this warning.
Port 8000 ar sheoladh IP ``127.0.0.1 ``:
\ndjango-admin runserver\nPort 8000 ar sheoladh IP ``1.2.3.4`:
\ndjango-admin runserver 1.2.3.4:8000\nPort 7000 ar sheoladh IP ``127.0.0.1 ``:
\ndjango-admin runserver 7000\nPort 7000 ar sheoladh IP 1.2.3.4:
django-admin runserver 1.2.3.4:7000\nPort 8000 ar sheoladh IPv6 :: 1:
django-admin runserver -6\nPort 7000 ar sheoladh IPv6 : :1:
django-admin runserver -6 7000\nPort 7000 ar sheoladh IPv6 2001:0 db 8:1234:5678: :9:
django-admin runserver [2001:0db8:1234:5678::9]:7000\nPort 8000 ar sheoladh IPv4 an óstach localhost:
django-admin runserver localhost:8000\nPort 8000 ar sheoladh IPv6 an óstach localhost:
django-admin runserver -6 localhost:8000\nDe 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 `.
\nSolá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.
sendtestemailLink to this heading#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:
\ndjango-admin sendtestemail foo@example.com bar@example.com\nThe following options may be used in any combination with each other and with\nrecipient email arguments.
\nSpecifies the MAILERS alias to use for sending the test email to\nthe recipients given as arguments. Defaults to the "default" mailer.
Mails the email addresses specified in MANAGERS using\nmail_managers().
Mails the email addresses specified in ADMINS using\nmail_admins().
sliogLink to this heading#Tosaíonn an ateangaire idirghníomhach Python.
\nAll models from installed apps are automatically imported into the shell\nenvironment. Models from apps listed earlier in INSTALLED_APPS take\nprecedence. The following common utilities are also imported:
from django.db import connection, reset_queries, models\nfrom django.conf import settings\nfrom django.utils import timezone\nFor a --verbosity of 2 or higher, the automatically imported objects will\nbe listed. To disable automatic importing entirely, use the --no-imports\nflag.
See the guide on customizing this behavior to add or remove automatic imports.
\n\nSonraí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:
\nIPython:
\ndjango-admin shell -i ipython\nbpython:
\ndjango-admin shell -i bpython\nMá 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:
\ndjango-admin shell -i python\nDí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.
Disables the automatic import of models from INSTALLED_APPS.
Ligeann duit ordú a rith mar shreang chun é a fhorghníomhú mar Django, mar sin:
\ndjango-admin shell --command="import django; print(django.__version__)"\nIs féidir leat cód a chur isteach ar ionchur caighdeánach chun é a fhorghníomhú. Mar shampla:
\n$ django-admin shell <<EOF\n> import django\n> print(django.__version__)\n> EOF\nAr Windows, tá an REPL aschur mar gheall ar theorainneacha cur chun feidhme de:func: select.select ar an ardán sin.
\nimirce taispeánaitheLink to this heading#Taispeánann an imirce go léir i dtionscadal. Is féidir leat a roghnú ó cheann de dhá fhormáid:
\nLiostaí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.
\nTaispeá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.
\nSonraíonn sé an bunachar sonraí le scrúdú. Réamhshocraithe go réamhshocraithe.
Priontáil na ráitis SQL a chuirfeadh i bhfeidhm don ordú:djadmin: flush.
\nSonraíonn sé an bunachar sonraí chun an SQL a phriontáil. Réamhshocraithe go réamhshocraithe.
sqlmigrateLink to this heading#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í.
\nTabhair faoi deara nach ndéanann sqlmigrate` dathú a aschur.
\nGineann 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.
\nSonraíonn sé an bunachar sonraí chun an SQL a ghiniúint. Réamhshocraithe go réamhshocraithe.
Priontáil na ráitis SQL chun seicheamh a athshocrú d'ainmne/ainmneacha an aip ar leith.
\nIs 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
\nÚ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.
\nSonraíonn sé an bunachar sonraí chun an SQL a phriontáil. Réamhshocraithe go réamhshocraithe.
`ScuashimirceLink to this heading#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ú.
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.
\nCuireann sé cosc ar gach leideanna úsáideora.
\nSocraí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.
Ginigh comhad imirce squashed gan leagan Django agus ceannteideal stampa ama.
\nStartappLink to this heading#Cruthaíonn struchtúr eolaire aip Django don ainm aip ar leith san eolaire reatha nó sa cheann scríbe ar leith.
\nDe 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.
\nIf the optional destination is provided, Django will use that name instead. If\nthe directory with the given name doesn't exist, it will be created. You can\nuse '.' to denote the current working directory.
\n\nMar shampla:
\ndjango-admin startapp myapp /Users/jezdez/Code/myapp\nSolá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.
\nMar shampla, cuardódh sé seo teimpléad aip san eolaire tugtha agus an aip myapp` á chruthú:
\ndjango-admin startapp --template=/Users/jezdez/Code/my_app_template myapp\nGlacfaidh 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:
\ndjango-admin startapp --template=https://github.com/githubuser/django-app-template/archive/main.zip myapp\nSonraí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.
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.
\nSonraí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\nmatching 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 tosaitheLink to this heading#Cruthaíonn struchtúr eolaire tionscadail Django don ainm tionscadail ar leith san eolaire reatha nó sa cheann scríbe ar leith.
\nDe 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.
\nMura 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.
\nIf the optional destination is provided, Django will use that name as the\nproject directory, and create manage.py and the project package within it.\nIf the directory with the given name doesn't exist, it will be created. Use '.'\nto denote the current working directory.
Mar shampla:
\ndjango-admin startproject myproject /Users/jezdez/Code/myproject_repo\nSpecifies a directory, file path, or URL of a custom project template. See the\nstartapp --template documentation for examples and usage. The same\nsecurity considerations described for startapp templates apply here:\nmalicious or poorly constructed templates may introduce weaknesses or consume\nexcessive resources, and templates should be carefully inspected before use.
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.
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.
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>.
\ntástálaLink to this heading#Ritheann sé tástálacha do gach aip suiteáilte. Féach: doc: `/topics/tástáil/innéacs `le haghaidh tuilleadh faisnéise.
\nStopann tástálacha a reáchtáil agus tuairiscíonn sé an teip díreach tar éis teip
\nRialaí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.
\nCuireann sé cosc ar gach leideanna úsáideora. Is é pras tipiciúil rabhadh faoi bhunachar sonraí tástála atá ann cheana a scriosadh.
\nFaigheann 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.
\nCaomhní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.
\nDé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
\nTá 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.
\nDé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ú.
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
<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.
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
\nUsing --parallel without a value, or with the value auto, runs one test\nprocess per core according to multiprocessing.cpu_count(). You can\noverride this by passing the desired number of processes, e.g.\n--parallel 4, or by setting the DJANGO_TEST_PROCESSES environment\nvariable.
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.
\nFaigheann 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.
\n\nÉilíonn an rogha seo an pacáiste tblib tríú páirtí chun rianais a thaispeáint i gceart:
$ python -m pip install tblib\nNíl an ghné seo ar fáil ar Windows. Ní oibríonn sé le cúltaca bunachar sonraí Oracle ach an oiread.
\nMá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ú.
<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.
\nMeastar go bhfuil tástálacha nach dteipfidh orthu a luchtú a mheaitseáil
\n<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.
\n<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.
\nCruthaíonn dífhabhtaitheoir pdb` ag gach earráid tástála nó teip. Má tá sé suiteáilte agat, úsáidtear ipdb ina ionad.
<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 `.
Django automatically calls faulthandler.enable() when starting the\ntests, which allows it to print a traceback if the interpreter crashes. Pass\n--no-faulthandler to disable this behavior.
Uaireanta aschuir, lena n-áirítear socrú bunachar sonraí agus am reatha iomlán.
\nTaispeánann sé na cásanna tástála N is moille (N = 0 do gach duine).
\nfreastalaí tástálaLink to this heading#Ritheann sé freastalaí forbartha Django (mar atá in:djadmin: runserver) ag baint úsáide as sonraí ón daingneán (í) ar leith.
\nMar shampla, an t-ordú seo:
\ndjango-admin testserver mydata.json\n... déanfadh na céimeanna seo a leanas:
\nCruthaigh bunachar sonraí tástála, mar a thuairiscítear in:ref: the-test-database.
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.)
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í:
\nNuair 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"\ncopy of a database that you'd like to interact with. You can dump your\ndatabase to a fixture (using the\ndumpdata command, explained above), then use testserver to run\nyour web application with that data. With this arrangement, you have the\nflexibility of messing up your data in any way, knowing that whatever data\nchanges 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.
\nSonraí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.
\nSamplaí:
\nChun an freastalaí tástála a reáchtáil ar chalafort 7000 le fixture1 agus fixture2`:
django-admin testserver --addrport 7000 fixture1 fixture2\ndjango-admin testserver fixture1 fixture2 --addrport 7000\n(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.)
\nChun rith ar 1.2.3. 4:7000 le daingneán ``tástála`:
\ndjango-admin testserver --addrport 1.2.3.4:7000 test\nCuireann sé cosc ar gach leideanna úsáideora. Is é pras tipiciúil rabhadh faoi bhunachar sonraí tástála atá ann cheana a scriosadh.
\n</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.authLink to this heading#athraitheaspasswordLink to this heading#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ú.
\nSonraíonn sé an bunachar sonraí le fiosrú don úsáideoir. Réamhshocraithe go réamhshocraithe.
Úsáid sampla:
\ndjango-admin changepassword ringo\ncreatesuperuserLink to this heading#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 (í).
\nNuair 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ó.
\n<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.
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.
\nIs 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.
Sonraíonn sé an bunachar sonraí ina sábhálfar an réad superuser.
\nIs 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.contenttypesLink to this heading#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.
\nScriosann 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.
\nSonraíonn sé an bunachar sonraí atá le húsáid. Réamhshocraithe go réamhshocraithe.
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.gisLink to this heading#ogrinspectLink to this heading#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.
\ndjango.contrib.sesionsLink to this heading#Is féidir é a reáchtáil mar phost cron nó go díreach chun seisiúin atá in éag a ghlanadh.
\nCollectstaticLink to this heading#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.
\nfindstaticLink to this heading#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.
\nCé 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
\nAdds the given filesystem path to the Python sys.path module\nattribute. If this isn't provided, django-admin will use the\nPYTHONPATH environment variable.
Níl an rogha seo gan ghá i manage.py`, toisc go dtugann sé aire do chonair Python a shocrú duit.
\nÚsáid sampla:
\ndjango-admin migrate --pythonpath='/home/djangoprojects/myproject'\nSonraí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:
\ndjango-admin migrate --settings=mysite.settings\nTaispeá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.
\nÚsáid sampla:
\ndjango-admin migrate --traceback\nSonraíonn sé méid na faisnéise fógra agus dífhabhtaithe ba chóir d'ordú a phriontáil chuig an gconsól.
\nCiallaí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.
\nÚsáid sampla:
\ndjango-admin migrate --verbosity 2\nDisables colorized command output. Some commands format their output to be\ncolorized. For example, errors will be printed to the console in red and SQL\nstatements will be syntax highlighted.
\nÚsáid sampla:
\ndjango-admin runserver --no-color\nDé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.
\nScaipeann 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.
\nÚsáid sampla:
\ndjango-admin migrate --skip-checks\nÚ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.
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.
\nFaoi 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í:
\nInstall: 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:
\n...\\> py -m pip install "colorama >= 0.4.6"\nSuiteá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"`.
Is féidir na dathanna a úsáidtear le haghaidh aibhsiú comhréireachta a shain Longa Django le trí phailéid dathanna:
\ndorch, 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:
\nexport DJANGO_COLORS="light"\nIs féidir leat na dathanna a úsáidtear a shaincheapadh freisin. Sonraíonn Django roinnt róil ina n-úsáidtear dath:
\nfógra - Earráid bheag.
sql_field - Ainm réimse samhail i SQL.
sql_coltype - An cineál réimse samhail i 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:
\n\nIs féidir gach ceann de na dathanna seo a athrú ansin trí na roghanna taispeána seo a leanas a úsáid:
\n`bold
Unscór
blink
`aisiom
ceilitheach
Leanann sonraíocht datha ceann de na patrúin seo a leanas:
\n\ná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:
export DJANGO_COLORS="error=yellow/blue,blink;notice=magenta"\nsonró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.
\nIs 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:
\nexport DJANGO_COLORS="light;error=yellow/blue,blink;notice=magenta"\nsonró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.
\nMá ú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...
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.
\nDé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:
PATH=path/to/venv/bin django-admin makemigrations\nLe haghaidh orduithe a úsáideann stdout is féidir leat an t-aschur a phíobáil chuig dub más gá:
django-admin inspectdb | black -\nChun ordú bainistíochta a ghlaoch ón gcód bain úsáid as ``call_command () ``.
\nainm 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.
\n*argsliosta 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') ``.
\nroghanna 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).
\nSamplaí:
\nfrom django.core import management\nfrom django.core.management.commands import loaddata\n\nmanagement.call_command("flush", verbosity=0, interactive=False)\nmanagement.call_command("loaddata", "test_data", verbosity=0)\nmanagement.call_command(loaddata.Command(), "test_data", verbosity=0)\nTabhair 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:
\n# Similar to the command line\nmanagement.call_command("dumpdata", "--natural-foreign")\n\n# Named argument similar to the command line minus the initial dashes and\n# with internal dashes replaced by underscores\nmanagement.call_command("dumpdata", natural_foreign=True)\n\n# `use_natural_foreign_keys` is the option destination variable\nmanagement.call_command("dumpdata", use_natural_foreign_keys=True)\nTá 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:
\nmanagement.call_command("dumpdata", exclude=["contenttypes", "auth"])\nTá luach tuairisceáin na feidhme call_command () ``mar an gcéanna le luach tuairisceáin modh ``handle () den ordaithe.
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:
with open("/path/to/command_output", "w") as f:\n management.call_command("dumpdata", stdout=f)\n